downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

substr_count> <strtr
Last updated: Fri, 13 Nov 2009

view this page in

substr_compare

(PHP 5)

substr_compare指定した位置から指定した長さの 2 つの文字列について、バイナリ対応で比較する

説明

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

substr_compare() は、main_stroffset 文字目以降の最大 length 文字を、str と比較します。

パラメータ

main_str

str

offset

比較を開始する位置。 負の値を指定した場合は、文字列の最後から数えます。

length

比較する長さ。

case_insensitivity

case_insensitivityTRUE の場合、 大文字小文字を区別せずに比較します。

返り値

main_stroffset 以降が str より小さい場合に負の数、 str より大きい場合に正の数、 等しい場合に 0 を返します。offsetmain_str の長さ以上であり、かつ length が設定されている場合、substr_compare() は警告を表示して FALSE を返します。

変更履歴

バージョン 説明
5.1.0 負の offset を使用できるようになりました。

例1 substr_compare() の例

<?php
echo substr_compare("abcde""bc"12); // 0
echo substr_compare("abcde""de", -22); // 0
echo substr_compare("abcde""bcg"12); // 0
echo substr_compare("abcde""BC"12true); // 0
echo substr_compare("abcde""bc"13); // 1
echo substr_compare("abcde""cd"12); // -1
echo substr_compare("abcde""abc"51); // 警告
?>



add a note add a note User Contributed Notes
substr_compare
sleek
23-May-2005 12:07
Modified version of the original posted function. Use this one:

<?php
if (!function_exists('substr_compare')) {
    function
substr_compare($main_str, $str, $offset, $length = NULL, $case_insensitivity = false) {
       
$offset = (int) $offset;

       
// Throw a warning because the offset is invalid
       
if ($offset >= strlen($main_str)) {
           
trigger_error('The start position cannot exceed initial string length.', E_USER_WARNING);
            return
false;
        }

       
// We are comparing the first n-characters of each string, so let's use the PHP function to do it
       
if ($offset == 0 && is_int($length) && $case_insensitivity === true) {
            return
strncasecmp($main_str, $str, $length);
        }

       
// Get the substring that we are comparing
       
if (is_int($length)) {
           
$main_substr = substr($main_str, $offset, $length);
           
$str_substr = substr($str, 0, $length);
        } else {
           
$main_substr = substr($main_str, $offset);
           
$str_substr = $str;
        }

       
// Return a case-insensitive comparison of the two strings
       
if ($case_insensitivity === true) {
            return
strcasecmp($main_substr, $str_substr);
        }

       
// Return a case-sensitive comparison of the two strings
       
return strcmp($main_substr, $str_substr);
    }
}
?>

substr_count> <strtr
Last updated: Fri, 13 Nov 2009
 
 
show source | credits | stats | sitemap | contact | advertising | mirror sites