Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы основы ссылка класса NSSortDescriptor

Опции
Развертывание Target:

На этой странице
Язык:

NSSortDescriptor

Экземпляр NSSortDescriptor описывает основание для упорядочивания объектов путем указания свойства для использования для сравнения объектов, метод для использования для сравнения свойств, и должно ли сравнение возрастать или убывать. Экземпляры NSSortDescriptor являются неизменными.

Вы создаете экземпляр NSSortDescriptor путем указания ключевого пути свойства, которое будет сравнено, порядок вида (возрастание или убывание), и (дополнительно) селектор для использования для выполнения сравнения. Конструктор с тремя параметрами позволяет Вам указывать другие селекторы сравнения такой как caseInsensitiveCompare: и localizedCompare:. Сортировка повышает исключение, если объекты, которые будут сортированы, не реагируют на селектор сравнения дескриптора вида.

Существует много ситуаций, в которых можно использовать дескрипторы вида, например:

  • Сортировать массив (экземпляр NSArray или NSMutableArray— посмотрите sortedArrayUsingDescriptors: и sortUsingDescriptors:)

  • Непосредственно сравнить два объекта (см. compareObject:toObject:)

  • Указать, как элементы в табличном представлении должны быть расположены (см. sortDescriptors)

  • Указать, как элементы, которыми управляет контроллер массива, должны быть расположены (см. sortDescriptors)

  • При использовании Базовых Данных чтобы указать, что упорядочивание объектов возвратилось из запроса выборки (см. sortDescriptors)

Наследование

Соответствует

Оператор импорта

Swift

import Foundation

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.3 и позже.

