SCCollectionException Class Reference

Exception class SCCollectionException. More...

#import <SCCollectionException.h>

Inheritance diagram for SCCollectionException:

Instance Properties
NSString *	collectionName
NSString *	typeName
NSString *	unsupported
NSString *	unknown
NSString *	unexpected
NSString *	expected
SCIndex	index
NSRange	range
NSIndexSet *	indexSet
SCULong	indexesCount
SCULong	objectsCount
NSString *	key
SCULong	keysCount

Creating and Initializing the Generic Collection Exceptions
(id)	- initWithName:reason:code:eid:
(id)	- initWithReason:code:eid:
(id)	- initWithName:
(id)	- init
(SCCollectionException *)	+ exceptionWithName:reason:code:eid:
(SCCollectionException *)	+ exceptionWithReason:code:eid:
(SCCollectionException *)	+ exceptionWithName:
(SCCollectionException *)	+ exception

Creating and Initializing Source Exception
(id)	- initWithSource
(SCCollectionException *)	+ exceptionWithSource

Creating and Initializing Unsupported Collection Type Exception
(id)	- initWithUnsupportedType:
(SCCollectionException *)	+ exceptionWithUnsupportedType:

Creating and Initializing Read Only Exception
(id)	- initWithReadOnlyType:name:
(id)	- initWithReadOnlyType:
(SCCollectionException *)	+ exceptionWithReadOnlyType:name:
(SCCollectionException *)	+ exceptionWithReadOnlyType:

Creating and Initializing Null Object Exception
(id)	- initWithItemType:name:
(id)	- initWithItemType:
(SCCollectionException *)	+ exceptionWithItemType:name:
(SCCollectionException *)	+ exceptionWithItemType:

Creating and Initializing Source Object Exception
(id)	- initWithObject
(SCCollectionException *)	+ exceptionWithObject

Creating and Initializing Unsupported Class Exception
(id)	- initWithUnsupported:type:name:
(id)	- initWithUnsupported:type:
(SCCollectionException *)	+ exceptionWithUnsupported:type:name:
(SCCollectionException *)	+ exceptionWithUnsupported:type:

Creating and Initializing Unknown Class Exception
(id)	- initWithUnknown:type:name:
(id)	- initWithUnknown:type:
(SCCollectionException *)	+ exceptionWithUnknown:type:name:
(SCCollectionException *)	+ exceptionWithUnknown:type:

Creating and Initializing Incomparable Object Exception
(id)	- initWithNotComparableType:name:
(id)	- initWithNotComparableType:
(SCCollectionException *)	+ exceptionWithNotComparableType:name:
(SCCollectionException *)	+ exceptionWithNotComparableType:

Creating and Initializing Unsortable Collection Exception
(id)	- initWithNotSortableType:name:
(id)	- initWithNotSortableType:
(SCCollectionException *)	+ exceptionWithNotSortableType:name:
(SCCollectionException *)	+ exceptionWithNotSortableType:

Creating and Initializing Incorrect Sorter Exception
(id)	- initWithSorterType:name:
(id)	- initWithSorterType:
(SCCollectionException *)	+ exceptionWithSorterType:name:
(SCCollectionException *)	+ exceptionWithSorterType:

Creating and Initializing Unexpected Class Exception
(id)	- initWithUnexpected:expected:type:name:
(id)	- initWithUnexpected:expected:type:
(SCCollectionException *)	+ exceptionWithUnexpected:expected:type:name:
(SCCollectionException *)	+ exceptionWithUnexpected:expected:type:

Creating and Initializing Incorrect Index Exception
(id)	- initWithIndex:name:
(id)	- initWithIndex:
(SCCollectionException *)	+ exceptionWithIndex:name:
(SCCollectionException *)	+ exceptionWithIndex:

Creating and Initializing Incorrect Range Exception
(id)	- initWithRange:name:
(id)	- initWithRange:
(SCCollectionException *)	+ exceptionWithRange:name:
(SCCollectionException *)	+ exceptionWithRange:

