SCDictionary.h

Go to the documentation of this file.

//
//  SCDictionary.h
//  scl
//
//  Created by Viacheslav Smolensky on 13.04.12.
//  Copyright (c) 2007 - 2017 by Samond Development Corporation. All rights reserved.
//

#import <scl/SCCollection.h>

#pragma mark -
#pragma mark Константы класса

#define SCDictionaryClass           @"SCDictionary" 
#define SC_KEY_DICTIONARY_LIST      @"Dictionary"
#define SC_KEY_DICTIONARY_ITEM      @"Item %llu"
#define SC_KEY_DICTIONARY_ITEM_KEY  @"Key %llu"
#define SC_KEY_DICTIONARY_COUNT     @"Count"

@interface SCDictionary : SCCollection {
    NSMutableDictionary *fDictionary;   // Внутреннее представление словаря
}

@property (nonatomic, retain, readonly, getter=allKeys) SCArray *allKeys;

@property (nonatomic, retain, readonly, getter=allValues) SCArray *allValues;

@property (nonatomic, retain, readonly, getter=keyEnumerator) NSEnumerator *keyEnumerator;

#pragma mark -
#pragma mark Создание словарей
+ (SCDictionary *)dictionaryWithCoder:(NSCoder *)coder;
+ (SCDictionary *)dictionaryWithContentsOfSerializedFile:(NSString *)path;
+ (SCDictionary *)dictionaryWithDataDictionary:(NSDictionary *)dictionary;
+ (SCDictionary *)dictionaryWithDataDictionaryFromFile:(NSString *)path;
+ (SCDictionary *)dictionaryWithStream:(SCStream *)stream;
+ (SCDictionary *)dictionaryWithFileStream:(NSString *)path;

+ (SCDictionary *)dictionaryWithName:(NSString *)name;
+ (SCDictionary *)dictionaryWithObject:(id)object forKey:(NSString *)key;
+ (SCDictionary *)dictionaryWithObject:(id)object;
+ (SCDictionary *)dictionaryWithObjects:(id)objects forKeys:(id)keys;
+ (SCDictionary *)dictionaryWithObjects:(id)object, ... NS_REQUIRES_NIL_TERMINATION;
+ (SCDictionary *)dictionaryWithObjectsAndKeys:(id)object, ... NS_REQUIRES_NIL_TERMINATION;
+ (SCDictionary *)dictionaryWithCollection:(id)collection;
+ (SCDictionary *)dictionaryWithDictionary:(SCDictionary *)dictionary;
+ (SCDictionary *)dictionary;

#pragma mark -
#pragma mark Инициализация словарей
- (id)initWithName:(NSString *)name;
- (id)initWithObject:(id)object forKey:(NSString *)key;
- (id)initWithObject:(id)object;
- (id)initWithObjects:(id)objects forKeys:(id)keys;
- (id)initWithObjects:(id)object, ... NS_REQUIRES_NIL_TERMINATION;
- (id)initWithObjectsAndKeys:(id)object, ... NS_REQUIRES_NIL_TERMINATION;
- (id)initWithCollection:(id)collection;
- (id)initWithDictionary:(SCDictionary *)dictionary;
- (id)init;

#pragma mark -
#pragma mark Копирование словарей
- (void)setDictionary:(SCDictionary *)dictionary;

#pragma mark -
#pragma mark Сравнение словарей
- (BOOL)isEqualToDictionary:(SCDictionary *)dictionary;
- (BOOL)isEqualToContentsOfDictionary:(SCDictionary *)dictionary;

#pragma mark -
#pragma mark Добавление и изменение объектов
- (void)setObject:(id)object forKey:(NSString *)key;
- (void)setByte:(SCByte)value forKey:(NSString *)key;
- (void)setUByte:(SCUByte)value forKey:(NSString *)key;
- (void)setShort:(SCShort)value forKey:(NSString *)key;
- (void)setUShort:(SCUShort)value forKey:(NSString *)key;
- (void)setInteger:(SCInteger)value forKey:(NSString *)key;
- (void)setUInteger:(SCUInteger)value forKey:(NSString *)key;
- (void)setLong:(SCLong)value forKey:(NSString *)key;
- (void)setULong:(SCULong)value forKey:(NSString *)key;
- (void)setChar:(char)value forKey:(NSString *)key;
- (void)setUnichar:(unichar)value forKey:(NSString *)key;
- (void)setCharString:(const char *)string forKey:(NSString *)key;
- (void)setBool:(BOOL)value forKey:(NSString *)key;
- (void)setFloat:(SCFloat)value forKey:(NSString *)key;
- (void)setDouble:(SCDouble)value forKey:(NSString *)key;
- (void)setObjects:(id)objects forKeys:(id)keys;
- (void)setObjectsAndKeys:(id)object, ... NS_REQUIRES_NIL_TERMINATION;

