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

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

Разработчик

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

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

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

NSSet

NSSet, NSMutableSet, и NSCountedSet классы объявляют программируемый интерфейс к неупорядоченному набору объектов.

NSSet объявляет программируемый интерфейс для статических наборов отдельных объектов. Вы устанавливаете записи статического набора, когда это создается, и после того записи не могут быть изменены. NSMutableSet, с другой стороны, объявляет программируемый интерфейс для динамических наборов отдельных объектов. Динамическое — или непостоянный — набор позволяет дополнение и удаление записей в любое время, автоматически выделяя память по мере необходимости.

Можно использовать наборы в качестве альтернативы массивам, когда порядок элементов не важен и производительность в тестировании, содержится ли объект в наборе, рассмотрение — в то время как массивы упорядочиваются, тестирование на членство медленнее, чем с наборами.

NSSet “бесплатный соединенный мостом” с его Базовым дубликатом Основы, CFSetRef. Посмотрите Бесплатное Образование моста для получения дополнительной информации о бесплатном образовании моста.

Разделение на подклассы примечаний

Должно быть мало потребности разделения на подклассы. Если необходимо настроить поведение, часто лучше рассмотреть состав вместо разделения на подклассы.

Методы для переопределения

В подклассе необходимо переопределить все его примитивные методы:

Альтернативы разделению на подклассы

Прежде, чем сделать пользовательский класс NSSet, заняться расследованиями NSHashTable и соответствующий Базовый тип Основы, Ссылка CFSet. Поскольку NSSet и CFSet “бесплатный соединенный мостом”, можно заменить a CFSet объект для a NSSet возразите в своем коде (с надлежащим кастингом). Несмотря на то, что они - соответствующие типы, CFSet и NSSet не имейте идентичных интерфейсов или реализаций, и можно иногда делать вещи с CFSet то, что Вы не можете легко сделать с NSSet.

