Files
marqdo-cli/stdlib/data/csv.mq.md
T

4.4 KiB

成功

(值)

{ok: true, value: 值}

失败

(代码, 消息)

{ok: false, code: 代码, message: 消息}

解析行

(文本)

解析单行 CSV:逗号分隔、双引号包裹、"" 表示一个字面双引号。 不处理换行、多行字段或首尾空白。未闭合引号和未加引号字段中的双引号 返回可恢复错误。

点 = text.codepoints(文本)

下标 = 0

字段 = ""

字段表 = []

引号内 = false

错误 = ""

  • 下标 < 长度(点) and 错误 == ""

    字符 = text.from_codepoint(点[下标])

    1. 引号内 and 字符 == "\""

      1. 下标 + 1 < 长度(点) and text.from_codepoint(点[下标 + 1]) == "\""

        字段 = 字段 + "\""

        下标 = 下标 + 2

      2. true

        引号内 = false

        下标 = 下标 + 1

    2. 引号内

      字段 = 字段 + 字符

      下标 = 下标 + 1

    3. 字符 == "\""

      1. 字段 == ""

        引号内 = true

        下标 = 下标 + 1

      2. true

        错误 = "csv.invalid_quote"

    4. 字符 == ","

      字段表 = list.append(字段表, 字段)

      字段 = ""

      下标 = 下标 + 1

    5. true

      字段 = 字段 + 字符

      下标 = 下标 + 1

  1. 错误 != ""

    失败(错误, "未加引号字段中出现双引号")

  2. 引号内

    失败("csv.unterminated_quote", "引号未闭合")

成功(list.concat(字段表, [字段]))

格式化字段

(文本)

含逗号、双引号、换行或回车的字段加引号,内部双引号写成 ""。

点 = text.codepoints(文本)

下标 = 0

需要引号 = false

  • 下标 < 长度(点) and not 需要引号

    码点 = 点[下标]

    1. 码点 == 34 or 码点 == 44 or 码点 == 10 or 码点 == 13

      需要引号 = true

    2. true

      忽略 = 0

    下标 = 下标 + 1

  1. not 需要引号

    文本

结果 = "\""

下标 = 0

  • 下标 < 长度(点)

    1. 点[下标] == 34

      结果 = 结果 + "\"\""

    2. true

      结果 = 结果 + text.from_codepoint(点[下标])

    下标 = 下标 + 1

结果 + "\""

格式化行

(列表)

结果 = ""

下标 = 0

  • 下标 < 长度(列表)

    1. 下标 > 0

      结果 = 结果 + ","

    2. true

      忽略 = 0

    结果 = 结果 + 格式化字段(文本(列表[下标]))

    下标 = 下标 + 1

结果

解析

(文本)

解析多行 CSV(逗号分隔、双引号、"" 转义、CRLF/LF 行尾,引号内可含 换行)。返回 {ok:true, value:List<List<Text>>};未闭合引号和不合法 引号返回可恢复错误。

点 = text.codepoints(文本)

下标 = 0

字段 = ""

当前行 = []

行 = []

引号内 = false

错误 = ""

  • 下标 < 长度(点) and 错误 == ""

    字符 = text.from_codepoint(点[下标])

    1. 引号内 and 字符 == "\""

      1. 下标 + 1 < 长度(点) and text.from_codepoint(点[下标 + 1]) == "\""

        字段 = 字段 + "\""

        下标 = 下标 + 2

      2. true

        引号内 = false

        下标 = 下标 + 1

    2. 引号内

      字段 = 字段 + 字符

      下标 = 下标 + 1

    3. 字符 == "\""

      1. 字段 == ""

        引号内 = true

        下标 = 下标 + 1

      2. true

        错误 = "csv.invalid_quote"

    4. 字符 == ","

      当前行 = list.append(当前行, 字段)

      字段 = ""

      下标 = 下标 + 1

    5. 字符 == "\n"

      当前行 = list.append(当前行, 字段)

      行 = list.append(行, 当前行)

      当前行 = []

      字段 = ""

      下标 = 下标 + 1

    6. 字符 == "\r"

      下标 = 下标 + 1

    7. true

      字段 = 字段 + 字符

      下标 = 下标 + 1

  1. 错误 != ""

    失败(错误, "未加引号字段中出现双引号")

  2. 引号内

    失败("csv.unterminated_quote", "引号未闭合")

  3. 字段 != "" or 长度(当前行) > 0

    当前行 = list.append(当前行, 字段)

    行 = list.append(行, 当前行)

成功(行)

格式化

(行列表)

结果 = ""

行号 = 0

  • 行号 < 长度(行列表)

    1. 行号 > 0

      结果 = 结果 + "\n"

    2. true

      忽略 = 0

    结果 = 结果 + 格式化行(行列表[行号])

    行号 = 行号 + 1

结果