Element: blob.part ( )

Syntax

<ident> = <blob>.part({<range> ,...})

   or

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

Type

blob or procedure

Description

A function which extracts byte values of the blob.

If called as part of a blob assignment or expression, the return value of this function is a copy of the blob restricted to specified byte ranges. The original blob is left unchanged.

If called stand-alone, there is no return value but the blob is replaced with the specified byte range(s).

The parameters to this function are one or more byte ranges. 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 to be extracted.

The code of this function cannot be redefined.

Examples

Replace a blob with a restricted byte-range:

myblob.part(50:100)

Extract a range of bytes (10 bytes in fact), and return the result into another blob:

blob newblob = myblob.part(11:20)

See Also