Samond Classes Library 1.2.1-RELEASE build 181
Полный список членов класса
Класс SCDictionary

Класс словарей Подробнее...

#import <SCDictionary.h>

Граф наследования:SCDictionary:
SCCollection SCObject <SCMutableCollection> <SCCollection>

Создание словарей

(instancetype) + dictionaryWithCoder:
 
(instancetype) + dictionaryWithContentsOfSerializedFile:
 
(instancetype) + dictionaryWithDataDictionary:
 
(instancetype) + dictionaryWithDataDictionaryFromFile:
 
(instancetype) + dictionaryWithStream:
 
(instancetype) + dictionaryWithFileStream:
 
(instancetype) + dictionaryWithName:
 
(instancetype) + dictionaryWithObject:forKey:
 
(instancetype) + dictionaryWithObject:
 
(instancetype) + dictionaryWithObjects:forKeys:
 
(instancetype) + dictionaryWithObjects:
 
(instancetype) + dictionaryWithObjectsAndKeys:
 
(instancetype) + dictionaryWithCollection:
 
(instancetype) + dictionaryWithDictionary:
 
(instancetype) + dictionary
 

Инициализация словарей

(instancetype) - initWithName:
 
(instancetype) - initWithObject:forKey:
 
(instancetype) - initWithObject:
 
(instancetype) - initWithObjects:forKeys:
 
(instancetype) - initWithObjects:
 
(instancetype) - initWithObjectsAndKeys:
 
(instancetype) - initWithCollection:
 
(instancetype) - initWithDictionary:
 
(instancetype) - init
 

Копирование словарей

(void) - setDictionary:
 

Сравнение словарей

(BOOL) - isEqualToDictionary:
 
(BOOL) - isEqualToContentsOfDictionary:
 

Добавление и изменение объектов

(void) - setObject:forKey:
 
(void) - setObjects:forKeys:
 
(void) - setObjectsAndKeys:
 
(void) - setValue:forKey:
 
(void) - setValues:forKeys:
 
(void) - setValuesAndKeys:
 

Удаление объектов

(void) - removeObjectForKey:
 
(void) - removeObjectsForKeys:
 

Доступ к объектам

SCArray * allKeys
 
SCArray * allValues
 
(SCArray *) - allKeysForObject:
 
(id) - objectForKey:
 
(id) - valueForKey:
 

Поиск объектов

(BOOL) - containsObjectForKey:
 
(BOOL) - containsStringForKey:
 
(BOOL) - containsNumberForKey:
 
(BOOL) - containsAnyObjectForKeys:
 
(BOOL) - containsAllObjectsForKeys:
 

Счетчики объектов

NSEnumerator * keyEnumerator
 

Дополнительные унаследованные члены

- Методы экземпляра унаследованные от SCCollection
(void) - setCollection:
 
(void) - setObject:
 
(void) - setObjects:
 
(BOOL) - isEqualToCollection:
 
(BOOL) - isEqual:
 
(void) - enumerateWithDelegate:
 
(void) - enumerate
 
(void) - reverseEnumerateWithDelegate:
 
(void) - reverseEnumerate
 
(void) - addObjects:
 
(void) - addCollection:
 
(void) - removeObjectsWithClassName:
 
(void) - removeCollection:
 
(void) - removeObjects:
 
(BOOL) - containsObjects:
 
(BOOL) - containsCollection:
 
(BOOL) - containsAnyObject:
 
(BOOL) - containsAnyObjectFromCollection:
 
(BOOL) - isCollection
 
(BOOL) - isLibraryCollection
 
(BOOL) - isFoundationCollection
 
(BOOL) - isArray
 
(BOOL) - isLibraryArray
 
(BOOL) - isFoundationArray
 
(BOOL) - isSet
 
(BOOL) - isLibrarySet
 
(BOOL) - isFoundationSet
 
(BOOL) - isOrderedSet
 
(BOOL) - isLibraryOrderedSet
 
(BOOL) - isFoundationOrderedSet
 
