Siebel eScript Language Reference > Siebel eScript Commands > The Clib Object Uncategorized Methods >

Clib.qsort() Method

This method sorts elements in an array.

Syntax

Clib.qsort(array, [elementCount, ]compareFunction)

Usage

This method sorts elements in an array, starting from index 0 to elementCount-1. If elementCount is not supplied, the method sorts the entire array. This method differs from the Array.sort() method in that it can sort dynamically created arrays, whereas Array.sort() works only with arrays explicitly created with a new Array statement.

Example

The following example prints a list of colors sorted in reverse alphabetical order, ignoring case:

// initialize an array of colors
var colors = { "yellow", "Blue", "GREEN", "purple", "RED",
"BLACK", "white", "orange" };
// sort the list using qsort and our ColorSorter routine
Clib.qsort(colors,"ReverseColorSorter");
// display the sorted colors
for ( var i = 0; i <= getArrayLength(colors); i++ )
   Clib.puts(colors[i]);

function ReverseColorSorter(color1, color2)
// do a simple case insensitive string
// comparison, and reverse the results too
{
   var CompareResult = Clib.stricmp(color1,color2)
   return( _CompareResult );
}

The output of the preceding code would be:

yellow
white
RED
purple
orange
GREEN
Blue
BLACK

See Also

Array sort() Method