bufsplit(3G) bufsplit(3G)
NAME
bufsplit - Puffer in Felder aufteilen
SYNTAX
cc [option ...] datei ... -lgen [bibliothek ...]
#include <libgen.h>
sizet bufsplit(char *Puffer, sizet n, char **a);
BESCHREIBUNG
bufsplit() untersucht den Puffer und weist dem Zeiger-Array a Werte
zu, so daß die Zeiger auf die ersten n Felder in Puffer zeigen, die
durch Tabulatoren oder Neue-Zeile-Zeichen voneinander getrennt sind.
Um die Zeichen zum Trennen der Felder zu ändern, rufen Sie bufsplit()
mit Puffer auf, der auf die Zeichenkette zeigt, und mit n und a, die
auf Null gesetzt sind. Um zum Beispiel :, . und , als Trennzeichen
zusammen mit Tabulator und Neue-Zeile-Zeichen zu verwenden, geben Sie
ein:
bufsplit (":.,\t\n", 0, (char**)0);
BEISPIELE
/*
* set a[0] = "Dies", a[1] = "ist", a[2] = "ein",
* a[3] = "Test"
*/
bufsplit("Dies\tist\tein\tTest\n", 4, a);
HINWEISE
bufsplit() ändert die Begrenzer in Puffer auf Null-Bytes.
ERGEBNIS
Die Anzahl von zugewiesenen Feldern in dem Array a wird zurückgegeben.
Wenn Puffer NULL ist, ist der Rückgabewert 0, und das Array bleibt
unverändert. Sonst ist der Wert mindestens 1. Den in dem Array ver-
bleibenden Elementen wird die Adresse des Null-Bytes am Ende des Puf-
fers zugewiesen.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98