# PHP sscanf() 函数
[![PHP String 参考手册](/images/up.gif) PHP String 参考手册](php-ref-string.html)
## 实例
Parse a string:
$str = "age:30 weight:60kg";
sscanf($str,"age:%d weight:%dkg",$age,$weight);
// show types and values
var_dump($age,$weight);
[运行实例 »](/try/showphp.php?filename=demo_func_string_sscanf)
---
sscanf() 函数根据指定的格式解析来自一个字符串的输入。 sscanf() 函数基于格式字符串解析字符串到变量中。
如果只向该函数传递两个参数,数据将以数组的形式返回。否则,如果传递了额外的参数,那么被解析的数据会存储在这些参数中。如果区分符的数目大于包含它们的变量的数目,则会发生错误。不过,如果区分符的数目小于包含它们的变量的数目,则额外的变量包含 NULL。
相关函数:
- [printf()](func-string-printf.html) - 输出已格式化字符串
- [sprintf()](func-string-sprintf.html) - 写入一个已格式化字符串到变量中
---
## 语法
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:
$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);
[运行实例 »](/try/showphp.php?filename=demo_func_string_sscanf2)
---
[![PHP String 参考手册](/images/up.gif) PHP String 参考手册](php-ref-string.html)