内建函数速查

按用途整理的内建函数。全部在本机 0.2.382 上实测可用；标注「编译轨」的只在 px build 的产物里可用。

输出与类型

字符串

列表与字典

数学

时间

文件与系统

JSON

字节与编码

网络

并发（仅编译轨）

内建到底有多少

0.2.382 注册的内建全局函数共 404 个（不含 __ 前缀的内部名）。本页按用途列的是最常用的几十个，不是全集。完整名单可以直接从运行时源码导出（RPM 自带 runtime/*.c）：

grep -ohE 'px_set_global\("[a-zA-Z_][a-zA-Z0-9_]*"' /usr/share/puxian/runtime/*.c \
  | sed 's/px_set_global("//; s/"//' | grep -v '^__' | sort -u > /tmp/px-builtins.txt
wc -l < /tmp/px-builtins.txt      # 404

怀疑某个函数有没有时，先查这张表——不要凭记忆，也不要因为本页没写就断定不存在。

进程与外部命令

def main():
    print("before")
    os_exec("sh", ["-c", "exit 7"])
    print("after")      # 永远不执行

before
（进程直接退出，rc=7）

要抓子进程输出用 os_capture，返回 {rc, stdout, stderr}，支持 timeout_ms（超时 rc=137）与 cwd：

var r = os_capture("sh", ["-c", "echo out; echo err >&2; exit 3"])
print(str(r["rc"]))     # 3
print(r["stdout"])      # out
print(r["stderr"])      # err

var t = os_capture("sh", ["-c", "sleep 5"], {"timeout_ms": 300})
print(str(t["rc"]))     # 137（超时被杀）

3
out

err

137

进程族一共 14 个：os_exec os_spawn os_spawn_capture os_capture os_popen os_wait os_kill os_pid os_self_path os_errno os_rename os_remove_all os_file_sha256 os_random_hex。要并发跑多个子进程用 os_spawn 拿 pid，再 os_wait(pid) 收尸。

HTTP 服务端

语言自带 HTTP 服务端，不需要额外框架：

def handler(req):
    return {"status": 200, "headers": {"Content-Type": "text/plain"}, "body": "hi " + req["path"]}

def main():
    http_serve(8080, handler)

$ curl -s http://127.0.0.1:8080/abc
hi /abc

相关名字：http_serve http_serve_unix px_serve（静态文件）vhost route middleware basic_auth sse_serve tcp_listen udp_serve tls_server。

WebSocket

服务端 ws_serve(port, handler)；客户端 ws_connect(url)。收发与心跳：ws_send ws_recv ws_broadcast ws_ping ws_heartbeat ws_close；连接信息 ws_conn_peer ws_conn_path ws_conn_header；流式与握手 ws_stream ws_reply_101 ws_connect_auto。

SQLite

var db = sqlite_open("/tmp/t.db")
sqlite_exec(db, "create table if not exists t(a int)")
sqlite_exec(db, "insert into t values(?)", [1])
var rows = sqlite_query(db, "select * from t")
print(str(rows))
sqlite_close(db)

六个函数：sqlite_open sqlite_exec sqlite_query sqlite_escape sqlite_last_insert_rowid sqlite_close。注意 --min 会把 sqlite 裁掉（见工具链那章）。

对象存储 / 网络 / 图像 / HTTP/3