4D Doc Center : Convert to text

4D v13.4

Convert to text


Convert to text ( BLOB ; Zeichensatz ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
BLOB	BLOB	BLOB mit Text im angegebenen Zeichensatz
Zeichensatz	String, Lange Ganzzahl	Name oder Nr. des BLOB Zeichensatzes
Funktionsergebnis	Text	Inhalt des BLOB in 4D Zeichensatz

Beschreibung

Die Funktion Convert to text konvertiert den Text im Parameter BLOB und gibt den Text im Zeichensatz von 4D zurück. 4D verwendet in Version 11 den Unicode Zeichensatz.

In Zeichensatz übergeben Sie den Zeichensatz des in BLOB enthaltenen Textes für die Konvertierung. Sie können eine Zeichenkette mit dem Standardnamen des Zeichensatzes übergeben oder eins seiner Aliase (z.B. “ISO-8859-1” oder “UTF-8”) bzw. Identifier (Lange Ganzzahl). Weitere Informationen dazu finden Sie in der Beschreibung zum Befehl CONVERT FROM TEXT.

Convert to text unterstützt BOM (Byte Order Marks). Ist der angegebene Zeichensatz vom Typ Unicode (UTF-8, UTF-16 oder UTF-32), versucht 4D unter den ersten empfangenen Bytes ein BOM zu identifizieren. Wurde es gefunden, wird es aus dem Ergebnis gefiltert und 4D verwendet den hier definierten Zeichensatz statt des angegebenen.

Hinweis: Dieser Befehl funktioniert nur, wenn 4D im Unicode Modus ausgeführt wird, d.h. in den Voreinstellungen der Datenbank muss die Option Unicode markiert sein (siehe Abschnitt ASCII Codes). Bei Verwendung im Modus Kompatibilität (Nicht-Unicode) wird der Parameter BLOB konvertiert leer zurückgegeben, die Variable OK wird auf 0 (Null) gesetzt.

Systemvariablen und Mengen

Wurde der Befehl korrekt ausgeführt, wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null).