Class

NSAssertionHandler

An object that logs an assertion to the console. コンソールにアサーションを記録するオブジェクト。

Declaration 宣言

class NSAssertionHandler : NSObject

Overview 概要

NSAssertionHandler objects are automatically created to handle false assertions. Assertion macros, such as NSAssert and NSCAssert, are used to evaluate a condition, and if the condition evaluates to false, the macros pass a string to an NSAssertionHandler object describing the failure. Each thread has its own NSAssertionHandler object. When invoked, an assertion handler prints an error message that includes the method and class (or function) containing the assertion and raises an NSInternalInconsistencyException. NSAssertionHandlerオブジェクトは、falseアサーションを取り扱うために自動的に作成されます。アサーションマクロ、例えばNSAssertおよびNSCAssertは、ある条件を評価するために使われます、そしてその条件をfalseに評価するならば、それらマクロはある文字列をNSAssertionHandlerオブジェクトに渡してその失敗を解説します。各スレッドはそれ自身のNSAssertionHandlerオブジェクトを持ちます。発動される場合、あるアサーションハンドラは、アサーションを含んでいるメソッドとクラス(または関数)を含んでいるエラーメッセージを出力します、そしてNSInternalInconsistencyExceptionを起こします。

You create assertions only using the assertion macros—you rarely need to invoke NSAssertionHandler methods directly. The macros for use inside methods and functions send handleFailureInMethod:object:file:lineNumber:description: and handleFailureInFunction:file:lineNumber:description: messages respectively to the current assertion handler. The assertion handler for the current thread is obtained using the current class method. See NSAssertionHandlerKey if you need to customize the behavior of NSAssertionHandler. あなたは、アサーションをアサーションマクロを使ってのみ作成します — あなたはめったにNSAssertionHandlerメソッドを直接に発動する必要はありません。メソッドおよび関数の内側で使うためのマクロは、handleFailureInMethod:object:file:lineNumber:description:およびhandleFailureInFunction:file:lineNumber:description:メッセージをそれぞれ現在のアサーションハンドラに送ります。現在のスレッドのためのアサーションハンドラは、currentクラスメソッドを使って取得されます。NSAssertionHandlerKeyを見てください、もしあなたがNSAssertionHandlerの挙動を好みに合わせて変更する必要があるならば。

Topics 話題

Handling Assertion Failures アサーションの失敗を取り扱う

Relationships 関係

Inherits From 継承元