Samond Classes Library 1.1.6-RELEASE build 132

SCConfig Class Reference

Basic configuration class. More...

#import <SCConfig.h>

Inheritance diagram for SCConfig:
SCObject <SCDictionaryObjectProtocol> <SCCodingProtocol> <SCStreamProtocol> <SCCollectionProtocol> SCCommandLine SCConfigDictionary SCConfigFile SCConfiguration SCEnvironment SCUserDefaults SCWebConfig

List of all members.

Public Member Functions

Getting and Setting Configuration Properties
(NSString *) - name
(SCConfigStatus) - status
(SCULong) - count
(SCULong) - fullCount
(BOOL) - isReadOnly
(BOOL) - isEmpty
(id< SCConfigDelegate >) - delegate
(NSString *) - description
(BOOL) - isModified
(BOOL) - isUnique
(BOOL) - caseInsensitive
(BOOL) - isIgnoreErrors
(BOOL) - isAutoCreate
(SCConfigException *) - error
(void) - setName:
(void) - setReadOnly:
(void) - setDelegate:
(void) - setUnique:
(void) - setCaseInsensitive:
(void) - setIgnoreErrors:
(void) - setAutoCreate:
Setting and Copying Configurations
(void) - setConfig:
(void) - setCollection:
(void) - setText:
Find Keys in Configuration
(BOOL) - containsValueForKey:
(BOOL) - containsStringValueForKey:
(BOOL) - containsNumberValueForKey:
(BOOL) - containsBoolValueForKey:
(BOOL) - containsDateValueForKey:
(BOOL) - containsValue:
(BOOL) - containsStringValue:
(BOOL) - containsNumberValue:
(BOOL) - containsBoolValue:
(BOOL) - containsDateValue:
(BOOL) - containsByteValue:
(BOOL) - containsUnsignedByteValue:
(BOOL) - containsShortValue:
(BOOL) - containsUnsignedShortValue:
(BOOL) - containsIntValue:
(BOOL) - containsUnsignedIntValue:
(BOOL) - containsLongValue:
(BOOL) - containsUnsignedLongValue:
(BOOL) - containsCharValue:
(BOOL) - containsUnicharValue:
(BOOL) - containsCharStringValue:
(BOOL) - containsFloatValue:
(BOOL) - containsDoubleValue:
(BOOL) - containsValue:forKey:
(BOOL) - containsStringValue:forKey:
(BOOL) - containsNumberValue:forKey:
(BOOL) - containsBoolValue:forKey:
(BOOL) - containsDateValue:forKey:
(BOOL) - containsByteValue:forKey:
(BOOL) - containsUnsignedByteValue:forKey:
(BOOL) - containsShortValue:forKey:
(BOOL) - containsUnsignedShortValue:forKey:
(BOOL) - containsIntValue:forKey:
(BOOL) - containsUnsignedIntValue:forKey:
(BOOL) - containsLongValue:forKey:
(BOOL) - containsUnsignedLongValue:forKey:
(BOOL) - containsCharValue:forKey:
(BOOL) - containsUnicharValue:forKey:
(BOOL) - containsCharStringValue:forKey:
(BOOL) - containsFloatValue:forKey:
(BOOL) - containsDoubleValue:forKey:
(SCULong) - stringValuesCount
(SCULong) - numberValuesCount
(SCULong) - boolValuesCount
(SCULong) - dateValuesCount
(SCULong) - configValuesCount
(SCULong) - countValuesForKey:
(SCULong) - countStringValuesForKey:
(SCULong) - countNumberValuesForKey:
(SCULong) - countBoolValuesForKey:
(SCULong) - countDateValuesForKey:
(SCULong) - countValue:
(SCULong) - countStringValue:
(SCULong) - countNumberValue:
(SCULong) - countBoolValue:
(SCULong) - countDateValue:
(SCULong) - countByteValue:
(SCULong) - countUnsignedByteValue:
(SCULong) - countShortValue:
(SCULong) - countUnsignedShortValue:
(SCULong) - countIntValue:
(SCULong) - countUnsignedIntValue:
(SCULong) - countLongValue:
(SCULong) - countUnsignedLongValue:
(SCULong) - countCharValue:
(SCULong) - countUnicharValue:
(SCULong) - countCharStringValue:
(SCULong) - countFloatValue:
(SCULong) - countDoubleValue:
Comparing Configurations
(BOOL) - isEqualToConfig:
(BOOL) - isEqualToContentOfConfig:
(BOOL) - isEqualToCollection:
(BOOL) - isEqualToText:
(BOOL) - isEqualTo:
(BOOL) - isEqual:
Enumerating Configurations
(NSEnumerator *) - keyEnumerator
Converting Configurations
(SCArray *) - array
(SCDictionary *) - dictionary
(SCStrings *) - textWithSpace:
(SCStrings *) - text
(NSArray *) - foundationArray
(NSDictionary *) - foundationDictionary
Adding and Setting Configuration Values
(void) - addValue:forKey:
(void) - addStringValue:forKey:
(void) - addNumberValue:forKey:
(void) - addBoolValue:forKey:
(void) - addDateValue:forKey:
(void) - addString:
(void) - addByteValue:forKey:
(void) - addUnsignedByteValue:forKey:
(void) - addShortValue:forKey:
(void) - addUnsignedShortValue:forKey:
(void) - addIntValue:forKey:
(void) - addUnsignedIntValue:forKey:
(void) - addLongValue:forKey:
(void) - addUnsignedLongValue:forKey:
(void) - addCharValue:forKey:
(void) - addUnicharValue:forKey:
(void) - addCharStringValue:forKey:
(void) - addFloatValue:forKey:
(void) - addDoubleValue:forKey:
(void) - setValue:forKey:
(void) - setStringValue:forKey:
(void) - setNumberValue:forKey:
(void) - setBoolValue:forKey:
(void) - setDateValue:forKey:
(void) - setByteValue:forKey:
(void) - setUnsignedByteValue:forKey:
(void) - setShortValue:forKey:
(void) - setUnsignedShortValue:forKey:
(void) - setIntValue:forKey:
(void) - setUnsignedIntValue:forKey:
(void) - setLongValue:forKey:
(void) - setUnsignedLongValue:forKey:
(void) - setCharValue:forKey:
(void) - setUnicharValue:forKey:
(void) - setCharStringValue:forKey:
(void) - setFloatValue:forKey:
(void) - setDoubleValue:forKey:
(void) - setValue:forKey:withValue:
(void) - setStringValue:forKey:withStringValue:
(void) - setNumberValue:forKey:withNumberValue:
(void) - setBoolValue:forKey:withBoolValue:
(void) - setDateValue:forKey:withDateValue:
(void) - setByteValue:forKey:withLongValue:
(void) - setUnsignedByteValue:forKey:withLongValue:
(void) - setShortValue:forKey:withLongValue:
(void) - setUnsignedShortValue:forKey:withLongValue:
(void) - setIntValue:forKey:withLongValue:
(void) - setUnsignedIntValue:forKey:withLongValue:
(void) - setLongValue:forKey:withLongValue:
(void) - setUnsignedLongValue:forKey:withLongValue:
(void) - setCharValue:forKey:withCharValue:
(void) - setUnicharValue:forKey:withUnicharValue:
(void) - setCharStringValue:forKey:withCharStringValue:
(void) - setFloatValue:forKey:withFloatValue:
(void) - setDoubleValue:forKey:withDoubleValue:
Add Values from Existing Configurations
(void) - addValuesFromConfig:
(void) - addValuesFromCollection:
(void) - addValuesFromText:
Removing Keys
(void) - removeValuesForKey:
(void) - removeValuesForKeys:
(void) - removeValuesForKeysFromArray:
(void) - removeAllValues
(void) - removeValue:forKey:
(void) - removeStringValue:forKey:
(void) - removeNumberValue:forKey:
(void) - removeBoolValue:forKey:
(void) - removeDateValue:forKey:
(void) - removeByteValue:forKey:
(void) - removeUnsignedByteValue:forKey:
(void) - removeShortValue:forKey:
(void) - removeUnsignedShortValue:forKey:
(void) - removeIntValue:forKey:
(void) - removeUnsignedIntValue:forKey:
(void) - removeLongValue:forKey:
(void) - removeUnsignedLongValue:forKey:
(void) - removeCharValue:forKey:
(void) - removeUnicharValue:forKey:
(void) - removeCharStringValue:forKey:
(void) - removeFloatValue:forKey:
(void) - removeDoubleValue:forKey:
Accessing Keys and Values
(SCArray *) - allKeys
(id) - valueForKey:
(NSString *) - stringValueForKey:
(NSNumber *) - numberValueForKey:
(BOOL) - boolValueForKey:
(NSDate *) - dateValueForKey:
(SCByte) - byteValueForKey:
(SCUByte) - unsignedByteValueForKey:
(SCShort) - shortValueForKey:
(SCUShort) - unsignedShortValueForKey:
(SCInteger) - intValueForKey:
(SCUInteger) - unsignedIntValueForKey:
(SCLong) - longValueForKey:
(SCULong) - unsignedLongValueForKey:
(char) - charValueForKey:
(unichar) - unicharValueForKey:
(const char *) - charStringValueForKey:
(SCFloat) - floatValueForKey:
(SCDouble) - doubleValueForKey:
(SCConfigRecordType) - typeForKey:
(NSString *) - typeNameForKey:
(BOOL) - isStringValueForKey:
(BOOL) - isNumberValueForKey:
(BOOL) - isBoolValueForKey:
(BOOL) - isDateValueForKey:
(BOOL) - isConfigValueForKey:
(SCArray *) - valuesForKey:
(SCArray *) - valuesForKeys:
(SCArray *) - valuesForKeysFromArray:
(NSString *) - keyForValue:
(NSString *) - keyForStringValue:
(NSString *) - keyForNumberValue:
(NSString *) - keyForBoolValue:
(NSString *) - keyForDateValue:
(NSString *) - keyForByteValue:
(NSString *) - keyForUnsignedByteValue:
(NSString *) - keyForShortValue:
(NSString *) - keyForUnsignedShortValue:
(NSString *) - keyForIntValue:
(NSString *) - keyForUnsignedIntValue:
(NSString *) - keyForLongValue:
(NSString *) - keyForUnsignedLongValue:
(NSString *) - keyForCharValue:
(NSString *) - keyForUnicharValue:
(NSString *) - keyForCharString:
(NSString *) - keyForFloatValue:
(NSString *) - keyForDoubleValue:
Subconfiguration Access Methods
(BOOL) - containsConfigForKey:
(void) - createConfigForKey:
(void) - removeConfigForKey:
(SCConfig *) - configForKey:
(void) - addConfig:forKey:
(void) - setConfig:forKey:
Configuration Validation Methods
(BOOL) - isValidConfigForKey:
(BOOL) - isValidKey:
(BOOL) - isValidType:forKey:
(BOOL) - isValidValue:forKey:
(BOOL) - isAllowedDuplicateValueForKey:
(NSString *) - keyNameForKey:
(SCArray *) - validKeys
(SCArray *) - validTypes
(SCArray *) - validTypesForKey:
(SCArray *) - validValues
(SCArray *) - validValuesForKey:
(SCArray *) - duplicatedKeys
(SCArray *) - mandatoryKeys
(SCArray *) - defaultValues
(SCArray *) - keyNames
(void) - addValidKey:
(void) - addValidType:forKey:
(void) - addValidValue:forKey:
(void) - addAllowedDuplicateKey:
(void) - addMandatoryKey:
(void) - addDefaultValue:withType:forKey:
(void) - addKeyName:forKey:
(void) - removeValidKey:
(void) - removeValidType:forKey:
(void) - removeValidTypesForKey:
(void) - removeValidValue:forKey:
(void) - removeValidValuesForKey:
(void) - removeValidDuplicateKey:
(void) - removeMandatoryKey:
(void) - removeDefaultValueForKey:
(void) - removeNameForKey:
(void) - removeValidKeys
(void) - removeValidTypes
(void) - removeValidValues
(void) - removeAllowedDuplicateKeys
(void) - removeMandatoryKeys
(void) - removeDefaultValues
(void) - removeKeyNames
(BOOL) - containsValidKey:
(BOOL) - containsValidType:forKey:
(BOOL) - containsValidTypesForKey:
(BOOL) - containsValidValue:forKey:
(BOOL) - containsValidValuesForKey:
(BOOL) - containsDuplicateKey:
(BOOL) - containsMandatoryKey:
(BOOL) - containsDefaultValueForKey:
(BOOL) - containsNameForKey:
(id) - defaultValueForKey:
(SCConfigRecordType) - defaultTypeForKey:
(NSString *) - nameForKey:
(void) - addDefaultValues
(BOOL) - checkMandatoryKeys
Additional methods
(void) - removeConfiguration
(void) - resetConfiguration

