FRESetArrayLength()

AIR 3.0 and later

Usage

FREResult FRESetArrayLength ( 
            FREObject             arrayOrVector, 
            uint32_t             length 
);

Parameters

arrayOrVector
An FREObject that represents an ActionScript Array or Vector class object.

length
A uint32_t. This method sets the length of the Array or Vector class object to this parameter’s value.

Returns

An FREResult. The possible return values include, but are not limited to, the following:

FRE_OK
The function succeeded. The runtime has changed the size of the Array or Vector object.

FRE_ILLEGAL_STATE
The extension context has acquired an ActionScript BitmapData or ByteArray object. The context cannot call this method until it releases the BitmapData or ByteArray object.

FRE_INSUFFICIENT_MEMORY
The runtime could not allocate enough memory to change the size of the Array or Vector object.

FRE_INVALID_ARGUMENT
The length parameter is greater than 2 32 .

FRE_INVALID_OBJECT
The arrayOrVector FREObject parameter is invalid.

FRE_READ_ONLY
The arrayOrVector FREObject parameter represents a ActionScript Vector object that has a fixed size. (Its fixed property is true.)

FRE_TYPE_MISMATCH
The arrayOrVector FREObject parameter does not represent an ActionScript Array or Vector class object.

FRE_WRONG_THREAD
The method was called from a thread other than the one on which the runtime has an outstanding call to a native extension function.

Description

Call this function to set the length of an ActionScript Array or Vector class object. The FREObject parameter arrayOrVector corresponds to the Array or Vector object. The runtime changes the size of the Array or Vector object as specified by the length parameter.

// Ethnio survey code removed