Если поведение Вы могли бы записать категорию на, Вы хотите добавить дополнения тот из существующего класса NSSet. Следует иметь в виду, однако, что эта категория будет иметь силу для всех экземпляров NSSet то, что Вы используете, и это могло бы иметь непреднамеренные последствия. Также Вы могли использовать состав для достижения желаемого поведения.

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Создание набора
  • набор + набор

    Создает и возвращает пустое множество.

    Объявление

    Objective C

    + (instancetype)set

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

    Новое пустое множество.

    Обсуждение

    Этот метод объявляется прежде всего для использования непостоянных подклассов NSSet.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    + setWithArray:
    + setWithObject:
    + setWithObjects:
    – setByAddingObject:
    – setByAddingObjectsFromSet:
    – setByAddingObjectsFromArray:

  • setWithArray: + setWithArray:

    Создает и возвращает набор, содержащий uniqued набор объектов, содержавшихся в данном массиве.

    Объявление

    Objective C

    + (instancetype)setWithArray:(NSArray *)array

    Параметры

    array

    Массив, содержащий объекты добавить к новому набору. Если тот же объект появляется несколько раз в array, это добавляется только один раз к возвращенному набору. Каждый объект получает a retain обменивайтесь сообщениями, как это добавляется к набору.

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

    Новый набор, содержащий uniqued набор объектов, содержавшихся в array.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    + набор
    + setWithObject:
    + setWithObjects:
    – setByAddingObject:
    – setByAddingObjectsFromSet:
    – setByAddingObjectsFromArray:

  • init (объект:) + setWithObject:

    Создает и возвращает набор, содержащий единственный данный объект.

    Объявление

    Swift

    convenience init(object object: AnyObject)

    Objective C

    + (instancetype)setWithObject:(id)object

    Параметры

    object

    Объект добавить к новому набору. object получает a retain сообщение, будучи добавленным к набору.

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

    Новый набор, содержащий единственный элемент, object.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + набор
    + setWithArray:
    + setWithObjects:
    – setByAddingObject:
    – setByAddingObjectsFromSet:
    – setByAddingObjectsFromArray:

  • setWithObjects: + setWithObjects:

    Создает и возвращает набор, содержащий объекты в данном списке аргументов.

    Объявление

    Objective C

    + (instancetype)setWithObjects:(id)firstObj, firstObj, ...

    Параметры

    firstObj

    Первый объект добавить к новому набору.

    firstObj, ...

    Список разделенных запятой значений объектов, заканчивающихся nil, добавить к новому набору. Если тот же объект появляется несколько раз в списке объектов, это добавляется только один раз к возвращенному набору. Каждый объект получает a retain обменивайтесь сообщениями, как это добавляется к набору.

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

    Новый набор, содержащий объекты в списке аргументов.

    Обсуждение

    Как пример, следующая выборка кода создает набор, содержащий три различных типов элементов (принятие aPath выходы):

    • NSSet *mySet;
    • NSData *someData = [NSData dataWithContentsOfFile:aPath];
    • NSValue *aValue = [NSNumber numberWithInteger:5];
    • NSString *aString = @"a string";
    • mySet = [NSSet setWithObjects:someData, aValue, aString, nil];

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    + набор
    + setWithArray:
    + setWithObject:
    – setByAddingObject:
    – setByAddingObjectsFromSet:
    – setByAddingObjectsFromArray:

  • setWithObjects:count: + setWithObjects:count:

    Создает и возвращает набор, содержащий конкретное количество объектов от данного массива C объектов.

    Объявление

    Objective C

    + (instancetype)setWithObjects:(const id [])objects count:(NSUInteger)cnt

    Параметры

    objects

    Массив C объектов добавить к новому набору. Если тот же объект появляется несколько раз в objects, это добавляется только один раз к возвращенному набору. Каждый объект получает a retain обменивайтесь сообщениями, как это добавляется к набору.

    cnt

    Число объектов от objects добавить к новому набору.

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

    Новый набор, содержащий cnt объекты из списка объектов, указанных objects.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    + набор
    + setWithArray:
    + setWithObject:
    + setWithObjects:
    – setByAddingObject:
    – setByAddingObjectsFromSet:
    – setByAddingObjectsFromArray:

  • setWithSet: + setWithSet:

    Создает и возвращает набор, содержащий объекты от другого набора.

    Объявление

    Objective C

    + (instancetype)setWithSet:(NSSet *)set

    Параметры

    set

    Набор, содержащий объекты добавить к новому набору. Каждый объект получает a retain обменивайтесь сообщениями, как это добавляется к новому набору.

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

    Новый набор, содержащий объекты от set.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    + набор
    + setWithArray:
    + setWithObject:
    + setWithObjects:
    – setByAddingObject:
    – setByAddingObjectsFromSet:
    – setByAddingObjectsFromArray:

  • setByAddingObject (_:) - setByAddingObject:

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

    Объявление

    Swift

    func setByAddingObject(_ anObject: AnyObject) -> NSSet

    Objective C

    - (NSSet *)setByAddingObject:(id)anObject

    Параметры

    anObject

    Объект добавить к набору.

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

    Новый набор, сформированный путем добавления anObject к набору получения.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + набор
    + setWithArray:
    + setWithObject:
    + setWithObjects:
    – setByAddingObjectsFromSet:
    – setByAddingObjectsFromArray:

  • setByAddingObjectsFromSet (_:) - setByAddingObjectsFromSet:

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

    Объявление

    Swift

    func setByAddingObjectsFromSet(_ other: NSSet) -> NSSet

    Objective C

    - (NSSet *)setByAddingObjectsFromSet:(NSSet *)other

    Параметры

    other

    Набор объектов добавить к набору получения.

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

    Новый набор, сформированный путем включения объектов other к набору получения.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + набор
    + setWithArray:
    + setWithObject:
    + setWithObjects:
    – setByAddingObject:
    – setByAddingObjectsFromArray:

  • setByAddingObjectsFromArray (_:) - setByAddingObjectsFromArray:

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

    Объявление

    Swift

    func setByAddingObjectsFromArray(_ other: [AnyObject]) -> NSSet

    Objective C

    - (NSSet *)setByAddingObjectsFromArray:(NSArray *)other

    Параметры

    other

    Массив объектов добавить к набору.

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

    Новый набор, сформированный путем включения объектов other к набору получения.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + набор
    + setWithArray:
    + setWithObject:
    + setWithObjects:
    – setByAddingObject:
    – setByAddingObjectsFromSet:

Инициализация набора
  • init (массив:) - initWithArray:

    Инициализирует недавно выделенный набор с объектами, содержащимися в данном массиве.

    Объявление

    Swift

    convenience init(array array: [AnyObject])

    Objective C

    - (instancetype)initWithArray:(NSArray *)array

    Параметры

    array

    Массив объектов добавить к новому набору. Если тот же объект появляется несколько раз в array, это представлено только один раз в возвращенном наборе. Каждый объект получает a retain обменивайтесь сообщениями, как это добавляется к набору.

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

    Инициализированный набор с содержанием array. Возвращенный набор мог бы отличаться, чем исходный получатель.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithObjects:
    – initWithObjects:count:
    – initWithSet:
    – initWithSet:copyItems:
    – init
    + setWithArray:

  • initWithObjects: - initWithObjects:

    Инициализирует недавно выделенный набор с элементами, взятыми из указанного списка объектов.

    Объявление

    Objective C

    - (instancetype)initWithObjects:(id)firstObj, firstObj, ...

    Параметры

    firstObj

    Первый объект добавить к новому набору.

    firstObj, ...

    Список разделенных запятой значений объектов, заканчивающихся nil, добавить к новому набору. Если тот же объект появляется несколько раз в списке, он представлен только один раз в возвращенном наборе. Каждый объект получает a retain обменивайтесь сообщениями, как это добавляется к набору

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

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

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – initWithArray:
    – initWithObjects:count:
    – initWithSet:
    – initWithSet:copyItems:
    – init
    + setWithObjects:

  • init (objects:count:) - initWithObjects:count: Определяемый инициализатор

    Инициализирует недавно выделенный набор с конкретным количеством объектов от данного массива C объектов.

    Объявление

    Swift

    init(objects objects: UnsafePointer<AnyObject?>, count cnt: Int)

    Objective C

    - (instancetype)initWithObjects:(const id [])objects count:(NSUInteger)cnt

    Параметры

    objects

    Массив C объектов добавить к новому набору. Если тот же объект появляется несколько раз в objects, это добавляется только один раз к возвращенному набору. Каждый объект получает a retain обменивайтесь сообщениями, как это добавляется к набору.

    cnt

    Число объектов от objects добавить к новому набору.

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

    Инициализированный набор, содержащий cnt объекты из списка объектов, указанных objects. Возвращенный набор мог бы отличаться, чем исходный получатель.

    Обсуждение

    Этот метод является определяемым инициализатором для NSSet.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithArray:
    – initWithObjects:
    – initWithSet:
    – initWithSet:copyItems:
    – init
    + setWithObjects:count:

  • init (набор:) - initWithSet:

    Инициализирует недавно выделенный набор и добавляет к нему объекты от другого данного набора.

    Объявление

    Swift

    convenience init(set set: NSSet)

    Objective C

    - (instancetype)initWithSet:(NSSet *)set

    Параметры

    set

    Набор, содержащий объекты добавить к набору получения. Каждый объект сохраняется, как он добавляется.

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

    Инициализированный набор объектов, содержащий объекты от set. Возвращенный набор мог бы отличаться, чем исходный получатель.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithArray:
    – initWithObjects:
    – initWithObjects:count:
    – initWithSet:copyItems:
    – init
    + setWithSet:

  • init (set:copyItems:) - initWithSet:copyItems:

    Инициализирует недавно выделенный набор и добавляет к нему элементы другого данного набора.

    Объявление

    Swift

    convenience init(set set: NSSet, copyItems flag: Bool)

    Objective C

    - (instancetype)initWithSet:(NSSet *)set copyItems:(BOOL)flag

    Параметры

    set

    Набор, содержащий объекты добавить к новому набору.

    flag

    Если YEStrue, каждый объект в set получает a copyWithZone: сообщение для создания копии объекта — объекты должно соответствовать NSCopying протокол. В среде управляемой памяти это вместо retain обменивайтесь сообщениями объект иначе получил бы. Объектная копия тогда добавляется к возвращенному набору.

    Если NOfalse, тогда в среде управляемой памяти каждый объект в set просто получает a retain обменивайтесь сообщениями, когда это будет добавлено к возвращенному набору.

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

    Инициализированный набор, содержащий элементы set. Возвращенный набор мог бы отличаться, чем исходный получатель.

    Обсуждение

    После того, как неизменный s был инициализирован таким образом, он не может быть изменен.

    copyWithZone: метод выполняет мелкую копию. Если у Вас есть набор произвольной глубины, передавая YEStrue для flag параметр выполнит неизменную копию первого уровня ниже поверхности. Если Вы передаете NOfalse переменчивость первого уровня незатронута. В любом случае переменчивость всех более глубоких уровней незатронута.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithArray:
    – initWithObjects:
    – initWithObjects:count:
    – initWithSet:
    – init
    + setWithSet:

  • init () - init Определяемый инициализатор

    Инициализирует недавно выделенный набор.

    Объявление

    Swift

    init()

    Objective C

    - (instancetype)init

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

    Набор.

    Обсуждение

    Этот метод является определяемым инициализатором NSSet.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithObjects:count:

