diff options
Diffstat (limited to 'framework/Collections/TMap.php')
| -rw-r--r-- | framework/Collections/TMap.php | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/framework/Collections/TMap.php b/framework/Collections/TMap.php index 73665136..6647d039 100644 --- a/framework/Collections/TMap.php +++ b/framework/Collections/TMap.php @@ -24,6 +24,7 @@ * unset($map[$key]); // remove the value with the specified key
* if(isset($map[$key])) // if the map contains the key
* foreach($map as $key=>$value) // traverse the items in the map
+ * $map->add("key1", "item1")->add("key2", "item2"); //multiple adds
* </code>
* Note, count($map) will always return 1. You should use {@link getCount()}
* to determine the number of items in the map.
@@ -101,6 +102,7 @@ class TMap extends TComponent implements IteratorAggregate,ArrayAccess * @param mixed key
* @param mixed value
* @throws TInvalidOperationException if the item cannot be added
+ * @return TMap this
*/
public function add($key,$value)
{
@@ -113,6 +115,7 @@ class TMap extends TComponent implements IteratorAggregate,ArrayAccess }
else
throw new TInvalidOperationException('map_addition_disallowed');
+ return $this;
}
/**
@@ -141,11 +144,13 @@ class TMap extends TComponent implements IteratorAggregate,ArrayAccess /**
* Removes all items in the map.
+ * @return TMap this
*/
public function clear()
{
foreach(array_keys($this->_d) as $key)
$this->remove($key);
+ return $this;
}
/**
@@ -170,6 +175,7 @@ class TMap extends TComponent implements IteratorAggregate,ArrayAccess * Note, existing data in the map will be cleared first.
* @param mixed the data to be copied from, must be an array or object implementing Traversable
* @throws TInvalidDataTypeException If data is neither an array nor an iterator.
+ * @return TMap this
*/
public function copyFrom($data)
{
@@ -182,6 +188,7 @@ class TMap extends TComponent implements IteratorAggregate,ArrayAccess }
else
throw new TInvalidDataTypeException('map_data_not_iterable');
+ return $this;
}
/**
@@ -189,6 +196,7 @@ class TMap extends TComponent implements IteratorAggregate,ArrayAccess * Existing data in the map will be kept and overwritten if the keys are the same.
* @param mixed the data to be merged with, must be an array or object implementing Traversable
* @throws TInvalidDataTypeException If data is neither an array nor an iterator.
+ * @return TMap this
*/
public function mergeWith($data)
{
@@ -199,6 +207,7 @@ class TMap extends TComponent implements IteratorAggregate,ArrayAccess }
else
throw new TInvalidDataTypeException('map_data_not_iterable');
+ return $this;
}
/**
|