Class

JSONEncoder

An object that encodes instances of a data type as JSON objects. あるデータ型のインスタンスをJSONオブジェクトとしてエンコードするオブジェクト。

Declaration 宣言

class JSONEncoder

Overview 概要

The example below shows how to encode an instance of a simple GroceryProduct type from a JSON object. The type adopts Codable so that it’s encodable as JSON using a JSONEncoder instance. 下の例は、単純なGroceryProduct型のインスタンスを JSONオブジェクトからエンコードする方法を示します。この型はCodableを採用します、それでそれはJSONEncoderインスタンスを使ってエンコード可能です。

struct GroceryProduct: Codable {
    var name: String
    var points: Int
    var description: String?
}


let pear = GroceryProduct(name: "Pear", points: 250, description: "A ripe pear.")


let encoder = JSONEncoder()
encoder.outputFormatting = .prettyPrinted


let data = try encoder.encode(pear)
print(String(data: data, encoding: .utf8)!)


/* Prints:
 {
   "name" : "Pear",
   "points" : 250,
   "description" : "A ripe pear."
 }
*/

Topics 話題

First Steps 初歩

init()

Creates a new, reusable JSON encoder with the default formatting settings and encoding strategies. 新しい、再利用可能なJSONエンコーダを省略時の書式設定の設定とエンコーディング戦略で作成します。

func encode<T>(T) -> Data

Returns a JSON-encoded representation of the value you supply. あなたが提供する値のJSONエンコードされた表現を返します。

Customizing Encoding エンコーディングをあつらえる

var outputFormatting: JSONEncoder.OutputFormatting

A value that determines the readability, size, and element order of the encoded JSON object. エンコードされたJSONオブジェクトの読み出し可能性、サイズ、そして要素順序を決定する値。

struct JSONEncoder.OutputFormatting

The output formatting options that determine the readability, size, and element order of an encoded JSON object. エンコードされたJSONオブジェクトの読み出し可能性、サイズ、そして要素順序を決定する出力書式設定オプション。

var keyEncodingStrategy: JSONEncoder.KeyEncodingStrategy

A value that determines how to encode a type’s coding keys as JSON keys.

enum JSONEncoder.KeyEncodingStrategy

The values that determine how to encode a type's coding keys as JSON keys. いくつかの値、それはどのようにある型のもつコーディングキーをJSONキーとしてエンコードするかを決定します。

var userInfo: [CodingUserInfoKey : Any]

A dictionary you use to customize the encoding process by providing contextual information. エンコーディング処理を文脈的な情報を提供することによってカスタマイズするためにあなたが使う辞書。

Encoding Dates 日付をエンコードする

var dateEncodingStrategy: JSONEncoder.DateEncodingStrategy

The strategy used when encoding dates as part of a JSON object. JSONオブジェクトの部分として日付をエンコードする場合に使われる戦略。

enum JSONEncoder.DateEncodingStrategy

The formatting strategies available for formatting dates when encoding a date as JSON. 日付をJSONとしてエンコードする場合に日付を書式設定するのに利用可能な書式設定戦略。

Encoding Raw Data 生のデータをエンコードする

var dataEncodingStrategy: JSONEncoder.DataEncodingStrategy

The strategy that an encoder uses to encode raw data. エンコーダが生のデータをエンコードするために使う戦略。

enum JSONEncoder.DataEncodingStrategy

The strategies for encoding raw data. 生のデータをエンコードするための戦略。

Encoding Exceptional Numbers 普通でない数をエンコードする

var nonConformingFloatEncodingStrategy: JSONEncoder.NonConformingFloatEncodingStrategy

The strategy used by an encoder when it encounters exceptional floating-point values. それが例外浮動小数点値に出くわす場合にエンコーダによって使われる戦略。

enum JSONEncoder.NonConformingFloatEncodingStrategy

The strategies for encoding nonconforming floating-point numbers, also known as IEEE 754 exceptional values. IEEE 754例外値としても知られる、不適合浮動小数点数をエンコードすることに対する戦略。

Supporting Types 支援を行う型

typealias JSONEncoder.Output

The type of output produced by the JSON encoder. JSONエンコーダによって生み出される出力の型。

Relationships 関係

Conforms To 次に準拠

TopLevelEncoder