Função strcoll

A função strcoll compara duas strings levando em conta a localidade atual. No primeiro parâmetro é passada a primeira string para comparação, no segundo - a segunda string. A função retorna 0 se as strings são idênticas, o número -1 se a primeira string for menor que a segunda, e um número maior que 1 se a primeira string for maior que a segunda.

Sintaxe

phpstrcoll(string1, string2);

Exemplo

Comparação de strings com diferentes localidades:

php<?php
  setlocale(LC_COLLATE, 'en_US.UTF-8');
  $res1 = strcoll('apple', 'banana');
  
  setlocale(LC_COLLATE, 'de_DE.UTF-8');
  $res2 = strcoll('äpfel', 'zebra');
  
  echo $res1;
  echo $res2;
?>

Resultado da execução do código:

php-1
-1

Exemplo

Comparação de strings idênticas:

php<?php
  setlocale(LC_COLLATE, 'ru_RU.UTF-8');
  $res = strcoll('строка', 'строка');
  echo $res;
?>

Resultado da execução do código:

php0

Veja também

  • a função strcmp,
    que compara strings sem considerar a localidade
  • a função strcasecmp,
    que compara strings sem diferenciar maiúsculas de minúsculas