BlobEdit
PowerScript function
Description
Inserts data of any PowerBuilder datatype into a blob
variable.
Syntax
|
1 |
BlobEdit ( blobvariable, n, data {, encoding} ) |
|
Argument |
Description |
|---|---|
|
blobvariable |
An initialized variable of the blob datatype into |
|
n |
The number (1 to 4,294,967,295) of the position in |
|
data |
Data of a valid PowerBuilder datatype that you want |
|
encoding |
Character encoding of the blob variable in which you
|
Return value
Unsigned long. Returns the position at which the next data can be
copied if it succeeds, and returns null if there is not enough space in
blobvariable to copy the data. If any argument’s value is null,
BlobEdit returns null.
If the data argument is a string, the position in the
blobvariable in which you want to copy data will be the length of the
string + 2. If the data argument is a string converted to a blob, the
position will be the length of the string + 1. This is because a string
contains a null terminating character that it loses when it is converted
to a blob. Thus, BlobEdit (blob_var, 1, “ZZZ”) returns 5, while BlobEdit
(blob_var, 1, blob (”ZZZ”) ) returns 4.
Use the encoding parameter if the data argument is a string and you
want to generate a blob with a specific encoding.
Examples
This example copies a bitmap in the blob emp_photo starting at
position 1, stores the position at which the next copy can begin in nbr,
and then copies a date into the blob emp_photo after the bitmap
data:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
blob{1000} emp_photo blob temp date pic_date ulong nbr ... // Read BMP file containing employee picture ... // into temp using FileOpen and FileRead. pic_date = Today() nbr = BlobEdit(emp_photo, 1, temp) BlobEdit(emp_photo, nbr, pic_date) UPDATEBLOB Employee SET pic = :emp_photo WHERE ... |
This example copies a string into the blob blb_data starting at
position 1 and specifies that the blob should use ANSI encoding:
|
1 2 3 4 5 |
blob{100} blb_data string str1 = "This is a string" ulong ul_pos ul_pos = BlobEdit (blb_data, 1, str1, EncodingANSI!) |
See also