Syntax:

BufGetVector (variable reference, position, vector attribute, no. of elements, value as pointer, cell storage, cell length)

Parameters:

variable reference – The reference to the BLOB variable containing the buffer. For example, 'A'VAR

position – The numeric value defining the starting position of the conversion method.

vector attribute – A number defining the vector attribute type. Valid vector attributes are:

1 – Alpha
2 – Numeric
3 – Logical
4 – Date
5 – Time
6 – BLOB

no. of elements – A numeric value representing the length of the vector.

value as pointer – A logical value indicating if the Vector value should be written directly to the buffer or as a pointer to the data. If you enter True, Magic xpa writes the Vector value as a pointer.

cell storage – The storage type of the vector cells that will be used when the external vector is read from the buffer. This parameter can be any of the appropriate storage types that relate to the cell attribute.

cell length – The storage length type of the vector cells that will be used when the Magic xpa vector is created from the external vector. This parameter can be any of the appropriate lengths that relate to the storage type.

For valid storage numbers and lengths, refer Magic xpa Storage Types.

Returns:

A Vector. Null is returned if the functions fails.

The function fails when the:

• Position is a negative value.

• Position and length are not part of the contents of the BLOB.

• The storage parameter does not contain a valid number.

• The length parameter does not contain a valid value.

See also:

Buffers

BufSetVector

The Online and Rich Client Samples projects (program CS04 and RCS04)