Next: astChrLen - Determine the used length of a string
Up: AST Memory Management and Utility Functions
Previous: astChr2Double - read a double value from a string
astChrCase
-
Convert a string to upper or lower case
- Description:
- This function converts a supplied string to upper or lower case,
storing the result in a supplied buffer. The astStringCase function
is similar, but stores the result in a dynamically allocated buffer.
- Synopsis:
- void astChrCase( const char
in, char
out, int upper, int blen, int
status )
- Parameters:
-
in
-
Pointer to the null terminated string to be converted. If this
is NULL, the supplied contents of the "out" string are used as
the input string.
-
out
-
Pointer to the buffer to receive the converted string. The
length of this buffer is given by "blen". If NULL is supplied
for "in", then the supplied contents of "out" are converted and
written back into "out" over-writing the supplied contents.
-
upper
-
If non-zero, the string is converted to upper case. Otherwise it
is converted to lower case.
-
blen
-
The length of the output buffer. Ignored if "in" is NULL. No
more than "blen - 1" characters will be copied from "in" to
"out", and a terminating null character will then be added.
Next: astChrLen - Determine the used length of a string
Up: AST Memory Management and Utility Functions
Previous: astChr2Double - read a double value from a string
AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 211
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk
Copyright (C) 2009 Science \& Technology Facilities Council