.. highlightlang:: us

.. _mem_alloc:

mem_alloc
=========

.. index:: mem_alloc

.. us.tag  mem_alloc GERMAN mem New420 Changed500

:ref:`mem_alloc` erzeugt ein skalaren String vorgegebener Länge. 

.. function::  ssString = mem_alloc(n)
    ssString = mem_alloc(n, c)

.. us.return

**Returnwert**

*ssString* ist ein String mit n Bytes Länge.

.. us.params

**Parameter**

.. uparam:: n

   *n* ist die Anzahl an Bytes des Strings.

.. uparam:: c

   *c* ist ein String oder eine Zahl mit der der String initialisiert wird. Falls
   *c* ein String ist, wird das erste Zeichen verwendet, falls *c* ein Zahl ist,
   wird die Zahl zuvor in einen 8-bit-Wert umgewandelt.

.. us.example

**Beispiel**

::

   def GetCurrentDirectory()
   {
       ret = RegisterFunction("KERNEL32", "GetCurrentDirectoryA",..
                        "uint", "_GetCurDir", ["uint", "char*"]);
       ssBuffer = mem_alloc(1024);
       _GetCurDir(1024, ssBuffer)
       return ssBuffer;
   }

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.0.0
     - Falls *c*  ein String ist, wird das niederwertige Byte des ersten Zeichens zur Initialisierung verwendet.
   * - 4.2.0
     - Neu.

.. seealso::
   :ref:`uberblick-strings`,
   :ref:`mem_len`,
   :ref:`strlen`,
   :ref:`mem_set`,
   :ref:`mem_get`

:sub:`id-783686`