PHP sscanf() 函数

PHP sscanf() 函数

PHP String 参考手册 PHP String 参考手册

实例

Parse a string:

<?php
$str = "age:30 weight:60kg";
sscanf($str,"age:%d weight:%dkg",$age,$weight);
// show types and values
var_dump($age,$weight);
?>

运行实例 »

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）：

  • + （在数字前面加上 + 或 - 来定义数字的正负性。默认情况下，只有负数才做标记，正数不做标记）
  • ' （规定使用什么作为填充，默认是空格。它必须与宽度指定器一起使用。例如：%'x20s（使用 "x" 作为填充））
  • - （左调整变量值）
  • [0-9] （规定变量值的最小宽度）
  • .[0-9] （规定小数位数或最大字符串长度）

注释：如果使用多个上述的格式值，它们必须按照上面的顺序进行使用，不能打乱。
arg1 可选。存储数据的第一个变量。
arg2 可选。存储数据的第二个变量。
arg++ 可选。存储数据的第三、四个变量。依此类推。

技术细节

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

更多实例

实例 1

使用格式值 %s、%d 和 %c：

<?php
$str = "If you divide 4 by 2 you'll get 2";
$format = sscanf($str,"%s %s %s %d %s %d %s %s %c");
print_r($format);
?>

运行实例 »

PHP String 参考手册 PHP String 参考手册
www.sxiaw.com