Creating and Initializing Configurations

(SCConfig *) + configWithCoder:
(SCConfig *) + configWithContentsOfSerializedFile:
(SCConfig *) + configWithDataDictionary:
(SCConfig *) + configWithDataDictionaryFromFile:
(SCConfig *) + configWithStream:
(SCConfig *) + configWithFileStream:
(SCConfig *) + configWithName:delegate:unique:caseInsensitive:ignoreErrors:autoCreate:
(SCConfig *) + configWithName:string:
(SCConfig *) + configWithName:strings:
(SCConfig *) + configWithName:
(SCConfig *) + config
(SCConfig *) + configWithString:
(SCConfig *) + configWithStrings:
(SCConfig *) + configWithConfig:
(SCConfig *) + configWithCollection:
(SCConfig *) + configWithText:
(id) - initWithName:delegate:unique:caseInsensitive:ignoreErrors:autoCreate:
(id) - initWithName:string:
(id) - initWithName:strings:
(id) - initWithName:
(id) - init
(id) - initWithString:
(id) - initWithStrings:
(id) - initWithConfig:
(id) - initWithCollection:
(id) - initWithText:

Detailed Description

Basic configuration class.

Class implements the basic functions of the configuration subsystem.
Class was introduced in version 1.2.0.

Class declares the following properties:

Member Function Documentation

- (void) addAllowedDuplicateKey: (NSString *)  key

Adds the specified key into the allowed duplicate list.

Parameters:
key- record key
- (void) addBoolValue: (BOOL)  boolValue
forKey: (NSString *)  key 

Adds the specified boolean value for a given key.

Parameters:
boolValue- boolean value for the specified key
key- a key for the specified boolean value
Exceptions:
SCConfigException- configuration error detected
- (void) addByteValue: (SCByte)  byteValue
forKey: (NSString *)  key 

Adds the specified signed byte value for a given key.

Parameters:
byteValue- signed byte value for the specified key
key- a key for the specified byte value
Exceptions:
SCConfigException- configuration error detected
- (void) addCharStringValue: (const char *)  charStringValue
forKey: (NSString *)  key 

Add the specified character string value for a given key.

Parameters:
charStringValue- character string value for the specified key
key- a key for the specified character string value
Exceptions:
SCConfigException- configuration error detected
- (void) addCharValue: (char)  charValue
forKey: (NSString *)  key 

Adds the specified char value for a given key.

Parameters:
charValue- char value for the specified key
key- a key for the specified char value
Exceptions:
SCConfigException- configuration error detected
- (void) addConfig: (SCConfig *)  config
forKey: (NSString *)  key 

Adds the specified existing configuration into the receiving configuration as a subconfiguration for a given key.

Parameters:
config- added existing configuration
key- added subconfiguration key
Exceptions:
SCConfigException- configuration error detected
- (void) addDateValue: (NSDate *)  dateValue
forKey: (NSString *)  key 

Adds the specified date value for a given key.

Parameters:
dateValue- date value for the specified key
key- a key for the specified date value
Exceptions:
SCConfigException- configuration error detected
- (void) addDefaultValue: (id)  value
withType: (SCConfigRecordType)  type
forKey: (NSString *)  key 

Add into the default values list the record with the specified value, type and key.

Parameters:
value- default record value
type- default record type
key- default record key
- (void) addDefaultValues

Adds into the receiving configuration the default values if the corresponding records do not exists in the configuration.

Exceptions:
SCConfigException- configuration error detected
- (void) addDoubleValue: (SCDouble)  doubleValue
forKey: (NSString *)  key 

Adds the specified double value for a given key.

Parameters:
doubleValue- double value for the specified key
key- a key for the specified double value
Exceptions:
SCConfigException- configuration error detected
- (void) addFloatValue: (SCFloat)  floatValue
forKey: (NSString *)  key 

Adds the specified float value for a given key.

Parameters:
floatValue- float value for the specified key
key- a key for the specified float value
Exceptions:
SCConfigException- configuration error detected
- (void) addIntValue: (SCInteger)  intValue
forKey: (NSString *)  key 

Adds the specified signed integer value for a given key.

Parameters:
intValue- signed integer value for the specified key
key- a key for the specified integer value
Exceptions:
SCConfigException- configuration error detected
- (void) addKeyName: (NSString *)  name
forKey: (NSString *)  key 

Adds into the key names list the record with the specified new and old keys.

Parameters:
name- new name of the configuration key
key- old name of the configuration key
- (void) addLongValue: (SCLong)  longValue
forKey: (NSString *)  key 

Adds the specified signed long value for a given key.

Parameters:
longValue- signed long value for the specified key
key- a key for the specified long value
Exceptions:
SCConfigException- configuration error detected
- (void) addMandatoryKey: (NSString *)  key

Adds the specified key into the mandatory keys list.

Parameters:
key- mandatory key
- (void) addNumberValue: (NSNumber *)  numberValue
forKey: (NSString *)  key 

Adds the specified number value for a given key.

Parameters:
numberValue- number value for the specified key
key- a key for the specified number value
Exceptions:
SCConfigException- configuration error detected
- (void) addShortValue: (SCShort)  shortValue
forKey: (NSString *)  key 

Adds the specified signed short value for a given key.

Parameters:
shortValue- signed short value for the specified key
key- a key for the specified short value
Exceptions:
SCConfigException- configuration error detected
- (void) addString: (NSString *)  string

Adds the configuration record created by using the specified configuration string.

Parameters:
string- configuration string
Exceptions:
SCConfigException- configuration error detected
- (void) addStringValue: (NSString *)  stringValue
forKey: (NSString *)  key 

Adds the specified string value for a given key.

Parameters:
stringValue- string value for the specified key
key- a key for the specified string value
Exceptions:
SCConfigException- configuration error detected
- (void) addUnicharValue: (unichar)  unicharValue
forKey: (NSString *)  key 

Adds the specified unichar value for a given key.

Parameters:
unicharValue- unichar value for the specified key
key- a key for the specified char value
Exceptions:
SCConfigException- configuration error detected
- (void) addUnsignedByteValue: (SCUByte)  unsignedByteValue
forKey: (NSString *)  key 

Adds the specified unsigned byte value for a given key.

Parameters:
unsignedByteValue- unsigned byte value for the specified key
key- a key for the specified unsigned byte value
Exceptions:
SCConfigException- configuration error detected
- (void) addUnsignedIntValue: (SCUInteger)  unsignedIntValue
forKey: (NSString *)  key 

Adds the specified unsigned integer value for a given key.

Parameters:
unsignedIntValue- unsigned integer value for the specified key
key- a key for the specified unsigned integer value
Exceptions:
SCConfigException- configuration error detected
- (void) addUnsignedLongValue: (SCULong)  unsignedLongValue
forKey: (NSString *)  key 

Adds the specified unsigned long value for a given key.

Parameters:
unsignedLongValue- unsigned long value for the specified key
key- a key for the specified unsigned long value
Exceptions:
SCConfigException- configuration error detected
- (void) addUnsignedShortValue: (SCUShort)  unsignedShortValue
forKey: (NSString *)  key 

Adds the specified unsigned short value for a given key.

Parameters:
unsignedShortValue- unsigned short value for the specified key
key- a key for the specified unsigned short value
Exceptions:
SCConfigException- configuration error detected
- (void) addValidKey: (NSString *)  key

