---

7.5.2.1 Text Functions

• - integer ‘alpha’(text s, integer x);

  is the base x integral interpretation of s. s is expected some sequence of base x digit characters, possibly prefixed (the sequence, not the characters) by some mix of white spaces and sign characters (minuses and pluses, that is). In bases above 10, the letter ‘a’ in either upper or lower cases represents 10, ‘b’ represents 11, and so forth, with ‘z’ representing 35. x is expected between 2 and 36 inclusive. Or zero, in which case the base is assumed 16 if the digits sequence is immediately prefixed by ‘0x’, 8 if the sequence starts with ‘0’, 10 otherwise.

• - real ‘atof’(text s);

  is the real decimal interpretation of s. s is expected some sequence of decimal digit characters, possibly including a single period sign (‘.’), though not in last position, possibly prefixed (the sequence, not the characters) by some mix of white spaces and sign characters (minuses and pluses, that is).

• - integer ‘atoi’(text s);

  is the integral decimal interpretation of s. s is expected some sequence of decimal digit characters, possibly prefixed (the sequence, not the characters) by some mix of white spaces and sign characters (minuses and pluses, that is). Same as ‘alpha’(s, 10).

• - cardinal ‘aton’(text s);

  is the cardinal decimal interpretation of s. s is expected some sequence of decimal digit characters, possibly prefixed (the sequence, not the characters) by some white spaces.

• - text ‘basename’(text s);

  is the basename of s, what follows the last occurring ‘/’

• - text ‘bfxa’(integer b, integer f, integer x, integer m);

  is the base x, f digits, b wide comma separated blocks representation of m

• - text ‘bfxcardinal’(integer b, integer f, integer x, cardinal z);

  is the base x, f digits, b wide comma separated blocks representation of z

• - text ‘bfxinteger’(integer b, integer f, integer x, integer m);

  is the base x, f digits, b wide comma separated blocks representation of m (same as ‘bfxa’(b, f, x, m))

• - text ‘cat’(text s1, text s2);

  is the concatenation of s1 and s2

• - text ‘cat2’(text s1, text s2);

  is same as ‘cat’(s1, s2)

• - text ‘cat3’(text s1, text s2, text s3);

  is the concatenation of s1, s2 and s3

• - text ‘cat4’(text s1, text s2, text s3, text s4);

  is the concatenation of s1, s2, s3 and s4

• - text ‘cut’(text string, integer offset, integer length);

  is the length long (shorter if fewer characters are available) substring starting from offset in string if offset is a valid position indication, s otherwise

• - text ‘delete’(text s, integer p);

  is the p indexed character deleted s string (negative position indications are interpreted with respect to the end of string) if p is a valid position indication, s otherwise

  See Negative Indices.

• - cardinal ‘digit’(text s, integer x);

  is the base x integral interpretation of s. s is expected some sequence of base x digit characters. In bases above 10, the letter ‘a’ in either upper or lower cases represents 10, ‘b’ represents 11, and so forth, with ‘z’ representing 35. x is expected between 2 and 36 inclusive. Or zero, in which case the base is assumed 16 if the digits sequence is immediately prefixed by ‘0x’, 8 if the sequence starts with ‘0’, 10 otherwise.

• - text ‘erase’(text s, integer p, integer q);

  is the p to q indexed characters deleted s string (negative position indications are interpreted with respect to the end of string) if p and q are valid position indications, s otherwise

  See Negative Indices.

• - text ‘insert’(text s, integer p, integer c);

  is the before p indexed character c character inserted s string (negative position indications are interpreted with respect to the end of string) if p is a valid position indication, s otherwise

• - text ‘itoa’(integer m);

  is the decimal representation of m (same as ‘bfxa’(0, 0, 10, m) or ‘bfxinteger’(0, 0, 10, m))

• - text ‘ntoa’(cardinal z);

  is the decimal representation of z (same as ‘bfxcardinal’(0, 0, 10, z))