Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

Comparação de três vias (<=>)

Devolve a comparação como inteiro numa função de ordenação. Trocar os operandos inverte a ordem.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

$left <=> $right

Devolve a comparação como inteiro numa função de ordenação. Trocar os operandos inverte a ordem.

Para dois números, o sinal do resultado indica a sua ordem. Um valor negativo indica que o primeiro é menor, zero indica igualdade e um valor positivo indica que o primeiro é maior. Esta convenção serve para uma função de comparação de usort.

  • 5 <=> 8 → -1
  • 8 <=> 8 → 0
  • 11 <=> 8 → 1
  • $items = [3,9,2]; usort($items, fn($a, $b) => $b <=> $a); echo json_encode($items); → [9,3,2]

Exemplos

<?php
echo json_encode(5 <=> 8), PHP_EOL;
echo json_encode(8 <=> 8), PHP_EOL;
echo json_encode(11 <=> 8), PHP_EOL;
$items = [3, 9, 2];
usort($items, fn($a, $b) => $b <=> $a);
echo json_encode($items), PHP_EOL;

Resultado

-1
0
1
[9,3,2]

Fontes