strncmp

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

strncmp — 前 n 个字符的二进制安全字符串比较

描述

strncmp(string $string1, string $string2, int $length): int

此函数类似于 strcmp()，不同之处在于您可以指定用于比较的每个字符串的字符数（上限）。

请注意，此比较区分大小写。

参数

string1: 第一个字符串。
string2: 第二个字符串。
length: 用于比较的字符数。

返回值

如果 string1 小于 string2，则返回 -1；如果 string1 大于 string2，则返回 1；如果两者相等，则返回 0。

变更日志

版本	描述
8.2.0	此函数现在返回 `-1` 或 `1`，而之前返回负数或正数。

示例

示例 #1 strncmp() 示例

<?php

$var1 = 'Hello John';
$var2 = 'Hello Doe';
if (strncmp($var1, $var2, 5) === 0) {
 echo '$var1 和 $var2 的前 5 个字符在区分大小写的字符串比较中相等';
}
?>

参见

strncasecmp() - 前 n 个字符的二进制安全不区分大小写的字符串比较
preg_match() - 执行正则表达式匹配
substr_compare() - 从偏移量开始，最多比较 length 个字符的两个字符串的二进制安全比较
strcmp() - 二进制安全字符串比较
strstr() - 查找字符串的第一次出现
substr() - 返回字符串的一部分

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献的注释 5 个注释

向上

向下

codeguru at crazyprogrammer dot cba dot pl ¶

16 年前

我进行了以下实验来比较数组。

1. 使用 (substr($key,0,5 == "HTTP_") & 2. 使用 (!strncmp($key, 'HTTP_', 5))

我想找出从数组中获取前几个字符的最快方法。

基准测试迭代结果是
if (substr($key,0,5 == "HTTP_").... - 0,000481 秒
if (!strncmp($key, 'HTTP_', 5)).... - 0,000405 秒

strncmp() 比 substr() 快 20% :D

<?php
// 示例函数
function strncmp_match($arr)
{
foreach ($arr as $key => $val)
 {
 //if (substr($key,0,5 == "HTTP_")
 if (!strncmp($key, 'HTTP_', 5)) 
 {
 $out[$key] = $val;
 }
 }
return $out;
}

// 示例使用
?><pre><?php
print_r(strncmp_match($_SERVER));
?></pre>

将显示如下代码

数组
(
[HTTP_ACCEPT] => XXX
[HTTP_ACCEPT_LANGUAGE] => pl
[HTTP_UA_CPU] => x64
[HTTP_ACCEPT_ENCODING] => gzip, deflate
[HTTP_USER_AGENT] => Mozilla/4.0
(兼容; MSIE 7.0;
Windows NT 5.1;
.NET CLR 1.1.4322;
.NET CLR 2.0.50727)
[HTTP_HOST] => XXX.XXX.XXX.XXX
[HTTP_CONNECTION] => Keep-Alive
[HTTP_COOKIE] => __utma=XX;__utmz=XX.utmccn=(direct)|utmcsr=(direct)|utmcmd=(none)
)

向上

向下

salehrezq at gmail dot com ¶

7 年前

文档中未包含的注释

int strcmp ( string $str1 , string $str2 )

如果 str1 小于 str2，则返回 < 0；如果 str1 大于 str2，则返回 > 0；如果两者相等，则返回 0。

我的补充
如果 str1 和 str2 不相等，并且 str1 是 str2 的子字符串，反之亦然。返回的 int 值将为负或正，指示两个字符串之间的差异（以绝对值表示）有多少个字符。

示例

<?php
$str1 = "phpaaa";
$str2 = "php";

echo strcmp($str1, $str2); // 3
?>

由于 str2 = "php" 是 str1 = "phpaaa" 的子字符串，并且 "phpaaa" 大于 "php"，因此返回的值为正数 3，指示两个字符串之间的差异（以绝对值表示）有多少个字符。

如果将 str1 的值替换为 str2，则结果将为 -3（负数），但仍然表示绝对差异，即 3

向上

向下

samy ¶

7 年前

我只想强调（至少在 php7 上），当测试一个字符串是否在另一个字符串的开头存在时，您应该考虑使用 substr 或 strpos（如果性能很重要）。

这是一个小型基准测试（仅供参考）
<?php
$n = 'abcd';
$l = strlen($n);
$haystack0 = base64_encode(random_bytes(128));

//热身
$r = 1;
for ($i = 0; $i < 100000000; $i++)
 $r += $r * $r % 10000;

//测试
$k = 30000000;
$res = array();
foreach (array('found' => $n . $haystack0, 'not-found' => strrev($n) . $haystack0) as $f => $haystack) {
 $m = microtime(true);
 for ($i = 0; $i < $k; $i++)
 !strncmp($haystack, $n, $l) && $r++;
 $res["strncmp-$f"] = -$m + ($m = microtime(true));

 for ($i = 0; $i < $k; $i++)
 (strpos($haystack, $n) === 0) && $r++;
 $res["strpos-$f"] = -$m + ($m = microtime(true));

 for ($i = 0; $i < $k; $i++)
 (substr($haystack, 0, $l) === $n) && $r++;
 $res["substr-$f"] = microtime(true) - $m;
}

//打印
asort($res);
print_r($res);
echo "\n$r"; // 确保没有自动优化发生
?>

这将输出
<?php /*
 [strpos-found] => 1.3313138484955
 [substr-not-found] => 1.4832630157471
 [substr-found] => 1.6976611614227
 [strpos-not-found] => 2.0043320655823
 [strncmp-not-found] => 2.0969619750977
 [strncmp-found] => 2.3616981506348
*/ ?>

向上

向下

bobvin at pillars dot net ¶

13 年前

对于检查短字符串开头的匹配项，strpos() 比 strncmp() 快大约 15%。


这是一个基准程序来证明这一点


<?php 
$haystack = "abcdefghijklmnopqrstuvwxyz"; 
$needles = array('abc', 'xyz', '123'); 
foreach ($needles as $needle) { 
 $times['strncmp'][$needle] = -microtime(true); 
 for ($i = 0; $i < 1000000; $i++) { 
 $result = strncmp($haystack, $needle, 3) === 0; 
 } 
 $times['strncmp'][$needle] += microtime(true); 
} 
foreach ($needles as $needle) { 
 $times['strpos'][$needle] = -microtime(true); 
 for ($i = 0; $i < 1000000; $i++) { 
 $result = strpos($haystack, $needle) === 0; 
 } 
 $times['strpos'][$needle] += microtime(true); 
} 
var_export($times); 
?>

向上

向下

elloromtz at gmail dot com ¶

14 年前

如果长度为 0，无论两个字符串是什么，它都将返回 0


<?php 
strncmp("xybc","a3234",0); // 0 
strncmp("blah123","hohoho", 0); //0 
?>

＋添加注释