Blob

Converts a string or byte array to a blob.

To

Use

Convert a string to a blob

Syntax 1 Convert a string to a blob

Convert a string or byte array to a blob

Syntax 2 Convert a string or a byte array to a blob


Syntax 1 Convert a string to a blob

Description

Converts a string to a blob datatype.

Syntax

Blob ( text {, encoding} )

Argument

Description

text

The string you want to convert to a blob datatype

encoding

Character encoding of the resulting blob. Values are:

  • EncodingANSI!

  • EncodingUTF8!

  • EncodingUTF16LE! (default)

  • EncodingUTF16BE!

Returns

Blob. Returns the converted string in a blob with the requested encoding, if specified. If text is null, Blob returns null.

Usage

If the encoding argument is not provided, Blob converts a Unicode string to a Unicode blob. You must provide the encoding argument if the blob has a different encoding.

Examples

Example 1

This example saves a text string as a Unicode blob:

Blob B

B = Blob("Any Text")

Example 2

This example saves a text string as a blob with UTF-8 encoding:

Blob Blb

Blb = Blob("Any Text", EncodingUTF8!)

See also


Syntax 2 Convert a string or a byte array to a blob

Description

Converts a string or an array of bytes to a blob datatype.

Syntax

Blob ( array[ ] )

Argument

Description

stringorbytearray

An Any variable that holds a string or an array of bytes you want to convert to a blob datatype

Returns

Blob. Returns the converted string or byte array in a blob.

Examples

Example 3

This example saves an array of bytes as a blob, then copies the contents of the blob to another byte array:

Blob lblb_1
Any a
byte lbyte_array[], lbyte_array2[]

// initialize array
lbyte_array[] = {1,10,100,200,255}

a = lbyte_array
lblb_1 = Blob(a)

lbyte_array2[] = GetByteArray(lblb_1)

See also