SuperAPI AI 工具集

functions

编程与开发

查看项目

更新于 11-01 16:10

技能介绍

本技能是 r2xsql 查询中 SQL 函数使用的参考。当你需要了解在 SELECT / WHERE 子句中可调用哪些函数时使用它;如需了解表结构本身,应改看 connect 技能中的 references/schema-catalog.md。

主要能力与函数说明

正则匹配:r2xsql 额外注册了 regexp(pattern, text),返回 1/0,用于支撑 text REGEXP 'pat' 在 WHERE/SELECT 中的过滤。它是唯一非标准 SQLite 的函数,也是唯一会新增的函数:SQLite 保留 REGEXP 语法但不提供实现,若宿主未注册该运算会报运行时错误;radare2 本身也没有表达正则匹配的命令,这正是它区别于其他函数之处。该函数不修改会话。

历史变更说明:项目保存/打开与类型定义过去以 SQL 函数形式提供,现已改为 radare2 命令(Ps <name>、P <name>、td <decl>),通过同一传输通道到达,SQL 包装并无额外价值。仍可用 SELECT name FROM projects 与 SELECT name FROM types 读取结果。

地址格式化:模式中的地址以 INT64 存储,转为人类可读的十六进制应使用 SQLite 的 printf:printf('0x%x', addr) 得到 0x401000 形式;hex(addr) 是标准 SQLite 函数,返回参数字节的十六进制(非 0x… 地址形式);unhex('4889e5') 为 SQLite 内置(3.41+),把十六进制字符串转为原始字节。

常用 SQLite 内置函数:LIKE(如 name LIKE 'aes_%' 通配匹配)、GLOB(如 name GLOB '[Aa]es',Unix 通配、区分大小写)、INSTR(s, sub)(子串位置,1 起始,0 表示未命中)、SUBSTR(s, i, n)、LENGTH(s)、LOWER(s)/UPPER(s)、COALESCE(a, b)、IIF(c, a, b)、CAST(x AS TEXT)、CASE WHEN … END、JSON_EXTRACT(j,'$.k')。

常见用法示例: SELECT printf('0x%x', addr) AS at, name FROM funcs LIMIT 5; SELECT addr, name FROM funcs WHERE name REGEXP '^aes_(enc|dec)_'; SELECT printf('0x%x', addr) AS at, bytes FROM instructions LIMIT 5; SELECT name, CASE WHEN cc > 25 THEN 'complex' WHEN cc > 10 THEN 'medium' ELSE 'simple' END AS rating FROM funcs; SELECT module, COUNT(*) AS n FROM imports GROUP BY module HAVING n > 1 ORDER BY n DESC;

适用场景:编写或调试 r2xsql 查询、需要格式化地址、按名称正则筛选函数、基于条件生成派生列、进行分组计数与排序时查阅。

限制:仅 regexp() 为 r2xsql 新增,其余均为标准 SQLite 内置函数;函数不修改会话状态;regexp() 依赖宿主注册,否则使用 REGEXP 会报错;具体平台、版本细节以资料为准,资料未涉及的部分暂未提供。