This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

New in version 18

This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

Versions 21 and later

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

This function is now available in browser code.

New in version 21

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

This function is now available in browser code.

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

This function is now available in browser code.

Versions 22 and later

This function is now available in Android Widget mode.

This function is now available for Android applications.

This function is now available for Java applications.

New in version 22

This function is now available in Android Widget mode.

This function is now available for Android applications.

This function is now available for Java applications.

This function is now available in Android Widget mode.

This function is now available for Android applications.

This function is now available for Java applications.

Example

MyArray is array of 2 by 3 strings MyArray.AddLine("A", "B", "C") MyArray.AddLine("a", "b", "c") MyArray.AddLine("D", "E", "F") // Display the content of the 3rd row (the two first rows are empty) Trace(MyArray[3,1], MyArray[3,2], MyArray[3,3]) // Displays "A B C"

MyArray is array of 2 by 3 strings MyArray[1,1] = "A" MyArray[1,2] = "B" MyArray[1,3] = "C" MyArray[2,1] = "a" MyArray[2,2] = "b" MyArray[2,3] = "c" MyArray.AddLine("D", "E", "F") // Display the content of the 3rd row Trace(MyArray[3,1], MyArray[3,2], MyArray[3,3]) // Displays "D E F"

Name of Array variable to use. This array must be a one-dimensional array or a two-dimensional array.

<Element column 1>: Type of array elements, optional

Element of the row that will be added into the specified array. Each element corresponds to a column in the array. The type of the added element must be compatible with the type of relevant column. If none of these parameters is specified, an empty row is added to the array. The columns are initialized with the default value of the type of the other array elements. If one of these parameters is not specified, the corresponding column is initialized with the default value of the type of the other array elements.

<Element column N>: Type of array elements, optional

Element of the row that will be added into the specified array. Each element corresponds to a column in the array. The type of the added element must be compatible with the type of relevant column. If none of these parameters is specified, an empty row is added to the array. The columns are initialized with the default value of the type of the other array elements. If one of these parameters is not specified, the corresponding column is initialized with the default value of the type of the other array elements.

Remarks

Adding a row into a WLanguage array

When <Array variable>.AddLine is called:

the number of rows in the array is automatically increased to include the new row.

the number of columns in the array is not increased. You must:

declare the array with the proper number of columns (second dimension of the array).

dynamically modify the number of columns with Dimension.

the elements are converted (if necessary) into the type of the other array elements.

Note: When declaring an array of N by M elements, this array contains N empty rows. For example, the array declared below contains 3 empty rows.

MyArray is array of 3 by 2 strings

When adding a row (<Array variable>.AddLine), this row is automatically added after the rows already found in the array.

In our example, the added row corresponds to the 4th row.

Adding a row into an advanced array property

When <Array variable>.AddLine is called:

the advanced variable must be created.

the advanced type must have an enumerator of modifiable collection type.

the advanced type is automatically enlarged to receive the new row.