|
Server : Apache System : Linux srv.rainic.com 4.18.0-553.47.1.el8_10.x86_64 #1 SMP Wed Apr 2 05:45:37 EDT 2025 x86_64 User : rainic ( 1014) PHP Version : 7.4.33 Disable Function : exec,passthru,shell_exec,system Directory : /home/akaindir/www/crm/modules/Mobile/third-party/qCal/qCal/ |
Upload File : |
<?php
/**
* Base property value class. Every property value has a specific data
* type. Some of them are very simple, such as boolean. Others can be
* rather complex, such as recur (specifies a date pattern for recurring
* events and other components).
* @package qCal
* @copyright Luke Visinoni (luke.visinoni@gmail.com)
* @author Luke Visinoni (luke.visinoni@gmail.com)
* @license GNU Lesser General Public License
*
* RFC 2445 Definition
*
* The properties in an iCalendar object are strongly typed. The
* definition of each property restricts the value to be one of the
* value data types, or simply value types, defined in this section. The
* value type for a property will either be specified implicitly as the
* default value type or will be explicitly specified with the "VALUE"
* parameter. If the value type of a property is one of the alternate
* valid types, then it MUST be explicitly specified with the "VALUE"
* parameter.
*/
abstract class qCal_Value {
protected $value;
public function __construct($value) {
$this->setValue($value);
}
/**
* A factory for data type objects. Pass in a type and a value, and it will return the value
* casted to the proper type
*/
public static function factory($type, $value) {
// remove dashes, capitalize properly
$parts = explode("-", $type);
$type = "";
foreach ($parts as $part) $type .= trim(ucfirst(strtolower($part)));
// get the class, and instantiate
$className = "qCal_Value_" . $type;
$class = new $className($value);
return $class;
}
/**
* Sets the value of this object. The beauty of using inheritence here is that I can store
* the value however I want for any value type, and then on __toString() I can return it how
* iCalendar specifies :)
*/
public function setValue($value) {
$this->value = $this->doCast($value);
return $this;
}
/**
* Returns raw value (as it is stored)
*/
public function getValue() {
return $this->value;
}
/**
* Casts $value to this data type
*/
public function cast($value) {
return $this->doCast($value);
}
/**
* Returns the value as a string
*/
public function __toString() {
return $this->toString($this->value);
}
/**
* Converts from native format to a string, __toString() calls this internally
*/
protected function toString($value) {
return (string) $value;
}
/**
* This is left to be implemented by children classes, basically they
* implement this method to cast any input into their data type (from a string)
* @todo Change the name of this to something more appropriate, maybe toNative or something
*/
abstract protected function doCast($value);
}