.. highlightlang:: us

.. _nc_attname:

nc_attname
==========

.. index:: nc_attname

.. us.tag  nc_attname NOTREADYENGLISH NC_Att  Changed5806

:ref:`nc_attname` returns the attribute name.

.. function::  ssName = nc_attname(ncid, varid, attnum)
    ssName = nc_attname(ncid, varid, attnum, bToUnderscore)

.. us.return

**Return Value**

*ssName*

.. us.params

**Parameters**

.. uparam:: ncid

   Identifies the netCDF file.

.. uparam:: varid

   *varid* is the variable ID of the variable to which
   the attribute will be assigned, or -1 for a global attribute.

.. uparam:: attnum

   *attnum* is the attribute number.

.. uparam:: bToUnderscore

   If *bToUnderscore* is TRUE (1) the special characters in the attribute name
   are replaced by underscores. For the value 0 the special characters remain in
   the channel name. Allowed spezial characters: 
   ``.``, ``-``, ``+``, ``$``, ``#``, ``~``, ``!``, ``^``, ``&``, ``%``
   Defaul value is FALSE (0).

.. us.history

**History**

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

   * - Version
     - Description
   * - R2016.6
     - Optional parameter bToUnderscore.

.. seealso::
   :ref:`overview-netcdf-files`,
   :ref:`nc_varinq_name`,
   :ref:`nc_create`

:sub:`id-487124`