substr_compare()

本页内容

PHP substr_compare() 函数

分类:PHP字符串函数参考手册

比较两个字符串:


示例

<?php

echo substr_compare("Hello world","Hello world",0);

?>

定义和用法

substr_compare() 函数从指定的开始位置比较两个字符串。

提示:该函数是二进制安全和选择性区分大小写。

语法

substr_compare(string1,string2,startpos,length,case)
参数 描述
string1 必需。规定要比较的第一个字符串。
string2 必需。规定要比较的第二个字符串。
startpos 必需。规定在 string1 中的何处开始比较。如果为负数,则从字符串末端开始计数。
length 可选。规定在 string1 中参与比较的字符数。
case

可选。一个布尔值,规定是否执行区分大小写的比较:

  • FALSE - 默认。区分大小写
  • TRUE - 不区分大小写

技术细节

返回值:

该函数返回:

  • 0 - 如果两字符串相等
  • <0 - 如果 string1 (从开始位置 startpos)小于 string2
  • >0 - 如果 string1 (从开始位置 startpos)大于 string2

如果 length 大于或等于 string1 的长度,则该函数返回 FALSE。

PHP 版本: 5+
更新日志: 自 PHP 5.1 起,允许使用负数的 startpos。

更多实例

实例 1

比较两个字符串,当 string1 中用于比较的开始位置为 6 时:


示例

<?php

echo substr_compare("Hello world","world",6);

?>

实例 2

使用所有的参数:


示例

<?php
echo substr_compare("world","or",1,2);
echo substr_compare("world","ld",-2,2);

echo substr_compare("world","orl",1,2);
echo substr_compare("world","OR",1,2,TRUE);

echo substr_compare("world","or",1,3);
echo substr_compare("world","rl",1,2);

?>

实例 3

不同的返回值:


示例

<?php
echo substr_compare("Hello world!","Hello world!",0); // the
    two strings are equal
echo substr_compare("Hello world!","Hello",0); //
    string1 is greater than string2
echo substr_compare("Hello world!","Hello
    world! Hello!",0); // str1 is less than str2

?>

分类:PHP字符串函数参考手册

此页面最后编辑于2022年8月17日 (星期三) 22:30。