Класс SCStreamException

Класс исключительных ситуаций в потоках Подробнее...

#import <SCStreamException.h>

Граф наследования:SCStreamException:

Свойства экземпляра класса
NSString *	streamName
NSString *	unknown
NSString *	unexpected
NSString *	expected
NSString *	unsupported
SCSize	readedBytes
SCSize	writedBytes
SCSize	waitedBytes
SCInteger	openError
SCInteger	readError
SCInteger	writeError
NSString *	numberType

Создание и инициализация общих видов исключительных ситуаций
(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

Создание и инициализация исключительной ситуации неоткрытого потока (SCL-20021)
(instancetype)	- initWithNotOpenStream:
(instancetype)	- initWithNotOpen
(instancetype)	+ exceptionWithNotOpenStream:
(instancetype)	+ exceptionWithNotOpen

Создание и инициализация исключительной ситуации записи в поток в режиме только для чтения (SCL-20022)
(instancetype)	- initWithReadOnlyStream:
(instancetype)	- initWithReadOnly
(instancetype)	+ exceptionWithReadOnlyStream:
(instancetype)	+ exceptionWithReadOnly

Создание и инициализация исключительной ситуации чтения из потока в режиме только для записи (SCL-20023)
(instancetype)	- initWithWriteOnlyStream:
(instancetype)	- initWithWriteOnly
(instancetype)	+ exceptionWithWriteOnlyStream:
(instancetype)	+ exceptionWithWriteOnly

Создание и инициализация исключительной ситуации неизвестного класса (SCL-20024)
(instancetype)	- initWithUnknown:stream:
(instancetype)	- initWithUnknown:
(instancetype)	+ exceptionWithUnknown:stream:
(instancetype)	+ exceptionWithUnknown:

Создание и инициализация исключительной ситуации неожиданного класса (SCL-20025)
(instancetype)	- initWithUnexpected:expected:stream:
(instancetype)	- initWithUnexpected:expected:
(instancetype)	+ exceptionWithUnexpected:expected:stream:
(instancetype)	+ exceptionWithUnexpected:expected:

Создание и инициализация исключительной ситуации неподдерживаемого класса (SCL-20026)
(instancetype)	- initWithUnsupported:stream:
(instancetype)	- initWithUnsupported:
(instancetype)	+ exceptionWithUnsupported:stream:
(instancetype)	+ exceptionWithUnsupported:

Создание и инициализация исключительных ситуаций незавершенных операций (SCL-20027 и 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:

Создание и инициализация исключительной ситуации при открытии потока (SCL-20029)
(instancetype)	- initWithOpenError:stream:
(instancetype)	- initWithOpenError:
(instancetype)	+ exceptionWithOpenError:stream:
(instancetype)	+ exceptionWithOpenError:

Создание и инициализация исключительной ситуации ошибки чтения потока (SCL-20030)
(instancetype)	- initWithReadError:stream:
(instancetype)	- initWithReadError:
(instancetype)	+ exceptionWithReadError:stream:
(instancetype)	+ exceptionWithReadError:

Создание и инициализация исключительной ситуации ошибки записи в поток (SCL-20031)
(instancetype)	- initWithWriteError:stream:
(instancetype)	- initWithWriteError:
(instancetype)	+ exceptionWithWriteError:stream:
(instancetype)	+ exceptionWithWriteError:

Создание и инициализация исключительной ситуации числового объекта (SCL-20032)
(instancetype)	- initWithUnsupportedNumberType:stream:
(instancetype)	- initWithUnsupportedNumberType:
(instancetype)	+ exceptionWithUnsupportedNumberType:stream:
(instancetype)	+ exceptionWithUnsupportedNumberType:

Дополнительные унаследованные члены
Методы экземпляра унаследованные от SCException
(instancetype)	- initWithName:reason:code:eid:
Свойства унаследованные от SCException
SCInteger	code
NSString *	eid

Подробное описание

Класс исключительных ситуаций в потоках

SDK

macOS 10.6+, iOS 7.0+, GNUstep

Начиная с

версии 1.1.3

Данные исключительные ситуации генерируются при возникновении ошибок при работе с потоками библиотеки. Включает в себя следующие ошибки:

• SCL-20020: неопределенная ошибка потока
• SCL-20021: поток не открыт
• SCL-20022: поток открыт только для чтения
• SCL-20023: поток открыт только для записи
• SCL-20024: обнаружен неизвестный класс
• SCL-20025: обнаружен экземпляр класса неожиданного типа
• SCL-20026: обнаружен неподдерживаемый класс
• SCL-20027: операция чтения не завершена
• SCL-20028: операция записи не завершена
• SCL-20029: ошибка открытия потока
• SCL-20030: ошибка чтения данных
• SCL-20031: ошибка записи данных
• SCL-20032: ошибка класса NSNumber

Документация метода

+ (instancetype) exception

Классовый метод создает исключительную ситуацию неопределенного типа с использованием параметров по умолчанию.

Возвращает

Созданный экземпляр класса

+ (instancetype) exceptionWithNotOpen

Классовый метод создает исключительную ситуацию неоткрытого потока SCL-20021.

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithNotOpenStream:

(NSString *)

stream

Классовый метод создает исключительную ситуацию неоткрытого потока SCL-20021 с использованием заданного названия потока.

Аргументы

stream

- название потока

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithOpenError:

(SCInteger)

error

Классовый метод создает исключительную ситуацию при открытии потока SCL-20029 с использованием указанного кода ошибки.

Аргументы

error

- код ошибки

Возвращает

Созданная исключительная ситуация

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

Классовый метод создает исключительную ситуацию при открытии потока SCL-20029 с использованием указанных кода ошибки и названия потока.

Аргументы

error	- код ошибки
stream	- название потока

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithReaded:		(SCSize)	readed
waited:		(SCSize)	waited

Классовый метод создает исключительную ситуацию незавершенной операции чтения SCL-20027 с использованием указанных количества считанных символов и количества ожидавшихся символов.

Аргументы

readed	- количество считанных символов
waited	- количество ожидавшихся символов

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithReaded:		(SCSize)	readed
waited:		(SCSize)	waited
stream:		(NSString *)	stream

Классовый метод создает исключительную ситуацию незавершенной операции чтения SCL-20027 с использованием указанных количества считанных символов, количества ожидавшихся символов и названия потока.

Аргументы

readed	- количество считанных символов
waited	- количество ожидавшихся символов
stream	- название потока

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithReadError:

(SCInteger)

error

Классовый метод создает исключительную ситуацию ошибки чтения данных SCL-20030 с использованием указанного кода ошибки.

Аргументы

error

- код ошибки чтения данных

Возвращает

Созданная исключительная ситуация

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

Классовый метод создает исключительную ситуацию ошибки чтения данных SCL-20030 с использованием указанных кода ошибки и названия потока.

Аргументы

error	- код ошибки чтения данных
stream	- название потока

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithReadOnly

Классовый метод создает исключительную ситуацию записи в поток в режиме только для чтения SCL-20022.

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithReadOnlyStream:

(NSString *)

stream

Классовый метод создает исключительную ситуацию записи в поток в режиме только для чтения SCL-20022 с использованием указанного названия потока.

Аргументы

stream

- название потока

Возвращает

Созданная исключительная ситуация

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

Классовый метод создает исключительную ситуацию с использованием заданных описания, кода и идентификатора ошибки.

Аргументы

reason	- описание ошибки
code	- код ошибки
eid	- идентификатор ошибки

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithStream:

(NSString *)

stream

Классовый метод создает исключительную ситуацию неопределенного типа с использованием заданного названия потока.

Аргументы

stream

- название потока

Возвращает

Созданная исключительная ситуация

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

Классовый метод создает исключительную ситуацию с использованием заданных названия потока, описания ошибки, кода ошибки и идентификатора ошибки.

Аргументы

stream	- название потока
reason	- описание ошибки
code	- код ошибки
eid	- идентификатор ошибки

Возвращает

Созданная исключительная ситуация

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

Классовый метод создает исключительную ситуацию неожиданного класса SCL-20025 с использованием заданных названия неожиданного класса и названия ожидавшегося класса.

Аргументы

unexpected	- название неожиданного класса
expected	- название ожидавшегося класса

Возвращает

Созданная исключительная ситуация

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

Классовый метод создает исключительную ситуацию неожиданного класса SCL-20025 с использованием заданных названия неожиданного класса, названия ожидавшегося класса и названия потока.

Аргументы

unexpected	- название неожиданного класса
expected	- название ожидавшегося класса
stream	- название потока

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithUnknown:

(NSString *)

name

Классовый метод создает исключительную ситуацию неизвестного класса SCL-20024 с использованием заданного названия обнаруженного в потоке неизвестного класса.

Аргументы

name	- название неизвестного класса

Возвращает

Созданный экземпляр класса

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

Классовый метод создает исключительную ситуацию неизвестного класса SCL-20024 с использованием указанных названия обнаруженного в потоке неизвестного класса и названия потока.

Аргументы

name	- название неизвестного класса
stream	- название потока

Возвращает

Созданный экземпляр класса

+ (instancetype) exceptionWithUnsupported:

(NSString *)

name

Классовый метод создает исключительную ситуацию неподдерживаемого класса SCL-20026 с заданным названием неподдерживаемого класса.

Аргументы

name	- название неподдерживаемого класса

Возвращает

Созданная исключительная ситуация

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

Классовый метод создает исключительную ситуацию неподдерживаемого класса SCL-20026 с заданными названием неподдерживаемого класса и названием потока.

Аргументы

name	- название неподдерживаемого класса
stream	- название потока

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithUnsupportedNumberType:

(NSString *)

type

Классовый метод создает исключительную ситуацию числового неподдерживаемого типа числового объекта SCL-20032 с использованием названия неподдерживаемого типа числового объекта.

Аргументы

type	- неподдерживаемый тип числового объекта

Возвращает

Созданная исключительная ситуация

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

Классовый метод создает исключительную ситуацию числового неподдерживаемого типа числового объекта SCL-20032 с использованием названия неподдерживаемого типа числового объекта и названия потока.

Аргументы

type	- неподдерживаемый тип числового объекта
stream	- название потока

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithWrited:		(SCSize)	writed
waited:		(SCSize)	waited

Классовый метод создает исключительную ситуацию незавершенной операции записи SCL-20028 с использованием указанных количества записанных символов и количества ожидавшихся символов.

Аргументы

writed	- количество записанных символов
waited	- количество ожидавшихся символов

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithWrited:		(SCSize)	writed
waited:		(SCSize)	waited
stream:		(NSString *)	stream

Классовый метод создает исключительную ситуацию незавершенной операции записи SCL-20028 с использованием указанных количества записанных символов, количества ожидавшихся символов и названия потока.

Аргументы

writed	- количество записанных символов
waited	- количество ожидавшихся символов
stream	- название потока

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithWriteError:

(SCInteger)

error

Классовый метод создает исключительную ситуацию ошибки записи данных SCL-20031 с использованием указанного кода ошибки.

Аргументы

error

- код ошибки записи данных

Возвращает

Созданная исключительная ситуация

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

Классовый метод создает исключительную ситуацию ошибки записи данных SCL-20031 с использованием указанных кода ошибки и названия потока.

Аргументы

error	- код ошибки записи данных
stream	- название потока

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithWriteOnly

Классовый метод создает исключительную ситуацию чтения из потока в режиме только для записи SCL-20023.

Возвращает

Созданная исключительная ситуация

+ (instancetype) exceptionWithWriteOnlyStream:

(NSString *)

stream

Классовый метод создает исключительную ситуацию чтения из потока в режиме только для записи SCL-20023 с использованием указанного названия потока.

Аргументы

stream

- название потока

Возвращает

Созданная исключительная ситуация

- (instancetype) init

Метод инициализации исключительной ситуации неопределенного типа.

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithNotOpen

Метод выполняет инициализацию исключительной ситуации неоткрытого потока SCL-20021.

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithNotOpenStream:

(NSString *)

stream

Метод выполняет инициализацию исключительной ситуации неоткрытого потока SCL-20021 с использованием указанного названия потока.

Аргументы

stream

- название потока

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithOpenError:

(SCInteger)

error

Метод инициализирует исключительную ситуацию при открытии потока SCL-20029 с использованием указанного кода ошибки.

Аргументы

error

- код ошибки

Возвращает

Инициализированная исключительная ситуация

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

Метод инициализирует исключительную ситуацию при открытии потока SCL-20029 с использованием указанных кода ошибки и названия потока.

Аргументы

error	- код ошибки
stream	- название потока

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithReaded:		(SCSize)	readed
waited:		(SCSize)	waited

Метод инициализирует исключительную ситуацию незавершенной операции чтения SCL-20027 с использованием указанных количества считанных символов и количества ожидавшихся символов.

Аргументы

readed	- количество считанных символов
waited	- количество ожидавшихся символов

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithReaded:		(SCSize)	readed
waited:		(SCSize)	waited
stream:		(NSString *)	stream

Метод инициализирует исключительную ситуацию незавершенной операции чтения SCL-20027 с использованием указанных количества считанных символов, количества ожидавшихся символов и названия потока.

Аргументы

readed	- количество считанных символов
waited	- количество ожидавшихся символов
stream	- название потока

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithReadError:

(SCInteger)

error

Метод инициализирует исключительную ситуацию ошибки чтения данных SCL-20030 с использованием указанного кода ошибки.

Аргументы

error

- код ошибки чтения данных

Возвращает

Инициализированная исключительная ситуация

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

Метод инициализирует исключительную ситуацию ошибки чтения данных SCL-20030 с использованием указанных кода ошибки и названия потока.

Аргументы

error	- код ошибки чтения данных
stream	- название потока

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithReadOnly

Метод выполняет инициализацию исключительной ситуации записи в поток в режиме тольк для чтения SCL-20022.

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithReadOnlyStream:

(NSString *)

stream

Метод выполняет инициализацию исключительной ситуации записи в поток в режиме только для чтения SCL-20022 с использованием указанного названия потока.

Аргументы

stream

- название потока

Возвращает

Инициализированная исключительная ситуация

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

Метод инициализирует исключительную ситуацию с использованием заданных описания, кода и идентификатора ошибки

Аргументы

reason	- описание ошибки
code	- код ошибки
eid	- идентификатор ошибки

Возвращает

Инициализированная исключительная ситуация

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

Метод инициализирует исключительную ситуацию с использованием заданных названия потока, описания ошибки, кода ошибки и идентификатора ошибки.

Внимание

Является назначенным инициализатором класса

Аргументы

stream	- название потока
reason	- описание ошибки
code	- код ошибки
eid	- идентификатор ошибки

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithStreamName:

(NSString *)

stream

Метод инициализации исключительной ситуации неопределенного типа с использованием указанного названия потока.

Аргументы

stream

- название потока

Возвращает

Инициализированная исключительная ситуация

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

Метод инициализирует исключительную ситуацию неожиданного класса SCL-20025 с использованием заданных названия неожиданного класса и названия ожидавшегося.

Аргументы

unexpected	- название неожиданного класса
expected	- название ожидавшегося класса

Возвращает

Инициализированная исключительная ситуация

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

Метод инициализирует исключительную ситуацию неожиданного класса SCL-20025 с использованием заданных названия неожиданного класса, названия ожидавшегося класса и названия потока.

Аргументы

unexpected	- название неожиданного класса
expected	- название ожидавшегося класса
stream	- название потока

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithUnknown:

(NSString *)

name

Метод инициализации исключительной ситуации неизвестного класса SCL-20024 с использованием заданного названия обнаруженного в потоке неизвестного класса.

Аргументы

name	- название неизвестного класса

Возвращает

Инициализированная исключительная ситуация

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

Метод инициализации исключительной ситуации неизвестного класса SCL-20024 с использованием заданных названия обнаруженного в потоке неизвестного класса и названия потока.

Аргументы

name	- название неизвестного класса
stream	- название потока

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithUnsupported:

(NSString *)

name

Метод инициализации исключительной ситуации неподдерживаемого класса SCL-20026 с заданными названием неподдерживаемого класса.

Аргументы

name	- название неподдерживаемого класса

Возвращает

Инициализированная исключительная ситуация

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

Метод инициализации исключительной ситуации неподдерживаемого класса SCL-20026 с заданными названием неподдерживаемого класса и названием потока.

Аргументы

name	- название неподдерживаемого класса
stream	- название потока

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithUnsupportedNumberType:

(NSString *)

type

Метод инициализирует исключительную ситуацию числового неподдерживаемого типа числового объекта SCL-20032 с использованием названия неподдерживаемого типа числового объекта.

Аргументы

type	- неподдерживаемый тип числового объекта

Возвращает

Инициализированная исключительная ситуация

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

Метод инициализирует исключительную ситуацию числового неподдерживаемого типа числового объекта SCL-20032 с использованием названия неподдерживаемого типа числового объекта и названия потока.

Аргументы

type	- неподдерживаемый тип числового объекта
stream	- название потока

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithWrited:		(SCSize)	writed
waited:		(SCSize)	waited

Метод инициализирует исключительную ситуацию незавершенной операции записи SCL-20028 с использованием указанных количества записанных символов и количества ожидавшихся символов.

Аргументы

writed	- количество записанных символов
waited	- количество ожидавшихся символов

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithWrited:		(SCSize)	writed
waited:		(SCSize)	waited
stream:		(NSString *)	stream

Метод инициализирует исключительную ситуацию незавершенной операции записи SCL-20028 с использованием указанных количества записанных символов, количества ожидавшихся символов и названия потока.

Аргументы

writed	- количество записанных символов
waited	- количество ожидавшихся символов
stream	- название потока

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithWriteError:

(SCInteger)

error

Метод инициализирует исключительную ситуацию ошибки записи данных SCL-20031 с использованием указанного кода ошибки.

Аргументы

error

- код ошибки записи данных

Возвращает

Инициализированная исключительная ситуация

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

Метод инициализирует исключительную ситуацию ошибки записи данных SCL-20031 с использованием указанных кода ошибки и названия потока.

Аргументы

error	- код ошибки записи данных
stream	- название потока

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithWriteOnly

Метод выполняет инициализацию исключительной ситуации чтения из потока в режиме только для записи SCL-20023.

Возвращает

Инициализированная исключительная ситуация

- (instancetype) initWithWriteOnlyStream:

(NSString *)

stream

Метод выполняет инициализацию исключительной ситуации чтения из потока в режиме только для записи SCL-20023 с использованием указанного названия потока.

Аргументы

stream

- название потока

Возвращает

Инициализированная исключительная ситуация

Полный список свойств

- (NSString *) expected

readnonatomicretain

Название ожидавшегося класса

- (NSString *) numberType

readatomicassign

Неподдерживаемый тип числового объекта

- (SCInteger) openError

readnonatomicassign

Код ошибки открытия потока

- (SCSize) readedBytes

readnonatomicassign

Количество считанных из потока символов

- (SCInteger) readError

readnonatomicassign

Код ошибки чтения данных из потока

- (NSString *) streamName

readnonatomicretain

Название вызвавшего ошибку потока

- (NSString *) unexpected

readnonatomicretain

Название неожиданного класса

- (NSString *) unknown

readatomicretain

Название обнаруженного неизвестного класса

- (NSString *) unsupported

readatomicretain

Название обнаруженного класса, который не поддерживает потоки

- (SCSize) waitedBytes

readnonatomicassign

Количество ожидавшихся в ходе операции чтения или записи символов

- (SCSize) writedBytes

readnonatomicassign

Количество записанных в поток символов

- (SCInteger) writeError

readnonatomicassign

Код ошибки записи данных в поток

---

Объявления и описания членов классов находятся в файлах:

• SCStreamException.h
• SCStreamException.m