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

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

Разработчик

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

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

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

NSMutableDictionary

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


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


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


Swift

import Foundation

Objective C

@import Foundation;

Доступность


Доступный в iOS 2.0 и позже.

NSMutableDictionary класс объявляет программируемый интерфейс к объектам, управляющим непостоянными ассоциациями ключей и значений. Это добавляет операции модификации к основным операциям, от которых это наследовалось NSDictionary. NSMutableDictionary “бесплатный соединенный мостом” с его Базовым дубликатом Основы, CFMutableDictionaryRef. Посмотрите Бесплатное Образование моста для получения дополнительной информации.

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

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

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

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

Необходимо также переопределить примитивные методы NSDictionary класс.

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

    Объявление

    Objective C

    + (instancetype)dictionaryWithCapacity:(NSUInteger)numItems

    Параметры

    numItems

    Начальная способность нового словаря.

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

    Новый непостоянный словарь с достаточным количеством выделенной памяти для содержания numItems записи.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в iOS 2.0 и позже.

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

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

    Объявление

    Swift

    init(capacity numItems: Int)

    Objective C

    - (instancetype)initWithCapacity:(NSUInteger)numItems

    Параметры

    numItems

    Начальная способность инициализированного словаря.

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

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

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

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

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

    Объявление

    Swift

    init()

    Objective C

    - (instancetype)init

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

    Непостоянный словарь.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 7.0 и позже.

    См. также

    – initWithCapacity:

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

    Объявление

    Swift

    init(sharedKeySet keyset: AnyObject) -> NSMutableDictionary

    Objective C

    + (NSMutableDictionary *)dictionaryWithSharedKeySet:(id)keyset

    Параметры

    keyset

    keyset, создаваемый NSDictionary метод класса sharedKeySetForKeys:.

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 6.0 и позже.

  • Добавляет данная пара ключ/значение к словарю.

    Объявление

    Swift

    func setObject(_ anObject: AnyObject, forKey aKey: NSCopying)

    Objective C

    - (void)setObject:(id)anObject forKey:(id<NSCopying>)aKey

    Параметры

    anObject

    Значение для aKey. Сильная ссылка к объекту сохраняется словарем.

    aKey

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • Добавляет данная пара ключ/значение к словарю.

    Объявление

    Objective C

    - (void)setObject:(id)object forKeyedSubscript:(id<NSCopying>)aKey

    Параметры

    object

    Значение для aKey. Сильная ссылка к объекту сохраняется словарем.

    aKey

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

    Обсуждение

    Этот метод идентичен setObject:forKey:.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в iOS 6.0 и позже.

  • Добавляет данная пара ключ/значение к словарю.

    Объявление

    Swift

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

    Objective C

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

    Параметры

    value

    Значение для key.

    key

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

    Обсуждение

    Этот метод добавляет value и key к использованию словаря setObject:forKey:, если value nil когда метод вместо этого пытается удалить key использование removeObjectForKey:.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    valueForKey: (NSDictionary)

  • Добавляет к словарю получения записи из другого словаря.

    Объявление

    Swift

    func addEntriesFromDictionary(_ otherDictionary: [NSObject : AnyObject])

    Objective C

    - (void)addEntriesFromDictionary:(NSDictionary *)otherDictionary

    Параметры

    otherDictionary

    Словарь, из которого можно добавить записи

    Обсуждение

    Каждый объект значения от otherDictionary отправляется a retain сообщение прежде чем быть добавленным к словарю получения. Напротив, каждый ключевой объект копируется (использование copyWithZone:— ключи должны соответствовать NSCopying протокол), и копия добавляется к словарю получения.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setObject:forKey:

  • Устанавливает содержание словаря получения к записям в данном словаре.

    Объявление

    Swift

    func setDictionary(_ otherDictionary: [NSObject : AnyObject])

    Objective C

    - (void)setDictionary:(NSDictionary *)otherDictionary

    Параметры

    otherDictionary

    Словарь, содержащий новые записи.

    Обсуждение

    Все записи удалены из словаря получения (с removeAllObjects), тогда каждая запись от otherDictionary добавленный в словарь получения.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • Удаляет данный ключ и его присваиваемое значение из словаря.

    Объявление

    Swift

    func removeObjectForKey(_ aKey: AnyObject)

    Objective C

    - (void)removeObjectForKey:(id)aKey

    Параметры

    aKey

    Ключ для удаления.

    Обсуждение

    Ничего не делает если aKey не существует.

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

    • NSMutableDictionary *stations = nil;
    • stations = [[NSMutableDictionary alloc]
    • initWithContentsOfFile: pathToArchive];
    • [stations removeObjectForKey:@"KIKT"];

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • Освобождает словарь от его записей.

    Объявление

    Swift

    func removeAllObjects()

    Objective C

    - (void)removeAllObjects

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • Удаляет из словарных статей, указанных элементами в данном массиве.

    Объявление

    Swift

    func removeObjectsForKeys(_ keyArray: [AnyObject])

    Objective C

    - (void)removeObjectsForKeys:(NSArray *)keyArray

    Параметры

    keyArray

    Массив объектов, указывающих ключи для удаления.

    Обсуждение

    Если ключ keyArray не существует, запись проигнорирована.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.