2024年6月10日发(作者：)

string.ｆormaｔ（)函数的用法

ｌua中有很多字符串操作的函数，ｓｒｍａt（)就是其中的一个,顾

名思义,formaｔ是格式化的意思，则sｔrinｇ.forｍaｔ（)功能就是格式化一个

字符串。ﻫ 我们知道ｌua中可以用".."连接字符串,可以起到一部分格式化

字符串的作用,但是如果字符串较长或者有特殊的格式转换操作(如十六进制转

换)，用＂.．＂就会很繁琐且可读性差。用stｒｉnｇ.fｏｒmat（)就是一个很好

的解决方案。

函数定义

ｓｔrinｇ.formａt（) 第一个参数为字符串格式，后面的参数可以任意多个,用

于填充第一个参数中的格式控制符，最后返回完整的格式化后的字符串。ﻫ

格式控制符以%开头，常用的有以下几种 ﻫ%s - 接受一个字符串并按照给

定的参数格式化该字符串ﻫ％ｄ － 接受一个数字并将其转化为有符号的整

数格式ﻫ%f － 接受一个数字并将其转化为浮点数格式(小数）,默认保留6

位小数,不足位用0填充ﻫ%x - 接受一个数字并将其转化为小写的十六进制

格式ﻫ%X - 接受一个数字并将其转化为大写的十六进制格式

示例:

1. str = ｓｔｒing．fｏrmat("字符串：%sｎ整数:％d＼n小数:%f

ｎ十六进制数:%X"，"ｑwｅqwe",1,0.13，348)

2. print（ｓｔｒ)

输出结果：

1. 字符串：qweqwe

2. 整数：1

3. 小数：0.1３0００0

4. 十六进制数：15Ｃ

5.

%X的特殊用法

%08X 中间的第２个数字格式化成多少位,第１个数字表示不足位数时

的填充数，通常用０填充。

例如：

1. str = ｒmat(＂０x％08X",348）

2. print(str）

前面的0x只是个普通的字符串,可有可无，因为我们一般在十六进制数前面加上

0x来表明这是一个十六进制数，所以这里才加了个０x，没有其他特殊意义。

输出结果:

ﻫ

ﻫ

1. 0ｘ00000１5C

%x的特殊用法与%X一样

%ｆ的特殊用法

0.3%

ﻫ

ｆ 中的小数点右边的数字表示小数点后面保

留多少位,小数点前面的数字表示位数不足时的填充数,通用用0填充。

例如:ﻫ格式化一个小数,保留2位小数

1. str = stｒｉng.fｏrmat（"%０.2f＂,3４.２３４4)

2. prｉnt(str）

输出结果：ﻫ

1. 34.23

ﻫ

更多用法

前面是常用的格式控制符,ｓtrｉng．foｒmａt（)还有很多其他的格式

控制符,更详细的信息可以参考官方文档。ﻫ%c － 接受一个数字, 并将其转化

为ＡSCII码表中对应的字符

%ｄ， ％ｉ - 接受一个数字并将其转化为有符号的整数格式ﻫ%o - 接受一个

数字并将其转化为八进制数格式

%u - 接受一个数字并将其转化为无符号整数格式

％x － 接受一个数字并将其转化为十六进制数格式, 使用小写字母ﻫ%X -

接受一个数字并将其转化为十六进制数格式， 使用大写字母ﻫ%ｅ － 接受

一个数字并将其转化为科学记数法格式, 使用小写字母ｅ

%Ｅ - 接受一个数字并将其转化为科学记数法格式, 使用大写字母E

%f － 接受一个数字并将其转化为浮点数格式ﻫ%g(%G) - 接受一个数字

并将其转化为％e(%E, 对应%Ｇ）及%f中较短的一种格式ﻫ%q － 接受一个

字符串并将其转化为可安全被Lua编译器读入的格式ﻫ%s － 接受一个字符

串并按照给定的参数格式化该字符串ﻫ

为进一步细化格式, 可以在%号后添加参数. 参数将以如下的顺序读入:

(１) 符号： 一个+号表示其后的数字转义符将让正数显示正号. 默认情况下

只有负数显示符号．ﻫ（2） 占位符： 一个0, 在后面指定了字串宽度时占位

用． 不填时的默认占位符是空格.3(ﻫ） 对齐标识: 在指定了字串宽度时， 默

认为右对齐, 增加-号可以改为左对齐.

(４) 宽度数值5(ﻫ） 小数位数/字串裁切: 在宽度数值后增加的小数部分n, 若

后接f(浮点数转义符， 如%６.3f)则设定该浮点数的小数只保留n位, 若后接

s(字符串转义符， 如％５.3s）则设定该字符串只显示前n位．

在这些参数的后面则是上述所列的转义码类型（c, d, ｉ, f， ．．.)．

1. <ｆont fａce＝"Verdanａ， Ａｒiaｌ， Helvetica， sans-ser

ｉf＂＞ｐrｉnt(ｓｍａt(＂pi = %.４f"， PＩ））

2. --> pi = 3.1416

3. d = 5; m = 11; ｙ = 1９９０

4. print(ｔ（"%02d/%02ｄ/%０4ｄ", d, ｍ, y））

5. -－> 0５/11／１990

6. tａg, title = "h1"， "ａ tｉtlｅ"

7. print（ａｔ(＂<%s＞%s＂, tａg, tｉｔle,

tag)）

8. －-＞ <ｈ1＞ａ tｉtle＜/h1>

ﻫ第一个例子,％.4f代表小数点后面有４位小数的浮点数。第二个例子%02d

代表以固定的两位显示十进制数，不足的前面补0。而%２ｄ前面没有指定0，

不足两位时会以空白补足。对于格式串部分指示符得详细描述清参考lｕa手册,

或者参考C手册,因为Lua调用标准C的ｐｒiｎtｆ函数来实现最终的功能。ﻫ

以下是一些例子:ﻫ

1. ＜ｆonｔ face=＂Couriｅr"＞ｓtring.ｆormａｔ(＂％%c: %

ｃ", ８3） 输出Ｓ

2. ｓtrinｇ.foｒmat("％＋d＂， １７．0) 输出

+17

3. ｓtring.fｏrmat（＂%05ｄ", 1７) 输出

00017

4. ｓtriｎg．foｒmat("％ｏ", １7） 输出21

5. sｔｒiｎｍat（＂%ｕ", 3.14） 输出3

6. stｒａｔ（"%ｘ", 1３） 输出d

7. strinｇ．formaｔ("%X＂, １3) 输出D

8. strinｇ.ｆormａt("%e", １000) 输出

１.00０000ｅ+03

9. sｔrｉng.ｆormａt（"%Ｅ", 10０0) 输出

１．0000０0E+03

10. striｎg.ｆormat("%6.3ｆ", １３) 输出１

3.000

11. string．format("%q"， "OｎeｎTwo"） 输出"One

12. Ｔｗo＂

13. stｒ("％s"， "moｎkey＂） 输出mｏ

nkｅy

14. ｓtrｉｎｒmat("％10s", "mｏnｋey") 输出 m

ｏnkey

15. ｓtrｉ（"%5.３s", "mｏnkey") 输出 mon

ｆｏｎt>