Index: third_party/protobuf/php/src/Google/Protobuf/Internal/MapField.php |
diff --git a/third_party/protobuf/php/src/Google/Protobuf/Internal/MapField.php b/third_party/protobuf/php/src/Google/Protobuf/Internal/MapField.php |
new file mode 100644 |
index 0000000000000000000000000000000000000000..14ee7ebee3307ccda8f8de807680057197395de9 |
--- /dev/null |
+++ b/third_party/protobuf/php/src/Google/Protobuf/Internal/MapField.php |
@@ -0,0 +1,321 @@ |
+<?php |
+ |
+// Protocol Buffers - Google's data interchange format |
+// Copyright 2008 Google Inc. All rights reserved. |
+// https://developers.google.com/protocol-buffers/ |
+// |
+// Redistribution and use in source and binary forms, with or without |
+// modification, are permitted provided that the following conditions are |
+// met: |
+// |
+// * Redistributions of source code must retain the above copyright |
+// notice, this list of conditions and the following disclaimer. |
+// * Redistributions in binary form must reproduce the above |
+// copyright notice, this list of conditions and the following disclaimer |
+// in the documentation and/or other materials provided with the |
+// distribution. |
+// * Neither the name of Google Inc. nor the names of its |
+// contributors may be used to endorse or promote products derived from |
+// this software without specific prior written permission. |
+// |
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
+ |
+/** |
+ * MapField and MapFieldIter are used by generated protocol message classes to |
+ * manipulate map fields. |
+ */ |
+ |
+namespace Google\Protobuf\Internal; |
+ |
+/** |
+ * MapFieldIter is used to iterate MapField. It is also need for the foreach |
+ * syntax. |
+ */ |
+class MapFieldIter implements \Iterator |
+{ |
+ |
+ /** |
+ * @ignore |
+ */ |
+ private $container; |
+ |
+ /** |
+ * Create iterator instance for MapField. |
+ * |
+ * @param MapField The MapField instance for which this iterator is |
+ * created. |
+ * @ignore |
+ */ |
+ public function __construct($container) |
+ { |
+ $this->container = $container; |
+ } |
+ |
+ /** |
+ * Reset the status of the iterator |
+ * |
+ * @return void |
+ */ |
+ public function rewind() |
+ { |
+ return reset($this->container); |
+ } |
+ |
+ /** |
+ * Return the element at the current position. |
+ * |
+ * @return object The element at the current position. |
+ */ |
+ public function current() |
+ { |
+ return current($this->container); |
+ } |
+ |
+ /** |
+ * Return the current key. |
+ * |
+ * @return object The current key. |
+ */ |
+ public function key() |
+ { |
+ return key($this->container); |
+ } |
+ |
+ /** |
+ * Move to the next position. |
+ * |
+ * @return void |
+ */ |
+ public function next() |
+ { |
+ return next($this->container); |
+ } |
+ |
+ /** |
+ * Check whether there are more elements to iterate. |
+ * |
+ * @return bool True if there are more elements to iterate. |
+ */ |
+ public function valid() |
+ { |
+ return key($this->container) !== null; |
+ } |
+} |
+ |
+/** |
+ * @ignore |
+ */ |
+function checkKey($key_type, &$key) |
+{ |
+ switch ($key_type) { |
+ case GPBType::INT32: |
+ GPBUtil::checkInt32($key); |
+ break; |
+ case GPBType::UINT32: |
+ GPBUtil::checkUint32($key); |
+ break; |
+ case GPBType::INT64: |
+ GPBUtil::checkInt64($key); |
+ break; |
+ case GPBType::UINT64: |
+ GPBUtil::checkUint64($key); |
+ break; |
+ case GPBType::FIXED64: |
+ GPBUtil::checkUint64($key); |
+ break; |
+ case GPBType::FIXED32: |
+ GPBUtil::checkUint32($key); |
+ break; |
+ case GPBType::SFIXED64: |
+ GPBUtil::checkInt64($key); |
+ break; |
+ case GPBType::SFIXED32: |
+ GPBUtil::checkInt32($key); |
+ break; |
+ case GPBType::SINT64: |
+ GPBUtil::checkInt64($key); |
+ break; |
+ case GPBType::SINT32: |
+ GPBUtil::checkInt32($key); |
+ break; |
+ case GPBType::BOOL: |
+ GPBUtil::checkBool($key); |
+ break; |
+ case GPBType::STRING: |
+ GPBUtil::checkString($key, true); |
+ break; |
+ default: |
+ var_dump($key_type); |
+ trigger_error( |
+ "Given type cannot be map key.", |
+ E_USER_ERROR); |
+ break; |
+ } |
+} |
+ |
+/** |
+ * MapField is used by generated protocol message classes to manipulate map |
+ * fields. It can be used like native PHP array. |
+ */ |
+class MapField implements \ArrayAccess, \IteratorAggregate, \Countable |
+{ |
+ /** |
+ * @ignore |
+ */ |
+ private $container; |
+ /** |
+ * @ignore |
+ */ |
+ private $key_type; |
+ /** |
+ * @ignore |
+ */ |
+ private $value_type; |
+ /** |
+ * @ignore |
+ */ |
+ private $value_klass; |
+ |
+ /** |
+ * Constructs an instance of MapField. |
+ * |
+ * @param long $key_type Type of the stored key element. |
+ * @param long $value_type Type of the stored value element. |
+ * @param string $klass Message/Enum class name of value instance |
+ * (message/enum fields only). |
+ * @ignore |
+ */ |
+ public function __construct($key_type, $value_type, $klass = null) |
+ { |
+ $this->container = []; |
+ $this->key_type = $key_type; |
+ $this->value_type = $value_type; |
+ $this->klass = $klass; |
+ } |
+ |
+ /** |
+ * Return the element at the given key. |
+ * |
+ * This will also be called for: $ele = $arr[$key] |
+ * |
+ * @param object $key The key of the element to be fetched. |
+ * @return object The stored element at given key. |
+ * @throws ErrorException Invalid type for index. |
+ * @throws ErrorException Non-existing index. |
+ */ |
+ public function offsetGet($key) |
+ { |
+ return $this->container[$key]; |
+ } |
+ |
+ /** |
+ * Assign the element at the given key. |
+ * |
+ * This will also be called for: $arr[$key] = $value |
+ * |
+ * @param object $key The key of the element to be fetched. |
+ * @param object $value The element to be assigned. |
+ * @return void |
+ * @throws ErrorException Invalid type for key. |
+ * @throws ErrorException Invalid type for value. |
+ * @throws ErrorException Non-existing key. |
+ */ |
+ public function offsetSet($key, $value) |
+ { |
+ checkKey($this->key_type, $key); |
+ |
+ switch ($this->value_type) { |
+ case GPBType::INT32: |
+ GPBUtil::checkInt32($value); |
+ break; |
+ case GPBType::UINT32: |
+ GPBUtil::checkUint32($value); |
+ break; |
+ case GPBType::INT64: |
+ GPBUtil::checkInt64($value); |
+ break; |
+ case GPBType::UINT64: |
+ GPBUtil::checkUint64($value); |
+ break; |
+ case GPBType::FLOAT: |
+ GPBUtil::checkFloat($value); |
+ break; |
+ case GPBType::DOUBLE: |
+ GPBUtil::checkDouble($value); |
+ break; |
+ case GPBType::BOOL: |
+ GPBUtil::checkBool($value); |
+ break; |
+ case GPBType::STRING: |
+ GPBUtil::checkString($value, true); |
+ break; |
+ case GPBType::MESSAGE: |
+ GPBUtil::checkMessage($value, $this->klass); |
+ break; |
+ default: |
+ break; |
+ } |
+ |
+ $this->container[$key] = $value; |
+ } |
+ |
+ /** |
+ * Remove the element at the given key. |
+ * |
+ * This will also be called for: unset($arr) |
+ * |
+ * @param object $key The key of the element to be removed. |
+ * @return void |
+ * @throws ErrorException Invalid type for key. |
+ */ |
+ public function offsetUnset($key) |
+ { |
+ checkKey($this->key_type, $key); |
+ unset($this->container[$key]); |
+ } |
+ |
+ /** |
+ * Check the existence of the element at the given key. |
+ * |
+ * This will also be called for: isset($arr) |
+ * |
+ * @param object $key The key of the element to be removed. |
+ * @return bool True if the element at the given key exists. |
+ * @throws ErrorException Invalid type for key. |
+ */ |
+ public function offsetExists($key) |
+ { |
+ checkKey($this->key_type, $key); |
+ return isset($this->container[$key]); |
+ } |
+ |
+ /** |
+ * @ignore |
+ */ |
+ public function getIterator() |
+ { |
+ return new MapFieldIter($this->container); |
+ } |
+ |
+ /** |
+ * Return the number of stored elements. |
+ * |
+ * This will also be called for: count($arr) |
+ * |
+ * @return integer The number of stored elements. |
+ */ |
+ public function count() |
+ { |
+ return count($this->container); |
+ } |
+} |