ReadRow

 Input Assistant 

目的
GuiXTテーブル変数の行を構造化変数に読み込むことができます。
ReadRow V[customerinfo] table=V[customers] index=2

テーブル変数V[customers]の2行目が読み込まれます。 名前が一致するすべてのカラムは、構造化変数V[customerinfo]の対応するコンポーネントにコピーされます。

書式
ReadRow V[strname] table=V[tabname] index=k
ReadRow V[strname] table=V[tabname] key=keystring
ReadRow V[strname] table=V[tabname] match=V[strmatch]
index=の説明
Ÿ   指定されたインデックスが1未満またはV[tabname.rowcount]より大きい場合、構造化変数は変更されません。

if Q[ok]を使用するとインデックスが1とV[tabname.rowcount]の間にあるかどうかを照会できます

Ÿ   構造化変数とテーブルの構造は異なる場合があります。 テーブル内で対応するものがないコンポーネントは変更されません。

key=の説明
Ÿ   最初の列が指定されたキー値と等しい最初のテーブル行を検索します。 そのような行が見つからない場合、構造化変数は変更されません。

if Q[ok]を使用すると適切な行が見つかったかどうかを照会できます。

Ÿ   構造化変数とテーブルの構造は異なる場合があります。 表の対応する対応物がないコンポーネントは変更されていません。

Ÿ   その他のオプションは下記で説明されています。

例:

ReadRow V[customerinfo] table=V[customers] key=“&V[customernumber]”

match=の説明
Ÿ   2番目の構造化変数を指定します。 このコマンドは、この構造化変数で一致する名前を持つすべてのカラムが同じ値を持つ最初のテーブル行を検索します。 そのような行が見つからない場合、構造化変数は変更されません。

if Q[ok]を使用すると適切な行が見つかったかどうかを照会できます。

Ÿ   構造化変数(match=で指定された変数とターゲット変数の両方)とテーブルの構造は異なる場合があります。 テーブル内で対応するものがないコンポーネントは変更されません。

Ÿ   その他のオプションは以下で説明されています。

例:

ReadRow V[customerinfo] table=V[customers] match=V[customersearch]

オプション
-ignoreCase  key=およびmatch=のすべての比較は、大文字と小文字を区別せずに実行されます。
-regex match=との比較は、検索構造で指定された値を正規表現として解釈します。 システムは、同じ名前のすべてのコンポーネントのそれぞれの正規表現に一致するテーブル行を検索します。 例は、Table row selection based on a regular expressionにあります。
fromIndex= 指定された行インデックスから検索を開始します。
toIndex= 指定された行インデックスで検索が終了します。
returnIndex= 変数名”varname”を指定します。 一致する行の行インデックスが

V[varname]に設定されます。

行が見つからない場合、変数は値-1を取得します。

備考:fromIndex=と組み合わせて、このオプションを使用すると、テーブル内の一致するすべての行を連続して決定できます。

前の記事

RemoveFile

次の記事

ReadFile