Подсчет записей
  • количество количество Свойство

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

    Объявление

    Swift

    var count: Int { get }

    Objective C

    @property(readonly) NSUInteger count

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Доступ к элементам множества
  • allObjects allObjects Свойство

    Массив, содержащий элементы набора или пустой массив, если набор не имеет никаких элементов. (только для чтения)

    Объявление

    Swift

    var allObjects: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *allObjects

    Обсуждение

    Порядок объектов в массиве не определен.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – anyObject
    – objectEnumerator

  • anyObject () - anyObject

    Возвраты один из объектов в наборе, или nil если набор не содержит объектов.

    Объявление

    Swift

    func anyObject() -> AnyObject?

    Objective C

    - (id)anyObject

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

    Один из объектов в наборе, или nil если набор не содержит объектов. Объект возвратился, выбран в удобстве набора — выбор, как гарантируют, не будет случаен.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – allObjects
    – objectEnumerator

  • containsObject (_:) - containsObject:

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

    Объявление

    Swift

    func containsObject(_ anObject: AnyObject) -> Bool

    Objective C

    - (BOOL)containsObject:(id)anObject

    Параметры

    anObject

    Объект, на который можно протестировать членство набора.

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

    YEStrue если anObject присутствует в наборе, иначе NOfalse.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – элемент:

  • filteredSetUsingPredicate (_:) - filteredSetUsingPredicate:

    Оценивает данный предикат против каждого объекта в наборе получения и возвращает новый набор, содержащий объекты, для которых предикат возвращает true.

    Объявление

    Swift

    func filteredSetUsingPredicate(_ predicate: NSPredicate) -> NSSet

    Objective C

    - (NSSet *)filteredSetUsingPredicate:(NSPredicate *)predicate

    Параметры

    predicate

    Предикат.

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

    Новый набор тот, содержащий объекты в наборе получения, для который predicate возвращает true.

    Обсуждение

    Следующий пример иллюстрирует использование этого метода.

    • NSSet *sourceSet =
    • [NSSet setWithObjects:@"One", @"Two", @"Three", @"Four", nil];
    • NSPredicate *predicate =
    • [NSPredicate predicateWithFormat:@"SELF beginswith 'T'"];
    • NSSet *filteredSet =
    • [sourceSet filteredSetUsingPredicate:predicate];
    • // filteredSet contains (Two, Three)

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • makeObjectsPerformSelector: - makeObjectsPerformSelector:

    Отправляет сообщение, указанное данным селектором к каждому объекту в наборе.

    Объявление

    Objective C

    - (void)makeObjectsPerformSelector:(SEL)aSelector

    Параметры

    aSelector

    Селектор, указывающий сообщение для отправки элементам набора. Метод не должен брать параметры. Это не должно иметь побочного эффекта изменения набора. Это значение не должно быть NULL.

    Обсуждение

    Сообщение, указанное aSelector отправляется один раз каждому элементу набора. Этот метод повышает NSInvalidArgumentException если aSelector NULL.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – makeObjectsPerformSelector:withObject:

  • makeObjectsPerformSelector:withObject: - makeObjectsPerformSelector:withObject:

    Отправляет сообщение, указанное данным селектором к каждому объекту в наборе.

    Объявление

    Objective C

    - (void)makeObjectsPerformSelector:(SEL)aSelector withObject:(id)argument

    Параметры

    aSelector

    Селектор, указывающий сообщение для отправки элементам набора. Метод должен взять отдельный аргумент типа id. Метод не должен, как побочный эффект, изменять набор. Значение не должно быть NULL.

    argument

    Объект передать как параметр методу, указанному aSelector.

    Обсуждение

    Сообщение, указанное aSelector отправляется, с argument как параметр, один раз каждому элементу набора. Этот метод повышает NSInvalidArgumentException если aSelector NULL.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – makeObjectsPerformSelector:

  • элемент (_:) - элемент:

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

    Объявление

    Swift

    func member(_ object: AnyObject) -> AnyObject?

    Objective C

    - (id)member:(id)object

    Параметры

    object

    Объект, для которого можно протестировать на членство набора.

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

    Если набор содержит объект, равный object (как определено isEqual:) тогда тот объект (обычно это будет object), иначе nil.

    Обсуждение

    Если Вы переопределяете isEqual:, необходимо также переопределить hash метод для member: метод для работы над рядом объектов класса.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • objectEnumerator () - objectEnumerator

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

    Объявление

    Swift

    func objectEnumerator() -> NSEnumerator

    Objective C

    - (NSEnumerator *)objectEnumerator

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

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

    Обсуждение

    Следующий фрагмент кода иллюстрирует, как можно использовать этот метод.

    • NSEnumerator *enumerator = [mySet objectEnumerator];
    • id value;
    • while ((value = [enumerator nextObject])) {
    • /* code that acts on the set’s values */
    • }

    Когда этот метод используется с непостоянными подклассами NSSet, Ваш код не должен изменять набор во время перечисления. Если Вы намереваетесь изменить набор, используйте allObjects метод для создания «снимка» элементов набора. Перечислите снимок, но сделайте свои модификации к исходному набору.

    Специальные замечания

    Более эффективно использовать быстрый протокол перечисления (см. NSFastEnumeration). Быстрое перечисление доступно на OS X v10.5 и позже и iOS 2.0 и позже.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    nextObject (NSEnumerator)

  • enumerateObjectsUsingBlock (_:) - enumerateObjectsUsingBlock:

    Выполняет данный Блок с помощью каждого объекта в наборе.

    Объявление

    Swift

    func enumerateObjectsUsingBlock(_ block: (AnyObject!, UnsafeMutablePointer<ObjCBool>) -> Void)

    Objective C

    - (void)enumerateObjectsUsingBlock:(void (^)(id obj, BOOL *stop))block

    Параметры

    block

    Блок для применения к элементам в наборе.

    Блок берет два параметра:

    obj

    Элемент в наборе.

    stop

    Ссылка на булево значение. Блок может установить значение в YEStrue остановить последующую обработку набора. stop параметром является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в YES в Блоке.

    Блок возвращает булево значение, указывающее ли obj прошедший тест.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • enumerateObjectsWithOptions (_: usingBlock:) - enumerateObjectsWithOptions:usingBlock:

    Выполняет данный Блок с помощью каждого объекта в наборе, с помощью указанных опций перечисления.

    Объявление

    Swift

    func enumerateObjectsWithOptions(_ opts: NSEnumerationOptions, usingBlock block: (AnyObject!, UnsafeMutablePointer<ObjCBool>) -> Void)

    Objective C

    - (void)enumerateObjectsWithOptions:(NSEnumerationOptions)opts usingBlock:(void (^)(id obj, BOOL *stop))block

    Параметры

    opts

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

    block

    Блок для применения к элементам в наборе.

    Блок берет два параметра:

    obj

    Элемент в наборе.

    stop

    Ссылка на булево значение. Блок может установить значение в YEStrue остановить последующую обработку набора. stop параметром является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в YES в Блоке.

    Блок возвращает булево значение, указывающее ли obj прошедший тест.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • objectsPassingTest (_:) - objectsPassingTest:

    Ряд возвратов возражает, которые проходят тест в данном Блоке.

    Объявление

    Swift

    func objectsPassingTest(_ predicate: (AnyObject!, UnsafeMutablePointer<ObjCBool>) -> Bool) -> NSSet

    Objective C

    - (NSSet *)objectsPassingTest:(BOOL (^)(id obj, BOOL *stop))predicate

    Параметры

    predicate

    Блок для применения к элементам в массиве.

    Блок берет три параметра:

    obj

    Элемент в наборе.

    stop

    Ссылка на булево значение. Блок может установить значение в YEStrue остановить последующую обработку набора. stop параметром является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в YES в Блоке.

    Блок возвращает булево значение, указывающее ли obj прошедший тест.

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

    NSSet, содержащий объекты, проходящие тест.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • objectsWithOptions (_: passingTest:) - objectsWithOptions:passingTest:

    Ряд возвратов возражает, которые проходят тест в данном Блоке, с помощью указанных опций перечисления.

    Объявление

    Swift

    func objectsWithOptions(_ opts: NSEnumerationOptions, passingTest predicate: (AnyObject!, UnsafeMutablePointer<ObjCBool>) -> Bool) -> NSSet

    Objective C

    - (NSSet *)objectsWithOptions:(NSEnumerationOptions)opts passingTest:(BOOL (^)(id obj, BOOL *stop))predicate

    Параметры

    opts

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

    predicate

    Блок для применения к элементам в наборе.

    Блок берет два параметра:

    obj

    Элемент в наборе.

    stop

    Ссылка на булево значение. Блок может установить значение в YEStrue остановить последующую обработку набора. stop параметром является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в YES в Блоке.

    Блок возвращает булево значение, указывающее ли obj прошедший тест.

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

    NSSet содержа объекты, проходящие тест.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Сравнение наборов
  • isSubsetOfSet (_:) - isSubsetOfSet:

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

    Объявление

    Swift

    func isSubsetOfSet(_ otherSet: NSSet) -> Bool

    Objective C

    - (BOOL)isSubsetOfSet:(NSSet *)otherSet

    Параметры

    otherSet

    Набор, с которым можно сравнить набор получения.

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

    YEStrue если каждый объект в наборе получения также присутствует в otherSet, иначе NOfalse.

    Обсуждение

    Объектное равенство тестируется с помощью isEqual:.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – intersectsSet:
    – isEqualToSet:

  • intersectsSet (_:) - intersectsSet:

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

    Объявление

    Swift

    func intersectsSet(_ otherSet: NSSet) -> Bool

    Objective C

    - (BOOL)intersectsSet:(NSSet *)otherSet

    Параметры

    otherSet

    Набор, с которым можно сравнить набор получения.

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

    YEStrue если по крайней мере один объект в наборе получения также присутствует в otherSet, иначе NOfalse.

    Обсуждение

    Объектное равенство тестируется с помощью isEqual:.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – isEqualToSet:
    – isSubsetOfSet:

  • isEqualToSet (_:) - isEqualToSet:

    Сравнивает набор получения с другим набором.

    Объявление

    Swift

    func isEqualToSet(_ otherSet: NSSet) -> Bool

    Objective C

    - (BOOL)isEqualToSet:(NSSet *)otherSet

    Параметры

    otherSet

    Набор, с которым можно сравнить набор получения.

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

    YEStrue если содержание otherSet равны содержанию набора получения, иначе NOfalse.

    Обсуждение

    Два набора имеют равное содержание, если у каждого из них есть то же число членов и если каждый элемент одного набора присутствует в другом. Объектное равенство тестируется с помощью isEqual:.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – intersectsSet:
    isEqual: (NSObject протокол)
    – isSubsetOfSet:

  • valueForKey (_:) - valueForKey:

    Возвратите набор, содержащий результаты вызова valueForKey: на каждом из элементов набора получения.

    Объявление

    Swift

    func valueForKey(_ key: String) -> AnyObject

    Objective C

    - (id)valueForKey:(NSString *)key

    Параметры

    key

    Имя одного из свойств элементов набора получения.

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

    Набор, содержащий результаты вызова valueForKey: (с параметром key) на каждом из элементов набора получения.

    Обсуждение

    Возвращенный набор не мог бы иметь того же числа членов как набор получения. Возвращенный набор не будет содержать элементов, соответствующих экземплярам valueForKey: возврат nil (обратите внимание на то, что это в отличие от NSArrayреализация, которая может поместить NSNull значения в массивах это возвращается).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setValue:forKey:

  • setValue (_: forKey:) - setValue:forKey:

    Вызывает setValue:forKey: на каждом из элементов набора.

    Объявление

    Swift

    func setValue(_ value: AnyObject?, forKey key: String)

    Objective C

    - (void)setValue:(id)value forKey:(NSString *)key

    Параметры

    value

    Значение для свойства, идентифицированного key.

    key

    Имя одного из свойств элементов набора.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – valueForKey:

