以下两个方法分别用于解析具有表头的 DSV 数据和表头的 DSV 数据：

• dsv.parse(string[, row]) 解析相应格式的数据，返回一个可迭代对象（数组）。
  第一个参数 string 是需要解析的数据，它由一些数据值和特定的分隔符构成的字符串，一般还有换行符 \n。传递的入参数据（字符串）需要具有表头，即表格的第一行是列属性
  第二个（可选）参数 row 是一个函数，用于对行数据进行转换或筛选
  最后该方法返回的是一个数组，其中的每一个元素都是一个数据项（即一行数据），元素是一个对象，以键值对 key: value 的方式来存储原来的二维数据。
  此外可迭代对象（数组也是对象）还会具有属性 columns，其属性值是一个数组，元素分别是原数据的列属性（即包含了原来的二维数据表的表头信息），且元素的顺序和表格的列属性顺序一致。
  js

  // 创建一个以 | 作为分隔符的解析器
  // psv stand for pipe separated values
  const psv = d3.dsvFormat("|");
  
  // 调用解析器
  // 传入的数据是 psv 格式的
  // 其中 | 表示数据项（每一行数据）各值之间的分割符
  // 其中 \n 表示换行，因此以下示例中传入的数据有两行
  // 第一行是属性名（即列属性的名称），有两个属性，分别是 foo 和 bar
  // 第二行才是具体的一个数据项
  console.log(psv.parse("foo|bar\n1|2")); // [{foo: "1", bar: "2"}, columns: ["foo", "bar"]]
  // 解析得到的是一个可迭代对象（数组）
  // 数组中的每一个元素都是一个数据项（一行数据），它是一个对象，每一个属性对应于表示的列属性
  

  
  

  

  注意

  如果原表格中的列属性并不唯一，则解析时只保留最后一个值（后盖前）

  js

  const data = "a,b,a\n1,2,3";
  
  const dsv = d3.dsvFormat(",");
  dsv.parse(data); // [{a: "3", b: "2"}, columns: ["a", "b", "a"]]
  

  

  提示

  该方法需要使用网页安全政策中的 unsafe-eval（即允许将字符串当作代码执行，速度更快），如果受限无法使用，可以修改部分代码用 dsv.parseRows() 方法替代

• dsv.parseRows(string[, row]) 解析相应格式的数据，返回一个可迭代对象（数组）。它和 dsv.parse() 方法的作用类似，不同在于该方法用于处理无表头的数据，即传入的数据集均是具体的数据项，没有列属性。
  第一个参数 string 是需要解析的数据。不具有表头，即表格从第一行开始就是具体的数据项
  第二个（可选）参数 row 是一个函数，用于对行数据进行转换或筛选，从第一行开始的数据项均会调用该函数，并依次传入 2 个参数：
  • d 当前所遍历的数据项（当前的行数据）
  • i 当前所遍历的数据项的索引，从 0 开始计算（即原表格的第一行）
  
  如果函数返回 null 或 undefined 则该行数据就会被忽略跳过
  最后该方法返回的是一个数组，元素也是一个数组，表示一个数据项（即一行数据）。和 dsv.parse() 结果不同，这是因为传入的数据没有表头，所以不需要使用对象以键值对 key: value 的方式来存储原来的二维数据，而且解析的数据是从原表格的第一行开始的。
  js

  const data = "1,2,3\n4,5,6";
  
  const dsv = d3.dsvFormat(",");
  dsv.parseRows(data); // [['1', '2', '3'], ['4', '5', '6']]
  

  
  

  

  提示

  该方法适用于表格的数据项「不等长」的情况（例如一些行的某些列属性对应的数据可能缺失了）

  js

  const data = "1997,Ford,E350,2.34\n2000,Mercury,2.38";
  
  
  const dsv = d3.dsvFormat(",");
  dsv.parseRows(data);
  // 解析得到的可迭代对象中
  // 第一个元素的长度为 4
  // 第二个元素的长度为 3
  // [
  //   ["1997", "Ford", "E350", "2.34"],
  //   ["2000", "Mercury", "2.38"]
  // ]
  

对于最常见的两种 DSV 数据格式 CSV 和 TSV，D3 提供了相应的解析方法，便于直接调用：

• 方法 d3.csvParse(string[, row]) 解析分隔符为 , 的 DSV 数据（具有表头信息），获得一个可迭代对象（对象数组）。
  js

  d3.csvParse("foo,bar\n1,2"); // [{foo: "1", bar: "2"}, columns: ["foo", "bar"]]
  

  提示

  等价于 d3.dsvFormat(',').parse()

• 方法 d3.csvParseRows(string[, row]) 解析分隔符为 , 的 DSV 数据（不带表头信息），获得一个可迭代对象（嵌套数组）。
  提示

  等价于 d3.dsvFormat(',').parseRows()

• 方法 d3.tsvParse(string[, row]) 解析分隔符为 \t 的 DSV 数据（具有表头信息），获得一个可迭代对象（对象数组）。
  js

  d3.tsvParse("foo\tbar\n1\t2"); // [{foo: "1", bar: "2"}, columns: ["foo", "bar"]]
  

  提示

  等价于 d3.dsvFormat('\t').parse()

• 方法 d3.tsvParseRows(string[, row]) 解析分隔符为 \t 的 DSV 数据（不带表头信息），获得一个可迭代对象（嵌套数组）。
  提示

  等价于 d3.dsvFormat('\t').parseRows()

以下两个方法分别是基于元素为对象数组或嵌套数组的可迭代对象构建 DSV 数据：

• dsv.format(rows[, columns]) 基于可迭代对象构建出 DSV 数据（字符串），它是 dsv.parse() 方法的逆操作
  第一个参数 rows 是可迭代对象（一个对象数组），==其中每个元素都是一个对象==（不同的属性表示原表格中的不同列属性），表示一个数据项（原表格中的一行数据），基于该可迭代对象构建出 DSV 数据（字符串）
  第二个（可选）参数 columns 是一个数组，指明了 DSV 的列属性（即表头信息）。如果没有设置该参数，则在构建 DSV 时，D3 会自动提取可迭代对象（数组）中各元素的属性的并集，作为构建出的 DSV 的表头（即第一行数据）。
  注意

  但是利用 D3 自动生成列属性的方式所构建的 DSV 数据，对于同一个可迭代对象而言，无法保证其列属性顺序每一次都相同。而且对于属性名为 null 或 undefined 的字段，会被转换为空字符串 ""。所以推荐传递 columns 参数，显式指明表头的信息，可以更精准地控制表格的列属性的顺序。

  js

  const data = [{a: "1", b: "2", c: "3"}, {a: "4", b: "5", c: "6"}]
  
  const dsv = d3.dsvFormat(",");
  dsv.format(data, ["a", "b", "c"]); // "a,b,c\n1,2,3\n4,5,6"
  

  
  如果可迭代对象的属性值中，具有分隔符（如 ,）、双引号 "、换行符 \n，则转换时使用双引号 "" 将这些具有特殊意义的字符包裹
  js

  const data = [{a: '1,', b: '2\n', c: '"3"'}];
  
  const dsv = d3.dsvFormat(",");
  dsv.format(data, ["a", "b", "c"]); // "a,b,c\n'1,','2\n','''3'''"
  

  提示

  如果希望基于可迭代对象（对象数组）构建出的 DSV 数据仅包含表格体，而不包含表头，可以使用 dsv.formatBody(rows[, columns]) 方法

  js

  const data = [{a: "1", b: "2", c: "3"}, {a: "4", b: "5", c: "6"}]
  
  const dsv = d3.dsvFormat(",");
  dsv.format(data, ["a", "b", "c"]); // "a,b,c\n1,2,3\n4,5,6"
  dsv.formatBody(data); // "1,2,3\n4,5,6"
  

  提示

  实际在这些构造 DSV 方法的内部使用 dsv.formatValue(value) 方法，用于对数据值进行转换，以保证生成的 DSV 数据（字符串）之后可以被正确地解析

  js

  const dsv = d3.dsvFormat(",");
  
  dsv.formatValue('a'); // "a"
  dsv.formatValue('a,'); // '"a,"'
  dsv.formatValue('a\n'); // "a\n"
  dsv.formatValue(null); // ""
  dsv.formatValue(undefined); // ""
  

• dsv.formatRows(rows) 基于可迭代对象构建出 DSV 数据（字符串），它是 dsv.parseRows() 方法的逆操作
  第一个参数 rows 是可迭代对象（一个嵌套数组），==其中每一个元素也是一个数组==（其元素则是字符串），表示一个数据项（即原表格中的一行数据），需要基于该可迭代对象构建出 DSV 数据（字符串）。
  提示

  由于该方法假定可迭代对象不包含表头信息，所以和 dsv.format() 方法不同，该方法不需要指定 columns 参数

  
  该方法实际是用换行符 \n 连接可迭代对象的每个元素（表示每一行数据项），然后再用分隔符，如 ,，连接每个嵌套数组中的字符串元素
  js

  const data = [["1997", "Ford", "E350", "2.34"], ["2000", "Mercury", "2.38"]]
  
  const dsv = d3.dsvFormat(",");
  dsv.formatRows(data); // "1997,Ford,E350,2.34\n2000,Mercury,2.38"
  

