powerdlz23 1.1.7 → 1.1.8

package/pto/yaamp/web/framework-1.0.8/collections/CAttributeCollection.php

@@ -0,0 +1,187 @@
+<?php
+/**
+ * This file contains classes implementing attribute collection feature.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+
+/**
+ * CAttributeCollection implements a collection for storing attribute names and values.
+ *
+ * Besides all functionalities provided by {@link CMap}, CAttributeCollection
+ * allows you to get and set attribute values like getting and setting
+ * properties. For example, the following usages are all valid for a
+ * CAttributeCollection object:
+ * <pre>
+ * $collection->text='text'; // same as:  $collection->add('text','text');
+ * echo $collection->text;   // same as:  echo $collection->itemAt('text');
+ * </pre>
+ *
+ * The case sensitivity of attribute names can be toggled by setting the
+ * {@link caseSensitive} property of the collection.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CAttributeCollection.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.collections
+ * @since 1.0
+ */
+class CAttributeCollection extends CMap
+{
+	/**
+	 * @var boolean whether the keys are case-sensitive. Defaults to false.
+	 */
+	public $caseSensitive=false;
+
+	/**
+	 * Returns a property value or an event handler list by property or event name.
+	 * This method overrides the parent implementation by returning
+	 * a key value if the key exists in the collection.
+	 * @param string the property name or the event name
+	 * @return mixed the property value or the event handler list
+	 * @throws CException if the property/event is not defined.
+	 */
+	public function __get($name)
+	{
+		if($this->contains($name))
+			return $this->itemAt($name);
+		else
+			return parent::__get($name);
+	}
+
+	/**
+	 * Sets value of a component property.
+	 * This method overrides the parent implementation by adding a new key value
+	 * to the collection.
+	 * @param string the property name or event name
+	 * @param mixed the property value or event handler
+	 * @throws CException If the property is not defined or read-only.
+	 */
+	public function __set($name,$value)
+	{
+		$this->add($name,$value);
+	}
+
+	/**
+	 * Checks if a property value is null.
+	 * This method overrides the parent implementation by checking
+	 * if the key exists in the collection and contains a non-null value.
+	 * @param string the property name or the event name
+	 * @return boolean whether the property value is null
+	 * @since 1.0.1
+	 */
+	public function __isset($name)
+	{
+		if($this->contains($name))
+			return $this->itemAt($name)!==null;
+		else
+			return parent::__isset($name);
+	}
+
+	/**
+	 * Sets a component property to be null.
+	 * This method overrides the parent implementation by clearing
+	 * the specified key value.
+	 * @param string the property name or the event name
+	 * @since 1.0.1
+	 */
+	public function __unset($name)
+	{
+		$this->remove($name);
+	}
+
+	/**
+	 * Returns the item with the specified key.
+	 * This overrides the parent implementation by converting the key to lower case first if {@link caseSensitive} is false.
+	 * @param mixed the key
+	 * @return mixed the element at the offset, null if no element is found at the offset
+	 */
+	public function itemAt($key)
+	{
+		if($this->caseSensitive)
+			return parent::itemAt($key);
+		else
+			return parent::itemAt(strtolower($key));
+	}
+
+	/**
+	 * Adds an item into the map.
+	 * This overrides the parent implementation by converting the key to lower case first if {@link caseSensitive} is false.
+	 * @param mixed key
+	 * @param mixed value
+	 */
+	public function add($key,$value)
+	{
+		if($this->caseSensitive)
+			parent::add($key,$value);
+		else
+			parent::add(strtolower($key),$value);
+	}
+
+	/**
+	 * Removes an item from the map by its key.
+	 * This overrides the parent implementation by converting the key to lower case first if {@link caseSensitive} is false.
+	 * @param mixed the key of the item to be removed
+	 * @return mixed the removed value, null if no such key exists.
+	 */
+	public function remove($key)
+	{
+		if($this->caseSensitive)
+			return parent::remove($key);
+		else
+			return parent::remove(strtolower($key));
+	}
+
+	/**
+	 * Returns whether the specified is in the map.
+	 * This overrides the parent implementation by converting the key to lower case first if {@link caseSensitive} is false.
+	 * @param mixed the key
+	 * @return boolean whether the map contains an item with the specified key
+	 */
+	public function contains($key)
+	{
+		if($this->caseSensitive)
+			return parent::contains($key);
+		else
+			return parent::contains(strtolower($key));
+	}
+
+	/**
+	 * Determines whether a property is defined.
+	 * This method overrides parent implementation by returning true
+	 * if the collection contains the named key.
+	 * @param string the property name
+	 * @return boolean whether the property is defined
+	 */
+	public function hasProperty($name)
+	{
+		return $this->contains($name) || parent::hasProperty($name);
+	}
+
+	/**
+	 * Determines whether a property can be read.
+	 * This method overrides parent implementation by returning true
+	 * if the collection contains the named key.
+	 * @param string the property name
+	 * @return boolean whether the property can be read
+	 */
+	public function canGetProperty($name)
+	{
+		return $this->contains($name) || parent::canGetProperty($name);
+	}
+
+	/**
+	 * Determines whether a property can be set.
+	 * This method overrides parent implementation by always returning true
+	 * because you can always add a new value to the collection.
+	 * @param string the property name
+	 * @return boolean true
+	 */
+	public function canSetProperty($name)
+	{
+		return true;
+	}
+}

