LIST2ARRAY method (System)
Description
Utility method to convert data stored in an EDITTABLE LIST property structure (Row/Column) to an EDITTABLE ARRAY property structure (Column)/Row.
Syntax
Array = Exec_Method( "SYSTEM",
"LIST2ARRAY",
List,
RowSize,
ColSize,
PrimaryDelim,
SecondaryDelim )
Parameters
| Name | Required | Description |
|---|---|---|
| List | Yes | Data to convert. This should be in the same format as the data used with the EDITTABLE LIST property, i.e. rows are delimited by @Fm, and columns are delimited by @Vm within each row. |
| RowSize | No | Number of rows to convert. If not specified the system determines the number of rows itself. Defaults to 0. |
| ColSize | No | Number of columns to convert. If not specified the system determines the number of columns itself. Defaults to 0. |
| PrimaryDelim | No | Delimiter to use when parsing the List for rows, and when delimiting columns in the returned Array. Defaults to @Fm. |
| SecondaryDelim | No | Delimiter to use when parsing the List for columns, and when delimiting rows in the returned Array. Defaults to @Vm. |
Returns
Converted data structured as per the EDITTABLE ARRAY property, i.e. columns are delimited by the PrimaryDelim (@fm) and rows are delimited by SecondaryDelim (@vm) in each column.
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.
See Also
N/A
Example
// Get the contents of an EDITTABLE control in LIST format and convert
// it to the ARRAY format (Yes, you could just get the ARRAY property
// but this is for demo purposes).
ObjxArray = @Window : ".EDT_MYDATA"
PropArray = "LIST"
ObjxArray := @Rm : @Window : ".EDT_MYDATA"
PropArray := @Rm : "LIMIT"
DataArray = Get_Property( ObjxArray, PropArray )
EdtList = DataArray[1,@Rm]
EdtDims = DataArray[Col2()+1,@Rm]
// Convert the format
EdtArray = Exec_Method( "SYSTEM", "LIST2ARRAY",
EdtList,
EdtDims<2>
EdtDims<1> )