CPException Class Reference

Used to implement exception handling (creating & raising). More...

#import <CPException.h>

Inheritance diagram for CPException:

Instance Methods
(id)	- copy
(CPString)	- description
(void)	- encodeWithCoder:
(id)	- initWithCoder:
(id)	- initWithName:reason:userInfo:
(BOOL)	- isEqual:
(CPString)	- name
(void)	- raise
(CPString)	- reason
(CPDictionary)	- userInfo
Instance Methods inherited from CPObject
(void)	- addObserver:forKeyPath:options:context:
(void)	- applyChange:toKeyPath:
(id)	- autorelease
(id)	- awakeAfterUsingCoder:
(void)	- awakeFromCib
(void)	- bind:toObject:withKeyPath:options:
(Class)	- classForCoder
(Class)	- classForKeyedArchiver
(CPString)	- className
(void)	- dealloc
(CPDictionary)	- dictionaryWithValuesForKeys:
(void)	- didChange:valuesAtIndexes:forKey:
(void)	- didChangeValueForKey:
(void)	- didChangeValueForKey:withSetMutation:usingObjects:
(void)	- doesNotRecognizeSelector:
(CPArray)	- exposedBindings
(id)	- forwardingTargetForSelector:
(void)	- forwardInvocation:
(unsigned)	- hash
(BOOL)	- implementsSelector:
(CPDictionary)	- infoForBinding:
(id)	- init
(BOOL)	- isKindOfClass:
(BOOL)	- isMemberOfClass:
(BOOL)	- isProxy
(IMP)	- methodForSelector:
(CPMethodSignature)	- methodSignatureForSelector:
(id)	- mutableArrayValueForKey:
(id)	- mutableArrayValueForKeyPath:
(id)	- mutableCopy
(id)	- mutableSetValueForKey:
(id)	- mutableSetValueForKeyPath:
(id)	- performSelector:
(id)	- performSelector:withObject:
(id)	- performSelector:withObject:withObject:
(id)	- performSelector:withObjects:
(void)	- release
(void)	- removeObserver:forKeyPath:
(id)	- replacementObjectForArchiver:
(id)	- replacementObjectForCoder:
(id)	- replacementObjectForKeyedArchiver:
(BOOL)	- respondsToSelector:
(id)	- retain
(id)	- self
(void)	- setValue:forKey:
(void)	- setValue:forKeyPath:
(void)	- setValue:forUndefinedKey:
(void)	- setValuesForKeysWithDictionary:
(CPString)	- UID
(void)	- unbind:
(Class)	- valueClassForBinding:
(id)	- valueForKey:
(id)	- valueForKeyPath:
(id)	- valueForUndefinedKey:
(void)	- willChange:valuesAtIndexes:forKey:
(void)	- willChangeValueForKey:
(void)	- willChangeValueForKey:withSetMutation:usingObjects:

Class Methods
(id)	+ alloc
(CPException)	+ exceptionWithName:reason:userInfo:
(void)	+ raise:reason:
Class Methods inherited from CPObject
(BOOL)	+ accessInstanceVariablesDirectly
(id)	+ allocWithCoder:
(BOOL)	+ automaticallyNotifiesObserversForKey:
(Class)	+ class
(void)	+ exposeBinding:
(void)	+ initialize
(IMP)	+ instanceMethodForSelector:
(BOOL)	+ instancesRespondToSelector:
(BOOL)	+ isSubclassOfClass:
(CPSet)	+ keyPathsForValuesAffectingValueForKey:
(void)	+ load
(id)	+ new
(void)	+ setVersion:
(Class)	+ superclass
(int)	+ version

Additional Inherited Members
Instance Variables inherited from CPObject
Class	isa

Detailed Description

Used to implement exception handling (creating & raising).

An example of throwing an exception in Objective-J:

// some code here...
if (input == nil)
    [CPException raise:"MyException" reason:"You didn't do something right."];

// code that gets executed if no exception was raised

Definition at line 2 of file CPException.h.

Method Documentation

+ (id) alloc

implementation

Allocates a new instance of the receiving class

Reimplemented from CPObject.

Definition at line 51 of file CPException.j.

- (id) copy

implementation

Makes a deep copy of the receiver. The copy should be functionally equivalent to the receiver.

Returns

the copy of the receiver

Reimplemented from CPObject.

Provided by category CPException(CPCopying).

Definition at line 156 of file CPException.j.

- (CPString) description

implementation

Returns the exception's reason.

Reimplemented from CPObject.

Definition at line 128 of file CPException.j.

- (void) encodeWithCoder: (CPCoder)  aCoder

implementation

Encodes the exception's data into a coder.

Parameters

aCoder

the coder to which the data will be written

Provided by category CPException(CPCoding).

Definition at line 190 of file CPException.j.

+ (CPException) exceptionWithName: (CPString)  aName reason: (CPString)  aReason userInfo: (CPDictionary)  aUserInfo

implementation

Creates an exception with a name, reason and user info.

Parameters

aName	the name of the exception
aReason	the reason the exception occurred
aUserInfo	a dictionary containing information about the exception

Returns

the new exception

Definition at line 75 of file CPException.j.

- (id) initWithCoder: (CPCoder)  aCoder

implementation

Initializes the exception with data from a coder.

Parameters

aCoder

the coder from which to read the exception data

Returns

the initialized exception

Provided by category CPException(CPCoding).

Definition at line 174 of file CPException.j.

- (id) initWithName: (CPString)  aName reason: (CPString)  aReason userInfo: (CPDictionary)  aUserInfo

implementation

Initializes the exception.

Parameters

aName	the name of the exception
aReason	the reason for the exception
aUserInfo	a dictionary containing information about the exception

Returns

the initialized exception

Definition at line 87 of file CPException.j.

- (BOOL) isEqual: (id)  anObject

implementation

Determines if anObject is functionally equivalent to the receiver.

Returns

YES if anObject is functionally equivalent to the receiver.

Reimplemented from CPObject.

Definition at line 141 of file CPException.j.

- (CPString) name

implementation

Returns the name of the exception.

Definition at line 104 of file CPException.j.

- (void) raise

implementation

Raises the exception and causes the program to go to the exception handler.

Definition at line 136 of file CPException.j.

+ (void) raise: (CPString)  aName reason: (CPString)  aReason

implementation

Raises an exception with a name and reason.

Parameters

aName	the name of the exception to raise
aReason	the reason for the exception

Definition at line 63 of file CPException.j.

- (CPString) reason

implementation

Returns the reason for the exception.

Definition at line 112 of file CPException.j.

- (CPDictionary) userInfo

implementation

Returns data containing info about the receiver.

Definition at line 120 of file CPException.j.

---

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

• Foundation/CPException.h
• Foundation/CPException.j