Instance Method インスタンスメソッド

failWithError:

Signals to this coder that the decode operation has failed. このコーダにデコード演算が失敗したことを合図します。

Declaration 宣言

- (void)failWithError:(NSError *)error;

Parameters パラメータ

error

An error that indicates why decoding failed. なぜ復号が失敗したかを指し示すエラー。

Discussion 議論

Typically, you call this method in your initWithCoder: implementation. You should set the error when you detect problems such as lack of secure coding, data corruption, or a domain validation failure. 概して、あなたはこのメソッドをあなたのinitWithCoder:実装の中で呼び出します。あなたは、安全なコーディングの欠如、データ汚染、またはドメイン検証失敗など、あなたが問題を検出する時に error を設定すべきです。

This method is only meaningful to call for decodes. このメソッドは、デコードに対する呼び出しにとって意味があるだけです。

The effect of calling this method depends on the value of decodingFailurePolicy, as follows: このメソッドを呼び出すことの効果は、decodingFailurePolicyの値によって決まります、以下のように:

  • If the policy is NSDecodingFailurePolicyRaiseException, calling this method throws an exception immediately. Swift code cannot catch this kind of exception. ポリシーがNSDecodingFailurePolicyRaiseExceptionならば、このメソッドを呼び出すことは、例外を直ぐにスローします。Swiftコードは、この種の例外をキャッチできません。

  • If the policy is NSDecodingFailurePolicySetErrorAndReturn, calling this method sets the error property once per call to one of the decode methods. Calling it repeatedly has no effect until the call stack unwinds to one of these methods’ entry points. ポリシーがNSDecodingFailurePolicySetErrorAndReturnならば、このメソッドを呼び出すことは、decodeメソッドの1つに対する呼び出しごとに一度だけerrorプロパティを設定します。それを繰り返し呼び出すことは、呼び出しスタックをこれらメソッドのもつエントリポイントの1つまで巻き戻すまで効果を持ちません。

See Also 参照

Managing Decode Errors デコードエラーを管理する