.. highlightlang:: us

.. index:: strtol

.. _strtol:

strtol
======

.. us.tag  strtol GERMAN STR Programming.Convert

:ref:`strtol` wandelt String-Matrizen mit ganzen Zahlen zur Basis 2 bis 36 in
reelle Zahlen um (32bit).

.. function::  rmReal = strtol(smString)
    rmReal = strtol(smString, nBase)
    <rmReal, smStopString> = strtol(smString)
    <rmReal, smStopString> = strtol(smString, nBase)

.. us.return

**Returnwert**

*rmReal* ist eine reelle Matrix, *smStopString* enthält den
Anteil in *smString* der nicht in eine Zahl umgewandelt werden kann.

.. us.params

**Parameter**

.. uparam:: smString

   *smString* ist eine String-Matrix.

.. uparam:: nBase

   *nBase* ist die Basis der zu konvertierenden Zahlen.  Ist *nBase* gleich 0
   oder wird dieser Parameter nicht verwendet, wird der erste Buchstabe zur
   Bestimmung der Basis verwendet.

   Bei einer führenden 0 wird die Zeichenfolge als oktale Zahl interpretiert
   (Basis 8), bei einem führenden 0x oder 0X wird die Zeichenfolge als
   hexadezimale Zahl interpretiert (Basis 16), andernfalls wird die Zeichenfolge
   als Dezimalzahl interpretiert. Die Buchstaben a-z oder A-Z werden den Zahlen
   10 bis 35 zugewiesen. Es dürfen nur Buchstaben verwendet werden, die kleiner
   als die Basis sind.

.. us.example

**Beispiel**

::

   * strtol("123")
     123.0000
   * strtol("101", 2)
     5.0000
   * strtol("0xA", 16)
     10.0000
   * strtol("Hallo")
       0.0000
   * <r,s> = strtol("123Hallo")
   * r
     123.0000
   * s
   Hallo

.. seealso::
   :ref:`uberblick-strings`,
   :ref:`strtoull`,
   :ref:`sprintf`,
   :ref:`strtod`,
   :ref:`ltostr`

:sub:`id-309376`