string.format()函数的用法
lua中有很多字符串操作的函数,string.format()就是其中的一个,顾名思义,format是格式化的意思,则string.format()功能就是格式化一个字符串。
我们知道lua中可以用".."连接字符串,可以起到一部分格式化字符串的作用,但是如果字符串较长或者有特殊的格式转换操作(如十六进制转换),用".."就会很繁琐且可读性差。用string.format()就是一个很好的解决方案。
函数定义
string.format() 第一个参数为字符串格式,后面的参数可以任意多个,用于填充第一个参数中的格式控制符,最后返回完整的格式化后的字符串。
格式控制符以%开头,常用的有以下几种
%s - 接受一个字符串并按照给定的参数格式化该字符串
%d - 接受一个数字并将其转化为有符号的整数格式
%f - 接受一个数字并将其转化为浮点数格式(小数),默认保留6位小数,不足位用0填充
%x - 接受一个数字并将其转化为小写的十六进制格式
%X - 接受一个数字并将其转化为大写的十六进制格式
示例:
1. str = string.format("字符串:%s\n整数:%d\n小数:%f\n十六进制数:%X","qweqwe",1,0.13,348)
2. print(str)
输出结果:
1. 字符串:qweqwe
2. 整数:1
3. 小数:0.130000
4. 十六进制数:15C
5.
%X的特殊用法
%08X 中间的第2个数字格式化成多少位,第1个数字表示不足位数时的填充数,通常用0填充。
例如:
1. str =string.format("0x%08X",348)
2. print(str)
前面的0x只是个普通的字符串,可有可无,因为我们一般在十六进制数前面加上0x来表明这是一个十六进制数,所以这里才加了个0x,没有其他特殊意义。
输出结果:
1. 0x0000015C
%x的特殊用法与%X一样
%f的特殊用法
%0.3f 中的小数点右边的数字表示小数点后面保留多少位,小数点前面的数字表示位数不足时的填充数,通用用0填充。
例如:
格式化一个小数,保留2位小数
1. str =string.format("%0.2f",34.2344)
2. print(str)
输出结果:
1. 34.23
更多用法
前面是常用的格式控制符,string.format()还有很多其他的格式控制符,更详细的信息可以参考官方文档。
%c- 接受一个数字, 并将其转化为ASCII码表中对应的字符
%d,%i - 接受一个数字并将其转化为有符号的整数格式
%o- 接受一个数字并将其转化为八进制数格式
%u- 接受一个数字并将其转化为无符号整数格式
%x- 接受一个数字并将其转化为十六进制数格式,使用小写字母
%X- 接受一个数字并将其转化为十六进制数格式,使用大写字母
%e- 接受一个数字并将其转化为科学记数法格式,使用小写字母e
%E- 接受一个数字并将其转化为科学记数法格式,使用大写字母E
%f- 接受一个数字并将其转化为浮点数格式
%g(%G)- 接受一个数字并将其转化为%e(%E, 对应%G)及%f中较短的一种格式
%q- 接受一个字符串并将其转化为可安全被Lua编译器读入的格式
%s- 接受一个字符串并按照给定的参数格式化该字符串
为进一步细化格式, 可以在%号后添加参数. 参数将以如下的顺序读入:
(1) 符号: 一个+号表示其后的数字转义符将让正数显示正号. 默认情况下只有负数显示符号.
(2) 占位符: 一个0, 在后面指定了字串宽度时占位用. 不填时的默认占位符是空格.
(3) 对齐标识: 在指定了字串宽度时, 默认为右对齐, 增加-号可以改为左对齐.
(4) 宽度数值
(5) 小数位数/字串裁切: 在宽度数值后增加的小数部分n, 若后接f(浮点数转义符, 如%6.3f)则设定该浮点数的小数只保留n位, 若后接s(字符串转义符, 如%5.3s)则设定该字符串只显示前n位.
在这些参数的后面则是上述所列的转义码类型(c, d, i, f,...).
1. print(string.format("pi = %.4f", PI))
2. --> pi= 3.1416
3. d = 5; m = 11; y = 1990
4. print(string.format("%02d/%02d/%04d",d, m, y))
5. --> 05/11/1990
6. tag, title = "h1", "atitle"
7. print(string.format("<%s>%s%s>",tag, title, tag))
8. --> a title
第一个例子,%.4f代表小数点后面有4位小数的浮点数。第二个例子%02d代表以固定的两位显示十进制数,不足的前面补0。而%2d前面没有指定0,不足两位时会以空白补足。对于格式串部分指示符得详细描述清参考lua手册,或者参考C手册,因为Lua调用标准C的printf函数来实现最终的功能。
以下是一些例子:
1.
2. string.format("%+d",17.0) 输出+17
3. string.format("%05d",17) 输出00017
4. string.format("%o",17) 输出21
5. string.format("%u",3.14) 输出3
6. string.format("%x",13) 输出d
7. string.format("%X",13) 输出D
8. string.format("%e",1000) 输出1.000000e+03
9. string.format("%E",1000) 输出1.000000E+03
10. string.format("%6.3f",13) 输出13.000
11. string.format("%q","One\nTwo") 输出"One\
12. Two"
13. string.format("%s","monkey") 输出monkey
14. string.format("%10s","monkey") 输出 monkey
15. string.format("%5.3s","monkey") 输出 mon