普贤教程 › 包参考

uuid 包

通用唯一标识符（UUID v4）

项	值
包名	`uuid`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`uuid.px`
分类	`标识、校验与版本`
文件数 / 行数	`1 / 149`

安装与引入

bash

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

import uuid

所属分类教程：标识、校验与版本

公开接口

函数	参数
`uuid_v4`
`uuid_format`	`hex32`
`uuid_parse`	`s`
`uuid_valid`	`s`

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

函数	参数
`uuid_hexval`	`c`
`uuid_hexchar`	`n`
`uuid_is_hex32`	`h`
`uuid_nil`
`uuid_version`	`s`
`uuid_variant`	`s`
`uuid_to_hex`	`s`
`uuid_from_hex`	`hex32`
`uuid_equals`	`a, b`
`uuid_v4_hex`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/uuid —— 通用唯一标识符（UUID v4）
------------------------------------------------------------
纯函数库（无 IO、无状态），编译（px build）与解释（px run）双模式一致。
对齐 Go google/uuid + 标准库 uuid.Parse 心智：
uuid_v4()            → "123e4567-e89b-4122-a456-426614174000"（标准 36 字符）
uuid_parse(s)        → Ok("123e4567…" 32hex) | Err(msg)（对齐 uuid.Parse）
uuid_valid(s)        → true / false
uuid_format(hex32)   → 标准 36 字符（对齐 uuid.UUID.String()）
依赖：os_random_hex（M66 原生）—— 无需新 native，纯语言实现。
============================================================