スクリプト-関数（データ）

[version 4.0.0.331以降]

任意のデータの値を取得する関数です。
DATAオブジェクトを使わずに任意のデータの値を取得することができます。
旧バージョンでの利用を考慮しない場合、こちらの関数を使ったほうが効率的です。

DATA_GetCountX 関数

指定データのフィールド数を取得します。

<構文>

DATA_GetCountX( <データ名>) As NUMBER

<引数>

引数	説明
<データ名>	対象のデータの名称を指定します。

<戻り値>
フィールド数を戻します。（NUMBER型）

<使用例>

return DATA_GetCountX("Data1");

DATA_GetCountY 関数

指定データのレコード数を取得します。

<構文>

DATA_GetCountY( <データ名>) As NUMBER

<引数>

引数	説明
<データ名>	対象のデータの名称を指定します。

<戻り値>
レコード数を戻します。（NUMBER型）

<使用例>

return DATA_GetCountY("Data1");

DATA_GetN 関数

指定データのデータ値を数値（NUMBER型）として取得します。

<構文>

DATA_GetN( <データ名>, <フィールド名>, <レコード番号>) As NUMBER

<引数>

引数	説明
<データ名>	対象のデータの名称を指定します。
<フィールド名>	値を取得するフィールドの名称を指定します。
<レコード番号>	値を取得するレコードの番号を指定します。1～

<戻り値>
データ値を戻します。（NUMBER型）

<使用例>

return DATA_GetN("Data1", "Field2", 0);

DATA_GetNA 関数

指定データからデータ値を数値配列（NUMBER_ARRAY型）で取得します。
指定フィールドから指定のフィールド数分の数値データを一括取得することができます。

<構文>

DATA_GetNA( <データ名>, <フィールド名>, <レコード番号>, <フィールド数> ) As NUMBER_ARRAY

<引数>

引数	説明
<データ名>	対象のデータの名称を指定します。
<フィールド名>	値の取得を開始するフィールドの名称を指定します。
<レコード番号>	値を取得するレコードの番号を指定します。1～
<フィールド数>	取得するフィールドの数を指定します。1～

<戻り値>
データ値を戻します。（NUMBER_ARRAY型）

<使用例>「英語」フィールドから５教科の点数を一括取得します。

NUMBER_ARRAY na;
na = DATA_GetNA("Data1", "英語", 0, 5);

DATA_GetM 関数

指定データのデータ値を画像（IMAGE型）として取得します。

<構文>

DATA_GetM( <データ名>, <フィールド名>, <レコード番号>) As IMAGE

<引数>

引数	説明
<データ名>	対象のデータの名称を指定します。
<フィールド名>	値を取得するフィールドの名称を指定します。
<レコード番号>	値を取得するレコードの番号を指定します。1～

<戻り値>
データ値を戻します。（IMAGE型）

<使用例>

return DATA_GetM("Data1", "Field3", 5);

DATA_GetS 関数

指定データのデータ値を文字列（STRING型）として取得します。

<構文>

DATA_GetS( <データ名>, <フィールド名>, <レコード番号>) As STRING

<引数>

引数	説明
<データ名>	対象のデータの名称を指定します。
<フィールド名>	値を取得するフィールドの名称を指定します。
<レコード番号>	値を取得するレコードの番号を指定します。1～

<戻り値>
データ値を戻します。（STRING型）

<使用例>

return DATA_GetS("Data1", "Field1", 2);

DATA_GetSA 関数

指定データからデータ値を文字列の配列（STRING_ARRAY型）で取得します。
指定フィールドから指定のフィールド数分の数値データを一括取得することができます。

<構文>

DATA_GetSA( <データ名>, <フィールド名>, <レコード番号>, <フィールド数> ) As STRING_ARRAY

<引数>

引数	説明
<データ名>	対象のデータの名称を指定します。
<フィールド名>	値の取得を開始するフィールドの名称を指定します。
<レコード番号>	値を取得するレコードの番号を指定します。1～
<フィールド数>	取得するフィールドの数を指定します。1～

<戻り値>
データ値を戻します。（STRING_ARRAY型）

<使用例>「英語」フィールドから５教科の点数を一括取得します。

STRING_ARRAY sa;
sa = DATA_GetSA("Data2", "Field1", 0, 7);