SCStreamException Class Reference

Exception class SCStreamException. More...

#import <SCStreamException.h>

Inheritance diagram for SCStreamException:

Instance Properties
NSString *	streamName
NSString *	unknown
NSString *	unexpected
NSString *	expected
NSString *	unsupported
SCUInteger	readedBytes
SCUInteger	writedBytes
SCUInteger	waitedBytes
SCInteger	openError
SCInteger	readError
SCInteger	writeError
NSString *	numberType

Creating and Initializing the Generic Stream Exceptions
(id)	- initWithStream:reason:code:eid:
(id)	- initWithReason:code:eid:
(id)	- initWithStream:
(id)	- init
(SCStreamException *)	+ exceptionWithStream:reason:code:eid:
(SCStreamException *)	+ exceptionWithReason:code:eid:
(SCStreamException *)	+ exceptionWithStream:
(SCStreamException *)	+ exception

Creating and Initializing Not Open Stream Exception
(id)	- initWithNotOpenStream:
(id)	- initWithNotOpen
(SCStreamException *)	+ exceptionWithNotOpenStream:
(SCStreamException *)	+ exceptionWithNotOpen

Creating and Initializing Read Only Stream Exception
(id)	- initWithReadOnlyStream:
(id)	- initWithReadOnly
(SCStreamException *)	+ exceptionWithReadOnlyStream:
(SCStreamException *)	+ exceptionWithReadOnly

Creating and Initializing Write Only Stream Exception
(id)	- initWithWriteOnlyStream:
(id)	- initWithWriteOnly
(SCStreamException *)	+ exceptionWithWriteOnlyStream:
(SCStreamException *)	+ exceptionWithWriteOnly

Creating and Initializing Unknown Class Exception
(id)	- initWithUnknown:stream:
(id)	- initWithUnknown:
(SCStreamException *)	+ exceptionWithUnknown:stream:
(SCStreamException *)	+ exceptionWithUnknown:

Creating and Initializing Unexpected Class Exception
(id)	- initWithUnexpected:expected:stream:
(id)	- initWithUnexpected:expected:
(SCStreamException *)	+ exceptionWithUnexpected:expected:stream:
(SCStreamException *)	+ exceptionWithUnexpected:expected:

Creating and Initializing Unsupported Class Exception
(id)	- initWithUnsupported:stream:
(id)	- initWithUnsupported:
(SCStreamException *)	+ exceptionWithUnsupported:stream:
(SCStreamException *)	+ exceptionWithUnsupported:

Creating and Initializing Incompleted Operation Exception
(id)	- initWithReaded:waited:stream:
(id)	- initWithReaded:waited:
(id)	- initWithWrited:waited:stream:
(id)	- initWithWrited:waited:
(SCStreamException *)	+ exceptionWithReaded:waited:stream:
(SCStreamException *)	+ exceptionWithReaded:waited:
(SCStreamException *)	+ exceptionWithWrited:waited:stream:
(SCStreamException *)	+ exceptionWithWrited:waited:

Creating and Initializing Opening Exception
(id)	- initWithOpenError:stream:
(id)	- initWithOpenError:
(SCStreamException *)	+ exceptionWithOpenError:stream:
(SCStreamException *)	+ exceptionWithOpenError:

Creating and Initializing Reading Exception
(id)	- initWithReadError:stream:
(id)	- initWithReadError:
(SCStreamException *)	+ exceptionWithReadError:stream:
(SCStreamException *)	+ exceptionWithReadError:

Creating and Initializing Writing Exception
(id)	- initWithWriteError:stream:
(id)	- initWithWriteError:
(SCStreamException *)	+ exceptionWithWriteError:stream:
(SCStreamException *)	+ exceptionWithWriteError:

Creating and Initializing Number Object Exception
(id)	- initWithUnsupportedNumberType:stream:
(id)	- initWithUnsupportedNumberType:
(SCStreamException *)	+ exceptionWithUnsupportedNumberType:stream:
(SCStreamException *)	+ exceptionWithUnsupportedNumberType:

Additional Inherited Members
Instance Methods inherited from SCException
(id)	- initWithName:reason:code:eid:
Properties inherited from SCException
SCInteger	code
NSString *	eid

Detailed Description

Exception class SCStreamException.

Since

version 1.1.3

Declares the stream common exceptions.
Generated by the class exceptions correspond to the following errors:

• SCL-20020: unspecified stream error
• SCL-20021: stream not open
• SCL-20022: read only stream
• SCL-20023: write only stream
• SCL-20024: unknown class
• SCL-20025: unexpected class
• SCL-20026: unsupported class
• SCL-20027: incompleted read operation
• SCL-20028: incompleted write operation
• SCL-20029: stream opening error
• SCL-20030: data read error
• SCL-20031: data write error
• SCL-20032: NSNumber error

