utf/v_lowercase [ Functions ]
NAME
v_lowercase -- turn the string into lowercase
SYNOPSIS
200 natural idx = v_lowercase(dst, src);
FUNCTION
The function converts the src string into lowercase. The converted letters are stored on the top of the dst stack. If the input string is found to be lowercase by itself, the top of the stack is restored and NATURAL_MAX is returned.
INPUTS
- dst - a string reporitory to store the lowercase string
- src - the char pointer to the string; it must not change while doing the conversion
RESULT
- idx - an index to the dst string repository to the beginning of the lowercase string or NATURAL_MAX if the input string was already lowercase