The method used to compare items when sorting. If you specify this property, Flex ignores any compareFunction properties that you specify in the SortField objects that you use in this class.

The compare function must have the following signature:

     
         function [name](a:Object, b:Object, fields:Array = null):int
     
      

This function must return the following

• -1, if a should appear before b in the sorted sequence
• 0, if a equals b
• 1, if a should appear after b in the sorted sequence

To return to the internal comparision function set this value to null.

The fields array specified specifies the object fields to compare. Typically the algorithm will compare properties until the field list is exhausted or a non zero value can be returned. For example:

        function myCompare(a:Object, b:Object, fields:Array = null):int
        {
            var result:int = 0;
            var i:int = 0;
            var propList:Array = fields ? fields : internalPropList;
            var len:int = propList.length;
            var propName:String;
            while (result == 0 && (i < len))
            {
                propName = propList[i];
                result = compareValues(a[propName], b[propName]);
                i++;
            }
            return result;
        }
     
        function compareValues(a:Object, b:Object):int
        {
            if (a == null && b == null)
                return 0;
     
            if (a == null)
              return 1;
     
            if (b == null)
               return -1;
     
            if (a < b)
                return -1;
     
            if (a > b)
                return 1;
     
            return 0;
        }
      

The default value is an internal compare function that can perform a string, numeric, or date comparison in ascending or descending order, with case-sensitive or case-insensitive string comparisons. Specify your own function only if you need a need a custom comparison algorithm. This is normally only the case if a calculated field is used in a display.

Alternatively you can specify separate compare functions for each sort field by using the SortField class compare property; This way you can use the default comparison for some fields and a custom comparison for others.

An Array of SortField objects that specifies the fields to compare. The order of the SortField objects in the array determines field priority order when sorting. The default sort comparator checks the sort fields in array order until it determinines a sort order for the two fields being compared.

The default value is null.

This property can be used as the source for data binding. When this property is modified, it dispatches the fieldsChanged event.

See also

Indicates if the sort should be unique. Unique sorts fail if any value or combined value specified by the fields listed in the fields property result in an indeterminate or non-unique sort order; that is, if two or more items have identical sort field values.

The default value is false.

Constructor.

Creates a new Sort with no fields set and no custom comparator.

Finds the specified object within the specified array (or the insertion point if asked for), returning the index if found or -1 if not. The ListCollectionView class findxxx() methods use this method to find the requested item; as a general rule, it is easier to use these functions, and not findItem() to find data in ListCollectionView-based objects. You call the findItem() method directly when writing a class that supports sorting, such as a new ICollectionView implementation.

Parameters

Return whether the specified property is used to control the sort. The function cannot determine a definitive answer if the sort uses a custom comparitor; it always returns true in this case.

Parameters

Goes through all SortFields and calls reverse() on them. If the field was descending now it is ascending, and vice versa.

Note: an ICollectionView does not automatically update when the SortFields are modified; call its refresh() method to update the view.

Apply the current sort to the specified array (not a copy). To prevent the array from being modified, create a copy use the copy in the items parameter.

Flex ICollectionView implementations call the sort method automatically and ensure that the sort is performed on a copy of the underlying data.

Parameters

When executing a find return the index any matching item.

When executing a find return the index for the first matching item.

When executing a find return the index for the last matching item.