Sorts a one dimensional dynamic array.
Syntax
NewArray = SRP_Array("SortSimpleList", Array, Option, Delim)
Returns
The sorted array.
Parameters
| Parameter | Description |
|---|---|
| Array | The one dimensional dynamic array to be sorted. (REQUIRED) |
| Option | A keyword indiciating how the array is to be sorted. (OPTIONAL) |
| Delim | The delimiter that separates elements of the Array. (OPTIONAL) |
Remarks
While the SortRows provides everything needed to sort both one and two dimensional arrays, this service simplifies the process greatly of sorting single dimensional arrays. Have a small simple list to sort? This is the service for you. Simply pass in the array and choose one of four sorting options: "AscendingText", "DescendingText", "AscendingNumbers", or "DescendingNumbers".
- "AscendingText" performs a left sort in alphabetical order.
- "DescendingText" performs a left sort in reverse alphabetical order.
- "AscendingNumbers" performs a sort in numerical order.
- "DescendingNumbers" performs a sort in reverse numerical order.
The Delim parameter tells the service what delimiter is used to delimit elements in the given array. When omitted, @FM is assumed.
Examples
// Sort a simple list using custom delimiters
List = "Don":@FM:"Paul":@FM:"Frank":@FM:"Bob":@FM:"Kevin"
List = SRP_Array("SortSimpleList", List)
// List will be: "Bob":@FM:"Don":@FM:"Frank":@FM:"Kevin":@FM:"Paul"
// Sort a simple list in reverse order
List = "Don":@FM:"Paul":@FM:"Frank":@FM:"Bob":@FM:"Kevin"
List = SRP_Array("SortSimpleList", List, "DescendingText")
// List will be: "Paul":@FM:"Kevin":@FM:"Frank":@FM:"Don":@FM:"Bob"
// Sort a simple list using custom delimiters
List = "81,90,44,66,52"
List = SRP_Array("SortSimpleList", List, "AscendingNumbers", ",")
// List will be: "44,52,66,81,90"