Adds the specified key into the valid keys list.

Parameters:
key- valid key
- (void) addValidType: (SCConfigRecordType)  type
forKey: (NSString *)  key 

Adds the record with the specified type and key into the valid types list.

Parameters:
type- valid type
key- record type
- (void) addValidValue: (id)  value
forKey: (NSString *)  key 

Adds the record with the specified value and key into the valid values list.

Parameters:
value- valid value
key- record type
- (void) addValue: (id)  value
forKey: (NSString *)  key 

Adds the specified value for a given key.

Parameters:
value- a value for the specified key
key- a key for the specified value
Exceptions:
SCConfigException- configuration error detected
- (void) addValuesFromCollection: (id)  collection

Adds into the receiving configuration records from the specified existing collection.

Parameters:
collection- existing source collection
Exceptions:
SCConfigException- configuration error detected
- (void) addValuesFromConfig: (SCConfig *)  config

Adds into the receiving configuration records from the specified existing configuration.

Parameters:
config- existing source configuration
Exceptions:
SCConfigException- configuration error detected
- (void) addValuesFromText: (SCStrings *)  text

Adds into the receiving configuration records from the specified existing strings list.

Parameters:
text- existing source strings list
Exceptions:
SCConfigException- configuration error detected
- (SCArray *) allKeys

Returns the array with the all keys from the receiving configuration.

Returns:
Array with the keys list
- (SCArray *) array

Returns the array with the receiving configuration records.

Returns:
Array with the records
- (BOOL) boolValueForKey: (NSString *)  key

Returns the boolean value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCULong) boolValuesCount

Returns a count of the boolean values in the receiving configuration.

Returns:
Count of the boolean values
- (SCByte) byteValueForKey: (NSString *)  key

Returns the signed byte value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (BOOL) caseInsensitive

Determines whether the receiving configuration ignores or not case in the records keys.

Returns:
YES if the configuration ignores case, otherwise NO
- (const char *) charStringValueForKey: (NSString *)  key

Returns the character string value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (char) charValueForKey: (NSString *)  key

Returns the char value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (BOOL) checkMandatoryKeys

Checks the receiving configuration for required keys.

Exceptions:
SCConfigException- configuration error detected
+ (SCConfig *) config

Returns the configuration created by using the default properties.

Returns:
A created configuration

Reimplemented in SCConfigFile.

- (SCConfig *) configForKey: (NSString *)  key

Returns the subconfiguration for a given key.

Parameters:
key- required subconfiguration key
Returns:
The subconfiguration for the specified key or nil if subconfiguration not found
- (SCULong) configValuesCount

Returns a count of the subconfigurations in the receiving configuration.

Returns:
Count of the subconfigurations
+ (SCConfig *) configWithCoder: (NSCoder *)  coder

Returns the configuration created by using the specified coder.

Parameters:
coder- source coder
Returns:
A created confgiration
+ (SCConfig *) configWithCollection: (id)  collection

Returns the configuration created by using the specified existing collection.

Parameters:
collection- existing source collection
Returns:
A created configuration
Exceptions:
SCConfigException- configuration error detected
+ (SCConfig *) configWithConfig: (SCConfig *)  config

Returns the configuration created by using the specified existing configuration.

Parameters:
config- existing source configuration
Returns:
A created configuration
Exceptions:
SCConfigException- configuration error detected
+ (SCConfig *) configWithContentsOfSerializedFile: (NSString *)  path

Returns the configuration created by using the contents of serialized file with the specified path.

Parameters:
path- source serialized file path
Returns:
A created configuration
+ (SCConfig *) configWithDataDictionary: (NSDictionary *)  dictionary

Returns the configuration created by using the specified dictionary.

Parameters:
dictionary- source dictionary
Returns:
A created configuration
+ (SCConfig *) configWithDataDictionaryFromFile: (NSString *)  path

Returns the configuration created by using the dictionary from the specified file.

Parameters:
path- source dictionary file path
Returns:
A created configuration
+ (SCConfig *) configWithFileStream: (NSString *)  path

Returns the configuration created from the stream file with the specified path.

Parameters:
path- stream file path
Returns:
A created configuration
Exceptions:
SCStreamException- stream operation error detected
SCSystemException- system error detected
+ (SCConfig *) configWithName: (NSString *)  name

Returns the configuration created by using the specified configuration name.

Parameters:
name- configuration name
Returns:
A created configuration
+ (SCConfig *) configWithName: (NSString *)  name
delegate: (id<SCConfigDelegate>)  delegate
unique: (BOOL)  unique
caseInsensitive: (BOOL)  caseInsensitive
ignoreErrors: (BOOL)  ignoreErrors
autoCreate: (BOOL)  autoCreate 

Returns the configuration created by using the specified configuration name, delegate object, key duplicate allowing flag, case insensitive flag, detected error ignoring flag and subconfiguration auto creation flag.

Parameters:
name- configuration name
delegate- delegate object
unique- NO for allowing key duplication, YES for disabling key duplication
caseInsensitive- YES for case insensitive key oprations, NO for case sensitive operations
ignoreErrors- YES for ignoring detected errors, NO for throw exception if error detected
autoCreate- YES for allowing automatic subsconfiguration creation, NO for disabling
Returns:
A created configuration
+ (SCConfig *) configWithName: (NSString *)  name
string: (NSString *)  string 

Returns the configuration created by using the specified configuration name and record with the configuration string.

Parameters:
name- configuration name
string- string with the configuration record
Returns:
A created configuration
Exceptions:
SCConfigException- configuration error detected
+ (SCConfig *) configWithName: (NSString *)  name
strings: (NSString *)  string
,   ... 

Returns the configuration created by using the specified configuration name and null terminated list with the configuration strings.

Parameters:
name- configuration name
string- first string with the configuration record
...- other strings with the configuration records
Exceptions:
SCConfigException- configuration error detected
+ (SCConfig *) configWithStream: (SCStream *)  stream

Returns the configuration created from the specified stream.

Parameters:
stream- stream for reading configuration
Returns:
A created configuration
Exceptions:
SCStreamException- stream operation error detected
SCSystemException- system error detected
+ (SCConfig *) configWithString: (NSString *)  string

Returns the configuration created by using the specified string with the configuration record.

Parameters:
string- string with the configuration record
Returns:
A created configuration
Exceptions:
SCConfigException- configuration error detected
+ (SCConfig *) configWithStrings: (NSString *)  string
,   ... 

Returns the configuration created by using the specified null terminated list with the configuration strings.

Parameters:
string- first string with the configuration record
...- other strings with the configuration records
Exceptions:
SCConfigException- configuration error detected
+ (SCConfig *) configWithText: (SCStrings *)  text

Returns the configuration created by using the specified existing strings list.

Parameters:
text- existing source strings list
Returns:
A created configuration
Exceptions:
SCConfigException- configuration error detected
- (BOOL) containsBoolValue: (BOOL)  boolValue

Returns a boolean value that indicates whether a given boolean value is present in the receiving configuration.

Parameters:
boolValue- boolean value
Returns:
YES if the specified boolean value is present in receiving configuration, otherwise NO
- (BOOL) containsBoolValue: (BOOL)  boolValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given boolean value with the specified key is present in the receiving configuration.

Parameters:
boolValue- boolean value for the key
key- key for the boolean value
Returns:
YES if the specified boolean value with a given key is present in the configuration, otherwise NO
- (BOOL) containsBoolValueForKey: (NSString *)  key

Returns a boolean value that indicates whether a boolean value with the specified key is present in the receiving configuration.

Parameters:
key- key for the boolean value
Returns:
YES if the boolean value with the specified key is present in the configuration, otherwise NO
- (BOOL) containsByteValue: (SCByte)  byteValue

Returns a boolean value that indicates whether a given signed byte value is present in the receiving configuration.

Parameters:
byteValue- signed byte value
Returns:
YES if a given signed byte value is present in receiving configuration, otherwise NO
- (BOOL) containsByteValue: (SCByte)  byteValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given signed byte value with the specified key is present in the receiving configuration.

Parameters:
byteValue- signed byte value for the key
key- key for the signed byte value
Returns:
YES if the specified signed byte value with a given key is present in the configuration, otherwise NO
- (BOOL) containsCharStringValue: (const char *)  charStringValue

Returns a boolean value that indicates whether a given char string value is present in the receiving configuration.

Parameters:
charStringValue- char string value
Returns:
YES if a given char string value is present in receiving configuration, otherwise NO
- (BOOL) containsCharStringValue: (const char *)  charStringValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given character string value with the specified key is present in the receiving configuration.

Parameters:
charStringValue- character string value for the key
key- key for the character string value
Returns:
YES if the specified character string value with a given key is present in the configuration, otherwise NO
- (BOOL) containsCharValue: (char)  charValue

Returns a boolean value that indicates whether a given char value is present in the receiving configuration.

Parameters:
charValue- char value
Returns:
YES if a given char value is present in receiving configuration, otherwise NO
- (BOOL) containsCharValue: (char)  charValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given char value with the specified key is present in the receiving configuration.

Parameters:
charValue- char value for the key
key- key for the char value
Returns:
YES if the specified char value with a given key is present in the configuration, otherwise NO
- (BOOL) containsConfigForKey: (NSString *)  key

Returns a boolean value that determines whether the subconfiguration with a given key is present in the receiving configuration.

Parameters:
key- required subconfiguration key
Returns:
YES if the required configuration is present in the receiving configuration, otherwise NO
- (BOOL) containsDateValue: (NSDate *)  dateValue

Returns a boolean value that indicates whether a given date value is present in the receiving configuration.

Parameters:
dateValue- date value
Returns:
YES if the specified date value is present in receiving configuration, otherwise NO
- (BOOL) containsDateValue: (NSDate *)  dateValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given date value with the specified key is present in the receiving configuration.

Parameters:
dateValue- date value for the key
key- key for the date value
Returns:
YES if the specified date value with a given key is present in the configuration, otherwise NO
- (BOOL) containsDateValueForKey: (NSString *)  key

