PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Inserting a row
  • Inserting 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
Inserts a row at a given position:
  • into a two-dimensional WLanguage array.
  • into an advanced two-dimensional array property (xlsDocument, etc.).
Note: This function is equivalent to ArrayInsertLine.
Versions 16 and later
PHP This function is now available for PHP sites.
New in version 16
PHP This function is now available for PHP sites.
PHP This function is now available for 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 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 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 iPhone/iPad applications.
Versions 21 and later
Apple Watch This function is now available in Apple Watch mode.
WEBDEV - Browser code This function is now available in browser code.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Apple Watch This function is now available in Apple Watch mode.
WEBDEV - Browser code This function is now available in browser code.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Apple Watch This function is now available in Apple Watch mode.
WEBDEV - Browser code This function is now available in browser code.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Versions 22 and later
Android Widget This function is now available in Android Widget mode.
Android This function is now available for 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 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 Android applications.
Java This function is now available for the Java applications.
Example
MyArray is array of 2 by 3 strings
InsertLine(MyArray, 1, "AT", "B", "C")
InsertLine(MyArray, 2, "a", "b", "c")
InsertLine(MyArray, 3, "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
InsertLine(<WLanguage array> , <Insertion subscript> [, <Element column 1> [... [, <Element column N>]]])
<WLanguage array>: Array
Name of Array variable to use. This array must be a two-dimensional array.
<Insertion subscript>: Integer
Subscript where the row must be inserted. From this subscript, all the rows will be moved by 1 row.
If <Insertion subscript> is equal to the number of rows in the array +1, the row is added at the end of the array (equivalent to ArrayAddLine).
A WLanguage error occurs if <Insertion subscript> is greater than the number of rows in the array +1.
<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

Inserting a row

When using InsertLine:
  • the array is automatically enlarged to receive the new row.
  • the elements are converted (if necessary) into the type of the other array elements.
When declaring an array of N by M elements, this array contains N empty rows. For example, the array declared below contains 3 empty strings.
Remark: 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 inserting a row (InsertLine), this row is automatically inserted among the rows already found in the array.
In our example, the array will contain 4 rows once the insertion is performed.

Inserting a row into an advanced array property

When InsertLine 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.

Various

  • This function cannot be used on:
    • non-created arrays
    • the fixed arrays.
  • To add a row at the end of a two-dimensional array, use ArrayAddLine or AddLine.
Component : wd250vm.dll
Minimum version required
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment