.. highlightlang:: us

.. index:: keys
.. index:: obj_keys

.. _obj_keys:

obj_keys
========

.. us.tag  obj_keys NOTREADYGERMAN New410 obj

:ref:`obj_keys` liefert die Keys (oder eine Auswahl an Keys) eines Objekts.

.. function::  keys = obj_keys(obj)
               keys = obj_keys(obj, start)
               keys = obj_keys(obj, start, end)

.. us.return

**Returnwert**

*keys* ist ein Array von ganzen Zahlen oder Strings.

.. us.params

**Parameter**

.. uparam:: obj

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

.. uparam:: start

   *start* ist der erste Key.

.. uparam:: end

   *end* ist der Vorgänger des letzten Keys. *start* und *end* müssen vom
   gleichen Typ sein, also beide entweder Zahlen oder Strings.

.. us.comment

**Kommentar**

``obj.keys()`` gibt alle String-Schlüssel zurück.

``obj.keys("a", "d")`` gibt alle String-Schlüssel zurück, die mit "a", "b" oder "c"
anfangen. Die Schlüssel werden alphabetisch sortiert geliefert.

``obj.keys(1)`` gibt alle Zahlen-Schlüssel größer gleich 1 zurück.

``obj.keys(-DBL_MAX, 0)`` gibt alle Zahlen-Schlüssel mit negativen Indizes zurück.

``obj.keys(1, 10)`` gibt alle Keys im Bereich 1 bis 10 (ohne die 10) zurück.

``obj.keys(-DBL_MAX, DBL_MAX)`` gibt alle Zahlenkeys zurück. (DBL_MAX ist die
Zahl 1.7976931348623158e+308.)

.. us.example

**Beispiel**

::

   obj = obj_create()
   for (i in 1:10000) {
       idx = rand(1,1) *100000;
       obj[idx] = i;
   }
   print obj.keys(1,1000)

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

:sub:`id-1690081`