PHP 字符串 substr() 函数

substr() 是 PHP 的一个内置函数，用于提取字符串的一部分。substr() 函数返回由 start 和 length 参数指定的一段字符串。PHP 4 及以上版本支持此函数。

语法

substr() 函数的语法如下。它包含三个参数，其中两个是必需的，一个是可选的。

参数

$string (必需) - 它是主字符串参数，指定需要裁剪或修改的字符串。这是此函数的必需参数。它指定了必须一个字符或更长的输入字符串。

$start (必需) - 这也是此函数的必需参数，与 $string 相同。它指定从字符串中的何处开始提取。此参数包含一个整数值，它有三个条件：

• 如果 $start 具有正值，则返回的字符串将从字符串中的第 $start^th 位置开始，计数从零开始。
• 如果 $start 具有负值，则返回的字符串将从字符串末尾的第 $start^th 个字符开始。在这种情况下，计数从 -1 开始，而不是从字符串末尾的零开始。
• 如果 $string 的大小小于 $start 值，则它将返回 FALSE。

$length (可选) - 这是一个整数类型，是此函数的可选参数。此参数表示要从主字符串中裁剪的字符串长度。它具有以下条件：

• 如果 $length 为正数，则返回的字符串将包含 $length 参数中传递的字符数，并从 $start 开始。
• 如果 $length 为负数，则它从 $start 位置开始，并从字符串末尾提取长度。如果 $length 参数中传递的值为负数，则字符串末尾的许多字符将被省略。
• 如果 $length 参数中传递的值为零、FALSE 或 NULL，则将返回一个空字符串（请参见示例 3）。
• 如果未传递 $length 参数，则 substr() 函数将返回一个从 $start 开始到字符串末尾的字符串。

返回值

substr() 函数在成功执行时返回字符串的提取部分。否则，在失败时返回 FALSE 或空字符串。

Changelog

• 在 PHP 7.0.0 中，如果 $string 等于 $start，则 substr() 函数返回一个空字符串。在此版本之前，在这种情况下返回 FALSE。
• 在 PHP 5.2.2 - PHP 5.2.6 中，如果 $start 参数指示负截断或超出位置，则将返回 FALSE，而其他版本则从 $start 获取字符串。

示例

下面给出了一些示例，通过这些示例我们可以学习 substr() 函数的工作原理。让我们看看下面的示例：

示例 1

输出

上面程序的输出如下。

lo javaTpoint
Hello javaTpoint
aTpoint
oint
JavaTpoint
Hello javaTpoint

示例 2

输出

上面程序的输出如下。

lo javaT
Hello jav
javaTp
o jav

Tpoin

示例 3

输出

当在 $length 中传递零或 Null 值时，substr() 函数返回一个空字符串。

No output