.. highlightlang:: us

.. index:: base64_encode

.. _base64_encode:

base64_encode
=============

.. us.tag  base64_encode NOTREADYGERMAN New400 Changed420 Changed500 STR

:ref:`base64_encode` kodiert Daten in das base64-Format.

.. function::  ssData = base64_encode(data)

.. us.return

**Returnwert**

*ssData* ist ein base64-kodierter String.

.. us.params

**Parameter**

.. uparam:: data

   *data* ist ein String oder ein Vektor mit Bytes (Zahlen zwischen 0 und 255).

.. us.comment

**Kommentar**

Falls ein String übergeben wird, wird er intern zunächst in ein Byte-Array 
umgewandelt. Die Umwandlung wird durch "Abschneiden" der höherwertiges Bytes der 
16-Bit-Unicode-Zeichen durchgeführt. Soll das höherwertige Byte auch kodiert werden,
sollte der String zuvor (je nach Anwendung) mit den Funktionen :ref:`mem_unpack`, 
:ref:`utf_to_locale` oder :ref:`utf8_encode` umgewandelt werden.

.. us.example

**Beispiel**

siehe auch :ref:`base64_decode`.

.. highlight:: none

::

   * r = base64_encode(s = "Hallo€")
   * r
   SGFsbG+s
   * base64_decode(r)
   Hallo¬
   * mem_dump(s)
   00000000  48 00 61 00 6c 00 6c 00-6f 00 ac 20              H.a.l.l.-o.. 
      12.0000 
   * r = base64_encode(s = mem_unpack("Hallo€"))
   * r
   SABhAGwAbABvAKwg
   * base64_decode(r)
      72.0000     0.0000    97.0000     0.0000   108.0000     0.0000   108.0000     0.0000   111.0000     0.0000   -84.0000    32.0000 
   * base64_decode(r, 1)
   H\x00a\x00l\x00l\x00o\x00¬ 
   * mem_pack(base64_decode(r, 1))
   Hallo€

.. highlight:: us

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.0.0
     - Unicode-Änderungen.

.. seealso::
   :ref:`uberblick-strings`,
   :ref:`base64_decode`,
   :ref:`strchar`,
   :ref:`strcode`

:sub:`id-240306`