DQPARSETOKENPUT Function

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

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

Syntax

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

Required Arguments

parsed-char

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

token-value

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

token-name

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

parse-definition

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.

Optional Argument

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.