DataTable行管理系¶

関数名	引数	戻り値
`DT_ROW_ADD`	`string`([, `string`, `any`] ...)	`int`
	`string`, `ref` `string[]`, `ref` `any[]`, `int`	`int`
`DT_ROW_SET`	`string`, `int`, `string`, `any`([, `string`, `any`] ...)	`int`
	`string`, `int`, `ref` `string[]`, `ref` `any[]`, `int`	`int`
`DT_ROW_REMOVE`	`string`, `int`	`int`
	`string`, `ref` `int[]`, `int`	`int`
`DT_ROW_LENGTH`	`string`	`int`

API

a. int DT_ROW_ADD dataTableName, ([, columnName, columnValue] ...)
b. int DT_ROW_ADD dataTableName, columnNames, columnValues, count

a. int DT_ROW_SET dataTableName, idValue, ([, columnName, columnValue] ...)
b. int DT_ROW_ADD dataTableName, idValue, columnNames, columnValues, count

a. int DT_ROW_REMOVE dataTableName, idValue
b. int DT_ROW_REMOVE dataTableName, idValues, count

int DT_ROW_LENGTH dataTableName

DataTable（データベース，DataTableクラスを基づき）の行を操作する関数です。

DT_ROW_ADD：dataTableNameに対応するDataTableに行を追加します。DataTable自体が存在しない場合、-1を返します。
1. 行を追加し、その行の列columnNameの値をcolumnValueで代入し、行の列idの値を返します。複数のcolumnName・columnValue組を渡せます。
2. 行を追加し、順番にcolumnNamesから行名、columnValuesから値を取出し、その行の該当列に値で代入し、最大count回繰り返します。行の列idの値を返します。
DT_ROW_SET：dataTableNameと同名のDataTableの列idがidValueの行の値を編集します。DataTable自体が存在しない場合、-1を返します。
1. その行の列columnNameの値をcolumnValueで代入し、編集した値の数を返します。複数のcolumnName・columnValue組を渡せます。
2. 順番にcolumnNamesから行名、columnValuesから値を取出し、その行の該当列に値で代入し、最大count回繰り返します。編集した値の数を返します。
DT_ROW_REMOVE：dataTableNameと同名のDataTableの行を削除します。DataTable自体が存在しない場合、-1を返します。
1. 列idがidValueの行を削除します。成功した場合、1を返します。
2. 順番に列idがidValuesの要素値に該当列する行を削除し、最大count回繰り返します。成功した場合、削除した行の数を返します。
DT_ROW_LENGTH：dataTableNameに対応するDataTableの行の数を返します。DataTable自体が存在しない場合、-1を返します。

注意

列idの値を編集することができません。

ヒント

命令、式中関数両方対応しています。

例

MAIN.ERB

@SYSTEM_TITLE 
    #DIM id
    #DIMS columnNames = "age", "height"
    #DIM columnValues = 11, 132

    DT_CREATE "db"
    DT_COLUMN_ADD "db", "name"
    DT_COLUMN_ADD "db", "height", "int16"
    DT_COLUMN_ADD "db", "age", "int16"

    id = DT_ROW_ADD("db", "name", "Name1")
    DT_ROW_SET "db", id, columnNames, columnValues, 2
    DT_ROW_ADD "db", "name", "Name2", "age", 21, "height", 164
    DT_ROW_ADD "db", "name", "Name3", "age", 18, "height", 159
    DT_ROW_ADD "db", "name", "Name4", "age", 33, "height", 180
    DT_ROW_ADD "db", "name", "Name5", "age", 18, "height", 172

    PRINTFORML 行数：{DT_ROW_LENGTH("db")}

    CALL PRINTL_ROW(0)
    DT_ROW_SET "db", id, "age", 0, "height", 50
    CALL PRINTL_ROW(0)

    ONEINPUT

@PRINTL_ROW(index)
    #DIM index
    PRINTFORM 第{index+1}行 - 名前：%DT_CELL_GETS("db", index, "name")% 
    PRINTFORM 年齢：{DT_CELL_GET("db", index, "age")} 
    PRINTFORML 身長：{DT_CELL_GET("db", index, "height")}

結果

行数：5
第1行 - 名前：Name1 年齢：11 身長：132
第1行 - 名前：Name1 年齢：0 身長：50