TEXT TO BLOB

Version 11 (Geändert)

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

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. In Datenbanken, die mit 4D v11 erstellt wurden, verwendet 4D standardmäßig den Unicode Zeichensatz (UTF8) 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 dazu eine der folgenden vordefinierten Konstanten unter dem Thema BLOB:

• 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, verwen-den Sie den Befehl CONVERT FROM TEXT.

Die verschiedenen Formate werden im folgenden beschrieben:

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

Text mit Länge	Dem 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änge	Der 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.

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

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

---