Creating and Initializing Incorrect Index Set Exception
(id)	- initWithIndexSet:name:
(id)	- initWithIndexSet:
(SCCollectionException *)	+ exceptionWithIndexSet:name:
(SCCollectionException *)	+ exceptionWithIndexSet:

Creating and Initializing Indexes and Objects Count Exception
(id)	- initWithIndexesCount:objectsCount:
(SCCollectionException *)	+ exceptionWithIndexesCount:objectsCount:

Creating and Initializing Incorrect Key Exception
(id)	- initWithKey:name:
(id)	- initWithKey:
(SCCollectionException *)	+ exceptionWithKey:name:
(SCCollectionException *)	+ exceptionWithKey:

Creating and Initializing Keys and Objects Count Exception
(id)	- initWithKeysCount:objectsCount:
(SCCollectionException *)	+ exceptionWithKeysCount:objectsCount:

Creating and Initializing Empty Value Exception
(id)	- initValueForKey:name:
(id)	- initValueForKey:
(SCCollectionException *)	+ exceptionValueForKey:name:
(SCCollectionException *)	+ exceptionValueForKey:

Additional Inherited Members
Instance Methods inherited from SCException
Properties inherited from SCException
SCInteger	code
NSString *	eid

Detailed Description

Exception class SCCollectionException.

Since

version 1.1.3

Declares the collection exceptions.
Generated exceptions correspond to the following errors:

• SCL-20040: unspecified collection error
• SCL-20041: source collection does not exist
• SCL-20042: unsupported collection type
• SCL-20043: collection is read-only
• SCL-20044: adding a null pointer
• SCL-20045: source object does not exist
• SCL-20046: unsupported class
• SCL-20047: unknown class
• SCL-20048: incomparable collection object
• SCL-20049: collection does not support sorting
• SCL-20050: incorrect data sorter
• SCL-20051: unexpected class
• SCL-20052: incorrect index
• SCL-20053: incorrect objects range
• SCL-20054: incorrect index set
• SCL-20055: number of indexes does not match number of objects
• SCL-20056: incorrect object key
• SCL-20057: number of keys does not match number of objects
• SCL-20058: empty value

Method Documentation

+ (SCCollectionException *) exception

Returns a generic collection exception created by using the default settings.

Returns

A created exception

+ (SCCollectionException *) exceptionValueForKey:

(NSString *)

key

Returns an empty value exception SCL-20058 created by using the specified key.

Parameters

key	- value key

Returns

A created exception

+ (SCCollectionException *) exceptionValueForKey:		(NSString *)	key
name:		(NSString *)	name

Returns an empty value exception SCL-20058 created by using the specified key and collection name.

Parameters

key	- value key
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithIndex:

(SCIndex)

index

Returns an incorrect index exception SCL-20052 created by using the specified incorrect index.

Parameters

index

- incorrect index

Returns

A created exception

+ (SCCollectionException *) exceptionWithIndex:		(SCIndex)	index
name:		(NSString *)	name

Returns an incorrect index exception SCL-20052 created by using the specified incorrect index and collection name.

Parameters

index	- incorrect index
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithIndexesCount:		(SCULong)	indexes
objectsCount:		(SCULong)	objects

Returns an indexes and objects count exception SCL-20055 created by using the specified number of indexes and number of objects.

Parameters

indexes	- number of indexes
objects	- number of objects

Returns

A created exception

+ (SCCollectionException *) exceptionWithIndexSet:

(NSIndexSet *)

indexSet

Returns an incorrect index set exception SCL-20054 created by using the specified index set.

Parameters

indexSet

- incorrect index set

Returns

A created exception

+ (SCCollectionException *) exceptionWithIndexSet:		(NSIndexSet *)	indexSet
name:		(NSString *)	name

Returns an incorrect index set exception SCL-20054 created by using the specified index set and collection name.

Parameters

indexSet	- incorrect index set
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithItemType:

(NSString *)

