ICHAR

ICHAR

Let Subcommand

Return the ASCII collating sequence index of the characters in a previously defined string.

Most modern computer platforms use the ASCII collating sequence to code characters. In the ASCII collating sequence, the integers 0 to 255 are used to represent specific characters. Specifically
1. 48 - 57 denote the digits 0 to 9
2. 65 - 90 denote the upper case characters A to Z
3. 97 - 122 denote the lower case characters a to z

The other values represent special characters such as quotes and ampersands or non-printing characters such as tabs, carriage returns, or line feeds.

This command allows you to generate the integer index corresponding to each character in a previously defined string.

LET <ival> = ICHAR <sorg>
where <ival> is a parameter or variable containing the ASCII collating sequence index values;
and <sorg> is a previously defined string.

If <ival> was previously defined as a parameter, only the value corresponding to the first character in <sorg> is returned. If <ival> was previously defined as a variable, then values corresponding to all characters in <sorg> are returned. If <ival> was previously defined as something other than a parameter or a variable, then an error is printed.

If <ival> was not previously defined, then it will saved as a parameter if <sorg> has only one character and it will be saved as a variable if <sorg> has more than one character.

LET IVAL = ICHAR S1

The string on the right hand side of the equal sign must be a previously defined string. String expressions are not allowed. So
LET IVAL = ICHAR ".dat"

should be coded as

LET STRING S1 = .dat LET IVAL = ICHAR S1

None

None

CHARACTER (LET)	= Convert numeric values to strings based on the ASCII collating sequence.
UPPER CASE	= Convert a string to upper case.
LOWER CASE	= Convert a string to lower case.
LET FUNCTION	= Defines a function.
LET STRING	= Defines a string.
READ STRING	= Reads a string from a file.
SUBSTITUTE CHARACTER (^)	= Substitute the value of a string or parameter.
CONCATENATE CHARACTER (&)	= Concatenate two strings.
SUBTRING	= Extract a substring from an existing string.
STRING INDEX	= Extract the start/stop positions of a substring within a string.
STRING CONCATENATE	= Concatenate one or more previously defined strings.
STRING EDIT	= Edit a string.
STRING MERGE	= Insert a string into another string without overwrite.
STRING REPLACE	= Insert a string into another string with overwrite.
STRING LENGTH	= Return the length of a string.
GROUP LABEL	= Define the text for group labels.

Data Management

11/2008

 
LET STRING S1 = file23.dat
LET IVAL = ICHAR S1
    

The resulting values of IVAL are 102, 105, 108, 101, 50, 51, 46, 100, 97, and 116.