VALPOS()
Numerical value of a character at a certain position
- Syntax
-
- VALPOS (<cString>, [<nPosition>]) --> nDigitValue
- Arguments
-
- <cString> is the processed string [<nPosition>] is an optional position within <cString> Default: last position in <cString>
- Returns
-
- <nDigitValue> the numerical value of the character at the specified position
- Description
-
- The VALPOS() function returns the numerical value of the character that can be found at the position <nPosition> in <cString>. If no digit can be found at this position or if <nPosition> is larger than the length of <cString>, 0 is returned.
Examples
? valpos ("1234x56789") --> 9
? valpos ("1234x56789",1) --> 1
Tests
valpos ("1234x56789") == 9
valpos ("1234x56789",1) == 1
valpos ("1234x56789",11) == 0 // to large !
valpos ("1234x56789",5) == 0 // "x" is not a digit !
- Status
- Ready
- Compliance
-
- VALPOS() is compatible with CT3's VALPOS().
- Platforms
-
- All
- Files
-
- Source is asciisum.c, library is libct.
- See Also