.. highlightlang:: us

.. _strtok:

strtok
======

.. index:: strtok

.. us.tag  strtok GERMAN STR Changed310

:ref:`strtok` zerlegt einen skalaren String in Teilstrings (Token).

.. function::  svToken = strtok(ssString, ssDelimiter)
    svToken = strtok(ssString, ssDelimiter, bIgnoreLeadingDelimiters)

.. us.return

**Returnwert**

*svToken* ist ein String-Zeilenvektor mit den
String-Token.

.. us.params

**Parameter**

.. uparam:: ssString

   *ssString* ist ein Stringskalar, der in Token
   zerlegt werden soll.

.. uparam:: ssDelimiter

   *ssDelimiter* enthält ein oder mehrere
   Trennzeichen. Die Trennzeichen werden aus *ssString* entfernt.

.. uparam:: bIgnoreLeadingDelimiters

   Wenn *bIgnoreLeadingDelimiters* auf FALSE (0) gesetzt ist, werden
   zusammenhängende Trennzeichen nicht übersprungen. Wenn 
   *bIgnoreLeadingDelimiters* auf TRUE (1) gesetzt ist, werden zusammenhängende
   Trennzeichen übersprungen. Defaultwert is TRUE (1).

.. us.example

**Beispiel**

::

   strtok("1,2,3;4,5", ",;")'
   1
   2
   3
   4
   5

Das folgende Beispiel liefert 2 Elemente:

::

   strtok("1;;2", ";")'
   1
   2

Das folgende Beispiel liefert 3 Elemente:

::

   strtok("1;;2", ";", FALSE)'
   1

   2

.. seealso::
   :ref:`uberblick-strings`,
   :ref:`sum`,
   :ref:`StringToField`

:sub:`id-243840`