package/pto/yaamp/web/framework-1.0.8/collections/CConfiguration.php

@@ -0,0 +1,121 @@
+<?php
+/**
+ * This file contains classes implementing configuration feature.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+
+/**
+ * CConfiguration represents an array-based configuration.
+ *
+ * It can be used to initialize an object's properties.
+ *
+ * The configuration data may be obtained from a PHP script. For example,
+ * <pre>
+ * &lt;?php
+ * return array
+ * (
+ *     'name'=>'My Application',
+ *     'defaultController'=>'index',
+ * );
+ * ?&gt;
+ * </pre>
+ * Use the following code to load the above configuration data:
+ * <pre>
+ * $config=new CConfiguration('path/to/config.php');
+ * </pre>
+ *
+ * To apply the configuration to an object, call {@link applyTo()}.
+ * Each (key,value) pair in the configuration data is applied
+ * to the object like: $object->$key=$value.
+ *
+ * Since CConfiguration extends from {@link CMap}, it can be
+ * used like an associative array. See {@link CMap} for more details.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CConfiguration.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.collections
+ * @since 1.0
+ */
+class CConfiguration extends CMap
+{
+	/**
+	 * Constructor.
+	 * @param mixed if string, it represents a config file (a PHP script returning the configuration as an array);
+	 * If array, it is config data.
+	 */
+	public function __construct($data=null)
+	{
+		if(is_string($data))
+			parent::__construct(require($data));
+		else
+			parent::__construct($data);
+	}
+
+	/**
+	 * Loads configuration data from a file and merges it with the existing configuration.
+	 *
+	 * A config file must be a PHP script returning a configuration array (like the following)
+	 * <pre>
+	 * return array
+	 * (
+	 *     'name'=>'My Application',
+	 *     'defaultController'=>'index',
+	 * );
+	 * </pre>
+	 *
+	 * @param string configuration file path (if using relative path, be aware of what is the current path)
+	 * @see mergeWith
+	 */
+	public function loadFromFile($configFile)
+	{
+		$data=require($configFile);
+		if($this->getCount()>0)
+			$this->mergeWith($data);
+		else
+			$this->copyFrom($data);
+	}
+
+	/**
+	 * Saves the configuration into a string.
+	 * The string is a valid PHP expression representing the configuration data as an array.
+	 * @return string the string representation of the configuration
+	 */
+	public function saveAsString()
+	{
+		return str_replace("\r",'',var_export($this->toArray(),true));
+	}
+
+	/**
+	 * Applies the configuration to an object.
+	 * Each (key,value) pair in the configuration data is applied
+	 * to the object like: $object->$key=$value.
+	 * @param object object to be applied with this configuration
+	 */
+	public function applyTo($object)
+	{
+		foreach($this->toArray() as $key=>$value)
+			$object->$key=$value;
+	}
+
+	/**
+	 * Creates an object and initializes it based on the given configuration.
+	 *
+	 * NOTE: this method has been deprecated since version 1.0.1.
+	 * Please use {@link YiiBase::createComponent Yii::createComponent}, instead.
+	 *
+	 * @param mixed the configuration. It can be either a string or an array.
+	 * @return mixed the created object
+	 * @throws CException if the configuration does not have 'class' value
+	 */
+	public static function createObject($config)
+	{
+		if($config instanceof self)
+			$config=$config->toArray();
+		return Yii::createComponent($config);
+	}
+}

package/pto/yaamp/web/framework-1.0.8/collections/CList.php