Returns a boolean value that indicates whether a date value with the specified key is present in the receiving configuration.

Parameters:
key- key for the boolean value
Returns:
YES if the date value with the specified key is present in the configuration, otherwise NO
- (BOOL) containsDefaultValueForKey: (NSString *)  key

Returns a boolean value that indicates whether a record with a given key is present in the default values list.

Parameters:
key- default value key
Returns:
YES if the default value with the specified key is present in the default values list, otherwise NO
- (BOOL) containsDoubleValue: (SCDouble)  doubleValue

Returns a boolean value that indicates whether a given double value is present in the receiving configuration.

Parameters:
doubleValue- double value
Returns:
YES if a given double value is present in receiving configuration, otherwise NO
- (BOOL) containsDoubleValue: (SCDouble)  doubleValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given double value with the specified key is present in the receiving configuration.

Parameters:
doubleValue- double value for the key
key- key for the double value
Returns:
YES if the specified float value with a given key is present in the configuration, otherwise NO
- (BOOL) containsDuplicateKey: (NSString *)  key

Returns a boolean value that indicates whether a given key is present in the allowed duplicate list.

Parameters:
key- checked key
Returns:
YES if the specified key is present in the allowed duplicate list, otherwise NO
- (BOOL) containsFloatValue: (SCFloat)  floatValue

Returns a boolean value that indicates whether a given float value is present in the receiving configuration.

Parameters:
floatValue- float value
Returns:
YES if a given float value is present in receiving configuration, otherwise NO
- (BOOL) containsFloatValue: (SCFloat)  floatValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given float value with the specified key is present in the receiving configuration.

Parameters:
floatValue- float value for the key
key- key for the float value
Returns:
YES if the specified float value with a given key is present in the configuration, otherwise NO
- (BOOL) containsIntValue: (SCInteger)  intValue

Returns a boolean value that indicates whether a given signed integer value is present in the receiving configuration.

Parameters:
intValue- signed integer value
Returns:
YES if a given signed integer value is present in receiving configuration, otherwise NO
- (BOOL) containsIntValue: (SCInteger)  intValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given signed integer value with the specified key is present in the receiving configuration.

Parameters:
intValue- signed integer value for the key
key- key for the signed integer value
Returns:
YES if the specified signed integer value with a given key is present in the configuration, otherwise NO
- (BOOL) containsLongValue: (SCLong)  longValue

Returns a boolean value that indicates whether a given signed long value is present in the receiving configuration.

Parameters:
longValue- signed long value
Returns:
YES if a given signed long value is present in receiving configuration, otherwise NO
- (BOOL) containsLongValue: (SCLong)  longValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given signed long value with the specified key is present in the receiving configuration.

Parameters:
longValue- signed long value for the key
key- key for the signed long value
Returns:
YES if the specified signed long value with a given key is present in the configuration, otherwise NO
- (BOOL) containsMandatoryKey: (NSString *)  key

Returns a boolean value that indicates whether a given key is present in the mandatory keys list.

Parameters:
key- checked key
Returns:
YES if the specified key is present in the mandatory keys list, otherwise NO
- (BOOL) containsNameForKey: (NSString *)  key

Returns a boolean value that indicates whether a given key is present in the key names list.

Parameters:
key- original key name
Returns:
YES if the specified key is present in the key names list
- (BOOL) containsNumberValue: (NSNumber *)  numberValue

Returns a boolean value that indicates whether a given number value is present in the receiving configuration.

Parameters:
numberValue- number value
Returns:
YES if the specified number value is present in receiving configuration, otherwise NO
- (BOOL) containsNumberValue: (NSNumber *)  numberValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given number value with the specified key is present in the receiving configuration.

Parameters:
numberValue- number value for the key
key- key for the number value
Returns:
YES if the specified number value with a given key is present in the configuration, otherwise NO
- (BOOL) containsNumberValueForKey: (NSString *)  key

Returns a boolean value that indicates whether a number value with the specified key is present in the receiving configuration.

Parameters:
key- key for the number value
Returns:
YES if the number value with the specified key is present in the configuration, otherwise NO
- (BOOL) containsShortValue: (SCShort)  shortValue

Returns a boolean value that indicates whether a given signed short value is present in the receiving configuration.

Parameters:
shortValue- signed short value
Returns:
YES if a given signed short value is present in receiving configuration, otherwise NO
- (BOOL) containsShortValue: (SCShort)  shortValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given signed short value with the specified key is present in the receiving configuration.

Parameters:
shortValue- signed short value for the key
key- key for the signed short value
Returns:
YES if the specified signed short value with a given key is present in the configuration, otherwise NO
- (BOOL) containsStringValue: (NSString *)  stringValue

Returns a boolean value that indicates whether a given string value is present in the receiving configuration.

Parameters:
stringValue- string value
Returns:
YES if the specified string value is present in receiving configuration, otherwise NO
- (BOOL) containsStringValue: (NSString *)  stringValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given string value with the specified key is present in the receiving configuration.

Parameters:
stringValue- string value for the key
key- key for the string value
Returns:
YES if the specified string value with a given key is present in the configuration, otherwise NO
- (BOOL) containsStringValueForKey: (NSString *)  key

Returns a boolean value that indicates whether a string value with the specified key is present in the receiving configuration.

Parameters:
key- key for the string value
Returns:
YES if the string value with the specified key is present in the configuration, otherwise NO
- (BOOL) containsUnicharValue: (unichar)  unicharValue

Returns a boolean value that indicates whether a given unichar value is present in the receiving configuration.

Parameters:
unicharValue- unichar value
Returns:
YES if a given unichar value is present in receiving configuration, otherwise NO
- (BOOL) containsUnicharValue: (unichar)  unicharValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given unichar value with the specified key is present in the receiving configuration.

Parameters:
unicharValue- unichar value for the key
key- key for the unichar value
Returns:
YES if the specified unichar value with a given key is present in the configuration, otherwise NO
- (BOOL) containsUnsignedByteValue: (SCUByte)  unsignedByteValue

Returns a boolean value that indicates whether a given unsigned byte value is present in the receiving configuration.

Parameters:
unsignedByteValue- unsigned byte value
Returns:
YES if a given unsigned byte value is present in receiving configuration, otherwise NO
- (BOOL) containsUnsignedByteValue: (SCUByte)  unsignedByteValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given unsigned byte value with the specified key is present in the receiving configuration.

Parameters:
unsignedByteValue- unsigned byte value for the key
key- key for the unsigned byte value
Returns:
YES if the specified unsigned byte value with a given key is present in the configuration, otherwise NO
- (BOOL) containsUnsignedIntValue: (SCUInteger)  unsignedIntValue

Returns a boolean value that indicates whether a given unsigned integer value is present in the receiving configuration.

Parameters:
unsignedIntValue- unsigned integer value
Returns:
YES if a given unsigned integer value is present in receiving configuration, otherwise NO
- (BOOL) containsUnsignedIntValue: (SCUInteger)  unsignedIntValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given unsigned integer value with the specified key is present in the receiving configuration.

Parameters:
unsignedIntValue- unsigned integer value for the key
key- key for the unsigned integer value
Returns:
YES if the specified unsigned integer value with a given key is present in the configuration, otherwise NO
- (BOOL) containsUnsignedLongValue: (SCULong)  unsignedLongValue

Returns a boolean value that indicates whether a given unsigned long value is present in the receiving configuration.

Parameters:
unsignedLongValue- unsigned long value
Returns:
YES if a given unsigned long value is present in receiving configuration, otherwise NO
- (BOOL) containsUnsignedLongValue: (SCULong)  unsignedLongValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given unsigned long value with the specified key is present in the receiving configuration.

Parameters:
unsignedLongValue- unsigned long value for the key
key- key for the unsigned long value
Returns:
YES if the specified unsigned long value with a given key is present in the configuration, otherwise NO
- (BOOL) containsUnsignedShortValue: (SCUShort)  unsignedShortValue

Returns a boolean value that indicates whether a given unsigned short value is present in the receiving configuration.

Parameters:
unsignedShortValue- unsigned short value
Returns:
YES if a given unsigned short value is present in receiving configuration, otherwise NO
- (BOOL) containsUnsignedShortValue: (SCUShort)  unsignedShortValue
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given unsigned short value with the specified key is present in the receiving configuration.

Parameters:
unsignedShortValue- unsigned short value for the key
key- key for the unsigned short value
Returns:
YES if the specified unsigned short value with a given key is present in the configuration, otherwise NO
- (BOOL) containsValidKey: (NSString *)  key

Returns a boolean value that indicates whether a given key is present in the valid keys list.

Parameters:
key- checked key
Returns:
YES if the specified key is present in the valid keys list, otherwise NO
- (BOOL) containsValidType: (SCConfigRecordType)  type
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a record with the specified type and key is present in the valid types list.

Parameters:
type- record type
key- record key
Returns:
YES if the specified record is present in the valid types list, otherwise NO
- (BOOL) containsValidTypesForKey: (NSString *)  key

Returns a boolean value that indicates whether a record for the specified key is present in the valid types list.

Parameters:
key- record key
Returns:
YES if the specified record is present in the valid types list, otherwise NO
- (BOOL) containsValidValue: (id)  value
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a record with the specified value and key is present in the valid vaslues list.

Parameters:
value- record value
key- record key
Returns:
YES if the specified record is present in the valid values list, otherwise NO
- (BOOL) containsValidValuesForKey: (NSString *)  key

Returns a boolean value that indicates whether a record for the specified key is present in the valid values list.

Parameters:
key- record key
Returns:
YES if the specified record is present in the valid values list, otherwise NO
- (BOOL) containsValue: (id)  value

Returns a boolean value that indicates whether a given value is present in the receiving configuration.

Parameters:
value- record value
Returns:
YES if the specified value is present in receiving configuration, otherwise NO
- (BOOL) containsValue: (id)  value
forKey: (NSString *)  key 

Returns a boolean value that indicates whether a given value with the specified key is present in the receiving configuration.

