strncmp

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

strncmp — 比較兩個字串前 n 個字元的二進位安全字串比較

說明

strncmp(字串 $string1, 字串 $string2, 整數 $length): 整數

此函式類似於 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() - 返回字串的一部分

發現問題了嗎？

瞭解如何改進此頁面 • 提交 Pull Request • 回報錯誤

＋新增註釋

使用者貢獻的註釋 5 則註釋

向上

向下

codeguru at crazyprogrammer dot cba dot pl ¶

16 年前

我進行了以下實驗來比較陣列。

第一種 - 使用 (substr($key,0,5 == "HTTP_") 和第二種 - 使用 (!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
(compatible; 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 ¶

8 年前

文件中未包含的註記

int strcmp ( string $str1 , string $str2 )

如果 str1 小於 str2，則返回 < 0；如果 str1 大於 str2，則返回 > 0；如果它們相等，則返回 0。

我的補充說明
如果 str1 和 str2 不相等，並且 str1 是 str2 的子字串，反之亦然。 返回的整數值將為負數或正數，表示兩個字串之間的字元數差異的絕對值。

範例

<?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));

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

//tests
$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;
}

//print
asort($res);
print_r($res);
echo "\n$r"; // makes sure no auto-optimization occurs
?>

輸出如下
<?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 
?>

＋新增註釋