TEXT TO BLOB

4D - Documentation   Français   English   German   Spanish   Japanese   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next

Version 11 (Geändert)


TEXT TO BLOB (Text; Blob; TextFormat{; Offset | *})

ParameterTypBeschreibung
TextStringText zum Schreiben ins BLOB
BlobBLOBBLOB zum Empfangen des Textes
TextFormatNumerischFormat und Zeichensatz des Textes
Offset | *Variable | *Versatz im BLOB (in Bytes)
oder * zum Anfügen des Wertes
Ohne *: Neuer Versatz nach Schreiben in BLOB

Beschreibung

Der Befehl TEXT TO BLOB schreibt den Wert Text in Blob.

Der Parameter TextFormat legt das interne Format und den Zeichensatz des zu schreibenden Textwertes fest. Übergeben Sie dazu eine der folgenden vordefinierten Konstanten unter dem Thema BLOB:

KonstanteTypWert
Mac C stringLange Ganzzahl0
Mac Pascal stringLange Ganzzahl1
Mac Text with lengthLange Ganzzahl2
Mac Text without lengthLange Ganzzahl3
UTF8 C stringLange Ganzzahl4
UTF8 Text with lengthLange Ganzzahl5
UTF8 Text without lengthLange Ganzzahl6

Geben Sie den Parameter TextFormat nicht an, verwendet 4D standardmäßig das Format Mac C string. In Anwendungen, die mit 4D v11 erstellt wurden, arbeitet 4D standardmäßig mit dem Unicode Zeichensatz (UTF8) zur Textverwaltung, deshalb wird empfohlen, diesen Zeichensatz zu verwenden.

Hinweise:

Die "UTF8" Konstanten sind nur verwendbar, wenn die Anwendung im Unicode Modus arbeitet.

Die "Mac" Konstanten können nicht mit Text größer als 32 KB arbeiten.

Wollen Sie mit einem anderen Zeichensatz als UTF8 arbeiten, verwenden Sie den Befehl CONVERT FROM TEXT.

Die verschiedenen Formate werden im folgenden beschrieben:

TextformatBeschreibung und Beispiele
C String Der Text endet mit dem Zeichen NULL (ASCII Code $00)
UTF8"" $00
"Café" $43 61 66 C3 A9 00
Mac"Café" $43 61 66 8E 00

Pascal StringDem Text ist eine 1-Byte Länge vorangestellt
UTF8-
Mac"" $00
"Café" $04 43 61 66 8E

Text mit LängeDem Text ist eine 3-Byte (UTF8) oder 2-Byte Länge (Mac) vorangestellt
UTF8"" $00 00 00 00
"Café" $00 00 00 05 43 61 66 C3 A9
Mac"" $00 00
"Café" $00 04 43 61 66 8E

Text ohne LängeDer Text besteht nur aus seinen Zeichen
UTF8"" Kein Wert
"Café" $43 61 66 C3 A9
Mac"" Kein Wert
"Café" $43 61 66 8E

Geben Sie den optionalen Parameter * an, wird der Wert vom Typ Zahl an das BLOB angefügt und die Größe des BLOB entsprechend erweitert. Mit dem optionalen Parameter * können Sie jede Zahl vom Typ Ganzzahl, Lange Ganzzahl, Zahl oder Text (siehe andere BLOB Befehle) sequentiell in einem BLOB speichern, solange der Speicher für das BLOB ausreicht.

Geben Sie den optionalen Parameter * oder den Parameter Offset nicht an, wird der Textwert am Anfang des BLOB gespeichert, der bisherige Inhalt wird überschrieben. Die Größe des BLOB wird entsprechend angepasst.

Übergeben Sie den Parameter Offset, wird der Textwert im BLOB am Byte-Versatz geschrieben (von Null ausgehend). Egal, wo Sie den Wert schreiben, die Größe des BLOB wird gemäß der übergebenen Position erhöht (bei Bedarf bis zur Größe des Textes). Neu zugewiesene Bytes, die Sie nicht schreiben, werden auf Null initialisiert.

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

Beispiele

1. Nach Ausführen dieses Code:

   SET BLOB SIZE (vxBlob;0)
   C_TEXT (vtValue)
   vtValue := "Café" ` Länge von vtValue ist 4 Bytes
   TEXT TO BLOB (vtValue;vxBlob;Mac C string) ` BLOB Größe wird 5 Bytes
   TEXT TO BLOB (vtValue;vxBlob;Mac Pascal string) ` BLOB Größe wird 5 Bytes
   TEXT TO BLOB (vtValue;vxBlob;Mac Text with length) ` BLOB Größe wird 6 Bytes
   TEXT TO BLOB (vtValue;vxBlob;Mac Text without length) ` BLOB Größe wird 4 Bytes
   TEXT TO BLOB (vtValue;vxBlob;UTF8 C string)  ` BLOB Größe wird 6 Bytes
   TEXT TO BLOB (vtValue;vxBlob;UTF8 Text with length)  ` BLOB Größe wird 9 Bytes
   TEXT TO BLOB (vtValue;vxBlob;UTF8 Text without length)  ` BLOB Größe wird 5 Bytes


Referenz

BLOB to integer, BLOB to longint, BLOB to real, BLOB to text, CONVERT FROM TEXT, INTEGER TO BLOB, LONGINT TO BLOB, REAL TO BLOB.

Anwendung des Befehls

Record to BLOB


4D - Documentation   Français   English   German   Spanish   Japanese   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next