Array Operations

The following functions can be used to manipulate and manage arrays:                                                  

#DEBUG ERROR

Control generation of error checking code

#DIM

Specify if variables must be declared before use

ARRAY ASSIGN

Assign a number of values to successive elements of an array

ARRAY DELETE

Delete a single item from a given array

ARRAY INSERT

Insert a single item into a given array

ARRAY SCAN

Scan all or part of an array for a given value

ARRAY SORT

Sort all or part of a given array

ARRAYATTR

Return descriptive attributes of a given array

BIT CALC

Set or reset a bit in an implied bit-array

BIT

Return the value of a particular bit in an implied bit-array

BIT

Manipulate individual bits of an implied bit-array

DATA

Declare an array of constants to be read by READ$

DATACOUNT

Return the total count of the number of local data items

DIM

Declare and dimension arrays, scalar variables, and pointers

ERASE

Deallocate array memory

FILESCAN

Rapidly scan an open file, before loading into an array with GET

GET

Read a complete array from a binary file

IPowerArray.ARRAYBASE

Returns the address of the first element of the array.

IPowerArray.ARRAYDESC

Returns the address of the SAFEARRAY descriptor.

IPowerArray.ARRAYINFO <Get>

Retrieves the info string, if one is present.

IPowerArray.ARRAYINFO <Set>

Assigns the info string.

IPowerArray.CLONE

An exact duplicate of the SafeArray is created, and stored in the specified PowerArray object.

IPowerArray.COPYTOVARIANT

An exact copy is made of the specified SafeArray and stored in this PowerArray object.

IPowerArray.COPYFROMVARIANT

An exact copy is made of the SafeArray in this object and stored in the specified Variant.

IPowerArray.DIM

Dimensions (creates) a new array.

IPowerArray.ELEMENTPTR

Retrieves the address of the specified data element.

IPowerArray.ELEMENTSIZE

Retrieves the storage size (in bytes) of each data element of the array.

IPowerArray.ERASE

Destroys the contained array and empties the object.

IPowerArray.LBOUND

Retrieves the lower bound number for the dimension specified.

IPowerArray.LOCK

Increments the lock count of the SAFEARRAY.

IPowerArray.MOVEFROMVARIANT

Transfers ownership of the specified SafeArray to the PowerArray object.

IPowerArray.MOVETOVARIANT

Transfers ownership of the SafeArray contained in this PowerArray object to a variant parameter.

IPowerArray.REDIM

Allows the SafeArray to be erased and re-dimensioned to a new size.

IPowerArray.REDIMPRESERVE

Allows the least significant (rightmost) bound to be changed to a new size.  The remaining data items in the array are preserved.

IPowerArray.RESET

All elements in the SafeArray are set back to their initial, default value.

IPowerArray.SUBSCRIPTS

Retrieves the number of dimensions (subscripts) for this array.

IPowerArray.UBOUND

Retrieves the upper bound number for the dimension specified

IPowerArray.UNLOCK

Decrements the lock count of the SAFEARRAY.

IPowerArray.VALUEGET

Retrieves the value of the specified array element.

IPowerArray.VALUESET

Assigns the specified value to the specified array element.

IPowerArray.VALUETYPE

Retrieves the %VT code which describes the data contained in this array.

JOIN$

Return a string consisting of all of the strings in a string array

LBOUND

Return the lowest subscript of an array's specific dimension

LET

Assign a Variant to an array or an array to a Variant

LINE INPUT#

Read line(s) from a sequential file into a string variable or array

MAT

Matrix calculations on numeric arrays

PARSE

Parse a string and extract all delimited fields into an array

PRINT#

Write a complete array to a sequential file

PUT

Write a complete array to a binary file

READ$

Retrieve string data from a local DATA list

REDIM

Declare dynamic arrays, allocate, reallocate, deallocate memory

RESET

Set an array subscript or an entire array to zero or null/empty

UBOUND

Return the highest subscript of an array's specific dimension