Method Documentation

+ (SCStreamException *) exception

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

Returns

A created exception

+ (SCStreamException *) exceptionWithNotOpen

Returns a not open stream exception SCL-20021 created by using the default settings.

Returns

A created exception

+ (SCStreamException *) exceptionWithNotOpenStream:

(NSString *)

stream

Returns a not open stream exception SCL-20021 created by using the specified erroneous stream name.

Parameters

stream

- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) exceptionWithOpenError:

(SCInteger)

error

Returns a stream opening exception SCL-20029 created by using the specified error code.

Parameters

error

- the detected error code

Returns

A created exception

+ (SCStreamException *) exceptionWithOpenError:		(SCInteger)	error
stream:		(NSString *)	stream

Returns a stream opening exception SCL-20029 created by using the specified error code and erroneous stream name.

Parameters

error	- the detected error code
stream	- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) exceptionWithReaded:		(SCUInteger)	readed
waited:		(SCUInteger)	waited

Returns an incompleted reading operation SCL-20027 created by using the specified number of actually readed bytes and number of waited bytes.

Parameters

readed	- the number of the actually readed bytes
waited	- the number of the required bytes during the reading operation

Returns

A created exception

+ (SCStreamException *) exceptionWithReaded:		(SCUInteger)	readed
waited:		(SCUInteger)	waited
stream:		(NSString *)	stream

Returns an incompleted reading operation SCL-20027 created by using the specified number of actually readed bytes, number of waited bytes and erroneous stream name.

Parameters

readed	- the number of the actually readed bytes
waited	- the number of the required bytes during the reading operation
stream	- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) exceptionWithReadError:

(SCInteger)

error

Returns a reading exception SCL-20030 created by using the specified error code.

Parameters

error

- the reading error code

Returns

A created exception

+ (SCStreamException *) exceptionWithReadError:		(SCInteger)	error
stream:		(NSString *)	stream

Returns a reading exception SCL-20030 created by using the specified error code and stream name.

Parameters

error	- the reading error code
stream	- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) exceptionWithReadOnly

Returns a read only stream exception SCL-20022 created by using the default settings.

Returns

A created exception

+ (SCStreamException *) exceptionWithReadOnlyStream:

(NSString *)

stream

Returns a read only stream exception SCL-20022 created by using the specified erroneous stream name.

Parameters

stream

- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) 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	- the error description
code	- the code of the detected error
eid	- the error ID

Returns

A created exception

+ (SCStreamException *) exceptionWithStream:

(NSString *)

stream

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

Parameters

stream

- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) exceptionWithStream:		(NSString *)	stream
reason:		(NSString *)	reason
code:		(SCInteger)	code
eid:		(NSString *)	eid

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

Parameters

stream	- the name of the erroneous stream
reason	- the error description
code	- the code of the detected error
eid	- the error ID

Returns

A created exception

+ (SCStreamException *) exceptionWithUnexpected:		(NSString *)	unexpected
expected:		(NSString *)	expected

Returns an unexpected class exception SCL-20025 created by using the specified unexpected class name and expected class name.

Parameters

unexpected	- the unexpected class name
expected	- the expected class name

Returns

A created exception

+ (SCStreamException *) exceptionWithUnexpected:		(NSString *)	unexpected
expected:		(NSString *)	expected
stream:		(NSString *)	stream

Returns an unexpected class exception SCL-20025 created by using the specified unexpected class name, expected class name and erroneous stream name.

Parameters

unexpected	- the unexpected class name
expected	- the expected class name
stream	- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) exceptionWithUnknown:

(NSString *)

name

Returns an unknown class exception SCL-20024 created by using the specified unknown class name.

Parameters

name	- the unknown class name

Returns

A created exception

+ (SCStreamException *) exceptionWithUnknown:		(NSString *)	name
stream:		(NSString *)	stream

Returns an unknown class exception SCL-20024 created by using the specified unknown class name and erroneous stream name.

Parameters

name	- the unknown class name
stream	- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) exceptionWithUnsupported:

(NSString *)

name

Returns an unsupported class exception SCL-20026 created by using the specified unsupported class name.

Parameters

name	- the unsupported class name

Returns

A created exception

+ (SCStreamException *) exceptionWithUnsupported:		(NSString *)	name
stream:		(NSString *)	stream

Returns an unsupported class exception SCL-20026 created by using the specified unsupported class name and erroneous stream name.

Parameters

name	- the unsupported class name
stream	- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) exceptionWithUnsupportedNumberType:

(NSString *)

type

Returns a number object exception SCL-20032 created by using the specified unsupported number object type.

Parameters

type	- the type of the unsupported object number

Returns

A created exception

+ (SCStreamException *) exceptionWithUnsupportedNumberType:		(NSString *)	type
stream:		(NSString *)	stream

