for...in ステートメント

[アーティクル]
08/09/2011

オブジェクトの各プロパティ、または配列やコレクションの各要素に対して、1 つ以上のステートメントを実行します。

for ( [var] variable in {object | array | collection})
   statement

引数

variable
必ず指定します。 object のプロパティ名、array のインデックス、または collection の要素を格納するために使用する変数を指定します。
object
反復処理の対象となる JScript オブジェクトを指定します。
array
反復処理の対象となる配列を指定します。 JScript Array オブジェクトまたは .NET Framework 配列を指定できます。
collection
反復処理の対象となるコレクションを指定します。 .NET Framework の IEnumerable インターフェイスまたは IEnumerator インターフェイスを実装する任意のクラスを指定できます。
statement
省略可能です。 object または collection のプロパティ、または array の各メンバーに対して実行するステートメントを指定します。複合ステートメントを指定することもできます。

解説

ループの各反復処理の実行前に、object の次のプロパティ名、array の次のインデックス、または collection の次の要素が variable に代入されます。ループ内のステートメントで variable を使用して、object のプロパティまたは array の要素を参照できます。

オブジェクトに対して反復処理を行う場合は、variable に代入されるオブジェクトのメンバー名の順番を決定したり制御したりすることはできません。 for...in ステートメントは、.NET Framework オブジェクトなどの JScript 以外のオブジェクトのメンバーに対してはループを実行できません。

配列の反復処理は、要素の順序で実行されます。最小のインデックスから開始し、最大のインデックスで終了します。 JScript の Array オブジェクトは疎配列であるため、for...in ステートメントは、配列の定義済み要素だけにアクセスします。 JScript の Array オブジェクトには expando プロパティが含まれることがあります。その場合は、配列インデックスがプロパティ名として variable に代入されます。配列が .NET Framework の多次元配列の場合は、最初の次元だけが列挙されます。

コレクションに対する反復操作の場合は、コレクション内の順序どおりに要素が variable に代入されます。

例 1

次のコードは、for ... in ステートメントで、連想処理可能な配列として使用する例です。

function ForInDemo1()
{
    // Initialize the object.
    var obj = {"a" : "Athens" , "b" : "Belgrade", "c" : "Cairo"}

    // Iterate over the properties and create the string result.
    var s = ""
    for (var key in obj)
    {
        s += key + ":  " + obj[key];
        s += "\n";
    }
    return (s);
}

この関数は、以下を含む文字列を返します。

a:  Athens
b:  Belgrade
c:  Cairo

例 2

expando プロパティを含む JScript の Array オブジェクトと共に for ... in ステートメントを使用する例を次に示します。

function ForInDemo2()
{
    // Initialize the array.
    var arr = new Array("zero","one","two");

    // Add a few expando properties to the array.
    arr["orange"] = "fruit";
    arr["carrot"] = "vegetable";

    // Iterate over the properties and elements
    // and create the string result.
    var s = "";
    for (var key in arr)
    {
        s += key + ":  " + arr[key];
        s += "\n";
    }
    
    return (s);
}

この関数は、以下を含む文字列を返します。

0:  zero
1:  one
2:  two
orange:  fruit
carrot:  vegetable

例 3

コレクションと共に for ... in ステートメントを使用する例を次に示します。この例の System.String オブジェクトの GetEnumerator メソッドは、文字列内の文字のコレクションを提供します。

function ForInDemo3()
{
    // Initialize the collection.
    var str : System.String = "Test.";
    var chars : System.CharEnumerator = str.GetEnumerator();

    // Iterate over the collection elements and
    // create the string result.
    var s = "";

    var i : int = 0;
    for (var elem in chars)
    {
        s += i + ": " + elem
        s += "\n";

        i++;
    }

    return(s);
}

この関数は、以下を含む文字列を返します。