Read Me - Common Public License V1.0 - Copyright Notice(©)

dataType


>>-dataType-+--------+-----------------------------------------><
            +-(type)-+

Returns NUM if you specify no argument and the receiving string is a valid Rexx number that can be added to 0 without error. It returns CHAR if the receiving string is not a valid number.

If you specify [type] , it returns 1 if the receiving string matches the type. Otherwise, it returns 0. If the receiving string is null, the method returns 0 (except when the [type] is X or B, for which [dataType] returns 1 for a null string). The following are valid [type] s. You need to specify only the capitalized letter, or the number of the last type listed. The language processor ignores all characters surrounding it.

Alphanumeric

returns 1 if the receiving string contains only characters from the ranges a-z, A-Z, and 0-9.

Binary

returns 1 if the receiving string contains only the characters 0 or 1, or whitespace. Whitespace characters can appear only between groups of 4 binary characters. It also returns 1 if string is a null string, which is a valid binary string.

Lowercase

returns 1 if the receiving string contains only characters from the range a-z.

Mixed case

returns 1 if the receiving string contains only characters from the ranges a-z and A-Z.

Number

returns 1 if receiving_string~dataType returns NUM.

lOgical

returns 1 if the receiving string is exactly "0" or "1". Otherwise it returns 0.

Symbol

returns 1 if the receiving string is a valid symbol, that is, if SYMBOL(string) does not return BAD. (See .) Note that both uppercase and lowercase alphabetic characters are permitted.

Uppercase

returns 1 if the receiving string contains only characters from the range A-Z.

Variable

returns 1 if the receiving string could appear on the left-hand side of an assignment without causing a SYNTAX condition.

Whole number

returns 1 if the receiving string is a whole number under the current setting of NUMERIC DIGITS.

heXadecimal

returns 1 if the receiving string contains only characters from the ranges a-f, A-F, 0-9, and whitespace characters (as long as whitespace characters appear only between pairs of hexadecimal characters). Also returns 1 if the receiving string is a null string.

9 Digits

returns 1 if receiving_string~dataType("W") returns 1 when NUMERIC DIGITS is set to 9.

String class - datatype method


" 12 "~dataType          ->   "NUM"
""~dataType              ->   "CHAR"
"123*"~dataType          ->   "CHAR"
"12.3"~dataType("N")     ->    1
"12.3"~dataType("W")     ->    0
"Fred"~dataType("M")     ->    1
""~dataType("M")         ->    0
"Fred"~dataType("L")     ->    0
"?20K"~dataType("s")     ->    1
"BCd3"~dataType("X")     ->    1
"BC d3"~dataType("X")    ->    1
"1"~dataType("O")        ->    1
"11"~dataType("O")        ->   0

Note

The [dataType] method tests the meaning or type of characters in a string, independent of the encoding of those characters (for example, ASCII or EBCDIC).

Read Me - Common Public License V1.0 - Copyright Notice(©)