WvStringList Class Reference

#include <wvstringlist.h>

List of all members.


Detailed Description

This is a WvList of WvStrings, and is a really handy way to parse strings.

If you ever find yourself using strtok(3) or strpbrk(3), or find yourself needing to parse a line of input, WvStringList, WvStringList::split(), and WvStringList::popstr() are probably what you want, and avoid all sorts of nasty security bugs caused by doing it any other way.

Definition at line 27 of file wvstringlist.h.

Public Member Functions

 WvStringList ()
 Instatiate a new WvStringList().
WvString join (const char *joinchars=" ") const
 concatenates all elements of the list seperating on joinchars
void split (WvStringParm s, const char *splitchars=" \t\r\n", int limit=0)
 split s and form a list ignoring splitchars (except at beginning and end) ie.
void splitstrict (WvStringParm s, const char *splitchars=" \t\r\n", int limit=0)
 split s and form a list creating null entries when there are multiple splitchars ie " happy birthday to you" split on " " will populate the list with "" "happy" "birthday" "" "to" "" "you"
void split (WvStringParm s, const WvRegex &regex, int limit=0)
 split s and form a list ignoring regex (except at beginning and end) Note that there is no splitstrict for regexes, since the differece is taken care of through the regex (.
void fill (const char *const *array)
void append (WvStringParm str)
void append (WVSTRING_FORMAT_DECL)
void append (WvString *strp, bool autofree, char *id=NULL)
WvString popstr ()
 get the first string in the list, or an empty string if the list is empty.


Member Function Documentation

void WvStringList::split ( WvStringParm  s,
const char *  splitchars = " \t\r\n",
int  limit = 0 
)

split s and form a list ignoring splitchars (except at beginning and end) ie.

" happy birthday to you" split on " " will populate the list with "" "happy" "birthday" "to" "you"

Definition at line 19 of file wvstringlist.cc.

References strcoll_split().

Referenced by encode_hostname_as_DN(), WvIPRouteList::get_kernel(), and WvLogRcv::set_custom_levels().

void WvStringList::split ( WvStringParm  s,
const WvRegex regex,
int  limit = 0 
)

split s and form a list ignoring regex (except at beginning and end) Note that there is no splitstrict for regexes, since the differece is taken care of through the regex (.

..)+ syntax

Definition at line 67 of file wvstringlist.cc.

References strcoll_split().

WvString WvStringList::popstr (  ) 

get the first string in the list, or an empty string if the list is empty.

Removes the returned string from the list.

Definition at line 55 of file wvstringlist.cc.

Referenced by UniClientGen::conncallback().


The documentation for this class was generated from the following files:
Generated on Mon Feb 5 10:54:41 2007 for WvStreams by  doxygen 1.5.1