.. highlightlang:: us

.. _updf_propval_new:

updf_propval_new
================

.. index:: updf_propval_new

.. us.tag  updf_propval_new NOTREADYGERMAN updf updf-propvals New560

:ref:`updf_propval_new` erzeugt einen Property-Wert.

.. function::  propval = updf_propval_new(data)
    propval = updf_propval_new(data, data_type)

.. us.return

**Returnwert**

*propval* ist ein propval-Zeiger oder eine Zahl mit dem Wert 0 beim Auftreten
eines Fehlers.

.. us.params

**Parameter**

.. uparam:: data

   *data* ist ein Skalar, Vektor oder Matrix (Zahl oder String).

.. uparam:: data_type

   *data_type* ist einer der folgenden Werte:

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

   * - Wert
     - Bedeutung
   * - UPDF_INT8
     - 8-Bit Integer mit Vorzeichen (-127..128).
   * - UPDF_UINT8
     - 8-Bit Integer ohne Vorzeichen (0..255).
   * - UPDF_INT16
     - 16-Bit Integer.
   * - UPDF_UINT16
     - 16-Bit Integer (vorzeichenlos).
   * - UPDF_INT32
     - 32-Bit Integer.
   * - UPDF_UINT32
     - 32-Bit Integer (vorzeichenlos).
   * - UPDF_INT64
     - 64-Bit Integer.
   * - UPDF_UINT64
     - 64-Bit Integer (vorzeichenlos).
   * - UPDF_FLOAT
     - 32-Bit Real-Zahl.
   * - UPDF_DOUBLE
     - 64-Bit Real-Zahl.
   * - UPDF_STRING
     - Unicode-String. Wird als UTF-8 gespeichert.
   * - UPDF_BLOB
     - Beliebige Folge von Bytes. *data*  muss ein String sein.

.. us.comment

**Kommentar**

Bei den Typen ``UPDF_INT8`` bis ``UPDF_DOUBLE`` muss *data*  eine Zahl, ein
Zahlenvektor oder eine Zahlenmatrix sein.

Bei dem Typ ``UPDF_STRING`` sollte *data*  einen echten Unicode-String enthalten,
weil intern eine UTF-16 nach UTF-8 Umwandlung durchgeführt wird.

Bei dem Typ ``UPDF_BLOB`` muss *data*  ein String-Wert sein, der aber keine 
gültigen Unicode-Zeichen enthalten muss. Er kann auch Null-Zeichen enthalten. Mit
der Funktion :ref:`mem_set` kann ein solcher String auch aus anderen Datentypen
erzeugt werden.

.. us.example

**Beispiel**

.. include:: ../include/test_updf_propval_new.ic

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.6.0
     - Neu

.. seealso::
   :ref:`uberblick-updf-dateien`,
   :ref:`updf_propval_get_info`,
   :ref:`updf_propval_get`,
   :ref:`mem_set`

:sub:`id-1298911`