substr_compare

substr_compare

(PHP 5, PHP 7)

substr_compare - 从偏移量到长度字符的两个字符串的二进制安全比较

描述

int substr_compare ( string $main_str , string $str , int $offset [, int $length [, bool $case_insensitivity = false ]] )

substr_compare（）将位置偏移量的main_str与str的长度字符进行比较。

参数

main_str

主要字符串进行比较。

str

次要字符串进行比较。

offset

比较的开始位置。如果为负值，则从字符串的末尾开始计数。

length

比较的长度。 缺省值是str长度的最大值，与main_str的长度减去偏移量相比较。

case_insensitivity

如果case_insensitivity是TRUE，则比较是不区分大小写的。

返回值

如果位置偏移量的main_str小于str，则返回<0;如果大于str，则返回> 0;如果相等，则返回0。 如果偏移量等于或大于main_str的长度，或者长度已设置且小于1（在PHP 5.5.11之前），substr_compare（）将输出警告并返回FALSE。

更新日志

例子

示例＃1 substr_compare（）示例

<?php
echo substr_compare("abcde", "bc", 1, 2 // 0
echo substr_compare("abcde", "de", -2, 2 // 0
echo substr_compare("abcde", "bcg", 1, 2 // 0
echo substr_compare("abcde", "BC", 1, 2, true // 0
echo substr_compare("abcde", "bc", 1, 3 // 1
echo substr_compare("abcde", "cd", 1, 2 // -1
echo substr_compare("abcde", "abc", 5, 1 // warning
?>

扩展内容

• strncmp（） - 前n个字符的二进制安全字符串比较

← strtr

substr_count →