.. highlightlang:: us

.. index:: ltostr

.. _ltostr:

ltostr
======

.. us.tag  ltostr ENGLISH STR Programming.Convert

:ref:`ltostr` (long-to-string) converts a real matrix of integers to a string
matrix of specified base. Base must be in the range 2 to 36.

.. function::  smString = ltostr(rmReal, nBase)

.. us.return

**Return Value**

*rmString* is a matrix of strings.

.. us.params

**Parameters**

.. uparam:: rmReal

   *rmReal* is a real matrix. Range: -2^31 to 2^31-1.

.. uparam:: nBase

   *nBase* is used as the base of the number and must be in the range 2 to 36. The
   letters a-z or A-Z are assigned the values 10 through 35.

.. us.comment

**Comment**

In opposite to :ref:`printf` :ref:`ltostr` can convert numbers not only to the
decimal, hexadecimal or octal number system.

.. us.example

**Example**

::

   * ltostr(123, 10)
     123
   * ltostr(5, 2)
     101
   * ltostr(0xA, 16)
     0xA
   * ltostr(3710, 36)
     2v2

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

:sub:`id-1745352`