4D Doc Center : BLOB to text

Home

4D v14.3

BLOB

BLOB to text


BLOB to text ( BLOB ; TextFormat {; Offset {; TextLänge}} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
BLOB	BLOB	BLOB zum Entnehmen des Textes
TextFormat	Lange Ganzzahl	Format und Zeichensatz des Textes
Offset	Variable	Versatz im BLOB (in Bytes)
		Neuer Versatz nach dem Lesen
TextLänge	Lange Ganzzahl	Anzahl der zu lesenden Zeichen
Funktionsergebnis	Text	Textwert

Beschreibung

Die Funktion BLOB to text gibt einen aus BLOB gelesenen Textwert zurück.

Der Parameter TextFormat legt das interne Format und den Zeichensatz des zu lesenden Textwertes fest. In Datenbanken, die mit 4D v11 erstellt wurden, verwendet 4D standardmäßig den Unicode Zeichensatz zur Textverwaltung. Zur Wahrung der Kompatibilität kann dieser Befehl die Umwandlung in den Mac Roman Zeichensatz erzwingen, der in früheren Versionen verwendet wurde. Der Zeichensatz wird im Parameter TextFormat definiert. Übergeben Sie eine der folgenden vordefinierten Konstanten unter dem Thema BLOB:

Konstante	Typ	Wert
Mac C string	Lange Ganzzahl	0
Mac Pascal string	Lange Ganzzahl	1
Mac text with length	Lange Ganzzahl	2
Mac text without length	Lange Ganzzahl	3
UTF8 C string	Lange Ganzzahl	4
UTF8 text with length	Lange Ganzzahl	5
UTF8 text without length	Lange Ganzzahl	6

Hinweise:

Die “UTF8” Konstanten sind nur verwendbar, wenn die Anwendung im Unicode Modus arbeitet.
Die “Mac “ Konstanten können nicht mit Texten größer als 32 KB arbeiten.
Wollen Sie mit anderen Zeichensätzen als UTF8 arbeiten, verwenden Sie die Funktion Convert to text.

Weitere Informationen zu diesen Formaten finden Sie in der Beschreibung zum Befehl TEXT TO BLOB.

Warnung: Die Anzahl der zu lesenden Zeichen wird durch den Parameter TextFormat festgelegt, mit Ausnahme der Formate Mac Text without length und UTF8 Text without length. Hier müssen Sie im Parameter TextLänge die Anzahl der Zeichen festlegen, da sonst der komplette Inhalt gelesen wird. Dieser Parameter wird für die anderen Formate ignoriert und Sie können ihn weglassen.

Geben Sie den optionalen Parameter Offset an, wird der Textwert im BLOB am Versatz gelesen (beginnend bei Null). Geben Sie den optionalen Parameter Offset nicht an, wird der Anfang des Blob gemäß dem in TextFormat übergebenen Wert gelesen. Beachten Sie, dass Sie beim Lesen von Text ohne Länge den Parameter Offset übergeben müssen.

Hinweis: Übergeben Sie als Versatz einen Wert (in Bytes) zwischen 0 (Null) und der BLOB-Größe minus der zu lesenden Textgröße. Andernfalls ist das Funktionsergebnis nicht vorhersehbar.

Nach dem Aufruf wird die Variable um die Anzahl der gelesenen Bytes erhöht. Von daher können Sie dieselbe Variable mit einem anderen BLOB Befehl zum Schreiben eines anderen Wertes verwenden.