.. highlightlang:: us

.. index:: auto_ReadNCText

.. _auto_readnctext:

auto_ReadNCText
===============

.. us.tag  auto_ReadNCText NOTREADYGERMAN

Die Funktion :ref:`auto_ReadNCText` liest ein Attribut aus der zuletzt mit der
Funktion :ref:`auto_ImportData` geöffneten Datendatei.

.. function::  ssText = auto_ReadNCText(ssVariable, ssAttribute)

.. us.return

**Returnwert**

*ssText* ist der Wert des Attributs als Text. Zahlenwerte
werden in Texte umgewandelt. Handelt es sich um einen Vektor, so
werden die einzelnen Elemente durch ein Komma, gefolgt von einem
Leerzeichen getrennt. Beispiel: ``"1, 2"``.

.. us.params

**Parameter**

.. uparam:: ssVariable

   *ssVariable* ist der Name der Variablen. Um ein globales Attribut zu lesen,
   kann als Variablenname der String ``"GLOBAL"`` angegeben werden.

.. uparam:: ssAttribute

   *ssAttribute* ist der Name des Attributs.

.. us.comment

**Kommentar**

Bei den Parametern *ssVariable* und *ssAttribut* muss auf
Groß- und Kleinschreibung geachtet werden.

.. us.example

**Beispiel**

::

   auto_ImportData(GetRootDirectory() + "samples/vollast.asc");
   ssFile = auto_ReadNCText("GLOBAL", "Origin");
   auto_ReplaceText("$Data$", ssFile);

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_ReplaceTextDialog`,
   :ref:`auto_ReplaceText`

:sub:`id-359204`