.. highlightlang:: us

.. index:: base64_decode

.. _base64_decode:

base64_decode
=============

.. us.tag  base64_decode NOTREADYENGLISH New400 Changed420 STR

:ref:`base64_decode` decodes a string that had been encoded using the
:ref:`base64_encode` function.

.. function::  r = base64_decode(data)
               r = base64_decode(data, bStrReturn)

.. us.return

**Return Value**

*r* is a string which does not contain any 0-characters.

.. us.params

**Parameters**

.. uparam:: data

   *data* is a string or real vector with values in the range from 0 to 255.

.. uparam:: bStrReturn

   If *bStrReturn* is not 0 the return values *r* is alwasy a string.

   If *bStrReturn* is 0 or the parameter is not specified the return value a real
   vector if *r* contains 0-charaters.

.. us.example

**Example**

::

   * a = base64_encode([0,1,2,3])
   * a
   AAECAw==
   * a = base64_encode("\x00\x01\x02\x03")
   * a
   AAECAw==
   * b = base64_decode(a)
   * b
       0.0000     1.0000     2.0000     3.0000 
   * b = base64_decode(a, 1)
   * b
   \x00\x01\x02\x03

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 4.2.0
     - New parameter *bStrReturn*.
   * - 4.0.0
     - New.

.. seealso::
   :ref:`overview-strings`,
   :ref:`base64_encode`,
   :ref:`binary_decode`,
   :ref:`binary_encode`,
   :ref:`strchar`,
   :ref:`strcode`

:sub:`id-236466`