Compara duas variantes

Descrição

variant_cmp(
    mixed $left,
    mixed $right,
    int $locale_id = LOCALE_SYSTEM_DEFAULT,
    int $flags = 0
): int

Compara left com right.

Esta função apenas compara valores escalares, e não arrays ou registros de variantes.

Parâmetros

left

O termo da esquerda.

right

O termo da direita.

locale_id

Um identificador de localidade válido a ser usado na comparação de strings (isso afeta a ordem de comparação).

flags

flags pode ser uma ou mais das constantes a seguir, combinadas com o operador binário OR, e afeta as comparações entre strings:

**Opções de Comparações entre Variantes**
valor	significado
`NORM_IGNORECASE`	Compara sem diferenciar maiúsculas de minúsculas
`NORM_IGNORENONSPACE`	Ignora caracteres que não sejam de espaçamento
`NORM_IGNORESYMBOLS`	Ignora símbolos
`NORM_IGNOREWIDTH`	Ignora largura da string
`NORM_IGNOREKANATYPE`	Ignora o tipo de Kana
`NORM_IGNOREKASHIDA`	Ignora caracteres arábicos kashida

Note:
Assim como todas as funções aritméticas variantes, os parâmetros para esta função podem ser um tipo nativo do PHP (inteiro, string, ponto flutuante, booleano ou null) ou uma instância de uma classe COM, VARIANT ou DOTNET. Tipos nativos do PHP serão convertidos em variantes usando as mesmas regras encontradas no construtor da classe variant. Objetos COM e DOTNET terão o valor de sua propriedade padrão obtido e usado como o valor da variante.

As funções aritméticas variantes são wrappers para funções com nomes semelhantes na biblioteca COM; para mais informações sobre estas funções, consulte a biblioteca MSDN. As funções do PHP são nomeadas de forma ligeiramente diferente; por exemplo, variant_add() no PHP corresponde a VarAdd() na documentação da MSDN.

Valor Retornado

Retorna uma das seguintes constantes:

**Resultado de Comparação de Variantes**
valor	significado
`VARCMP_LT`	`left` é menor que `right`
`VARCMP_EQ`	`left` é igual a `right`
`VARCMP_GT`	`left` é maior que `right`
`VARCMP_NULL`	`left`, `right` ou ambos são `null`