.. highlightlang:: us

.. index:: obj_set_at

.. _obj_set_at:

obj_set_at
==========

.. us.tag  obj_set_at GERMAN New410 obj

:ref:`obj_set_at` fügt ein Schlüssel-Wert-Paar in das Objekt ein. Falls der
Schlüssel bereits existierte wird der Wert durch den neuen Wert ersetzt.

.. function::  bool = obj_set_at(obj, key, val)

.. us.return

**Returnwert**

*bool*.

.. us.params

**Parameter**

.. uparam:: obj

   *obj* ist ein mit :ref:`obj_create` erzeugtes Objekt.

.. uparam:: key

   *key* ist eine reele Zahl oder eine Zeichenkette.

.. uparam:: val

   *val* ist eine Zahl, ein String oder eine komplexe Zahl oder eine Matrix der
   drei Typen oder ein mit :ref:`obj_create` erzeugtes Objekt. 

.. us.example

**Beispiel**

::

   obj = [. a = 123]

oder::

   obj = obj_create()

   // syntax 1
   obj_set_at(obj, "a", 123)

   // syntax 2
   obj.set_at("a", 123)

   // syntax 3
   obj["a"] = 123

   // syntax 4
   obj.a = 123

.. seealso::
   :ref:`uberblick-uniscript-objekte`,
   :ref:`obj_lookup`

:sub:`id-253332`