const arr = [{a: "1", b: "2", c: "3"}, {a: "4", b: "5", c: "6"}]

// 先将对象数组转换为嵌套数组
const newArr = arr.map((d, i) => {
  return [
    d.a,
    d.b,
    d.c,
  ];
});

// 添加上表头数组
const newArrWithHeader = [["a", "b", "c"]].concat(newArr);

// 构建 DSV
const dsv = d3.dsvFormat(",");
dsv.formatRows(newArrWithHeader); // "a,b,c\n1,2,3\n4,5,6"

• dsv.formatRow(row) ==基于字符串数组==（元素为字符串）建出 DSV 数据（字符串）
  它和 dsv.formatRows() 方法类似，不同的是 dsv.formatRows(rows) 入参 rows 需要时一个嵌套数组，每一个元素表示原表格中的一行数据；而该方法入参 row 是一个字符串数组（元素为字符串），该数组就表示一行数据，元素表示该行的不同列属性的值。可以理解为 dsv.formatRows() 是生成一个数据表；而 dsv.formatRow() 只生成一行数据。
  js

  const dataset = [[1, 2, 3]];
  const rowData = [1, 2, 3];
  
  dsv = d3.dsvFormat(",");
  
  // 生成一个数据表（不带表头）
  dsv.formatRows(dataset); // "1,2,3"
  // 生成一行数据
  dsv.formatRow(rowData); // "1,2,3"
  

对于最常见的两种 DSV 数据格式 CSV 和 TSV，D3 提供了相应的构建方法，便于直接调用：

• 方法 d3.csvFormat(rows[, columns]) 基于可迭代对象（对象数组）构建出 CSV 数据表（具有表头信息）
  js

  d3.csvFormat([{foo: "1", bar: "2"}]); // "foo,bar\n1,2"
  

  提示

  等价于 d3.dsvFormat(",").format()

  
  如果希望基于可迭代对象（对象数组）构建出的 CSV 数据仅包含表格体，而不包含表头，可以使用方法 d3.csvFormatBody(rows[, columns])。等价于 d3.dsvFormat(",").formatBody()
• 方法 d3.csvFormatRows(rows) 基于可迭代对象（嵌套数组）构建出 CSV 数据表（不具有表头信息）。
  提示

  等价于 d3.dsvFormat(",").formatRows()

• 方法 d3.csvFormatRow(row) 基于字符串数组（元素为字符串）建出 CSV 一行数据（字符串）
  提示

  实际在这些构造 CSV 方法的内部使用方法 d3.csvFormatValue(value) 对数据值进行转换。等价于 d3.dsvFormat(",").formatValue()

• 方法 d3.tsvFormat(rows[, columns]) 基于可迭代对象（对象数组）构建出 TSV 数据表（具有表头信息）
  js

  d3.tsvFormat([{foo: "1", bar: "2"}]); // "foo\tbar\n1\t2"
  

  提示

  等价于 d3.dsvFormat('\t').format()

  
  如果希望基于可迭代对象（对象数组）构建出的 TSV 数据仅包含表格体，而不包含表头，可以使用方法 d3.tsvFormatBody(rows[, columns])。等价于 d3.dsvFormat("\t").formatBody()
• 方法 d3.tsvFormatRows(rows) 基于可迭代对象（嵌套数组）构建出 TSV 数据表（不具有表头信息）。
  提示

  等价于 d3.dsvFormat("\t").formatRows()

• 方法 d3.tsvFormatRow(row) 基于字符串数组（元素为字符串）建出 TSV 一行数据（字符串）
  提示

  实际在这些构造 TSV 方法的内部使用方法 d3.tsvFormatValue(value) 对数据值进行转换。等价于 d3.dsvFormat("\t").formatValue()

在 d3-dsv 模块中还提供了一些命令行工具，用于对 DSV、JSON 文档进行格式转换处理

需要先安装 d3-dsv 模块，在终端输入以下命令

# 在当前项目中安装 d3-dsv 模块
npm install d3-dsv

# 在系统全局安装 d3-dsv 模块
npm install -g d3-dsv

然后可以使用命令行转换工具。假设当前目录中存在一个数据表 test.csv 在终端输入以下命令可以将它转换为 result.json 文档

# 如果在项目中安装了 d3-dsv 模块
./node_modules/.bin/csv2json test.csv -o result.json

# 如果在系统全局安装了 d3-dsv 模块
csv2json test.csv -o result.json

• dsv2dsv 命令、csv2tsv 命令、tsv2csv 命令支持 DSV 文档转换分隔符
• dsv2json 命令、csv2json 命令、tsv2json 命令和 json2dsv命令、json2csv 命令、json2tsv 命令支持 DSV 与 JSON 文档互转