Next: FITS-WCS Coverage
Up: AST Memory Management and Utility Functions
Previous: astStringArray - Create an array of C strings from an array of characters
astStringCase
-
Convert a string to upper or lower case
- Description:
- This function converts a supplied string to upper or lower case,
storing the result in dynamically allocated memory. The astChrCase
function is similar, but stores the result in a supplied buffer.
- Synopsis:
- char
astStringCase( const char string, int upper )
- Parameters:
-
string
-
Pointer to the null terminated string to be converted.
-
upper
-
If non-zero, the string is converted to upper case. Otherwise it
is converted to lower case.
- Returned Value:
-
astStringCase()
-
If successful, the function returns a pointer to the start of
the allocated string. The returned memory should be freed using
astFree when no longer needed.
- Notes:
- A pointer value of NULL is returned if this function is
invoked with the global error status set or if it fails for any
reason.
Next: FITS-WCS Coverage
Up: AST Memory Management and Utility Functions
Previous: astStringArray - Create an array of C strings from an array of characters
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