.. highlightlang:: us

.. index:: strtoseq

.. _strtoseq:

strtoseq
========

.. us.tag  strtoseq GERMAN STR Programming.Convert

:ref:`strtoseq` konvertiert einen String mit einer Sequenzbeschreibung zu einem
Vektor von ganzen Zahlen.

.. function::  rvSequence = strtoseq(ssSequence, rsMin, rsMax)

.. us.return

**Returnwert**

**Return Value**

*rvSequence* ist ein Integer Vektor oder der Wert rsMin-1, if an error
occurred.

.. us.params

**Parameter**

**Parameters**

.. uparam:: svSequence

   *svSequence* ist eine String mit einer Sequenzbeschreibung (Zahlenfolge). 
   Die Elemente werden durch ein Komma (,) getrennt. Ein Zahlenbereich wird
   durch eine Minus-Zeichen (-) oder einen Doppelpunkt (:) getrennt. Um eine
   Schrittweite größer 1 zu erzeugen, sind drei Zahlenwerte erforderlich. Der
   folgenden String "2:2:10" erzeugt die Folge 2,4,6,8,10. Negative Zahlen 
   zählen vom Ende (rsMax). -1 ist der letzte Wert(rsMax), -2 ist der vorletzte
   Wert. Der String "-10--1" erzeugt einen Vektor mit den Werten der letzten
   10 Werte. 

.. uparam:: rsMin

   *rsMin* ist die untere Grenze der gültigen Werte. 

.. uparam:: rsMax

   *rsMax* ist die obere Grenze der gültigen Werte. 

.. us.example

**Beispiel**

.. highlight:: none

::

   * create_sequence("1:10",1,20)
       1.00 2.00 3.00 4.00 5.00 6.00 7.00  8.00  9.00  10.00
   * create_sequence("1:12",1,20)
       1.00 2.00  3.00  4.00  5.00  6.00 7.00 8.00 9.00 10.00 11.00 12.00
   * create_sequence("1:12,16",1,20)
       1.00 2.00 3.00 4.00 5.00 6.00 7.00 8.00 9.00 10.00 11.00 12.00 16.00
   * create_sequence("1:12,16,-2",1,20)
       1.00 2.00 3.00 4.00 5.00 6.00 7.00 8.00 9.00 10.00 11.00 12.00 16.00 19.00
   * create_sequence("1:5,16,-2",1,20)
       1.00 2.00 3.00 4.00 5.00 16.00 19.00
   * create_sequence("-6--1",1,20)
      15.00 16.00 17.00 18.00 19.00 20.00
   * create_sequence("1,6,9",1,20)
       1.00 6.00 9.00

.. highlight:: us

.. seealso::
   :ref:`overview-strings`,
   :ref:`sprintf`,
   :ref:`strtod`,
   :ref:`strtol`

:sub:`id-41452`