PowerBuilder 高频实用函数清单：入门必会的 50 个 PowerScript 函数

pbai

免费乐捐，感谢支持

PowerBuilder 高频实用函数清单：入门必会的 50 个 PowerScript 函数

阅读说明
① 适用版本：PowerBuilder 9.0 ~ 12.5（PBIDEA 亦兼容，均为内置全局函数）；
② 支持数据库：不依赖任何数据库，纯语言层面；
③ 操作系统与环境要求：Windows 7 及以上，无需额外组件；
④ 难度系数：★★☆☆☆（入门）；
⑤ 其它阅读说明：适合刚接触 PowerScript 的读者按场景速查，示例可直接粘贴到按钮 Click 事件运行。

为什么需要一张函数清单

PowerScript 内置了 200 多个全局函数，但日常开发里 80% 的代码只用其中几十个。与其翻帮助，不如按场景记一张高频清单：字符串、类型转换、数值、日期时间、数组、文件、杂项。本文把这七类讲清楚，每个函数都配一句话说明和一个最小示例。

1. 字符串处理：最高频的一组

函数	作用	示例
Len()	取字符个数	Len("abc") 返回 3
Trim()	去掉两端空格	Trim(" ab ") 返回 "ab"
Left() / Right()	取左/右 N 个字符	Left("abcd", 2) 返回 "ab"
Mid()	从第 N 位取 M 个字符	Mid("abcd", 2, 2) 返回 "bc"
Pos()	找子串位置，找不到返回 0	Pos("abcd", "bc") 返回 2
Upper() / Lower()	转大写 / 小写	Upper("ab") 返回 "AB"
Replace()	替换子串	Replace("abcd", 1, 2, "XY") 返回 "XYcd"
Fill() / Space()	生成重复字符 / 空格	Fill("-", 3) 返回 "---"
Reverse()	反转字符串	Reverse("abc") 返回 "cba"
NullToEmpty()	NULL 转空串，防报错	NullToEmpty(ls_x)

2. // 输入值
3. string ls_name = "  PowerBuilder  "
4. string ls_word = "hello world"
6. // 长度与去空格
7. long ll_len
8. ll_len = Len(ls_name)              // 去空格前长度
9. string ls_trim
10. ls_trim = Trim(ls_name)            // 去掉两端空格
12. // 截取
13. string ls_left
14. ls_left = Left(ls_word, 5)         // "hello"
15. string ls_mid
16. ls_mid = Mid(ls_word, 7, 5)        // "world"
17. string ls_right
18. ls_right = Right(ls_word, 5)       // "world"
20. // 查找与替换
21. long ll_pos
22. ll_pos = Pos(ls_word, "world")     // 7
23. string ls_rep
24. ls_rep = Replace(ls_word, 1, 5, "Hi") // "Hi world"
26. // 大小写与填充
27. string ls_up
28. ls_up = Upper(ls_word)             // "HELLO WORLD"
29. string ls_fill
30. ls_fill = Fill("-", 10)            // "----------"
32. // 空值兜底：变量没赋值时是 NULL，直接拼串会整段变 NULL
33. string ls_maybe
34. string ls_safe
35. ls_safe = NullToEmpty(ls_maybe)    // ""
37. MessageBox("字符串示例", ls_trim + " / " + ls_left + " / " + ls_mid + " / " + ls_fill)

复制代码

2. 类型转换：字符串和数值互转

函数	作用	示例
Long() / Integer() / Double() / Decimal()	字符串转数值	Long("32") 返回 32
String()	数值转字符串，可带格式	String(3.14159, "#.00") 返回 "3.14"
Val()	从头解析数字，遇非数字停止	Val("12ab") 返回 12
IsNumber()	判断字符串是否为数字	IsNumber("3.14") 返回 TRUE
Date() / DateTime() / Time()	各类型互转	Date("2026-08-21")

2. // 输入值
3. string ls_num = "3.14159"
4. string ls_age = "32"
6. // 字符串转数值
7. long ll_age
8. ll_age = Long(ls_age)              // 32
9. double ld_pi
10. ld_pi = Double(ls_num)             // 3.14159
12. // 转换前先判断，避免运行时出错
13. boolean lb_ok
14. lb_ok = IsNumber(ls_num)           // TRUE
15. if not lb_ok then
16.     MessageBox("转换示例", "不是数字")
17.     return
18. end if
20. // 数值转字符串，带格式
21. string ls_pi
22. ls_pi = String(ld_pi)              // "3.14159"
23. string ls_fmt
24. ls_fmt = String(ld_pi, "#.00")     // "3.14"
26. MessageBox("转换示例", ls_pi + " / " + ls_fmt + " / 年龄=" + String(ll_age))

