X++ コンテナー ランタイム関数

この記事では、コンテナー ランタイム関数について説明します。

これらの関数はコンテナーの内容を操作します。

conDel

コンテナーから指定した要素の数を削除します。

構文

container conDel(container container, int start, int number)

パラメーター

パラメーター	説明
コンテナー	要素を削除するコンテナー。
開始	要素の削除を開始する 1 から始まる位置。
数値	削除する要素の数。

戻り値

削除された要素を含まない新しいコンテナーです。

例

static void conDelExample(Args _args)
{
    container c = ["Hello world", 1, 3.14];
        // Deletes the first two items from the container.
        c = conDel(c, 1, 2);
}

conFind

コンテナー内の最初の要素または一連の要素を検索します。

構文

int conFind (container container, anytype element,... )

パラメーター

パラメーター	説明
コンテナー	検索するコンテナー。
要素	1 つ以上の要素を検索し、コンマで区切ります。

備考

順序で複数の要素を指定する場合は、これらは、コンマで区切られ、正しい順序で指定されている必要があります。 要素は、任意のデータ型にすることができます。

戻り値

0 項目が見つからなかった場合。そうでなければ、項目の順序番号。

例

static void conFindExample(Args _args)
{
    container c = ["item1", "item2", "item3"];
    int i;
    int j;
    i = conFind(c, "item2");
    j = conFind(c, "item4");
    print "Position of 'item2' in container is " + int2Str(i);
    print "Position of 'item4' in container is " + int2Str(j);
}

conIns

コンテナーに 1 つまたは複数の要素を挿入します。

構文

container conIns (container container, int start, anytype element, ... )

パラメーター

パラメーター	説明
コンテナー	要素を挿入するコンテナー。
開始	要素を挿入する位置。
要素	1 つ以上の要素を挿入し、コンマで区切ります。

戻り値

挿入された要素を含む新しいコンテナーです。

備考

コンテナーの最初の要素は、番号 1 によって指定されます。. n 番目の要素の後に挿入するには、開始パラメーターは n+1 でなければなりません。 また、+= 演算子を使用して任意のタイプの値をコンテナに追加することができます。 たとえば、最初の 10 ループ反復処理の自乗値を含むコンテナーを作成するには、次のコードを使用します。

int i;
container c;

for (i = 1; i < = 10; i++)
{
    c += i*i;
}

例

static void conInsExample(Args _arg)
{
    container c;
    int i;

    c = conIns(c,1,"item1");
    c = conIns(c,2,"item2");
    for (i = 1 ; i <= conLen(c) ; i++)
    {
        // Prints the content of a container.
        print conPeek(c, i);
    }
}

conLen

コンテナー内の要素の数を取得します。

構文

int conLen(container container)

パラメーター

パラメーター	説明
コンテナー	要素の数を数えるコンテナー 。

戻り値

コンテナー内の要素の数。

例

static void conLenExample(Args _arg)
{
    container c;
    int i;

    c = conins(["item1", "item2"], 1);
    for (i = 1 ; i <= conLen(c) ; i++)
    {
            print conPeek(c, i);
    }
}

conNull

空のコンテナーを取得します。

container conNull()

備考

明示的にコンテナーの内容を破棄するには、この機能を使用します。

戻り値

空のコンテナー。

例

static void conNullExample(Args _arg)
{
    container c = ["item1", "item2", "item3"];

    print "Size of container is " + int2str(conLen(c));
    // Set the container to null.
    c = conNull();
    print "Size of container after conNull() is " + int2Str(conLen(c));
}

conPeek

コンテナーから特定の要素を取得し、換算が必要な場合は別のデータ型に変換します。

構文

anytype conPeek(container container, int number)

パラメーター

パラメーター	説明
コンテナー	要素を返すコンテナー。
数値	返す要素の位置。 最初の要素を取得するには 1 を指定します。 -3、0などの無効な位置番号、またはコンテナーの長さより高い番号は予期しないエラーが発生する可能性があります。

戻り値

number パラメーターで指定された位置にあるコンテナーの要素。 conPeek 関数は、参照した項目を予想される戻り値の型に自動的に変換します。 文字列は、整数と実数に自動的に変換され、整数と実数は文字列に変換することができます。

例

static void main(Args _args)
{
    container cnI, cnJ;
    int i, j;
    anytype aty;
    info("container cnI ...");
    cnI = ["itemBlue", "itemYellow"];
    for (i=1; i <= conLen(cnI); i++)
    {
        aty = conPeek(cnI, i);
        info(int2str(i) + " :  " + aty);
    }

    info("container cnJ ...");
    cnJ = conIns(cnI, 2, "ItemInserted");
    for (j=1; j <= conLen(cnJ); j++)
    {
        aty = conPeek(cnJ, j);
        info(int2str(j) + " :  " + aty);
    }
}
/***  Output pasted from InfoLog ...
Message (10:20:03 am)
container cnI ...
1 :  itemBlue
2 :  itemYellow
container cnJ ...
1 :  itemBlue
2 :  ItemInserted
3 :  itemYellow
***/

conPoke

既存の要素を 1 つ以上を置換することでコンテナーを変更します。

構文

container conPoke(container container, int start, anytype element, ...)

パラメーター

パラメーター	説明
コンテナー	変更するコンテナー。
開始	置き換える最初の要素の位置。
要素	1 つ以上の要素を置換し、コンマで区切ります。

戻り値

新しい要素を含む新しいコンテナーです。

備考

コンテナーの最初の要素は、番号 1 によって指定されます。.

例

static void conPokeExample(Args _arg)
{
    container c1 = ["item1", "item2", "item3"];
    container c2;
    int i;
    void conPrint(container c)
    {
        for (i = 1 ; i <= conLen(c) ; i++)
        {
            print conPeek(c, i);
        }
    }

    conPrint(c1);
    c2 = conPoke(c1, 2, "PokedItem");
    print "";
    conPrint(c2);
}