.. highlightlang:: us

.. index:: nc_get_option

.. _nc_get_enum_values:

nc_get_enum_values
==================

.. us.tag  nc_get_enum_values ENGLISH NC New5600

:ref:`nc_get_enum_values` return a matrix with enum values or an empty string.

.. function::  smLabel = nc_get_enum_values(ncid, varid)

.. us.return

**Return Value**

*smLabel* is a string matrix with two colums. The first column contains the 
value as a string and the second column contains the text. If the channel
does not contain the attribute ``_nc_enum`` the return value is an empty string.

.. us.params

**Parameters**

.. uparam:: ncid

   Identifies the netCDF file.

.. uparam:: varid

   *varid* is the ID of a variable.

.. us.comment

**Comment**

Returns the value of the variable attribute ``_nc_enum``. 

.. us.example

**Example**

::

   * smLabel = nc_get_enum_values(ncid, varid);
   * smLabel
      3SNA
      2INT
      1ANST
      0NANST
   * strtod(smLabel[;1])
      3.0000 
      2.0000 
      1.0000 
      0.0000 

.. us.history

**History**

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

   * - Version
     - Description
   * - R2014.0
     - New

.. seealso::
   :ref:`overview-netcdf-files`,
   :ref:`nc_open`,
   :ref:`nc_set_option`

:sub:`id-331005`