CreateTable

 Input Assistant 

目的
GuiXTテーブル変数を作成できます。
CreateTable V[customers] account name city country

変数V[customers]はテーブル変数として作成されます。 各行1、2、3 …に対して、以下のコンポーネントを個別の変数として使用できます。

V[customers.account.1] V[customers.name.1] V[customers.city] V[customers.country.1]

V[customers.account.2]
V[customers.name.2]
….

書式
CreateTable V[tabname] field1 field2 field3 …

 

説明
Ÿ   通常の変数とは対照的に、V[customers.xxx.1]のような無効なコンポーネント名は、構文エラーメッセージを引き起こします。

Ÿ   存在しない行番号には、次の規則が適用されます:

行番号が存在しないテーブルセルを読み取ると、 “”が返されます。行番号が存在しないテーブルセルに書き込むと、まず空のセルを含む行が作成され、次に指定したセルに値が書き込まれます。また、空のセル値を持つすべての中間行を作成します。たとえば、行100に書き込み、行1のみが存在する場合、行2から99までです。

Ÿ   行の総数はV[tabname.rowcount]、カラム数はV[tabname.colcount]です。

Ÿ   行カウントV[tabname.rowcount]Setで直接変更できます。たとえば、テーブルに多くの行を入力する場合は、最初に合計行数を設定してから、すべてのセル値を設定する方が簡単です。

Ÿ   カラム名はV[tabname.colname.k]という表記で読み取りが可能です(”&V[customers.colname.3]” は “city”等)。

Ÿ   Clear V[tabname]を使用すると、すべての行が削除され、V[tabname.rowcount]が0に設定されます。

Ÿ   V[customers.account.1]ではなく、V[customers.cell.account.1]という表記を使用できます。これは、Tableコマンドを使用したテーブル表示との互換性を保証するためにサポートされています。

Ÿ   Tableテーブル表示で使用され、すべてのステータス変数V[tabname.stat. …1]はその値を保持します。必要に応じて、Clear V[tabname.stat*]を使用して明示的にクリアできます。

Ÿ   テーブル変数の文字列表現 “&V[tabname]は、JavaScriptオブジェクト表記と互換性のある”JSON” 形式を生成します。

例:

Set V[customers.account.1] “1000”
Set
V[customers.name.1] “M&S Inc.”
Set V[customers.account.4] “2000”
Set
V[customers.name.4] “ABC Inc.”

Ÿ   &V[customers]の場合、次の文字列が生成されます:

[{“account”: “1000”, “name”: “M&S Inc.”, “city”: “”, “country”: “”}, {“account”: “”, “name”: “”, “city”: “”, “country”: “”}, {“account”: “”, “name”: “”, “city”: “”, “country”: “”}, {“account”: “2000”, “name”: “ABC Inc.”, “city”: “”, “country”: “”}]

Ÿ   テーブル変数値を設定するために同じJSONタイプ表記を使用できます。

Ÿ   通常のGuiXT変数は4000バイトに制限されているため、大きなテーブルが予想される場合は、GuiXTのロングテキスト変数を使用してください。 コマンドは以下の通りです。
CopTextfromTable= … -JSON
CopText
toTable=… -JSON

オプション
include= 別の構造化変数またはテーブル変数を参照します。 この変数のコンポーネントが含まれています。
例:
CreateStructure V[customer] account name city country
CreateTable V[tab1] include=V[customer]
CreateTable V[tab2] include=V[customer]

include=オプションは複数回使用できます。
テーブル変数のその他のコマンド
DeleteTable テーブル変数(コンテンツと構造)を削除します。
Clear すべての行を削除し、構造を維持します。
ReadRow テーブルの行を構造化変数に読み込みます
UpdateRow 構造化変数からテーブル行を更新します。
AppendRow 構造化変数の内容をテーブル変数の新しい行として追加します 。
Sort テーブル変数の行を並べ替えます。
CopyText オプションtoTable=およびfromTable=を使用して、テーブル変数を長いテキスト変数に、またはその逆にコピーします。
Call オープンコールインターフェイスを使用する場合、テーブル変数をexport=およびimport=パラメータとして指定できます。 テーブルカラムは、汎用モジュールテーブルパラメータとの間で名前によってコピーされます。
「テーブル変数」および「オープンコールインターフェース」の多数のサンプル集が用意されています。

次の記事

CreateStructure