- (void)setValue:(id)value forKey:(NSString *)key;
- (void)setByteValue:(SCByte)value forKey:(NSString *)key;
- (void)setUByteValue:(SCUByte)value forKey:(NSString *)key;
- (void)setShortValue:(SCShort)value forKey:(NSString *)key;
- (void)setUShortValue:(SCUShort)value forKey:(NSString *)key;
- (void)setIntegerValue:(SCInteger)value forKey:(NSString *)key;
- (void)setUIntegerValue:(SCUInteger)value forKey:(NSString *)key;
- (void)setLongValue:(SCLong)value forKey:(NSString *)key;
- (void)setULongValue:(SCULong)value forKey:(NSString *)key;
- (void)setCharValue:(char)value forKey:(NSString *)key;
- (void)setUnicharValue:(unichar)value forKey:(NSString *)key;
- (void)setCharStringValue:(const char *)value forKey:(NSString *)key;
- (void)setBoolValue:(BOOL)value forKey:(NSString *)key;
- (void)setFloatValue:(SCFloat)value forKey:(NSString *)key;
- (void)setDoubleValue:(SCDouble)value forKey:(NSString *)key;
- (void)setValues:(id)values forKeys:(id)keys;
- (void)setValuesAndKeys:(id)object, ... NS_REQUIRES_NIL_TERMINATION;

#pragma mark -
#pragma mark Удаление объектов
- (void)removeObjectForKey:(NSString *)key;
- (void)removeObjectsForKeys:(SCArray *)keys;

#pragma mark -
#pragma mark Доступ к объектам
- (SCArray *)allKeys;
- (SCArray *)allValues;
- (SCArray *)allKeysForObject:(id)object;

- (id)objectForKey:(NSString *)key;
- (NSString *)stringForKey:(NSString *)key;
- (NSNumber *)numberForKey:(NSString *)key;
- (SCByte)byteForKey:(NSString *)key;
- (SCUByte)uByteForKey:(NSString *)key;
- (SCShort)shortForKey:(NSString *)key;
- (SCUShort)uShortForKey:(NSString *)key;
- (SCInteger)integerForKey:(NSString *)key;
- (SCUInteger)uIntegerForKey:(NSString *)key;
- (SCLong)longForKey:(NSString *)key;
- (SCULong)uLongForKey:(NSString *)key;
- (char)charForKey:(NSString *)key;
- (unichar)unicharForKey:(NSString *)key;
- (const char *)charStringForKey:(NSString *)key;
- (BOOL)boolForKey:(NSString *)key;
- (SCFloat)floatForKey:(NSString *)key;
- (SCDouble)doubleForKey:(NSString *)key;

- (id)valueForKey:(NSString *)key;
- (NSString *)stringValueForKey:(NSString *)key;
- (NSNumber *)numberValueForKey:(NSString *)key;
- (SCByte)byteValueForKey:(NSString *)key;
- (SCUByte)uByteValueForKey:(NSString *)key;
- (SCShort)shortValueForKey:(NSString *)key;
- (SCUShort)uShortValueForKey:(NSString *)key;
- (SCInteger)integerValueForKey:(NSString *)key;
- (SCUInteger)uIntegerValueForKey:(NSString *)key;
- (SCLong)longValueForKey:(NSString *)key;
- (SCULong)uLongValueForKey:(NSString *)key;
- (char)charValueForKey:(NSString *)key;
- (unichar)unicharValueForKey:(NSString *)key;
- (const char *)charStringValueForKey:(NSString *)key;
- (BOOL)boolValueForKey:(NSString *)key;
- (SCFloat)floatValueForKey:(NSString *)key;
- (SCDouble)doubleValueForKey:(NSString *)key;

#pragma mark -
#pragma mark Поиск объектов
- (BOOL)containsObjectForKey:(NSString *)key;
- (BOOL)containsStringForKey:(NSString *)key;
- (BOOL)containsNumberForKey:(NSString *)key;
- (BOOL)containsAnyObjectForKeys:(id)keys;
- (BOOL)containsAllObjectsForKeys:(id)keys;

#pragma mark -
#pragma mark Счетчики объектов
- (NSEnumerator *)keyEnumerator;

@end