Instance Method インスタンスメソッド

sortedArray(_:context:)

Returns a new array that lists the receiving array’s elements in ascending order as defined by the comparison function comparator. ある配列を返します、それは、受け手側の配列の持つ要素を昇順で比較関数comparatorによって定義されるとおりに列記するものです。

Declaration 宣言 

func sortedArray(_ comparator: (Any, Any, UnsafeMutableRawPointer?) -> Int, 
         context: UnsafeMutableRawPointer?) -> [Any]

Discussion 議論

The new array contains references to the receiving array’s elements, not copies of them. それらのコピーではなく、受け手側の持つ要素に対する参照を含んでいる新しい配列。

The comparison function is used to compare two elements at a time and should return NSOrderedAscending if the first element is smaller than the second, NSOrderedDescending if the first element is larger than the second, and NSOrderedSame if the elements are equal. Each time the comparison function is called, it’s passed context as its third argument. This allows the comparison to be based on some outside parameter, such as whether character sorting is case-sensitive or case-insensitive. 比較関数は、２つの要素を一度に比較するために使われます、そして最初の要素が２番目よりも小さいならばNSOrderedAscendingを、最初の要素が２番目よりも大きいならばNSOrderedDescendingを、およびそれらの要素が同等ならばNSOrderedSameを返さなければなりません。比較関数が呼び出されるたびに、それはそれの３番目の引数としてcontextを渡されます。これは、比較がいくつかの外部パラメータに基づくことを可能にします、例えば文字列ソートが大文字小文字等（ケース）考慮であるかまたは大文字小文字等非考慮であるかなど。

Given anArray (an array of NSNumber objects) and a comparison function of this type: anArray（NSNumberオブジェクトの配列）と、この型の比較関数を与えられて： 


NSInteger intSort(id num1, id num2, void *context)
{
    int v1 = [num1 intValue];
    int v2 = [num2 intValue];
    if (v1 < v2)
        return NSOrderedAscending;
    else if (v1 > v2)
        return NSOrderedDescending;
    else
        return NSOrderedSame;
}

A sorted version of anArray is created in this way: anArrayのソートされたバージョンは、この方法で作成されます： 


NSArray *sortedArray; sortedArray = [anArray sortedArrayUsingFunction:intSort context:NULL];

See Also 参照

Sorting ソートする

var sortedArrayHint: Data
Analyzes the array and returns a “hint” that speeds the sorting of the array when the hint is supplied to sortedArray(_:context:hint:). 配列を分析して「ヒント」を返します、それは、そのヒントがsortedArray(_:context:hint:)に提供される場合この配列のソートをはかどらせるものです。
func sortedArray((Any, Any, UnsafeMutableRawPointer?) -> Int, context: UnsafeMutableRawPointer?, hint: Data?) -> [Any]
Returns a new array that lists the receiving array’s elements in ascending order as defined by the comparison function comparator. ある配列を返します、それは、受け手側の配列の持つ要素を昇順で比較関数comparatorによって定義されるとおりに列記するものです。
func sortedArray(using: [NSSortDescriptor]) -> [Any]
Returns a copy of the receiving array sorted as specified by a given array of sort descriptors. 与えられたソート記述子の配列によって指定された通りにソートされた受け手側の配列のコピーを返します。
func sortedArray(using: Selector) -> [Any]
Returns an array that lists the receiving array’s elements in ascending order, as determined by the comparison method specified by a given selector. ある配列を返します、それは受け手側の配列の持つ要素を昇順で列記します、与えられたセレクタによって指定される比較メソッドで決定されるとおりにです。
func sortedArray(comparator: (Any, Any) -> ComparisonResult) -> [Any]
Returns an array that lists the receiving array’s elements in ascending order, as determined by the comparison method specified by a given NSComparator block. 新しい配列を返します、それは、受け手側の配列の持つ要素を昇順で、与えられたNSComparatorブロックによって指定される比較メソッドで決定されるとおりに列記するものです。
func sortedArray(options: NSSortOptions, usingComparator: (Any, Any) -> ComparisonResult) -> [Any]
Returns an array that lists the receiving array’s elements in ascending order, as determined by the comparison method specified by a given NSComparator block. 新しい配列を返します、それは、受け手側の配列の持つ要素を昇順で、与えられたNSComparatorブロックによって指定される比較メソッドで決定されるとおりに列記するものです。
typealias Comparator
Defines the signature for a block object used for comparison operations. 比較演算に使われるブロックオブジェクトに対するシグネチャを定義します。