substr

(PHP 4, PHP 5, PHP 7, PHP 8)

substr返回字符串的子串

说明

substr(string $string, int $offset, ?int $length = null): string

返回字符串 stringoffsetlength 参数指定的子字符串。

参数

string

输入字符串。

offset

如果 offset 是非负数,返回的字符串将从 stringoffset 位置开始,从 0 开始计算。例如,在字符串 “abcdef” 中,在位置 0 的字符是 “a”,位置 2 的字符串是 “c” 等等。

如果 offset 是负数,返回的字符串将从 string 结尾处向前数第 offset 个字符开始。

如果 string 的长度小于 offset,将返回空字符串。

示例 #1 使用负数 offset

<?php
$rest 
substr("abcdef", -1);    // 返回 "f"
$rest substr("abcdef", -2);    // 返回 "ef"
$rest substr("abcdef", -31); // 返回 "d"
?>

length

如果提供了正数的 length,返回的字符串将从 offset 处开始最多包括 length 个字符(取决于 string 的长度)。

如果提供了负数的 length,那么 string 末尾处的 length 个字符将会被省略(若 offset 是负数则从字符串尾部算起)。如果 offset 不在这段文本中,那么将返回空字符串。

如果提供了值为 0length,那么将返回一个空字符串。

如果没有提供 length,返回的子字符串将从 offset 位置开始直到字符串结尾。

示例 #2 使用负数 length

<?php
$rest 
substr("abcdef"0, -1);  // 返回 "abcde"
$rest substr("abcdef"2, -1);  // 返回 "cde"
$rest substr("abcdef"4, -4);  // 返回 ""; 在 PHP 8.0.0 之前,返回 false
$rest substr("abcdef", -3, -1); // 返回 "de"
?>

返回值

返回提取的 string 部分或者空字符串。

更新日志

版本 说明
8.0.0 现在 length 允许为 null。
8.0.0 函数将返回一个空字符串, 在此之前返回 false

范例

示例 #3 substr() 基本用法

<?php
echo substr('abcdef'1);     // bcdef
echo substr("abcdef"1null); // bcdef; 在 PHP 8.0.0 之前,返回空字符串
echo substr('abcdef'13);  // bcd
echo substr('abcdef'04);  // abcd
echo substr('abcdef'08);  // abcdef
echo substr('abcdef', -11); // f

// 访问字符串中的单个字符
// 也可以使用中括号
$string 'abcdef';
echo 
$string[0];                 // a
echo $string[3];                 // d
echo $string[strlen($string)-1]; // f
?>

示例 #4 substr() casting behaviour

<?php
class apple {
    public function 
__toString() {
        return 
"green";
    }
}

echo 
"1) ".var_export(substr("pear"02), true).PHP_EOL;
echo 
"2) ".var_export(substr(5432102), true).PHP_EOL;
echo 
"3) ".var_export(substr(new apple(), 02), true).PHP_EOL;
echo 
"4) ".var_export(substr(true01), true).PHP_EOL;
echo 
"5) ".var_export(substr(false01), true).PHP_EOL;
echo 
"6) ".var_export(substr(""01), true).PHP_EOL;
echo 
"7) ".var_export(substr(1.2e304), true).PHP_EOL;
?>

以上例程会输出:

1) 'pe'
2) '54'
3) 'gr'
4) '1'
5) ''
6) ''
7) '1200'

示例 #5 无效字符范围

如果请求的字符范围无效, substr() 从 PHP 8.0.0 开始返回空字符串;在此之前返回 false

<?php
var_dump
(substr('a'2));
?>

以上例程在 PHP 8 中的输出:

string(0) ""
]

以上例程在 PHP 7 中的输出:

bool(false)

参见