(BOOL) - isFoundationDictionary
 
(BOOL) - isStack
 
(BOOL) - isQueue
 
(BOOL) - isList
 
(BOOL) - isSortable
 
- Методы экземпляра унаследованные от SCObject
(instancetype) - initWithContentsOfSerializedFile:
 
(BOOL) - writeContentsToSerializedFile:
 
(instancetype) - initWithDataDictionaryFromFile:
 
(void) - writeToDataDictionaryFile:atomically:
 
(void) - writeToDataDictionaryFile:
 
(NSDictionary *) - dataDictionary
 
(instancetype) - initWithFileStream:
 
(void) - writeToFileStream:
 
(void) - appendToFileStream:
 
- Методы экземпляра унаследованные от <SCMutableCollection>
- Методы экземпляра унаследованные от <SCCollection>
- Методы класса унаследованные от SCCollection
(BOOL) + isCollectionClass:
 
(BOOL) + isLibraryCollectionClass:
 
(BOOL) + isFoundationCollectionClass:
 
(BOOL) + isArrayClass:
 
(BOOL) + isLibraryArrayClass:
 
(BOOL) + isFoundationArrayClass:
 
(BOOL) + isSetClass:
 
(BOOL) + isLibrarySetClass:
 
(BOOL) + isFoundationSetClass:
 
(BOOL) + isOrderedSetClass:
 
(BOOL) + isLibraryOrderedSetClass:
 
(BOOL) + isFoundationOrderedSetClass:
 
(BOOL) + isDictionaryClass:
 
(BOOL) + isLibraryDictionaryClass:
 
(BOOL) + isFoundationDictionaryClass:
 
(BOOL) + isStackClass:
 
(BOOL) + isQueueClass:
 
(BOOL) + isListClass:
 
(BOOL) + isSortableClass:
 
(BOOL) + isCollection:
 
(BOOL) + isLibraryCollection:
 
(BOOL) + isFoundationCollection:
 
(BOOL) + isArray:
 
(BOOL) + isLibraryArray:
 
(BOOL) + isFoundationArray:
 
(BOOL) + isSet:
 
(BOOL) + isLibrarySet:
 
(BOOL) + isFoundationSet:
 
(BOOL) + isOrderedSet:
 
(BOOL) + isLibraryOrderedSet:
 
(BOOL) + isFoundationOrderedSet:
 
(BOOL) + isDictionary:
 
(BOOL) + isLibraryDictionary:
 
(BOOL) + isFoundationDictionary:
 
(BOOL) + isStack:
 
(BOOL) + isQueue:
 
(BOOL) + isList:
 
(BOOL) + isSortable:
 
- Свойства унаследованные от SCCollection
NSString * name
 
BOOL readOnly
 
id< SCCollectionDelegate > delegate
 
SCIndex count
 
BOOL empty
 
NSString * typeName
 
NSString * description
 
NSEnumerator * objectEnumerator
 
NSEnumerator * reverseObjectEnumerator
 
- Свойства унаследованные от <SCCollection>
NSString * name
 
SCIndex count
 
BOOL empty
 
NSString * description
 
SCArray * array
 
SCSet * set
 
SCOrderedSet * orderedSet
 
SCDictionary * dictionary
 
SCStack * stack
 
SCQueue * queue
 
SCUnidirectionalList * unidirectionalList
 
SCBidirectionalList * bidirectionalList
 
NSArray * foundationArray
 
NSSet * foundationSet
 
NSOrderedSet * foundationOrderedSet
 
NSDictionary * foundationDictionary
 
NSEnumerator * objectEnumerator
 

Подробное описание

Класс словарей

SDK
macOS 10.6+, iOS 7.0+, GNUstep
Начиная с
версии 1.1.3

Реализует представление коллекции, доступ к элементам которой осуществляется по строковым ключам. Класс также поддерживает древовидную структуру данных.
При работе класса возможно возникновение следующих ошибок:

Документация метода

- (SCArray *) allKeysForObject: (id<SCCollectioning>)  object

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