复制代码

3. 数值计算：取整、绝对值、最值

函数	作用	示例
Abs()	绝对值	Abs(-3.7) 返回 3.7
Ceiling() / Floor()	向上 / 向下取整	Ceiling(2.5) 返回 3
Truncate()	向零截断小数	Truncate(-3.7) 返回 -3
Round()	四舍五入	Round(2.56, 1) 返回 2.6
Max() / Min()	取大 / 取小	Max(2, 5) 返回 5
Mod()	求余数	Mod(17, 5) 返回 2
Rand()	返回 0~1 随机数	Rand() 返回 0~1 之间

2. // 输入值
3. double ld_x = -3.7
4. double ld_y = 2.5
6. // 取整
7. integer li_ceil
8. li_ceil = Ceiling(ld_y)            // 3
9. integer li_floor
10. li_floor = Floor(ld_y)             // 2
11. integer li_trunc
12. li_trunc = Truncate(ld_x)          // -3（向零截断，注意与 Floor 区别）
14. // 绝对值与四舍五入
15. double ld_abs
16. ld_abs = Abs(ld_x)                 // 3.7
17. double ld_round
18. ld_round = Round(ld_y, 0)          // 3
20. // 最值与余数
21. double ld_max
22. ld_max = Max(ld_x, ld_y)           // 2.5
23. double ld_min
24. ld_min = Min(ld_x, ld_y)           // -3.7
25. integer li_mod
26. li_mod = Mod(17, 5)                // 2
28. MessageBox("数值示例", String(li_ceil) + "/" + String(li_floor) + "/" + String(li_trunc) + "/ 余数=" + String(li_mod))

复制代码

4. 日期时间：Today 与 Now 是起点

函数	作用	示例
Today()	今天日期	Today() 返回 2026-08-21
Now()	当前日期时间	Now()
Year() / Month() / Day()	拆出年 / 月 / 日	Year(Today()) 返回 2026
Hour() / Minute() / Second()	拆出时 / 分 / 秒	Hour(Now())
DayName() / DayNumber()	星期几（名 / 数）	DayName(Today()) 返回 "星期五"
DaysAfter()	两个日期相差天数	DaysAfter(今天, 明天) 返回 1
RelativeDate() / RelativeTime()	日期 / 时间加减	RelativeDate(Today(), 30)
SecondsAfter()	两个时间相差秒数	SecondsAfter(t1, t2)

2. // 输入值（以下两句是取值，不需要先声明再赋值之外的特别处理）
3. date ld_today
4. ld_today = Today()                 // 今天
5. datetime ldt_now
6. ldt_now = Now()                    // 当前日期时间
8. // 拆分
9. integer li_year
10. li_year = Year(ld_today)           // 2026
11. integer li_month
12. li_month = Month(ld_today)         // 8
13. integer li_day
14. li_day = Day(ld_today)             // 21
16. // 日期计算
17. long ll_days
18. ll_days = DaysAfter(ld_today, Date(2026, 9, 1)) // 距 9 月 1 日还有几天
19. date ld_future
20. ld_future = RelativeDate(ld_today, 30)          // 30 天后是哪天
22. // 星期几
23. string ls_week
24. ls_week = DayName(ld_today)        // 星期五
26. MessageBox("日期示例", String(li_year) + "-" + String(li_month) + "-" + String(li_day) + " " + ls_week + " / 30天后=" + String(ld_future))

复制代码

5. 数组：上下界与遍历

函数	作用	示例
LowerBound()	数组下界	LowerBound(ls_arr) 通常返回 1
UpperBound()	数组上界（元素个数）	UpperBound(ls_arr)
SetNull()	把变量置为 NULL	SetNull(ls_x)
IsNull()	判断是否为 NULL	IsNull(ls_x)

