.. highlightlang:: us

.. index:: lltostr

.. _lltostr:

lltostr
=======

.. us.tag  lltostr ENGLISH STR Programming.Convert

:ref:`lltostr` (long-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 = lltostr(rmReal, nBase)

.. us.return

**Return Value**

*rmString* is a matrix of strings.

.. us.params

**Parameters**

.. uparam:: rmReal

   *rmReal* is a real matrix. Range: -2^52 to 2^53-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:`lltostr` can convert numbers not only to the
decimal, hexadecimal or octal number system.

.. us.example

**Example**

::

   * lltostr(2^53, 2)
   100000000000000000000000000000000000000000000000000000
   * lltostr(2^53, 16)
   20000000000000
   * lltostr(2^53-1, 16)
   1FFFFFFFFFFFFF

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

:sub:`id-1700593`