type

Returns a null object exception SCL-20044 created by using the specified collection type.

Parameters

type	- collection type

Returns

A created exception

+ (SCCollectionException *) exceptionWithItemType:		(NSString *)	type
name:		(NSString *)	name

Returns a null object exception SCL-20044 created by using the specified collection type and collection name.

Parameters

type	- collection type
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithKey:

(NSString *)

key

Returns an incorrect key exception SCL-20056 created by using the specified incorrect key.

Parameters

key	- incorrect object key

Returns

A created exception

+ (SCCollectionException *) exceptionWithKey:		(NSString *)	key
name:		(NSString *)	name

Returns an incorrect key exception SCL-20056 created by using the specified incorrect key and collection name.

Parameters

key	- incorrect object key
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithKeysCount:		(SCULong)	keys
objectsCount:		(SCULong)	objects

Returns a keys and objects count exception SCL-20057 created by using the specified number of keys and number of objects.

Parameters

keys	- number of keys
objects	- number of objects

Returns

A created exception

+ (SCCollectionException *) exceptionWithName:

(NSString *)

name

Returns a generic collection exception created by using the specified collection name.

Parameters

name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithName:		(NSString *)	name
reason:		(NSString *)	reason
code:		(SCInteger)	code
eid:		(NSString *)	eid

Returns an exception created by using the specified collection name, error description, error code and error ID.

Parameters

name	- collection name
reason	- error description
code	- error code
eid	- error ID

Returns

A created exception

+ (SCCollectionException *) exceptionWithNotComparableType:

(NSString *)

type

Returns an incomparable object exception SCL-20048 created by using the specified collection type.

Parameters

type	- collection type

Returns

A created exception

+ (SCCollectionException *) exceptionWithNotComparableType:		(NSString *)	type
name:		(NSString *)	name

Returns an incomparable object exception SCL-20048 created by using the specified collection type and collection name.

Parameters

type	- collection type
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithNotSortableType:

(NSString *)

type

Returns an unsortable collection exception SCL-20049 created by using the specified collection type.

Parameters

type	- collection type

Returns

A created exception

+ (SCCollectionException *) exceptionWithNotSortableType:		(NSString *)	type
name:		(NSString *)	name

Returns an unsortable collection exception SCL-20049 created by using the specified collection type and collection name.

Parameters

type	- collection type
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithObject

Returns a source object exception SCL-20045 created by using the default settings.

Returns

A created exception

+ (SCCollectionException *) exceptionWithRange:

(NSRange)

range

Returns an incorrect range exception SCL-20053 created by using the specified incorrect range.

Parameters

range

- incorrect range

Returns

A created exception

+ (SCCollectionException *) exceptionWithRange:		(NSRange)	range
name:		(NSString *)	name

Returns an incorrect range exception SCL-20053 created by using the specified incorrect range and collection name.

Parameters

range	- incorrect range
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithReadOnlyType:

(NSString *)

type

Returns a read only exception SCL-20043 created by using the specified collection type.

Parameters

type	- collection type

Returns

A created exception

+ (SCCollectionException *) exceptionWithReadOnlyType:		(NSString *)	type
name:		(NSString *)	name

Returns a read only exception SCL-20043 created by using the specified collection type and collection name.

Parameters

type	- collection type
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithReason:		(NSString *)	reason
code:		(SCInteger)	code
eid:		(NSString *)	eid

Returns an exception created by using the specified error description, error code and error ID.

Parameters

reason	- error description
code	- error code
eid	- error ID

Returns

A created exception

+ (SCCollectionException *) exceptionWithSorterType:

(NSString *)

type

Returns an incorrect sorter exception SCL-20050 created by using the specified collection type.

Parameters

type	- collection type

Returns

A created exception

+ (SCCollectionException *) exceptionWithSorterType:		(NSString *)	type
name:		(NSString *)	name

Returns an incorrect sorter exception SCL-20050 created by using the specified collection type and collection name.

Parameters

type	- collection type
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithSource

Returns a source exception SCL-20041 created by using the defult settings.

Returns

A created exception

+ (SCCollectionException *) exceptionWithUnexpected:		(NSString *)	unexpected
expected:		(NSString *)	expected
type:		(NSString *)	type

Returns an unexpected class exception SCL-20051 created by using the specifies unexpected class name, expected class name and collection type.

Parameters

unexpected	- unexpected class name
expected	- expected class name
type	- collection type

Returns

A created exception

+ (SCCollectionException *) exceptionWithUnexpected:		(NSString *)	unexpected
expected:		(NSString *)	expected
type:		(NSString *)	type
name:		(NSString *)	name

Returns an unexpected class exception SCL-20051 created by using the specified unexpected class name, expected class name, collection type and collection name.

Parameters

unexpected	- unexpected class name
expected	- expected class name
type	- collection type
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithUnknown:		(NSString *)	cname
type:		(NSString *)	type

Returns an unknown class exception SCL-20047 created by using the specified unknown class name and collection type.

Parameters

cname	- unknown class name
type	- collection type

Returns

A created exception

+ (SCCollectionException *) exceptionWithUnknown:		(NSString *)	cname
type:		(NSString *)	type
name:		(NSString *)	name

Returns an unknown class exception SCL-20047 created by using the specified unknown class name, collection type and collection name.

Parameters

cname	- unknown class name
type	- collection type
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithUnsupported:		(NSString *)	cname
type:		(NSString *)	type

Returns an unsupported class exception SCL-20046 created by using the specified unsupported class name and collection type.

Parameters

cname	- unsupported class name
type	- collection type

Returns

A created exception

+ (SCCollectionException *) exceptionWithUnsupported:		(NSString *)	cname
type:		(NSString *)	type
name:		(NSString *)	name

Returns an unsupported class exception SCL-20046 created by using the specified unsupported class name, collection type and collection name.

Parameters

cname	- unsupported class name
type	- collection type
name	- collection name

Returns

A created exception

+ (SCCollectionException *) exceptionWithUnsupportedType:

(NSString *)

type

Returns an unsupported collection type exception SCL-20042 created by using the specified unsupported type name.

Parameters

type	- unsupported type name

Returns

A created exception

- (id) init

Initializes a generic collection exception using the default settings.

Returns

A newly initialized exception

- (id) initValueForKey:

(NSString *)

key

Initializes an empty value exception SCL-20058 using the specified key.

Parameters

key	- value key

Returns

A newly initialized exception

- (id) initValueForKey:		(NSString *)	key
name:		(NSString *)	name

Initializes an empty value exception SCL-20058 using the specified key and collection name.

Parameters

key	- value key
name	- collection name

Returns

A newly initialized exception

- (id) initWithIndex:

(SCIndex)

index

Initializes an incorrect index exception SCL-20052 using the specified incorrect index.

Parameters

index

- incorrect index

Returns

A newly initialized exception

- (id) initWithIndex:		(SCIndex)	index
name:		(NSString *)	name

Initializes an incorrect index exception SCL-20052 using the specified incorrect index and collection name.

Parameters

index	- incorrect index
name	- collection name

Returns

A newly initialized exception

- (id) initWithIndexesCount:		(SCULong)	indexes
objectsCount:		(SCULong)	objects

Initializes an indexes and objects count exception SCL-20055 created by using the specified number of indexes and number of objects.

Parameters

indexes	- number of indexes
objects	- number of objects

Returns

A newly initialized exception

- (id) initWithIndexSet:

(NSIndexSet *)

indexSet

Initializes an incorrect index set exception SCL-20054 using the specified index set.

Parameters

indexSet

- incorrect index set

Returns

A newly initializes exception

- (id) initWithIndexSet:		(NSIndexSet *)	indexSet
name:		(NSString *)	name

Initializes an incorrect index set exception SCL-20054 using the specified index set and collection name.

Parameters

indexSet	- incorrect index set
name	- collection name

Returns

A newly initialized exception

- (id) initWithItemType:

(NSString *)

type

Initializes a null object exception SCL-20044 using the specified collection type.

Parameters

type	- collection type

Returns

A newly initialized exception

- (id) initWithItemType:		(NSString *)	type
name:		(NSString *)	name

Initializes a null object exception SCL-20044 using the specified collection type and collection name.

Parameters

type	- collection type
name	- collection name

Returns

A newly initialized exception

- (id) initWithKey:

(NSString *)

key

Initializes an incorrect key exception SCL-20056 using the specified incorrect key.

Parameters

key	- incorrect object key

Returns

A newly initialized exception

- (id) initWithKey:		(NSString *)	key
name:		(NSString *)	name

Initializes an incorrect key exception SCL-20056 using the specified incorrect key and collection name.

Parameters

key	- incorrect object key
name	- collection name

Returns

A newly initialized exception

- (id) initWithKeysCount:		(SCULong)	keys
objectsCount:		(SCULong)	objects

Initializes a keys and objects count exception SCL-20057 using the specified number of keys and number of objects.

Parameters

keys	- number of keys
objects	- number of objects

Returns

A newly initialized exception

- (id) initWithName:

(NSString *)

name

Initializes a generic collection exception using the specified collection name.

Parameters

name	- collection name

Returns

A newly initialized exception

- (id) initWithName:		(NSString *)	name
reason:		(NSString *)	reason
code:		(SCInteger)	code
eid:		(NSString *)	eid

Initializes an exception using the specified collection name, error description, error code and error ID.

Attention

Designed initializer

Parameters

name	- collection name
reason	- error description
code	- error code
eid	- error id

Returns

A newly initialized exception

Reimplemented from SCException.

- (id) initWithNotComparableType:

(NSString *)

type

Initializes an incomparable object exception SCL-20048 using the specified collection type.

Parameters

type	- collection type

Returns

A newly initialized exception

- (id) initWithNotComparableType:		(NSString *)	type
name:		(NSString *)	name

Initializes an incomparable object exception SCL-20048 using the specified collection type and collection name.

Parameters

type	- collection type
name	- collection name

Returns

A newly initialized exception

- (id) initWithNotSortableType:

(NSString *)

type

Initializes an unsortable collection exception SCL-20049 using the specified collection type.

Parameters

type	- collection type

Returns

A newly initialized exception

- (id) initWithNotSortableType:		(NSString *)	type
name:		(NSString *)	name

Initializes an unsortable collection exception SCL-20049 using the specified collection type and collection name.

Parameters

type	- collection type
name	- collection name

Returns

A newly initialized exception

- (id) initWithObject

Initializes a source object exception SCL-20045 using the defult settings.

Returns

A newly initialized exception

- (id) initWithRange:

(NSRange)

range

Initializes an incorrect range exception SCL-20053 using the specified incorrect range.

Parameters

range

- incorrect range

Returns

A newly initialized exception

- (id) initWithRange:		(NSRange)	range
name:		(NSString *)	name

Initializes an incorrect range exception SCL-20053 using the specified incorrect range and collection name.

Parameters

range	- incorrect range
name	- collection name

Returns

A newly initialized exception

- (id) initWithReadOnlyType:

(NSString *)

type

Initializes a read only exception SCL-20043 using the specified collection type.

Parameters

type	- collection type

Returns

A newly initialized exception

- (id) initWithReadOnlyType:		(NSString *)	type
name:		(NSString *)	name

Initializes a read only exception SCL-20043 using the specified collection type and collection name.

Parameters

type	- collection type
name	- collection name

Returns

A newly initialized exception

- (id) initWithReason:		(NSString *)	reason
code:		(SCInteger)	code
eid:		(NSString *)	eid

Initializes an exception using the specified error description, error code and error ID.

Parameters

reason	- error description
code	- error code
eid	- error ID

Returns

A newly initialized exception

- (id) initWithSorterType:

(NSString *)

