Functions and CALL Routines |
Returns a parsed character value and a status flag.
Restriction: |
Always use the DQPARSETOKENGET function
to extract tokens from parsed values. To extract tokens from values that do
not contain delimiters, use the DQTOKEN function.
|
Requirement: |
If specified, the locale must be loaded
into memory as part of the locale list.
|
Valid in: |
DATA step, PROC SQL, and SCL
|
CALL DQPARSE ( parse-definition,'parse-result',
parse-return-code,parse-string,'< locale>')
|
- parse-definition
-
is the name of the parse definition. The definition must
exist in the locale that is used.
- parse-result
-
is an output character variable that receives the result
of the parse operation.
- parse-return-code
-
is an output numeric variable that returns 1 when the parse
operation is successful. Otherwise, this variable receives a 0.
- parse-string
-
is the input value that is parsed according to the specified
parse definition. The value must be the name of a character variable, or a
character value in quotation marks. Also valid, an expression that evaluates
to a variable name or quoted value.
- 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 DQPARSE CALL routine returns a parsed character value
and a return code into separate variables. The parsed character value contains
delimiters that identify the elements in the value that correspond to the
tokens that are enabled by the parse definition. The delimiters in the value
allow functions such as DQPARSETOKENGET to access the elements in the value
based on specified token names.
The following example parses the name of an individual.
data a;
length parsename $ 40;
call dqparse (name, 'Name', parsename, solution);
if solution= 1 then
put 'found solution';
else
put 'no solution';
run;
Copyright © 2010 by SAS Institute Inc., Cary, NC, USA. All rights reserved.