Returns the length in characters of a char or varchar
expression, or number of strings/items in other types. The syntax is
length(value[, mode])
For example:
SELECT NAME, length(NAME)
FROM SYSTABLES
The results are:
NAME length(NAME) SYSTABLES 9 SYSCOLUMNS 10 SYSINDEX 8 SYSUSERS 8 SYSPERMS 8 SYSTRIG 7 SYSMETAINDEX 12 |
The optional mode argument is a
stringcomparemode-style compare mode to use; see the Vortex manual
on <apicp stringcomparemode> for details on syntax and the
default. If mode is not given, the current apicp
stringcomparemode is used. Currently the only pertinent mode
flag is "iso-8859-1", which determines whether to interpret
value as ISO-8859-1 or UTF-8. This can alter how many characters long
the string appears to be, as UTF-8 characters are variable-byte-sized,
whereas ISO-8859-1 characters are always mono-byte. The mode
argument was added in version 6.
In version 5.01.1226622000 20081113 and later, if given a strlst
type value, length() returns the number of string values
in the list. For other types, it returns the number of values, e.g.
for varint it returns the number of integer values.