.. highlightlang:: us

.. index:: mem_dump

.. _mem_dump:

mem_dump
========

.. us.tag  mem_dump GERMAN mem New500 Changed590

:ref:`mem_dump` gibt einen String als Speicherblock im Kommandofenster aus.

.. function::  n = mem_dump(ssString)
    n = mem_dump(ssString, count)
    n = mem_dump(ssString, count, offset)
    n = mem_dump(ssString, count, offset, bStringReturn)

.. us.return

**Returnwert**

*n* ist die Länge des Strings. Falls *bStringReturn* auf TRUE (1) gesetzt 
ist, liefert die Ffunktion einen String zurück.

.. us.params

**Parameter**

.. uparam:: ssString

   *ssString* ist ein String, der auch Null-Zeichen enthalten kann.

.. uparam:: count

   *count* ist die Anzahl an Bytes die ausgegeben werden sollen. Falls *count* 0 
   oder größer oder gleich ``mem_len(ssString)`` ist, werden alle Bytes
   ausgegeben.

.. uparam:: offset

   *offset* ist die Anfangsposition in *ssString*. Defaultwert ist 0.

.. uparam:: bStringReturn

   Falls *bStringReturn* auf TRUE (1) gesetzt ist, liefert die Funktion einen
   String zurück. Defaultwert ist FALSE (0).

.. us.example

**Beispiel**

::

   * mem_dump("Hello")
   00000000  48 00 65 00 6c 00 6c 00-6f 00                    H.e.l.l.-o
      10.0000 
   * mem_dump("Hello\x00Hello")
   00000000  48 00 65 00 6c 00 6c 00-6f 00 00 00 48 00 65 00  H.e.l.l.-o...H.e.
   00000010  6c 00 6c 00 6f 00                                l.l.o.
      22.0000 

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.9
     - Neuer Parameter *bStringReturn*.
   * - 5.0
     - Neu.

.. seealso::
   :ref:`uberblick-strings`,
   :ref:`mem_alloc`

:sub:`id-1714994`