smarty/docs/ja/designers/language-builtin-functions/language-function-if.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2715 Maintainer: takagi Status: ready -->
<!-- CREDITS: mat-sh,daichi,joe -->
<sect1 id="language.function.if">
 <title>{if},{elseif},{else}</title>
 <para>
  Smarty における <varname>{if}</varname> ステートメントは、PHP の
  <ulink url="&url.php-manual;if">if</ulink> と同等の柔軟性を持っています。
  さらに、テンプレートエンジンのための機能をいくつか追加しています。
  全ての <varname>{if}</varname> は、対応する
  <varname>{/if}</varname> とペアである必要があります。<varname>{else}</varname>
  と <varname>{elseif}</varname> も使用できます。
  <emphasis>||</emphasis> や <emphasis>or</emphasis>、
  <emphasis>&amp;&amp;</emphasis>、<emphasis>and</emphasis>、
  <emphasis>is_array()</emphasis> など、PHP の条件演算子や関数はすべて利用可能です。
 </para>
 <para>
  <link linkend="variable.security"><parameter>$security</parameter></link>
  が有効な場合は、 <link
  linkend="variable.security.settings"><parameter>$security_settings</parameter></link>
  の配列 <emphasis>IF_FUNCS</emphasis> に含まれる PHP の関数のみが利用可能となります。
 </para>
 <para>
  以下は認識される条件演算子の一覧です。
  これらはスペースによって周りの要素から分離される必要があります。
  [] 内に記載された項目は任意である事に注意して下さい。
  "PHP 相当" には、PHP において当てはまるものが示されます。
 </para>

 <informaltable frame="all">
  <tgroup cols="4">
   <colspec colname="qualifier" align="center" />
   <colspec colname="alternates" align="center" />
   <colspec colname="meaning" />
   <colspec colname="example" />
   <colspec colname="php" />
   <thead>
    <row>
     <entry>条件演算子</entry>
     <entry>代替</entry>
     <entry>構文例</entry>
     <entry>意味</entry>
     <entry>PHP 相当</entry>
    </row>
   </thead>
   <tbody>
    <row>
     <entry>==</entry>
     <entry>eq</entry>
     <entry>$a eq $b</entry>
     <entry>等しい</entry>
     <entry>==</entry>
    </row>
    <row>
     <entry>!=</entry>
     <entry>ne, neq</entry>
     <entry>$a neq $b</entry>
     <entry>等しくない</entry>
     <entry>!=</entry>
    </row>
    <row>
     <entry>&gt;</entry>
     <entry>gt</entry>
     <entry>$a gt $b</entry>
     <entry>より大きい</entry>
     <entry>&gt;</entry>
    </row>
    <row>
     <entry>&lt;</entry>
     <entry>lt</entry>
     <entry>$a lt $b</entry>
     <entry>より小さい</entry>
     <entry>&lt;</entry>
    </row>
    <row>
     <entry>&gt;=</entry>
     <entry>gte, ge</entry>
     <entry>$a ge $b</entry>
     <entry>以上</entry>
     <entry>&gt;=</entry>
    </row>
    <row>
     <entry>&lt;=</entry>
     <entry>lte, le</entry>
     <entry>$a le $b</entry>
     <entry>以下</entry>
     <entry>&lt;=</entry>
    </row>
    <row>
     <entry>===</entry>
     <entry></entry>
     <entry>$a === 0</entry>
     <entry>同一性のチェック</entry>
     <entry>===</entry>
    </row>
    <row>
     <entry>!</entry>
     <entry>not</entry>
     <entry>not $a</entry>
     <entry>否定 (単項)</entry>
     <entry>!</entry>
    </row>
    <row>
     <entry>%</entry>
     <entry>mod</entry>
     <entry>$a mod $b</entry>
     <entry>剰余</entry>
     <entry>%</entry>
    </row>
    <row>
     <entry>is [not] div by</entry>
     <entry></entry>
     <entry>$a is not div by 4</entry>
     <entry>割り切れる</entry>
     <entry>$a % $b == 0</entry>
    </row>
    <row>
     <entry>is [not] even</entry>
     <entry></entry>
     <entry>$a is not even</entry>
     <entry>偶数である [ない] (単項)</entry>
     <entry>$a % 2 == 0</entry>
    </row>
    <row>
     <entry>is [not] even by</entry>
     <entry></entry>
     <entry>$a is not even by $b</entry>
     <entry>偶数番目のグループである [ない]</entry>
     <entry>($a / $b) % 2 == 0</entry>
    </row>
    <row>
     <entry>is [not] odd</entry>
     <entry></entry>
     <entry>$a is not odd</entry>
     <entry>奇数である [ない] (単項)</entry>
     <entry>$a % 2 != 0</entry>
    </row>
    <row>
     <entry>is [not] odd by</entry>
     <entry></entry>
     <entry>$a is not odd by $b</entry>
     <entry>奇数番目のグループである [ない]</entry>
     <entry>($a / $b) % 2 != 0</entry>
    </row>
   </tbody>
  </tgroup>
 </informaltable>
 <example>
  <title>{if} ステートメント</title>
  <programlisting>
<![CDATA[
{if $name eq 'Fred'}
    Welcome Sir.
{elseif $name eq 'Wilma'}
    Welcome Ma'am.
{else}
    Welcome, whatever you are.
{/if}

{* 論理演算子 "or" の例 *}
{if $name eq 'Fred' or $name eq 'Wilma'}
   ...
{/if}

{* 上と同じ *}
{if $name == 'Fred' || $name == 'Wilma'}
   ...
{/if}


{* 括弧は使用可能 *}
{if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#}
   ...
{/if}


{* PHP 関数を埋め込むことも可能 *}
{if count($var) gt 0}
   ...
{/if}

{* 配列のチェック *}
{if is_array($foo) }
   .....
{/if}

{* null でないことのチェック *}
{if isset($foo) }
   .....
{/if}


{* 値が偶数か奇数か *}
{if $var is even}
   ...
{/if}
{if $var is odd}
   ...
{/if}
{if $var is not odd}
   ...
{/if}


{* 値が 4 で割り切れるかどうか *}
{if $var is div by 4}
   ...
{/if}


{*
  ふたつずつグループ化したときに、値が even であるかどうか
  0=even, 1=even, 2=odd, 3=odd, 4=even, 5=even, etc.
*}
{if $var is even by 2}
   ...
{/if}

{* 0=even, 1=even, 2=even, 3=odd, 4=odd, 5=odd, etc. *}
{if $var is even by 3}
   ...
{/if}
]]>
  </programlisting>
 </example>


 <example>
   <title>{if} のその他の例</title>
<programlisting>
 <![CDATA[
{if isset($name) && $name == 'Blog'}
     {* 何かを行います *}
{elseif $name == $foo}
    {* 何かを行います *}
{/if}

{if is_array($foo) && count($foo) > 0)
    {* foreach ループを実行します *}
{/if}
  ]]>
</programlisting>
 </example>

</sect1>
<!-- Keep this comment at the end of the file
     Local variables:
     mode: sgml
     sgml-omittag:t
     sgml-shorttag:t
     sgml-minimize-attributes:nil
     sgml-always-quote-attributes:t
     sgml-indent-step:1
     sgml-indent-data:t
     indent-tabs-mode:nil
     sgml-parent-document:nil
     sgml-default-dtd-file:"../../../../manual.ced"
     sgml-exposed-tags:nil
     sgml-local-catalogs:nil
     sgml-local-ecat-files:nil
     End:
     vim600: syn=xml fen fdm=syntax fdl=2 si
     vim: et tw=78 syn=sgml
     vi: ts=1 sw=1
-->