Functions and CALL Routines

DQPARSEINFOGET Function

Returns the token names in a parse definition.

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

Syntax

DQPARSEINFOGET ('parse-definition' <,'locale'>)

parse-definition

specifies the name of the parse definition. The definition must exist in the locale that is used.

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.

The DQPARSEINFOGET function returns the names of the tokens that can be inserted into character values using the DQPARSETOKENPUT function.

The following example returns the token names for the parse definition e-mail in the locale ENUSA and displays the token names in the SAS log.

tokenNames=dqParseInfoGet('e-mail','ENUSA');
put tokenNames;

After this function call, the value of TOKENNAMES is Mailbox, Sub-Domain, Top-Level Domain, the names of the three tokens in this parse definition.