From 2d0739422a41237f48d2ff7c079043fa7f0b2944 Mon Sep 17 00:00:00 2001
From: wei <>
Date: Mon, 2 Jan 2006 05:48:24 +0000
Subject: return self instances to some functions
---
framework/Collections/TMap.php | 9 +++++++++
1 file changed, 9 insertions(+)
(limited to 'framework/Collections/TMap.php')
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;
}
/**
--
cgit v1.2.3