API15:JApplication/getUserStateFromRequest

This Namespace has been archived - Please Do Not Edit or Create Pages in this namespace. Pages contain information for a Joomla! version which is no longer supported. It exists only as a historical reference, will not be improved and its content may be incomplete.

Description

Gets the value of a user state variable.

Syntax

getUserStateFromRequest($key, $request, $default=null, $type= 'none')

Parameter Name	Default Value	Description
$key		The key of the user state variable.
$request		The name of the variable passed in a request.
$default	null	The default value for the variable if not found. Optional.
$type	'none'	Filter for the variable, for valid values see . Optional.

Returns

The request user state.

Defined in

libraries/joomla/application/application.php

Importing

jimport( 'joomla.application.application' );

Source Body

function getUserStateFromRequest( $key, $request, $default = null, $type = 'none' )
{
        $old_state = $this->getUserState( $key );
        $cur_state = (!is_null($old_state)) ? $old_state : $default;
        $new_state = JRequest::getVar($request, null, 'default', $type);
 
        // Save the new value only if it was set in this request
        if ($new_state !== null) {
                $this->setUserState($key, $new_state);
        } else {
                $new_state = $cur_state;
        }
 
        return $new_state;
}

Examples

<CodeExamplesForm />