Parameters:
value- value for the key
key- key for the value
Returns:
YES if the specified value with a given key is present in configuration, otherwise NO
- (BOOL) containsValueForKey: (NSString *)  key

Returns a boolean value that indicates whether a record with the specified key is present in the receiving configuration.

Parameters:
key- record key
Returns:
YES if the record with the specified key is present in the configuration, otherwise NO
- (SCULong) count

Returns the count of configuration records on the top level. Records from the subconfigurations do not processing.

Returns:
Top level records count
See also:
- fullCount
- (SCULong) countBoolValue: (BOOL)  boolValue

Returns a count of the specified boolean values in the receiving configuration.

Parameters:
boolValue- boolean value
Returns:
Boolean values count
- (SCULong) countBoolValuesForKey: (NSString *)  key

Returns a count of the boolean values for the specified key in the receiving configuration.

Parameters:
key- boolean values key
Returns:
Count of the boolean values
- (SCULong) countByteValue: (SCByte)  byteValue

Returns a count of the specified signed byte values in the receiving configuration.

Parameters:
byteValue- signed byte value
Returns:
Signed byte values count
- (SCULong) countCharStringValue: (const char *)  charStringValue

Returns a count of the specified character string values in the receiving configuration.

Parameters:
charStringValue- character string value
Returns:
Character string values count
- (SCULong) countCharValue: (char)  charValue

Returns a count of the specified char values in the receiving configuration.

Parameters:
charValue- char value
Returns:
Char values count
- (SCULong) countDateValue: (NSDate *)  dateValue

Returns a count of the specified date values in the receiving configuration.

Parameters:
dateValue- date value
Returns:
Date values count
- (SCULong) countDateValuesForKey: (NSString *)  key

Returns a count of the date values for the specified key in the receiving configuration.

Parameters:
key- date values key
Returns:
Count of the date values
- (SCULong) countDoubleValue: (SCDouble)  doubleValue

Returns a count of the specified double values in the receiving configuration.

Parameters:
doubleValue- double value
Returns:
Double values count
- (SCULong) countFloatValue: (SCFloat)  floatValue

Returns a count of the specified float values in the receiving configuration.

Parameters:
floatValue- float value
Returns:
Float values count
- (SCULong) countIntValue: (SCInteger)  intValue

Returns a count of the specified signed integer values in the receiving configuration.

Parameters:
intValue- signed integer value
Returns:
Signed integer values count
- (SCULong) countLongValue: (SCLong)  longValue

Returns a count of the specified signed long values in the receiving configuration.

Parameters:
longValue- signed long value
Returns:
Signed long values count
- (SCULong) countNumberValue: (NSNumber *)  numberValue

Returns a count of the specified number values in the receiving configuration.

Parameters:
numberValue- number value
Returns:
Number values count
- (SCULong) countNumberValuesForKey: (NSString *)  key

Returns a count of the number values for the specified key in the receiving configuration.

Parameters:
key- number values key
Returns:
Count of the number values
- (SCULong) countShortValue: (SCShort)  shortValue

Returns a count of the specified signed short values in the receiving configuration.

Parameters:
shortValue- signed short value
Returns:
Signed short values count
- (SCULong) countStringValue: (NSString *)  stringValue

Returns a count of the specified string values in the receiving configuration.

Parameters:
stringValue- string value
Returns:
String values count
- (SCULong) countStringValuesForKey: (NSString *)  key

Returns a count of the string values for the specified key in the receiving configuration.

Parameters:
key- string values key
Returns:
Count of the string values
- (SCULong) countUnicharValue: (unichar)  unicharValue

Returns a count of the specified unichar values in the receiving configuration.

Parameters:
unicharValue- unichar value
Returns:
Unichar values count
- (SCULong) countUnsignedByteValue: (SCUByte)  unsignedByteValue

Returns a count of the specified unsigned byte values in the receiving configuration.

Parameters:
unsignedByteValue- unsigned byte value
Returns:
Unsigned byte values count
- (SCULong) countUnsignedIntValue: (SCUInteger)  unsignedIntValue

Returns a count of the specified unsigned integer values in the receiving configuration.

Parameters:
unsignedIntValue- unsigned integer value
Returns:
Unsigned integer values count
- (SCULong) countUnsignedLongValue: (SCULong)  unsignedLongValue

Returns a count of the specified unsigned long values in the receiving configuration.

Parameters:
unsignedLongValue- unsigned long value
Returns:
Unsigned long values count
- (SCULong) countUnsignedShortValue: (SCUShort)  unsignedShortValue

Returns a count of the specified unsigned short values in the receiving configuration.

Parameters:
unsignedShortValue- unsigned short value
Returns:
Unsigned short values count
- (SCULong) countValue: (id)  value

Returns a count of the specified values in the receiving configuration.

Parameters:
value- configuration value
Returns:
Values count
- (SCULong) countValuesForKey: (NSString *)  key

Returns a count of the values for the specified key in the receiving configuration.

Parameters:
key- record key
Returns:
Count of the values
- (void) createConfigForKey: (NSString *)  key

Creates the subconfiguration with the specified key.

Parameters:
key- created subconfiguration key
Exceptions:
SCConfigException- configuration error detected
- (NSDate *) dateValueForKey: (NSString *)  key

Returns the date value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCULong) dateValuesCount

Returns a count of the date values in the receiving configuration.

Returns:
Count of the date values
- (SCConfigRecordType) defaultTypeForKey: (NSString *)  key

Returns the default type for the specified key.

Parameters:
key- the key for which to get the default type
Returns:
Default type for a given key
- (id) defaultValueForKey: (NSString *)  key

Returns the default value for the specified key.

Parameters:
key- the key for which to get the default value
Returns:
Default value for a given key, or nil if the default value for a given key do not found
- (SCArray *) defaultValues

Returns the list of the configuration default values.

Returns:
Default values list
- (id< SCConfigDelegate >) delegate

Returns the receiving configuration delegate object.

Returns:
A delegate object or nil if the delegate object do not set
- (NSString *) description

Returns a string which represents the configuration information.

Returns:
Configuration description string

Reimplemented in SCConfigFile.

- (SCDictionary *) dictionary

Returns the dictionary with the receiving configuration records. If the receiving configuration contains more than one record with the same key, in the resulting dictionary sets only one of the records.

Returns:
Dictionary with the records
- (SCDouble) doubleValueForKey: (NSString *)  key

Returns the double value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCArray *) duplicatedKeys

Returns the list of keys that can be duplicates in the receiving configuration.

Returns:
List of keys
- (SCConfigException *) error

Returns the receiving configuration last detected error.

Returns:
Last detected error
- (SCFloat) floatValueForKey: (NSString *)  key

Returns the float value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (NSArray *) foundationArray

Returns the foundation array with the receiving configuration records.

Returns:
Foundation array with the records
- (NSDictionary *) foundationDictionary

Returns the foundation dictionary with the receiving configuration records. If the receiving configuration contains more than one record with the same key, in the resulting foundation dictionary sets only one of the records.

Returns:
Foundation dictionary with the records
- (SCULong) fullCount

Returns the count of all configuration records including records from all subconfigurations.

Returns:
All records count
See also:
- count
- (id) init

Initializes the configuration with the default properties.

Returns:
A newly initialized configuration
- (id) initWithCollection: (id)  collection

Initializes the configuration using the specified existing collection.

Parameters:
collection- existing source collection
Returns:
A newly initialized configuration
Exceptions:
SCConfigException- configuration error detected
- (id) initWithConfig: (SCConfig *)  config

Initializes the configuration using the specified existing configuration.

Parameters:
config- existing source configuration
Returns:
A newly initialized configuration
Exceptions:
SCConfigException- configuration error detected
- (id) initWithName: (NSString *)  name

Initializes the configuration using the specified name.

Parameters:
name- configuration name
Returns:
A newly initialized configuration
- (id) initWithName: (NSString *)  name
delegate: (id<SCConfigDelegate>)  delegate
unique: (BOOL)  unique
caseInsensitive: (BOOL)  caseInsensitive
ignoreErrors: (BOOL)  ignoreErrors
autoCreate: (BOOL)  autoCreate 

Initializes the configuration using the specified configuration name, delegate object, key duplicate allowing flag, case insensitive flag, detected error ignoring flag and subconfiguration auto creation flag.

Parameters:
name- configuration name
delegate- delegate object
unique- NO for allowing key duplication, YES for disabling key duplication
caseInsensitive- YES for case insensitive key oprations, NO for case sensitive operations
ignoreErrors- YES for ignoring detected errors, NO for throw exception if error detected
autoCreate- YES for allowing automatic subsconfiguration creation, NO for disabling
Returns:
A newly initialized configuration
- (id) initWithName: (NSString *)  name
string: (NSString *)  string 

Initializes the configuration using the specified configuration name and string with the configuration record.

Parameters:
name- configuration name
string- string with the configuration record
Returns:
A newly initialized configuration
Exceptions:
SCConfigExcpetion- configuration error detected
- (id) initWithName: (NSString *)  name
strings: (NSString *)  string
,   ... 

Initializes the configuration using the specified configuration name and null terminated list of the configuration strings.

Parameters:
name- configuration name
string- first string with the configuration record
...- other strings with the configuration records
Returns:
A newly initialized configuration
Exceptions:
SCConfigException- configuration error detected
- (id) initWithString: (NSString *)  string

Initializes the configuration using the specified string with the configuration record.

Parameters:
string- string with the configuration record
Returns:
A newly initialized configuration
Exceptions:
SCConfigException- configuration error detected
- (id) initWithStrings: (NSString *)  string
,   ... 

Initializes the configuration using the specified null terminated list of the configuration strings.

Parameters:
string- first string with the configuration record
...- other strings with the configuration records
Returns:
A newly initialized configuration
Exceptions:
SCConfigException- configuration error detected
- (id) initWithText: (SCStrings *)  text

Initializes the configuration using the specified existing strings list.

Parameters:
text- existing source strings list
Returns:
A newly initialized configuration
Exceptions:
SCConfigException- configuration error detected
- (SCInteger) intValueForKey: (NSString *)  key

