X++ リフレクションランタイム関数

[アーティクル]
03/08/2023

この記事では、リフレクションランタイム関数について説明します。

classIdGet

初期化されるオブジェクトが属しているクラスの数値識別子 (クラス ID) を取得します。

int classIdGet(class object)

パラメーター

パラメーター	説明
オブジェクト	クラス ID を取得するオブジェクト。

戻り値

指定されたオブジェクトのクラス ID。

例

static void classIdGetExample(Args _args)
{
    int i;
    WorkTimeCheck w;

    i = classIdGet(w);
    print "Class ID for object is " + int2Str(i);
}

dimOf

X++ 配列内で領域が割り当てられているインデックス要素の番号を取得します。

int dimOf(anytype object)

パラメーター

パラメーター	説明
オブジェクト	分析コードサイズを決定するための配列。

戻り値

オブジェクト パラメーターの値が配列である場合、値は配列の要素の数になります。それ以外の場合は 0 (ゼロ) になります。

備考

dimOf 関数は、次の X++ プリミティブ型として宣言されている X++ 配列に使用されます。

ブール型
日付
int
int64
real
utcDateTime

たとえば int iAmounts[6]; です。列挙値および拡張データ型の配列も、前述のプリミティブデータ型のいずれかに最終的に基づいている場合はサポートされています (int など) 。 dimOf 機能は、すべての X++ プリミティブ型の配列を受け入れるわけではありません。 dimOf 関数が受け入れない配列タイプを次に示します。

str
コンテナー
anytype
クラスオブジェクトの配列
配列クラスのインスタンス

例

static void JobDimOfArrays(Args _args)
{
    int iAmounts[20], iCounts[];
    ABCModel enumAbcModel[22]; // Enum
    ABCModelType exdtAbcModelType[24]; // Extended data type
    anytype anyThings[26];
    str sNames[28];
    Array myArrayObj; // Class

    info("Start of job.");
    info("--(Next, normal int array, dimOf() accepts it.)");
    info(int2Str(dimOf(iAmounts)));
    info("--(Next, normal enum array, dimOf() accepts it.)");
    info(int2Str(dimOf(enumAbcModel)));
    info("--(Next, normal extended data type array (based on enum), dimOf() accepts it.)");
    info(int2Str(dimOf(exdtAbcModelType)));
    info("--(Next, dynamic int array, dimension not yet set.)");
    info(int2Str(dimOf(iCounts)));
    info("--(Next, dynamic int array, after dimension established.)");

    iCounts[13] = 13;
    info(int2Str(dimOf(iCounts)));
    info(" == == == == == (Next, array types that dimOf() does not support.)");
    info("--(Next, normal anytype array, dimOf() always returns 0.)");
    info(int2Str(dimOf(anyThings)));
    info("--(Next, an instance of class X++ Array, dimOf() always returns 0.)");

    myArrayObj = new Array(Types::Integer);
    myArrayObj.value(1,501);
    info(int2Str(dimOf(myArrayObj)));
    info("--(Next, the lastIndex method provides size information about Array instances.)");
    info(int2Str(myArrayObj.lastIndex()));
    info("--(Next, normal str array, dimOf() does not accept it, job is halted.)");
    info(int2Str(dimOf(sNames)));
    info("End of job.");

}
/************  Actual Infolog output
Message (11:10:06 am)
Start of job.
--(Next, normal int array, dimOf() accepts it.)
20
--(Next, normal enum array, dimOf() accepts it.)
22
--(Next, normal extended data type array (based on enum), dimOf() accepts it.)
24
--(Next, dynamic int array, dimension not yet set.)
0
--(Next, dynamic int array, after dimension established.)
16
== == == == == (Next, array types that dimOf() does not support.)
--(Next, normal anytype array, dimOf() always returns 0.)
0
--(Next, an instance of class X++ Array, dimOf() always returns 0.)
0
--(Next, the lastIndex method provides size information about Array instances.)
1
--(Next, normal str array, dimOf() does not accept it, job is halted.)
Error executing code: Illegal operation on this type of array. (C)JobsJobDimOfArrays - line 41
************/
/***********  Pop-up error dialog box
"Internal error number 25 in script."
This error is caused by the code line...
info(int2Str(dimOf(iCounts)));
...before iCounts was assigned at any index.
***********/

fieldId2Name

テーブルの ID 番号とフィールドの ID 番号で指定されているフィールドの名前を表す文字列を取得します。

str fieldId2Name(int tableid, int fieldid)

パラメーター

パラメーター	説明
tableid	テーブルの ID 番号。注記: テーブルの ID を指定するには、tableName2Id 関数を使用します。
fieldid	フィールドの ID 番号。

戻り値

フィールドの名前。

備考

フィールド名の印刷可能なバージョンを返すには、fieldId2PName 関数を使用します。

例

次の例では、フィールド ID が 7 の Customer (CustGroup) テーブルのフィールド名に fn を設定しています。

static void fieldId2NameExample(Args _arg)
{
    str fn;
    fn = fieldId2Name(tableName2Id("Customer"),7);
}

fieldId2PName

テーブルの ID 番号とフィールドの ID 番号で指定されているフィールドの出力可能な名前を取得します。

str fieldId2PName(int tableid, int fieldid)

パラメーター

パラメーター	説明
tableid	テーブルの ID 番号。注記: テーブルの ID を指定するには、tableName2Id 関数を使用します。
fieldid	フィールドの ID 番号。注記: フィールドの ID を指定するには、fieldName2Id 関数を使用します。

