NSError

Overview 概要

Objective-C methods can signal an error condition by returning an NSError object by reference, which provides additional information about the kind of error and any underlying cause, if one can be determined. An NSError object may also provide localized error descriptions suitable for display to the user in its user info dictionary. See Error Handling Programming Guide for more information. Objective-Cメソッドは、NSErrorオブジェクトを参照によって返すことでエラー状態を合図できます、それはエラーの種類と何らかの根本的な原因についての追加的な情報を、もしそういったものが特定できるならば提供します。NSErrorオブジェクトはまた、表示するのに適したローカライズされたエラー説明をユーザに対してそれのの中で提供するかもしれません。Error Handling Programming Guideを更なる情報として見てください。

Methods in Foundation and other Cocoa frameworks most often produce errors in the Cocoa error domain (NSCocoaErrorDomain); error codes for the Cocoa Error Domain are documented in the Foundation Constants. There are also predefined domains corresponding to Mach (NSMachErrorDomain), POSIX (NSPOSIXErrorDomain), and Carbon (NSOSStatusErrorDomain) errors. Foundationおよび他のCocoaフレームワークは、大抵ほとんどはエラーをCocoaエラードメイン（NSCocoaErrorDomain）で生じます；Cocoa Error Domainに対するエラーコードは、Foundation Constantsで文書化されます。またMach（NSMachErrorDomain）、POSIX（NSPOSIXErrorDomain）、そしてCarbon（NSOSStatusErrorDomain）エラーに対応するあらかじめ定義されたドメインもあります。

NSError is “toll-free bridged” with its Core Foundation counterpart, CFError. See Toll-Free Bridging for more information. NSErrorは、それのCore Foundation相当物、CFErrorと「トールフリーブリッジ」されます。さらなる情報のためにToll-Free Bridgingを見てください。

Subclassing Notes サブクラス作成の注意

Applications may choose to create subclasses of NSError, for example, to provide better localized error strings by overriding localizedDescription. アプリケーションは、NSErrorのサブクラスを作成することを選んで，例えば、より良いローカライズされたエラー文字列をlocalizedDescriptionをオーバーライドすることによって提供するかもしれません。