<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >variant_cmp</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="Manual do PHP" HREF="index.html"><LINK REL="UP" TITLE="COM and .Net (Windows)" HREF="ref.com.html"><LINK REL="PREVIOUS" TITLE="variant_cat" HREF="function.variant-cat.html"><LINK REL="NEXT" TITLE="variant_date_from_timestamp" HREF="function.variant-date-from-timestamp.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=UTF-8"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >Manual do PHP</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.variant-cat.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.variant-date-from-timestamp.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.variant-cmp" ></A >variant_cmp</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN21373" ></A ><P > (PHP 5)</P >variant_cmp -- Compares two variants </DIV ><DIV CLASS="refsect1" ><A NAME="AEN21376" ></A ><H2 >Description</H2 >int <B CLASS="methodname" >variant_cmp</B > ( mixed left, mixed right [, int lcid [, int flags]] )<BR ></BR ><P > Compares <CODE CLASS="parameter" >left</CODE > with <CODE CLASS="parameter" >right</CODE > and returns one of the following values: <DIV CLASS="table" ><A NAME="AEN21396" ></A ><P ><B >Tabela 1. Variant Comparision Results</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><THEAD ><TR ><TH >value</TH ><TH >meaning</TH ></TR ></THEAD ><TBODY ><TR ><TD ><TT CLASS="constant" ><B >VARCMP_LT</B ></TT ></TD ><TD ><CODE CLASS="parameter" >left</CODE > is less than <CODE CLASS="parameter" >right</CODE > </TD ></TR ><TR ><TD ><TT CLASS="constant" ><B >VARCMP_EQ</B ></TT ></TD ><TD ><CODE CLASS="parameter" >left</CODE > is equal to <CODE CLASS="parameter" >right</CODE > </TD ></TR ><TR ><TD ><TT CLASS="constant" ><B >VARCMP_GT</B ></TT ></TD ><TD ><CODE CLASS="parameter" >left</CODE > is greater than <CODE CLASS="parameter" >right</CODE > </TD ></TR ><TR ><TD ><TT CLASS="constant" ><B >VARCMP_NULL</B ></TT ></TD ><TD >Either <CODE CLASS="parameter" >left</CODE >, <CODE CLASS="parameter" >right</CODE > or both are <TT CLASS="constant" ><B >NULL</B ></TT > </TD ></TR ></TBODY ></TABLE ></DIV > </P ><P > This function will only compare scalar values, not arrays or variant records. </P ><P > <CODE CLASS="parameter" >lcid</CODE > is a valid Locale Identifier to use when comparing strings (this affects string collation). <CODE CLASS="parameter" >flags</CODE > can be one or more of the following values OR'd together, and affects string comparisons: <DIV CLASS="table" ><A NAME="AEN21433" ></A ><P ><B >Tabela 2. Variant Comparision Flags</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><THEAD ><TR ><TH >value</TH ><TH >meaning</TH ></TR ></THEAD ><TBODY ><TR ><TD ><TT CLASS="constant" ><B >NORM_IGNORECASE</B ></TT ></TD ><TD >Compare case insensitively</TD ></TR ><TR ><TD ><TT CLASS="constant" ><B >NORM_IGNORENONSPACE</B ></TT ></TD ><TD >Ignore nonspacing characters</TD ></TR ><TR ><TD ><TT CLASS="constant" ><B >NORM_IGNORESYMBOLS</B ></TT ></TD ><TD >Ignore symbols</TD ></TR ><TR ><TD ><TT CLASS="constant" ><B >NORM_IGNOREWIDTH</B ></TT ></TD ><TD >Ignore string width</TD ></TR ><TR ><TD ><TT CLASS="constant" ><B >NORM_IGNOREKANATYPE</B ></TT ></TD ><TD >Ignore Kana type</TD ></TR ><TR ><TD ><TT CLASS="constant" ><B >NORM_IGNOREKASHIDA</B ></TT ></TD ><TD >Ignore Arabic kashida characters</TD ></TR ></TBODY ></TABLE ></DIV > </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > As with all the variant arithmetic functions, the parameters for this function can be either a PHP native type (integer, string, floating point, boolean or <TT CLASS="constant" ><B >NULL</B ></TT >), or an instance of a COM, VARIANT or DOTNET class. PHP native types will be converted to variants using the same rules as found in the constructor for the <A HREF="class.variant.html" >VARIANT</A > class. COM and DOTNET objects will have the value of their default property taken and used as the variant value. </P ><P > The variant arithmetic functions are wrappers around the similarly named functions in the COM library; for more information on these functions, consult the MSDN library. The PHP functions are named slightly differently; for example variant_add() in PHP corresponds to VarAdd() in the MSDN documentation. </P ></BLOCKQUOTE ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.variant-cat.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Principal</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.variant-date-from-timestamp.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >variant_cat</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.com.html" ACCESSKEY="U" >Acima</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >variant_date_from_timestamp</TD ></TR ></TABLE ></DIV ></BODY ></HTML >