NameValueRemove

See Also: NamedValueAdd, NamedValueGet, NamedValueIndex, OnGetNavigateForwardData

Purpose

Removes a value for the passed name of a tNameValuePair array that is part of tWebNavigateData during navigation in a mobile web application (drilldown interface).

Returns an array of tNameValuePair data with the name/value pair item removed. If the value was not found, the passed and returned array will be the same.

Return Type

tNameValuePair[]

Syntax

Use NameValuePairFunctions.pkg

Function NamedValueRemove tNameValuePair[] Data String sName Returns tNameValuePair[]

where

• Data: An array of tNameValuePair data that will be searched. Usually the tWebNavigateData.NamedValue member.
• sName: The name that will be searched for.

What It Does

NamedValueRemove is used to remove retrieve the value for a named pair during forward and back navigation in a mobile web application (drilldown interface).

It performs a case-insensitive search for the passed name. If a match is found, the function will remove this from the tNameValuePair array. The new array is returned.

Get NamedValueRemove NavigateData.NamedValues "InvtHeader" to NavigateData.NamedValues

The tNameValuePair array in the NamedValues member is cleared each time a forward navigation starts. Therefore, you don't normally need to remove values from the NamedValues array.