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
SCSize	readedBytes
SCSize	writedBytes
SCSize	waitedBytes
SCInteger	openError
SCInteger	readError
SCInteger	writeError
NSString *	numberType

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

Creating and Initializing Not Open Stream Exception (SCL-20021)
(instancetype)	- initWithNotOpenStream:
(instancetype)	- initWithNotOpen
(instancetype)	+ exceptionWithNotOpenStream:
(instancetype)	+ exceptionWithNotOpen

Creating and Initializing Read Only Stream Exception (SCL-20022)
(instancetype)	- initWithReadOnlyStream:
(instancetype)	- initWithReadOnly
(instancetype)	+ exceptionWithReadOnlyStream:
(instancetype)	+ exceptionWithReadOnly

Creating and Initializing Write Only Stream Exception (SCL-20023)
(instancetype)	- initWithWriteOnlyStream:
(instancetype)	- initWithWriteOnly
(instancetype)	+ exceptionWithWriteOnlyStream:
(instancetype)	+ exceptionWithWriteOnly

Creating and Initializing Unknown Class Exception (SCL-20024)
(instancetype)	- initWithUnknown:stream:
(instancetype)	- initWithUnknown:
(instancetype)	+ exceptionWithUnknown:stream:
(instancetype)	+ exceptionWithUnknown:

Creating and Initializing Unexpected Class Exception (SCL-20025)
(instancetype)	- initWithUnexpected:expected:stream:
(instancetype)	- initWithUnexpected:expected:
(instancetype)	+ exceptionWithUnexpected:expected:stream:
(instancetype)	+ exceptionWithUnexpected:expected:

Creating and Initializing Unsupported Class Exception (SCL-20026)
(instancetype)	- initWithUnsupported:stream:
(instancetype)	- initWithUnsupported:
(instancetype)	+ exceptionWithUnsupported:stream:
(instancetype)	+ exceptionWithUnsupported:

Creating and Initializing Incompleted Operation Exception (SCL-20027 and SCL-20028)
(instancetype)	- initWithReaded:waited:stream:
(instancetype)	- initWithReaded:waited:
(instancetype)	- initWithWrited:waited:stream:
(instancetype)	- initWithWrited:waited:
(instancetype)	+ exceptionWithReaded:waited:stream:
(instancetype)	+ exceptionWithReaded:waited:
(instancetype)	+ exceptionWithWrited:waited:stream:
(instancetype)	+ exceptionWithWrited:waited:

Creating and Initializing Opening Exception (SCL-20029)
(instancetype)	- initWithOpenError:stream:
(instancetype)	- initWithOpenError:
(instancetype)	+ exceptionWithOpenError:stream:
(instancetype)	+ exceptionWithOpenError:

Creating and Initializing Reading Exception (SCL-20030)
(instancetype)	- initWithReadError:stream:
(instancetype)	- initWithReadError:
(instancetype)	+ exceptionWithReadError:stream:
(instancetype)	+ exceptionWithReadError:

Creating and Initializing Writing Exception (SCL-20031)
(instancetype)	- initWithWriteError:stream:
(instancetype)	- initWithWriteError:
(instancetype)	+ exceptionWithWriteError:stream:
(instancetype)	+ exceptionWithWriteError:

Creating and Initializing Number Object Exception (SCL-20032)
(instancetype)	- initWithUnsupportedNumberType:stream:
(instancetype)	- initWithUnsupportedNumberType:
(instancetype)	+ exceptionWithUnsupportedNumberType:stream:
(instancetype)	+ exceptionWithUnsupportedNumberType:

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

Detailed Description

Exception class SCStreamException.

SDK

macOS 10.6+, iOS 7.0+, GNUstep

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

+ (instancetype) exception

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

Returns

A created exception

+ (instancetype) exceptionWithNotOpen

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

Returns

A created exception

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) exceptionWithReaded:		(SCSize)	readed
waited:		(SCSize)	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

+ (instancetype) exceptionWithReaded:		(SCSize)	readed
waited:		(SCSize)	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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) exceptionWithReadOnly

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

Returns

A created exception

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) exceptionWithWrited:		(SCSize)	writed
waited:		(SCSize)	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

+ (instancetype) exceptionWithWrited:		(SCSize)	writed
waited:		(SCSize)	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

+ (instancetype) 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

+ (instancetype) 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

+ (instancetype) exceptionWithWriteOnly

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

Returns

A created exception

+ (instancetype) 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

- (instancetype) init

Initializes a generic stream exception using the default settings.

Returns

A newly initialized exception

- (instancetype) initWithNotOpen

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

Returns

A newly initialized exception

- (instancetype) 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

- (instancetype) 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

- (instancetype) 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

- (instancetype) initWithReaded:		(SCSize)	readed
waited:		(SCSize)	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

- (instancetype) initWithReaded:		(SCSize)	readed
waited:		(SCSize)	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

- (instancetype) 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

- (instancetype) 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

- (instancetype) initWithReadOnly

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

Returns

A newly initialized exception

- (instancetype) 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

- (instancetype) 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

- (instancetype) 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

- (instancetype) initWithStreamName:

(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

- (instancetype) 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

- (instancetype) 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

- (instancetype) 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

- (instancetype) 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

- (instancetype) 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

- (instancetype) 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

- (instancetype) 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

- (instancetype) 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

- (instancetype) initWithWrited:		(SCSize)	writed
waited:		(SCSize)	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

- (instancetype) initWithWrited:		(SCSize)	writed
waited:		(SCSize)	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

- (instancetype) 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

- (instancetype) 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

- (instancetype) initWithWriteOnly

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

Returns

A newly initialized exception

- (instancetype) 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

- (SCSize) 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

- (SCSize) waitedBytes

readnonatomicassign

Number of waited during reading or writing operation bytes

- (SCSize) 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