戻り値

フィールドの名前。

例

static void fieldId2PNameExample(Args _arg)
{
    str name;
    tableid _tableId;
    fieldid _fieldid;

    _tableId = tableName2Id("Address");
    _fieldId = fieldName2Id(_tableId, "Name");
    name = fieldId2PName(_tableId, _fieldid);
    print name;
}

fieldName2Id

テーブルの ID 番号とフィールドの ID 番号で指定されているテーブルフィールドのフィールド ID を取得します。

int fieldName2Id(int tableid, str fieldname)

パラメーター

パラメーター	説明
tableid	テーブルの ID 番号。注記: テーブルの ID を指定するには、tableName2Id 関数を使用します。
fieldname	フィールドの名前。

戻り値

tableid および fieldname パラメーターにより指定されているフィールドの ID。

例

static void fieldName2IdExample(Args _arg)
{
    int id;

    id = fieldName2Id(tableName2Id("Address"), "Name");
    // Returns 6. Name is the 6th field in the Address table.
    print id;
}

indexId2Name

インデックスの名前を取得します。

str indexId2Name(int tableid, int indexid)

パラメーター

パラメーター	説明
tableid	インデックスが属するテーブルの ID。
indexid	インデックスの ID です。

戻り値

インデックスの名前。

例

static void indexId2NameExample(Args _arg)
{
    str s;
    tableid id;
    indexid idx;

    id  = tableName2Id("Address");
    idx = indexName2Id(id, "AddrIdx");
    s = indexId2Name(id, idx);
    print "The result of calling indexId2Name is " + s;
}

indexName2Id

インデックスの ID を取得します。

int indexName2Id(int tableid, str indexname)

パラメーター

パラメーター	説明
tableid	インデックスが属するテーブルの ID。
indexname	インデックスの名前。

戻り値

インデックスの ID です。

例

static void indexName2IdExample(Args _arg)
{
    indexid idx;
    tableid id;

    id  = tableName2Id("Address");
    idx = indexName2Id(id, "AddrIdx");
    print "Index ID for index name AddrIdx of table Address is " + int2Str(idx);
}

tableId2Name

テーブルの名前を含む文字列を取得します。

str tableId2Name(int _tableid)

パラメーター

パラメーター	Description
_tableid	テーブルの ID。

戻り値

テーブルの名前。

例

static void tableId2NameExample(Args _arg)
{
    str s;
    tableid id;

    // Get the ID for table name Address.
    id = tableName2Id("Address");
    print "ID for table name Address is " + int2Str(id);

    // Get the name from the table ID.
    s = tableId2Name(id);
    print "Name for table ID " + int2Str(id) + " is " + s;

    // Get the printable name from the table ID.
    s = tableId2PName(id);
    print "Printable name for table ID " + int2Str(id) + " is " + s;
}

tableId2PName

テーブルの出力可能な名前 (ラベル) を含む文字列を取得します。

str tableId2PName(int _fieldid)

パラメーター

パラメーター	Description
_fieldid	テーブルの ID。

戻り値

テーブルのラベル。

例

static void tableId2NameExample(Args _arg)
{
    str s;
    tableid id;

    // Get the ID for table name Address.
    id = tableName2Id("Address");
    print "ID for table name Address is " + int2Str(id);

    // Get the name from the table ID.
    s = tableId2Name(id);
    print "Name for table ID " + int2Str(id) + " is " + s;

    // Get the printable name from the table ID.
    s = tableId2PName(id);
    print "Printable name for table ID " + int2Str(id) + " is " + s;
}

tableName2Id

テーブルの ID を取得します。

int tableName2Id(str _name)

パラメーター

パラメーター	Description
_name	テーブルの名前。

戻り値

テーブルの ID。

例

static void tableName2IdExample(Args _arg)
{
    str s;
    tableid id;

    // Get the ID for the Address table name.
    id = tableName2Id("Address");
    print "ID for the Address table name is " + int2Str(id);

    // Get the name from the table ID.
    s = tableId2Name(id);
    print "Name for table ID " + int2Str(id) + " is " + s;

    // Get the printable name from the table ID.
    s = tableId2PName(id);
    print "Printable name for table ID " + int2Str(id) + " is " + s;
}

typeOf

要素のタイプを取得します。

enum typeOf(anytype _object)

パラメーター

パラメーター	Description
_object	タイプを返す対象の要素。

戻り値

タイプシステム列挙値。

例

次の例では、コンテナ内の最初の要素、c が単一の整数を含む別のコンテナーであるかどうかをテストします。

if(typeof(conpeek(c, 1)) != Types::Container ||
conlen(conpeek(c, 1)) != 1 ||
typeof(conpeek(conpeek(c, 1), 1)) != Types::Integer)
{
    // More code.
}

次の方法で共有

X++ リフレクション ランタイム関数

classIdGet

パラメーター

戻り値

例

dimOf

パラメーター

戻り値

備考

例

fieldId2Name

パラメーター

戻り値

備考

例

fieldId2PName

パラメーター

戻り値

例

fieldName2Id

パラメーター

戻り値

例

indexId2Name

パラメーター

戻り値

例

indexName2Id

パラメーター

戻り値

例

tableId2Name

パラメーター

戻り値

例

tableId2PName

パラメーター

戻り値

例

tableName2Id

パラメーター

戻り値

例

typeOf

パラメーター

戻り値

例

フィードバック

その他のリソース

X++ リフレクションランタイム関数