ARRAY2LIST method (System)
Description
Utility method to convert data stored in an EDITTABLE ARRAY property structure (Column/Row) to an EDITTABLE LIST property structure (Row/Column).
Syntax
List = Exec_Method( "SYSTEM",
"ARRAY2LIST",
Array,
ColSize,
RowSize,
PrimaryDelim,
SecondaryDelim )
Parameters
| Name | Required | Description |
|---|---|---|
| Array | Yes | Data to convert. This should be in the same format as the data used with the EDITTABLE ARRAY property, i.e. columns are delimited by @fm, and rows delimited by @vm within each column. |
| ColSize | No | Number of columns to convert. If not specified the system determines the number of columns itself. Defaults to 0. |
| RowSize | No | Number of rows to convert. If not specified the system determines the number of rows itself. Defaults to 0. |
| PrimaryDelim | No | Delimiter to use when parsing the Array for columns, and when delimiting rows in the returned List. Defaults to @fm. |
| SecondaryDelim | No | Delimiter to use when parsing the Array for rows, and when delimiting columns in the returned List. Defaults to @vm. |
Returns
Converted data structured as per the EDITTABLE LIST property, i.e. rows are delimited by the PrimaryDelim (@fm) and columns are delimited by SecondaryDelim (@vm) in each row.
Remarks
ColSize and RowSize are optional. They do not limit the actual number of columns and rows processed by this method – they are simply used as a guideline to help with some internal memory optimization, which may help performance when processing very large arrays.
Example
* // Get the contents of an EDITTABLE control in ARRAY format and convert
* // it to the LIST format (Yes, you could just get the LIST property
* // but this is for demo purposes).
ObjxArray = @Window : ".EDT_MYDATA"
PropArray = "ARRAY"
ObjxArray := @Rm : @Window : ".EDT_MYDATA"
PropArray := @Rm : "LIMIT"
DataArray = Get_Property( ObjxArray, PropArray )
EdtArray = DataArray[1,@Rm]
EdtDims = DataArray[Col2()+1,@Rm]
* // Convert the format
EdtList = Exec_Method( "SYSTEM", "ARRAY2LIST",
EdtArray,
EdtDims<1>
EdtDims<2> )
See Also
N/A