Аргументы
object- искомый объект
Возвращает
Массив с соответствующими искомому объекту ключами или пустой массив при отсутствии объекта в словаре
- (BOOL) containsAllObjectsForKeys: (id<SCCollection>)  keys

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

Аргументы
keys- список ключей
Возвращает
YES при наличии в словаре всех искомых объектов и NO в противном случае
- (BOOL) containsAnyObjectForKeys: (id<SCCollection>)  keys

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

Аргументы
keys- список ключей
Возвращает
YES при наличии хотя бы одного объекта и NO в противном случае
- (BOOL) containsNumberForKey: (NSString *)  key

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

Аргументы
key- ключ искомого числового объекта
Возвращает
YES при наличии в словаре числового объекта с искомым ключем и NO в противном случае
- (BOOL) containsObjectForKey: (NSString *)  key

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

Аргументы
key- ключ искомого объекта
Возвращает
YES при наличии в словаре объекта с искомым ключем и NO в противном случае
- (BOOL) containsStringForKey: (NSString *)  key

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

Аргументы
key- ключ искомой строки
Возвращает
YES при наличии в словаре строки с искомым ключем и NO в противном случае
+ (instancetype) dictionary

Классовый метод создает неименованный словарь.

Возвращает
Созданный словарь

Переопределяет метод предка SCCollection.

+ (instancetype) dictionaryWithCoder: (NSCoder *)  coder

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

Аргументы
coder- исходный кодировщик данных
Возвращает
Созданный словарь
+ (instancetype) dictionaryWithCollection: (id<SCCollection>)  collection

Классовый метод создает словарь с объектами из указанной коллекции.

Аргументы
collection- исходная коллекция
Возвращает
Созданный словарь
Исключения
SCCollectionException- обнаружена ошибка коллекции
+ (instancetype) dictionaryWithContentsOfSerializedFile: (NSString *)  path

Классовый метод создает словарь с использованием данных из стандартного последовательного файла с заданным путем.

Аргументы
path- путь к исходному стандартному последовательному файлу
Возвращает
Созданный словарь
+ (instancetype) dictionaryWithDataDictionary: (NSDictionary *)  dictionary

Классовый метод создает словарь на основании данных из указанного словаря.

Аргументы
dictionary- словарь с исходными данными
Возвращает
Созданный словарь
+ (instancetype) dictionaryWithDataDictionaryFromFile: (NSString *)  path

Классовый метод создает словарь на основании данных словаря из указанного файла.

Аргументы
path- путь к файлу словаря
Возвращает
Созданный словарь
+ (instancetype) dictionaryWithDictionary: (SCDictionary *)  dictionary

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

Аргументы
dictionary- исходный словарь
Возвращает
Созданный словарь
Исключения
SCCollectionException- обнаружена ошибка коллекции
+ (instancetype) dictionaryWithFileStream: (NSString *)  path

Классовый метод создает словарь с использованием данных из указанного файлового потока.

Аргументы
path- путь к файлу потока
Возвращает
Созданный словарь
Исключения
SCStreamException- ошибка в ходе операции с потоком
SCSystemException- системная ошибка
+ (instancetype) dictionaryWithName: (NSString *)  name

Классовый метод создает словарь с указанным именем.

Аргументы
name- имя словаря
Возвращает
Созданный словарь
+ (instancetype) dictionaryWithObject: (id<SCCollectioning>)  object

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

Аргументы
object- добавляемый объект
Возвращает
Созданный словарь
+ (instancetype) dictionaryWithObject: (id<SCCollectioning>)  object
forKey: (NSString *)  key 

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

Аргументы
object- добавляемый объект
key- ключ добавляемого объекта
Возвращает
Созданный словарь
+ (SCDictionary *) dictionaryWithObjects: (id<SCCollectioning>)  object
,   NS_REQUIRES_NIL_TERMINATION 

Классовый метод создает словарь с объектами из указанного списка.