Создание сортированного массива
  • sortedArrayUsingDescriptors (_:) - sortedArrayUsingDescriptors:

    Возвращает массив содержания набора, сортированного, как указано данным массивом дескрипторов вида.

    Объявление

    Swift

    func sortedArrayUsingDescriptors(_ sortDescriptors: [AnyObject]) -> [AnyObject]

    Objective C

    - (NSArray *)sortedArrayUsingDescriptors:(NSArray *)sortDescriptors

    Параметры

    sortDescriptors

    Массив NSSortDescriptor объекты.

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

    NSArray, содержащий содержание набора, сортированное, как указано sortDescriptors.

    Обсуждение

    Первый дескриптор указывает путь первичного ключа, который будет использоваться в сортировке содержания набора. Любые последующие дескрипторы используются для дальнейшего совершенствования сортировки объектов с двойными значениями. Посмотрите NSSortDescriptor для получения дополнительной информации.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Наблюдение значения ключа
  • addObserver (_: forKeyPath:options:context:) - addObserver:forKeyPath:options:context:

    Повышает исключение.

    Объявление

    Swift

    func addObserver(_ observer: NSObject, forKeyPath keyPath: String, options options: NSKeyValueObservingOptions, context context: UnsafeMutablePointer<Void>)

    Objective C

    - (void)addObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath options:(NSKeyValueObservingOptions)options context:(void *)context

    Параметры

    observer

    Объект зарегистрироваться для уведомлений KVO. Наблюдатель должен реализовать метод наблюдения значения ключа observeValueForKeyPath:ofObject:change:context:.

    keyPath

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

    options

    Комбинация NSKeyValueObservingOptions значения, который указывает то, что включено в уведомления наблюдения. Для возможных значений посмотрите NSKeyValueObservingOptions.

    context

    Произвольные данные, передающиеся observer в observeValueForKeyPath:ofObject:change:context:.

    Специальные замечания

    NSSet объекты не заметны, таким образом, этот метод повышает исключение, когда вызвано на NSSet объект. Вместо того, чтобы наблюдать набор, наблюдайте неупорядоченный к - многие отношение, для которого набор является набором связанных объектов.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – removeObserver:forKeyPath:

  • removeObserver (_: forKeyPath:context:) - removeObserver:forKeyPath:context:

    Повышает исключение.

    Объявление

    Swift

    func removeObserver(_ observer: NSObject, forKeyPath keyPath: String, context context: UnsafeMutablePointer<Void>)

    Objective C

    - (void)removeObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath context:(void *)context

    Параметры

    observer

    Объект удалить как наблюдатель.

    keyPath

    Ключевой путь тот, относительно набора, для который observer регистрируется для получения уведомлений изменения KVO. Это значение не должно быть nil.

    context

    Произвольные данные, передающиеся observer в observeValueForKeyPath:ofObject:change:context:.

    Специальные замечания

    NSSet объекты не заметны, таким образом, этот метод повышает исключение, когда вызвано на NSSet объект. Вместо того, чтобы наблюдать набор, наблюдайте неупорядоченный к - многие отношение, для которого набор является набором связанных объектов.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – addObserver:forKeyPath:options:context:

  • removeObserver (_: forKeyPath:) - removeObserver:forKeyPath:

    Повышает исключение.

    Объявление

    Swift

    func removeObserver(_ observer: NSObject, forKeyPath keyPath: String)

    Objective C

    - (void)removeObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath

    Параметры

    observer

    Объект удалить как наблюдатель.

    keyPath

    Ключевой путь тот, относительно набора, для который observer регистрируется для получения уведомлений изменения KVO. Это значение не должно быть nil.

    Специальные замечания

    NSSet объекты не заметны, таким образом, этот метод повышает исключение, когда вызвано на NSSet объект. Вместо того, чтобы наблюдать набор, наблюдайте неупорядоченный к - многие отношение, для которого набор является набором связанных объектов.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – addObserver:forKeyPath:options:context:

Описание набора
  • описание описание Свойство

    Строка, представляющая содержание набора, отформатированного как список свойств. (только для чтения)

    Объявление

    Swift

    var description: String { get }

    Objective C

    @property(readonly, copy) NSString *description

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – descriptionWithLocale:

  • descriptionWithLocale (_:) - descriptionWithLocale:

    Возвращает строку, представляющую содержание набора, отформатированного как список свойств.

    Объявление

    Swift

    func descriptionWithLocale(_ locale: AnyObject?) -> String

    Objective C

    - (NSString *)descriptionWithLocale:(id)locale

    Параметры

    locale

    На iOS и OS X v10.5 и позже, любой экземпляр NSDictionary или NSLocale объект может использоваться для localeOS X.On v10.4 и ранее это должен быть экземпляр NSDictionary.

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

    Строка, представляющая содержание набора, отформатированного как список свойств.

    Обсуждение

    Этот метод отправляет каждый из элементов набора descriptionWithLocale: с locale переданный как единственный параметр. Если элементы набора не отвечают на descriptionWithLocale:, этот метод отправляет description вместо этого.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – описание