next up previous 264
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 up previous 264
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