Returns a number object exception SCL-20032 created by using the specified type of the unsupported number object and erroneous stream name.

Parameters

type	- the unsupported number object type
stream	- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) exceptionWithWrited:		(SCUInteger)	writed
waited:		(SCUInteger)	waited

Returns an incompleted writing operation SCL-20028 created by using the specified number of actually writed bytes and number of waited bytes.

Parameters

writed	- the number of the actually writed bytes
waited	- the number of the waited bytes

Returns

A created exception

+ (SCStreamException *) exceptionWithWrited:		(SCUInteger)	writed
waited:		(SCUInteger)	waited
stream:		(NSString *)	stream

Returns an incompleted writing operation SCL-20028 created by using the specified number of actually writed bytes, number of waited bytes and erroneous stream name.

Parameters

writed	- the number of the actually writed bytes
waited	- the number of the waited bytes
stream	- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) exceptionWithWriteError:

(SCInteger)

error

Returns a writing exception SCL-20031 created by using the specified writing error code.

Parameters

error

- the writing error code

Returns

A created exception

+ (SCStreamException *) exceptionWithWriteError:		(SCInteger)	error
stream:		(NSString *)	stream

Returns a writing exception SCL-20031 created by using the specified writing error code and erroneous stream name.

Parameters

error	- the writing error code
stream	- the name of the erroneous stream

Returns

A created exception

+ (SCStreamException *) exceptionWithWriteOnly

Returns a write only stream exception SCL-20023 created by using the default settings.

Returns

A created exception

+ (SCStreamException *) exceptionWithWriteOnlyStream:

(NSString *)

stream

Returns a write only stream exception SCL-20023 created by using the specified erroneous stream name.

Parameters

stream

- the name of the erroneous stream

Returns

A created exception

- (id) init

Initializes a generic stream exception using the default settings.

Returns

A newly initialized exception

- (id) initWithNotOpen

Initializes a not open stream exception SCL-20021 by using the default settings.

Returns

A newly initialized exception

- (id) initWithNotOpenStream:

(NSString *)

stream

Initializes a not open stream exception SCL-20021 by using the specified erroneous stream name.

Parameters

stream

- the name of the erroneous stream

Returns

A newly initialized exception

- (id) initWithOpenError:

(SCInteger)

error

Initializes a stream opening exception SCL-20029 by using the specified error code.

Parameters

error

- the opening error code

Returns

A newly initialized exception

- (id) initWithOpenError:		(SCInteger)	error
stream:		(NSString *)	stream

Initializes a stream opening exception SCL-20029 by using the specified error code and erroneous stream name.

Parameters

error	- the code of the detected error
stream	- the name of the erroneous stream

Returns

A newly initialized exception

- (id) initWithReaded:		(SCUInteger)	readed
waited:		(SCUInteger)	waited

Initializes an incomplited reading operation SCL-20027 by using the specified number of actually readed bytes and number of waited bytes.

Parameters

readed	- the number of the actually readed bytes
waited	- the number of the required bytes

Returns

A newly initialized exception

- (id) initWithReaded:		(SCUInteger)	readed
waited:		(SCUInteger)	waited
stream:		(NSString *)	stream

Initializes an incomplited reading operation SCL-20027 by using the specified number of actually readed bytes, number of waited bytes and erroneous stream name.

Parameters

readed	- the number of the actually readed bytes
waited	- the number of the required bytes
stream	- the name of the erroneous stream

Returns

A newly initialized exception

- (id) initWithReadError:

(SCInteger)

error

Initializes a reading exception SCL-20030 by using the specified error code.

Parameters

error

- the reading error code

Returns

A newly initialized exception

- (id) initWithReadError:		(SCInteger)	error
stream:		(NSString *)	stream

Initializes a reading exception SCL-20030 by using the specified error code and stream name.

Parameters

error	- the reading error code
stream	- the name of the erroneous stream

Returns

A newly initialized exception

- (id) initWithReadOnly

Initializes a read only stream exception SCL-20022 by using the default settings.

Returns

A newly initialized exception

- (id) initWithReadOnlyStream:

(NSString *)

stream

Initializes a read only stream exception SCL-20022 by using the specified erroneous stream name.

Parameters

stream

- the name of the erroneous stream

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	- the error description
code	- the code of the detected error
eid	- the error ID

Returns

A newly initialized exception

- (id) initWithStream:

(NSString *)

stream

Initializes a generic stream exception using the specified erroneous stream name.

Parameters

stream

- the name of the erroneous stream

Returns

A newly initialized exception

- (id) initWithStream:		(NSString *)	stream
reason:		(NSString *)	reason
code:		(SCInteger)	code
eid:		(NSString *)	eid

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

Attention

Designed initializer

Parameters

