The Datatype function is used to assess whether a value is of a certain type.
| result = Datatype( string [, type ] ) |
A Alphanumeric -- returns 1 if string contains only letters and digits
B Binary -- returns 1 if string contains only '0' or '1' digits
L Lower case -- returns 1 if string contains only lower case letters
M Mixed case -- returns 1 if string contains only letters
N Number -- returns 1 if string is a Rexx numeric value
S Symbol -- returns 1 if string contains only characters that are valid in Rexx symbols
U Upper case -- returns 1 if string contains only upper case letters
W Whole number -- returns 1 if string is a Rexx whole number as constrained by the current setting of numeric digits.
Observe: when the number of digits within a whole number exceeds the numeric digits setting, exponential notation is necessary, and the number could be rounded. Consequently, such large numbers are not considered to be a whole number.
X heXadecimal -- returns 1 if string contains only hexadecimal characters, or if the string is empty. Spaces are permitted at hexadecimal digit pair boundaries.
In the above cases, when the type of the value does not match 0 is returned.
When the type argument is omitted, the Datatype function returns
NUM if string is a Rexx numeric value
CHAR if string is NOT a Rexx numeric value
|
Examples:
say Datatype( ' 7 ') -- shows NUM say Datatype( 'shazam' ) -- shows CHAR say Datatype( ' 7 ', 'N' ) -- shows 1 say Datatype( ' 7.1 ', 'W' ) -- shows 0 say Datatype( 'm3', 'A' ) -- shows 1 say Datatype( 'shazam', 'L' ) -- shows 1 say Datatype( 'Shazam', 'M' ) -- shows 1 say Datatype( 'SHAZAM', 'U' ) -- shows 1 say Datatype( 'm.3', 'S' ) -- shows 1 say Datatype( '1101', 'B' ) -- shows 1 say Datatype( '2BAD', 'X' ) -- shows 1 say Datatype( '0 2BAD', 'X' ) -- shows 1 say Datatype( 'BACK', 'X' ) -- shows 0 say Datatype( '', 'X' ) -- shows 1 ! |