Type Method 型メソッド

dataWithJSONObject:options:error:

Returns JSON data from a Foundation object. JSONデータをFoundationオブジェクトから返します。

Declaration 宣言

+ (NSData *)dataWithJSONObject:(id)obj 
                       options:(NSJSONWritingOptions)opt 
                         error:(NSError * _Nullable *)error;

Parameters パラメータ

obj

The object from which to generate JSON data. Must not be nil. それからJSONデータを生成するオブジェクト。nilであってはいけません。

opt

Options for creating the JSON data. JSONデータの作成に対するオプション。

See NSJSONWritingOptions for possible values. 可能な値のためにNSJSONWritingOptionsを見てください。

error

If an internal error occurs, upon return contains an NSError object with code NSPropertyListWriteInvalidError that describes the problem. 内部エラーが発生するならば、戻りでは、NSErrorオブジェクトを含みます、問題を記述するNSPropertyListWriteInvalidErrorとともに。

Return Value 戻り値

JSON data for obj, or nil if an internal error occurs. The resulting data is encoded in UTF-8. objに対するJSONデータ、または内部エラーが起こるならばnil。結果データは、UTF-8にエンコードされます。

Discussion 議論

If obj can’t produce valid JSON, NSJSONSerialization throws an exception. This exception occurs prior to parsing and represents a programming error, not an internal error. Before calling this method, you should check whether the input can produce valid JSON by using isValidJSONObject:. objが有効なJSON生み出せないならば、NSJSONSerializationは例外をスローします。この例外は、構文解析に優先して発生して、プログラミングエラーを表します、内部エラーではなく。このメソッドを呼び出す前に、あなたは入力が有効なJSONを生み出すことが可能かどうかisValidJSONObject:を使うことで確認すべきです。

Setting the NSJSONWritingPrettyPrinted option generates JSON with white space designed to make the output more readable. If this option isn’t set, NSJSONSerialization generates the most compact possible JSON. NSJSONWritingPrettyPrintedオプションを設定することは、出力をより読みやすくするように設計された空白とともにJSONを生成します。このオプションが設定されないならば、NSJSONSerializationは可能な限り最も簡潔なJSONを生成します。

See Also 参照

Creating JSON Data JSONデータを作成する