A community member pointed out recently that the ActionScript Language Reference description for `Vector.sort()`

is incomplete. The reference will be updated soon. In the meantime, here’s the corrected description, which now includes sorting according to a “sort option” as well as sorting by using a compare function.

**Vector sort() method:**

Sorts the elements in the Vector object, and also returns a sorted Vector object. This method sorts according to the parameter `sortBehavior`

, which is either a function that compares two values, or a set of sorting options.

The method takes one parameter. The parameter is one of the following:

- a function that takes two arguments of the base type (T) of the Vector and returns a Number:

`function compare(x:T, y:T):Number {}`

The logic of the function is that, given two elements x and y, the function returns one of the following three values:

- a negative number, if x should appear before y in the sorted sequence

- 0, if x equals y

- a positive number, if x should appear after y in the sorted sequence

- a number which is a bitwise OR of the following values:

- 1 or
`Array.CASEINSENSITIVE`

- 2 or
`Array.DESCENDING`

- 4 or
`Array.UNIQUESORT`

- 8 or
`Array.RETURNINDEXEDARRAY`

- 16 or
`Array.NUMERIC`

If the value is 0, the sort works in the following way:

- Sorting is case-sensitive (Z precedes a).

- Sorting is ascending (a precedes b).

- The array is modified to reflect the sort order; multiple elements that have identical sort fields are placed consecutively in the sorted array in no particular order.

- All elements, regardless of data type, are sorted as if they were strings, so 100 precedes 99, because “1” is a lower string value than “9”.

**Parameters**

`sortBehavior:*`

— A Function or a Number value that determines the behavior of the sort. A Function parameter specifies a comparison method. A Number value specifies the sorting options.

**Returns**

Vector — A Vector object, with elements in the new order.

Hi Jackie,

Has the sort option recently been added?

When the Vector class was first added to ActionScript, one of the key differences between Vector and Array was that Vector did not support the sortBehavior mechanism. (That’s why I left it out of the Vector docs when I wrote them =)

Just something to check — I’m not sure if the commenter actually tested whether it worked or just assumed it’s the same as Array when it isn’t necessarily.