说明

strtok(string $string, string $token): string|false

可选 token （不支持命名参数）：

strtok(string $token): string|false

strtok() 将字符串 string 分割为若干子字符串，每个子字符串以 token 中的字符分割。这也就意味着，如果有个字符串是 "This is an example string"，你可以使用空格字符作为 token，将这句话分割成独立的单词。

注意，仅第一次调用 strtok 函数时才使用 string 参数。随后每次调用 strtok 都将只使用 token 参数，因为它会记住它在当前字符串中的位置。如果要重新开始分割一个新的字符串，你需要再次使用 string 参数来调用 strtok 函数来对其进行初始化。注意，可以在 token 参数中使用多个字符。字符串将被 token 参数中任何一个字符分割。

注意:
这个函数的行为可能与熟悉 explode() 的人期望略有不同。首先，在解析的字符串中，两个或多个连续的 token 的字符被认为是单一的分隔符。此外，位于字符串开始或结束处的 token 将被忽略。例如，如果使用一个字符串 ";aaa;;bbb;" ，连续调用 strtok() 并将 ";" 作为一个 token 将返回字符串 "aaa" 和 "bbb"，然后返回 false 。因此，字符串将仅被拆分为两个元素，而 explode(";", $string) 将返回一个包含 5 个元素的数组。

参数

string: 被分成若干子字符串的原始字符串。
token: 分割 string 时使用的分界字符。

返回值

标记后的字符串，如果没有更多标记可用，则返回 false 。

更新日志

版本说明

8.3.0 现在，当未提供 token 时，会抛出 E_WARNING。

版本	说明
8.3.0	现在，当未提供 `token` 时，会抛出 `E_WARNING`。

示例

示例 #1 strtok() 示例

<?php
$string = "This is\tan example\nstring";
/* 使用制表符和换行符作为分界符 */
$tok = strtok($string, " \n\t");

while ($tok !== false) {
    echo "Word={$tok}\n";
    $tok = strtok(" \n\t");
}
?>

示例 #2 当 strtok() 找不到标记时的反应

<?php
$first_token  = strtok('/something', '/');
$second_token = strtok('/');
var_dump($first_token, $second_token);
?>

以上示例会输出：

string(9) "something"
    bool(false)

示例 #3 strtok() 和 explode() 的不同点

<?php
$string = ";aaa;;bbb;";
$parts = [];
$tok = strtok($string, ";");
while ($tok !== false) {
    $parts[] = $tok;
    $tok = strtok(";");
}
echo json_encode($parts),"\n";
$parts = explode(";", $string);
echo json_encode($parts),"\n";

以上示例会输出：

["aaa","bbb"]
["","aaa","","bbb",""]

注释

警告

此函数可能返回布尔值 false，但也可能返回等同于 false 的非布尔值。请阅读布尔类型章节以获取更多信息。应使用 === 运算符来测试此函数的返回值。

参见

explode() - 使用一个字符串分割另一个字符串