Класс словарей
Подробнее...
#import <SCDictionary.h>
Класс словарей
- SDK
- macOS 10.6+, iOS 7.0+, GNUstep
- Начиная с
- версии 1.1.3
Реализует представление коллекции, доступ к элементам которой осуществляется по строковым ключам. Класс также поддерживает древовидную структуру данных.
При работе класса возможно возникновение следующих ошибок:
- (void) addArray: |
|
(SCArray *) |
array |
|
Метод добавляет в словарь объекты из указанного словаря.
- Аргументы
-
array | - словарь с добавляемыми объектами |
- Исключения
-
- Начиная с
- version 1.2.3
- См. также
- - addObjectsFromArray:
Метод добавляет в словарь записи из другого словаря.
- Аргументы
-
dictionary | - словарь с добавляемыми записями |
- Исключения
-
- Начиная с
- версии 1.2.3
- См. также
- - addEntriesFromDictionary:
- (void) addEntriesFromDictionary: |
|
(SCDictionary *) |
dictionary |
|
Метод добавляет в словарь записи из другого словаря.
- Аргументы
-
dictionary | - словарь с добавляемыми записями |
- Исключения
-
- Начиная с
- версии 1.2.3
- См. также
- - addDictionary:
Метод добавляет в словарь записи, создаваниемые из ключей и объектов из указанных коллекций.
- Аргументы
-
objects | - коллекция добавляемых объектов |
keys | - коллекция добавляемых ключей |
- Начиная с
- версии 1.2.3
- (void) addObjectsAndKeys: |
|
(id<SCCollectioning>) |
object |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Метод добавляет в словарь записи на основе объектов и ключей из заданного списка.
- Аргументы
-
object | - первый добавляемый объект |
... | - ключ первого объекта и список остальных объектов и ключей |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель |
- Начиная с
- версии 1.2.3
- (void) addObjectsFromArray: |
|
(SCArray *) |
array |
|
Метод добавляет в словарь объекты из указанного словаря.
- Аргументы
-
array | - словарь с добавляемыми объектами |
- Исключения
-
- Начиная с
- version 1.2.3
- См. также
- - addArray:
Метод возвращает массив ключей, которым соответствует указанный объект.
- Аргументы
-
- Возвращает
- Массив с соответствующими искомому объекту ключами или пустой массив при отсутствии объекта в словаре
Метод определяет наличие в словаре всех объектов с ключами из указанной коллекции.
- Аргументы
-
- Возвращает
- YES при наличии в словаре всех искомых объектов и NO в противном случае
- (BOOL) containsAnyKey: |
|
(NSString *) |
key |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Метод определяет наличие в словаре объектов хотя бы для одного ключа из указанного списка.
- Аргументы
-
key | - первый ключ из списка |
... | - остальные ключи из списка |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Возвращает
- YES при наличии в словаре объектов для хотя бы одного ключа из списка и NO в противном случае
- (BOOL) containsAnyKeyFromCollection: |
|
(id<SCCollection>) |
collection |
|
Метод определяет наличие в словаре объектов для хотя бы одного ключа из указанной коллекции.
- Аргументы
-
collection | - коллекция с искомыми ключами |
- Возвращает
- YES при наличии в словаре объектов для хотя бы одного ключа из указанной коллекции и NO в противном случае
Метод определяет наличие в словаре хотя бы одного объекта с ключем из указанной коллекции.
- Аргументы
-
- Возвращает
- YES при наличии хотя бы одного объекта и NO в противном случае
- (BOOL) containsKey: |
|
(NSString *) |
key |
|
Метод определяет наличие в словаре объекта для заданного ключа.
- Аргументы
-
- Возвращает
- YES при наличии в словаре объекта с искомым ключем и NO в противном случае
- (BOOL) containsKeys: |
|
(NSString *) |
key |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Метод определяет наличие в словаре объектов для всех ключей из указанного списка.
- Аргументы
-
key | - первый ключ из списка |
... | - остальные ключи из списка |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Возвращает
- YES при наличии в словаре объектов для всех указанных в списке ключей и NO в противном случае
- (BOOL) containsKeysFromCollection: |
|
(id<SCCollection>) |
collection |
|
Метод определяет наличие в словаре объектов для всех ключей из указанной коллекции.
- Аргументы
-
collection | - коллекция с искомыми ключами |
- Возвращает
- YES при наличии в словаре объектов для всех ключей из указанной коллекции и NO в противном случае
- (BOOL) containsNumberForKey: |
|
(NSString *) |
key |
|
Метод определяет наличие в словаре числового объекта с указанным ключем.
- Аргументы
-
key | - ключ искомого числового объекта |
- Возвращает
- YES при наличии в словаре числового объекта с искомым ключем и NO в противном случае
- (BOOL) containsObjectForKey: |
|
(NSString *) |
key |
|
Метод определяет наличие в словаре объекта с указанным ключем.
- Аргументы
-
key | - ключ искомого объекта |
- Возвращает
- YES при наличии в словаре объекта с искомым ключем и NO в противном случае
- (BOOL) containsStringForKey: |
|
(NSString *) |
key |
|
Метод определяет наличие в словаре строки с указанным ключем.
- Аргументы
-
- Возвращает
- YES при наличии в словаре строки с искомым ключем и NO в противном случае
+ (instancetype) dictionary |
|
|
|
Классовый метод создает неименованный словарь.
- Возвращает
- Созданный словарь
Метод возвращает новый словарь с записями исходного словаря и записями из объектов указанного массива.
- Аргументы
-
array | - массив добавляемых объектов |
- Возвращает
- Новый словарь с записями исходного словаря и объектами заданного массива
- Исключения
-
- Начиная с
- версии 1.2.3
- См. также
- - dictionaryByAddingObjectsFromArray:
Метод возвращает новый словарь с записями исходного словаря и новыми объектами из указанной коллекции.
- Аргументы
-
collection | - коллекция с добавляемыми объектами |
- Возвращает
- Новый словарь с записями исходного словаря и объектами из заданной коллекции
- Исключения
-
- Начиная с
- версии 1.2.3
Метод возвращает новый словарь с записями исходного словаря и записями из указанного словаря.
- Аргументы
-
dictionary | - словарь с добавляемыми записями |
- Возвращает
- Новый словарь с записями исходного словаря и записями заданного словаря
- Исключения
-
- Начиная с
- версии 1.2.3
- См. также
- - dictionaryByAddingEntriesFromDictionary:
Метод возвращает новый словарь с записями исходного словаря и записями из указанного словаря.
- Аргументы
-
dictionary | - словарь с добавляемыми записями |
- Возвращает
- Новый словарь с записями исходного словаря и записями заданного словаря
- Исключения
-
- Начиная с
- версии 1.2.3
- См. также
- - dictionaryByAddingDictionary:
Метод возвращает новый словарь из записей исходного словаря и новой записью с заданным объктом и автоматически генерируемым ключем.
- Аргументы
-
object | - добавляемый в новый словарь объект |
- Возвращает
- Новый словарь с записями исходного словаря и новой записью с заданным объектом
- Исключения
-
- Начиная с
- версии 1.2.3
Метод возвращает новый словарь из записей исходного словаря и новой записью с заданными объектом и ключем.
- Аргументы
-
object | - добавляемый в новый словарь объект |
key | - ключ добавляемого объекта |
- Возвращает
- Новый словарь с записями исходного словаря и новой записью с заданными объектом и ключем
- Исключения
-
- Начиная с
- версии 1.2.3
Метод возвращает новый словарь из записей исходного словаря и новыми записями на основе объектов из заданного списка и автоматически генерируемых ключей.
- Аргументы
-
object | - первый объект из списка |
... | - остальные объекты из списка |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель |
- Возвращает
- Новый словарь с записями исходного словаря и новыми записями из объектов из указанного списка
- Исключения
-
- Начиная с
- версии 1.2.3
Метод возвращает новый словарь из записей исходного словаря и новыми записями на основе объектов и ключей из указанных коллекций любого поддерживаемого типа.
- Аргументы
-
objects | - коллекция добавляемых объектов |
keys | - коллекция добавляемых ключей |
- Возвращает
- Новый словарь с записями исходного словаря и новыми записями на основе заданных коллекций
- Исключения
-
- Начиная с
- версии 1.2.3
Метод возвращает новый словарь из записей исходного словаря и новых записей на основе объектов и ключей из заданного списка.
- Аргументы
-
object | - первый добавляемый объект |
... | - ключ первого объекта и список остальных объектов и ключей |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель |
- Возвращает
- Новый словарь с записями исходного словаря и новыми записи из объектов и ключей указанного списка
- Исключения
-
- Начиная с
- версии 1.2.3
Метод возвращает новый словарь с записями исходного словаря и записями из объектов указанного массива.
- Аргументы
-
array | - массив добавляемых объектов |
- Возвращает
- Новый словарь с записями исходного словаря и объектами заданного массива
- Исключения
-
- Начиная с
- версии 1.2.3
- См. также
- - dictionaryByAddingArray:
+ (instancetype) dictionaryWithCoder: |
|
(NSCoder *) |
coder |
|
Классовый метод создает словарь с использованием указанного кодировщика данных.
- Аргументы
-
coder | - исходный кодировщик данных |
- Возвращает
- Созданный словарь
+ (instancetype) dictionaryWithCollection: |
|
(id<SCCollection>) |
collection |
|
Классовый метод создает словарь с объектами из указанной коллекции.
- Аргументы
-
collection | - исходная коллекция |
- Возвращает
- Созданный словарь
- Исключения
-
+ (instancetype) dictionaryWithContentsOfFile: |
|
(NSString *) |
path |
|
Классовый метод создает словарь на основании информации из указанного файла.
- Аргументы
-
path | - путь к исходному файлу |
- Возвращает
- Созданный словарь
+ (instancetype) dictionaryWithContentsOfSerializedFile: |
|
(NSString *) |
path |
|
Классовый метод создает словарь с использованием данных из стандартного последовательного файла с заданным путем.
- Аргументы
-
path | - путь к исходному стандартному последовательному файлу |
- Возвращает
- Созданный словарь
+ (instancetype) dictionaryWithContentsOfURL: |
|
(NSURL *) |
url |
|
Классовый метод создает словарь с использованием данных по заданному URL.
- Аргументы
-
- Возвращает
- Созданный словарь
+ (instancetype) dictionaryWithContentsOfURLString: |
|
(NSString *) |
urlString |
|
Классовый метод создает словарь с использованием данных по заданному строкой URL.
- Аргументы
-
- Возвращает
- Созданный словарь
+ (instancetype) dictionaryWithData: |
|
(NSData *) |
data |
|
Классовый метод создает словарь с использованием заданного объекта данных.
- Аргументы
-
data | - исходный объект данных |
- Возвращает
- Созданный словарь
+ (instancetype) dictionaryWithDataDictionary: |
|
(NSDictionary *) |
dictionary |
|
Классовый метод создает словарь на основании данных из указанного словаря.
- Аргументы
-
dictionary | - словарь с исходными данными |
- Возвращает
- Созданный словарь
+ (instancetype) dictionaryWithDataDictionaryFromFile: |
|
(NSString *) |
path |
|
Классовый метод создает словарь на основании данных словаря из указанного файла.
- Аргументы
-
path | - путь к файлу словаря |
- Возвращает
- Созданный словарь
+ (instancetype) dictionaryWithDictionary: |
|
(SCDictionary *) |
dictionary |
|
Классовый метод создает копию указанного словаря.
- Аргументы
-
dictionary | - исходный словарь |
- Возвращает
- Созданный словарь
- Исключения
-
+ (instancetype) dictionaryWithFileStream: |
|
(NSString *) |
path |
|
Классовый метод создает словарь с использованием данных из указанного файлового потока.
- Аргументы
-
path | - путь к файлу потока |
- Возвращает
- Созданный словарь
- Исключения
-
+ (instancetype) dictionaryWithName: |
|
(NSString *) |
name |
|
Классовый метод создает словарь с указанным именем.
- Аргументы
-
- Возвращает
- Созданный словарь
Классовый метод создает словарь с одной записью из указанного объекта.
- Аргументы
-
object | - добавляемый объект |
- Возвращает
- Созданный словарь
Классовый метод создает словарь с одной записью с указанными объектом и ключем.
- Аргументы
-
object | - добавляемый объект |
key | - ключ добавляемого объекта |
- Возвращает
- Созданный словарь
Классовый метод создает словарь с объектами из указанного списка.
- Аргументы
-
object | - первый добавляемый объект |
... | - остальные добавляемые объекты |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Возвращает
- Созданный словарь
Классовый метод создает словарь с записями из указанных списков объектов и ключей.
- Аргументы
-
objects | - добавляемые в словарь объекты |
keys | - ключи добавляемых в словарь объектов |
- Возвращает
- Созданный словарь
+ (instancetype) dictionaryWithObjectsAndKeys: |
|
(id<SCCollectioning>) |
object |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Классовый метод создает словарь с объектами и ключами из указанного списка.
- Аргументы
-
object | - первый элемент списка |
... | - остальные добавляемые объекты |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель |
- Возвращает
- Созданный словарь
+ (instancetype) dictionaryWithStream: |
|
(SCStream *) |
stream |
|
Классовый метод создает словарь с использованием данных из указанного потока.
- Аргументы
-
stream | - поток для чтения данных словаря |
- Возвращает
- Созданный словарь
- Исключения
-
Метод инициализирует неименованный словарь.
- Возвращает
- Инициализированный словарь
Переопределяет метод предка SCCollection.
- (instancetype) initWithCollection: |
|
(id<SCCollection>) |
collection |
|
Метод инициализирует словарь с объектами из указанной коллекции.
- Аргументы
-
collection | - исходная коллекция |
- Возвращает
- Инициализированный словарь
- Исключения
-
Переопределяет метод предка SCCollection.
- (instancetype) initWithDictionary: |
|
(SCDictionary *) |
dictionary |
|
Метод инициализирует копию указанного словаря.
- Внимание
- Является назначенным инициализатором класса
- Аргументы
-
dictionary | - исходный словарь |
- Возвращает
- Инициализированный словарь
- Исключения
-
- (instancetype) initWithName: |
|
(NSString *) |
name |
|
Метод инициализирует словарь с указанным именем.
Назначенный инициализатор класса
- Аргументы
-
- Возвращает
- Инициализированный словарь
Переопределяет метод предка SCCollection.
Метод инициализирует словарь с одной записью из указанного объекта.
- Аргументы
-
object | - добавляемый объект |
- Возвращает
- Инициализированный словарь
Метод инициализирует словарь с одной записью с указанными объектом и ключем.
- Аргументы
-
object | - добавляемый объект |
key | - ключ добавляемого объекта |
- Возвращает
- Инициализированный словарь
- (instancetype) initWithObjects: |
|
(id<SCCollectioning>) |
object |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Метод инициализирует словарь с объектами из указанного списка.
- Аргументы
-
object | - первый добавляемый объект |
... | - остальные добавляемые объекты |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Возвращает
- Инициализированный словарь
Метод инициализирует словарь с записями из указанных списков объектов и ключей.
- Аргументы
-
objects | - добавляемые в словарь объекты |
keys | - ключи добавляемых в словарь объектов |
- Возвращает
- Инициализированный словарь
- (instancetype) initWithObjectsAndKeys: |
|
(id<SCCollectioning>) |
object |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Метод инициализирует словарь с объектами и ключами из указанного списка.
- Аргументы
-
object | - первый элемент списка |
... | - остальные добавляемые объекты |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Возвращает
- Инициализированный словарь
Метод выполняет сравнение содержимого и параметров словаря с содержимым и параметрами указанного словаря.
- Аргументы
-
dictionary | - словарь для сравнения |
- Возвращает
- YES если содержимое и параметры словарей совпадают и NO в противном случае
- (id) objectForKey: |
|
(NSString *) |
key |
|
Метод возвращает соответствующий указанному ключу объект.
- Аргументы
-
key | - ключ искомого объекта |
- Возвращает
- Соответствующий ключу объект или nil при отсутствии ключа в словаре
- См. также
- - valueForKey:
Переопределяет метод предка <SCKeyedCollection>.
- (id) objectForKeyedSubscript: |
|
(NSString *) |
key |
|
Метод возвращает значение, связанное с указанным ключем.
- Аргументы
-
key | - ключ искомого значения |
- Возвращает
- Ассоциированное с ключем значение или nil при отсутствии значения для указанного ключа
- Исключения
-
- Начиная с
- версии 1.2.5
Переопределяет метод предка <SCKeyedCollection>.
- (void) removeObjectForKey: |
|
(NSString *) |
key |
|
Метод удаляет из словаря объект с указанным ключем.
- Аргументы
-
key | - ключ удаляемого объекта |
- Исключения
-
Переопределяет метод предка <SCMutableKeyedCollection>.
- (void) removeObjectsForKeys: |
|
(SCArray *) |
keys |
|
Метод удаляет из словаря объекты с ключами из указанного массива.
- Аргументы
-
keys | - массив с ключами удаляемых объектов |
- Исключения
-
Метод замещает содержимое и настройки словаря содержимым и настройками указанного словаря.
- Аргументы
-
dictionary | - исходный словарь |
- Исключения
-
Метод устанавливает заданный объект для указанного ключа. Если запись для данного ключа не существует, то она создается, если запись уже существовала, то заданный объект заменяет уже существующий.
- Аргументы
-
object | - объект для ассоциации с указанным ключем |
key | - ключ объекта |
- Исключения
-
- См. также
- - setValue:forKey:
Переопределяет метод предка <SCMutableKeyedCollection>.
Метод добавляет в словарь указанную пару ключ-значение.
- Аргументы
-
object | - добавляемое в словарь значение |
key | - ключ добавляемого значения |
- Исключения
-
- Начиная с
- версии 1.2.5
Переопределяет метод предка <SCMutableKeyedCollection>.
Метод устанавливает объекты из указанного списка объектов в соответствии с ключами из заданного списка ключей.
- Аргументы
-
objects | - список объектов |
keys | - список ключей |
- Исключения
-
- (void) setObjectsAndKeys: |
|
(id<SCCollectioning>) |
object |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Метод устанавливает объекты и ключи из указанного списка.
- Аргументы
-
object | - первый элемент списка |
... | - остальные элементы списка |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Исключения
-
Метод устанавливает заданное значение для указанного ключа. Если запись для данного ключа не существует, то она создается, в противном случае значение записи меняется на заданное.
- Аргументы
-
value | - значение для ассоциации с указанным ключем |
key | - ключ значения |
- Исключения
-
- См. также
- - setObject:forKey:
Переопределяет метод предка <SCMutableKeyedCollection>.
Метод устанавливает значения из указанного списка объектов в соответствии с ключами из заданного списка ключей.
- Аргументы
-
values | - список значений |
keys | - список ключей |
- Исключения
-
- (void) setValuesAndKeys: |
|
(id<SCCollectioning>) |
object |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Метод устанавливает значения и ключи из указанного списка.
- Аргументы
-
object | - первый элемент списка |
... | - остальные элементы списка |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Исключения
-
- (id) valueForKey: |
|
(NSString *) |
key |
|
Метод возвращает ассоциированное с заданным ключем значение.
- Аргументы
-
key | - ключ искомого значения |
- Возвращает
- Искомое значение или nil при отсутствии ключа в словаре
- См. также
- - objectForKey:
Переопределяет метод предка <SCKeyedCollection>.
Массив со всеми ключами в словаре или пустой массив если словарь пуст
Массив со всеми значениями в словаре или пустой массив если словарь пуст
- (NSEnumerator *) keyEnumerator |
|
readnonatomicassign |
Счетчик всех ключей в словаре
Объявления и описания членов классов находятся в файлах: