INSERT IN BLOB
INSERT IN BLOB ( blob : Blob ; offset : Integer ; len : Integer {; filler : Integer} )
| Parameter | Type | Description | |
|---|---|---|---|
| Blob | Blob | → | BLOB into which bytes will be inserted |
| offset | Integer | → | Starting position where bytes will be inserted |
| len | Integer | → | Number of bytes to be inserted |
| filler | Integer | → | Default byte value (0x00..0xFF) 0x00 if omitted |
History
| Release | Changes |
|---|---|
| 6 | Created |
Description
The INSERT IN BLOB command inserts the number of bytes specified by len into the BLOB blob at the position specified by offset. The BLOB then becomes len bytes larger.
If you do not specify the optional filler parameter, the bytes inserted into the BLOB are set to 0x00. Otherwise, the bytes are set to the value you pass in filler (modulo 256 — 0..255).
Before the call, you pass in the offset parameter the position of the insertion relative to the beginning of the BLOB.
Note
Compatiblity note: Since this command alters the blob passed as a parameter, it does not support blob objects (4D.Blob type). See Passing blobs and blob objects to 4D commands.
See also
Properties
| Command number | 559 |
| Thread safe | yes |