array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.strnatcasecmp.php', 1 => 'strnatcasecmp', 2 => '"自然順"アルゴリズムにより大文字小文字を区別しない文字列比較を行う', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String 関数', ), 'prev' => array ( 0 => 'function.strlen.php', 1 => 'strlen', ), 'next' => array ( 0 => 'function.strnatcmp.php', 1 => 'strnatcmp', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/strings/functions/strnatcasecmp.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

strnatcasecmp

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

strnatcasecmp — "自然順"アルゴリズムにより大文字小文字を区別しない文字列比較を行う

説明

strnatcasecmp(string $string1, string $string2): int

この関数は、人間が行うような手法でアルファベットまたは数字の 文字列の順序を比較するアルゴリズムを実装します。この関数の動作は、 strnatcmp() に似ていますが、 比較が大文字小文字を区別しない違いがあります。 詳細な情報については、Martin Pool の » 自然順文字列比較 のページを参照ください。

パラメータ

string1

最初の文字列。

string2

次の文字列。

戻り値

string1 が string2 より小さければ 0 より小さな値を、 string1 が string2 より大きければ 0 より大きな値を、 両者が等しければ 0 を返します。 返却される値の絶対値に、特に意味はありません。

変更履歴

バージョン 説明
8.2.0 この関数は、2つの文字列の長さが等しくない場合に strlen($string1) - strlen($string2) を返すとは限らなくなりました。 代わりに、-1 や 1 を返す可能性があります。

例

例1 strnatcasecmp() の例

<?php

var_dump(strnatcasecmp('Apple', 'Banana'));
var_dump(strnatcasecmp('Banana', 'Apple'));
var_dump(strnatcasecmp('apple', 'Apple'));
?>

上の例の出力は以下となります。

int(-1)
int(1)
int(0)

参考