Класс 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
SCFileStreamOpenMode	openMode
SCSystemError	seekError
NSInteger	offset
SCFileStreamOffsetWhence	whence

Создание и инициализация общих видов исключительных ситуаций (SCL-20020)
(instancetype)	+ exceptionWithStream:reason:code:eid:
(instancetype)	+ exceptionWithReason:code:eid:
(instancetype)	+ exceptionWithStream:
(instancetype)	+ exception
(instancetype)	- initWithStream:reason:code:eid:
(instancetype)	- initWithReason:code:eid:

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

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

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

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

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

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

Создание исключительных ситуаций незавершенных операций (SCL-20027 и SCL-20028)
(instancetype)	+ exceptionWithReaded:waited:stream:
(instancetype)	+ exceptionWithReaded:waited:
(instancetype)	+ exceptionWithWrited:waited:stream:
(instancetype)	+ exceptionWithWrited:waited:

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

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

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

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

Создание исключительной ситуации некорректного режима открытия потока (SCL-20033)
(instancetype)	+ exceptionWithOpenMode:path:
(instancetype)	+ exceptionWithOpenMode:

Создание исключительной ситуации пустого пути файлового потока (SCL-20034)
(instancetype)	+ exceptionWithEmptyPath

Создание исключительной ситуации обнаружения конца файлового потока (SCL-20035)
(instancetype)	+ exceptionWithEndOfFile:
(instancetype)	+ exceptionWithEndOfFile

Создание исключительных ситуаций при позиционировании в потоке (SCL-20036 и SCL-20037)
(instancetype)	+ exceptionWithSeekError:whence:offset:path:
(instancetype)	+ exceptionWithSeekError:whence:offset:
(instancetype)	+ exceptionWithSeekError:path:
(instancetype)	+ exceptionWithSeekError:
(instancetype)	+ exceptionWithWhence:path:
(instancetype)	+ exceptionWithWhence:

Дополнительные унаследованные члены
Методы экземпляра унаследованные от 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
• SCL-20033: некорректный режим открытия потока
• SCL-20034: задан пустой путь к файловому потоку
• SCL-20035: обнаружен конец потока
• SCL-20036: некорректный размер смещения в потоке
• SCL-20037: некорректное направление смещения в потоке

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

+ (instancetype) exception

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

Возвращает

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

+ (instancetype) exceptionWithEmptyPath

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

Возвращает

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

+ (instancetype) exceptionWithEndOfFile

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

Возвращает

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

+ (instancetype) exceptionWithEndOfFile:

(NSString *)

file

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

Аргументы

file	- имя файла потока

Возвращает

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

+ (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) exceptionWithOpenMode:

(SCFileStreamOpenMode)

mode

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

Аргументы

mode	- некорретный режим открытия потока

Возвращает

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

+ (instancetype) exceptionWithOpenMode:		(SCFileStreamOpenMode)	mode
path:		(NSString *)	path

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

Аргументы

mode	- некорретный режим открытия потока
path	- путь к файлу потока

Возвращает

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

+ (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) exceptionWithSeekError:

(SCSystemError)

error

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

Аргументы

error

- код системной ошибки

Возвращает

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

+ (instancetype) exceptionWithSeekError:		(SCSystemError)	error
path:		(NSString *)	path

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

Аргументы

error	- код системной ошибки
path	- путь к файлу потока

Возвращает

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

+ (instancetype) exceptionWithSeekError:		(SCSystemError)	error
whence:		(SCFileStreamOffsetWhence)	whence
offset:		(NSInteger)	offset

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

Аргументы

error	- код системной ошибки
whence	- направление смещения
offset	- смещение в символах

Возвращает

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

+ (instancetype) exceptionWithSeekError:		(SCSystemError)	error
whence:		(SCFileStreamOffsetWhence)	whence
offset:		(NSInteger)	offset
path:		(NSString *)	path

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

Аргументы

error	- код системной ошибки
whence	- направление смещения
offset	- смещение в символах
path	- путь к файловому потоку

Возвращает

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

+ (instancetype) exceptionWithStream:

(NSString *)

stream

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

Аргументы

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) exceptionWithWhence:

(SCFileStreamOffsetWhence)

whence

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

Аргументы

whence

- некорректное направление смещения

Возвращает

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

+ (instancetype) exceptionWithWhence:		(SCFileStreamOffsetWhence)	whence
path:		(NSString *)	path

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

Аргументы

whence	- некорректное направление смещения
path	- путь к файлу потока

Возвращает

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

+ (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) 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	- идентификатор ошибки

Возвращает

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

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

- (NSString*) expected

readnonatomicretain

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

- (NSString*) numberType

readnonatomicretain

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

- (NSInteger) offset

readnonatomicassign

Некорректное смещение в файловом потоке

- (SCInteger) openError

readnonatomicassign

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

- (SCFileStreamOpenMode) openMode

readnonatomicassign

Некорректный режим открытия потока

- (SCSize) readedBytes

readnonatomicassign

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

- (SCInteger) readError

readnonatomicassign

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

- (SCSystemError) seekError

readnonatomicassign

Код ошибки позиционирования в файловом потоке

- (NSString*) streamName

readnonatomicretain

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

- (NSString*) unexpected

readnonatomicretain

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

- (NSString*) unknown

readnonatomicretain

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

- (NSString*) unsupported

readnonatomicretain

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

- (SCSize) waitedBytes

readnonatomicassign

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

- (SCFileStreamOffsetWhence) whence

readnonatomicassign

Некорректное направление смещения в файловом потоке

- (SCSize) writedBytes

readnonatomicassign

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

- (SCInteger) writeError

readnonatomicassign

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

---

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

• SCStreamException.h
• SCStreamException.m