メモ リスト添字演算子は Release 6 で新しく追加されました。

次の例は、[Categories] フィールドの要素 2 を返します。

Categories[2]

添字は、数字と、それを囲むカッコで構成されています。数値には、定数、変数、または式が使えます。小数点以下は整数に丸められます。添字はリスト名の後に付きます。

次の例は、変数の添字を使ってリストを反復します。

n := 1;
@While(n <= @Elements(Categories);
@Prompt([OK]; "Category " + @Text(n); Categories[n]);
n := n + 1

)

リストを含む [Categories] フィールドは、このコードを含むフィールドよりも上か左に置かれている必要があります。そうでないと、「配列インデックスの越境」エラーを返します。

リスト内の最初の要素は、添字 [1] です。[1] より小さい添字、またはリスト内の要素の数より大きい添字の場合にも「配列インデックスの越境」エラーを返します。

添字演算子は、データエンティティがスカラー値であっても、リストを許可するすべてのデータ型 (テキスト、数字、日付/時刻) で有効です。リストを許可しないデータ型 (リッチテキスト) で添字演算子が有効なのは、添字 [1] が使われている場合のみです。この場合は、カレント値を変更せずに返します。

添字演算子は、代入ステートメントの左側では使えません。つまり、添字付きの要素には値を割り当てられません。完全なリストを作成してから、値を割り当てる必要があります。たとえば、Categories が 3 つの要素から成るリストであり、要素 2 に新しい値を割り当てるには、次のように記述します。

FIELD Categories := Categories[1] :"CatNew" :Categories[3]

関連項目

@Elements
@While

用語集