<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.com.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'function.variant-cmp.php',
    1 => 'variant_cmp',
    2 => '2 つの variant を比較する',
  ),
  'up' => 
  array (
    0 => 'ref.com.php',
    1 => 'COM関数',
  ),
  'prev' => 
  array (
    0 => 'function.variant-cat.php',
    1 => 'variant_cat',
  ),
  'next' => 
  array (
    0 => 'function.variant-date-from-timestamp.php',
    1 => 'variant_date_from_timestamp',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'reference/com/functions/variant-cmp.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.variant-cmp" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">variant_cmp</h1>
  <p class="verinfo">(PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">variant_cmp</span> &mdash; <span class="dc-title">2 つの variant を比較する</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.variant-cmp-description">
  <h3 class="title">説明</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>variant_cmp</strong></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$left</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$right</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$locale_id</code><span class="initializer"> = <strong><code><a href="com.constants.php#constant.locale-system-default">LOCALE_SYSTEM_DEFAULT</a></code></strong></span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$flags</code><span class="initializer"> = 0</span></span><br>): <span class="type"><a href="language.types.integer.php" class="type int">int</a></span></div>

  <p class="para rdfs-comment">
   <code class="parameter">left</code> と <code class="parameter">right</code>
   を比較します。
  </p>
  <p class="para">
   この関数はスカラー値のみを比較します。配列や variant レコードは比較しません。
  </p>
 </div>

 <div class="refsect1 parameters" id="refsect1-function.variant-cmp-parameters">
  <h3 class="title">パラメータ</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">left</code></dt>
     <dd>
      <p class="para">
       左オペランド。
      </p>
     </dd>
    
    
     <dt><code class="parameter">right</code></dt>
     <dd>
      <p class="para">
       右オペランド。
      </p>
     </dd>
    
    
     <dt><code class="parameter">locale_id</code></dt>
     <dd>
      <p class="para">
       文字列の比較に使用する有効なロケール識別子です
       (これは文字列の比較に影響します)。
      </p>
     </dd>
    
    
     <dt><code class="parameter">flags</code></dt>
     <dd>
      <p class="para">
       <code class="parameter">flags</code> は、以下のひとつあるいは複数の値を
       OR で組み合わせたもので、文字列の比較に影響します。
       <table class="doctable table">
        <caption><strong>Variant の比較フラグ</strong></caption>
        
         <thead>
          <tr>
           <th>値</th>
           <th>意味</th>
          </tr>

         </thead>

         <tbody class="tbody">
          <tr>
           <td><strong><code><a href="com.constants.php#constant.norm-ignorecase">NORM_IGNORECASE</a></code></strong></td>
           <td>大文字小文字を区別せずに比較する</td>
          </tr>

          <tr>
           <td><strong><code><a href="com.constants.php#constant.norm-ignorenonspace">NORM_IGNORENONSPACE</a></code></strong></td>
           <td>非スペーシング文字を無視する</td>
          </tr>

          <tr>
           <td><strong><code><a href="com.constants.php#constant.norm-ignoresymbols">NORM_IGNORESYMBOLS</a></code></strong></td>
           <td>記号を無視する</td>
          </tr>

          <tr>
           <td><strong><code><a href="com.constants.php#constant.norm-ignorewidth">NORM_IGNOREWIDTH</a></code></strong></td>
           <td>全角半角を区別しない</td>
          </tr>

          <tr>
           <td><strong><code><a href="com.constants.php#constant.norm-ignorekanatype">NORM_IGNOREKANATYPE</a></code></strong></td>
           <td>ひらがなカタカナを区別しない</td>
          </tr>

          <tr>
           <td><strong><code><a href="com.constants.php#constant.norm-ignorekashida">NORM_IGNOREKASHIDA</a></code></strong></td>
           <td>アラビア語の kashida 文字を無視する</td>
          </tr>

         </tbody>
        
       </table>

      </p>
     </dd>
    
   </dl>
  </p>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
<p class="para">
 variant に関するすべての計算用関数と同様、この関数のパラメータには
 PHP のネイティブ型 (整数、文字列、浮動小数点数、boolean あるいは
 <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>) あるいは COM、VARIANT、DOTNET クラスのインスタンスが使用できます。
 PHP のネイティブ型は、<a href="class.variant.php" class="xref">variant</a>
 クラスのコンストラクタと同じ方法で variant に変換されます。
 COM オブジェクトおよび DOTNET オブジェクトはデフォルトプロパティの値を持っており、
 これを variant の値として使用します。
</p>
<p class="para">
 variant に関する計算関数は、COM ライブラリの同名の関数のラッパーです。
 これらの関数についての詳細な情報は、MSDN ライブラリでご確認ください。
 PHP での関数名は微妙に異なります。たとえば、PHP での関数
 <span class="function"><a href="function.variant-add.php" class="function">variant_add()</a></span> に対応する関数は、MSDN のドキュメントでは
 <code class="literal">VarAdd()</code> となります。
</p>
</p></blockquote>

 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.variant-cmp-returnvalues">
  <h3 class="title">戻り値</h3>
  <p class="para">
   以下のいずれかを返します。
   <table class="doctable table">
    <caption><strong>Variant の比較結果</strong></caption>
    
     <thead>
      <tr>
       <th>値</th>
       <th>意味</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td><strong><code><a href="com.constants.php#constant.varcmp-lt">VARCMP_LT</a></code></strong></td>
       <td><code class="parameter">left</code> は
        <code class="parameter">right</code> より小さい
       </td>
      </tr>

      <tr>
       <td><strong><code><a href="com.constants.php#constant.varcmp-eq">VARCMP_EQ</a></code></strong></td>
       <td><code class="parameter">left</code> は
        <code class="parameter">right</code> と等しい
       </td>
      </tr>

      <tr>
       <td><strong><code><a href="com.constants.php#constant.varcmp-gt">VARCMP_GT</a></code></strong></td>
       <td><code class="parameter">left</code> は
        <code class="parameter">right</code> より大きい
       </td>
      </tr>

      <tr>
       <td><strong><code><a href="com.constants.php#constant.varcmp-null">VARCMP_NULL</a></code></strong></td>
       <td><code class="parameter">left</code> と
        <code class="parameter">right</code> のいずれか、あるいは両方が <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>
       </td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>

</div><?php manual_footer($setup); ?>