/usr/include/wvstreams/wvstringlist.h is in libwvstreams-dev 4.6.1-7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 | /* -*- Mode: C++ -*-
* Worldvisions Weaver Software:
* Copyright (C) 1997-2002 Net Integration Technologies, Inc.
*
* WvStrings are used a lot more often than WvStringLists, so the List need
* not be defined most of the time. Include this file if you need it.
*
*/
#ifndef __WVSTRINGLIST_H
#define __WVSTRINGLIST_H
#include "wvstring.h"
#include "wvlinklist.h"
class WvRegex;
DeclareWvList2(WvStringListBase, WvString);
/**
* 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.
*/
class WvStringList : public WvStringListBase
{
// copy constructor: not defined anywhere!
WvStringList(const WvStringList &l);
public:
/**
* Instatiate a new WvStringList()
*/
WvStringList() {}
/**
* concatenates all elements of the list seperating on joinchars
*/
WvString join(const char *joinchars = " ") const;
/**
* 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"
*/
void split(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 splitstrict(WvStringParm s, const char *splitchars = " \t\r\n",
int limit = 0);
#ifndef _WIN32
/**
* 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
*/
void split(WvStringParm s, const WvRegex ®ex, int limit = 0);
#endif
/*
* populate the list from an array of strings
*/
void fill(const char * const *array);
void append(WvStringParm str);
void append(WVSTRING_FORMAT_DECL)
{ append(WvString(WVSTRING_FORMAT_CALL)); }
void append(WvString *strp, bool autofree, char *id = NULL);
/**
* get the first string in the list, or an empty string if the list is empty.
* Removes the returned string from the list.
*/
WvString popstr();
};
#endif // __WVSTRINGLIST_H
|