2. // 输入值
3. string ls_city[3]
4. ls_city[1] = "北京"
5. ls_city[2] = "上海"
6. ls_city[3] = "广州"
8. // 上下界
9. integer li_low
10. li_low = LowerBound(ls_city)       // 1
11. integer li_high
12. li_high = UpperBound(ls_city)      // 3
14. // 遍历拼接（循环变量先声明，经典 PB 不支持循环内联声明变量）
15. integer li_i
16. string ls_all = ""
17. for li_i = li_low to li_high
18.     ls_all = ls_all + ls_city[li_i] + " "
19. next
21. // 空值判断：未赋值的变量是 NULL
22. string ls_x
23. boolean lb_null
24. lb_null = IsNull(ls_x)             // TRUE
26. MessageBox("数组示例", "共" + String(li_high) + "个城市：" + ls_all + " / 空值=" + String(lb_null))

复制代码

6. 文件读写：记牢开-读/写-关三步

函数	作用	说明
FileExists()	文件是否存在	返回 boolean
FileLength()	文件字节数	返回 long
FileOpen()	打开文件	模式：LineMode!/StreamMode!，Read!/Write!
FileRead() / FileWrite()	读一行 / 写一行	返回读写的字符数
FileClose()	关闭文件	用完必须关
FileDelete()	删除文件	返回 boolean
GetFileOpenName() / GetFileSaveName()	弹出选择文件对话框	带文件类型过滤

2. // 输入值
3. string ls_path = "C:\temp\demo.txt"
4. string ls_content = "Hello PowerBuilder"
6. // 写：开 -> 写 -> 关
7. integer li_fp
8. li_fp = FileOpen(ls_path, LineMode!, Write!, LockWrite!, Replace!)
9. if li_fp > 0 then
10.     FileWrite(li_fp, ls_content)
11.     FileClose(li_fp)
12. end if
14. // 读：先确认存在再开
15. boolean lb_exist
16. lb_exist = FileExists(ls_path)
17. string ls_read = ""
18. integer li_fr
19. li_fr = FileOpen(ls_path, LineMode!, Read!, LockRead!)
20. if li_fr > 0 then
21.     FileRead(li_fr, ls_read)
22.     FileClose(li_fr)
23. end if
25. // 文件大小
26. long ll_size
27. ll_size = FileLength(ls_path)
29. MessageBox("文件示例", "存在=" + String(lb_exist) + " 大小=" + String(ll_size) + " 内容=" + ls_read)

复制代码

7. 杂项：弹窗、配置、剪贴板

函数	作用	说明
MessageBox()	弹窗提示	最常用的调试与提示手段
Beep()	响铃提示	Beep(1)
ProfileString()	读 ini 配置	ProfileString(文件, 节, 键, 默认值)
SetProfileString()	写 ini 配置	返回值 1 表示成功
Clipboard()	读写剪贴板	不带参读取，带参写入
IsValid()	对象是否已创建	IsValid(dw_1)
Create() / Destroy()	创建 / 销毁对象	配合自定义类使用

2. // 输入值
3. string ls_ini = "C:\app\config.ini"
5. // 读写 ini 配置（键不存在时返回默认值）
6. string ls_server
7. ls_server = ProfileString(ls_ini, "database", "server", "127.0.0.1")
8. SetProfileString(ls_ini, "database", "port", "1433")
10. // 剪贴板：先读旧内容，再写入新内容
11. string ls_old
12. ls_old = Clipboard()
13. Clipboard("复制这段文字")
15. // 对象有效性
16. boolean lb_ok
17. lb_ok = IsValid(dw_1)
19. MessageBox("杂项示例", "server=" + ls_server + " / 剪贴板旧值=" + ls_old + " / dw_1 有效=" + String(lb_ok))

复制代码

小结：怎么记这张清单

入门阶段先死记三组：字符串（Len/Trim/Left/Mid/Pos/Replace）、转换（Long/String/IsNumber）、日期（Today/Year/DaysAfter）——这三组覆盖了日常九成需求。文件操作记住"开-读写-关"三步曲，数组记住 LowerBound/UpperBound。剩下的函数用到再查帮助即可，不必一次全背。

几个易错提醒：

• 未赋值的变量是 NULL 不是空串，拼字符串前先 NullToEmpty()；
  
• Pos() 找不到返回 0，不是 -1；
  
• Truncate 与 Floor 方向不同：负数时 Truncate(-3.7)=-3，Floor(-3.7)=-4；
  
• 文件用完必须 FileClose，否则句柄泄漏，长时间运行会打不开文件。