.. highlightlang:: us

.. _nc_varrename:

nc_varrename
============

.. index:: nc_varrename

.. us.tag  nc_varrename GERMAN NC_Var New320

:ref:`nc_varrename` gibt einer netCDF-Variable einen anderen Namen.

.. function::  ret = nc_varrename(ncid, varid, ssNewName)

.. us.return

**Returnwert**

Im Fehlerfall hat *ret* den Wert -1, sonst ungleich -1.

.. us.params

**Parameter**

.. uparam:: ncid

   *ncid* ist die Zugriffsnummer, die von einem erfolgreichen Aufruf der
   Funktionen :ref:`nc_create` oder :ref:`nc_open` geliefert wurde.

.. uparam:: varid

   *varid* ist die Identifikations-Nummer einer Variablen.

.. uparam:: ssNewName

   *ssNewName* ist der neue Name der netCDF-Variablen.

::

   // Remove _Mean and _Max from all channel names:
   def _nc_modifychannelnames(ssNCName)
   {
       svRemove = ["_Mean", "_Max"];
       ncid = nc_open(ssNCName, NC_WRITE)
       if (ncid == -1) {
           MessageBoxError("Cannot open file: %s", ssNCName);
           return FALSE;
       }
       svVarNames = NC_GetVarNames(ncid);
       svVarNamesNew = svVarNames;
       for (i in 1:len(svRemove)) {
           idx = strmatchi("*" + svRemove[i], svVarNamesNew)
           if (idx[1] != 0) {
               svVarNamesNew[idx] = strfindreplace(svVarNamesNew[idx], svRemove[i], "");
           }
       }
       nc_redef(ncid);
       for (i in 1:len(svVarNamesNew)) {
           if (svVarNames[i] != svVarNamesNew[i]) {
               varid = nc_varid(ncid, svVarNames[i]);
               if (varid != -1) {
                   nc_varrename(ncid, varid, svVarNamesNew[i]);
                   nc_attput(ncid, varid, "title", NC_CHAR, svVarNamesNew[i], TRUE);
                   ssUnit = nc_attget(ncid, varid, "units");
                   ssUnit = strfindreplace(ssUnit, "[", "");
                   ssUnit = strfindreplace(ssUnit, "]", "");
                   nc_attput(ncid, varid, "long_name", NC_CHAR, ...
                           NC_long_name(svVarNamesNew[i], ssUnit), TRUE);
               }
           }
       }
       nc_endef(ncid);
       nc_close(ncid);
       return TRUE;
   }

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_create`

:sub:`id-227457`