Função PHP substr_compare()
Exemplo
Compare duas strings:
<?php
echo substr_compare("Hello world","Hello world",0);
?>
Definição e uso
A função substr_compare() compara duas strings de uma posição inicial especificada.
Dica: Esta função é segura para binários e opcionalmente diferencia maiúsculas de minúsculas.
Sintaxe
substr_compare(string1,string2,startpos,length,case)
Valores de parâmetro
Parameter | Description |
---|---|
string1 | Required. Specifies the first string to compare |
string2 | Required. Specifies the second string to compare |
startpos | Required. Specifies where to start comparing in string1. If negative, it starts counting from the end of the string |
length | Optional. Specifies how much of string1 to compare |
case | Optional. A boolean value that specifies whether or not to perform a case-sensitive compare:
|
Detalhes técnicos
Valor de retorno: | Esta função retorna:
|
---|---|
Versão do PHP: | 5+ |
Registro de alterações: | A partir do PHP 5.5.11 - O parâmetro length pode ser 0. A partir do PHP 5.1, agora é possível usar um startpos negativo. |
Mais exemplos
Exemplo
Compare duas strings, quando a posição inicial na string1 para a comparação for a 6ª:
<?php
echo substr_compare("Hello world","world",6);
?>
Exemplo
Usando todos os parâmetros:
<?php
echo substr_compare("world","or",1,2);
echo substr_compare("world","ld",-2,2);
echo substr_compare("world","orl",1,2);
echo substr_compare("world","OR",1,2,TRUE);
echo substr_compare("world","or",1,3);
echo substr_compare("world","rl",1,2);
?>
Exemplo
Diferentes valores de retorno:
<?php
echo substr_compare("Hello world!","Hello world!",0); // the two strings are equal
echo substr_compare("Hello world!","Hello",0); // string1 is greater than string2
echo substr_compare("Hello world!","Hello world! Hello!",0); // str1 is less than str2
?>
❮ Referência de String PHP