StringTools
Iota
generate string containing character ranges
Calling Sequence
Parameters
Description
Examples
Iota( n )
Iota( m .. n )
Iota( m, n )
m
-
positive integer or character
n
The Iota procedure generates strings containing character ranges. Called with one argument n, a positive integer or a character, it generates the string consisting of those characters whose ASCII values are in the range 1..n, inclusive. If n is a character (a string of length equal to one), it is equivalent to its ASCII value, given by the Ord procedure.
If Iota is called with two integer arguments (or two character arguments, again taken to be equivalent to their ASCII values), the character string consisting of the characters that fall numerically (in the ASCII character set) between those two values is generated.
The call Iota( m .. n ) is equivalent to Iota( m, n ).
When both m and n are specified, the numeric value of m must be less than or equal to n. Both m and n (or their ASCII numeric equivalent values) must be in the range 1..255.
All of the StringTools package commands treat strings as (null-terminated) sequences of 8-bit (ASCII) characters. Thus, there is no support for multibyte character encodings, such as unicode encodings.
with( StringTools ):
length( Iota( 255 ) ); # Iota( 255 ) contains control characters
255
Iota( 42 .. 56 );
*+,-./012345678
Iota( 42, 56 );
Iota( "a" .. "z" );
abcdefghijklmnopqrstuvwxyz
Iota( "a", "z" );
Iota( "@", "@" );
@
Maple returns an error if the numeric value of the first parameter m is greater than that of the second parameter n.
Iota( "z" .. "a" );
Error, (in StringTools:-Iota) left endpoint of range must be less than or equal to the right endpoint
See Also
string
StringTools[Char]
StringTools[Ord]
Download Help Document