.. highlightlang:: us

.. _aop_getval:

aop_getval
==========

.. index:: aop_getval

.. us.tag  aop_getval NOTREADYGERMAN New500 asam3

:ref:`aop_getval` liefert die Werte von Applikations-Elementen.

.. function::  nvSeq = aop_getval(envId, applId, nuSeq, nsSeq, elemId, refName, cl)

.. us.return

**Returnwert**

*nvSeq* ist ein Objekt mit folgendem Aufbau:

::

   nvSeq.n
   nvSeq[1].name
   nvSeq[1].unitId
   nvSeq[1].valMap.dtyp
   nvSeq[1].valMap.val

Im Fehlerfall liefert die Funktion ein Error-Objekt (siehe :ref:`error_create`).

.. us.params

**Parameter**

.. uparam:: envId

   *envId* ist die Environment-ID, die von der Funktion :ref:`aop_openenv` geliefert
   wird.

.. uparam:: applId

   *applId*.

.. uparam:: nuSeq

   *nuSeq* ist ein Array von AOP_NameU-Strukturen der Form:

   C:

   ::

      struct AOP_NameU {
          AOP_Name name;
          AOP_Id unitId;
      };

   UniScript:

   ::

      nuSeq = [. n = 1];
      nuSeq[1] = [. name = "NAME", unitId = 123];

.. uparam:: nsSeq

   *nsSeq* ist ein Array von AOP_NameS-Strukturen der Form:

   C:

   ::

      struct AOP_NameS {
          AOP_Name name;
          AOP_ValMap valMap;
          AOP_SelOpcode selOpcode;
      };

   UniScript:

   ::

      nsSeq = [. n = 1]
      nsSeq[1] = [. name = "VersuchsID", 
                    valMap = [. dtyp = ODS_DT_DOUBLE, 
                                val = [1]], 
                    selOpcode = 6 ]

.. uparam:: elemId

   *elemId*.

.. uparam:: refName

   *refName*.

.. uparam:: cl

   *cl* ist der Client-Pointer, der von der Funktion :ref:`rpc_clnt_create` geliefert
   wird.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.0.0
     - Neu

.. seealso::
   :ref:`uberblick-asam-ods`

:sub:`id-2006625`