文書 > Foundation > Archives and Serialization > JSONSerialization > data(withJSONObject:options:)
型メソッド
data(withJSONObject:options:)
Foundation オブジェクトから JSON データを返します。
宣言
options opt: JSONSerialization.WritingOptions = []) throws -> Data
パラメータ
| obj | JSON データをそこから生成するオブジェクト。nil ではいけません。 |
| options | JSON データを作成するためのオプション。 可能な値については、JSONSerialization.WritingOptions を参照してください。 |
戻り値
obj の JSON データ、または内部エラーが発生した場合は nil。結果のデータは UTF-8 でコード化されています。
議論
obj が有効な JSON を生成しない場合、例外が throw されます。この例外は、解析される前に throw され、内部エラーではなくプログラミングエラーを表します。isValidJSONObject(_:) を使用してこのメソッドを呼び出す前に、入力が有効な JSON を生成するかどうか確認する必要があります。
prettyPrinted オプションを設定すると、出力をより読みやすくするように設計された空白を含む JSON を生成します。このオプションが設定されていない場合、最もコンパクトな JSON が生成されます。
Swift では、このメソッドは optional でない結果を返し、失敗した場合にエラーを throw することを示す throws キーワードでマークされています。
Swift プログラミング言語 (Swift 4.0.3) の エラー処理 および Swift を Cocoa および Objective-C で使用する (Swift 4.0.3) 内の エラー処理で説明したように、try 式でこのメソッドを呼び出し、do 文の catch 句のエラーを処理します。
以下も見よ
JSON データの作成
class func writeJSONObject(Any, to: OutputStream, options: JSONSerialization.WritingOptions = [], error: NSErrorPointer)
指定された JSON オブジェクトをストリームに書き込みます。
class func isValidJSONObject(Any)
指定されたオブジェクトを JSON データに変換できるかどうかを示すブール値を返します。