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