nc_attput fügt einer Variablen ein Attribut hinzu oder ändert ein vorhandenes Attribut.
Returnwert
r ist größer oder gleich 0 wenn die Funktion erfolgreich war und im Fehlerfall kleiner als 0.
Parameter
ncid ist die Zugriffsnummer, die von einem erfolgreichen Aufruf der Funktionen nc_create oder nc_open geliefert wurde.
varid ist die Identiätsnummer (ID) der Variablen oder NC_GLOBAL (-1) für ein globales Attribut. Die Variablen ID beginnt mit 0.
ssName ist der Name des Attributs. Der Name muss mit einem Buchstaben beginnen, gefolgt von 0 oder mehr Buchstaben oder Zahlen sowie dem Unterstrich (_). Groß- und Kleinbuchstaben werden unterschieden.
nDataType ist der Datentyp des Attributs. Er kann folgende Werte annehmen:
| Wert | Bedeutung |
|---|---|
| NC_BYTE | Ein Byte |
| NC_CHAR | Ein Zeichen |
| NC_SHORT | 16-Bit Integer |
| NC_LONG | 32-Bit Integer |
| NC_FLOAT | 32-Bit Fließkommazahl |
| NC_DOUBLE | 64-Bit Fließkommazahl |
values sind die Werte des Attributs. values kann ein Spalten- oder Zeilenvektor sein.
Falls bOverwrite auf den Wert TRUE (1) gesetzt wird, wird der Wert des Attributs überschrieben. Falls bOverwrite auf den Wert FALSE (0) gesetzt wird, wird ein neues Attribut erzeugt (Default). Durch eine an den Namen angehängte Zahl wird ein eindeutiger Attributname erzeugt.
Kommentar
Die Datei muss sich im Definitions-Modus befinden (siehe nc_redef).
Siehe auch
Überblick UniPlot-Datendateien, Kanal-Attribute, nc_create, nc_attget, nc_inquire_ngatts, nc_varinq_natts, nc_attinq_datatype, nc_attinq_len, nc_attname
id-550528