Аргументы
object- первый добавляемый объект
...- остальные добавляемые объекты
NS_REQUIRES_NIL_TERMINATION- завершающий список нулевой указатель nil
Возвращает
Созданный словарь
+ (instancetype) dictionaryWithObjects: (id<SCCollection>)  objects
forKeys: (id<SCCollection>)  keys 

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

Аргументы
objects- добавляемые в словарь объекты
keys- ключи добавляемых в словарь объектов
Возвращает
Созданный словарь
+ (instancetype) dictionaryWithObjectsAndKeys: (id<SCCollectioning>)  object
,   NS_REQUIRES_NIL_TERMINATION 

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

Аргументы
object- первый элемент списка
...- остальные добавляемые объекты
NS_REQUIRES_NIL_TERMINATION- завершающий список нулевой указатель nil
Возвращает
Созданный словарь
+ (instancetype) dictionaryWithStream: (SCStream *)  stream

Классовый метод создает словарь с использованием данных из указанного потока.

Аргументы
stream- поток для чтения данных словаря
Возвращает
Созданный словарь
Исключения
SCStreamException- ошибка в ходе операции с потоком
SCSystemException- системная ошибка
- (instancetype) init

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

Возвращает
Инициализированный словарь
- (instancetype) initWithCollection: (id<SCCollection>)  collection

Метод инициализирует словарь с объектами из указанной коллекции.

Аргументы
collection- исходная коллекция
Возвращает
Инициализированный словарь
Исключения
SCCollectionException- обнаружена ошибка коллекции

Переопределяет метод предка SCCollection.

- (instancetype) initWithDictionary: (SCDictionary *)  dictionary

Метод инициализирует копию указанного словаря.

Внимание
Является назначенным инициализатором класса
Аргументы
dictionary- исходный словарь
Возвращает
Инициализированный словарь
Исключения
SCCollectionException- обнаружена ошибка коллекции
- (instancetype) initWithName: (NSString *)  name

Метод инициализирует словарь с указанным именем.

Внимание
Является назначенным инициализатором класса
Аргументы
name- имя словаря
Возвращает
Инициализированный словарь
- (instancetype) initWithObject: (id<SCCollectioning>)  object

Метод инициализирует словарь с одной записью из указанного объекта.

Аргументы
object- добавляемый объект
Возвращает
Инициализированный словарь
- (instancetype) initWithObject: (id<SCCollectioning>)  object
forKey: (NSString *)  key 

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

Аргументы
object- добавляемый объект
key- ключ добавляемого объекта
Возвращает
Инициализированный словарь
- (instancetype) initWithObjects: (id<SCCollectioning>)  object
,   NS_REQUIRES_NIL_TERMINATION 

Метод инициализирует словарь с объектами из указанного списка.

Аргументы
object- первый добавляемый объект
...- остальные добавляемые объекты
NS_REQUIRES_NIL_TERMINATION- завершающий список нулевой указатель nil
Возвращает
Инициализированный словарь
- (instancetype) initWithObjects: (id<SCCollection>)  objects
forKeys: (id<SCCollection>)  keys 

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

Аргументы
objects- добавляемые в словарь объекты
keys- ключи добавляемых в словарь объектов
Возвращает
Инициализированный словарь
- (instancetype) initWithObjectsAndKeys: (id<SCCollectioning>)  object
,   NS_REQUIRES_NIL_TERMINATION 

Метод инициализирует словарь с объектами и ключами из указанного списка.

Аргументы
object- первый элемент списка
...- остальные добавляемые объекты
NS_REQUIRES_NIL_TERMINATION- завершающий список нулевой указатель nil
Возвращает
Инициализированный словарь
- (BOOL) isEqualToContentsOfDictionary: (SCDictionary *)  dictionary

Метод выполняет сравнение содержимого словаря с содержимым указанного словаря.

Аргументы
dictionary- словарь для сравнения
Возвращает
YES если содержимое словарей совпадает и NO в противном случае
- (BOOL) isEqualToDictionary: (SCDictionary *)  dictionary

