Version 11 (Geändert)
BLOB to text (Blob; TextFormat{; Offset{; TextLänge}}) Text
Parameter | Typ | Beschreibung | |
Blob | BLOB | BLOB zum Entnehmen des Textes | |
TextFormat | Numerisch | Format und Zeichensatz des Textes | |
Offset | Variable | Versatz im BLOB (in Bytes) | |
Neuer Versatz nach dem Lesen | |||
TextLänge | Numerisch | 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 Beschrei-bung 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. Dieser Parameter wird für die anderen Formate ignoriert. Sie müssen dafür keinen Wert eintragen.
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.
Referenz
BLOB to integer, BLOB to longint, BLOB to real, INTEGER TO BLOB, LONGINT TO BLOB, REAL TO BLOB, TEXT TO BLOB.