.. highlightlang:: us

.. index:: mem_unpack

.. _mem_unpack:

mem_unpack
==========

.. us.tag  mem_unpack ENGLISH mem New500

:ref:`mem_unpack` creates a string from the given input byte string.

.. function::  ssString = mem_unpack(ssPackedString)

.. us.return

**Return Value**

*ssString* is a vector of UTF-16 characters.

.. us.params

**Parameters**

.. uparam:: ssPackedString

   *ssPackedString* is a vector of bytes.

.. us.example

**Example**

::

   * s = "Hello"
   * mem_dump(s)
   00000000  48 00 65 00 6c 00 6c 00-6f 00                    H.e.l.l.-o
      10.0000 
   * sPacked = mem_pack(s)
   * mem_dump(sPacked)
   00000000  48 65 6c 6c 6f                                   Hello
       5.0000 
   * mem_unpack(sPacked)
   Hello
   * sUn = mem_unpack(sPacked)
   * mem_dump(sUn)
   00000000  48 00 65 00 6c 00 6c 00-6f 00                    H.e.l.l.-o
      10.0000 

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.0.0
     - New.

.. seealso::
   :ref:`overview-strings`,
   :ref:`mem_pack`

:sub:`id-2046302`