/**
* Get parameter
*
* Returns the <var>$name</var> parameter from the selected source. Returns
* <var>$default</var> if <var>$name</var> parameter is not set:
* <code> // *** Assuming $_GET = array('foo' => 'foo', 'baz' => array('bar' => 'bar'));
* $input = new AeInput(AeInput::GET);
* $input->get('foo', 'undefined'); // foo
* $input->get('bar', 'undefined'); // undefined
* $input->get('baz.bar', 'undefined'); // bar</code>
*
* This method does not return the default value, if the requested parameter
* is set but empty, you should use {@link AeInput::getString() getString()}
* method for this purpose.
*
* <b>NOTE:</b> This method is backwards compatible with AeNode_Nested::get(),
* which may result in undesired return values. Use other getter methods to
* overcome this effect:
* <code> $input = new AeInput(AeInput::GET);
* $_GET['source'] = 'foo';
* $input->get('source'); // AeInput::GET value
* $input->getString('source'); // foo</code>
*
* @see AeInput::getBoolean(), AeInput::getInteger(), AeInput::getFloat(),
* AeInput::getString(), AeInput::getText(), AeInput::getArray(),
* AeInput::GetHtml()
*
* @param string $name
* @param mixed $default
*
* @return AeType|mixed
*/
public function get($name, $default = null)
{
$name = (string) $name;
if ($this->propertyExists($name)) {
return parent::get($name, $default);
}
return AeType::wrapReturn($this->_getClean($name), $default);
}
/**
* Get setting value
*
* Return setting value or default value, if setting not found:
* <code> $params->get('foo.bar', 'baz');</code>
*
* @uses AeSettings_Driver::$_namePattern
*
* @throws AeSettingsDriverException #400 if setting name is invalid
*
* @param string $name setting name
* @param mixed $default default value
*
* @return AeType|mixed setting value or default value
*/
public function get($name, $default = null)
{
$name = (string) $name;
if ($this->propertyExists($name)) {
// *** Never wrap object properties
return parent::get($name, $default);
}
if (!preg_match($this->_namePattern, (string) $name)) {
throw new AeSettingsDriverException('Setting name is invalid', 400);
}
if (strpos($name, '.')) {
list($section, $name) = explode('.', $name, 2);
} else {
$section = $this->section;
}
return AeType::wrapReturn(parent::get($section . '.' . $name, $default));
}
/**
* Get session variable
*
* Returns the session variable, identified by the <var>$name</var>
* parameter, or the <var>$default</var>, if variable is not set or is null
*
* @uses AeSession::_check() to check for session state
*
* @throws AeSessionException #403 if session validation failed
* @throws AeSessionException #408 if session has expired
* @throws AeSessionException #412 if session has been destroyed
*
* @param string $name
* @param mixed $default
*
* @return object|AeScalar|AeArray
*/
public function get($name, $default = null)
{
$name = (string) $name;
if ($this->propertyExists($name)) {
// *** Never wrap object properties
return parent::get($name, $default);
}
$this->_check();
if (!preg_match($this->_keyPattern, (string) $name)) {
throw new AeSessionException('Key name is invalid', 400);
}
$return = $this->_getByKey((string) $name, $_SESSION);
return AeType::wrapReturn($return, $default);
}
