strcasecmp
(PHP 4, PHP 5, PHP 7)
strcasecmp — Бинарно-безопасное сравнение строк без учета регистра
Описание
int strcasecmp
( string
$str1
, string $str2
)Бинарно-безопасное сравнение строк без учета регистра.
Список параметров
-
str1 -
Первая строка
-
str2 -
Вторая строка
Возвращаемые значения
Возвращает отрицательное число, если str1
меньше, чем str2, положительное число,
если str1 больше, чем str2,
и 0 если строки равны.
Примеры
Пример #1 Пример использования strcasecmp()
<?php
$var1 = "Hello";
$var2 = "hello";
if (strcasecmp($var1, $var2) == 0) {
echo '$var1 равно $var2 при сравнении без учета регистра';
}
?>
Смотрите также
- strcmp() - Бинарно-безопасное сравнение строк
- preg_match() - Выполняет проверку на соответствие регулярному выражению
- substr_compare() - Бинарно-безопасное сравнение 2 строк со смещением, с учетом или без учета регистра
- strncasecmp() - Бинарно-безопасное сравнение первых n символов строк без учета регистра
- stristr() - Регистронезависимый вариант функции strstr
- substr() - Возвращает подстроку
- addcslashes
- addslashes
- bin2hex
- chop
- chr
- chunk_split
- convert_cyr_string
- convert_uudecode
- convert_uuencode
- count_chars
- crc32
- crypt
- echo
- explode
- fprintf
- get_html_translation_table
- hebrev
- hebrevc
- hex2bin
- html_entity_decode
- htmlentities
- htmlspecialchars_decode
- htmlspecialchars
- implode
- join
- lcfirst
- levenshtein
- localeconv
- ltrim
- md5_file
- md5
- metaphone
- money_format
- nl_langinfo
- nl2br
- number_format
- ord
- parse_str
- printf
- quoted_printable_decode
- quoted_printable_encode
- quotemeta
- rtrim
- setlocale
- sha1_file
- sha1
- similar_text
- soundex
- sprintf
- sscanf
- str_getcsv
- str_ireplace
- str_pad
- str_repeat
- str_replace
- str_rot13
- str_shuffle
- str_split
- str_word_count
- strcasecmp
- strchr
- strcmp
- strcoll
- strcspn
- strip_tags
- stripcslashes
- stripos
- stripslashes
- stristr
- strlen
- strnatcasecmp
- strnatcmp
- strncasecmp
- strncmp
- strpbrk
- strpos
- strrchr
- strrev
- strripos
- strrpos
- strspn
- strstr
- strtok
- strtolower
- strtoupper
- strtr
- substr_compare
- substr_count
- substr_replace
- substr
- trim
- ucfirst
- ucwords
- vfprintf
- vprintf
- vsprintf
- wordwrap
Коментарии
The sample above is only true on some platforms that only use a simple 'C' locale, where individual bytes are considered as complete characters that are converted to lowercase before being differentiated.
Other locales (see LC_COLLATE and LC_ALL) use the difference of collation order of characters, where characters may be groups of bytes taken from the input strings, or simply return -1, 0, or 1 as the collation order is not simply defined by comparing individual characters but by more complex rules.
Don't base your code on a specific non null value returned by strcmp() or strcasecmp(): it is not portable. Just consider the sign of the result and be sure to use the correct locale!
Don't forget this is a single-byte function: in Unicode strings it'll provide incoherent results as soon as both strings differ only in case. There doesn't seem to exist a built-in multi-byte alternative so you need to write your own, taking into account both character encoding and collation.A simple multibyte-safe case-insensitive string comparison:
<?php
function mb_strcasecmp($str1, $str2, $encoding = null) {
if (null === $encoding) { $encoding = mb_internal_encoding(); }
return strcmp(mb_strtoupper($str1, $encoding), mb_strtoupper($str2, $encoding));
}
?>
Caveat: watch out for edge cases like "ß".
I didn't see any explanation in the documentation as to precisely how the positive/negative return values are calculated for unequal strings.
After a bit of experimentation it appears that it's the difference in alphabetical position of the first character in unequal strings.
For example, the letter 'z' is the 26th letter while the letter 'a' is the 1st letter:
<?php
$zappl = "zappl";
$apple = "apple";
echo strcasecmp($zappl, $apple); #outputs 25 [26 - 1]
echo strcasecmp($apple, $zappl); #outputs -25 [1 - 26]
?>
This might be incredibly obvious to most people, but hopefully it will clarify the calculation process for some others.