ProfileReadValue / ReadProfileValue

value ProfileReadValue ( string strSectionName, string strKeyName, value BYREF Result, value Default = 0, string strFileName = "", value bWriteDefault = TRUE );

value ReadProfileValue ( string strSectionName, string strKeyName, value BYREF Result, value Default = 0, string strFileName = "", value bWriteDefault = TRUE );

Rückgabewert

Die Anzahl der gelesenen Zeichen.

Parameter

strSectionName

Die Sektion in der INI-Datei, aus der gelesen werden soll.

strKeyName

Der Eintrag (Name vor dem '=') dessen Wert gelesen werden soll.

Result

Der gelesene Wert.

Default

Der Alternativwert welcher für Result verwendet werden soll, falls der Eintrag strKeyName in der INI-Datei nicht existiert.

strFileName

Die INI-Datei, aus der gelesen werden soll. Wird kein Datename bzw. ein Leerstring angegeben, dann wird die Projekt-INI-Datei verwendet.

bWriteDefault

Gibt an ob der Eintrag strKeyName mit dem Default-Wert in die INI-Datei geschrieben werden soll, wenn der Eintrag nicht existiert.

Bemerkung

Liest den Wert/Text des Eintrags strKeyName in der Sektion strSectionName aus der INI-Datei strFileName aus. Wird der Eintrag nicht gefunden, so wird das Ergebnis Result mit dem Wert Default geladen.

Beispiel

if (Button1 == 1)
   ProfileReadValue ("DATEN", "Druck", Pressure, 999, "Druck.ini");
end
   
Ermittelt aus der Datei "Druck.ini" in der Sektion "DATEN" den Wert des Schlüssels "Druck" und übergibt diesen an die numerische Variable Pressure sobald die Variable Button1 (z.B. durch einen Tastendruck) den Wert "1" besitzt.
Tritt beim Lesen ein Fehler auf, wird die Variable Pressure auf den Wert "999" gesetzt.
   
Aufbau der INI-Datei für obiges Beispiel:
   
[DATEN]
Druck = 66.12

Profile (INI-Datei) Funktionen

Siehe auch WriteProfileValue