Convert the characters in a string to uppercase.
VARIABLE I/O DESCRIPTION -------- --- -------------------------------------------------- in I Input string. lenout I Maximum length of output string. out O Output string, all uppercase.
in is the input string. lenout is the maximum allowed length of the output string, including the terminating null.
out is the output string. This is the input string with all lowercase letters converted to uppercase. 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 min ( strlen(in), lenout-1 ) unless lenout is less than or equal to zero. out may overwrite in.
Convert each lowercase character in IN to uppercase.
"This is an example" becomes "THIS IS AN EXAMPLE" "12345 +-=? > * $ &" "12345 +-=? > * $ &"
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.
N.J. Bachman (JPL) K.R. Gehringer (JPL) I.M. Underwood (JPL)
-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 2.0.0, 26-AUG-1999 (NJB) Added string error checks. -CSPICE Version 1.0.0, 08-FEB-1998 (NJB) Based on SPICELIB Version 1.1.0, 13-MAR-1996 (KRG)
convert to uppercase