stream	- the name of the erroneous stream
reason	- the error description
code	- the code of the detected error
eid	- the error ID

Returns

A newly initialized exception

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

Initializes an unexpected class exception SCL-20025 by using the specified unexpected class name and expected class name.

Parameters

unexpected	- the unexpected class name
expected	- the expected class name

Returns

A newly initialized exception

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

Initializes an unexpected class exception SCL-20025 by using the specified unexpected class name, expected class name and erroneous stream name.

Parameters

unexpected	- the unexpected class name
expected	- the expected class name
stream	- the name of the erroneous class

Returns

A newly initialized exception

- (id) initWithUnknown:

(NSString *)

name

Initializes an unknown class exception SCL-20024 by using the specified unknown class name.

Parameters

name	- the name of the unknown class

Returns

A newly initialized exception

- (id) initWithUnknown:		(NSString *)	name
stream:		(NSString *)	stream

Initializes an unknown class exception SCL-20024 by using the specified unknown class name and erroneous stream name.

Parameters

name	- the unknown class name
stream	- the name of the erroneous stream

Returns

A newly initialized exception

- (id) initWithUnsupported:

(NSString *)

name

Initializes an unsupported class exception SCL-20026 by using the specified unsupported class name.

Parameters

name	- the unsupported class name

Returns

A newly initialized exception

- (id) initWithUnsupported:		(NSString *)	name
stream:		(NSString *)	stream

Initializes an unsupported class exception SCL-20026 by using the specified unsupported class name and the erroneous stream name.

Parameters

name	- the unsupported class name
stream	- the name of the erroneous stream

Returns

A newly initialized exception

- (id) initWithUnsupportedNumberType:

(NSString *)

type

Initializes a number object exception SCL-20032 by using the specified type of the unsupported number object.

Parameters

type	- the unsupported number object type

Returns

A newly initialized exception

- (id) initWithUnsupportedNumberType:		(NSString *)	type
stream:		(NSString *)	stream

Initializes a number object exception SCL-20032 by using the specified unsupported number object type and erroneous stream name.

Parameters

type	- the type of the unsupported number object
stream	- the name of the erroneous name

Returns

A newly initialized exception

- (id) initWithWrited:		(SCUInteger)	writed
waited:		(SCUInteger)	waited

Initializes an incomplited writing operation SCL-20028 by using the specified number of actually writed bytes and number of waited bytes.

Parameters

writed	- the number of the actually writed bytes
waited	- the number of the waited bytes

Returns

A newly initialized exception

- (id) initWithWrited:		(SCUInteger)	writed
waited:		(SCUInteger)	waited
stream:		(NSString *)	stream

Initializes an incomplited writing operation SCL-20028 by using the specified number of actually writed bytes, number of waited bytes and erroneous stream name.

Parameters

writed	- the number of the actually writed bytes
waited	- the number of the waited bytes
stream	- the name of the erroneous stream

Returns

A newly initialized exception

- (id) initWithWriteError:

(SCInteger)

error

Initializes a writing exception SCL-20031 by using the specified writing error code.

Parameters

error

- the writing error code

Returns

A newly initialized

- (id) initWithWriteError:		(SCInteger)	error
stream:		(NSString *)	stream

Initializes a writing exception SCL-20031 by using the specified writing error code and erroneous stream name.

Parameters

error	- the writing error code
stream	- the name of the erroneous stream

Returns

A newly initialized exception

- (id) initWithWriteOnly

Initializes a write only stream exception SCL-20023 by using the default settings.

Returns

A newly initialized exception

- (id) initWithWriteOnlyStream:

(NSString *)

stream

Initializes a write only stream exception SCL-20023 by using the specified erroneous stream name.

Parameters

stream

- the name of the erroneous stream

Returns

A newly initialized exception

Property Documentation

- (NSString *) expected

readnonatomicretain

Name of the expected class

- (NSString *) numberType

readatomicassign

Unsupported number object type

- (SCInteger) openError

readnonatomicassign

Code of the stream opening error

- (SCUInteger) readedBytes

readnonatomicassign

Number of actually readed bytes from the stream

- (SCInteger) readError

readnonatomicassign

Code of the stream reading error

- (NSString *) streamName

readnonatomicretain

Erroneous stream name

- (NSString *) unexpected

readnonatomicretain

Name of the unexpected class

- (NSString *) unknown

readatomicretain

Name of the detected unknown class

- (NSString *) unsupported

readatomicretain

Name of the detected unsupported by streams class

- (SCUInteger) waitedBytes

readnonatomicassign

Number of waited during reading or writing operation bytes

- (SCUInteger) writedBytes

readnonatomicassign

Number of actually writed bytes to the stream

- (SCInteger) writeError

readnonatomicassign

Code of the stream writing error

---

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

• SCStreamException.h
• SCStreamException.m