普贤教程 › 包参考

glob 包

通配匹配与目录列举

项	值
包名	`glob`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`glob.px`
分类	`文件系统`
文件数 / 行数	`1 / 220`

安装与引入

bash

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

import glob

所属分类教程：文件系统

公开接口

函数	参数
`glob_has_magic`	`s`
`glob_match`	`p, s`
`glob_list`	`dir, pattern`

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

函数	参数
`gl_parse_class`	`core`
`gl_class_match`	`core, c`
`gl_class_end`	`p, start`
`gl_match`	`p, pi, s, si`
`gl_index`	`s, sub`
`gl_list_entries`	`dir, pattern`
`gl_walk`	`dir, pattern`
`glob_compile`	`pattern`
`glob_match_list`	`pattern, items`
`glob_filter`	`pattern, items`
`glob_match_any`	`patterns, s`
`glob_split_ext`	`pattern`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/glob —— 通配匹配与目录列举
------------------------------------------------------------
纯函数库（glob_match 无 IO；glob_list 读目录），编译与解释双模式一致。
glob_match(pattern, name) → bool     单段通配匹配
glob_list(dir, pattern)   → Ok([全路径...]) | Err   列举 + 过滤（排序）
glob_has_magic(s)         → bool     是否含通配元字符
支持：
*        任意个字符（不跨 "/"）
?        单个字符（不跨 "/"）
[...]    字符类：a-z 区间、[^...]/[!...] 取反、] 作首字符、- 首/尾字面量
说明：
- 与 Go filepath.Match 一致，* 和 ? 不匹配 "/"（目录/文件名分段匹配）
- 反斜杠转义不支持（0.2.0 考虑）
============================================================