SYSstrtok

Zeichenkette nach Zeichen trennen.

Diese Routine funktioniert wie die C Routine strtok, nur mit dem Unterschied, dass bei dieser Routine mehrere Aufrufe verschachtelt sein dürfen, im Gegensatz zu strtok. Die Zeichenkette enthält einen beliebigen Text, der nach den Zeichen aus limits aufgeteilt wird. Dabei wird die Zeichenkette in ptr von vorne zerstört. Deshalb ist es sinnvoll eine Kopie der Zeichenkette anzulegen, falls sie danach weiter verwendet werden soll.

Parameter

ptr (char **)                                                  [IN]

Diese Zeichenkette wird unterteilt nach den Zeichen, die in limits vorkommen. Diese Zeichenkette wird dabei von vorne beginnend gelöscht, so dass es sinnvoll ist, sich vorher eine Kopie dieser Zeichenkette anzulegen.

limits (char *)                                                [IN]

limits beinhaltet die Zeichen, nach denen die Zeichenkette ptr unterteilt werden soll.

multilimits (char *)                                        [IN]

In multilimits können die Zeichen angegeben werden, die bei der weiteren Unterteilung übersprungen werden sollen, wenn sie schon vorgekommen sind. Kann auch den Wert NULL haben.

Ergebnis

(char *)                                                     [OUT]

Hier wird der Teil der Zeichenkette zurückgeliefert, der bis zum Auftauchen eines Zeichens aus limits besteht, sonst NULL.

Deklaration

#include "basic.h"

char * DLLENTRY SYSstrtok (

     char **     ptr,

     char *      limits,

     char *      multilimits

);