- Abstract
Convert the characters in a string to lowercase.
- Required_Reading
None.
- Brief_I/O
VARIABLE I/O DESCRIPTION
-------- --- --------------------------------------------------
in I Input string.
lenout I Maximum length of output string.
out O Output string, all lowercase.
- Detailed_Input
in is the input string.
lenout is the maximum allowed length of the output string,
including the terminating null.
- Detailed_Output
out is the output string. This is the input string
with all lowercase letters converted to lowercase.
Non-letters are not affected.
If
lenout < strlen(in)+1
the output string will be truncated on the right.
A terminating null will be placed in out at position
MinVal ( strlen(in), lenout-1 )
unless lenout is less than or equal to zero.
out may overwrite in.
- Parameters
None.
- Particulars
Convert each lowercase character in IN to lowercase.
- Examples
"This is an example" becomes "THIS IS AN EXAMPLE"
"12345 +-=? > * $ &" "12345 +-=? > * $ &"
- Restrictions
None.
- Exceptions
1) If the input string pointer is null, the error
SPICE(NULLPOINTER) will be signaled.
2) If the output string pointer is null, the error
SPICE(NULLPOINTER) will be signaled.
3) If lenout is less than or equal to zero, the error
SPICE(STRINGTOOSHORT) will be signaled.
4) If the output string is shorter than the input string, the
result will be truncated on the right.
- Files
None.
- Author_and_Institution
N.J. Bachman (JPL)
K.R. Gehringer (JPL)
I.M. Underwood (JPL)
- Literature_References
None.
- Version
-CSPICE Version 1.1.0, 26-JAN-2005 (NJB)
Cast to SpiceInt was applied to strlen output to suppress
compiler warnings about comparison of signed and unsigned types.
-CSPICE Version 1.0.0, 26-AUG-1999 (NJB)
Based on SPICELIB Version 1.1.0, 13-MAR-1996 (KRG)
- Index_Entries
convert to lowercase
- Link to routine source