ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Queue, stack, list and array functions / Array functions
  • Adding an element
  • 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
Adds an element to a one-dimensional WLanguage array taking into account:
  • the sort criteria defined by <Array>.Sort
  • the comparison operator described in the class, if the elements of the array are class instances.
Remark: This function can only be used on WLanguage arrays.
Example
MyArray is array of 2 strings
MyArray[1] = "WINDEV"
MyArray[2] = "WEBDEV"
MyArray.Sort(asAscending)
MyArray.AddSorted("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> = <WLanguage array>.AddSorted(<Element value>)
<Result>: Integer
  • Index at which the specified element was added,
  • -1 if the element could not be added.
A WLanguage error occurs if:
  • no sort criteria have been defined (<Array>.Sort function or comparison operator in the class).
  • the array did not meet the sort criteria before the addition.
<WLanguage array>: Array
Name of the 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 <Array>.AddSorted 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.
  • the element is placed in the array according to the sort.

Miscellaneous

This function cannot be used on:
  • non-created arrays,
  • fixed arrays.
Component: wd290vm.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help