RENDER.UNPACKARG

Home > Contents > Index >

Template Tag TOC | Alpha TOC | Tag Family TOC | Purpose TOC | Annotated TOC | Index

RENDER.UNPACKARG

Retrieves a variable from a packedargs string, optionally removing it from the string.

Syntax

<RENDER.UNPACKARG
        PACKED="string containing packed args"
        UNPACK="variable to unpack"
        REMOVE="true | false"
        OUTVAR="name of resultant packed args variable"
        />

Attributes

packed (required): A string containing packed args. Often the value of the packedargs variable.
unpack (required): The name of the encoded key-value pair to remove from the packed string. A new variable of the same name will be created with the retrieved value.
remove (required): Flag specifying whether the key-value pair specified by unpack should be removed from the unpack string or not.
outvar (required): Name of the variable to contain the updated value of the packed string.

Description

This tag extracts a name-value pair from a url-encoded (packed) string. It sets the removed variable into the variable scope for later use. Optionally, it can remove the variable key-value pair entirely. The new packed string is then set as an output variable as well.

In most cases, the packed string will correspond to a variable called packedargs. If outvar is set to packedargs, then the packedargs variable will be overwritten.

errno

The possible values of errno include:


Value	Description
-10004	A required parameter is missing .

Example

The following example is in JSP but the XML syntax is analogous. The following example, taken from the FirstSite Mark II Wrapper CSElement unpacks the rendermode variable so that it can be passed into another tag. The rendermode variable is not removed from the packedargs string, leaving the packedargs variable unchanged.

<render:unpackarg unpack="rendermode" remove="false" 
        packed='<%=ics.GetVar("packedargs")%>' outvar="packedargs"/>