Latest web development tutorials

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參考手冊