wcstok - Langzeichenkette in Langzeichenteilkette zerlegen

Definition	#include <wchar.h> wchar_t *wcstok(wchar_t *ws1, const wchar_t *ws2, wchar_t **ptr); Mit wcstok lässt sich eine Gesamtlangzeichenkette ws1 in Langzeichenteilketten - sog. "Tokens" - zerlegen, z.B. ein Satz in die einzelnen Wörter oder eine Quellprogrammanweisung in die kleinsten syntaktischen Einheiten. Der Zeiger auf ws1 darf nur beim ersten wcstok-Aufruf übergeben werden. In ptr speichert wcstok die Informationen, die zur weiteren Zerlegung der Langzeichenkette notwendig sind. Ab dem zweiten Aufruf ist für ws1 ein NULL-Zeiger anzugeben und in ptr der Wert, der beim vorhergehenden Aufruf mit der gleichen Langzeichenkette gespeichert wurde. Beginn- und Endekriterium für jedes Token sind Trennzeichen (Separatoren), die in einer zweiten Langzeichenkette ws2 anzugeben sind. Token können durch einen oder mehrere dieser Separatoren begrenzt sein, bzw. durch Beginn und Ende der Gesamtlangzeichenkette ws1. Typische Separatoren zwischen den Wörtern eines Satzes sind z.B. Leerzeichen, Doppelpunkt, Komma etc. Pro Aufruf bearbeitet wcstok genau eine Langzeichenteilkette. Der erste Aufruf liefert einen Zeiger auf den Beginn der ersten gefundenen Langzeichenteilkette, die weiteren Aufrufe jeweils einen Zeiger auf den Beginn der nächsten Langzeichenteilketten. Jede Langzeichenteilkette schließt wcstok mit dem Null-Langzeichen (\0) ab. Bei jedem Aufruf kann eine andere Trennzeichenfolge ws2 angegeben werden.
Returnwert	Zeiger auf den Beginn einer Langzeichenteilkette.
		Beim ersten Aufruf ein Zeiger auf die erste Langzeichenteilkette, beim nächsten Aufruf ein Zeiger auf die nachfolgende Langzeichenteilkette etc. wcstok schließt jede Langzeichenteilkette in ws1 mit einem Null-Langzeichen (\0) ab, wobei das jeweils erste gefundene Trennzeichen mit dem Null-Langzeichen (\0) überschrieben wird.
	NULL-Zeiger	falls keine bzw. keine weitere Langzeichenteilkette gefunden wurde.
Hinweise	In dieser Version des C-Laufzeitsystems werden nur 1-Byte-Zeichen als Langzeichen unterstützt.
Siehe auch	strtok