.. highlightlang:: us .. _writeprofilestring: WriteProfileString ================== .. index:: WriteProfileString .. us.tag WriteProfileString GERMAN uniplot-registry Changed5101 :ref:`WriteProfileString` schreibt einen String in den angegebenen Abschnitt einer Initialisierungsdatei bzw. in die Registrierdatenbank. .. function:: bool = WriteProfileString(ssSection, ssKey, ssString) bool = WriteProfileString(ssSection, ssKey, ssString, ssFileName) .. us.return **Returnwert** *bool* ist TRUE (1), wenn die Funktion erfolgreich war und FALSE (0), wenn die Funktion nicht erfolgreich war. .. us.params **Parameter** .. uparam:: ssSection *ssSection* enthält den Abschnittsnamen. Wenn der Abschnitt nicht existiert, wird er erzeugt. Der Name kann eine beliebige Kombination aus Groß- und Kleinbuchstaben sein. .. uparam:: ssKey *ssKey* ist der Schlüsselname. Wenn der Name nicht existiert, wird er erzeugt. Wenn *ssKey* ein leerer String ist (String der Länge 0) werden alle Einträge des Abschnitts gelöscht. .. uparam:: ssString *ssString* ist ein skalarer String der in die Initialisierungsdatei geschrieben wird. Wenn *ssString* ein leerer String ist (String der Länge 0), wird der Schlüssel *ssKey* gelöscht. Es werden maximal 16384 Zeichen gespeichert. .. uparam:: ssFileName In *ssFileName* kann der komplette Name (Dateiname mit Pfad) einer Initialisierungsdatei angegeben werden. Falls die Datei nicht existiert, wird sie erzeugt. Wenn dieser Parameter nicht angegeben wird, wird die Windows-Registrierdatenbank verwendet und zwar unter dem Schlüsselnamen :file:`HKEY_CURRENT_USER\\Software\\RSB\\UniPlot5`. .. us.example **Beispiel** Der folgende Aufruf erzeugt eine INI-Datei (test.ini) :: WriteProfileString("Section", "Key", "Test", "d:/test.ini") mit dem Inhalt :: [Section] Key=Test .. us.comment **Kommentar** Falls INI-Dateien geschrieben werden, wird in UNICODE-INI-Dateien UNICODE geschrieben, sonst ANSI. UniPlot erzeugt per Default ANSI-Dateien. INI-Dateien können auch nachträglich, z. B. mit notepad.exe, in UNICODE-Dateien umgewandelt werden. .. us.history **History** .. list-table:: :header-rows: 1 * - Version - Beschreibung * - 5.10.1 - Falls eine INI-Datei geschrieben wird, werden Zeichen mit einem Code kleiner 0x20 (blank) als Escape-Sequenzen geschrieben. Vor den String wird in diesem Fall die Zeichenkette "esc:" geschrieben. .. seealso:: :ref:`uberblick-dateien`, :ref:`GetProfileString`, :ref:`WriteProfileInt` :sub:`id-1988435`