.. highlightlang:: us

.. index:: obj_lookup

.. _obj_lookup:

obj_lookup
==========

.. us.tag  obj_lookup GERMAN obj New410 Changed5147 Changed5502

:ref:`obj_lookup` liefert den Wert zu einem Schlüssel (Key).

.. function::  val = obj_lookup(obj, key)
               val = obj_lookup(obj, key, default)

.. us.return

**Returnwert**

*val* ist der Wert des Schlüssels. Falls der Schlüssel nicht existiert liefert
die Funktion entweder die Zahl 0 (default), einen leeren String oder
löst eine Exception aus. Siehe :ref:`obj_set_str_return`.

.. us.params

**Parameter**

.. uparam:: obj

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

.. uparam:: key

   *key* ist ein String oder eine ganze Zahl.

.. uparam:: default

   *default* ist der Wert, der zurück gegeben wird, wenn *key* nicht existiert.

.. us.comment

**Kommentar**

Die alternative Syntax zu ``val = obj_lookup(obj, key)`` ist
``val = obj.lookup(key)`` oder ``val = obj[key]``. Falls der Key eine Zeichenkette
ist, die den Regeln für Funktionsnamen genügt, kann auch ``val = m.key``
verwendet werden.

.. us.example

**Beispiel**

::

   obj = obj_create()
   obj.set_at(1, 123)
   obj.set_at("a", 456)
   print obj_lookup(obj, 1)
   print obj.lookup(1)
   print obj[1]
   print obj_lookup(obj, "a")
   print obj.lookup("a")
   print obj["a"]
   print obj.a

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013.2
     - Über :ref:`obj_set_str_return` kann erreicht werden, das eine Exception
       erzeugt wird, wenn der Key nicht vorhanden ist. Gilt beim Aufruf mit zwei
       Parametern, also ohne *default*.
   * - 5.14.7
     - Neuer Parameter *default*.
   * - 4.1.0
     - Neu.

.. seealso::
   :ref:`uberblick-uniscript-objekte`,
   :ref:`obj_set_at`,
   :ref:`obj_has_key`,
   :ref:`obj_set_str_return`

:sub:`id-1771386`