Returns the signed integer value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (BOOL) isAllowedDuplicateValueForKey: (NSString *)  key

Returns a boolean value that determines the permission of duplicating record with the specified key.

Parameters:
key- record key
Returns:
YES if the record with the specified key can be duplicated, otherwise NO
- (BOOL) isAutoCreate

Determines whether the receiving configuration allows subconfigurations automatic creation.

Returns:
YES if the subsconfiguration automatic creation is allowed, otherwise NO
- (BOOL) isBoolValueForKey: (NSString *)  key

Returns a boolean value which determines whether the record with a specified key is a boolean record.

Parameters:
key- checked record key
Returns:
YES if the record with the specified key is a boolean record, otherwise NO
Exceptions:
SCConfigException- configuration error detected
- (BOOL) isConfigValueForKey: (NSString *)  key

Returns a boolean value which determines whether the record with a specified key is a subconfiguration.

Parameters:
key- checked record key
Returns:
YES if the record with the specified key is a subconfiguration, otherwise NO
Exceptions:
SCConfigException- configuration error detected
- (BOOL) isDateValueForKey: (NSString *)  key

Returns a boolean value which determines whether the record with a specified key is a date record.

Parameters:
key- checked record key
Returns:
YES if the record with the specified key is a date record, otherwise NO
Exceptions:
SCConfigException- configuration error detected
- (BOOL) isEmpty

Returns a boolean value that determines whether the receiving configuration is empty or contains at least one top-level record.

Returns:
YES if the configuration is empty, otherwise NO
- (BOOL) isEqual: (id)  object

Returns a boolean value that indicates whether the receiving configuration are equal to the specified object.

Parameters:
object- the object with which to compare the receiving configuration
Returns:
YES if a given object are equal to the receiving configuration, otherwise NO

Reimplemented from SCObject.

- (BOOL) isEqualTo: (id)  object

Returns a boolean value that indicates whether the receiving configuration are equal to the specified object.

Parameters:
object- the object with which to compare the receiving configuration
Returns:
YES if a given object are equal to the receiving configuration, otherwise NO
- (BOOL) isEqualToCollection: (id)  collection

Returns a boolean value that indicates whether the contents of the receiving configuration are equal to the contents of a given collection.

Parameters:
collection- the collection with which to compare the receiving configuration
Returns:
YES if the contents of a given collection are equal to the contents of the receiving configuration, otherwise NO
- (BOOL) isEqualToConfig: (SCConfig *)  config

Returns a boolean value that indicates whether the receiving configuration are equal to the another given configuration.

Parameters:
config- the configuration with which to compare the receiving configuration
Returns:
YES if a given configuration are equal to the receiving configuration, otherwise NO
- (BOOL) isEqualToContentOfConfig: (SCConfig *)  config

Returns a boolean value that indicates whether the contents of the receiving configuration are equal to the contents of another given configuration.

Parameters:
config- the configuration with which to compare the receiving configuration
Returns:
YES if the contents of a given configuration are equal to the contents of the receiving configuration, otherwise NO
- (BOOL) isEqualToText: (SCStrings *)  text

Returns a boolean value that indicates whether the contents of the receiving configuration are equal to the specified text.

Parameters:
text- the text with which to compare the receiving configuration
Returns:
YES if a given text are equal to the contents of the receiving configuration, otherwise NO
- (BOOL) isIgnoreErrors

Determines whether the receiving configuration ignores the detected errors or throws exceptions.

Returns:
YES if the configuration ignores errors, otherwise NO
- (BOOL) isModified

Determines whether the receiving configuration has any modifications.

Returns:
YES if the configuration has modifications, otherwise NO
- (BOOL) isNumberValueForKey: (NSString *)  key

Returns a boolean value which determines whether the record with a specified key is a number record.

Parameters:
key- checked record key
Returns:
YES if the record with the specified key is a number record, otherwise NO
Exceptions:
SCConfigException- configuration error detected
- (BOOL) isReadOnly

Returns a boolean value that determines whether the receiving configuration allows any changes.

Returns:
YES if the changes are allowed, otherwise NO
- (BOOL) isStringValueForKey: (NSString *)  key

Returns a boolean value which determines whether the record with a specified key is a string record.

Parameters:
key- checked record key
Returns:
YES if the record with the specified key is a string record, otherwise NO
Exceptions:
SCConfigException- configuration error detected
- (BOOL) isUnique

Determines whether the receiving configuration allows records with the duplicated keys.

Returns:
YES if the configuration do not allow the duplicated records (excepted records from the allow duplicated list), NO if the configuration allows the duplicated records
- (BOOL) isValidConfigForKey: (NSString *)  key

Returns a boolean value which determines the ability of adding the subconfiguration with the specified key.

Parameters:
key- subconfiguration key
Returns:
YES if the subconfiguration key is valid, otherwise NO
- (BOOL) isValidKey: (NSString *)  key

Returns a boolean value that indicates ability of a given local key.

Parameters:
key- local key
Returns:
YES if the specified key is valid, otherwise NO
- (BOOL) isValidType: (SCConfigRecordType)  type
forKey: (NSString *)  key 

Returns a boolean value that indicates ability of a given type for the specified key.

Parameters:
type- value type
key- value key
Returns:
YES if the type is correct for the specified key, otherwise NO
- (BOOL) isValidValue: (id)  value
forKey: (NSString *)  key 

Returns a boolean value that indicates ability of a given value for the specified key.

Parameters:
value- checked value
key- value key
Returns:
YES if the value is correct for the specified key, otherwise NO
- (NSEnumerator *) keyEnumerator

Returns an enumerator object that lets you access each key in the receiving configuration.

Returns:
The enumerator object that lets yoy access each key in the configuration
- (NSString *) keyForBoolValue: (BOOL)  boolValue

Returns the first key which corresponding with the specified boolean value.

Parameters:
boolValue- the boolean value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified boolean value is not found
- (NSString *) keyForByteValue: (SCByte)  byteValue

Returns the first key which corresponding with the specified signed byte value.

Parameters:
byteValue- the signed byte value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified signed byte value is not found
- (NSString *) keyForCharString: (const char *)  charStringValue

Returns the first key which corresponding with the specified char string value.

Parameters:
charStringValue- the char string value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified char string value is not found
- (NSString *) keyForCharValue: (char)  charValue

Returns the first key which corresponding with the specified char value.

Parameters:
charValue- the char value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified char value is not found
- (NSString *) keyForDateValue: (NSDate *)  dateValue

Returns the first key which corresponding with the specified date value.

Parameters:
dateValue- the date value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified date value is not found
- (NSString *) keyForDoubleValue: (SCDouble)  doubleValue

Returns the first key which corresponding with the specified double value.

Parameters:
doubleValue- the double value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified double value is not found
- (NSString *) keyForFloatValue: (SCFloat)  floatValue

Returns the first key which corresponding with the specified float value.

Parameters:
floatValue- the float value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified float value is not found
- (NSString *) keyForIntValue: (SCInteger)  intValue

Returns the first key which corresponding with the specified signed integer value.

Parameters:
intValue- the signed integer value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified signed integer value is not found
- (NSString *) keyForLongValue: (SCLong)  longValue

Returns the first key which corresponding with the specified signed long value.

Parameters:
longValue- the signed long value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified signed long value is not found
- (NSString *) keyForNumberValue: (NSNumber *)  numberValue

Returns the first key which corresponding with the specified number value.

Parameters:
numberValue- the number value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified number value is not found
- (NSString *) keyForShortValue: (SCShort)  shortValue

Returns the first key which corresponding with the specified signed short value.

Parameters:
shortValue- the signed short value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified signed short value is not found
- (NSString *) keyForStringValue: (NSString *)  stringValue

Returns the first key which corresponding with the specified string value.

Parameters:
stringValue- the string value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified string value is not found
- (NSString *) keyForUnicharValue: (unichar)  unicharValue

Returns the first key which corresponding with the specified unichar value.

Parameters:
unicharValue- the unichar value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified unichar value is not found
- (NSString *) keyForUnsignedByteValue: (SCUByte)  unsignedByteValue

Returns the first key which corresponding with the specified unsigned byte value.

Parameters:
unsignedByteValue- the unsigned byte value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified unsigned byte value is not found
- (NSString *) keyForUnsignedIntValue: (SCUInteger)  unsignedIntValue

Returns the first key which corresponding with the specified unsigned integer value.

Parameters:
unsignedIntValue- the unsigned integer value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified unsigned integer value is not found
- (NSString *) keyForUnsignedLongValue: (SCULong)  unsignedLongValue

Returns the first key which corresponding with the specified unsigned long value.

Parameters:
unsignedLongValue- the unsigned long value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified unsigned long value is not found
- (NSString *) keyForUnsignedShortValue: (SCUShort)  unsignedShortValue

Returns the first key which corresponding with the specified unsigned short value.

Parameters:
unsignedShortValue- the unsigned short value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified unsigned short value is not found
- (NSString *) keyForValue: (id)  value

Returns the first key which corresponding with the specified value.

Parameters:
value- the value for which to return the corresponding key
Returns:
Corresponding key or nil if the specified value is not found
- (NSString *) keyNameForKey: (NSString *)  key

Returns the configuration key name for the specified existing key.

Parameters:
key- existing configuration key name
Returns:
Configuration key name
- (SCArray *) keyNames

Returns the keys substitution list.

Returns:
Keys substitution list
- (SCLong) longValueForKey: (NSString *)  key

Returns the signed long value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCArray *) mandatoryKeys

Returns the list of the mandatory configuration keys.

Returns:
Mandatory keys list
- (NSString *) name

Returns the receiving configuration name.

Returns:
A configuration name of nil if configuration name do not set
- (NSString *) nameForKey: (NSString *)  key

Returns the new name of the specified configuration key.

Parameters:
key- existing key
Returns:
New key name or nil if the specified key do not found in the key names list
- (NSNumber *) numberValueForKey: (NSString *)  key

Returns the number value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCULong) numberValuesCount

Returns a count of the number values in the receiving configuration.

