// Purpose: interface of wxStringTokenizer
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
/**
In this mode, the empty tokens in the middle of the string will be returned,
- i.e. @c "a::b:" will be tokenized in three tokens @c 'a', " and @c 'b'. Notice
- that all trailing delimiters are ignored in this mode, not just the last one,
+ i.e. @c "a::b:" will be tokenized in three tokens @c 'a', @c '' and @c 'b'.
+ Notice that all trailing delimiters are ignored in this mode, not just the last one,
i.e. a string @c "a::b::" would still result in the same set of tokens.
*/
wxTOKEN_RET_EMPTY,
@library{wxbase}
@category{data}
- @see wxStringTokenize()
+ @see ::wxStringTokenize()
*/
class wxStringTokenizer : public wxObject
{
const wxString& delims = " \t\r\n",
wxStringTokenizerMode mode = wxTOKEN_DEFAULT);
};
+
+
+/** @addtogroup group_funcmacro_string */
+//@{
+
+/**
+ This is a convenience function wrapping wxStringTokenizer which simply
+ returns all tokens found in the given @a str as an array.
+
+ Please see wxStringTokenizer::wxStringTokenizer for the description
+ of the other parameters.
+
+ @return The array with the parsed tokens.
+
+ @header{wx/string.h}
+*/
+wxArrayString
+wxStringTokenize(const wxString& str,
+ const wxString& delims = wxDEFAULT_DELIMITERS,
+ wxStringTokenizerMode mode = wxTOKEN_DEFAULT);
+
+//@}