普贤教程 › 包参考

vcard 包

vCard/iCalendar 文本格式解析

项	值
包名	`vcard`
版本	`0.1.0`
入口	`vcard.px`
分类	`数据格式与编解码`
文件数 / 行数	`1 / 265`

安装与引入

bash

pxpkg init          # 首次
pxpkg add vcard@0.1.0
pxpkg install

import vcard

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

公开接口

函数	参数
`vc_unfold`	`text`
`vc_fold`	`line`
`vc_escape`	`text`
`vc_unescape`	`text`
`vc_parse`	`text`
`vc_get_prop`	`card, name`
`vc_get_all_props`	`card, name`
`vc_add_prop`	`card, name, value, params = {}`
`vc_new`
`vc_encode`	`cards`
`vc_parse_vcard`	`text`
`vc_build_vcard`	`contact`

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

函数	参数
`vc_parse_line`	`line`
`vc_split_unescaped`	`text, sep`
`vc_encode_prop`	`prop`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/vcard — vCard/iCalendar 文本格式解析
------------------------------------------------------------
纯函数库，双模式一致。
对齐 PHP vCard / icalendar / Python vobject：
vc_parse(text)               → 解析 vCard/iCalendar 文本 → [{name, params, value}]
vc_encode(cards)             → 编码为 vCard 文本
vc_get_prop(card, name)      → 获取属性值
vc_get_all_props(card, name) → 获取所有同名属性
vc_add_prop(card, name, value, params) → 添加属性
vc_new()                     → 创建空 vCard
vc_fold(line)                → 行折叠（75 字符）
vc_unfold(text)              → 行展开（合并续行）
vc_escape(text)              → 转义特殊字符
vc_unescape(text)            → 反转义
vc_parse_vcard(text)         → 解析为联系人 dict
vc_build_vcard(contact)      → 从 dict 构建 vCard
============================================================