Element: blob.values ( )

Syntax

<blob>.values({<range> ,...})

Type

numeric[ ]

Description

A function which returns the byte values of the blob as an array of numerics.

The parameters to this function are one or more byte ranges whose values are required. Each range is in the form startbyte:endbyte or just byte if only one byte is required. The ranges are comma-separated and do not have to be consecutive in byte order. Omitting the range parameters implies that all byte values are required. All returned values will be in the range 0 through 255.

Care should be taken when requesting all byte values from large blobs, keeping in mind memory considerations.

The code of this function cannot be redefined.

Examples

Get all the bytes of a blob

numeric vals[] = myblob.values()

Get specific byte ranges of a blob, in this case 23 values in all.

numeric vals[] = myblob.values(50:60,10:20,35)

See Also