|
Samond Classes Library 1.2.1-RELEASE build 181
|
В ходе работы программного кода библиотеки могут возникать различные ошибки времени выполнения, обработка которых зависит от модуля, в котором возникла соответстующая ошибка. Некоторые модули могут обеспечивать выбор режима обработки ошибок, другие модули всегда генерируют исключительные ситуации.
Подробнее о механизме ошибок рассказывается в разделе Исключительные ситуации Руководства программиста.
Данные ошибки относятся не к конкретному модулю, а ко всей библиотеке сразу.
Исключительная ситуация SCException, являясь общим предком всех остальных исключительных ситуаций библиотеки, определяет понятие общая неопределенная ошибка, однако ни один модуль данной ошибки не генерирует. Данная ошибка введена исключительно для структуризации сообщений об ошибках.
Ошибка возникает при попытке вызова абстрактного метода какого-либо класса, например, в такой ситуации, как работа с абстрактным классом вместо соответствующего дочернего класса. При обнаружении данной ошибки генерируется исключительная ситуация SCAbstractMethodException.
Данная ошибка генерируется следующими классами библиотеки:
Может возникнуть в тех случаях, когда библиотека выполняет системный вызов или обращается к какой-либо стандартной библиотеке C/C++, библиотеке Objective C или программному коду Apple. При возникновении данной ошибки генерируется исключительная ситуация SCSystemException.
Генерируется следующими классами и категориями:
Данные ошибки могут возникать при работе с числовыми объектами на базе стандартного класса NSNumber и расширяющей ее категории NSNumber(SCNumber). При обнаружении данных ошибок генерируется исключительная ситуация SCNumberException.
Абстрактная ошибка, которая теоретически может возникнуть при работе с числовыми объектами. В настоящее время программный код библиотеки данную ошибку не генерирует.
Возникает в тех случаях, когда при работе механизмов потоков и коллекций обнаруживается неизвестный библиотеке тип числового объекта. Это может произойти в тех случаях, когда компания Apple внесла изменения в класс NSNumber, а мы не успели внести изменения в наш программный код.
Возникают при работе механизма потоков. Если не задействован специальный обработчик ошибок потоков или не указано изменение статуса потока или вызов исключительной ситуации системной ошибки (класс SCSystemException), то генерируется исключительная ситуация SCStreamException или SCFileStreamException.
Абстрактная ошибка неопределенной ошибки при работе потока. Программным кодом библиотеки в настоящее время не генерируется.
Ошибка возникает при попытках выполнить операции чтения или записи с потоком, который не был открыт.
При ее обнаружении генерируется исключительная ситуация SCStreamException.
Название вызвавшего ошибку потока может быть получено из свойства SCStreamException.streamName.
Ошибка может возникнуть при вызове методов классов:
Возникает при попытке осуществить операцию записи в поток, который был открыт в режиме только для чтения.
При обнаружении данной ошибки генерируется исключительная ситуация SCStreamException.
Название вызвавшего ошибку потока может быть получено из свойства SCStreamException.streamName.
Может возникнуть в ходе работы методов следующих классов:
Возникает при попытке осуществить операцию чтения из потока, который был открыт в режиме только для записи.
При обнаружении данной ошибки генерируется исключительная ситуация SCStreamException.
Название вызвавшего ошибку потока может быть получено из свойства SCStreamException.streamName.
Может возникнуть в ходе работы методов следующих классов:
Ошибка возникает в том случае, если при чтении из потока обнаруживается экземпляр неизвестного класса, то есть в потоке содержатся данные класса, неизвестного на данном компьютере. Это может возникнуть в том случае, если читаемый поток был создан версией программы, отличной от используемой в данный момент.
При обработке данной ошибки может быть сгенерирована исключительная ситуация SCStreamException.
Информацию об ошибке можно получить из следующих свойств исключительной ситуации SCStreamException:
Ошибка может возникнуть при работе со следующими классами:
Данная ошибка происходит, если поток вместо экземпляра одного класса обнаруживает экземпляр иного класса, нежели ожидалось изначально. Как правило, она возникает, если программа пытается считать из потока экземпляр не того класса, который там содержится. Например, в потоке находятся данные экземпляра класса NSString, тогда как программа пытается считать данные экземпляра класса NSNumber.
В ходе обработки ошибки может быть сгенерирована исключительная ситуация SCStreamException.
Информацию об ошибке можно получить из следующих свойств исключительной ситуации SCStreamException:
Возникновение данной ошибки возможно при работе с методами следующих классов:
Ошибка происходит в том случае, когда поток пытается работать с экземпляром класса, который не имеет определенных протоколом SCStreaming методов.При ее возникновении возможна генерация исключительной ситуации SCStreamException.
Данные об ошибке можно получить из следующих свойств исключительной ситуации SCStreamException:
Ошибка может возникнуть при работе с методами следующих классов:
Ошибка возникает в случае, когда из потока считывается меньше символов, чем ожидалось.
При обнаружении возможна генерация исключительной ситуации SCStreamException.
Данные по этой ошибке можно получить из следующий свойств исключительной ситуации SCStreamException:
Ошибка может произойти при работе со следующими классами:
Ошибка возникает в случае, когда в поток записалось меньше символов, чем было задано.
При обнаружении возможна генерация исключительной ситуации SCStreamException.
Данные по этой ошибке можно получить из следующий свойств исключительной ситуации SCStreamException:
Ошибка может произойти при работе со следующими классами:
Возникает при попытке открытия потока. Чаще всего это происходит при попытке:
При обработке данной ошибки возможна генерация исключительной ситуации SCStreamException.
Подробности ошибки можно получить из свойств класса SCStreamException:
Возникновение ошибки возможно при работе с методами следующих классов:
Может произойти во время операции чтения данных из потока и обычно связана с какими-либо системными проблемами или проблемами с носителем информации.Обнаружение может привести к генерации исключительной ситуации SCStreamException.
Информацию об ошибке можно получить из следующих свойств исключительной ситуации SCStreamException:
Ошибка может возникнуть при работе со следующими классами:
Может возникнуть во время операции записи данных в поток и обычно связана с какими-либо системными проблемами или проблемами с носителем информации.Обнаружение может привести к генерации исключительной ситуации SCStreamException.
Информацию об ошибке можно получить из следующих свойств исключительной ситуации SCStreamException:
Ошибка может возникнуть при работе со следующими классами:
Фиксируется при попытке потока работать с числовым объектом неизвестного типа. Связана с ошибкой SCL-20011.
При ее обнаружении возможна генерация исключительной ситуации SCStreamException.
Данные об ошибке могут быть прочитаны из следующих свойств класса SCStreamException:
Возникновение ошибки может произойти в следующих классах:
Возникает при попытке открытия файлового потока класса SCFileStream с режимом открытия, который не предусмотрен типом SCFileStreamOpenMode.
В результате обнаружения данной ошибки возможна генерация исключительной ситуации SCFileStreamException.
Информация о данной ошибке содержится в следующих свойствах класса SCFileStreamException:
Ошибка возникает при попытке открыть файловый поток SCFileStream без указания пути к файлу потока.
При обнаружении ошибки возможна генерация исключительной ситуации SCFileStreamException.
Фиксируется при попытке чтения данных за пределами файлового потока SCFileStream.
Обнаружение данной ошибки может привести к генерации исключительной ситуации SCFileStreamException, из свойства streamName которого можно выяснить путь к файлу данного потока.
Ошибка может возникнуть во время выполнения операции установки указателя файлового потока SCFileStream.
В случае возникновения данной ошибки может быть сгенерирована исключительная ситуация SCFileStreamException.
Следующие свойства класса SCFileStreamException обеспечивают доступ к информации об ошибке:
Ошибка возникает при попытке задать некорректное направление смещения (не поддерживаемое типом SCFileStreamOffsetWhence) при выполнении операции позиционирования в файловом потоке SCFileStream.
При ее возникновении возможна генерация исключительной ситуации SCFileStreamException.
Для получения информации об ошибке можно использовать следующие свойства класса SCFileStreamException:
Описанные в данном разделе ошибки могут возникать в ходе работы с различными коллекциям. При обнаружении этих ошибок механизм коллекций может генерировать исключительную ситуацию SCCollectionException.
Абстрактная ошибка коллекций. Программным кодом библиотеки не генерируется.
Ошибка возникает при попытке создания или инициализации новой коллекции на основании уже существующей коллекции, а также при попытке копирования данных из другой коллекции. Происходит данная ошибка в том случае, если исходная коллекция не существует - вызвавшему ошибку методу передан нулевой указатель.
Ошибка может возникнуть при работе со следующими классами:
Данная ошибка во многом аналогична предыдущей ошибке SCL-20041, но возникает в случае передачи соответствующим метода указателя на экземпляр класса, не являющийся классом коллекции. Название данного класса может быть выяснено через свойство typeName исключительной ситуации SCCollectionException.
Ошибка может возникнуть при работе со следующими классами:
Ошибка происходит при попытке внести изменения в коллекцию, которая находится в режиме только для чтения. Название вызвавшей ошибку коллекции можно получить через свойство collectionName класса исключительной ситуации SCCollectionException.
Ошибка может возникнуть при работе со следующими классами:
Возникает при попытке добавить в коллекцию нулевой указатель на экземпляр класса. Название вызвавшей ошибку коллекции можно получить через свойство collectionName класса исключительной ситуации SCCollectionException.
Ошибка может возникнуть при работе со следующими классами:
Ошибка возникает при попытке создания или инициализации новой коллекции на основании существующего объекта.
Отличие от ошибки SCL-20041 состоит в том, что данная ошибка возникает не во время создания коллекции на основании другой коллекции, а во время создания коллекции из единственного указанного исходного объекта.
Происходит данная ошибка в том случае, если исходного объекта не существует - вызвавшему ошибку методу передан нулевой указатель.
Ошибка может возникнуть при работе со следующими классами:
Ошибка возникает при попытке механизма коллекций работать с экземпляром класса, который не имеет методов взаимодействия с механизмом коллекций, то есть не соответствует протоколу SCCollectioning.
Название неподдерживаемого класса можно получить через свойство unsupported исключительной ситуации SCCollectionException.
Ошибка может возникнуть при работе со следующими классами:
Ошибка возникает в том случае, когда механизм коллекций сталкивается с классом, который неизвестнем системе, поэтому создание экземпляра класса невозможно. Основной причиной данной ошибки является несоответствие версий программного обеспечения, например программа пытается загрузить данные, созданные более новой программой.
Название неизвестного класса можно получить через свойство unknown исключительной ситуации SCCollectionException.
Ошибка может возникнуть при работе со следующими классами:
Возникает при попытке механизма коллекций осуществить сравнение объектов, которые не могут сравниваться друг с другом.
Ошибка может возникнуть при работе со следующими классами:
Ошибка вызывается при попытке выполнить сортировку коллекции, которая не поддерживает такую возможность, например, нельзя отсортировать данные множеств или словарей.
Ошибка может возникнуть при работе со следующими классами:
Ошибка возникает в ходе сортировки данных в коллекции, если механизм коллекций обнаруживает, что ему передан указатель на несуществующий сортировщик или указатель на экземпляр класса, который не является сортировщиком данных.
Ошибка может возникнуть при работе со следующими классами:
Данная ошибка возникает при попытке обратиться к элементу массива с некорретным индексом, например в том случае, если индекс запрошенного объекта находится за пределами массива. Вызвавший ошибку индекс можно узнать через свойство index класса SCCollectionException.
Ошибка может возникнуть при работе со следующими классами:
Данная ошибка возникает при попытке обратиться к элементам массива с некорретным диапазоном объектов. Вызвавший ошибку диапазон объектов можно узнать через свойство range класса SCCollectionException.
Ошибка может возникнуть при работе со следующими классами:
Ошибка возникает в одном из следующих случаев:
Получить информацию по списку индексов можно через свойство indexSet класса SCCollectionException.
Ошибка может возникнуть при работе со следующими классами:
Ошибка возникает при передаче методам механизма коллекций списка индексов и списка объектов, имеющих разное количество.
Информация об ошибке содержится в одном из свойств класса SCCollectionException:
Ошибка может возникнуть при работе со следующими классами:
Возникает при попытке передать словарю несуществующий ключ или запросить данные по записи с отсутствующим в словаре ключем. Данные о вызвавшем ошибку ключе можно получить из свойства key класса исключительной ситуации SCCollectionException.
Ошибка может возникнуть при работе со следующими классами:
Ошибка возникает при передаче методам механизма коллекций списка ключей и списка объектов, имеющих разное количество.
Информация об ошибке содержится в одном из свойств класса SCCollectionException:
Ошибка может возникнуть при работе со следующими классами:
Возникает при попытке установить для какого-либо ключа словаря несуществующее значение. Имя ключа можно выяснить через свойство key класса SCCollectionException.
Ошибка может возникнуть при работе со следующими классами:
Описанные в данном разделе ошибки могут возникать в ходе работы с различными текстовыми классами. При обнаружении этих ошибок текстовые классы могут генерировать исключительную ситуацию SCTextException.
Абстрактная ошибка при работе с текстовыми классами. Программным кодом библиотеки не генерируется.
Возникает при попытке создания текстовых объектов на основании несуществующих исходных объектов. Также ошибка генерируется при попытке замены содержимого текстовых объектов содержимым несуществующего исходного объекта.
Ошибка может возникнуть при работе со следующими классами:
Возникает при попытке загрузить текстовый файл из потока. Как правило, причиной такой ошибки является либо попытка чтения из несуществующего потока, либо попытка чтения из потока, доступного только для записи. Информацию о некорректном потоке можно получить через свойство SCTextException.stream "stream" класса SCTextExcepion.
Ошибка может возникнуть при работе с классом SCTextFile.
Возникает при попытке внесения изменений в текст, для которого ранее был установлен режим только для чтения. Имя вызвавшего ошибку текста можно выяснить через свойство textName класса SCTextException.
Ошибка может возникнуть при работе со следующими классами:
Генерируется при попытке добавить в текст нулевой указатель на строку. Нулевую строку нельзя путать с пустой строкой, которая просто не содержит никаких символов. Имя текста, в который была произведена попытка добавить нулевую строку, можно выяснить через свойство textName класса SCTextException.
Ошибка может возникнуть при работе со следующими классами:
Ошибка возникает при попытке загрузить или записать текст из потока, который не был открыт ранее. Данные об ошибочном потоке могут быть получены из свойства stream класса SCTextException.
Ошибка может возникнуть при работе с классом SCTextFile.
Ошибка возникает при попытке текстовых объектов работать с экземпляром класса, который не является экземпляром класса NSString или его дочерних классов. Название неподдерживаемого класса можно получить через свойство unsupported исключительной ситуации SCTextException.
Ошибка может возникнуть при работе со следующими классами:
Ошибка генерируется при возникновении ошибки в ходе чтения строк из потока. Информацию о вызвавшем ошибку потоке можно получить через свойство stream класса SCTextException.
Ошибка может возникнуть при работе с классом SCTextFile.
Ошибка возникает при попытке чтения или записи текстового файла с пустым путем. Может возникнуть в классе SCTextFile.
Возникает при попытке добавить в класс SCUniqueStrings строку, которая уже существует в данном списке. Также возможна генерация данной ошибки при попытке изменить строку, если новая строка уже находится в списке с отличным от изменяемой строки индексом.
Информация об ошибке содержится в следующих свойствах класса SCTextException:
Ошибка может возникнуть при работе с классом SCUniqueStrings.
Ошибка возникает в ходе сортировки строк в текстах, если механизм обработки текстов обнаруживает, что ему передан указатель на несуществующий сортировщик или указатель на экземпляр класса, который не является сортировщиком строк.
Ошибка может возникнуть при работе со следующими классами:
Возникает при попытке сохранить текстовый файл в потока. Как правило, причиной такой ошибки является либо попытка записи в несуществующий поток, либо попытка записи в поток, доступный только для чтения. Информацию о некорректном потоке можно получить через свойство SCTextException.stream "stream" класса SCTextExcepion.
Ошибка может возникнуть при работе с классом SCTextFile.
Ошибка возникает при попытке обратиться к индексу, выходящему за пределы списка строк. Дополнительную информацию о данной ошибке можно выяснить через следующие свойства класса SCTextException:
Ошибка может возникнуть при работе со следующими классами:
Данная ошибка возникает при попытке обратиться к тексту с некорретным диапазоном объектов. Вызвавший ошибку диапазон строк можно узнать через свойство range класса SCTextException.
Ошибка может возникнуть при работе со следующими классами:
Ошибка возникает в одном из следующих случаев:
Получить информацию по списку индексов можно через свойство indexSet класса SCTextException.
Ошибка может возникнуть при работе со следующими классами:
Данная ошибка генерируется некоторыми методами текстовых объектов при обнаружении несоответствия между количеством строк и количеством соответствующих этим строкам индексов. Дополнительную информацию по данной ошибке можно получить через следующие методы класса SCTextException:
Ошибка может возникнуть при работе со следующими классами:
Ошибка возникает при попытке обработать строки в пересекающихся диапазонах, тогда как логика работы требует, чтобы диапазоны строк были независимы друг от друга, например, при операциях обмена строками между двумя диапазонами. Дополнительную информацию по данной ошибке можно получить через следующие методы класса SCTextException:
Ошибка может возникнуть при работе со следующими классами:
Ошибка генерируется при возникновении ошибки в ходе записи строк в поток. Информацию о вызвавшем ошибку потоке можно получить через свойство stream класса SCTextException.
Ошибка может возникнуть при работе с классом SCTextFile.
1.8.9.1