Returns:
Count of the number values
- (void) removeAllowedDuplicateKeys

Removes all records from the duplicated keys list.

- (void) removeAllValues

Removes all records from the receiving configuration.

Exceptions:
SCConfigException- configuration error detected
- (void) removeBoolValue: (BOOL)  boolValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified boolean value and key.

Parameters:
boolValue- removed boolean value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeByteValue: (SCByte)  byteValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified signed byte value and key.

Parameters:
byteValue- removed signed byte value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeCharStringValue: (const char *)  charStringValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified char string value and key.

Parameters:
charStringValue- removed char string value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeCharValue: (char)  charValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified char value and key.

Parameters:
charValue- removed char value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeConfigForKey: (NSString *)  key

Removes from the receiving configuration the subconfiguration for the specified key.

Parameters:
key- removed subconfiguration key
Exceptions:
SCConfigException- configuration error detected
- (void) removeConfiguration

Removes all records from the configuration service lists.

- (void) removeDateValue: (NSDate *)  dateValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified date value and key.

Parameters:
dateValue- removed date value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeDefaultValueForKey: (NSString *)  key

Removes the default value for the specified key from the default values list.

Parameters:
key- key for the default value to be deleted
- (void) removeDefaultValues

Removes all records from the default values list.

- (void) removeDoubleValue: (SCDouble)  doubleValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified double value and key.

Parameters:
doubleValue- removed double value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeFloatValue: (SCFloat)  floatValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified float value and key.

Parameters:
floatValue- removed float value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeIntValue: (SCInteger)  intValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified signed integer value and key.

Parameters:
intValue- removed signed integer value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeKeyNames

Removes all records from the key names list.

- (void) removeLongValue: (SCLong)  longValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified signed long value and key.

Parameters:
longValue- removed signed long value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeMandatoryKey: (NSString *)  key

Removes the specified key from the mandatory keys list.

Parameters:
key- removed key
- (void) removeMandatoryKeys

Removes all records from the mandatory keys list.

- (void) removeNameForKey: (NSString *)  key

Removes the specified key from the key names list.

Parameters:
key- removed key
- (void) removeNumberValue: (NSNumber *)  numberValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified number value and key.

Parameters:
numberValue- removed number value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeShortValue: (SCShort)  shortValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified signed short value and key.

Parameters:
shortValue- removed signed short value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeStringValue: (NSString *)  stringValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified string value and key.

Parameters:
stringValue- removed string value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeUnicharValue: (unichar)  unicharValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified unichar value and key.

Parameters:
unicharValue- removed unichar value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeUnsignedByteValue: (SCUByte)  unsignedByteValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified unsigned byte value and key.

Parameters:
unsignedByteValue- removed unsigned byte value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeUnsignedIntValue: (SCUInteger)  unsignedIntValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified unsigned integer value and key.

Parameters:
unsignedIntValue- removed unsigned integer value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeUnsignedLongValue: (SCULong)  unsignedLongValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified unsigned long value and key.

Parameters:
unsignedLongValue- removed unsigned long value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeUnsignedShortValue: (SCUShort)  unsignedShortValue
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified unsigned short value and key.

Parameters:
unsignedShortValue- removed unsigned short value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeValidDuplicateKey: (NSString *)  key

Removes the specified key from the duplicate allowing keys list.

Parameters:
key- removed key
- (void) removeValidKey: (NSString *)  key

Removes the specified key from the valid keys list.

Parameters:
key- removed key
- (void) removeValidKeys

Removes all records from the valid keys list.

- (void) removeValidType: (SCConfigRecordType)  type
forKey: (NSString *)  key 

Removes the specified valid type for a given key from the valid types list.

Parameters:
type- removed type
key- key for the removed type
- (void) removeValidTypes

Removes all records from the valid types list.

- (void) removeValidTypesForKey: (NSString *)  key

Removes the all valid types for the specified key from the valid types list.

Parameters:
key- key for the removed valid types
- (void) removeValidValue: (id)  value
forKey: (NSString *)  key 

Removes the specified valid value for a given key from the valid values list.

Parameters:
value- removed value
key- key for the removed value
- (void) removeValidValues

Removes all records from the valid values list.

- (void) removeValidValuesForKey: (NSString *)  key

Removes the all valid values for the specified key from the valid values list.

Parameters:
key- key for the removed valid values
- (void) removeValue: (id)  value
forKey: (NSString *)  key 

Removes from the receiving configuration the record with the specified value and key.

Parameters:
value- removed value
key- removed key
Exceptions:
SCConfigException- configuration error detected
- (void) removeValuesForKey: (NSString *)  key

Removes all records with the specified key.

Parameters:
key- key to remove
Exceptions:
SCConfigException- configuration error detected
- (void) removeValuesForKeys: (NSString *)  key
,   ... 

Removes from the receiving configuration the values for the keys from the specified nil terminated list.

Parameters:
key- first removed key
...- other removed keys
Exceptions:
SCConfigException- configuration error detected
- (void) removeValuesForKeysFromArray: (SCArray *)  array

Removes from the receiving configuration the values for the keys from the specified array.

Parameters:
array- array with the removing keys
Exceptions:
SCConfigException- configuration error detected
- (void) resetConfiguration

Remove all configuration records, clears the configuration service lists and sets the properties to the default values (excluding configuration name and delegate object).

Exceptions:
SCConfigException- configuration error detected
- (void) setAutoCreate: (BOOL)  autoCreate

Sets the value of the flag which determines whether the receiving configuration allows the subsconfigurations automatic creation.

Parameters:
autoCreate- YES for autocreation allowing, NO for disabling automaric creation
- (void) setBoolValue: (BOOL)  boolValue
forKey: (NSString *)  key 

Sets the boolean value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
boolValue- new boolean value for the specified key
key- key for the specified boolean value
Exceptions:
SCConfigException- configuration error detected
- (void) setBoolValue: (BOOL)  value
forKey: (NSString *)  key
withBoolValue: (BOOL)  old 

Sets the boolean value for the specified key and previous boolean value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new boolean value for the specified key
key- key for the specified boolean value
old- previous boolean value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setByteValue: (SCByte)  byteValue
forKey: (NSString *)  key 

Sets the signed byte value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
byteValue- new signed byte value for the specified key
key- key for the specified signed byte value
Exceptions:
SCConfigException- configuration error detected
- (void) setByteValue: (SCByte)  value
forKey: (NSString *)  key
withLongValue: (SCLong)  old 

Sets the signed byte value for the specified key and previous signed long value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new signed byte value for the specified key
key- key for the specified value
old- previous signed long value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setCaseInsensitive: (BOOL)  caseInsensitive

Sets the value of the flag which determines the receiving configuration ignores or not the case of the records keys.

Parameters:
caseInsensitive- YES for ignoring case, NO for case sensitive processing
- (void) setCharStringValue: (const char *)  charStringValue
forKey: (NSString *)  key 

Sets the character string value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
charStringValue- new character string value for the specified key
key- key for the specified character string value
Exceptions:
SCConfigException- configuration error detected
- (void) setCharStringValue: (const char *)  value
forKey: (NSString *)  key
withCharStringValue: (const char *)  old 

Sets the char string value for the specified key and previous char string value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new char string value for the specified key
key- key for the specified value
old- previous char string value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setCharValue: (char)  charValue
forKey: (NSString *)  key 

Sets the char value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
charValue- new char value for the specified key
key- key for the specified char value
Exceptions:
SCConfigException- configuration error detected
- (void) setCharValue: (char)  value
forKey: (NSString *)  key
withCharValue: (char)  old 

Sets the char value for the specified key and previous char value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new char value for the specified key
key- key for the specified value
old- previous char value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setCollection: (id)  collection

Erases the receiving configuration and copies all values from the specified existing collection.

Parameters:
collection- existing source collection
Exceptions:
SCConfigException- configuration error detected
- (void) setConfig: (SCConfig *)  config

Erases the receiving configuration and copies all values and settings from the specified existing configuration.

Parameters:
config- existing source configuration
Exceptions:
SCConfigException- configuration error detected
- (void) setConfig: (SCConfig *)  config
forKey: (NSString *)  key 

Sets the subconfiguration for a given key with the specified existing configuration. If the destination subconfiguration is not exists, the method creates it, otherwise replaces.

Parameters:
config- new subconfiguration
key- subconfiguration key
Exceptions:
SCConfigException- configuration error detected
- (void) setDateValue: (NSDate *)  dateValue
forKey: (NSString *)  key 

Sets the date value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
dateValue- new date value for the specified key
key- key for the specified date value
Exceptions:
SCConfigException- configuration error detected
- (void) setDateValue: (NSDate *)  value
forKey: (NSString *)  key
withDateValue: (NSDate *)  old 

Sets the date value for the specified key and previous date value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new date value for the specified key
key- key for the specified date value
old- previous date value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setDelegate: (id<SCConfigDelegate>)  delegate

Sets the receiving configuration delegate object.

Parameters:
delegate- delegate object or nil for remove previous delegate object
- (void) setDoubleValue: (SCDouble)  doubleValue
forKey: (NSString *)  key 

Sets the double value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
doubleValue- new double value for the specified key
key- key for the specified double value
Exceptions:
SCConfigException- configuration error detected
- (void) setDoubleValue: (SCDouble)  value
forKey: (NSString *)  key
withDoubleValue: (SCDouble)  old 

Sets the double value for the specified key and previous double value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new double value for the specified key
key- key for the specified value
old- previous double value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setFloatValue: (SCFloat)  floatValue
forKey: (NSString *)  key 

Sets the float value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
floatValue- new float value for the specified key
key- key for the specified float value
Exceptions:
SCConfigException- configuration error detected
- (void) setFloatValue: (SCFloat)  value
forKey: (NSString *)  key
withFloatValue: (SCFloat)  old 

Sets the float value for the specified key and previous float value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new float value for the specified key
key- key for the specified value
old- previous float value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setIgnoreErrors: (BOOL)  ignoreErrors

Sets the value of the flag which determines the receiving configuration ignores the detected errors or throws the exceptions.

