目次

dart:convert

目次

dart:convert ライブラリ ( API リファレンス ) には、JSON および UTF-8 用のコンバーターと、追加のコンバーターを作成するためのサポートが含まれています。JSON は、構造化されたオブジェクトとコレクションを表現するためのシンプルなテキスト形式です。UTF-8 は、Unicode 文字セット内のすべての文字を表現できる一般的な可変幅エンコーディングです。

このライブラリを使用するには、dart:convert をインポートします。

dart
import 'dart:convert';

JSON のデコードとエンコード

#

jsonDecode() を使用して、JSON でエンコードされた文字列を Dart オブジェクトにデコードします

dart
// NOTE: Be sure to use double quotes ("),
// not single quotes ('), inside the JSON string.
// This string is JSON, not Dart.
var jsonString = '''
  [
    {"score": 40},
    {"score": 80}
  ]
''';

var scores = jsonDecode(jsonString);
assert(scores is List);

var firstScore = scores[0];
assert(firstScore is Map);
assert(firstScore['score'] == 40);

jsonEncode() を使用して、サポートされている Dart オブジェクトを JSON 形式の文字列にエンコードします

dart
var scores = [
  {'score': 40},
  {'score': 80},
  {'score': 100, 'overtime': true, 'special_guest': null}
];

var jsonText = jsonEncode(scores);
assert(jsonText ==
    '[{"score":40},{"score":80},'
        '{"score":100,"overtime":true,'
        '"special_guest":null}]');

int、double、String、bool、null、List、または Map (文字列キーを持つ) 型のオブジェクトのみが、直接 JSON にエンコード可能です。List および Map オブジェクトは再帰的にエンコードされます。

直接エンコードできないオブジェクトをエンコードするには、2 つのオプションがあります。1 つ目は、直接エンコード可能なオブジェクトを返す関数を 2 番目の引数として jsonEncode() を呼び出すことです。2 つ目のオプションは、2 番目の引数を省略することです。この場合、エンコーダーはオブジェクトの toJson() メソッドを呼び出します。

JSON 関連のパッケージのその他の例とリンクについては、JSON の使用を参照してください。

UTF-8 文字のデコードとエンコード

#

utf8.decode() を使用して、UTF8 でエンコードされたバイトを Dart 文字列にデコードします

dart
List<int> utf8Bytes = [
  0xc3, 0x8e, 0xc3, 0xb1, 0xc5, 0xa3, 0xc3, 0xa9,
  0x72, 0xc3, 0xb1, 0xc3, 0xa5, 0xc5, 0xa3, 0xc3,
  0xae, 0xc3, 0xb6, 0xc3, 0xb1, 0xc3, 0xa5, 0xc4,
  0xbc, 0xc3, 0xae, 0xc5, 0xbe, 0xc3, 0xa5, 0xc5,
  0xa3, 0xc3, 0xae, 0xe1, 0xbb, 0x9d, 0xc3, 0xb1
];

var funnyWord = utf8.decode(utf8Bytes);

assert(funnyWord == 'Îñţérñåţîöñåļîžåţîờñ');

UTF-8 文字のストリームを Dart 文字列に変換するには、Stream の transform() メソッドに utf8.decoder を指定します

dart
var lines = utf8.decoder.bind(inputStream).transform(const LineSplitter());
try {
  await for (final line in lines) {
    print('Got ${line.length} characters from stream');
  }
  print('file is now closed');
} catch (e) {
  print(e);
}

utf8.encode() を使用して、Dart 文字列を UTF8 でエンコードされたバイトのリストとしてエンコードします

dart
Uint8List encoded = utf8.encode('Îñţérñåţîöñåļîžåţîờñ');

assert(encoded.length == utf8Bytes.length);
for (int i = 0; i < encoded.length; i++) {
  assert(encoded[i] == utf8Bytes[i]);
}

その他の機能

#

dart:convert ライブラリには、ASCII および ISO-8859-1 (Latin1) 用のコンバーターもあります。詳細については、dart:convert ライブラリの API リファレンスを参照してください。

特に明記されていない限り、このサイトのドキュメントは Dart 3.5.3 を反映しています。ページの最終更新日は 2024-02-26 です。 ソースを表示 または 問題を報告。