ArrayAddSorted (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | French

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

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 at which the specified element was added,
-1 if the element could not be placed.
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 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.

Miscellaneous

This function cannot be used on:

non-created arrays,
fixed arrays.

Component : wd250vm.dll