variant_cmp

(PHP 5, PHP 7)

variant_cmpCompares two variants

Descrição

variant_cmp ( mixed $left , mixed $right [, int $lcid [, int $flags ]] ) : int

Compares left with right.

This function will only compare scalar values, not arrays or variant records.

Parâmetros

left

The left operand.

right

The right operand.

lcid

A valid Locale Identifier to use when comparing strings (this affects string collation).

flags

flags can be one or more of the following values OR'd together, and affects string comparisons:

Variant Comparision Flags
value meaning
NORM_IGNORECASE Compare case insensitively
NORM_IGNORENONSPACE Ignore nonspacing characters
NORM_IGNORESYMBOLS Ignore symbols
NORM_IGNOREWIDTH Ignore string width
NORM_IGNOREKANATYPE Ignore Kana type
NORM_IGNOREKASHIDA Ignore Arabic kashida characters

Nota:

Assim como todas as funções aritméticas, os parâmetros para esta função podem ser qualquer um tipo nativo do PHP (integer, string, ponto flutuante, booleano ou NULL), ou uma instancia de uma classe COM, VARIANT ou DOTNET. Tipos nativos do PHP serão convertidos para variants usando as mesmas regras como mencionadas no construtor da classe VARIANT. Objetos COM e DOTNET terão o valor de suas propriedades padrão obtidos e usados como um valor variant.

As funções aritméticas variant são wrappers para funções chamadas similarmente na biblioteca COM; para mais informação sobre estas funções, consulte o MSDN. As funções PHP são nomeadas ligeiramente diferentes; por exemplo variant_add() no PHP corresponde à VarAdd() na documentação MSDN.

Valor Retornado

Returns one of the following:

Variant Comparision Results
value meaning
VARCMP_LT left is less than right
VARCMP_EQ left is equal to right
VARCMP_GT left is greater than right
VARCMP_NULL Either left, right or both are NULL