@@ -0,0 +1,341 @@
+<?php
+/**
+ * This file contains classes implementing list feature.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CList implements an integer-indexed collection class.
+ *
+ * You can access, append, insert, remove an item by using
+ * {@link itemAt}, {@link add}, {@link insertAt}, {@link remove}, and {@link removeAt}.
+ * To get the number of the items in the list, use {@link getCount}.
+ * CList can also be used like a regular array as follows,
+ * <pre>
+ * $list[]=$item;  // append at the end
+ * $list[$index]=$item; // $index must be between 0 and $list->Count
+ * unset($list[$index]); // remove the item at $index
+ * if(isset($list[$index])) // if the list has an item at $index
+ * foreach($list as $index=>$item) // traverse each item in the list
+ * $n=count($list); // returns the number of items in the list
+ * </pre>
+ *
+ * To extend CList by doing additional operations with each addition or removal
+ * operation (e.g. performing type check), override {@link insertAt()}, and {@link removeAt()}.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CList.php 568 2009-01-23 22:50:14Z qiang.xue $
+ * @package system.collections
+ * @since 1.0
+ */
+class CList extends CComponent implements IteratorAggregate,ArrayAccess,Countable
+{
+	/**
+	 * @var array internal data storage
+	 */
+	private $_d=array();
+	/**
+	 * @var integer number of items
+	 */
+	private $_c=0;
+	/**
+	 * @var boolean whether this list is read-only
+	 */
+	private $_r=false;
+
+	/**
+	 * Constructor.
+	 * Initializes the list with an array or an iterable object.
+	 * @param array the initial data. Default is null, meaning no initialization.
+	 * @param boolean whether the list is read-only
+	 * @throws CException If data is not null and neither an array nor an iterator.
+	 */
+	public function __construct($data=null,$readOnly=false)
+	{
+		if($data!==null)
+			$this->copyFrom($data);
+		$this->setReadOnly($readOnly);
+	}
+
+	/**
+	 * @return boolean whether this list is read-only or not. Defaults to false.
+	 */
+	public function getReadOnly()
+	{
+		return $this->_r;
+	}
+
+	/**
+	 * @param boolean whether this list is read-only or not
+	 */
+	protected function setReadOnly($value)
+	{
+		$this->_r=$value;
+	}
+
+	/**
+	 * Returns an iterator for traversing the items in the list.
+	 * This method is required by the interface IteratorAggregate.
+	 * @return Iterator an iterator for traversing the items in the list.
+	 */
+	public function getIterator()
+	{
+		return new CListIterator($this->_d);
+	}
+
+	/**
+	 * Returns the number of items in the list.
+	 * This method is required by Countable interface.
+	 * @return integer number of items in the list.
+	 */
+	public function count()
+	{
+		return $this->getCount();
+	}
+
+	/**
+	 * @return integer the number of items in the list
+	 */
+	public function getCount()
+	{
+		return $this->_c;
+	}
+
+	/**
+	 * Returns the item at the specified offset.
+	 * This method is exactly the same as {@link offsetGet}.
+	 * @param integer the index of the item
+	 * @return mixed the item at the index
+	 * @throws CException if the index is out of the range
+	 */
+	public function itemAt($index)
+	{
+		if(isset($this->_d[$index]))
+			return $this->_d[$index];
+		else if($index>=0 && $index<$this->_c) // in case the value is null
+			return $this->_d[$index];
+		else
+			throw new CException(Yii::t('yii','List index "{index}" is out of bound.',
+				array('{index}'=>$index)));
+	}
+
+	/**
+	 * Appends an item at the end of the list.
+	 * @param mixed new item
+	 * @return integer the zero-based index at which the item is added
+	 */
+	public function add($item)
+	{
+		$this->insertAt($this->_c,$item);
+		return $this->_c-1;
+	}
+
+	/**
+	 * Inserts an item at the specified position.
+	 * Original item at the position and the next items
+	 * will be moved one step towards the end.
+	 * @param integer the specified position.
+	 * @param mixed new item
+	 * @throws CException If the index specified exceeds the bound or the list is read-only
+	 */
+	public function insertAt($index,$item)
+	{
+		if(!$this->_r)
+		{
+			if($index===$this->_c)
+				$this->_d[$this->_c++]=$item;
+			else if($index>=0 && $index<$this->_c)
+			{
+				array_splice($this->_d,$index,0,array($item));
+				$this->_c++;
+			}
+			else
+				throw new CException(Yii::t('yii','List index "{index}" is out of bound.',
+					array('{index}'=>$index)));
+		}
+		else
+			throw new CException(Yii::t('yii','The list is read only.'));
+	}
+
+	/**
+	 * Removes an item from the list.
+	 * The list will first search for the item.
+	 * The first item found will be removed from the list.
+	 * @param mixed the item to be removed.
+	 * @return integer the index at which the item is being removed
+	 * @throws CException If the item does not exist
+	 */
+	public function remove($item)
+	{
+		if(($index=$this->indexOf($item))>=0)
+		{
+			$this->removeAt($index);
+			return $index;
+		}
+		else
+			return false;
+	}
+
+	/**
+	 * Removes an item at the specified position.
+	 * @param integer the index of the item to be removed.
+	 * @return mixed the removed item.
+	 * @throws CException If the index specified exceeds the bound or the list is read-only
+	 */
+	public function removeAt($index)
+	{
+		if(!$this->_r)
+		{
+			if($index>=0 && $index<$this->_c)
+			{
+				$this->_c--;
+				if($index===$this->_c)
+					return array_pop($this->_d);
+				else
+				{
+					$item=$this->_d[$index];
+					array_splice($this->_d,$index,1);
+					return $item;
+				}
+			}
+			else
+				throw new CException(Yii::t('yii','List index "{index}" is out of bound.',
+					array('{index}'=>$index)));
+		}
+		else
+			throw new CException(Yii::t('yii','The list is read only.'));
+	}
+
+	/**
+	 * Removes all items in the list.
+	 */
+	public function clear()
+	{
+		for($i=$this->_c-1;$i>=0;--$i)
+			$this->removeAt($i);
+	}
+
+	/**
+	 * @param mixed the item
+	 * @return boolean whether the list contains the item
+	 */
+	public function contains($item)
+	{
+		return $this->indexOf($item)>=0;
+	}
+
+	/**
+	 * @param mixed the item
+	 * @return integer the index of the item in the list (0 based), -1 if not found.
+	 */
+	public function indexOf($item)
+	{
+		if(($index=array_search($item,$this->_d,true))!==false)
+			return $index;
+		else
+			return -1;
+	}
+
+	/**
+	 * @return array the list of items in array
+	 */
+	public function toArray()
+	{
+		return $this->_d;
+	}
+
+	/**
+	 * Copies iterable data into the list.
+	 * Note, existing data in the list will be cleared first.
+	 * @param mixed the data to be copied from, must be an array or object implementing Traversable
+	 * @throws CException If data is neither an array nor a Traversable.
+	 */
+	public function copyFrom($data)
+	{
+		if(is_array($data) || ($data instanceof Traversable))
+		{
+			if($this->_c>0)
+				$this->clear();
+			if($data instanceof CList)
+				$data=$data->_d;
+			foreach($data as $item)
+				$this->add($item);
+		}
+		else if($data!==null)
+			throw new CException(Yii::t('yii','List data must be an array or an object implementing Traversable.'));
+	}
+
+	/**
+	 * Merges iterable data into the map.
+	 * New data will be appended to the end of the existing data.
+	 * @param mixed the data to be merged with, must be an array or object implementing Traversable
+	 * @throws CException If data is neither an array nor an iterator.
+	 */
+	public function mergeWith($data)
+	{
+		if(is_array($data) || ($data instanceof Traversable))
+		{
+			if($data instanceof CList)
+				$data=$data->_d;
+			foreach($data as $item)
+				$this->add($item);
+		}
+		else if($data!==null)
+			throw new CException(Yii::t('yii','List data must be an array or an object implementing Traversable.'));
+	}
+
+	/**
+	 * Returns whether there is an item at the specified offset.
+	 * This method is required by the interface ArrayAccess.
+	 * @param integer the offset to check on
+	 * @return boolean
+	 */
+	public function offsetExists($offset)
+	{
+		return ($offset>=0 && $offset<$this->_c);
+	}
+
+	/**
+	 * Returns the item at the specified offset.
+	 * This method is required by the interface ArrayAccess.
+	 * @param integer the offset to retrieve item.
+	 * @return mixed the item at the offset
+	 * @throws CException if the offset is invalid
+	 */
+	public function offsetGet($offset)
+	{
+		return $this->itemAt($offset);
+	}
+
+	/**
+	 * Sets the item at the specified offset.
+	 * This method is required by the interface ArrayAccess.
+	 * @param integer the offset to set item
+	 * @param mixed the item value
+	 */
+	public function offsetSet($offset,$item)
+	{
+		if($offset===null || $offset===$this->_c)
+			$this->insertAt($this->_c,$item);
+		else
+		{
+			$this->removeAt($offset);
+			$this->insertAt($offset,$item);
+		}
+	}
+
+	/**
+	 * Unsets the item at the specified offset.
+	 * This method is required by the interface ArrayAccess.
+	 * @param integer the offset to unset item
+	 */
+	public function offsetUnset($offset)
+	{
+		$this->removeAt($offset);
+	}
+}
+