Инициализация дескриптора вида
  • sortDescriptorWithKey:ascending: + sortDescriptorWithKey:ascending:

    Создает и возвращается NSSortDescriptor с указанным ключом и упорядочиванием.

    Объявление

    Objective C

    + (instancetype)sortDescriptorWithKey:(NSString *)key ascending:(BOOL)ascending

    Параметры

    key

    Ключ свойства для использования при выполнении сравнения. В сравнении к свойству получают доступ с помощью кодирования значения ключа (см., что Значение ключа Кодирует Руководство по программированию).

    ascending

    YEStrue если получатель указывает сортировку в порядке возрастания, иначе NOfalse.

    Возвращаемое значение

    NSSortDescriptor инициализированный с указанным ключом и упорядочиванием.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.6 и позже.

    См. также

    – initWithKey:ascending:

  • init (key:ascending:) - initWithKey:ascending:

    Возвраты NSSortDescriptor объект, инициализированный с данным ключевым путем свойства и порядком сортировки, и с селектором сравнения по умолчанию.

    Объявление

    Swift

    init(key keyPath: String, ascending ascending: Bool)

    Objective C

    - (instancetype)initWithKey:(NSString *)keyPath ascending:(BOOL)ascending

    Параметры

    keyPath

    Ключ свойства для использования при выполнении сравнения. В сравнении к свойству получают доступ с помощью кодирования значения ключа (см., что Значение ключа Кодирует Руководство по программированию).

    ascending

    YEStrue если получатель указывает сортировку в порядке возрастания, иначе NOfalse.

    Возвращаемое значение

    NSSortDescriptor объект, инициализированный с ключевым путем свойства, указанным keyPath, порядок сортировки, указанный ascending, и селектор сравнения по умолчанию (compare:).

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.3 и позже.

    См. также

    – initWithKey:ascending:selector:

  • sortDescriptorWithKey:ascending:selector: + sortDescriptorWithKey:ascending:selector:

    Создает NSSortDescriptor с указанным упорядочиванием и селектором сравнения.

    Объявление

    Objective C

    + (instancetype)sortDescriptorWithKey:(NSString *)key ascending:(BOOL)ascending selector:(SEL)selector

    Параметры

    key

    Ключ свойства для использования при выполнении сравнения. В сравнении к свойству получают доступ с помощью кодирования значения ключа (см., что Значение ключа Кодирует Руководство по программированию).

    ascending

    YEStrue если получатель указывает сортировку в порядке возрастания, иначе NOfalse.

    selector

    Метод для использования при сравнении свойств объектов, например caseInsensitiveCompare: или localizedCompare:. Селектор должен указать метод, реализованный значением свойства, идентифицированного keyPath. Селектор, используемый для сравнения, передается единственный параметр, объект выдержать сравнение с self, и должен возвратить надлежащее NSComparisonResult постоянный. Селектор должен иметь ту же сигнатуру метода как:

    • - (NSComparisonResult)localizedCompare:(NSString *)aString

    Возвращаемое значение

    NSSortDescriptor объект, инициализированный с ключевым путем свойства, указанным keyPath, порядок сортировки, указанный ascending, и селектор, указанный selector.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.6 и позже.

    См. также

    – initWithKey:ascending:selector:

  • init (key:ascending:selector:) - initWithKey:ascending:selector:

    Возвраты NSSortDescriptor объект, инициализированный с данным ключевым путем свойства, порядком сортировки и селектором сравнения.

    Объявление

    Swift

    init(key keyPath: String, ascending ascending: Bool, selector selector: Selector)

    Objective C

    - (instancetype)initWithKey:(NSString *)keyPath ascending:(BOOL)ascending selector:(SEL)selector

    Параметры

    keyPath

    Ключ свойства для использования при выполнении сравнения. В сравнении к свойству получают доступ с помощью кодирования значения ключа (см., что Значение ключа Кодирует Руководство по программированию).

    ascending

    YEStrue если получатель указывает сортировку в порядке возрастания, иначе NOfalse.

    selector

    Метод для использования при сравнении свойств объектов, например caseInsensitiveCompare: или localizedCompare:. Селектор должен указать метод, реализованный значением свойства, идентифицированного keyPath. Селектор, используемый для сравнения, передается единственный параметр, объект выдержать сравнение с self, и должен возвратить надлежащее NSComparisonResult постоянный. Селектор должен иметь ту же сигнатуру метода как:

    • - (NSComparisonResult)localizedCompare:(NSString *)aString

    Возвращаемое значение

    NSSortDescriptor объект, инициализированный с ключевым путем свойства, указанным keyPath, порядок сортировки, указанный ascending, и селектор, указанный selector.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.3 и позже.

    См. также

    – initWithKey:ascending:

  • sortDescriptorWithKey:ascending:comparator: + sortDescriptorWithKey:ascending:comparator:

    Создает и возвращается NSSortDescriptor объект, инициализированный, чтобы сделать с данным упорядочиванием и блоком компаратора.

    Объявление

    Objective C

    + (instancetype)sortDescriptorWithKey:(NSString *)key ascending:(BOOL)ascending comparator:(NSComparator)cmptr

    Параметры

    key

    Ключ свойства для использования при выполнении сравнения. В сравнении к свойству получают доступ с помощью кодирования значения ключа (см., что Значение ключа Кодирует Руководство по программированию).

    ascending

    YEStrue если получатель указывает сортировку в порядке возрастания, иначе NOfalse.

    cmptr

    Блок компаратора.

    Возвращаемое значение

    NSSortDescriptor инициализированный с указанным ключом, упорядочиванием и компаратором.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.6 и позже.

    См. также

    – initWithKey:ascending:comparator:

  • init (key:ascending:comparator:) - initWithKey:ascending:comparator:

    Возвраты NSSortDescriptor объект, инициализированный, чтобы сделать с данным упорядочиванием и блоком компаратора.

    Объявление

    Swift

    init(key key: String, ascending ascending: Bool, comparator cmptr: NSComparator)

    Objective C

    - (instancetype)initWithKey:(NSString *)key ascending:(BOOL)ascending comparator:(NSComparator)cmptr

    Параметры

    key

    Ключ свойства для использования при выполнении сравнения. В сравнении к свойству получают доступ с помощью кодирования значения ключа (см., что Значение ключа Кодирует Руководство по программированию).

    ascending

    YEStrue если получатель указывает сортировку в порядке возрастания, иначе NOfalse.

    cmptr

    Блок компаратора.

    Возвращаемое значение

    NSSortDescriptor инициализированный с указанным ключом, упорядочиванием и компаратором.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

    См. также

    + sortDescriptorWithKey:ascending:comparator:

Получение информации о дескрипторе вида
  • возрастание возрастание Свойство

    Булево значение, указывающее, указывает ли получатель сортировку в порядке возрастания. (только для чтения)

    Объявление

    Swift

    var ascending: Bool { get }

    Objective C

    @property(readonly) BOOL ascending

    Обсуждение

    YEStrue если получатель указывает сортировку в порядке возрастания, иначе NOfalse.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.3 и позже.

  • ключ ключ Свойство

    Ключевой путь свойства получателя. (только для чтения)

    Объявление

    Swift

    var key: String? { get }

    Objective C

    @property(readonly, copy) NSString *key

    Обсуждение

    Этот ключевой путь указывает свойство, сравненное во время сортировки.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.3 и позже.

  • селектор селектор Свойство

    Селектор получатель указывает для использования при сравнении объектов.

    Объявление

    Swift

    var selector: Selector { get }

    Objective C

    @property(readonly) SEL selector

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.3 и позже.

Используя дескрипторы вида
  • compareObject (_: toObject:) - compareObject:toObject:

    Возвраты NSComparisonResult значение, указывающее упорядочивание двух данных объектов.

    Объявление

    Swift

    func compareObject(_ object1: AnyObject, toObject object2: AnyObject) -> NSComparisonResult

    Objective C

    - (NSComparisonResult)compareObject:(id)object1 toObject:(id)object2

    Параметры

    object1

    Объект соответствовать object2. Этот объект должен иметь свойство доступное использование ключевого пути, указанного ключом.

    Это значение не должно быть nil. Если значение nil, поведение не определено и может измениться в будущих версиях OS X.

    object2

    Объект соответствовать object1. Этот объект должен иметь свойство доступное использование ключевого пути, указанного ключом.

    Это значение не должно быть nil. Если значение nil, поведение не определено и может измениться в будущих версиях OS X.

    Возвращаемое значение

    NSOrderedAscending если object1 меньше, чем object2, NSOrderedDescending если object1 больше, чем object2, или NSOrderedSame если object1 равно object2.

    Обсуждение

    Упорядочивание определяется путем сравнения, использование селектора указало селектор, значения свойств, указанных ключом object1 и object2.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.3 и позже.

  • reversedSortDescriptor reversedSortDescriptor Свойство

    Дескриптор вида с инвертированным порядком сортировки. (только для чтения)

    Объявление

    Swift

    var reversedSortDescriptor: AnyObject! { get }

    Objective C

    @property(readonly, retain) id reversedSortDescriptor

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.3 и позже.

  • allowEvaluation () - allowEvaluation

    Вызовите дескриптор вида, надежно декодировавшийся для разрешения оценки.

    Объявление

    Swift

    func allowEvaluation()

    Objective C

    - (void)allowEvaluation

    Обсуждение

    При безопасном декодировании NSSortDescriptor объект закодировал использование NSSecureCoding, оценка отключена, потому что потенциально небезопасно оценить дескрипторы, Вы выходите из архива.

    Перед включением оценки необходимо проверить ключевые пути, селекторы, и т.д. чтобы гарантировать, что не будет выполняться никакой ошибочный или вредоносный код. Как только у Вас есть preflighted дескриптор вида, можно включить получатель для оценки путем вызова allowEvaluation.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

Создайте NSComparator для дескриптора вида.
  • компаратор компаратор Свойство

    NSComparator для дескриптора вида. (только для чтения)

    Объявление

    Swift

    var comparator: NSComparator? { get }

    Objective C

    @property(readonly) NSComparator comparator

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.