Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы основы ссылка класса NSException

Опции
Развертывание Target:

На этой странице
Язык:

NSException

NSException используется для реализации обработки исключений и содержит информацию об исключении. Исключение является специальным условием, прерывающим нормальный поток реализации программы. Каждое приложение может прервать программу по разным причинам. Например, одно приложение могло бы интерпретировать сохранить файл в каталоге, защищенном от записи как исключение. В этом смысле исключение эквивалентно ошибке. Другое приложение могло бы интерпретировать нажатие клавиши пользователя (например, Ctrl-C) как исключение: индикация, что должен быть прерван продолжительный процесс.

Наследование

Соответствует

Оператор импорта

Swift

import Foundation

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.

Создание и повышение объекта NSException
  • exceptionWithName:reason:userInfo: + exceptionWithName:reason:userInfo:

    Создает и возвращает объект исключения.

    Объявление

    Objective C

    + (NSException *)exceptionWithName:(NSString *)name reason:(NSString *)reason userInfo:(NSDictionary *)userInfo

    Параметры

    name

    Имя исключения.

    reason

    Человекочитаемая строка сообщения, суммирующая причину исключения.

    userInfo

    Словарь, содержащий определяемую пользователем информацию, касающуюся исключения

    Возвращаемое значение

    Создаваемый NSException объект или nil если не мог бы быть создан объект.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – initWithName:reason:userInfo:
    – имя
    – причина
    – userInfo

  • raise:format: + raise:format:

    Удобный метод, создающий и повышающий исключение.

    Объявление

    Objective C

    + (void)raise:(NSString *)name format:(NSString *)format,, ...

    Параметры

    name

    Имя исключения.

    format,

    Человекочитаемая строка сообщения (т.е. причина исключения) со спецификациями преобразования для следующих аргументов переменной.

    ...

    Переменная информация, которая будет вставлена в отформатированную причину исключения (способом printf).

    Обсуждение

    Определяемая пользователем информация nil для объекта исключительной ситуации.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    + raise:format:arguments:
    – повышение

  • повышение (_: format:arguments:) + raise:format:arguments:

    Создает и повышает исключение с указанным именем, причиной и параметрами.

    Объявление

    Swift

    class func raise(_ name: String, format format: String, arguments argList: CVaListPointer)

    Objective C

    + (void)raise:(NSString *)name format:(NSString *)format arguments:(va_list)argList

    Параметры

    name

    Имя исключения.

    format

    Человекочитаемая строка сообщения (т.е. причина исключения) со спецификациями преобразования для аргументов переменной в argList.

    argList

    Переменная информация, которая будет вставлена в отформатированную причину исключения (способом vprintf).

    Обсуждение

    Определяемый пользователем словарь сгенерированного объекта nil.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    + raise:format:
    – повышение

  • init (name:reason:userInfo:) - initWithName:reason:userInfo: Определяемый инициализатор

    Инициализирует и возвращает недавно выделенный объект исключения.

    Объявление

    Swift

    init(name name: String, reason reason: String?, userInfo userInfo: [NSObject : AnyObject]?)

    Objective C

    - (instancetype)initWithName:(NSString *)name reason:(NSString *)reason userInfo:(NSDictionary *)userInfo

    Параметры

    name

    Имя исключения.

    reason

    Человекочитаемая строка сообщения, суммирующая причину исключения.

    userInfo

    Словарь, содержащий определяемую пользователем информацию, касающуюся исключения

    Возвращаемое значение

    Создаваемый NSException объект или nil если не мог бы быть создан объект.

    Обсуждение

    Это - определяемый инициализатор.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    + exceptionWithName:reason:userInfo:

  • повышение () - повышение

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

    Объявление

    Swift

    func raise()

    Objective C

    - (void)raise

    Обсуждение

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

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    + raise:format:
    + raise:format:arguments:

Запросы объекта NSException
  • имя имя Свойство

    Строка раньше однозначно определяла получатель. (только для чтения)

    Объявление

    Swift

    var name: String { get }

    Objective C

    @property(readonly, copy) NSString *name

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    + exceptionWithName:reason:userInfo:
    – initWithName:reason:userInfo:

  • причина причина Свойство

    Строка, содержащая «человекочитаемую» причину получателя. (только для чтения)

    Объявление

    Swift

    var reason: String? { get }

    Objective C

    @property(readonly, copy) NSString *reason

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    + exceptionWithName:reason:userInfo:
    – initWithName:reason:userInfo:

  • userInfo userInfo Свойство

    Словарь, содержащий специализированные данные, имеющие отношение к получателю. (только для чтения)

    Объявление

    Swift

    var userInfo: [NSObject : AnyObject]? { get }

    Objective C

    @property(readonly, copy) NSDictionary *userInfo

    Обсуждение

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

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    + exceptionWithName:reason:userInfo:
    – initWithName:reason:userInfo:

Получение стековых фреймов исключения
  • callStackReturnAddresses callStackReturnAddresses Свойство

    Адреса возврата вызова имели отношение к повышенному исключению. (только для чтения)

    Объявление

    Swift

    var callStackReturnAddresses: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *callStackReturnAddresses

    Обсуждение

    Массив NSNumber инкапсуляция объектов NSUInteger значения. Каждое значение является обратным адресом кадра вызова. Массив стековых фреймов запускается в точке, в которой исключение было сначала повышено с первыми элементами, являющимися новыми стековыми фреймами.

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

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

  • callStackSymbols callStackSymbols Свойство

    Массив, содержащий текущие символы стека вызовов. (только для чтения)

    Объявление

    Swift

    var callStackSymbols: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *callStackSymbols

    Обсуждение

    Массив строк, описывающих след стека вызовов в данный момент исключение, был сначала повышен. Формат каждой строки определяется backtrace_symbols() API

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.