dart:convert 库

用于在不同数据表示之间转换的编码器和解码器，包括 JSON 和 UTF-8。

除了常见的数据表示的转换器之外，此库还提供了以易于链式调用和使用流的方式实现转换器的支持。

在您的代码中使用此库

import 'dart:convert';

两个常用的转换器是顶级实例 JsonCodec 和 Utf8Codec，分别命名为 json 和 utf8。

JSON

JSON 是一种用于表示结构化对象和集合的简单文本格式。

JsonCodec 将 JSON 对象编码为字符串，将字符串解码为 JSON 对象。使用 JSON 格式，json 编码器/解码器在字符串和对象结构之间转换，例如列表和映射。

json 是 JsonCodec 的默认实现。

示例

var encoded = json.encode([1, 2, { "a": null }]);
var decoded = json.decode('["foo", { "bar": 499 }]');

有关更多信息，请参阅 JsonEncoder 和 JsonDecoder。

UTF-8

Utf8Codec 将字符串编码为 UTF-8 代码单元（字节），并将 UTF-8 代码单元解码为字符串。

utf8 是 Utf8Codec 的默认实现。

示例

var encoded = utf8.encode('Îñţérñåţîöñåļîžåţîờñ');
var decoded = utf8.decode([
  195, 142, 195, 177, 197, 163, 195, 169, 114, 195, 177, 195, 165, 197,
  163, 195, 174, 195, 182, 195, 177, 195, 165, 196, 188, 195, 174, 197,
  190, 195, 165, 197, 163, 195, 174, 225, 187, 157, 195, 177]);

有关更多信息，请参阅 Utf8Encoder 和 Utf8Decoder。

ASCII

AsciiCodec 将字符串编码为存储为字节的 ASCII 代码，并将 ASCII 字节解码为字符串。并非所有字符都可以表示为 ASCII，因此并非所有字符串都可以成功转换。

ascii 是 AsciiCodec 的默认实现。

示例

var encoded = ascii.encode('This is ASCII!');
var decoded = ascii.decode([0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73,
                            0x20, 0x41, 0x53, 0x43, 0x49, 0x49, 0x21]);

有关更多信息，请参阅 AsciiEncoder 和 AsciiDecoder。

Latin-1

Latin1Codec 将字符串编码为 ISO Latin-1（又称 ISO-8859-1）字节，并将 Latin-1 字节解码为字符串。并非所有字符都可以表示为 Latin-1，因此并非所有字符串都可以成功转换。

latin1 是 Latin1Codec 的默认实现。

示例

var encoded = latin1.encode('blåbærgrød');
var decoded = latin1.decode([0x62, 0x6c, 0xe5, 0x62, 0xe6,
                             0x72, 0x67, 0x72, 0xf8, 0x64]);

有关更多信息，请参阅 Latin1Encoder 和 Latin1Decoder。

Base64

Base64Codec 使用默认的 base64 字母表编码字节，使用 base64 和 base64url 字母表解码，不允许无效字符且需要填充。

base64 是 Base64Codec 的默认实现。

示例

var encoded = base64.encode([0x62, 0x6c, 0xc3, 0xa5, 0x62, 0xc3, 0xa6,
                             0x72, 0x67, 0x72, 0xc3, 0xb8, 0x64]);
var decoded = base64.decode('YmzDpWLDpnJncsO4ZAo=');

有关更多信息，请参阅 Base64Encoder 和 Base64Decoder。

转换器

转换器通常与流一起使用，以将流中的数据转换为可用时所需的数据格式。以下代码使用了两个转换器。第一个是一个UTF-8解码器，它在从文件读取数据时将其从字节转换为UTF-8格式。第二个是一个行分割器实例，它将数据按换行符边界分割。

const showLineNumbers = true;
var lineNumber = 1;
var stream = File('quotes.txt').openRead();

stream.transform(utf8.decoder)
      .transform(const LineSplitter())
      .forEach((line) {
        if (showLineNumbers) {
          stdout.write('${lineNumber++} ');
        }
        stdout.writeln(line);
      });

有关创建自己的转换器的信息，请参阅Codec和Converter类的文档。

HTML转义

HtmlEscape转换器将HTML中具有特殊意义的字符转义。该转换器查找HTML源中具有意义的字符，并用相应的HTML实体替换它们。

可以使用HtmlEscapeMode.new构造函数创建自定义转义模式。

示例

const htmlEscapeMode = HtmlEscapeMode(
  name: 'custom',
  escapeLtGt: true,
  escapeQuot: false,
  escapeApos: false,
  escapeSlash: false,
 );

const HtmlEscape htmlEscape = HtmlEscape(htmlEscapeMode);
String unescaped = 'Text & subject';
String escaped = htmlEscape.convert(unescaped);
print(escaped); // Text & subject

unescaped = '10 > 1 and 1 < 10';
escaped = htmlEscape.convert(unescaped);
print(escaped); // 10 &gt; 1 and 1 &lt; 10

unescaped = "Single-quoted: 'text'";
escaped = htmlEscape.convert(unescaped);
print(escaped); // Single-quoted: 'text'

unescaped = 'Double-quoted: "text"';
escaped = htmlEscape.convert(unescaped);
print(escaped); // Double-quoted: "text"

unescaped = 'Path: /system/';
escaped = htmlEscape.convert(unescaped);
print(escaped); // Path: /system/