NSError Class Reference - Cocoaリファレンス日本語化計画

Tags: General リファレンス 未完 Cocoa

トップ> リファレンス > 全般 > NSErrorクラスリファレンス

NSError クラスリファレンス 翻訳元

このページの最終更新：2010-02-10
ADCの最終更新：2009-09-01

継承するクラス	NSObject
Top:準拠しているプロトコル	NSCoding NSCopying NSObject (NSObject)
フレームワーク	/System/Library/Frameworks/Foundation.framework
使用可能な環境	Safari 1.0がインストールされたMac OS X v10.2 Mac OS X v10.2.7以降 iPhone OS 2.0以降
宣言ファイル	NSError.h NSURLError.h
コンパニオンガイド	Error Handling Programming Guide For Cocoa?
サンプルコード	CoreRecipes? CustomAtomicStoreSubclass? Quartz Composer WWDC 2005 TextEdit? SimpleStickies? Sketch-112?

概観(Overview)

---

　NSErrotオブジェクトはエラーコードやエラー文字列のみを使ってできるものより豊かで拡張可能なエラー情報をカプセル化します。NSErrorオブジェクトの属性の中核はエラードメイン(文字列で表されます)と、ドメインに固有のエラーコード、アプリケーション特有の情報を含んだ辞書であるユーザ情報です。
　いくつかの既に定着しているドメインはMach、POSIX、OSStatus?のエラーと一致しています。FounationのエラーコードはCocoaのエラードメインにみることができます。これらは、Foundation Constants Reference?にまとめられています。更に、NSErrorクラスはエラーオブジェクト任意のユーザ情報辞書を添えることができ、またエラーを人間にわかりやすい形で記述して返す方法も用意しています。
　NSErrorクラスは抽象クラスではありません。このクラスは直接使うことができます。アプリケーションはlink_anchor plugin error : idが指定されていないか、存在しないページを指定しています。メソッドをオーバーライドしより良いローカライズされたエラー文字列を提供する為に、NSErrorのサブクラスを作成することもできます。
　通常は、メソッドはエラー状態を知らせるために、例えばNOやnilを返すよりは、単純なエラーオブジェクトをプレゼンすべきです。そのようにすれば、メソッドは任意でNSErrorオブジェクトの参照を返すことによって、エラーについてのより詳しい記述を与えることができます。

採用しているプロトコル(Adopted Protocols)

---

NSCoding
        encodeWithCoder:
        initWithCoder:
NSCopying
        copyWithZone:

このクラスでできること(Tasks)

---

エラーオブジェクトの生成(Creating Error Objects)

        + errorWithDomain:code:userInfo:
        – initWithDomain:code:userInfo:

エラー情報の取得(Getting Error Properties)

        – code
        – domain
        – userInfo

国際化されたエラー記述の取得(Getting a Localized Error Description)

        – localizedDescription
        – localizedRecoveryOptions
        – localizedRecoverySuggestion
        – localizedFailureReason

エラー修復試行者の取得(Getting the Error Recovery Attempter)

        – recoveryAttempter

ヘルプアンカーの表示(Displaying a Help Anchor)

        – helpAnchor

クラスメソッド

---

errorWithDomain:code:userInfo:

インスタンスメソッド

---

code

domain

helpAnchor

initWithDomain:code:userInfo:

localizedDescription

localizedFailureReason

localizedRecoveryOptions

localizedRecoverySuggestion

recoveryAttempter

userInfo

定数(Constants)

---

User info dictionary keys

Error Domains

---