WideString-Klasse. Mehr ...

Öffentliche Methoden
size_t	byteLength () const
	Länge des Strings in Byte. Mehr ...

size_t	capacity () const
	Anzahl Zeichen, die in den bereits allokierten Speicher passen. Mehr ...

void	clear () throw ()
	String leeren. Mehr ...

bool	isEmpty () const
	Prüft, ob der String leer ist. Mehr ...

bool	isFalse () const
	Prüft, ob der String "unwahr" ist. Mehr ...

bool	isInteger () const
	Prüft, ob der String einen Integer Wert enthält. Mehr ...

bool	isNumeric () const
	Prüft, ob der String nummerisch ist. Mehr ...

bool	isTrue () const
	Prüft, ob der String "wahr" ist. Mehr ...

WideString	left (size_t len) const
	Linken Teilstring zurückgeben. Mehr ...

size_t	len () const
	Länge des Strings. Mehr ...

size_t	length () const
	Länge des Strings. Mehr ...

WideString	mid (size_t start, size_t len=(size_t)-1) const
	Teilstring zurückgeben. Mehr ...

bool	notEmpty () const
	Prüft, ob der String Zeichen enthält. Mehr ...

void	reserve (size_t size)
	Reserviert Speicher für den String. Mehr ...

WideString	right (size_t len) const
	Rechten Teilstring zurückgeben. Mehr ...

size_t	size () const
	Länge des Strings. Mehr ...

int	strCaseCmp (const WideString &str, size_t size=(size_t)-1) const
	Stringvergleich mit Ignorierung von Gross-/Kleinschreibung. Mehr ...

int	strcmp (const WideString &str, size_t size=(size_t)-1) const
	Führt einen Vergleich mit einem anderen String durch. Mehr ...

WideString	substr (size_t start, size_t len=(size_t)-1) const
	Teilstring zurückgeben. Mehr ...

Konstruktoren und Destruktor
	WideString () throw ()
	Konstruktor für leeren String. Mehr ...

	WideString (const wchar_t *str)
	Konstruktor aus Wide-Character-String. Mehr ...

	WideString (const wchar_t *str, size_t size)
	Konstruktor aus Wide-Character-String mit bestimmer Länge. Mehr ...

	WideString (const WideString *str)
	Konstruktor aus String-Pointer. Mehr ...

	WideString (const WideString &str)
	Konstruktor aus anderem String (Copy-Konstruktor) Mehr ...

	WideString (const String *str)
	Konstruktor aus String-Pointer. Mehr ...

	WideString (const String &str)
	Konstruktor aus anderem String (Copy-Konstruktor) Mehr ...

	WideString (const std::string &str)
	Konstruktor aus Standard-Template String. Mehr ...

	WideString (const std::wstring &str)
	Konstruktor aus Standard-Template Wide-String. Mehr ...

	~WideString () throw ()
	Destruktor. Mehr ...

String setzen und verändern
WideString &	set (const char *str, size_t size=(size_t)-1)
	String anhand eines C-Strings setzen. Mehr ...

WideString &	set (const wchar_t *str, size_t size=(size_t)-1)
	String anhand eines wchar_t* setzen. Mehr ...

WideString &	set (const WideString *str, size_t size=(size_t)-1)
	String anhand eines String-Pointers setzen. Mehr ...

WideString &	set (const WideString &str, size_t size=(size_t)-1)
	Wert eines anderen Strings übernehmen. Mehr ...

WideString &	set (const String *str, size_t size=(size_t)-1)
	Wert eines anderen Strings übernehmen. Mehr ...

WideString &	set (const String &str, size_t size=(size_t)-1)

WideString &	set (const std::string &str, size_t size=(size_t)-1)
	Wert eines Strings der STL übernehmen. Mehr ...

WideString &	set (const std::wstring &str, size_t size=(size_t)-1)
	Wert eines Wide-Strings der STL übernehmen. Mehr ...

WideString &	set (wchar_t c)
	Einzelnes Unicode-Zeichen übernehmen. Mehr ...

WideString &	set (size_t position, wchar_t c)
	Einzelnes Zeichen ersetzen. Mehr ...

WideString &	setf (const char *fmt,...)
	Erzeugt einen formatierten String. Mehr ...

WideString &	append (const char *str, size_t size=(size_t)-1)
	Fügt einen C-String an das Ende des bestehenden an. Mehr ...

WideString &	append (const wchar_t *str, size_t size=(size_t)-1)
	Fügt einen Wide-Character String an das Ende des bestehenden an. Mehr ...

WideString &	append (const WideString *str, size_t size=(size_t)-1)
	Fügt einen als Pointer übergebenen String an das Ende des bestehenden an. Mehr ...

WideString &	append (const WideString &str, size_t size=(size_t)-1)
	Fügt einen String an das Ende des bestehenden an. Mehr ...

WideString &	append (const std::string &str, size_t size=(size_t)-1)
	Fügt einen std::string an das Ende des bestehenden an. Mehr ...

WideString &	append (const std::wstring &str, size_t size=(size_t)-1)
	Fügt einen std::wstring an das Ende des bestehenden an. Mehr ...

WideString &	appendf (const char *fmt,...)
	Fügt einen Formatierten String an das Ende des bestehenden an. Mehr ...

WideString &	append (wchar_t c)
	Einzelnes Unicode-Zeichen anhängen. Mehr ...

WideString &	prepend (const char *str, size_t size=(size_t)-1)
	Fügt einen C-String am Anfang des bestehenden Strings ein. Mehr ...

WideString &	prepend (const wchar_t *str, size_t size=(size_t)-1)
	Fügt einen Wide-Character String am Anfang des bestehenden Strings ein. Mehr ...

WideString &	prepend (const WideString *str, size_t size=(size_t)-1)
	Fügt einen String am Anfang des bestehenden Strings ein. Mehr ...

WideString &	prepend (const WideString &str, size_t size=(size_t)-1)
	Fügt einen String am Anfang des bestehenden Strings ein. Mehr ...

WideString &	prepend (const std::string &str, size_t size=(size_t)-1)
	Fügt einen std::string der STL am Anfang des bestehenden Strings ein. Mehr ...

WideString &	prepend (const std::wstring &str, size_t size=(size_t)-1)
	Fügt einen std::wstring der STL am Anfang des bestehenden Strings ein. Mehr ...

WideString &	prependf (const char *fmt,...)
	Fügt einen Formatierten String am Anfang bestehenden ein. Mehr ...

WideString &	prepend (wchar_t c)
	Einzelnes Unicode-Zeichen am Anfang einfügen. Mehr ...

WideString &	vasprintf (const char *fmt, va_list args)
	Erzeugt einen formatierten String. Mehr ...

WideString &	repeat (size_t num)
	String wiederholen. Mehr ...

WideString &	repeat (wchar_t unicode, size_t num)
	Füllt den String mit einem Zeichen. Mehr ...

WideString &	repeat (const WideString &str, size_t num)
	String wiederholen. Mehr ...

WideString	repeated (size_t num) const
	String multiplizieren. Mehr ...

void	lowerCase ()
	Wandelt alle Zeichen des Strings in Kleinbuchstaben um. Mehr ...

void	upperCase ()
	Wandelt alle Zeichen des Strings in Grossbuchstaben um. Mehr ...

void	upperCaseWords ()
	Anfangsbuchstaben der Wörter groß Mehr ...

void	trim ()
	Schneidet Leerzeichen, Tabs Returns und Linefeeds am Anfang und Ende des Strings ab. Mehr ...

void	trimLeft ()
	Schneidet Leerzeichen, Tabs Returns und Linefeeds am Anfang des Strings ab. Mehr ...

void	trimRight ()
	Schneidet Leerzeichen, Tabs Returns und Linefeeds am Ende des Strings ab. Mehr ...

void	trim (const WideString &chars)
	Schneidet die definierten Zeichen am Anfang und Ende des Strings ab. Mehr ...

void	trimLeft (const WideString &chars)
	Schneidet die definierten Zeichen am Anfang des Strings ab. Mehr ...

void	trimRight (const WideString &chars)
	Schneidet die definierten Zeichen am Ende des Strings ab. Mehr ...

void	chopRight (size_t num=1)
	Schneidet Zeichen am Ende des Strings ab. Mehr ...

void	chop (size_t num=1)
	Schneidet Zeichen am Ende des Strings ab. Mehr ...

void	chopLeft (size_t num=1)
	Schneidet Zeichen am Anfang des Strings ab. Mehr ...

