Functions and CALL Routines

DQPARSETOKENPUT Function

Inserts a token into a parsed character value and returns the updated parsed character value.

Requirement:	If specified, the locale must be loaded into memory as part of the locale list.
Valid in:	DATA step and SCL

Syntax
Arguments
Details
See Also

Syntax

DQPARSETOKENPUT ('char','parse-definition', 'token-name','token-value' <,'locale'>)

Arguments

char

specifies a character constant, variable, or expression that contains the value that is the parsed character value that receives the new token value.

parse-definition

is the name of the parse definition. The definition must exist in the locale that is used. The parse definition must be the same definition that was used to parse the parsed-char value.

token-name

is the name of the token. The specified token must be enabled by the parse definition.

token-value

is the value of the token that is to be inserted into parsed-char.

locale

specifies a character constant, variable, or expression that contains the locale name.

Default:

The default locale is the first locale in the locale list. If no value is specified, the default locale is used.

Details

The DQPARSETOKENPUT function enables you to insert a new value that is associated with a specified token into a parsed value. If a value exists for that token in the input value, the new value is inserted before the existing value. The existing value is retained.

You can specify a variable name for the value of parsed-char, and then assign the return value from DQPARSETOKENPUT to the same variable.