Parameters:
ignoreErrors- YES for ignoring detected errors, NO for throws exceptions
- (void) setIntValue: (SCInteger)  intValue
forKey: (NSString *)  key 

Sets the signed integer value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
intValue- new signed integer value for the specified key
key- key for the specified signed integer value
Exceptions:
SCConfigException- configuration error detected
- (void) setIntValue: (SCInteger)  value
forKey: (NSString *)  key
withLongValue: (SCLong)  old 

Sets the signed integer value for the specified key and previous signed long value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new signed integer value for the specified key
key- key for the specified value
old- previous signed long value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setLongValue: (SCLong)  longValue
forKey: (NSString *)  key 

Sets the signed long value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
longValue- new signed long value for the specified key
key- key for the specified signed long value
Exceptions:
SCConfigException- configuration error detected
- (void) setLongValue: (SCLong)  value
forKey: (NSString *)  key
withLongValue: (SCLong)  old 

Sets the signed long value for the specified key and previous signed long value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new signed long value for the specified key
key- key for the specified value
old- previous signed long value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setName: (NSString *)  name

Sets the receiving configuration name.

- (void) setNumberValue: (NSNumber *)  numberValue
forKey: (NSString *)  key 

Sets the number value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
numberValue- new number value for the specified key
key- key for the specified number value
Exceptions:
SCConfigException- configuration error detected
- (void) setNumberValue: (NSNumber *)  value
forKey: (NSString *)  key
withNumberValue: (NSNumber *)  old 

Sets the number value for the specified key and previous number value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new number value for the specified key
key- key for the specified number value
old- previous number value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setReadOnly: (BOOL)  readonly

Sets the value of the flag, which determines the possibility of changes in the receiving configuration.

Parameters:
readonly- YES for allowing changes, NO for disabling changes
- (void) setShortValue: (SCShort)  shortValue
forKey: (NSString *)  key 

Sets the signed short value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
shortValue- new signed short value for the specified key
key- key for the specified signed short value
Exceptions:
SCConfigException- configuration error detected
- (void) setShortValue: (SCShort)  value
forKey: (NSString *)  key
withLongValue: (SCLong)  old 

Sets the signed short value for the specified key and previous signed long value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new signed short value for the specified key
key- key for the specified value
old- previous signed long value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setStringValue: (NSString *)  stringValue
forKey: (NSString *)  key 

Sets the string value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
stringValue- new string value for the specified key
key- key for the specified string value
Exceptions:
SCConfigException- configuration error detected
- (void) setStringValue: (NSString *)  value
forKey: (NSString *)  key
withStringValue: (NSString *)  old 

Sets the string value for the specified key and previous string value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new string value for the specified key
key- key for the specified string value
old- previous string value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setText: (SCStrings *)  text

Erases the receiving configuratopm and copies all values from the specified existing strings list.

Parameters:
text- existing source strings list
Exceptions:
SCConfigException- configuration error detected
- (void) setUnicharValue: (unichar)  unicharValue
forKey: (NSString *)  key 

Sets the unichar value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
unicharValue- new unichar value for the specified key
key- key for the specified unichar value
Exceptions:
SCConfigException- configuration error detected
- (void) setUnicharValue: (unichar)  value
forKey: (NSString *)  key
withUnicharValue: (unichar)  old 

Sets the unichar value for the specified key and previous unichar value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new unichar value for the specified key
key- key for the specified value
old- previous unichar value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setUnique: (BOOL)  unique

Sets the value of the flag which determines the configuration unique mode - allowed or not allowed adding into the receiving configuration records with the duplicated records.

Parameters:
unique- YES if the duplicated records do not allowed (excepted the records with the keys from the allowed duplicated keys list),
NO if the duplicated records are allowed
- (void) setUnsignedByteValue: (SCUByte)  unsignedByteValue
forKey: (NSString *)  key 

Sets the unsigned byte value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
unsignedByteValue- new unsigned byte value for the specified key
key- key for the specified unsigned byte value
Exceptions:
SCConfigException- configuration error detected
- (void) setUnsignedByteValue: (SCUByte)  value
forKey: (NSString *)  key
withLongValue: (SCLong)  old 

Sets the unsigned byte value for the specified key and previous signed long value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new unsigned byte value for the specified key
key- key for the specified value
old- previous signed long value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setUnsignedIntValue: (SCUInteger)  unsignedIntValue
forKey: (NSString *)  key 

Sets the unsigned integer value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
unsignedIntValue- new unsigned integer value for the specified key
key- key for the specified unsigned integer value
Exceptions:
SCConfigException- configuration error detected
- (void) setUnsignedIntValue: (SCUInteger)  value
forKey: (NSString *)  key
withLongValue: (SCLong)  old 

Sets the unsigned integer value for the specified key and previous signed long value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new unsigned integer value for the specified key
key- key for the specified value
old- previous signed long value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setUnsignedLongValue: (SCULong)  unsignedLongValue
forKey: (NSString *)  key 

Sets the unsigned long value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
unsignedLongValue- new unsigned long value for the specified key
key- key for the specified unsigned long value
Exceptions:
SCConfigException- configuration error detected
- (void) setUnsignedLongValue: (SCULong)  value
forKey: (NSString *)  key
withLongValue: (SCLong)  old 

Sets the unsigned long value for the specified key and previous signed long value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new unsigned long value for the specified key
key- key for the specified value
old- previous signed long value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setUnsignedShortValue: (SCUShort)  unsignedShortValue
forKey: (NSString *)  key 

Sets the unsigned short value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
unsignedShortValue- new unsigned short value for the specified key
key- key for the specified unsigned short value
Exceptions:
SCConfigException- configuration error detected
- (void) setUnsignedShortValue: (SCUShort)  value
forKey: (NSString *)  key
withLongValue: (SCLong)  old 

Sets the unsigned short value for the specified key and previous signed long value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new unsigned short value for the specified key
key- key for the specified value
old- previous signed long value of a given key
Exceptions:
SCConfigException- configuration error detected
- (void) setValue: (id)  value
forKey: (NSString *)  key 

Sets the value for the specified key. If the record with a given key is not present in the receiving configuration, the method creates it.

Parameters:
value- new value for the specified key
key- key for the specified value
Exceptions:
SCConfigException- configuration error detected
- (void) setValue: (id)  value
forKey: (NSString *)  key
withValue: (id)  oldValue 

Sets the value for the specified key and previous value. If the record with a given key and value is not present in the receiving configuration, the method ignores it.

Parameters:
value- new value for the specified key
key- key for the specified value
oldValue- previous value of a given key
Exceptions:
SCConfigException- configuration error detected
- (SCShort) shortValueForKey: (NSString *)  key

Returns the signed short value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCConfigStatus) status

Returns the receiving configuration status.

Returns:
Configuration status
- (NSString *) stringValueForKey: (NSString *)  key

Returns the string value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCULong) stringValuesCount

Returns a count of the string values in the receiving configuration.

Returns:
Count of the string values
- (SCStrings *) text

Returns the text with the receiving configuration records with using the equals sign as a key/value delimiter.

Returns:
Text with the records
- (SCStrings *) textWithSpace: (BOOL)  space

Returns the text with the receiving configuration records.

Parameters:
space- YES for using space as a key/value delimiter, NO for using the equals sign
Returns:
Text with the records
- (SCConfigRecordType) typeForKey: (NSString *)  key

Returns the type of the record with the specified key.

Parameters:
key- the key for which to return the corresponding type
Returns:
Record type for the specified key name
Exceptions:
SCConfigException- configuration error detected
- (NSString *) typeNameForKey: (NSString *)  key

Returns the type name of the record with the specified key.

Parameters:
key- the key for which to return the corresponding type name
Returns:
Record type name for the specified key name
Exceptions:
SCConfigException- configuration error detected
- (unichar) unicharValueForKey: (NSString *)  key

Returns the unichar value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCUByte) unsignedByteValueForKey: (NSString *)  key

Returns the unsigned byte value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCUInteger) unsignedIntValueForKey: (NSString *)  key

Returns the unsigned integer value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCULong) unsignedLongValueForKey: (NSString *)  key

Returns the unsigned long value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCUShort) unsignedShortValueForKey: (NSString *)  key

Returns the unsigned byte value assodicated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCArray *) validKeys

Returns the configuration valid keys list.

Returns:
A valid key list
- (SCArray *) validTypes

Returns the valid types list for the receiving local configuration.

Returns:
Valid types list
- (SCArray *) validTypesForKey: (NSString *)  key

Returns the valid types list for the specified key.

Parameters:
key- the key for which to return the valid types list
Returns:
Valid types list for the specified key
- (SCArray *) validValues

Returns the valid values list for the receiving local configuration.

Returns:
Valid values list
- (SCArray *) validValuesForKey: (NSString *)  key

Returns the valid values list for the specified key.

Parameters:
key- the key for which to return the valid values list.
Returns:
Valid values list
- (id) valueForKey: (NSString *)  key

Returns the value associated with a given key.

Parameters:
key- the key for which to return the corresponding value
Returns:
The value assiated with key or nil if the specified key do not found
Exceptions:
SCConfigException- configuration error detected
- (SCArray *) valuesForKey: (NSString *)  key

Returns the array with the values for a given key.

Parameters:
key- the key for which to return the corresponding values
Returns:
An array with the required values
- (SCArray *) valuesForKeys: (NSString *)  key
,   ... 

Returns the array with the values for a keys from the specified nil terminated list.

Parameters:
key- the first key for which to return the corresponding values
...- the other keys for which to return the corresponding values
Returns:
An array with the required values
- (SCArray *) valuesForKeysFromArray: (SCArray *)  keys

Returns the array with the values for a keys from the specified array.

Parameters:
keys- the array with the keys for which to return the corresponding values
Returns:
An array with the required values
The documentation for this class was generated from the following files:
 All Classes Files Functions Typedefs Enumerations Enumerator Defines
Generated on Fri Nov 21 2014 15:25:35 for Samond Classes Library 1.1.6-RELEASE build 132 by  doxygen 1.7.3