Метод выполняет сравнение содержимого и параметров словаря с содержимым и параметрами указанного словаря.

Аргументы
dictionary- словарь для сравнения
Возвращает
YES если содержимое и параметры словарей совпадают и NO в противном случае
- (id) objectForKey: (NSString *)  key

Метод возвращает соответствующий указанному ключу объект.

Аргументы
key- ключ искомого объекта
Возвращает
Соответствующий ключу объект или nil при отсутствии ключа в словаре
См. также
- valueForKey:
- (void) removeObjectForKey: (NSString *)  key

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

Аргументы
key- ключ удаляемого объекта
Исключения
SCCollectionException- обнаружена ошибка коллекции
- (void) removeObjectsForKeys: (SCArray *)  keys

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

Аргументы
keys- массив с ключами удаляемых объектов
Исключения
SCCollectionException- обнаружена ошибка коллекции
- (void) setDictionary: (SCDictionary *)  dictionary

Метод замещает содержимое и настройки словаря содержимым и настройками указанного словаря.

Аргументы
dictionary- исходный словарь
Исключения
SCCollectionException- обнаружена ошибка коллекции
- (void) setObject: (id<SCCollectioning>)  object
forKey: (NSString *)  key 

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

Аргументы
object- объект для ассоциации с указанным ключем
key- ключ объекта
Исключения
SCCollectionException- обнаружена ошибка коллекции
См. также
- setValue:forKey:
- (void) setObjects: (id<SCCollection>)  objects
forKeys: (id<SCCollection>)  keys 

Метод устанавливает объекты из указанного списка объектов в соответствии с ключами из заданного списка ключей.

Аргументы
objects- список объектов
keys- список ключей
Исключения
SCCollectionException- обнаружена ошибка коллекции
- (void) setObjectsAndKeys: (id<SCCollectioning>)  object
,   NS_REQUIRES_NIL_TERMINATION 

Метод устанавливает объекты и ключи из указанного списка.

Аргументы
object- первый элемент списка
...- остальные элементы списка
NS_REQUIRES_NIL_TERMINATION- завершающий список нулевой указатель nil
Исключения
SCCollectionException- обнаружена ошибка коллекции
- (void) setValue: (id<SCCollectioning>)  value
forKey: (NSString *)  key 

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

Аргументы
value- значение для ассоциации с указанным ключем
key- ключ значения
Исключения
SCCollectionException- обнаружена ошибка коллекции
См. также
- setObject:forKey:
- (void) setValues: (id<SCCollection>)  values
forKeys: (id<SCCollection>)  keys 

Метод устанавливает значения из указанного списка объектов в соответствии с ключами из заданного списка ключей.

Аргументы
values- список значений
keys- список ключей
Исключения
SCCollectionException- обнаружена ошибка коллекции
- (void) setValuesAndKeys: (id<SCCollectioning>)  object
,   NS_REQUIRES_NIL_TERMINATION 

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

Аргументы
object- первый элемент списка
...- остальные элементы списка
NS_REQUIRES_NIL_TERMINATION- завершающий список нулевой указатель nil
Исключения
SCCollectionException- обнаружена ошибка коллекции
- (id) valueForKey: (NSString *)  key

Метод возвращает ассоциированное с заданным ключем значение.

Аргументы
key- ключ искомого значения
Возвращает
Искомое значение или nil при отсутствии ключа в словаре
См. также
- objectForKey:

Полный список свойств

- (SCArray *) allKeys
readnonatomicretain

Массив со всеми ключами в словаре или пустой массив если словарь пуст

- (SCArray *) allValues
readnonatomicretain

Массив со всеми значениями в словаре или пустой массив если словарь пуст

- (NSEnumerator *) keyEnumerator
readnonatomicretain

Счетчик всех ключей в словаре

Объявления и описания членов классов находятся в файлах:
Документация по Samond Classes Library 1.2.1-RELEASE build 181. Последние изменения: Пн 10 Апр 2017 15:23:04. Создано системой   doxygen 1.8.9.1