string-length - the length of a string
(import (rnrs)) ;R6RS
(import (rnrs base)) ;R6RS
(import (scheme r5rs)) ;R7RS
(import (scheme base)) ;R7RS
Returns, as an exact integer object, the number of elements in string.
The length of a string is fixed.
All extant implementations use fixnums to represent string lengths, but this is
not required.
Returns a single value which is the length of the string.
(string-length "ABC")
=> 3
The string-length procedure often appears in code that decodes or encodes
data in some protocol or file format or that formats or parses strings.
Sometimes an alternative is to use higher-order procedures
(string-for-each(3scm), string-map(3scm)) or string ports
(open-input-string(3scm), open-output-string(3scm)).
Apart from error handling, this procedure is the same in all Scheme reports.
This procedure can raise exceptions with the following condition types:
- &assertion (R6RS)
- The wrong number of arguments was passed or an argument was outside its
domain.
- R7RS
- The assertions described above are errors. Implementations may signal an
error, extend the procedure's domain of definition to include such
arguments, or fail catastrophically.
R4RS, IEEE Scheme, R5RS, R6RS, R7RS