定义和用法

sscanf() 函数根据指定的格式解析来自字符串的输入。 sscanf() 函数基于格式字符串向变量中解析字符串。

如果只向该函数传递两个参数,数据将以数组的形式返回。否则,如果传递了额外的参数,则被解析的数据会存储在这些参数中。如果区分符的数目大于包含它们的变量的数目,则会发生错误。不过,如果区分符的数目小于包含它们的变量的数目,则额外的变量包含 NULL。

相关函数:

  • printf() - 输出已格式化字符串
  • sprintf() - 写入一个已格式化字符串到变量中

语法

sscanf(string,format,arg1,arg2,arg++)
参数描述
string必需。规定要读取的字符串。
format必需。规定要使用的格式。可能的格式值:
%% - 返回一个百分号
%%c - ASCII 值对应的字符%d - 包含正负号的十进制数(负数、0、正数)
%e - 使用小写的科学计数法(例如 1.2e+2)
%u - 不包含正负号的十进制数(大于等于 0)
%f - 浮点数
%o - 八进制数
%s - 字符串%x - 十六进制数(小写字母)
%X - 十六进制数(大写字母)
附加的格式值。必需放置在 % 和字母之间(例如 %.2f)
:+ (在数字前面加上 + 或 - 来定义数字的正负性。默认地,只有负数做标记,正数不做标记)
' (规定使用什么作为填充,默认是空格。它必须与宽度指定器一起使用。)
- (左调整变量值)[0-9] (规定变量值的最小宽度)
.[0-9] (规定小数位数或最大字符串长度)
注释:如果使用多个上述的格式值,它们必须按照上面的顺序使用。
arg1可选。存储数据的第一个变量。
arg2可选。存储数据的第二个变量。
arg++可选。存储数据的第三、四个变量,依此类推。

技术细节

返回值:如果只向该函数传递两个参数,数据将以数组的形式返回。否则,如果传递了额外的参数,那么被解析的数据会存储在这些参数中。如果区分符的数目大于包含它们的变量的数目,则会发生错误。不过,如果区分符的数目小于包含它们的变量的数目,则额外的变量包含 NULL。
PHP 版本:4.0.1+

demo

#ex1
$str = "age:30 weight:60kg";
sscanf($str,"age:%d weight:%dkg",$age,$weight);
var_dump($age,$weight);
##输出
int(30) int(60)
#ex2
$str = "If you divide 4 by 2 you'll get 2";
$format = sscanf($str,"%s %s %s %d %s %d %s %s %c");
show($format);
##输出
Array
(
    [0] => If
    [1] => you
    [2] => divide
    [3] => 4
    [4] => by
    [5] => 2
    [6] => you'll
    [7] => get
    [8] => 2
)