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