DQPARSETOKENPUT Function

parsed-char

is the parsed character value that receives the new token value, according to the specified parse definition. The parsed-char value can be the name of a character variable, a character value in quotation marks, or an expression that evaluates to a variable name or a quoted value.

token-value

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

token-name

specifies the name of the token that is to be inserted into the parsed value. The specified token must be enabled by the specified parse definition.

parse-definition

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

locale

(optional) specifies the name of the locale that contains the specified parse definition. The value can be a name in quotation marks, the name of a variable whose value is a locale name, or an expression that evaluates to a variable name or to a quoted locale name.

The specified locale must be loaded into memory as part of the locale list. If no value is specified, the default locale is used. The default locale is the first locale in the locale list. For information on the locale list, see Load and Unload Locales.

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

As shown in the example that is referenced below, you can specify a variable name as the value of the parsed-char argument, and then assign the return value from the function to the same variable.

• DQGENDERINFOGET Function for an example that uses the DQPARSETOKENPUT function.

• DQPARSETOKENGET Function.

• DQMATCHPARSED Function.

• DQGENDERPARSED Function.

Copyright © 2007 by SAS Institute Inc., Cary, NC, USA. All rights reserved.