.. highlightlang:: us

.. index:: updf_prop_set_at

.. _updf_prop_set_at:

updf_prop_set_at
================

.. us.tag  updf_prop_set_at NOTREADYENGLISH updf updf-props New560

:ref:`updf_prop_set_at` writes a property.

.. function::  bool = updf_prop_set_at(props, name, prop_val)

.. us.return

**Return Value**

If the function succeeds, the return value is TRUE (1); otherwise it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: props

   *props*.

.. uparam:: name

   *name* is a property name. The name is limited to 255 characters and can
   contain the following characters: a-z, A-Z, 0-9 and the four special
   characters  "_", "-", ":" and ".". The period can be used as the last
   character.

.. uparam:: prop_val

   *prop_val* is a property-value (see :ref:`updf_propval_new`).

.. us.example

**Example**

.. include:: ../include/test_updf_prop_set_at.ic

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.6.0
     - New

.. seealso::
   :ref:`overview-updf-files`,
   :ref:`updf_propval_new`,
   :ref:`updf_prop_get_at`

:sub:`id-195643`