%PDF- %PDF-
Direktori : /www/varak.net/wiki.varak.net/vendor/wikimedia/cdb/src/Reader/ |
Current File : /www/varak.net/wiki.varak.net/vendor/wikimedia/cdb/src/Reader/Hash.php |
<?php namespace Cdb\Reader; use Cdb\Reader; use Wikimedia\Assert\Assert; /** * Hash implements the CdbReader interface based on an associative * PHP array (a.k.a "hash"). * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License along * with this program; if not, write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * http://www.gnu.org/copyleft/gpl.html * * @file */ /** * Hash implements the CdbReader interface based on an associative * PHP array (a.k.a "hash"). */ class Hash extends Reader { /** * @var string */ private $data; /** * A queue of keys to return from nextkey(), * initialized by firstkey(); * * @var string[]|null */ private $keys = null; /** * Create the object and open the file * * @param string[] $data An associative PHP array. */ public function __construct( $data ) { if ( !is_array( $data ) ) { throw new \InvalidArgumentException( __METHOD__ . ': "$data" must be an array.' ); } $this->data = $data; } /** * Close the file. Optional, you can just let the variable go out of scope. */ public function close() { $this->data = array(); $this->keys = null; } /** * Get a value with a given key. Only string values are supported. * * @param string $key * * @return bool|string The value associated with $key, or false if $key is not known. */ public function get( $key ) { return isset( $this->data[ $key ] ) ? $this->data[ $key ] : false; } /** * Check whether key exists * * @param string $key * * @return bool */ public function exists( $key ) { return isset( $this->data[ $key ] ); } /** * Fetch first key * * @return string */ public function firstkey() { $this->keys = array_keys( $this->data ); return $this->nextkey(); } /** * Fetch next key * * @return string */ public function nextkey() { if ( $this->keys === null ) { return $this->firstkey(); } return empty( $this->keys ) ? false : array_shift( $this->keys ); } }