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, CFErrorRef
. See Toll-Free Bridging for more information.
NSError
は、それのCore Foundation相当物CFErrorRef
と「トールフリーブリッジ(通行料なしの橋渡し)」されます。さらなる情報のために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
をオーバーライドすることによって提供するかもしれません。