PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Adding a row into an array
  • Adding a row into an advanced array property
  • Various
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Adds a row at the end:
  • of a one- or two-dimensional WLanguage array.
  • of a two-dimensional array property of a variable type (xlsDocument variable for example).
Note: This function is identical to ArrayAddLine.
Versions 17 and later
PHP This function is now available for the PHP sites.
New in version 17
PHP This function is now available for the PHP sites.
PHP This function is now available for the PHP sites.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Universal Windows 10 App This function is now available in Windows Store apps mode.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 21 and later
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
WEBDEV - Browser code This function is now available in browser code.
New in version 21
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
WEBDEV - Browser code This function is now available in browser code.
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
WEBDEV - Browser code This function is now available in browser code.
Versions 22 and later
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
Java This function is now available for the Java applications.
New in version 22
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
Java This function is now available for the Java applications.
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
Java This function is now available for the Java applications.
Example
MyArray is array of 2 by 3 strings
AddLine(MyArray, "AT", "B", "C")
AddLine(MyArray, "a", "b", "c")
AddLine(MyArray, "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"
AddLine(MyArray, "D", "E", "F")
// Display the content of the 3rd row
Trace(MyArray[3,1], MyArray[3,2], MyArray[3,3])
// Displays "D E F"
Syntax
<Result> = AddLine(<Array Name> [, <Element Column 1> [... [, <Element Column N>]]])
<Result>: Integer
  • Subscript of added row,
  • -1 if an error occurred.
<Array Name>: Array
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 the 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 the 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 an array

When using AddLine:
  • 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 (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 using AddLine:
  • the advanced variable must be allocated.
  • the advanced type must have an enumerator of modifiable collection type.
  • the advanced type is automatically enlarged to receive the new row.

Various

  • This function cannot be used on:
    • the non-allocated arrays,
    • the fixed arrays.
  • To add a row at a given position, use ArrayInsertLine or Insert.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230vm.dll
Windows Mobile wp230vm.dll
WEBDEV - Browser code WDJS.DLL
Java wd230java.jar
Linux wd230vm.so
Android wd230android.jar
Minimum required version
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment