.. highlightlang:: us

.. _nc_varput_text:

nc_varput_text
==============

.. index:: nc_varput_text

.. us.tag  nc_varput_text GERMAN NC_Var New6002

:ref:`nc_varput_text` schreibt Textdaten in eine netCDF-Variable in eine
geöffnete netCDF-Datei, die sich im Daten-Modus befinden muss.

.. function::  r = nc_varput_text(ncid, varid, rsStart, rsCount, svData)

.. us.return

**Returnwert**

*r* hat den Wert -1, falls ein Fehler beim Schreiben auftritt.

.. 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. Der Datentyp muss 
   NC_CHAR sein und die Variable muss zwei Dimensionen haben.

.. uparam:: rsStart

   *rvStart* ist der Startindex, der mit 0 beginnt.

.. uparam:: rsCount

   *rvCount* ist die Anzahl der Strings, die geschrieben werden sollen.

.. uparam:: values

   *svData* ist ein Stringvektor.

.. us.example

**Beispiel**

::

   svData = ["Text1", "Another Text", "A Long Text"];
   ncid = nc_create("d:/test.nc");
   dimid1 = nc_dimdef(ncid, "n", len(svData));
   dimid2 = nc_dimdef(ncid, "nChar", max(strlen(svData))); // longest text

   varid = nc_vardef(ncid, "text", NC_CHAR, [dimid1, dimid2]);
   nc_endef(ncid);
   nc_varput_text(ncid, varid, 0, len(svData), svData);
   nc_close(ncid);

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_create`,
   :ref:`nc_dimdef`,
   :ref:`nc_vardef`,
   :ref:`nc_endef`,
   :ref:`nc_redef`,
   :ref:`nc_close`,
   :ref:`nc_varget`,
   :ref:`nc_varput`,
   :ref:`nc_varput_missing`,
   :ref:`strcode`

:sub:`id-885951`