JSTLコア・ライブラリ - <c:forTokens>タグ

指定のデリミタで区切られたトークンを反復します。

構文

<c:forTokens items="stringOfTokens" delims=" delimiters"
   [var="varName"]
   [varStatus="varStatusName"]
   [begin="begin "] [end="end"] [step="step"]>
       body content
</c:forEach>

ボディ・コンテンツ

JSP。反復対象の項目が存在するかぎり、JSPコンテナによってボディ・コンテンツが処理され、現在のJspWriterに書き込まれます。

属性

var
現在反復されている項目を格納するエクスポート・スコープ変数の名前。このスコープ変数はネストされた可視性を持ちます。
items
反復するトークンの文字列。
delims
デリミタ(文字列内でトークンを区切る文字)のセット。
varStatus
反復のステータスを格納するエクスポート・スコープ変数の名前。エクスポートされるオブジェクトはjavax.servlet.jsp.jstl.core.LoopTagStatus型です。このスコープ変数はネストされた可視性を持ちます。
begin
指定のインデックスの位置にあるトークンから反復が開始されます。最初のトークンのインデックスは0です。
end
指定のインデックスの位置にあるトークン(そのトークンを含む)で反復が終了します。
step
文字列のトークンを、最初のトークンからstepに指定した数ずつ反復処理します。

制約

NULLおよびエラーの処理

itemsがNULLの場合、空のコレクションとして扱われます。つまり、反復は実行されません。

delimsがNULLの場合、itemsは単一のモノリシック・トークンとして扱われます。したがって、delimsがNULLの場合、<c:forTokens>は0回(itemsもNULLの場合)、または1回のみ反復します。

説明

文字列のトークンは、引数としてitems(トークン化される文字列)およびdelims(デリミタ)を指定したjava.util.StringTokenizerのインスタンスを使用して取得されます。

トークンはデリミタ文字で区切ります。トークンとは、デリミタではない連続した文字の最大のシーケンスです。


JDeveloperのJSTLタグ・ライブラリについて
リファレンス: JavaServer Pages標準タグ・ライブラリ(JSTL)

 

Copyright © 1997, 2004, Oracle. All rights reserved.