====== 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 ====
 
<code>
Array = Exec_Method( "SYSTEM",      
                     "LIST2ARRAY",  
                     List,          
                     RowSize,       
                     ColSize,       
                     PrimaryDelim,  
                     SecondaryDelim )
</code>
 
 
 
==== 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 ====
 
<code>
 
// 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> )
 
 
</code>