配列関数

関数一覧

ARRAY2LIST ARRAY_CLEAR INDEX LIST2ARRAY LOAD_TF
LOOKUP SAVE_TF

配列関数

配列の主な用途として想定しているのは、マスターテーブル処理である。
外部にタブファイルの形式でマスターテーブルを用意し、 LOAD_TF関数を用いて先頭ブロックで読みこむ。 LOOKUP関数でデータの引用や、また、必要ならば更新を行う。 データを更新したならば、末尾ブロックでSAVE_TF関数で内容を出力すれば良い。

ARRAY_CLEAR

bool ARRAY_CLEAR( 配列名 または 変数名 )
配列または変数をクリアする。戻り値は常に真。
文字列には空の文字列を、数値には0を代入する。

INDEX

INDEX( 配列名 , num 添字 [ , エラー値 ] )
配列要素を添字で引用。
戻る値は、配列と同じ型。通常の[]を使った配列要素の引用と異なり、 添字の範囲が不正でもエラーとならない。添字が配列の範囲にない場合は、エラー値を返す。 エラー値を省略すると、数値ならばオーバーフロー値。 文字列ならば、長さ0の文字列を返す。
エラー値は配列と同じ型にすること。

LOOKUP

num LOOKUP( 検索値 , [ NOT ] 比較演算子 , 検索対象配列 [ , num 開始インデックス , num 終了インデックス ] )
配列から値を検索する。
指定した演算子を用いて、配列の前のほうから順に検索し、演算の結果が真になった添字を返す。 一つも成立しなかった場合や、検索範囲の指定が不正な場合は、オーバーフロー値を返す。
開始インデックス、終了インデックスで検索範囲を指定できる。 インデックスは添字なので、0から始まる。また、終了インデックスは検索する最後の添字。 もし、0-9を検索するならば、終了インデックスは9を指定する。
範囲を省略した場合は、配列の全体が検索対象となる。
検索値と検索対象配列の型は一致しなければならない。 比較演算子の前にNOTがあると条件が反転する。

LOAD_TF

num LOAD_TF( str ファイル名 , num 件数 [ , 配列名 ] )
配列にタブファイルを読みこむ。戻り値は読込件数。
配列の先頭の要素から順にファイルの各行を読みこむ。 配列名を複数並べると、それぞれが先頭からフィールドに対応する。 読込件数の上限は配列の要素数のうちの、最小の値で制限される。

SAVE_TF

num SAVE_TF( str ファイル名 , num 件数 [ , 配列名 ] )
配列にタブファイルを書きこむ。戻り値は書きこみ件数。
配列の先頭の要素から順にファイルの各行に書きこむ。 配列名を複数並べると、それぞれが先頭からフィールドに対応する。 読込件数の上限は配列の要素数のうちの、最小の値で制限される。

LIST2ARRAY

num LIST2ARRAY( 文字列配列名 , str リストの区切り , str リスト )
リストのメンバーを文字列配列に書きこむ。戻り値は書きこみ件数。
配列の先頭の要素から順に書かれる。 配列の要素数がリストのメンバー数よりも小さい場合は、配列の要素分だけ書きこむ。

ARRAY2LIST

str ARRAY2LIST( 文字列配列名 , num 個数 , str リストの区切り )
文字列配列の要素からなるリストを返す。
配列要素の先頭から順に連結してリストを作る。 指定した個数が配列要素数を越えた場合は配列要素数分だけのメンバーからなるリストになる。