ArrayAddSorted (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Adding an element
Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ArrayAddSorted (Function)

In french: TableauAjouteTrié

Adds an element to a one-dimensional WLanguage array taking into account the sort criterion defined by ArraySort.

Remark: This function can only be used on the WLanguage arrays.

Versions 18 and later

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.

Example

MyArray is array of 2 strings
MyArray[1] = "WINDEV"
MyArray[2] = "WEBDEV"
ArraySort(MyArray, asAscending)
ArrayAddSorted(MyArray, "WEBDEV and WINDEV")
// Display the content of elements
Trace(MyArray[1]) // Displays "WEBDEV"
Trace(MyArray[2]) // Displays "WEBDEV and WINDEV"
Trace(MyArray[3]) // Displays "WINDEV"

Syntax

<Result> = ArrayAddSorted(<WLanguage array> , <Element value>)

<Result>: Integer

Subscript where the specified element was added, -1 if the element was not added.
A WLanguage error occurs if:
no sort criterion was defined (ArraySort).
the sort criterion was not respected by the array before the addition.

<WLanguage array>: Array

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

<Element value>: Type of array elements

Element that must be added to the specified array.

Remarks

Adding an element

When using ArrayAddSorted:

the array is automatically enlarged to receive the new element.
the element is converted (if necessary) into the type of the other array elements.
the element is placed in the array according to the sort.

Miscellaneous

This function cannot be used on:

non-created arrays,
fixed arrays.

Component : wd250vm.dll