strnatcmp

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

strnatcmpString comparisons using a "natural order" algorithm

Descrição

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

This function implements a comparison algorithm that orders alphanumeric strings in the way a human being would, this is described as a "natural ordering". Note that this comparison is case sensitive.

Parâmetros

string1

The first string.

string2

The second string.

Valor Retornado

Similar to other string comparison functions, this one returns -1 if string1 is less than string2; 1 if string1 is greater than string2, and 0 if they are equal.

Registro de Alterações

VersãoDescrição
8.2.0 Esta função agora retorna -1 ou 1, onde anteriormente retornava um número negativo ou positivo.

Exemplos

An example of the difference between this algorithm and the regular computer string sorting algorithms (used in strcmp()) can be seen below:

<?php
$arr1
= $arr2 = array("img12.png", "img10.png", "img2.png", "img1.png");
echo
"Standard string comparison\n";
usort($arr1, "strcmp");
print_r($arr1);
echo
"\nNatural order string comparison\n";
usort($arr2, "strnatcmp");
print_r($arr2);
?>

O exemplo acima produzirá:

Standard string comparison Array ( [0] => img1.png [1] => img10.png [2] => img12.png [3] => img2.png ) Natural order string comparison Array ( [0] => img1.png [1] => img2.png [2] => img10.png [3] => img12.png )
For more information see: Martin Pool's » Natural Order String Comparison page.

Veja Também

  • preg_match() - Perform a regular expression match
  • strcasecmp() - Binary safe case-insensitive string comparison
  • substr() - Retorna parte de uma string
  • stristr() - Case-insensitive strstr
  • strcmp() - Binary safe string comparison
  • strncmp() - Binary safe string comparison of the first n characters
  • strncasecmp() - Comparação binária de strings, insensível a maiúsculas/minúsculas, dos primeiros n caracteres
  • strnatcasecmp() - Comparação de strings insensível a maiúsculas/minúsculas usando o algoritmo de "ordem natural"
  • strstr() - Find the first occurrence of a string
  • natsort() - Ordena um array utilizando o algoritmo de "ordem natural"
  • natcasesort() - Ordena um array utilizando o algoritmo da "ordem natural" sem diferenciar maiúsculas e minúsculas
To Top