普贤教程 › 包参考

csv 包

0.2.0 —— RFC 4180 CSV 解析与序列化（增强版）

项	值
包名	`csv`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`csv.px`
分类	`数据格式与编解码`
文件数 / 行数	`1 / 354`

安装与引入

bash

pxpkg init          # 首次
pxpkg add csv@0.2.0
pxpkg install

import csv

所属分类教程：数据格式与编解码

公开接口

函数	参数
`csv_parse_opts`	`s, opts`
`csv_serialize_row`	`row`
`csv_parse_header`	`s`
`csv_serialize_header`	`rows, headers`
`csv_parse_tsv`	`s`
`csv_parse_delim`	`s, delim`
`csv_get_col`	`rows, idx`
`csv_filter_rows`	`rows, idx, val`

其余 14 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`csv_parse`	`s`
`csv_needs_quote`	`f, delim`
`csv_escape_quotes`	`f`
`csv_serialize`	`rows`
`csv_serialize_opts`	`rows, opts`
`csv_replace_all`	`text, old, new`
`csv_escape_field`	`field, delimiter = ",", quote = "\""`
`csv_unescape_field`	`field, quote = "\""`
`csv_build`	`rows, delimiter = ",", quote = "\""`
`csv_build_header`	`rows, headers`
`csv_filter`	`rows, column, value`
`csv_sort`	`rows, column, ascending = true`
`csv_column`	`rows, column`
`csv_unique`	`rows, column`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/csv 0.2.0 —— RFC 4180 CSV 解析与序列化（增强版）
------------------------------------------------------------
纯函数库（无 IO、无状态），编译（px build）与解释（px run）双模式一致。
对齐 Go encoding/csv 心智：

新增：
csv_parse_opts(s, opts)     → 自定义分隔符/引号/注释符/跳空行
csv_parse_header(s)         → Ok(list[dict]) 首行作 header
csv_serialize_header(rows, headers) → Ok(str) 带 header 行
csv_serialize_row(row)      → Ok(str) 单行序列化
csv_parse_tsv(s)            → Tab 分隔快捷
csv_parse_delim(s, delim)   → 自定义分隔符快捷
csv_get_col(rows, idx)      → 提取某列为 list
csv_filter_rows(rows, idx, val) → 筛选某列等于 val 的行
============================================================