void	chomp ()
	Schneidet Returns und Linefeeds am Anfanng und Ende des Strings ab. Mehr ...

void	cut (size_t pos)
	Schneidet den String an einer bestimmten Stelle ab. Mehr ...

void	cut (const WideString &letter)
	Schneidet den String beim ersten Auftauchen eines Zeichens/Strings ab. Mehr ...

WideString	strchr (wchar_t c) const

WideString	strrchr (wchar_t c) const

WideString	strstr (const WideString &needle) const
	Teilstring finden. Mehr ...

ssize_t	find (const WideString &needle, ssize_t start=0) const
	Sucht nach einem String. Mehr ...

ssize_t	findCase (const WideString &needle, ssize_t start=0) const
	Sucht nach einem String, Gross-/Kleinschreibung wird ignoriert. Mehr ...

ssize_t	instr (const WideString &needle, size_t start=0) const
	Sucht nach einem String. Mehr ...

ssize_t	instrCase (const WideString &needle, size_t start=0) const
	Sucht nach einem String, Gross-/Kleinschreibung wird ignoriert. Mehr ...

WideString &	stripSlashes ()

WideString &	replace (const WideString &search, const WideString &replacement)
	Ersetzt einen Teilstring durch einen anderen. Mehr ...

WideString &	pregReplace (const WideString &expression, const WideString &replacement, int max=0)

WideString &	pregEscape ()
	Fügt dem String Escape-Zeichen zu, zur Verwendung in einem Match. Mehr ...

bool	pregMatch (const WideString &expression) const
	Der String wird anhand einer Regular Expression durchsucht. Mehr ...

bool	pregMatch (const WideString &expression, Array &matches, size_t maxmatches=16) const
	Der String wird anhand einer Regular Expression durchsucht. Mehr ...

String ausgeben und auslesen
void	print (bool withNewline=false) const throw ()
	String auf STDOUT ausgeben. Mehr ...

void	printnl () const throw ()
	String auf STDOUT mit abschließendem Zeilenumbruch ausgeben. Mehr ...

void	hexDump () const
	Hexdump des Strings ausgeben. Mehr ...

wchar_t	get (ssize_t pos) const
	Einzelnes Zeichen auslesen. Mehr ...

const wchar_t *	getPtr () const
	Pointer auf den internen Unicode-String Mehr ...

ByteArray	toUtf8 () const
	String in UTF8 umwandeln. Mehr ...

String	toString () const

ByteArray	toLocalEncoding () const
	String in Lokale Kodierung umwandeln. Mehr ...

String	toLocalString () const

ByteArray	toEncoding (const char *encoding) const
	String in eine beliebige lokale Kodierung umwandeln. Mehr ...

ByteArray	toUCS4 () const

WideString &	fromUCS4 (const ppluint32 *str, size_t size=(size_t)-1)

WideString &	fromUCS4 (const ByteArrayPtr &bin)

int	toInt () const

unsigned int	toUnsignedInt () const

pplint64	toInt64 () const

ppluint64	toUnsignedInt64 () const

bool	toBool () const

long	toLong () const

unsigned long	toUnsignedLong () const

long long	toLongLong () const

unsigned long long	toUnsignedLongLong () const

float	toFloat () const

double	toDouble () const

const wchar_t *	toWchart () const
	Pointer auf den internen Unicode-String Mehr ...

Operatoren
	operator const wchar_t * () const
	Pointer auf den internen Unicode-String Mehr ...

	operator int () const

	operator unsigned int () const

	operator bool () const

	operator long () const

	operator unsigned long () const

	operator long long () const

	operator unsigned long long () const

	operator float () const

	operator double () const

	operator std::string () const

	operator std::wstring () const

wchar_t	operator[] (ssize_t pos) const
	Einzelnes Zeichen auslesen. Mehr ...

WideString &	operator= (const char *str)
	String übernehmen. Mehr ...

WideString &	operator= (const wchar_t *str)
	String übernehmen. Mehr ...

WideString &	operator= (const WideString *str)
	String übernehmen. Mehr ...

WideString &	operator= (const WideString &str)
	String übernehmen. Mehr ...

WideString &	operator= (const String *str)
	String übernehmen. Mehr ...

WideString &	operator= (const String &str)
	String übernehmen. Mehr ...

WideString &	operator= (const std::string &str)
	String übernehmen. Mehr ...

WideString &	operator= (const std::wstring &str)
	String übernehmen. Mehr ...

WideString &	operator= (wchar_t c)
	Zeichen übernehmen. Mehr ...

WideString &	operator+= (const char *str)
	String addieren. Mehr ...

WideString &	operator+= (const wchar_t *str)
	String addieren. Mehr ...

WideString &	operator+= (const WideString &str)
	String addieren. Mehr ...

WideString &	operator+= (const std::string &str)
	String addieren. Mehr ...

WideString &	operator+= (const std::wstring &str)
	String addieren. Mehr ...

WideString &	operator+= (wchar_t c)
	Zeichen anhängen. Mehr ...

bool	operator< (const WideString &str) const
	Kleiner als. Mehr ...

bool	operator<= (const WideString &str) const
	Kleiner oder gleich. Mehr ...

bool	operator== (const WideString &str) const
	Gleich. Mehr ...

bool	operator!= (const WideString &str) const
	Ungleich. Mehr ...

bool	operator>= (const WideString &str) const
	Größer oder gleich. Mehr ...

bool	operator> (const WideString &str) const
	Größer als. Mehr ...

bool	operator< (const wchar_t *str) const
	Kleiner als. Mehr ...

bool	operator<= (const wchar_t *str) const
	Kleiner oder gleich. Mehr ...

bool	operator== (const wchar_t *str) const
	Gleich. Mehr ...

bool	operator!= (const wchar_t *str) const
	Ungleich. Mehr ...

bool	operator>= (const wchar_t *str) const
	Größer oder gleich. Mehr ...

bool	operator> (const wchar_t *str) const
	Größer als. Mehr ...

Öffentliche, statische Methoden
Statische Funktionen
static void	setGlobalEncoding (const char *encoding)

Private Attribute
wchar_t *	ptr

size_t	s

size_t	stringlen

Ausführliche Beschreibung

Beschreibung:: Diese Klasse kann verwendet werden, um beliebige Strings zu speichern und zu verarbeiten. Dabei braucht sich der Anwender keine Gedanken um den verwendeten Speicher zu machen. Die einzelnen Zeichen des Strings werden intern im Unicode-Format gespeichert. Bei Übernahme eines C-Strings wird erwartet, dass dieser im UTF-8 Format vorliegt, mit der statischen Funktion WideString::setGlobalEncoding kann jedoch auch eine andere Kodierung vorgegeben werden.

Beschreibung der Konstruktoren und Destruktoren

ppl7::WideString::WideString	(	)
throw	(
	)

Beschreibung:: Es wird ein leerer String erstellt.

ppl7::WideString::WideString ( const wchar_t * str )

Beschreibung:: Ein String wird aus einem Wide-Character-String erstellt.

Parameter

str	Wide-Character-String, der mit einem 0-Wert Endet

Ausnahmebehandlung

OutOfMemoryException

ppl7::WideString::WideString	(	const wchar_t *	str,
		size_t	size
	)

Beschreibung:: Ein String wird aus dem Wide-Character-String str erstellt, von dem maximal size Zeichen übernommen werden.

Parameter

str	Wide-Character-String, der mit einem 0-Wert Endet
size	Maximale Anzahl Zeichen, die übernommen werden sollen

Ausnahmebehandlung

OutOfMemoryException

ppl7::WideString::WideString ( const WideString * str )

Beschreibung:: Ein String wird aus einem anderen String erstellt.

Parameter

str	Pointer auf einen anderen String

Ausnahmebehandlung

OutOfMemoryException

ppl7::WideString::WideString ( const WideString & str )

Beschreibung:: Ein String wird aus einem anderen String erstellt.

Parameter

str	Referenz auf einen anderen String

Ausnahmebehandlung

OutOfMemoryException

ppl7::WideString::WideString ( const String * str )

Beschreibung:: Ein String wird aus einem anderen String erstellt.

Parameter

str	Pointer auf einen anderen String

Ausnahmebehandlung

OutOfMemoryException

ppl7::WideString::WideString ( const String & str )

Beschreibung:: Ein String wird aus einem anderen String erstellt.

Parameter

str	Referenz auf einen anderen String

Ausnahmebehandlung

OutOfMemoryException

ppl7::WideString::WideString ( const std::string & str )

