ArrayAddSorted (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Queue, stack, list and array management functions

Constants for managing the arrays

Functions for managing arrays

This content has been translated automatically. Click here to view the French version.

Adding an element
Various

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ArrayAddSorted (Function)

In french: TableauAjouteTrié

Adds an element in an array WLanguage to a dimension taking into account:

the sort criterion defined by function ArraySort
the comparison operator described in the class if the array elements are class instances.

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 at which the specified element was added,
-1 if the element could not be placed.
A WLanguage error occurs if:
No sort criteria have been defined (ArraySort function or comparison operator in the class).
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 the function 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.

Various

This function cannot be used on:

non-created arrays,
les arrays fixes.

Business / UI classification : Neutral code

Component : wd260vm.dll