ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Queue, stack, list and array functions / Array functions
  • Inserting an element into an array
  • Inserting an element into an advanced array property
  • Inserting an element into a list
  • Inserting an array
  • Inserting a list
  • Use conditions
  • Miscellaneous
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Inserts an element at a given position:
  • into a one-dimensional WLanguage array.
  • into an associative array.
  • into an advanced array property (array of gglCalendar events, etc.).
  • into a WLanguage list.
This function can also be used to concatenate two arrays or two lists.
Remarks:
  • This function is equivalent to ArrayInsert.
  • WEBDEV - Browser codePHP This function can only be used with Array and Associative array variables.
Example
MyArray is array of 2 strings
Insert(MyArray, 1, "WINDEV")
Insert(MyArray, 2, "WEBDEV")
Insert(MyArray, 3, "WINDEV and WEBDEV")
// Display the content of 3rd element
Trace(MyArray[3]) // Displays "WINDEV and WEBDEV"
MyArray is array of 2 strings
MyArray[1] = "WINDEV"
MyArray[2] = "WEBDEV"
Insert(MyArray, 3, "WINDEV and WEBDEV")
// Display the content of 3rd element
Trace(MyArray[3]) // Displays "WINDEV and WEBDEV"
// Associative array Last Name - First Name
aaLastNameFirstName is associative array of strings
Insert(aaLastNameFirstName, "Smith", "Tommy")
Insert(aaLastNameFirstName, "Montgomery", "Julia")
Syntax

Inserting an element into an array or into an advanced array property Hide the details

Insert(<WLanguage array> , <Insertion index> [, <Element value>])
<WLanguage array>: Array
Name of the Array variable to use. This array must be a one-dimensional array.
<Insertion index>: Integer
Index where the element will be inserted into the array. From this index, all elements will be moved by 1 element.
If <Insertion index> is equal to the number of elements in the array +1, the element is added at the last position in the array (equivalent to ArrayAdd or Add).
A WLanguage error occurs if <Insertion index> is greater than the number of elements in the array +1.
<Element value>: Any type, optional
Element that will be inserted into the array at the specified position. If this parameter is not specified, the array is enlarged with the default value of the type of the other array elements.

Inserting an element into an associative array Hide the details

Insert(<WLanguage array> , <Element key> , <Element value>)
<WLanguage array>: Array
Name of the Array variable to use. This array must be a one-dimensional array.
<Element key>: Type of key in the associative array
Value of key for which the element will be inserted. In an associative array without duplicate, a WLanguage error occurs if the element already exists.
<Element value>: Any type
Element that will be inserted into the specified array.

Inserting an array into an array Hide the details

Insert(<WLanguage array> , <Insertion index> [, <WLanguage array to insert>])
<WLanguage array>: Array
Name of the Array variable to use. This array must be a one-dimensional array.
<Insertion index>: Integer
Index where the element will be inserted into the array. From this index, all elements will be moved by 1 element.
If <Insertion index> is equal to the number of elements in the array +1, the element is added at the end of the array (equivalent to ArrayAdd).
A WLanguage error occurs if <Insertion index> is greater than the number of elements in the array +1.
<WLanguage array to insert>: Optional array
Array that will be inserted into <Array name>. This element will be inserted at the specified insertion index.
WEBDEV - Browser codePHP Not available in browser code and in PHP

Inserting an element into a list Hide the details

Insert(<WLanguage list> , <Insertion index> , <Element value>)
<WLanguage list>: List
Name of List variable to use.
<Insertion index>: Integer constant
Index where the element will be inserted into the list. The following constants can be used:
AfterCurrentElementThe element is inserted after the current element.
This constant is only available to iterate over the elements of the list.
Caution: The element will be read in the next iteration in an ascending loop.
BeforeCurrentElementThe element is inserted before the current element.
This constant is only available to iterate over the elements of the list.
Caution: The element will be read in the next iteration in a descending loop.
FirstElementThe element is inserted at the beginning of list.
LastElementThe element is inserted at the end of list.
<Element value>: Any type
Element that will be inserted into the list at the specified position.
WEBDEV - Browser codePHP Not available in browser code and in PHP

Inserting a list into a list Hide the details

Insert(<WLanguage list> , <Insertion index> , <WLanguage list to insert>)
<WLanguage list>: List
Name of List variable to use.
<Insertion index>: Integer constant
Index where the list will be inserted into the list. The following constants can be used:
AfterCurrentElementThe list is inserted after the current element.
This constant is only available to iterate over the elements of the list.
BeforeCurrentElementThe list is inserted before the current element.
This constant is only available to iterate over the elements of the list.
FirstElementThe list is inserted at the beginning of <WLanguage list>.
LastElementThe list is inserted at the end of <WLanguage list>.
<WLanguage list to insert>: List
List that will be inserted at the specified insertion index.
Remarks

Inserting an element into an array

When Insert is called:
  • the array is automatically enlarged to receive the new element.
  • the element is converted (if necessary) into the type of the other array elements.
When declaring an array of N elements, this array contains N empty elements. For example, the array declared below contains 3 empty strings.
MyArray is array of 3 strings
Elements inserted using Insert are automatically inserted among the existing elements in the array.
In our example, the array will contain 4 elements once the insertion is performed.

Inserting an element into an advanced array property

When Insert 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 elements.
  • the element is initialized with the value passed as parameter. If no value is passed in parameter, the element is initialized with the default value of the type of the array elements.

Inserting an element into a list

When Insert is called:
  • the list is automatically enlarged to receive the new element.
  • the element is converted (if necessary) into the type of the other list elements.
WEBDEV - Browser codePHP This feature is not available.

Inserting an array

When Insert is called:
  • the array is automatically resized to include the new elements. The elements of <WLanguage array to insert> are added at the position specified in <Array name>.
  • the two arrays must have the same type.
  • the arrays must have the same dimension.
  • the values of array dimensions (except for the first one) must be identical.

Inserting a list

When Insert is called:
  • the list is automatically enlarged to receive the new elements. The elements of <WLanguage list to insert> are added at the specified position.
  • both lists must be of the same type.
WEBDEV - Browser codePHP This feature is not available.

Use conditions

This function can be used with the structures. In this case, you must:
  1. Declare a variable (same type as the structure).
  2. Initialize each member.
  3. Pass the structure variable as parameter to Insert.
This function cannot be used on:
  • non-created arrays,
  • fixed arrays.

Miscellaneous

  • To add an element at the end of a one-dimensional array, use ArrayAdd or Add.
  • To add an element into a sorted array (while respecting the sort), use ArrayAddSorted.
Component: wd290vm.dll
Minimum version required
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help