Beschreibung:: Ein String wird aus einem String der Standard-Template-Library (STL) erstellt.

Parameter

str	Referenz auf String der STL

Ausnahmebehandlung

OutOfMemoryException
UnsupportedFeatureException
UnsupportedCharacterEncodingException
CharacterEncodingException

ppl7::WideString::WideString ( const std::wstring & str )

Beschreibung:: Ein String wird aus einem Wide-String der Standard-Template-Library (STL) erstellt.

Parameter

str	Referenz auf Wide-String der STL

Ausnahmebehandlung

OutOfMemoryException

ppl7::WideString::~WideString	(	)
throw	(
	)

Beschreibung:: Der Destructor gibt den durch den String belegten Speicher wieder frei.

Dokumentation der Elementfunktionen

WideString & ppl7::WideString::append	(	const char *	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen C-String an das Ende des bestehenden an. Der String muss entweder UTF-8 kodiert sein, oder es muss mit der statischen Funktion WideString::setGlobalEncoding zuvor eine andere Kodierung gesetzt worden sein.

Parameter

[in]	str	Pointer auf einen Wide-Character String
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException
UnsupportedFeatureException
UnsupportedCharacterEncodingException
CharacterEncodingException

WideString & ppl7::WideString::append	(	const wchar_t *	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen Wide-Character String an das Ende des bestehenden an

Parameter

[in]	str	Pointer auf einen Wide-Character String
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::append	(	const WideString *	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen als Pointer übergebenen String an das Ende des bestehenden an. Ist der Pointer NULL oder der Inhalt des Strings leer, wird der bisherige String beibehalten, es erfolgt keine Exception.

Parameter

[in]	str	Pointer auf ein String-Objekt
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::append	(	const WideString &	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen String an das Ende des bestehenden an.

Parameter

[in]	str	Referenz auf ein String-Objekt
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::append	(	const std::string &	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen std::string an das Ende des bestehenden an.

Parameter

[in]	str	Referenz auf ein String-Objekt der STL
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::append	(	const std::wstring &	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen std::wstring an das Ende des bestehenden an.

Parameter

[in]	str	Referenz auf ein Wide-String-Objekt der STL
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::append ( wchar_t c )

Beschreibung:: Ein einzelnes Unicode-Zeichen c wird in an den String angehangen.

Parameter

c	Unicode-Wert des gewünschten Zeichens

Rückgabe: Referenz auf den String

WideString & ppl7::WideString::appendf	(	const char *	fmt,
			...
	)

Anhand des übergebenen Formatstrings fmt und den optionalen Parametern ... wird ein neuer String gebildet, der an das Ende des bestehenden angehangen wird

Parameter

fmt	Der Formatstring
...	Optionale Parameter

Rückgabe: Referenz auf den String

Example:: int main(int argc, char **argv)

{

String s;

s="Hallo Welt!";

s.appendf (" Es wurden %i Parameter übergeben\n",argc);

s.printnl();

return 0;

}

size_t ppl7::WideString::byteLength ( ) const

Beschreibung:: Diese Funktion gibt die Anzahl Byte zurück, die durch den String belegt werden.

Rückgabe: Anzahl Bytes

size_t ppl7::WideString::capacity ( ) const

Beschreibung:: Diese Funktion liefert die Anzahl Zeichen zurück, die in den derzeitig allokierten Puffer passen, ohne dass neuer Speicher allokiert werden muss.

Rückgabe: Anzahl Zeichen

void ppl7::WideString::chomp ( )

Beschreibung:: Schneidet Returns und Linefeeds am Anfanng und Ende des Strings ab

void ppl7::WideString::chop ( size_t num = 1 )

Beschreibung:: Diese Funktion schneidet num Zeichen vom Ende des Strings ab. Falls num größer als der String ist, bleibt ein leerer String zurück.

Parameter

num	Anzahl Zeichen, die abgeschnitten werden sollen

Siehe auch: Die Funktion ist identisch zu WideString::chopRight

void ppl7::WideString::chopLeft ( size_t num = 1 )

Beschreibung:: Diese Funktion schneidet num Zeichen vom Anfang des Strings ab. Falls num größer als der String ist, bleibt ein leerer String zurück.

Parameter

num	Anzahl Zeichen, die abgeschnitten werden sollen

void ppl7::WideString::chopRight ( size_t num = 1 )

Beschreibung:: Diese Funktion schneidet num Zeichen vom Ende des Strings ab. Falls num größer als der String ist, bleibt ein leerer String zurück.

Parameter

num	Anzahl Zeichen, die abgeschnitten werden sollen

void ppl7::WideString::clear	(	)
throw	(
	)

Beschreibung:: Mit dieser Funktion wird der String geleert und der bisher allokierte Speicher wieder freigegeben.

void ppl7::WideString::cut ( size_t pos )

Beschreibung:: Der String wird an einer bestimmten Stelle einfach abgeschnitten

Parameter

pos	Die Position, an der der String abgeschnitten wird. Bei Angabe von 0 ist der String anschließend komplett leer. Ist `pos` größer als die Länge des Strings, passiert nichts.

void ppl7::WideString::cut ( const WideString & letter )

Der String wird beim ersten Auftauchen eines Zeichens oder eines Strings abgeschnitten.

Parameter

[in] letter Buchstabe oder Buchstabenkombination, an der der String abgeschnitten werden soll. Zeigt der Pointer auf NULL oder ist der String leer, passiert nichts.

ssize_t ppl7::WideString::find	(	const WideString &	needle,
		ssize_t	start = `0`
	)		const

Find sucht nach dem Suchstring needle ab der gewünschten Position start.

Parameter

[in]	needle	Gesuchter Teilstring
[in]	start	Optionale Startposition innerhalb des Suchstrings. Ist der Parameter 0 oder wird er weggelassen, wird der String vom Anfang an durchsucht. Ist der Wert jedoch negativ, wird rückwärts vom Ende des Strings gesucht.

Rückgabe: Liefert die Position innerhalb des Strings, an der der Suchstring gefunden wurde oder -1 wenn er nicht gefunden wurde. Ist needle ein leerer String, liefert die Funktion immer 0 zurück.

ssize_t ppl7::WideString::findCase	(	const WideString &	needle,
		ssize_t	start = `0`
	)		const

Beschreibung:: Diese Funktion sucht innerhalb des aktuellen String nach needle ab der gewünschten Position start. Gross-/Kleinschreibung wird dabei ignoriert.

Parameter

[in]	needle	Gesuchter Teilstring
[in]	start	Optionale Startposition innerhalb des Suchstrings. Ist der Parameter 0 oder wird er weggelassen, wird der String vom Anfang an durchsucht. Ist der Wert jedoch negativ, wird rückwärts vom Ende des Strings gesucht.

Rückgabe: Liefert die Position innerhalb des Strings, an der der Suchstring gefunden wurde oder -1 wenn er nicht gefunden wurde. Ist needle ein leerer String, liefert die Funktion immer 0 zurück.

WideString & ppl7::WideString::fromUCS4	(	const ppluint32 *	str,
		size_t	size = `(size_t)-1`
	)

WideString & ppl7::WideString::fromUCS4 ( const ByteArrayPtr & bin )

wchar_t ppl7::WideString::get ( ssize_t pos ) const

Beschreibung:: Mit dieser Funktion kann der Unicode-Wert eines einzelnen Zeichens an der Position pos ausgelesen werden. Enthält pos einen positiven Wert, wird die Position des Zeichens vom Anfang des Strings ermittelt, wobei 0 dem ersten Zeichen entspricht. Ist der Wert negativ, wird das Zeichen vom Ende des Strings ermittelt, wobei -1 dem letzten Zeichen des Strings entspricht.

Parameter

pos	Position des Zeichens innerhalb des Strings

Rückgabe: Unicode-Wert des Zeichens

Ausnahmebehandlung

OutOfBoundsEception Wird geworfen, wenn die angegebene Position pos ausserhalb des Strings liegt oder der String leer ist.

const wchar_t * ppl7::WideString::getPtr ( ) const

Beschreibung:: Diese Funktion liefert einen Pointer im Format "const wchar_t*" auf den internen Widecharacter-String (Unicode) der Klasse zurück. Falls der String leer ist, wird ein Pointer auf einen leeren String zurückgegeben. Das Ergebnis kann in printf und verwandten Funktionen mit dem Formatstring "%ls" verwendet werden.

Rückgabe: Pointer auf die Widecharacter Repräsentation des Strings.

Beispiel:: void PrintString(const ppl7::String &text)

{

printf ("Der String lautet: %ls\n",text.getPtr());

// oder mittels Operator:

printf ("Der String lautet: %ls\n",(const wchar_t*)text);

}

Siehe auch

Die folgenden Funktionen erfüllen den gleichen Zweck:

const wchar_t * WideString::getPtr() const
const wchar_t * WideString::toWchart() const
WideString::operator const wchar_t *() const

Zu beachten: In Version 6 der PPLib hat diese Funktion den Datentyp "const char *" zurückgeliefert, der den String im systemspezifischen Format beinhaltete (z.B. UTF-8 oder ISO-8859-1). Um dieses Verhalten zu simulieren, kann die Funktion WideString::toLocalEncoding verwendet werden. Beispiel:
void PrintString(const ppl7::String &text)

{

// Nutzung des Operators:

printf ("Der String lautet: %s\n",(const char*)text.toLocalEncoding());

// oder Nutzung der Funktion:

printf ("Der String lautet: %s\n",text.toLocalEncoding().toCharPtr());

}

void ppl7::WideString::hexDump ( ) const

Beschreibung:: Mit dieser zu Debug-Zwecken gedachten Funktion wird der Inhalt des Strings als HexDump auf der Konsole ausgegeben.

ssize_t ppl7::WideString::instr	(	const WideString &	needle,
		size_t	start = `0`
	)		const

Beschreibung:: Diese Funktion sucht nach dem Suchstring needle ab der gewünschten Position start.

Parameter

[in]	needle	Gesuchter Teilstring
[in]	start	Optionale Startposition innerhalb des Suchstrings. Ist der Parameter 0 oder nicht angegeben, wird der String vom Anfang an gesucht.

Rückgabe: Liefert die Position innerhalb des Strings, an der der Suchstring gefunden wurde oder -1 wenn er nicht gefunden wurde. Ist needle ein leerer String, liefert die Funktion immer 0 zurück.

ssize_t ppl7::WideString::instrCase	(	const WideString &	needle,
		size_t	start = `0`
	)		const

Beschreibung:: Diese Funktion sucht nach dem Suchstring needle ab der gewünschten Position start. Gross-/Kleinschreibung wird dabei ignoriert.

Parameter

[in]	needle	Gesuchter Teilstring
[in]	start	Optionale Startposition innerhalb des Suchstrings. Ist der Parameter 0 oder nicht angegeben, wird der String vom Anfang an gesucht.

Rückgabe: Liefert die Position innerhalb des Strings, an der der Suchstring gefunden wurde oder -1 wenn er nicht gefunden wurde. Ist needle ein leerer String, liefert die Funktion immer 0 zurück.

bool ppl7::WideString::isEmpty ( ) const

Beschreibung:: Diese Funktion prüft, ob der String leer ist.

Rückgabe: Ist der String leer, liefert die Funktion true zurück, sonst false.

Siehe auch: WideString::notEmpty

bool ppl7::WideString::isFalse ( ) const

Diese Funktion überprüft den aktuellen String, ob er "unwahr" ist. Dies ist der Fall, wenn eine der folgenden Bedingungen erfüllt ist:

Der String zeigt auf NULL
Die Länge des Strings ist 0
Der String enthält die Ziffer 0
Der String enthält nicht das Wort "true", "wahr", "yes" oder "ja" (Gross-/Kleinschreibung egal)

Rückgabe: Liefert true (1) zurück, wenn der String "unwahr" ist, sonst false (0). Ein Fehlercode wird nicht gesetzt

Siehe auch: CWWideString::IsTrue()

bool ppl7::WideString::isInteger ( ) const

Beschreibung:: Diese Funktion prüft, ob im String einen integer Wert enthält, also nur die Ziffern 0-9 und optional ein Minus am Anfang enthalten sind

Rückgabe: Ist der String ein Integer, wird 1 zurückgegeben. Ist er es nicht oder ist der String leer, wird 0 zurückgegeben.

bool ppl7::WideString::isNumeric ( ) const

Beschreibung:: Diese Funktion prüft, ob im String nur nummerische Zeichen vorhanden sind, also die Ziffern 0-9, Punkt, Komma und Minus.

Rückgabe: Ist der String nummerisch, wird 1 zurückgegeben. Ist er es nicht oder ist der String leer, wird 0 zurückgegeben.

bool ppl7::WideString::isTrue ( ) const

Diese Funktion überprüft den aktuellen String, ob er "wahr" ist. Dies ist der Fall, wenn eine der folgenden Bedingungen erfüllt ist:

Der String enthält eine Ziffer ungleich 0
Der String enthält das Wort "true" (Gross- oder Kleingeschrieben)
Der String enthält das Wort "wahr" (Gross- oder Kleingeschrieben)
Der String enthält das Wort "yes" (Gross- oder Kleingeschrieben)
Der String enthält das Wort "ja" (Gross- oder Kleingeschrieben)

Rückgabe: Liefert true (1) zurück, wenn der String "wahr" ist, sonst false (0). Ein Fehlercode wird nicht gesetzt

Siehe auch: CWWideString::IsFalse()

WideString ppl7::WideString::left ( size_t len ) const

Beschreibung:: Gibt die ersten len Zeichen des Strings als neuen zurück.

Parameter

len	Länge des Teilstrings

Rückgabe: Neuer String

size_t ppl7::WideString::len ( ) const

Beschreibung:: Diese Funktion gibt die Anzahl Zeichen zurück, aus denen der String besteht.

Zu beachten: Die Funktionen WideString::len, WideString::length und WideString::size sind identisch.

Siehe auch: WideString::capacity

Rückgabe: Anzahl Zeichen

size_t ppl7::WideString::length ( ) const

Beschreibung:: Diese Funktion gibt die Anzahl Zeichen zurück, aus denen der String besteht.

Zu beachten: Die Funktionen WideString::len, WideString::length und WideString::size sind identisch.

Siehe auch: WideString::capacity

Rückgabe: Anzahl Zeichen

void ppl7::WideString::lowerCase ( )

Beschreibung:: Diese Funktion wandelt alle Zeichen des Strings in Kleinbuchstaben um. Die genaue Funktionsweise hängt davon ab, welche Spracheinstellungen aktiv sind, genauer vom Wert "LC_CTYPE".

Achtung: Unter UNIX (und möglicherweise anderen Betriebssystemen) werden die Lokalisationseinstellungen der Umgebung nicht automatisch übernommen, sondern stehen standardmäßig auf "C". Dadurch werden nur US-ASCII (ASCII 32 bis 127) umgewandelt. Man sollte daher nach Programmstart mit "setlocale" die gewünschte Spracheinstellung vornehmen.

Beispiel:: #include <locale.h>

...

setlocale(LC_CTYPE,"de_DE.UTF-8");

WideString ppl7::WideString::mid	(	size_t	start,
		size_t	len = `(size_t)-1`
	)		const

Beschreibung:: Gibt len Zeichen des Strings, beginnend ab Position start als neuen String zurück.

Parameter

start	Startposition
len	Optionale Länge des Teilstrings. Ist der Parameter nicht angegeben, wird der komplette String ab Position `start` zurückgegeben.

Rückgabe: Neuer String

bool ppl7::WideString::notEmpty ( ) const

Beschreibung:: Diese Funktion prüft, ob der String Zeichen enthält.

Rückgabe: Enthält der String Zeichen, liefert die Funktion true zurück, sonst false.

Siehe auch: WideString::isEmpty

ppl7::WideString::operator bool ( ) const

ppl7::WideString::operator const wchar_t * ( ) const

Beschreibung:: Diese Funktion liefert einen Pointer im Format "const wchar_t*" auf den internen Widecharacter-String (Unicode) der Klasse zurück. Falls der String leer ist, wird ein Pointer auf einen leeren String zurückgegeben. Das Ergebnis kann in printf und verwandten Funktionen mit dem Formatstring "%ls" verwendet werden.

Rückgabe: Pointer auf die Widecharacter Repräsentation des Strings.

Beispiel:: void PrintString(const ppl7::String &text)

{

printf ("Der String lautet: %ls\n",text.getPtr());

// oder mittels Operator:

printf ("Der String lautet: %ls\n",(const wchar_t*)text);

}

Siehe auch

Die folgenden Funktionen erfüllen den gleichen Zweck:

const wchar_t * WideString::getPtr() const
const wchar_t * WideString::toWchart() const
WideString::operator const wchar_t *() const

Zu beachten: In Version 6 der PPLib hat diese Funktion den Datentyp "const char *" zurückgeliefert, der den String im systemspezifischen Format beinhaltete (z.B. UTF-8 oder ISO-8859-1). Um dieses Verhalten zu simulieren, kann die Funktion WideString::toLocalEncoding verwendet werden. Beispiel:
void PrintString(const ppl7::String &text)

{

// Nutzung des Operators:

printf ("Der String lautet: %s\n",(const char*)text.toLocalEncoding());

// oder Nutzung der Funktion:

printf ("Der String lautet: %s\n",text.toLocalEncoding().toCharPtr());

}

ppl7::WideString::operator double ( ) const

ppl7::WideString::operator float ( ) const

ppl7::WideString::operator int ( ) const

ppl7::WideString::operator long ( ) const

ppl7::WideString::operator long long ( ) const

ppl7::WideString::operator std::string ( ) const

ppl7::WideString::operator std::wstring ( ) const

ppl7::WideString::operator unsigned int ( ) const

ppl7::WideString::operator unsigned long ( ) const

ppl7::WideString::operator unsigned long long ( ) const

bool ppl7::WideString::operator!= ( const WideString & str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters nicht dem des rechten entspricht.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

bool ppl7::WideString::operator!= ( const wchar_t * str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters nicht dem des rechten entspricht.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

WideString & ppl7::WideString::operator+= ( const char * str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str an den bisher vorhandenen String angehangen. Der Operator ist identisch mit der Funktion WideString::append.

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator+= ( const wchar_t * str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str an den bisher vorhandenen String angehangen. Der Operator ist identisch mit der Funktion WideString::append.

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator+= ( const WideString & str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str an den bisher vorhandenen String angehangen. Der Operator ist identisch mit der Funktion WideString::append.

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator+= ( const std::string & str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str an den bisher vorhandenen String angehangen. Der Operator ist identisch mit der Funktion WideString::append.

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator+= ( const std::wstring & str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str an den bisher vorhandenen String angehangen. Der Operator ist identisch mit der Funktion WideString::append.

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator+= ( wchar_t c )

Beschreibung:: Mit diesem Operator wird das angegebene Zeichen c an den bisher vorhandenen String angehangen. Der Operator ist identisch mit der Funktion WideString::append.

Parameter

[in] c Unicode-Wert des anzuhängenden Zeichens

Rückgabe: Referenz auf diese Instanz der Klasse

bool ppl7::WideString::operator< ( const WideString & str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters kleiner dem des rechten ist.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

bool ppl7::WideString::operator< ( const wchar_t * str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters kleiner dem des rechten ist.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

bool ppl7::WideString::operator<= ( const WideString & str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters kleiner oder gleich dem des rechten ist.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

bool ppl7::WideString::operator<= ( const wchar_t * str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters kleiner oder gleich dem des rechten ist.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

WideString & ppl7::WideString::operator= ( const char * str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str kopiert. Der Operator ist identisch mit der Funktion WideString::set

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator= ( const wchar_t * str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str kopiert. Der Operator ist identisch mit der Funktion WideString::set

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator= ( const WideString * str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str kopiert. Der Operator ist identisch mit der Funktion WideString::set

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator= ( const WideString & str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str kopiert. Der Operator ist identisch mit der Funktion WideString::set

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator= ( const String * str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str kopiert. Der Operator ist identisch mit der Funktion WideString::set

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator= ( const String & str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str kopiert. Der Operator ist identisch mit der Funktion WideString::set

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator= ( const std::string & str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str kopiert. Der Operator ist identisch mit der Funktion WideString::set

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator= ( const std::wstring & str )

Beschreibung:: Mit diesem Operator wird der Angegebene String str kopiert. Der Operator ist identisch mit der Funktion WideString::set

Parameter

[in] str Zu kopierender String

Rückgabe: Referenz auf diese Instanz der Klasse

WideString & ppl7::WideString::operator= ( wchar_t c )

Beschreibung:: Mit diesem Operator wird ein einzelnes Zeichen in den String kopiert.

Parameter

[in] c Unicode Wert des zu übernehmenden Zeichens

Rückgabe: Referenz auf diese Instanz der Klasse

bool ppl7::WideString::operator== ( const WideString & str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters mit dem des rechten identisch ist.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

bool ppl7::WideString::operator== ( const wchar_t * str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters mit dem des rechten identisch ist.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

bool ppl7::WideString::operator> ( const WideString & str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters größer dem des rechten ist.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

bool ppl7::WideString::operator> ( const wchar_t * str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters größer dem des rechten ist.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

bool ppl7::WideString::operator>= ( const WideString & str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters größer oder gleich dem des rechten ist.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

bool ppl7::WideString::operator>= ( const wchar_t * str ) const

Beschreibung:: Dieser Operator liefert true zurück, wenn der Wert des linken Parameters größer oder gleich dem des rechten ist.

Parameter

str	Zu vergleichender String

Rückgabe: Liefert true oder false zurück

wchar_t ppl7::WideString::operator[] ( ssize_t pos ) const

Beschreibung:: Mit diesem Operator kann der Unicode-Wert eines einzelnen Zeichens an der Position pos ausgelesen werden. Enthält pos einen positiven Wert, wird die Position des Zeichens vom Anfang des Strings ermittelt, wobei 0 dem ersten Zeichen entspricht. Ist der Wert negativ, wird das Zeichen vom Ende des Strings ermittelt, wobei -1 dem letzten Zeichen des Strings entspricht.

Parameter

pos	Position des Zeichens innerhalb des Strings

Rückgabe: Unicode-Wert des Zeichens

Ausnahmebehandlung

OutOfBoundsEception Wird geworfen, wenn die angegebene Position pos ausserhalb des Strings liegt oder der String leer ist.

WideString & ppl7::WideString::pregEscape ( )

Beschreibung:: Der Befehl scannt den String nach Zeichen mit besonderer Bedeutung in einer Perl-Regular-Expression und escaped diese mit einem Slash. Das Ergebnis kann dann in einer Regular Expression verwendet werden.

Folgende Zeichen werden escaped: - + \ * /

bool ppl7::WideString::pregMatch ( const WideString & expression ) const

Durchsucht den String anhand einer Perl-Expression

Parameter

[in] expression Ist eine Perl-kompatible Regular Expression, die mit Slash (/) beginnt und endet. Optional können nach dem schließenden Slash folgende Optionen angegeben werden:

i caseless
If this bit is set, letters in the pattern match both upper and lower case letters. It is equivalent to Perl's /i option, and it can be changed within a pattern by a (?i) option setting. In UTF-8 mode, PCRE always understands the concept of case for characters whose values are less than 128, so caseless matching is always possible. For characters with higher values, the concept of case is supported if PCRE is compiled with Unicode property support, but not otherwise. If you want to use caseless matching for characters 128 and above, you must ensure that PCRE is compiled with Unicode property support as well as with UTF-8 support.

m multiline
By default, PCRE treats the subject string as consisting of a single line of characters (even if it actually contains newlines). The "start of line" metacharacter (^) matches only at the start of the string, while the "end of line" metacharacter ($) matches only at the end of the string, or before a terminating newline. This is the same as Perl. When "m" it is set, the "start of line" and "end of line" constructs match immediately following or immediately before any newline in the subject string, respectively, as well as at the very start and end. This is equivalent to Perl's /m option, and it can be changed within a pattern by a (?m) option setting. If there are no "\n" characters in a subject string, or no occurrences of ^ or $ in a pattern, setting "m" has no effect.

x extended
If this is set, whitespace data characters in the pattern are totally ignored except when escaped or inside a character class. Whitespace does not include the VT character (code 11). In addition, characters between an unescaped # outside a character class and the next newline character, inclusive, are also ignored.

s dotall
If this bit is set, a dot metacharater in the pattern matches all characters, including newlines. Without it, newlines are excluded. This option is equivalent to Perl's /s option, and it can be changed within a pattern by a (?s) option setting. A negative class such as [^a] always matches a newline character, independent of the setting of this option.

8 UTF8
This option causes PregMatch to regard both the pattern and the subject as strings of UTF-8 characters instead of single-byte character strings. However, it is available only when PCRE is built to include UTF-8 support. If not, the use of this option provokes an error. Details of how this option changes the behaviour of PCRE are given in the section on UTF-8 support in the main pcre page.

a anchored
If this bit is set, the pattern is forced to be "anchored", that is, it is constrained to match only at the first matching point in the string that is being searched (the "subject string"). This effect can also be achieved by appropriate constructs in the pattern itself, which is the only way to do it in Perl.

u ungreedy
This option inverts the "greediness" of the quantifiers so that they are not greedy by default, but become greedy if followed by "?". It is not compatible with Perl. It can also be set by a (?U) option setting within the pattern.
Rückgabe
Liefert true(1) zurück, wenn ein Match gefunden wurde, ansonsten false(0)

Bemerkungen
Der String wird intern zuerst nach UTF-8 kodiert, bevor die pcre-Funktionen aufgerufen werden.

Zu beachten

Diese Funktion ist nur verfügbar, wenn PPL mit dem Configure-Flag –with-pcre konfiguriert und kompiliert wurde.

Falls kein UTF-8 angegeben wird, das System auf dem das Programm läuft aber UTF-8 in LC_CTYPE konfiguriert hat, wird automatisch UTF-8 verwendet.

Falls UTF-8 verwendet wird, der zu vergleichende String aber ungültiges UTF-8 enthält, macht die Funktion ein Fallback auf Singlebyte-Zeichen.

bool ppl7::WideString::pregMatch	(	const WideString &	expression,
		Array &	matches,
		size_t	maxmatches = `16`
	)		const

Durchsucht den String anhand einer Perl-Expression

Parameter

[in] expression Ist eine Perl-kompatible Regular Expression, die mit Slash (/) beginnt und endet. Optional können nach dem schließenden Slash folgende Optionen angegeben werden:

i caseless
If this bit is set, letters in the pattern match both upper and lower case letters. It is equivalent to Perl's /i option, and it can be changed within a pattern by a (?i) option setting. In UTF-8 mode, PCRE always understands the concept of case for characters whose values are less than 128, so caseless matching is always possible. For characters with higher values, the concept of case is supported if PCRE is compiled with Unicode property support, but not otherwise. If you want to use caseless matching for characters 128 and above, you must ensure that PCRE is compiled with Unicode property support as well as with UTF-8 support.

m multiline
By default, PCRE treats the subject string as consisting of a single line of characters (even if it actually contains newlines). The "start of line" metacharacter (^) matches only at the start of the string, while the "end of line" metacharacter ($) matches only at the end of the string, or before a terminating newline. This is the same as Perl. When "m" it is set, the "start of line" and "end of line" constructs match immediately following or immediately before any newline in the subject string, respectively, as well as at the very start and end. This is equivalent to Perl's /m option, and it can be changed within a pattern by a (?m) option setting. If there are no "\n" characters in a subject string, or no occurrences of ^ or $ in a pattern, setting "m" has no effect.

x extended
If this is set, whitespace data characters in the pattern are totally ignored except when escaped or inside a character class. Whitespace does not include the VT character (code 11). In addition, characters between an unescaped # outside a character class and the next newline character, inclusive, are also ignored.

s dotall
If this bit is set, a dot metacharater in the pattern matches all characters, including newlines. Without it, newlines are excluded. This option is equivalent to Perl's /s option, and it can be changed within a pattern by a (?s) option setting. A negative class such as [^a] always matches a newline character, independent of the setting of this option.

8 UTF8
This option causes PregMatch to regard both the pattern and the subject as strings of UTF-8 characters instead of single-byte character strings. However, it is available only when PCRE is built to include UTF-8 support. If not, the use of this option provokes an error. Details of how this option changes the behaviour of PCRE are given in the section on UTF-8 support in the main pcre page.

a anchored
If this bit is set, the pattern is forced to be "anchored", that is, it is constrained to match only at the first matching point in the string that is being searched (the "subject string"). This effect can also be achieved by appropriate constructs in the pattern itself, which is the only way to do it in Perl.

u ungreedy
This option inverts the "greediness" of the quantifiers so that they are not greedy by default, but become greedy if followed by "?". It is not compatible with Perl. It can also be set by a (?U) option setting within the pattern.
Parameter

[out] matches Array, dass die zu kopierenden Werte aufnimmt.

[in] maxmatches Optionaler Parameter, der die maximale Anzahl zu kopierender Werte aufnimmt (Default=16).

Rückgabe
Liefert true(1) zurück, wenn ein Match gefunden wurde, ansonsten false(0)

Bemerkungen
Der String wird intern zuerst nach UTF-8 kodiert, bevor die pcre-Funktionen aufgerufen werden.

Zu beachten

Diese Funktion ist nur verfügbar, wenn PPL mit dem Configure-Flag –with-pcre konfiguriert und kompiliert wurde.

Falls kein UTF-8 angegeben wird, das System auf dem das Programm läuft aber UTF-8 in LC_CTYPE konfiguriert hat, wird automatisch UTF-8 verwendet.

Falls UTF-8 verwendet wird, der zu vergleichende String aber ungültiges UTF-8 enthält, macht die Funktion ein Fallback auf Singlebyte-Zeichen.

WideString& ppl7::WideString::pregReplace	(	const WideString &	expression,
		const WideString &	replacement,
		int	max = `0`
	)

WideString & ppl7::WideString::prepend	(	const char *	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen C-String am Anfang des bestehenden Strings ein

Parameter

[in]	str	Pointer auf einen C-String
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::prepend	(	const wchar_t *	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen Wide-Character String am Anfang des bestehenden Strings ein

Parameter

[in]	str	Pointer auf einen Wide-Character String
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::prepend	(	const WideString *	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen String am Anfang des bestehenden Strings ein

Parameter

[in]	str	Pointer auf einen String
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::prepend	(	const WideString &	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen String am Anfang des bestehenden Strings ein

Parameter

[in]	str	Referenz auf einen String
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::prepend	(	const std::string &	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen std::string der Standard Template Library am Anfang des bestehenden Strings ein

Parameter

[in]	str	Referenz auf einen std::string
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::prepend	(	const std::wstring &	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Fügt einen std::wstring der Standard Template Library am Anfang des bestehenden Strings ein

Parameter

[in]	str	Referenz auf einen std::wstring
[in]	size	Optional die Anzahl Zeichen (nicht Bytes) im String, die kopiert werden sollen.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::prepend ( wchar_t c )

Beschreibung:: Ein einzelnes Unicode-Zeichen c wird in am Anfang des Strings eingefügt. Die nachfolgenden Zeichen des Strings verschieben sich nach rechts.

Parameter

c	Unicode-Wert des gewünschten Zeichens

Rückgabe: Referenz auf den String

WideString & ppl7::WideString::prependf	(	const char *	fmt,
			...
	)

Anhand des übergebenen Formatstrings fmt und den optionalen Parametern ... wird ein neuer String gebildet, der am Anfang des bestehenden eingehangen wird.

Parameter

fmt	Der Formatstring
...	Optionale Parameter

Example:: int main(int argc, char **argv)

{

String s;

s="Vielen Dank!\n";

s.prependf ("Es wurden %i Parameter übergeben. ",argc);

s.printnl();

return 0;

}

void ppl7::WideString::print	(	bool	withNewline = `false`	)	const
throw	(
	)

Diese Funktion gibt den aktuellen String auf STDOUT aus. Dazu ist es notwendig den String vom internen Unicode-Format in das Encoding des Betriebssystems umzurechnen. Da dieses von den lokalen Einstellungen des Betriebssystems und des Users abhängig ist, wird die Environment-Variable "LANG" ausgewertet. Ist diese nicht gesetzt oder enthält ein unbekanntes Encoding, wird der String immer in UTF-8 ausgegeben.

Parameter

withNewline Ein optionaler Parameter, der angibt, ob nach der Ausgabe ein Zeilenumbruch angehangen werden soll (default=false)

Exceptions:: Keine

void ppl7::WideString::printnl	(	)	const
throw	(
	)

Diese Funktion gibt den aktuellen String mit abschließendem Zeilenumbruch auf STDOUT aus. Dazu ist es notwendig den String vom internen Unicode-Format in das Encoding des Betriebssystems umzurechnen. Da dieses von den lokalen Einstellungen des Betriebssystems und des Users abhängig ist, wird die Environment-Variable "LANG" ausgewertet. Ist diese nicht gesetzt oder enthält ein unbekanntes Encoding, wird der String immer in UTF-8 ausgegeben.

Exceptions:: Keine

WideString & ppl7::WideString::repeat ( size_t num )

Beschreibung:: Mit dieser Funktion wird der Inhalt des Strings mehrfach wiederholt.

Parameter

num	Anzahl Wiederholungen. Falls `num` 0 ist, ist der String anschließend leer.

Rückgabe: Referenz auf den verlängerten String.

WideString & ppl7::WideString::repeat	(	wchar_t	unicode,
		size_t	num
	)

Der String wird mit einem gewünschten Zeichen gefüllt

Parameter

unicode	Der Unicode des Zeichens, mit dem der String gefüllt werden soll
num	Die Länge des gewünschten Strings

Rückgabe: Referenz auf den neuen String

WideString & ppl7::WideString::repeat	(	const WideString &	str,
		size_t	num
	)

Beschreibung:: Mit dieser Funktion wird der übergebene String str num mal wiederholt und das Ergebnis in diesem String gespeichert.

Parameter

str	Der zu wiederholende String
num	Anzahl wiederholungen

Rückgabe: Referenz auf den String

WideString ppl7::WideString::repeated ( size_t count ) const

Beschreibung:: Der aktuelle String wird count mal hintereinander wiederholt und als neuer String zurückgegeben.

Parameter

[in] count Anzahl wiederholungen

Rückgabe: Neuer String

Ausnahmebehandlung

OutOfMemoryException Tritt auf, wenn kein Speicher mehr verfügbar ist.

WideString & ppl7::WideString::replace	(	const WideString &	search,
		const WideString &	replacement
	)

void ppl7::WideString::reserve ( size_t size )

Beschreibung:: Mit dieser Funktion kann vor Verwendung des Strings vorgegeben werden, wieviel Speicher initial reserviert werden soll. Dies ist insbesondere dann sinnvoll, wenn der String während seiner Lebenszeit häufig verlängert wird.

Parameter

[in] size Anzahl Zeichen, für die Speicher reserviert werden soll.

Zu beachten: Enthält der String bereits Zeichen, gehen diese nicht verloren, der existierende Speicherbereich kann aber zwecks Vergrößerung umkopiert werden. Der Aufruf der Funktion WideString::clear führt dazu, dass der Speicher wieder freigegeben wird.

WideString ppl7::WideString::right ( size_t len ) const

Beschreibung:: Gibt die letzten len Zeichen des Strings als neuen zurück.

Parameter

len	Länge des Teilstrings

Rückgabe: Neuer String

WideString & ppl7::WideString::set	(	const char *	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Mit dieser Funktion wird der String anhand eines char * gesetzt. Dabei wird er intern nach Unicode konvertiert.

Parameter

str	Pointer auf einen String
size	Optionaler Parameter, der die Anzahl zu importierender Zeichen angibt. Ist der Wert nicht angegeben, wird der komplette String übernommen. Ist der Wert größer als der angegebene String, wird er ignoriert und der komplette String importiert.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException
UnsupportedFeatureException
UnsupportedCharacterEncodingException
CharacterEncodingException

Zu beachten: Multibyte-Characters zählen als ein Zeichen.

WideString & ppl7::WideString::set	(	const wchar_t *	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Mit dieser Funktion wird der String anhand eines wchar_t * gesetzt.

Parameter

str	Pointer auf einen String
size	Optionaler Parameter, der die Anzahl zu importierender Zeichen angibt. Ist der Wert nicht angegeben, wird der komplette String übernommen. Ist der Wert größer als der angegebene String, wird er ignoriert und der komplette String importiert.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::set	(	const WideString *	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Mit dieser Funktion wird der String anhand des Pointers str eines anderen Strings gesetzt.

Parameter

str	Pointer auf einen String
size	Optionaler Parameter, der die Anzahl zu importierender Zeichen angibt. Ist der Wert nicht angegeben, wird der komplette String übernommen. Ist der Wert größer als der angegebene String, wird er ignoriert und der komplette String importiert.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::set	(	const WideString &	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Mit dieser Funktion wird der Inhalt des Strings str übernommen.

Parameter

str	Referenz auf einen anderen String
size	Optionaler Parameter, der die Anzahl zu importierender Zeichen angibt. Ist der Wert nicht angegeben, wird der komplette String übernommen. Ist der Wert größer als der angegebene String, wird er ignoriert und der komplette String importiert.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::set	(	const String *	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Mit dieser Funktion wird der Inhalt des Strings str übernommen.

Parameter

str	Referenz auf einen anderen String
size	Optionaler Parameter, der die Anzahl zu importierender Zeichen angibt. Ist der Wert nicht angegeben, wird der komplette String übernommen. Ist der Wert größer als der angegebene String, wird er ignoriert und der komplette String importiert.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::set	(	const String &	str,
		size_t	size = `(size_t)-1`
	)

WideString & ppl7::WideString::set	(	const std::string &	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Mit dieser Funktion wird der Inhalt des STL-Strings str übernommen.

Parameter

str	Referenz auf einen String der Standard Template Library (STL)
size	Optionaler Parameter, der die Anzahl zu importierender Zeichen angibt. Ist der Wert nicht angegeben, wird der komplette String übernommen. Ist der Wert größer als der angegebene String, wird er ignoriert und der komplette String importiert.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::set	(	const std::wstring &	str,
		size_t	size = `(size_t)-1`
	)

Beschreibung:: Mit dieser Funktion wird der Inhalt des STL-Wide-Strings str übernommen.

Parameter

str	Referenz auf einen Wide-String der Standard Template Library (STL)
size	Optionaler Parameter, der die Anzahl zu importierender Zeichen angibt. Ist der Wert nicht angegeben, wird der komplette String übernommen. Ist der Wert größer als der angegebene String, wird er ignoriert und der komplette String importiert.

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfMemoryException

WideString & ppl7::WideString::set ( wchar_t c )

Beschreibung:: Ein einzelnes Unicode-Zeichen c wird in den String übernommen.

Parameter

c	Unicode-Wert des gewünschten Zeichens

Rückgabe: Referenz auf den String

WideString & ppl7::WideString::set	(	size_t	position,
		wchar_t	c
	)

Beschreibung:: Mit dieser Funktion wird ein einzelnes Zeichen eines Strings an der Position position durch das Zeichen c ersetzt.

Parameter

position	Position innerhalb des Strings (Zählung beginnt bei 0)
c	Unicode-Wert, der gesetzt werden soll

Rückgabe: Referenz auf den String

Ausnahmebehandlung

OutOfBoundsEception Wird geworfen, wenn position größer ist, als die Länge des Strings

WideString & ppl7::WideString::setf	(	const char *	fmt,
			...
	)

Beschreibung:: Erzeugt einen String anhand des übergebenen Formatstrings fmt und den optionalen Parametern ...

Parameter

fmt	Der Formatstring
...	Optionale Parameter

Rückgabe: Referenz auf den String

Example:: int main(int argc, char **argv)

{

String s;

s.setf ("Anzahl Parameter: %i\n",argc);

s.printnl();

return 0;

}

static void ppl7::WideString::setGlobalEncoding ( const char * encoding )

static

size_t ppl7::WideString::size ( ) const

Beschreibung:: Diese Funktion gibt die Anzahl Zeichen zurück, aus denen der String besteht.

Zu beachten: Die Funktionen WideString::len, WideString::length und WideString::size sind identisch.

Siehe auch: WideString::capacity

Rückgabe: Anzahl Zeichen

int ppl7::WideString::strCaseCmp	(	const WideString &	str,
		size_t	size = `(size_t)-1`
	)		const

Beschreibung:: Führt einen Vergleich mit einem anderen String durch, unter Ignorierung der Gross-/Kleinschreibung.

Parameter

str	String, mit dem verglichen werden soll
size	Optionaler Parameter, der die Anzahl zu berücksichtigender Zeichen innerhalb des Strings `str` angibt. Wird er nicht angegeben, wird ein vergleich mit dem kompletten String `str` durchgeführt.

Rückgabe: Ist der String innerhalb dieses Objekts kleiner als der mit str angegebene, wird ein negativer Wert zurückgegeben, ist er größer, erfolgt ein positiver Return-Wert, sind beide identisch, wird 0 zurückgegeben.

Siehe auch: strcmp Vergleich zweier Strings unter Berücksichtigung der Gross-/Kleinschreibung

WideString ppl7::WideString::strchr ( wchar_t c ) const

int ppl7::WideString::strcmp	(	const WideString &	str,
		size_t	size = `(size_t)-1`
	)		const

Beschreibung:: Führt einen Vergleich mit einem anderen String durch.

Parameter

str	String, mit dem verglichen werden soll
size	Optionaler Parameter, der die Anzahl zu berücksichtigender Zeichen innerhalb des Strings `str` angibt. Wird er nicht angegeben, wird ein vergleich mit dem kompletten String `str` durchgeführt.

Rückgabe: Ist der String innerhalb dieses Objekts kleiner als der mit str angegebene, wird ein negativer Wert zurückgegeben, ist er größer, erfolgt ein positiver Return-Wert, sind beide identisch, wird 0 zurückgegeben.

Siehe auch: strCaseCmp Vergleich zweier Strings unter Ignorierung der Gross-/Kleinschreibung

WideString & ppl7::WideString::stripSlashes ( )

WideString ppl7::WideString::strrchr ( wchar_t c ) const

WideString ppl7::WideString::strstr ( const WideString & needle ) const

Beschreibung:: Diese Funktion findet die erste Position der Zeichenfolge needle innerhalb des Strings. Abschließende `\0'-Zeichen werden nicht miteinander verglichen.

Parameter

needle

Rückgabe: Die Funktion gibt einen String zurück, der mit der gefundenen Zeichenkette beginnt und den Rest des Strings bis zum Ende enthält. Wurde die Zeichenkette nicht gefunden, wird ein leerer String zurückgegeben.

Zu beachten: Ein Sonderfall besteht, wenn needle leer ist. In diesem Fall wird der komplette String zurückgegeben.

WideString ppl7::WideString::substr	(	size_t	start,
		size_t	len = `(size_t)-1`
	)		const

Beschreibung:: Gibt len Zeichen des Strings, beginnend ab Position start als neuen String zurück.

Parameter

start	Startposition
len	Optionale Länge des Teilstrings. Ist der Parameter nicht angegeben, wird der komplette String ab Position `start` zurückgegeben.

Rückgabe: Neuer String

bool ppl7::WideString::toBool ( ) const

double ppl7::WideString::toDouble ( ) const

ByteArray ppl7::WideString::toEncoding ( const char * encoding ) const

Beschreibung:: Mit dieser Funktion wird der Inhalt des Strings in eine beliebige lokale Kodierung umgewandelt und als ByteArray zurückgegeben.

Parameter

[in] encoding Das gewünschte Encoding

Rückgabe: ByteArray mit der UTF8-Repräsentation des Strings.

Achtung: Für diese Funktion wird "Iconv" benötigt. Ist keine Iconv-Bibliothek auf dem System vorhanden, wird eine UnsupportedFeatureException geworfen.

float ppl7::WideString::toFloat ( ) const

int ppl7::WideString::toInt ( ) const

pplint64 ppl7::WideString::toInt64 ( ) const

ByteArray ppl7::WideString::toLocalEncoding ( ) const

Beschreibung:: Mit dieser Funktion wird der Inhalt des Strings in in die lokale Kodierung des Betriebssystems umgewandelt, bzw. den Zeichensatz, der über "setlocale" eingestellt wurde. Das Ergebnis wird als ByteArray zurückgegeben.

Rückgabe: ByteArray mit der lokalen Repräsentation des Strings.

Beispiel:: Die aktuelle Lokalisierungs-Einstellung für die String-Konvertierung kann folgendermassen abgefragt werden:
printf ("Lokalisierung: %s\n",setlocale(LC_CTYPE,NULL);

Und folgendermassen kann sie gesetzt werden:
if (!setlocale(LC_CTYPE, "de_DE.ISO8859-15")) {

printf ("setlocale fehlgeschlagen\n");

throw std::exception();

}

printf ("Lokalisierung: %s\n",setlocale(LC_CTYPE,NULL);

String ppl7::WideString::toLocalString ( ) const

long ppl7::WideString::toLong ( ) const

long long ppl7::WideString::toLongLong ( ) const

String ppl7::WideString::toString ( ) const

ByteArray ppl7::WideString::toUCS4 ( ) const

unsigned int ppl7::WideString::toUnsignedInt ( ) const

ppluint64 ppl7::WideString::toUnsignedInt64 ( ) const

unsigned long ppl7::WideString::toUnsignedLong ( ) const

unsigned long long ppl7::WideString::toUnsignedLongLong ( ) const

ByteArray ppl7::WideString::toUtf8 ( ) const

Beschreibung:: Mit dieser Funktion wird der Inhalt des Strings in UTF8 umgewandelt und als ByteArray zurückgegeben.

Rückgabe: ByteArray mit der UTF8-Repräsentation des Strings.

const wchar_t * ppl7::WideString::toWchart ( ) const

Beschreibung:: Diese Funktion liefert einen Pointer im Format "const wchar_t*" auf den internen Widecharacter-String (Unicode) der Klasse zurück. Falls der String leer ist, wird ein Pointer auf einen leeren String zurückgegeben. Das Ergebnis kann in printf und verwandten Funktionen mit dem Formatstring "%ls" verwendet werden.

Rückgabe: Pointer auf die Widecharacter Repräsentation des Strings.

Beispiel:: void PrintString(const ppl7::String &text)

{

printf ("Der String lautet: %ls\n",text.getPtr());

// oder mittels Operator:

printf ("Der String lautet: %ls\n",(const wchar_t*)text);

}

Siehe auch

Die folgenden Funktionen erfüllen den gleichen Zweck:

const wchar_t * WideString::getPtr() const
const wchar_t * WideString::toWchart() const
WideString::operator const wchar_t *() const

Zu beachten: In Version 6 der PPLib hat diese Funktion den Datentyp "const char *" zurückgeliefert, der den String im systemspezifischen Format beinhaltete (z.B. UTF-8 oder ISO-8859-1). Um dieses Verhalten zu simulieren, kann die Funktion WideString::toLocalEncoding verwendet werden. Beispiel:
void PrintString(const ppl7::String &text)

{

// Nutzung des Operators:

printf ("Der String lautet: %s\n",(const char*)text.toLocalEncoding());

// oder Nutzung der Funktion:

printf ("Der String lautet: %s\n",text.toLocalEncoding().toCharPtr());

}

void ppl7::WideString::trim ( )

void ppl7::WideString::trim ( const WideString & chars )

void ppl7::WideString::trimLeft ( )

void ppl7::WideString::trimLeft ( const WideString & chars )

void ppl7::WideString::trimRight ( )

void ppl7::WideString::trimRight ( const WideString & chars )

void ppl7::WideString::upperCase ( )

Beschreibung:: Diese Funktion wandelt alle Zeichen des Strings in Großbuchstaben um. Die genaue Funktionsweise hängt davon ab, welche Spracheinstellungen aktiv sind, genauer vom Wert "LC_CTYPE".

Achtung: Unter UNIX (und möglicherweise anderen Betriebssystemen) werden die Lokalisationseinstellungen der Umgebung nicht automatisch übernommen, sondern stehen standardmäßig auf "C". Dadurch werden nur US-ASCII (ASCII 32 bis 127) umgewandelt. Man sollte daher nach Programmstart mit "setlocale" die gewünschte Spracheinstellung vornehmen.

Beispiel:: #include <locale.h>

...

setlocale(LC_CTYPE,"de_DE.UTF-8");

void ppl7::WideString::upperCaseWords ( )

Beschreibung:: Diese Funktion wandelt die Anfangsbuchstaben aller im String enthaltenen Wörter in Großbuchstaben um.

WideString & ppl7::WideString::vasprintf	(	const char *	fmt,
		va_list	args
	)

Erzeugt einen String anhand des übergebenen Formatstrings fmt und den optionalen Parametern in args.

Parameter

fmt	Der Formatstring
args	Pointer auf Liste der Parameter. Muss zuvor mit va_start initialisiert worden sein.

Rückgabe: Referenz auf den String

Example:: void MyFunction(const char *fmt, ...)

{

String s;

va_list args;

va_start(args, fmt);

s.vasprintf(fmt,args);

va_end(args);

printf ("Ergebnis: %ls",(const wchar_t*)s);

}

Dokumentation der Datenelemente

wchar_t* ppl7::WideString::ptr

private

size_t ppl7::WideString::s

private

size_t ppl7::WideString::stringlen

private

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Dateien:

/jenkins/jobs/clang_ppl7/workspace/include/ppl7-types.h
/jenkins/jobs/clang_ppl7/workspace/src/types/WideString.cpp

[out]	matches	Array, dass die zu kopierenden Werte aufnimmt.
[in]	maxmatches	Optionaler Parameter, der die maximale Anzahl zu kopierender Werte aufnimmt (Default=16).

Öffentliche Methoden

Öffentliche, statische Methoden

Private Attribute

Ausführliche Beschreibung

Beschreibung der Konstruktoren und Destruktoren

Dokumentation der Elementfunktionen

Dokumentation der Datenelemente