arc:enum

​

パラメータ

• item：アトリビュートを反復するアイテムの名前。
• attr：どのアトリビュートを反復するかを指定する、マッチするエクスプレッション。例えば、arc:* です。このパラメータを指定して、複数値のパラメータの値を反復することもできます。
• prefix：アイテムが列挙される基になる接頭辞。
• expand：複数値のアトリビュートが検出された場合に、どのようにarc:enum が挙動するかを指定するboolean 値。expand がtrue に設定されている場合、arc:enum のボディはアトリビュートのそれぞれの値につき一度づつ実行されます。false の場合、すべての値は1つの文字列値として結合され、一度の反復が実行されます。デフォルトで、arc:enum はすべての値をexpand しません。
• sep[arator]：expand パラメータがfalse の場合に、複数値のアトリビュートの値を結合させるために使われるセパレータ。このパラメータは、listseparator が定義されていない場合にリストの値をトークン化するためにも使われます。デフォルト値は改行文字（\n）です。
• list：列挙する区切られた値のリスト。例えば、値のリストがviolet, indigo, blue, green, yellow, orange, red で、セパレータがカンマ（,）の場合、arc:enum のスコープは虹の色ごとに実行されます。
• range：昇順、降順で列挙される数字もしくは文字の範囲。例えば、a..z やZ..A です。

​

アトリビュートの制御

• _attr：反復されるアトリビュートの名前。複数値のアトリビュートの値を反復している場合、名前の一部としてindex を持つ以外はアトリビュート名は同じです。Index は、ハッシュ記号（#）で名前と区別されます。例えば、name#1、name#2、などです。
• _index：アイテムでアトリビュートが出現するindex、もしくはリストエレメントが現在列挙されている位置。
• _value：反復されるアトリビュートの値。複数値のアトリビュートでは、expand およびseparator 設定は、_value が1つのアトリビュート値の参照なのか、すべてのアトリビュート値の参照なのかを決定します。
• _count：アトリビュート内またはリスト内の値の数。
• _separator：リスト内の値を区切るセパレータ。

​

例

<arc:set item="input" attr="Greeting" value="Hello" />
<arc:set item="input" attr="Goodbye" value="See ya" />
<arc:enum item="input">
  [_attr] is [_value]
  <br/>
</arc:enum> 

goodbye is See ya greeting is Hello

<arc:set attr="colors" value="violet, indigo, blue, green, yellow, orange, red"/>
<arc:enum list="[colors]" separator=",">
  [_value] 
</arc:enum>

<arc:enum range="a..z">
  [_value] 
</arc:enum>
<arc:enum range="Z..A">
  [_value] 
</arc:enum>
<arc:enum range="1..25">
  [_value] 
</arc:enum>

<arc:set attr="foo.email#1" value="joe@mycompany.com"/>
<arc:set attr="foo.email#2" value="john@mycompany.com"/>
<arc:enum attr="foo.email" expand="true">
    ([_index]) [_attr] -> [_value]
</arc:enum>

(1) email#1 -> joe@mycompany.com (2) email#2 -> john@mycompany.com

​

関連項目

• arc:break：arc:call またはarc:enum の反復を終了する。
• arc:continue：arc:call またはarc:enum の反復をスキップする。
• arc:first：最初の反復で特別な処理を行う。
• arc:last：最後の反復で特別な処理を行う。