.. highlightlang:: us

.. _aop_getval:

aop_getval
==========

.. index:: aop_getval

.. us.tag  aop_getval NOTREADYENGLISH New500 asam3

:ref:`aop_getval` returns the values of application elements.

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

.. us.return

**Return Value**

*nvSeq* is an object of the following form:

::

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

In case of an error an error object is returned (see :ref:`error_create`).

.. us.params

**Parameters**

.. uparam:: envId

   *envId* is the environment Id, returned by :ref:`aop_openenv`.

.. uparam:: applId

   *applId*.

.. uparam:: nuSeq

   *nuSeq* is an array of AOP_NameU structures of the following form:

   C:

   ::

      struct AOP_NameU {
          AOP_Name name;
          AOP_Id unitId;
      };

   UniScript:

   ::

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

.. uparam:: nsSeq

   *nsSeq*  is an array of AOP_NameS structures of the following 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* is the client pointer, returned by :ref:`rpc_clnt_create`.

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.0.0
     - New

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

:sub:`id-2006625`