PHP sprintf() 函数
PHP sprintf() 函数把格式化的字符串写入一个变量中
( PHP >= 4 )
函数原型
sprintf( **format,arg1,arg2,arg++** )
arg1、arg2、++ 参数将被插入到主字符串中的百分号(%)符号处
该函数是逐步执行的
在第一个 % 符号处,插入 arg1,在第二个 % 符号处,插入 arg2,依此类推
如果 % 符号多于 arg 参数,则必须使用占位符
占位符被插入到 % 符号之后,由数字和 "\$" 组成
相关函数
参数
参数 | 描述 |
---|---|
format | 必需。规定字符串以及如何格式化其中的变量 |
arg1 | 必需。规定插到 format 字符串中第一个 % 符号处的参数 |
arg2 | 可选。规定插到 format 字符串中第二个 % 符号处的参数 |
arg++ | 可选。规定插到 format 字符串中第三、四等等 % 符号处的参数 |
参数 format 格式化符列表
格式化符 | 说明 |
---|---|
%% | 返回一个百分号 |
%%b | 二进制数 |
%c | ASCII 值对应的字符 |
%d | 包含正负号的十进制数(负数、0、正数) |
%e | 使用小写的科学计数法(例如 1.2e+2) |
%E | 使用大写的科学计数法(例如 1.2E+2) |
%u | 不包含正负号的十进制数(大于等于 0) |
%f | 浮点数(本地设置) |
%F | 浮点数(非本地设置) |
%g | 较短的 %e 和 %f |
%G | 较短的 %E 和 %f |
%o | 八进制数 |
%s | 字符串 |
%x | - 十六进制数(小写字母) |
%X | 十六进制数(大写字母) |
. | 附加的格式值。必需放置在 % 和字母之间(例如 %.2f) |
+ | 在数字前面加上 + 或 - 来定义数字的正负性 默认情况下,只有负数才做标记,正数不做标记) |
' | 规定使用什么作为填充,默认是空格 它必须与宽度指定器一起使用例如:%'x20s(使用 "x" 作为填充) |
- | 左调整变量值 |
[0-9] | 规定变量值的最小宽度 |
.[0-9] | 规定小数位数或最大字符串长度 |
如果使用多个上述的格式值,它们必须按照上面的顺序进行使用,不能打乱
返回值
返回已格式化的字符串
范例 1
把百分号(%)符号替换成一个作为参数进行传递的变量
<?php $number = 9; $str = "Beijing"; $txt = sprintf("There are %u million bicycles in %s.",$number,$str); echo $txt;
运行以上 PHP 范例,输出结果如下
There are 9 million bicycles in Beijing.
范例 2
使用格式值 %f
<?php $number = 123; $txt = sprintf("%f",$number); echo $txt;
运行以上 PHP 范例,输出结果如下
123.000000
范例 3
使用占位符
<?php $u = 123; $txt = sprintf("With 2 decimals: %1$.2f<br>With no decimals: %1$u",$u); echo $txt;
运行以上 PHP 范例,输出结果如下
With 2 decimals: 123.00 With no decimals:
范例 4
所有可能的格式值的演示
<?php $num1 = 123456789; $num2 = -123456789; $char = 50; // The ASCII Character 50 is 2 // Note: The format value "%%" returns a percent sign echo sprintf("%%b = %b<br>",$num1); // Binary number echo sprintf("%%c = %c<br>",$char); // The ASCII Character echo sprintf("%%d = %d<br>",$num1) ; // Signed decimal number echo sprintf("%%d = %d<br>",$num2); // Signed decimal number echo sprintf("%%e = %e<br>",$num1); // Scientific notation (lowercase) echo sprintf("%%E = %E<br>",$num1); // Scientific notation (uppercase) echo sprintf("%%u = %u<br>",$num1); // Unsigned decimal number (positive) echo sprintf("%%u = %u<br>",$num2); // Unsigned decimal number (negative) echo sprintf("%%f = %f<br>",$num1); // Floating-point number (local settings aware) echo sprintf("%%F = %F<br>",$num1); // Floating-point number (not local sett aware) echo sprintf("%%g = %g<br>",$num1) ; // Shorter of %e and %f echo sprintf("%%G = %G<br>",$num1) ; // Shorter of %E and %f echo sprintf("%%o = %o<br>",$num1) ; // Octal number echo sprintf("%%s = %s<br>",$num1) ; // String echo sprintf("%%x = %x<br>",$num1); // Hexadecimal number (lowercase) echo sprintf("%%X = %X<br>",$num1); // Hex a decimal number (uppercase) echo sprintf("%%+d = %+d<br>",$num1) ; // Sign specifier (positive) echo sprintf("%%+d = %+d<br>",$num2) ;
运行以上 PHP 范例,输出结果如下
%b = 111010110111100110100010101 %c = 2 %d = 123456789 %d = -123456789 %e = 1.234568e+8 %E = 1.234568E+8 %u = 123456789 %u = 18446744073586094827 %f = 123456789.000000 %F = 123456789.000000 %g = 1.23457e+8 %G = 1.23457E+8 %o = 726746425 %s = 123456789 %x = 75bcd15 %X = 75BCD15 %+d = +123456789 %+d = -123456789
范例 5
字符串说明符的演示
<?php $str1 = "Hello"; $str2 = "Hello world!"; echo sprintf("[%s]",$str1) , "<br>"; echo sprintf("[%8s]",$str1) ,"<br>"; echo sprintf("[%-8s]",$str1),"<br>"; echo sprintf("[%08s]",$str1) ,"<br>"; echo sprintf("[%'*8s]",$str1),"<br>"; echo sprintf("[%8.8s]",$str2),"<br>";
运行以上 PHP 范例,输出结果如下
[Hello] [ Hello] [Hello ] [000Hello] [***Hello] [Hello wo]