decodeTopLevelObjectOfClass:forKey:error:

- (id)decodeTopLevelObjectOfClass:(Class)aClass 
                           forKey:(NSString *)key 
                            error:(NSError * _Nullable *)error;

Return Value 戻り値

The decoded object, or nil if decoding fails. デコードされたオブジェクト、またはnil、もしデコードが失敗するならば。

Discussion 議論

If the coder responds YES to requiresSecureCoding, then the coder calls failWithError: in either the following cases: コーダがYESで応答をrequiresSecureCodingにするならば、そのときコードはfailWithError:を以下の場合のどちらかで呼び出します：

• The class indicated by cls does not implement NSSecureCoding. clsによって指し示されるクラスは、NSSecureCodingを実装しません。

• The unarchived class does not match cls, nor do any of its superclasses. 未アーカイブクラスは、clsに一致しません、それのスーパークラスのどれもまたしません。

If the coder does not require secure coding, it ignores the cls parameter and does not check the decoded object. コーダが安全なコーディングを必要としないならば、それはclsパラメータを無視します、そしてデコードされたオブジェクトを調べません。