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

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

Разработчик

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

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

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

NSDictionary

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

Пару ключ/значение в словаре вызывают записью. Каждая запись состоит из одного объекта, представляющего ключ и второй объект, который является что значение ключа. В словаре ключи уникальны. Т.е. никакие два ключа в единственном словаре не равны (как определено isEqual:). В целом ключ может быть любым объектом (при условии, что это соответствует NSCopying протокол — видит ниже), но обратите внимание на то, что при использовании значения ключа, кодирующего ключ, должна быть строка (см., что Значение ключа Кодирует Основные принципы). Ни ключ, ни значение не могут быть nil; если необходимо представлять нулевое значение в словаре, необходимо использовать NSNull.

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

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

Вы обычно не должны должны быть разделять на подклассы NSDictionary. Пользовательское поведение может обычно достигаться через состав вместо разделения на подклассы.

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

Если действительно необходимо разделить на подклассы NSDictionary, примите во внимание, что это - кластер класса. Любой подкласс должен переопределить следующие примитивные методы:

Другие методы NSDictionary действуйте путем вызова один или больше этих примитивов. Непримитивные методы обеспечивают удобные способы получить доступ к многократным записям сразу.

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

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

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

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


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


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


Swift

import Foundation

Objective C

@import Foundation;

Доступность


