variant_cmp

(PHP 5, PHP 7)

variant_cmpCompara dos variantes

Descripción

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

Compara left con right.

Esta fucnión sólo comparará valores escalares, no arrays o registros de variantes.

Parámetros

left

El operando izquierdo.

right

El operando derecho.

lcid

Un Identificador Regional válido a usar cuando se comparan cadenas (esto afecta a la compaginación de cadenas).

flags

flags puede ser uno o más de los siguientes valores usando OR entre ellos, y afecta a la comparación de cadenas:

Banderas de Comparación de Variantes
valor significado
NORM_IGNORECASE Comparara de forma insensible a mayúsculas-minúsculas
NORM_IGNORENONSPACE Ignorar caracteres que no son de espacio
NORM_IGNORESYMBOLS Ignorar símbolos
NORM_IGNOREWIDTH Ignorar el ancho de cadena
NORM_IGNOREKANATYPE Ignorar el tipo Kana
NORM_IGNOREKASHIDA Ignorar caracteras kashida arábigos

Nota:

Al igual que con todas las funciones aritméticas variantes, los parámetros de esta función pueden ser tanto un tipo nativo de PHP (integer, string, de punto flotante, boolean o NULL), o una instancia de una clase COM, VARIANT o DOTNET. Los tipos nativos de PHP serán convertidos en variantes usando las mismas reglas tal como se encuentran en el constructor para la clase VARIANT. Los objetos COM y DOTNET tomarán el valor de sus propiedades predeterminadas adoptadas y lo utilizarán como el valor variante.

Las funciones aritméticas variantes son wrappers alrededor de las funciones con nombres similares en la librería COM; para más información sobre estas funciones, consulte la librería MSDN. Las funciones de PHP tienen nombres ligeramente diferentes; por ejemplo, variant_add() en PHP corresponde a VarAdd() en la documentación MSDN.

Valores devueltos

Devuelve un valor de los siguientes:

Resultados de la Comparación de Variantes
valor significado
VARCMP_LT left es menor que right
VARCMP_EQ left es igual que right
VARCMP_GT left es mayor que right
VARCMP_NULL left o, right o ambos son NULL