Next: astChrSplitC - Split a string using a specified character delimiter
Up: AST Memory Management and Utility Functions
Previous: astChrMatchN - Case insensitive string comparison of at most N characters
astChrSplit
-
Extract words from a supplied string
- Description:
- This function extracts all space-separated words form the supplied
string and returns them in an array of dynamically allocated strings.
- Synopsis:
- char

astChrSplit_( const char
str, int
n )
- Parameters:
-
str
-
Pointer to the string to be split.
-
n
-
Address of an int in which to return the number of words returned.
- Returned Value:
-
astChrSplit()
-
A pointer to a dynamically allocated array containing "
n" elements.
Each element is a pointer to a dynamically allocated character
string containing a word extracted from the supplied string. Each
of these words will have no leading or trailing white space.
- Notes:
- A NULL pointer is returned if this function is invoked with the
global error status set or if it should fail for any reason, or if
the supplied string contains no words.
Next: astChrSplitC - Split a string using a specified character delimiter
Up: AST Memory Management and Utility Functions
Previous: astChrMatchN - Case insensitive string comparison of at most N 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