Доступный в OS X v10.0 и позже.
  • Создает и возвращает пустой словарь.

    Объявление

    Objective C

    + (instancetype)dictionary

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

    Новый пустой словарь.

    Обсуждение

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

    Если Вы не хотите временного объекта, можно также создать пустое использование словаря alloc... и init.

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

    Objective C

    @import Foundation;

    Доступность

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

  • Создает и возвращает словарь с помощью ключей и оценивает найденный в файле, указанном данным путем.

    Объявление

    Objective C

    + (NSDictionary *)dictionaryWithContentsOfFile:(NSString *)path

    Параметры

    path

    Полный или относительный путь. Файл, идентифицированный path должен содержать строковое представление списка свойств, корневой объект которого является словарем.

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

    Новый словарь, содержащий словарь в path, или nil если содержание файла является недопустимым представлением словаря, если существует ошибка файла или.

    Обсуждение

    Представление словаря в файле, идентифицированном path должен содержать только объекты списка свойств (NSString, NSData, NSDate, NSNumber, NSArray, или NSDictionary объекты). Для получения дополнительной информации см. Руководство по программированию Списка свойств. Даже если словарь является непостоянным, объекты, содержавшие этим словарем, являются неизменными.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – initWithContentsOfFile:

  • Создает и возвращает словарь с помощью ключей и оценивает найденный в ресурсе, указанном данным URL.

    Объявление

    Objective C

    + (NSDictionary *)dictionaryWithContentsOfURL:(NSURL *)aURL

    Параметры

    aURL

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

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

    Новый словарь, содержащий словарь в aURL, или nil если содержание ресурса является недопустимым представлением словаря, если существует ошибка или.

    Обсуждение

    Представление словаря в файле, идентифицированном path должен содержать только объекты списка свойств (NSString, NSData, NSDate, NSNumber, NSArray, или NSDictionary объекты). Для получения дополнительной информации см. Руководство по программированию Списка свойств. Даже если словарь является непостоянным, объекты, содержавшие этим словарем, являются неизменными.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – initWithContentsOfURL:

  • Создает и возвращает словарь, содержащий ключи, и оценивает от другого данного словаря.

    Объявление

    Objective C

    + (instancetype)dictionaryWithDictionary:(NSDictionary *)otherDictionary

    Параметры

    otherDictionary

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

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

    Новый словарь, содержащий ключи и значения, найденные в otherDictionary.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – initWithDictionary:

  • Создает и возвращает словарь, содержащий данный ключ и значение.

    Объявление

    Swift

    convenience init(object anObject: AnyObject, forKey aKey: NSCopying)

    Objective C

    + (instancetype)dictionaryWithObject:(id)anObject forKey:(id<NSCopying>)aKey

    Параметры

    anObject

    Соответствие значения aKey.

    Если это значение nil, NSInvalidArgumentException повышен.

    aKey

    Ключ для anObject.

    Если это значение nil, NSInvalidArgumentException повышен.

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

    Новый словарь, содержащий отдельный объект, anObject, для единственного ключа, aKey.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Создает и возвращает словарь, содержащий записи, созданные из содержания массива ключей и массива значений.

    Объявление

    Objective C

    + (instancetype)dictionaryWithObjects:(NSArray *)objects forKeys:(NSArray *)keys

    Параметры

    objects

    Массив, содержащий значения для нового словаря.

    keys

    Массив, содержащий ключи для нового словаря. Каждый ключ копируется (использование copyWithZone:; ключи должны соответствовать NSCopying протокол), и копия добавляется к словарю.

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

    Новый словарь, содержащий записи, созданные из содержания objects и keys.

    Обсуждение

    Этот метод продвигается через objects и keys массивы, создавая записи в новом словаре, когда это идет. NSInvalidArgumentException если объекты и ключи не имеют того же числа элементов, повышен.

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

    Objective C

    @import Foundation;

    Доступность

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

  • Создает и возвращает словарь, содержащий count объекты от objects массив.

    Объявление

    Objective C

    + (instancetype)dictionaryWithObjects:(const id [])objects forKeys:(const id<NSCopying> [])keys count:(NSUInteger)count

    Параметры

    objects

    Массив C значений для нового словаря.

    keys

    Массив C ключей для нового словаря. Каждый ключ копируется (использование copyWithZone:; ключи должны соответствовать NSCopying протокол), и копия добавляется к новому словарю.

    count

    Число элементов для использования от keys и objects массивы. count не должен превышать число элементов в objects или keys.

    Обсуждение

    Этот метод продвигается через objects и keys массивы, создавая записи в новом словаре, когда это идет. NSInvalidArgumentException если объект ключа или значения, повышен nil.

    Следующий фрагмент кода иллюстрирует, как создать словарь, связывающий буквенные символы с их значениями ASCII:

    • static const NSInteger N_ENTRIES = 26;
    • NSDictionary *asciiDict;
    • NSString *keyArray[N_ENTRIES];
    • NSNumber *valueArray[N_ENTRIES];
    • NSInteger i;
    • for (i = 0; i < N_ENTRIES; i++) {
    • char charValue = 'a' + i;
    • keyArray[i] = [NSString stringWithFormat:@"%c", charValue];
    • valueArray[i] = [NSNumber numberWithChar:charValue];
    • }
    • asciiDict = [NSDictionary dictionaryWithObjects:(id *)valueArray
    • forKeys:(id *)keyArray count:N_ENTRIES];

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

    Objective C

    @import Foundation;

    Доступность

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

  • Создает и возвращает словарь, содержащий записи, созданные из указанного набора значений и ключей.

    Объявление

    Objective C

    + (instancetype)dictionaryWithObjectsAndKeys:(id)firstObject, ...

    Параметры

    firstObject

    Первое значение, которое добавит к новому словарю.

    ...

    Сначала ключ для firstObject, тогда завершенный нулем список чередования значений и ключей. Если какой-либо ключ nil, NSInvalidArgumentException повышен.

    Обсуждение

    Этот метод подобен dictionaryWithObjects:forKeys:, отличие только по пути пары ключ/значение указано.

    Например:

    • NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys:
    • @"value1", @"key1", @"value2", @"key2", nil];

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

    Objective C

    @import Foundation;

    Доступность

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

  • Инициализирует недавно выделенный словарь с помощью ключей и оценивает найденный в файле в данном пути.

    Объявление

    Swift

    convenience init?(contentsOfFile path: String)

    Objective C

    - (NSDictionary *)initWithContentsOfFile:(NSString *)path

    Параметры

    path

    Полный или относительный путь. Файл, идентифицированный path должен содержать строковое представление списка свойств, корневой объект которого является словарем.

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

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

    Обсуждение

    Представление словаря в файле, идентифицированном path должен содержать только объекты списка свойств (NSString, NSData, NSDate, NSNumber, NSArray, или NSDictionary объекты). Для получения дополнительной информации см. Руководство по программированию Списка свойств. Даже если словарь является непостоянным, объекты, содержавшие этим словарем, являются неизменными.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Инициализирует недавно выделенный словарь с помощью ключей и оценивает найденный в данный URL.

    Объявление

    Swift

    convenience init?(contentsOfURL aURL: NSURL)

    Objective C

    - (NSDictionary *)initWithContentsOfURL:(NSURL *)aURL

    Параметры

    aURL

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

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

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

    Обсуждение

    Представление словаря в файле, идентифицированном path должен содержать только объекты списка свойств (NSString, NSData, NSDate, NSNumber, NSArray, или NSDictionary объекты). Для получения дополнительной информации см. Руководство по программированию Списка свойств. Даже если словарь является непостоянным, объекты, содержавшие этим словарем, являются неизменными.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Инициализирует недавно выделенный словарь путем размещения в него ключей и оценивает содержавшийся в другом данном словаре.

    Объявление

    Swift

    convenience init(dictionary otherDictionary: [NSObject : AnyObject])

    Objective C

    - (instancetype)initWithDictionary:(NSDictionary *)otherDictionary

    Параметры

    otherDictionary

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + dictionaryWithDictionary:

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

    Объявление

    Swift

    convenience init(dictionary otherDictionary: [NSObject : AnyObject], copyItems flag: Bool)

    Objective C

    - (instancetype)initWithDictionary:(NSDictionary *)otherDictionary copyItems:(BOOL)flag

    Параметры

    otherDictionary

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

    flag

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

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

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

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

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithDictionary:

  • Инициализирует недавно выделенный словарь с записями, созданными из содержания objects и keys массивы.

    Объявление

    Swift

    convenience init(objects objects: [AnyObject], forKeys keys: [AnyObject])

    Objective C

    - (instancetype)initWithObjects:(NSArray *)objects forKeys:(NSArray *)keys

    Параметры

    objects

    Массив, содержащий значения для нового словаря.

    keys

    Массив, содержащий ключи для нового словаря. Каждый ключ копируется (использование copyWithZone:; ключи должны соответствовать NSCopying протокол), и копия добавляется к новому словарю.

    Обсуждение

    Этот метод продвигается через objects и keys массивы, создавая записи в новом словаре, когда это идет. NSInvalidArgumentException если объекты и ключевые массивы не имеют того же числа элементов, повышен.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Инициализирует недавно выделенный словарь с count записи.

    Объявление

    Swift

    init(objects objects: UnsafePointer<AnyObject?>, forKeys keys: UnsafePointer<NSCopying?>, count count: Int)

    Objective C

    - (instancetype)initWithObjects:(const id [])objects forKeys:(const id<NSCopying> [])keys count:(NSUInteger)count

    Параметры

    objects

    Массив C значений для нового словаря.

    keys

    Массив C ключей для нового словаря. Каждый ключ копируется (использование copyWithZone:; ключи должны соответствовать NSCopying протокол), и копия добавляется к новому словарю.

    count

    Число элементов для использования от keys и objects массивы. count не должен превышать число элементов в objects или keys.

    Обсуждение

    Этот метод продвигается через objects и keys массивы, создавая записи в новом словаре, когда это идет. NSInvalidArgumentException если объект ключа или значения, повышен nil.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Objective C

    - (instancetype)initWithObjectsAndKeys:(id)firstObject, ...

    Параметры

    firstObject

    Первое значение, которое добавит к новому словарю.

    ...

    Сначала ключ для firstObject, тогда завершенный нулем список чередования значений и ключей. Если какой-либо ключ nil, NSInvalidArgumentException повышен.

    Обсуждение

    Этот метод подобен initWithObjects:forKeys:, отличие только по пути, которым указаны пары ключ/значение.

    Например:

    • NSDictionary *dict = [[NSDictionary alloc] initWithObjectsAndKeys:
    • @"value1", @"key1", @"value2", @"key2", nil];

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

    Objective C

    @import Foundation;

    Доступность

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

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

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

    Объявление

    Swift

    init()

    Objective C

    - (instancetype)init

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

    Словарь.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func sharedKeySetForKeys(_ keys: [AnyObject]) -> AnyObject

    Objective C

    + (id)sharedKeySetForKeys:(NSArray *)keys

    Параметры

    keys

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

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

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

    Обсуждение

    Массив keys может содержать бесшумно проигнорированные копии. Двойные значения хэш-функции ключей бесшумно позволяются, но могут вызвать более низкую производительность и увеличить использование памяти.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Число записей в словаре (только для чтения)

    Объявление

    Swift

    var count: Int { get }

    Objective C

    @property(readonly) NSUInteger count

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    func isEqualToDictionary(_ otherDictionary: [NSObject : AnyObject]) -> Bool

    Objective C

    - (BOOL)isEqualToDictionary:(NSDictionary *)otherDictionary

    Параметры

    otherDictionary

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

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    isEqual: (NSObject протокол)

  • allKeys allKeys Свойство

    Новый массив, содержащий ключи словаря или пустой массив, если словарь не имеет никаких записей (только для чтения)

    Объявление

    Swift

    var allKeys: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *allKeys

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    func allKeysForObject(_ anObject: AnyObject) -> [AnyObject]

    Objective C

    - (NSArray *)allKeysForObject:(id)anObject

    Параметры

    anObject

    Значение для поиска в словаре.

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

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

    Обсуждение

    Каждый объект в словаре отправляется isEqual: сообщение, чтобы определить, равно ли это anObject.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    allKeys
    – keyEnumerator

  • allValues allValues Свойство

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

    Объявление

    Swift

    var allValues: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *allValues

    Обсуждение

    Порядок значений в массиве не определяется.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвраты ссылкой C массивы ключей и значений в словаре.

    Объявление

    Swift

    func getObjects(_ objects: AutoreleasingUnsafeMutablePointer<AnyObject?>, andKeys keys: AutoreleasingUnsafeMutablePointer<AnyObject?>)

    Objective C

    - (void)getObjects:(id [])objects andKeys:(id [])keys

    Параметры

    objects

    По возврату, содержит массив C значений в словаре.

    keys

    По возврату, содержит массив C ключей в словаре.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение, связанное с данным ключом.

    Объявление

    Swift

    func objectForKey(_ aKey: AnyObject) -> AnyObject?

    Objective C

    - (id)objectForKey:(id)aKey

    Параметры

    aKey

    Ключ, для которого можно возвратить соответствующее значение.

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

    Значение связалось с aKey, или nil если никакое значение не связано с aKey.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение, связанное с данным ключом.

    Объявление

    Objective C

    - (id)objectForKeyedSubscript:(id)key

    Параметры

    key

    Ключ, для которого можно возвратить соответствующее значение.

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

    Значение связалось с aKey, или nil если никакое значение не связано с aKey.

    Обсуждение

    Этот метод ведет себя то же как objectForKey:.

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

    Objective C

    @import Foundation;

    Доступность

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

  • Возвращает набор объектов из словаря, соответствующего указанному keys как NSArray.

    Объявление

    Swift

    func objectsForKeys(_ keys: [AnyObject], notFoundMarker anObject: AnyObject) -> [AnyObject]

    Objective C

    - (NSArray *)objectsForKeys:(NSArray *)keys notFoundMarker:(id)anObject

    Параметры

    keys

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

    anObject

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение, связанное с данным ключом.

    Объявление

    Swift

    func valueForKey(_ key: String) -> AnyObject?

    Objective C

    - (id)valueForKey:(NSString *)key

    Параметры

    key

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

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

    Значение связалось с key.

    Обсуждение

    Если key не запускается с “@”, вызывает objectForKey:. Если key действительно запускается с “@”, полосы и вызывают [super valueForKey:] с остальной частью ключа.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    setValue:forKey: (NSMutableDictionary)
    – getObjects:andKeys:

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

    Объявление

    Objective C

    - (NSEnumerator *)keyEnumerator

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

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

    Обсуждение

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

    • NSEnumerator *enumerator = [myDictionary keyEnumerator];
    • id key;
    • while ((key = [enumerator nextObject])) {
    • /* code that uses the returned key */
    • }

    Если Вы используете этот метод с экземплярами непостоянных подклассов NSDictionary, Ваш код не должен изменять записи во время перечисления. Если Вы намереваетесь изменить записи, используйте allKeys свойство для создания «снимка» ключей словаря. Тогда используйте этот снимок для пересечения записей, изменяя их по пути.

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

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

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

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

    Объявление

    Swift

    func objectEnumerator() -> NSEnumerator

    Objective C

    - (NSEnumerator *)objectEnumerator

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

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

    Обсуждение

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

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

    Если Вы используете этот метод с экземплярами непостоянных подклассов NSDictionary, Ваш код не должен изменять записи во время перечисления. Если Вы намереваетесь изменить записи, используйте allValues метод для создания «снимка» значений словаря. Работа от этого снимка для изменения значений.

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – keyEnumerator:
    nextObject (NSEnumerator)

  • Применяет данный блочный объект к записям словаря.

    Объявление

    Swift

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

    Objective C

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

    Параметры

    block

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

    Обсуждение

    Если блок устанавливает *stop к YEStrue, остановки перечисления.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Применяет данный блочный объект к записям словаря.

    Объявление

    Swift

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

    Objective C

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

    Параметры

    opts

    Опции перечисления.

    block

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

    Обсуждение

    Если блок устанавливает *stop к YEStrue, остановки перечисления.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    func keysSortedByValueUsingSelector(_ comparator: Selector) -> [AnyObject]

    Objective C

    - (NSArray *)keysSortedByValueUsingSelector:(SEL)comparator

    Параметры

    comparator

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

    comparator метод должен возвратиться NSOrderedAscending если значение словаря меньше, чем параметр, NSOrderedDescending если значение словаря больше, чем параметр, и NSOrderedSame если они равны.

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

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

    Обсуждение

    Пары значений словаря сравнены с помощью метода сравнения, указанного comparator; comparator сообщение отправляется в одно из значений и имеет как его отдельный аргумент другое значение из словаря.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    allKeys
    sortedArrayUsingSelector: (NSArray)

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

    Объявление

    Swift

    func keysSortedByValueUsingComparator(_ cmptr: NSComparator) -> [AnyObject]

    Objective C

    - (NSArray *)keysSortedByValueUsingComparator:(NSComparator)cmptr

    Параметры

    cmptr

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

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

    Массив ключей словаря, в порядке, которым они были бы в том, если бы словарь был сортирован его использованием значений cmptr.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    func keysSortedByValueWithOptions(_ opts: NSSortOptions, usingComparator cmptr: NSComparator) -> [AnyObject]

    Objective C

    - (NSArray *)keysSortedByValueWithOptions:(NSSortOptions)opts usingComparator:(NSComparator)cmptr

    Параметры

    opts

    Битовая маска опций вида.

    cmptr

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

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

    Массив ключей словаря, в порядке, которым они были бы в том, если бы словарь был сортирован его использованием значений cmptr с поданными опциями opts.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    predicate

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    opts

    Немного маски опций перечисления.

    predicate

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Пишет представление списка свойств содержания словаря к данному пути.

    Объявление

    Swift

    func writeToFile(_ path: String, atomically flag: Bool) -> Bool

    Objective C

    - (BOOL)writeToFile:(NSString *)path atomically:(BOOL)flag

    Параметры

    path

    Путь, в котором можно записать файл.

    Если path содержит тильду (~) символ, необходимо развернуть его с stringByExpandingTildeInPath прежде, чем вызвать этот метод.

    flag

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

    Если flag YEStrue, словарь записан во вспомогательный файл, и затем вспомогательный файл переименован к path. Если flag NOfalse, словарь записан непосредственно в path. YEStrue опция гарантирует это path, если это будет существовать вообще, то не будет поврежден, даже если система должна отказать во время записи.

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

    YEStrue если файл записан успешно, иначе NOfalse.

    Обсуждение

    Этот метод рекурсивно проверяет это, все содержащие в нем объекты являются объектами списка свойств (экземпляры NSData, NSDate, NSNumber, NSString, NSArray, или NSDictionary) перед выписыванием файла и возвратов NOfalse если бы все объекты не являются объектами списка свойств, так как результирующий файл не был бы допустимым списком свойств.

    Если содержание словаря является всеми объектами списка свойств, файл, записанный этим методом, может использоваться для инициализации нового словаря с методом класса dictionaryWithContentsOfFile: или метод экземпляра initWithContentsOfFile:.

    Для получения дополнительной информации о списках свойств, см. Руководство по программированию Списка свойств.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Пишет представление списка свойств содержания словаря к данному URL.

    Объявление

    Swift

    func writeToURL(_ aURL: NSURL, atomically flag: Bool) -> Bool

    Objective C

    - (BOOL)writeToURL:(NSURL *)aURL atomically:(BOOL)flag

    Параметры

    aURL

    URL, в который можно записать словарь.

    flag

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

    Если flag YEStrue, словарь записан во вспомогательное расположение, и затем вспомогательное расположение переименовано к aURL. Если flag NOfalse, словарь записан непосредственно в aURL. YEStrue опция гарантирует это aURL, если это будет существовать вообще, то не будет поврежден, даже если система должна отказать во время записи. flag проигнорирован если aURL имеет тип, который не может быть записан атомарно.

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

    YEStrue если расположение записано успешно, иначе NOfalse.

    Обсуждение

    Этот метод рекурсивно проверяет это, все содержащие в нем объекты являются объектами списка свойств (экземпляры NSData, NSDate, NSNumber, NSString, NSArray, или NSDictionary) перед выписыванием файла и возвратов NOfalse если бы все объекты не являются объектами списка свойств, так как результирующий вывод не был бы допустимым списком свойств.

    Если содержание словаря является всеми объектами списка свойств, расположение, записанное этим методом, может использоваться для инициализации нового словаря с методом класса dictionaryWithContentsOfURL: или метод экземпляра initWithContentsOfURL:.

    Для получения дополнительной информации о списках свойств, см. Руководство по программированию Списка свойств.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для NSFileCreationDate ключ.

    Объявление

    Swift

    func fileCreationDate() -> NSDate?

    Objective C

    - (NSDate *)fileCreationDate

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

    Значение для NSFileCreationDate ключ, или nil если словарь не имеет записи для ключа.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для NSFileExtensionHidden ключ.

    Объявление

    Swift

    func fileExtensionHidden() -> Bool

    Objective C

    - (BOOL)fileExtensionHidden

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

    Значение для NSFileExtensionHidden ключ, или NOfalse если словарь не имеет записи для ключа.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для NSFileGroupOwnerAccountID ключ.

    Объявление

    Swift

    func fileGroupOwnerAccountID() -> NSNumber?

    Objective C

    - (NSNumber *)fileGroupOwnerAccountID

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

    Значение для NSFileGroupOwnerAccountID ключ, или nil если словарь не имеет записи для ключа.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для NSFileGroupOwnerAccountName ключ.

    Объявление

    Swift

    func fileGroupOwnerAccountName() -> String?

    Objective C

    - (NSString *)fileGroupOwnerAccountName

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

    Значение для ключа NSFileGroupOwnerAccountName, или nil если словарь не имеет записи для ключа.

    Обсуждение

    Это и другой file... методы для использования со словарем, таким как возвращенные из методов fileAttributesAtPath:traverseLink: (NSFileManager), directoryAttributes (NSDirectoryEnumerator), и fileAttributes (NSDirectoryEnumerator), это представляет атрибуты POSIX файла или каталога. Этот метод возвращает имя группы соответствующего файла.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для NSFileHFSCreatorCode ключ.

    Объявление

    Swift

    func fileHFSCreatorCode() -> OSType

    Objective C

    - (OSType)fileHFSCreatorCode

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

    Значение для NSFileHFSCreatorCode ключ, или 0 если словарь не имеет записи для ключа.

    Обсуждение

    См. Типы файлов HFS для подробных данных о типе данных OSType.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для NSFileHFSTypeCode ключ.

    Объявление

    Swift

    func fileHFSTypeCode() -> OSType

    Objective C

    - (OSType)fileHFSTypeCode

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

    Значение для NSFileHFSTypeCode ключ, или 0 если словарь не имеет записи для ключа.

    Обсуждение

    См. Типы файлов HFS для подробных данных о типе данных OSType.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для NSFileAppendOnly ключ.

    Объявление

    Swift

    func fileIsAppendOnly() -> Bool

    Objective C

    - (BOOL)fileIsAppendOnly

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

    Значение для NSFileAppendOnly ключ, или NOfalse если словарь не имеет записи для ключа.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для NSFileImmutable ключ.

    Объявление

    Swift

    func fileIsImmutable() -> Bool

    Objective C

    - (BOOL)fileIsImmutable

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

    Значение для NSFileImmutable ключ, или NOfalse если словарь не имеет записи для ключа.

    Обсуждение

    Это и другой file... методы для использования со словарем, таким как возвращенные из методов fileAttributesAtPath:traverseLink: (NSFileManager), directoryAttributes (NSDirectoryEnumerator), и fileAttributes (NSDirectoryEnumerator), это представляет атрибуты POSIX файла или каталога.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для ключа NSFileModificationDate.

    Объявление

    Swift

    func fileModificationDate() -> NSDate?

    Objective C

    - (NSDate *)fileModificationDate

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

    Значение для ключа NSFileModificationDate, или nil если словарь не имеет записи для ключа.

    Обсуждение

    Это и другой file... методы для использования со словарем, таким как возвращенные из методов fileAttributesAtPath:traverseLink: (NSFileManager), directoryAttributes (NSDirectoryEnumerator), и fileAttributes (NSDirectoryEnumerator), это представляет атрибуты POSIX файла или каталога. Этот метод возвращает дату, что были в последний раз изменены данные файла.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для NSFileOwnerAccountID ключ.

    Объявление

    Swift

    func fileOwnerAccountID() -> NSNumber?

    Objective C

    - (NSNumber *)fileOwnerAccountID

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

    Значение для NSFileOwnerAccountID ключ, или nil если словарь не имеет записи для ключа.

    Обсуждение

    Это и другой file... методы для использования со словарем, таким как возвращенные из методов fileAttributesAtPath:traverseLink: (NSFileManager), directoryAttributes (NSDirectoryEnumerator), и fileAttributes (NSDirectoryEnumerator), это представляет атрибуты POSIX файла или каталога. Этот метод возвращает название счета владельца файла.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для ключа NSFileOwnerAccountName.

    Объявление

    Swift

    func fileOwnerAccountName() -> String?

    Objective C

    - (NSString *)fileOwnerAccountName

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

    Значение для ключа NSFileOwnerAccountName, или nil если словарь не имеет записи для ключа.

    Обсуждение

    Это и другой file... методы для использования со словарем, таким как возвращенные из методов fileAttributesAtPath:traverseLink: (NSFileManager), directoryAttributes (NSDirectoryEnumerator), и fileAttributes (NSDirectoryEnumerator), это представляет атрибуты POSIX файла или каталога. Этот метод возвращает название счета владельца файла.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для ключа NSFilePosixPermissions.

    Объявление

    Swift

    func filePosixPermissions() -> Int

    Objective C

    - (NSUInteger)filePosixPermissions

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

    Значение, как unsigned long, для ключа NSFilePosixPermissions, или 0 если словарь не имеет записи для ключа.

    Обсуждение

    Это и другой file... методы для использования со словарем, таким как возвращенные из методов fileAttributesAtPath:traverseLink: (NSFileManager), directoryAttributes (NSDirectoryEnumerator), и fileAttributes (NSDirectoryEnumerator), это представляет атрибуты POSIX файла или каталога. Этот метод возвращает полномочия файла.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для ключа NSFileSize.

    Объявление

    Swift

    func fileSize() -> UInt64

    Objective C

    - (unsigned long long)fileSize

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

    Значение, как unsigned long long, для ключа NSFileSize, или 0 если словарь не имеет записи для ключа.

    Обсуждение

    Это и другой file... методы - для использования со словарем такой как возвращенные из методов fileAttributesAtPath:traverseLink: (NSFileManager), directoryAttributes (NSDirectoryEnumerator), и fileAttributes (NSDirectoryEnumerator), это представляет атрибуты POSIX файла или каталога. Этот метод возвращает размер файла.

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

    Если файл имеет ветвь ресурсов, возвращенное значение не включает размер ветви ресурсов.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для ключа NSFileSystemFileNumber.

    Объявление

    Swift

    func fileSystemFileNumber() -> Int

    Objective C

    - (NSUInteger)fileSystemFileNumber

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

    Значение, как unsigned long, для ключа NSFileSystemFileNumber, или 0 если словарь не имеет записи для ключа

    Обсуждение

    Это и другой file... методы для использования со словарем, таким как возвращенные из методов fileAttributesAtPath:traverseLink: (NSFileManager), directoryAttributes (NSDirectoryEnumerator), и fileAttributes (NSDirectoryEnumerator), это представляет атрибуты POSIX файла или каталога. Этот метод возвращает inode файла.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для ключа NSFileSystemNumber.

    Объявление

    Swift

    func fileSystemNumber() -> Int

    Objective C

    - (NSInteger)fileSystemNumber

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

    Значение, как unsigned long, для ключа NSFileSystemNumber, или 0 если словарь не имеет записи для ключа

    Обсуждение

    Это и другой file... методы для использования со словарем, таким как возвращенные из методов fileAttributesAtPath:traverseLink: (NSFileManager), directoryAttributes (NSDirectoryEnumerator), и fileAttributes (NSDirectoryEnumerator), это представляет атрибуты POSIX файла или каталога. Этот метод возвращает ID устройства, содержащего файл.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает значение для ключа NSFileType.

    Объявление

    Swift

    func fileType() -> String?

    Objective C

    - (NSString *)fileType

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

    Значение для ключа NSFileType, или nil если словарь не имеет записи для ключа.

    Обсуждение

    Это и другой file... методы для использования со словарем, таким как возвращенные из методов fileAttributesAtPath:traverseLink: (NSFileManager), directoryAttributes (NSDirectoryEnumerator), и fileAttributes (NSDirectoryEnumerator), это представляет атрибуты POSIX файла или каталога. Этот метод возвращает тип файла. Возможные возвращаемые значения описаны в разделе «Constants» NSFileManager.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    var description: String { get }

    Objective C

    @property(readonly, copy) NSString *description

    Обсуждение

    Если каждый ключ в словаре NSString объект, записи перечислены в порядке возрастания ключом, иначе порядок, в котором перечислены записи, не определен. Это свойство предназначается для создания читаемого вывода для отладки целей, не для сериализации данных. Если Вы хотите хранить данные словаря для более позднего извлечения, см. Руководство по программированию Списка свойств и Руководство по программированию Архивов и Сериализации.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    var descriptionInStringsFileFormat: String { get }

    Objective C

    @property(readonly, copy) NSString *descriptionInStringsFileFormat

    Обсуждение

    Порядок, в котором перечислены записи, не определен.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

    - (NSString *)descriptionWithLocale:(id)locale

    Параметры

    locale

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

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

    Обсуждение

    Для описания как locale применяется к каждому элементу в словаре, посмотрите descriptionWithLocale:indent:.

    Если каждый ключ в словаре отвечает на compare:, записи перечислены в порядке возрастания ключом, иначе порядок, в котором перечислены записи, не определен.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    func descriptionWithLocale(_ locale: AnyObject?, indent level: Int) -> String

    Objective C

    - (NSString *)descriptionWithLocale:(id)locale indent:(NSUInteger)level

    Параметры

    locale

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

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

    level

    Указывает уровень добавления отступа, для создания вывода более читаемым: добавление отступа (4 пробелов) * level.

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

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

    Обсуждение

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

    • Если объект NSString объект, это использовано как есть.

    • Если объект отвечает на descriptionWithLocale:indent:, тот метод вызывается для получения строкового представления объекта.

    • Если объект отвечает на descriptionWithLocale:, тот метод вызывается для получения строкового представления объекта.

    • Если ни одному из вышеупомянутых условий не удовлетворяют, строковое представление объекта получено через description свойство.

    Если каждый ключ в словаре отвечает на compare:, записи перечислены в порядке возрастания ключом. Иначе, порядок, в котором перечислены записи, не определен.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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