Class

NSException

An object that represents a special condition that interrupts the normal flow of program execution. プログラム実行の通常の流れを妨げる特別な条件を表すオブジェクト。

Declaration 宣言 

@interface NSException : NSObject

Overview 概要

Use NSException to implement exception handling. An exception is a special condition that interrupts the normal flow of program execution. Each application can interrupt the program for different reasons. For example, one application might interpret saving a file in a directory that is write-protected as an exception. In this sense, the exception is equivalent to an error. Another application might interpret the user’s key-press (for example, Control-C) as an exception: an indication that a long-running process should abort. NSExceptionを使って例外処理を実装してください。例外は、プログラム実行の通常の流れをさえぎるある特別な条件です。各アプリケーションは、プログラムを異なる理由で中断できます。例えば、あるアプリケーションはファイルを書き込み禁止ディレクトリに保存することを１つの例外として解釈するかもしれません。この意味では、例外はエラーに等しいです。別のアプリケーションは、ユーザのキー押し込み（例えば、Control-C）を例外：ある長く動作しているプロセスを中止しなくてはならないという指示として解釈するかもしれません。

Topics 話題

Creating and Raising an NSException Object NSExceptionオブジェクトを作成するそして引き起こす

+ exceptionWithName:reason:userInfo:
Creates and returns an exception object . 例外オブジェクトを作成して返します。
+ raise:format:
A convenience method that creates and raises an exception. 例外を作成して引き起こす便宜メソッド。し
+ raise:format:arguments:
Creates and raises an exception with the specified name, reason, and arguments. ある例外をこの指定された名前、理由、そして引数で作成して引き起こします。
- initWithName:reason:userInfo:
Initializes and returns a newly allocated exception object. 新しくアロケートされた例外オブジェクトを初期化して返します。
- raise
Raises the receiver, causing program flow to jump to the local exception handler. レシーバを引き起こします、プログラムの流れをローカル例外ハンドラにジャンプさせます。

Querying an NSException Object NSExceptionオブジェクトに問いただす

name
A string used to uniquely identify the receiver. レシーバーを特有に識別するのに使われる文字列。
reason
A string containing a “human-readable” reason for the receiver. レシーバに対する “人に読みやすい” 理由を含んでいる文字列。
userInfo
A dictionary containing application-specific data pertaining to the receiver. レシーバに関係があるアプリケーション固有のデータを含んでいる辞書。

Getting Exception Stack Frames 例外スタックフレームを得る

callStackReturnAddresses
The call return addresses related to a raised exception. この呼び出しは、引き起こされた例外に関連したアドレスを返します。
callStackSymbols
An array containing the current call stack symbols. 現在の呼び出しスタックシンボルを含んでいる配列。

Related Types 関連する型

NSUncaughtExceptionHandler
NSExceptionName

Functions 関数

NSGetUncaughtExceptionHandler
Returns the top-level error handler. トップレベルのエラーハンドラを返します。
NSSetUncaughtExceptionHandler
Changes the top-level error handler. トップレベルのエラーハンドラを変更します。

Legacy Macros レガシーマクロ

NS_DURING
Marks the start of the exception-handling domain. 例外処理ドメインの始まりを印します。
NS_ENDHANDLER
Marks the end of the local event handler. ローカルイベントハンドラの終わりを印します。
NS_HANDLER
Marks the end of the exception-handling domain and the start of the local exception handler. 例外処理ドメインの終わりとローカル例外ハンドラの始まりを印します。
NS_VALUERETURN
Permits program control to exit from an exception-handling domain with a value of a specified type. プログラム制御が例外処理ドメインから指定された型の値で退出する許可を与えます。
NS_VOIDRETURN
Permits program control to exit from an exception-handling domain. プログラム制御が例外処理ドメインから退出する許可を与えます。

Relationships 関係

Inherits From 継承元

Conforms To 次に準拠