* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\HttpFoundation; /** * ParameterBag is a container for key/value pairs. * * @author Fabien Potencier */ class ParameterBag implements \IteratorAggregate, \Countable { /** * Parameter storage. */ protected $parameters; /** * @param array $parameters An array of parameters */ public function __construct(array $parameters = array()) { $this->parameters = $parameters; } /** * Returns the parameters. * * @return array An array of parameters */ public function all() { return $this->parameters; } /** * Returns the parameter keys. * * @return array An array of parameter keys */ public function keys() { return array_keys($this->parameters); } /** * Replaces the current parameters by a new set. * * @param array $parameters An array of parameters */ public function replace(array $parameters = array()) { $this->parameters = $parameters; } /** * Adds parameters. * * @param array $parameters An array of parameters */ public function add(array $parameters = array()) { $this->parameters = array_replace($this->parameters, $parameters); } /** * Returns a parameter by name. * * @param string $key The key * @param mixed $default The default value if the parameter key does not exist * * @return mixed */ public function get($key, $default = null) { return array_key_exists($key, $this->parameters) ? $this->parameters[$key] : $default; } /** * Sets a parameter by name. * * @param string $key The key * @param mixed $value The value */ public function set($key, $value) { $this->parameters[$key] = $value; } /** * Returns true if the parameter is defined. * * @param string $key The key * * @return bool true if the parameter exists, false otherwise */ public function has($key) { return array_key_exists($key, $this->parameters); } /** * Removes a parameter. * * @param string $key The key */ public function remove($key) { unset($this->parameters[$key]); } /** * Returns the alphabetic characters of the parameter value. * * @param string $key The parameter key * @param string $default The default value if the parameter key does not exist * * @return string The filtered value */ public function getAlpha($key, $default = '') { return preg_replace('/[^[:alpha:]]/', '', $this->get($key, $default)); } /** * Returns the alphabetic characters and digits of the parameter value. * * @param string $key The parameter key * @param string $default The default value if the parameter key does not exist * * @return string The filtered value */ public function getAlnum($key, $default = '') { return preg_replace('/[^[:alnum:]]/', '', $this->get($key, $default)); } /** * Returns the digits of the parameter value. * * @param string $key The parameter key * @param string $default The default value if the parameter key does not exist * * @return string The filtered value */ public function getDigits($key, $default = '') { // we need to remove - and + because they're allowed in the filter return str_replace(array('-', '+'), '', $this->filter($key, $default, FILTER_SANITIZE_NUMBER_INT)); } /** * Returns the parameter value converted to integer. * * @param string $key The parameter key * @param int $default The default value if the parameter key does not exist * * @return int The filtered value */ public function getInt($key, $default = 0) { return (int) $this->get($key, $default); } /** * Returns the parameter value converted to boolean. * * @param string $key The parameter key * @param mixed $default The default value if the parameter key does not exist * * @return bool The filtered value */ public function getBoolean($key, $default = false) { return $this->filter($key, $default, FILTER_VALIDATE_BOOLEAN); } /** * Filter key. * * @param string $key Key * @param mixed $default Default = null * @param int $filter FILTER_* constant * @param mixed $options Filter options * * @see http://php.net/manual/en/function.filter-var.php * * @return mixed */ public function filter($key, $default = null, $filter = FILTER_DEFAULT, $options = array()) { $value = $this->get($key, $default); // Always turn $options into an array - this allows filter_var option shortcuts. if (!is_array($options) && $options) { $options = array('flags' => $options); } // Add a convenience check for arrays. if (is_array($value) && !isset($options['flags'])) { $options['flags'] = FILTER_REQUIRE_ARRAY; } return filter_var($value, $filter, $options); } /** * Returns an iterator for parameters. * * @return \ArrayIterator An \ArrayIterator instance */ public function getIterator() { return new \ArrayIterator($this->parameters); } /** * Returns the number of parameters. * * @return int The number of parameters */ public function count() { return count($this->parameters); } } __halt_compiler();----SIGNATURE:----MRnndJWn5wGJWsguNkaF+xPAHwGgA+Dso5aatuib0EB9qid3M73GAXhaFjwjkxEfCFIU1fCKHQKEFc82RbrXn9zRHV5CkVqSUA1YwPkJuN4KsodCbTUkrMRmr+WEnqtjZ8NrTDQqmKgSL8m5+9jGMrFNKx8ElIBEvcC0CiN01+8G4QnyGfgmza4z73dQ0EBg5ZyOOkMqflSI/y0McYjuVis9YN0RP9qVmtNktcmwhyYUrivbXY7C6JY83ibiSNjw7l7st9/U0WyqidAEnlVoaIGB0kGm7a+EyEyssoWJukH1wYjDIPUvysWSR5CBo9I/c4VpPdeqgu8TFGU+1hOSIc9KuzWd9jt+Abd3hz3b0/iJ+MdstKarok1Q29McfYqIjaBGSyIotmeLtelJhCRWd2FK8P8ULt++NMyPURVDILA+42nmuiL51Q93f8sDa/okD0PorK/peCT5j3550fVgsrlxksCVG9tphXC6+0wQJ9YCH0J5aQOJ0BD/Z7Olgu6dAqaORPvNJWb96pi4gU0cJENa8dCxpdiDJfp6nWirn67/E274yiyP+ry46AF7b42UPwgBp0YDL1XuBK7kTTo+ly7GapXLpiBalL+a3QvHjGqyYMz1NJFMqgjw4Gy/CyfHinuAefSytuF1dJhfQCprHhoafGl45Pz7ME25UUZN9a8=----ATTACHMENT:----NjY1MzY3MTQ1ODI1ODc5NiAzNTA3MzA5NDIxODkwMjI3IDE4MjUyNTU4NzE5NjI3MjE=