字符串函数

PHP substr_compare() 函数

主题:PHP 字符串参考上一页|下一页

说明

substr_compare() 函数比较从指定起始位置到指定字符长度的两个字符串。 默认情况下,比较区分大小写。

下表总结了该函数的技术细节。

返回值:

如果 start 位置的 main_str 小于 str,则返回负值 (< 0); 如果大于 str,则为正值 (> 0),如果它们相等,则为 0

如果 start 设置为大于 main_str 长度的值,或者length设置为小于 0 的值,则此函数返回 FALSE
变更日志: 自 PHP 7.3.5 起,start 现在可能等于 main_str 的长度。
版本: PHP 5+

语法

substr_compare() 函数的基本语法如下:

substr_compare(main_str, str, start, length, case_insensitivity);

下面的例子展示了 substr_compare() 函数的作用。

<?php
// 示例字符串
$main_str = "Blackbird";
$str = "bird";

// 比较字符串
echo substr_compare($main_str, $str, 5);
?>

参数

substr_compare() 函数接受以下参数。

参数 说明
main_str 必填。 指定要比较的主字符串。
str 必填。 指定要比较的辅助字符串。
start 必填。 指定比较的开始位置。 如果为负数,则从字符串末尾开始计数。
length 可选。 指定比较的长度。 默认值为 str 的长度与 main_str 的长度减去 start 后的最大值。
case_insensitivity 可选。 如果设置为 true,则比较将不区分大小写。 默认值为 false,它执行区分大小写的比较。

更多示例

这里有更多示例展示了 substr_compare() 函数的实际工作原理:

下面的例子只是从头开始比较两个字符串。

<?php
// 两个字符串相等
echo substr_compare("Blackbird", "Blackbird", 0)."<br>";

// 主字符串大于辅助字符串
echo substr_compare("Blackbird", "Black", 0)."<br>";

// 主字符串小于辅助字符串
echo substr_compare("Black", "Blackbird", 0);
?>

以下示例演示了不同参数的用法。

<?php
// 比较字符串
echo substr_compare("Blackbird", "Black", 0)."<br>";
echo substr_compare("Blackbird", "black", 0, 5, true)."<br>";
echo substr_compare("Blackbird", "bird", -4, 4)."<br>";
echo substr_compare("Blackbird", "bird", 2, 4)."<br>";
echo substr_compare("Blackbird", "lack", 1, 5);
?>
Advertisements