type

Initializes an incorect sorter exception SCL-20050 using the specified collection type.

Parameters

type	- collection type

Returns

A newly initialized exception

- (id) initWithSorterType:		(NSString *)	type
name:		(NSString *)	name

Initializes an incorrect sorter exception SCL-20050 using the specified collection type and collection name.

Parameters

type	- collection type
name	- collection name

Returns

A newly initialized exception

- (id) initWithSource

Initialies a source exception SCL-20041 using the default settings.

Returns

A newly initialized exception

- (id) initWithUnexpected:		(NSString *)	unexpected
expected:		(NSString *)	expected
type:		(NSString *)	type

Initializes an unexpected class exception SCL-20051 using the specified unexpected class name, expected class name and collection type.

Parameters

unexpected	- unexpected class name
expected	- expected class name
type	- collection type

Returns

A newly initialized exception

- (id) initWithUnexpected:		(NSString *)	unexpected
expected:		(NSString *)	expected
type:		(NSString *)	type
name:		(NSString *)	name

Initializes an unexpected class exception SCL-20051 using the specified unexpected class name, expected class name, collection type and collection name.

Parameters

unexpected	- unexpected class name
expected	- expected class name
type	- collection type
name	- collection name

Returns

A newly initialized exception

- (id) initWithUnknown:		(NSString *)	cname
type:		(NSString *)	type

Initializes an unknown class exception SCL-20047 using the specified unknown class name and collection type.

Parameters

cname	- unknown class name
type	- collection type

Returns

A newly initialized exception

- (id) initWithUnknown:		(NSString *)	cname
type:		(NSString *)	type
name:		(NSString *)	name

Initializes an unknown class exception SCL-20047 using the specified unknown class name, collection type and collection name.

Parameters

cname	- unknown class name
type	- collection type
name	- collection name

Returns

A newly initialized exception

- (id) initWithUnsupported:		(NSString *)	cname
type:		(NSString *)	type

Initializes an unsupported class exception SCL-20046 using the specified unsupported class name and collection type.

Parameters

cname	- unsupported class name
type	- collection type

Returns

A newly initialized exception

- (id) initWithUnsupported:		(NSString *)	cname
type:		(NSString *)	type
name:		(NSString *)	name

Initializes an unsupported class exception SCL-20046 using the specified unsupported class name, collection type and collection name.

Parameters

cname	- unsupported class name
type	- collection type
name	- collection name

Returns

A newly initialized exception

- (id) initWithUnsupportedType:

(NSString *)

type

Initializes an unsupported collection type exception SCL-20042 using the specified unsupported type name.

Parameters

type	- unsupported type name

Returns

A newly initialized exception

Property Documentation

- (NSString *) collectionName

readnonatomicretain

Erroneous collection name

- (NSString *) expected

readnonatomicretain

Expected class name (SCL-20051)

- (SCIndex) index

readnonatomicassign

Incorrect object index (SCL-20052)

- (SCULong) indexesCount

readnonatomicassign

Number of indexes (SCL-20055)

- (NSIndexSet *) indexSet

readnonatomicretain

Incorrect index set (SCL-20054)

- (NSString *) key

readnonatomicretain

Incorrect object key (SCL-20056)

- (SCULong) keysCount

readnonatomicassign

Number of keys (SCL-20057)

- (SCULong) objectsCount

readnonatomicassign

Number of objects (SCL-20055 and SCL-20057)

- (NSRange) range

readnonatomicassign

Incorrect objects range (SCL-20053)

- (NSString *) typeName

readnonatomicretain

Unsupported collection type name (SCL-20042)

- (NSString *) unexpected

readnonatomicretain

Unexpected class name (SCL-20051)

- (NSString *) unknown

readnonatomicretain

Unknown class name (SCL-20047)

- (NSString *) unsupported

readnonatomicretain

Unsupported class name (SCL-20046)

---

The documentation for this class was generated from the following files:

• SCCollectionException.h
• SCCollectionException.m