pstring.h File Reference

#include <string>
#include <vector>
#include <ptlib/array.h>

Go to the source code of this file.

Classes
class	PString
class	PCaselessString
class	PStringStream
class	PStringArray
class	PStringList
class	PSortedStringList
class	PStringSet
class	PStringDictionary< K >
class	POrdinalToString
struct	POrdinalToString::Initialiser
	Structure for static array initialiser for class. More...
class	PStringToOrdinal
struct	PStringToOrdinal::Initialiser
	Structure for static array initialiser for class. More...
class	PStringToString
struct	PStringToString::Initialiser
	Structure for static array initialiser for class. More...
class	PRegularExpression
Defines
#define	PDECLARE_STRING_DICTIONARY(cls, K)
#define	PSTRING_DICTIONARY(cls, K)   typedef PStringDictionary<K> cls
Functions
PString	psprintf (const char *fmt,...)
PString	pvsprintf (const char *fmt, va_list arg)
	PBASEARRAY (PWCharArray, wchar_t)
ostream &	operator<< (ostream &stream, const PString &string)
wostream &	operator<< (wostream &stream, const PString &string)

---

Define Documentation

#define PDECLARE_STRING_DICTIONARY	(	cls,
		K		)

Value:

PDECLARE_CLASS(cls, PStringDictionary<K>) \
  protected: \
    cls(int dummy, const cls * c) \
      : PStringDictionary<K>(dummy, c) { } \
  public: \
    cls() \
      : PStringDictionary<K>() { } \
    virtual PObject * Clone() const \
      { return PNEW cls(0, this); } \

Begin declaration of a dictionary of strings class. This macro is used to declare a descendent of PAbstractList class, customised for a particular key type { K} and data object type PString#.

If the compilation is using templates then this macro produces a descendent of the PStringDictionary# template class. If templates are not being used then the macro defines a set of inline functions to do all casting of types. The resultant classes have an identical set of functions in either case.

See the PStringDictionary# and PAbstractDictionary# classes for more information.

#define PSTRING_DICTIONARY	(	cls,
		K		)	typedef PStringDictionary<K> cls

Declare a dictionary of strings class. This macro is used to declare a descendent of PAbstractDictionary class, customised for a particular key type { K} and data object type PString#. This macro closes the class declaration off so no additional members can be added.

If the compilation is using templates then this macro produces a typedef of the PStringDictionary# template class.

See the PStringDictionary# class and PDECLARE_STRING_DICTIONARY# macro for more information.

---

Function Documentation

wostream& operator<<	(	wostream &	stream,
		const PString &	string
	)			[inline]

ostream& operator<<	(	ostream &	stream,
		const PString &	string
	)			[inline]

PBASEARRAY	(	PWCharArray	,
		wchar_t
	)

PString psprintf	(	const char *	fmt,
			...
	)

The same as the standard C snprintf(fmt, 1000, ...), but returns a PString instead of a const char *.

Parameters:

cfmt	C string for output format.

PString pvsprintf	(	const char *	fmt,
		va_list	arg
	)

The same as the standard C vsnprintf(fmt, 1000, va_list arg), but returns a PString instead of a const char *.

Parameters:

cfmt	C string for output format.
args	Extra parameters for sprintf()# call.

---