NSMutableDictionary

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

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

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

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

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

setObject:forKey:
removeObjectForKey:

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

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

NSObject
NSDictionary
NSMutableDictionary

NSObject
NSDictionary
NSMutableDictionary

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

AnyObject
CVarArgType
DictionaryLiteralConvertible
Сопоставимый
Hashable
NSCoding
NSCopying
NSFastEnumeration
NSMutableCopying
NSObjectProtocol
NSSecureCoding
Печатаемый
Reflectable
SequenceType
NSCopying
NSFastEnumeration
NSMutableCopying
NSObject
NSSecureCoding

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Создание и инициализация непостоянного словаря

dictionaryWithCapacity: + dictionaryWithCapacity:

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

Объявление

Objective C

+ (instancetype)dictionaryWithCapacity:(NSUInteger)numItems

Параметры

numItems

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

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

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

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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

См. также

dictionary (NSDictionary)
dictionaryWithContentsOfFile: (NSDictionary)
dictionaryWithContentsOfURL:: (NSDictionary)
dictionaryWithObject:forKey: (NSDictionary)
dictionaryWithObjects:forKeys:: (NSDictionary)
dictionaryWithObjects:forKeys:count: (NSDictionary)
dictionaryWithObjectsAndKeys: (NSDictionary)
– initWithCapacity:
init (способность:) - initWithCapacity: Определяемый инициализатор

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

Объявление

Swift

init(capacity numItems: Int)

Objective C

- (instancetype)initWithCapacity:(NSUInteger)numItems

Параметры

numItems

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

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

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

Обсуждение

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

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

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

Объявление

Swift

init()

Objective C

- (instancetype)init

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

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

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– initWithCapacity:


    
    init (sharedKeySet:)
    + dictionaryWithSharedKeySet:

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

Объявление

Swift

init(sharedKeySet keyset: AnyObject) -> NSMutableDictionary

Objective C

+ (NSMutableDictionary *)dictionaryWithSharedKeySet:(id)keyset

Параметры


      keyset

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

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

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

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Добавление записей в непостоянный словарь


    
    setObject (_: forKey:)
    - setObject:forKey:

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

Объявление

Swift

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

Objective C

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

Параметры

`anObject`	Значение для `aKey`. Сильная ссылка к объекту сохраняется словарем. Важный Повышения `NSInvalidArgumentException` если `anObject` `nil`. Если необходимо представлять a `nil` значение в словаре, использовать `NSNull`.
`aKey`	Ключ для `value`. Ключ копируется (использование `copyWithZone:`; ключи должны соответствовать `NSCopying` протокол). Если `aKey` уже существует в словаре, `anObject` занимает его место. Важный Повышения `NSInvalidArgumentException` если `aKey` `nil`.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– setObject:forKeyedSubscript:
– removeObjectForKey:


    
    setObject:forKeyedSubscript:
    - setObject:forKeyedSubscript:

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

Объявление

Objective C

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

Параметры

`object`	Значение для `aKey`. Сильная ссылка к объекту сохраняется словарем. Важный Повышения `NSInvalidArgumentException` если `anObject` `nil`. Если необходимо представлять a `nil` значение в словаре, использовать `NSNull`.
`aKey`	Ключ для `value`. Ключ копируется (использование `copyWithZone:`; ключи должны соответствовать `NSCopying` протокол). Если `aKey` уже существует в словаре, `anObject` занимает его место. Важный Повышения `NSInvalidArgumentException` если `aKey` `nil`.

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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

См. также

– setObject:forKey:
– removeObjectForKey:


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

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

Объявление

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

Доступность

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

См. также

valueForKey: (NSDictionary)

addEntriesFromDictionary (_:) - addEntriesFromDictionary:

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

Объявление

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

Доступность

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

См. также

– setObject:forKey:
setDictionary (_:) - setDictionary:

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

Объявление

Swift

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

Objective C

- (void)setDictionary:(NSDictionary *)otherDictionary

Параметры

otherDictionary

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

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Удаление записей из непостоянного словаря


    
    removeObjectForKey (_:)
    - removeObjectForKey:

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

Объявление

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

Доступность

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

См. также

– removeAllObjects
– removeObjectsForKeys:

removeAllObjects () - removeAllObjects

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

Объявление

Swift

func removeAllObjects()

Objective C

- (void)removeAllObjects

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– removeObjectForKey:
– removeObjectsForKeys:
removeObjectsForKeys (_:) - removeObjectsForKeys:

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

Объявление

Swift

func removeObjectsForKeys(_ keyArray: [AnyObject])

Objective C

- (void)removeObjectsForKeys:(NSArray *)keyArray

Параметры

keyArray

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

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– removeObjectForKey:
– removeObjectForKey: