インデックス配列

複数のテクニックを使用して、Array インスタンスまたは Vector インスタンスを作成できます。ただし、配列の各型を作成するテクニックは、やや異なります。

インデックス配列に要素を追加する最も基本的な方法は、配列アクセス（ [] ）演算子を使用することです。インデックス配列要素の値を設定するには、代入ステートメントの左側に Array オブジェクトまたは Vector オブジェクトの名前とインデックス番号を使用します。

songTitles[5] = "Happy Birthday";

Array または Vector にまだそのインデックスの要素がない場合は、インデックスが作成され、そこに値が格納されます。そのインデックスに値が既にある場合は、既存の値は新しい値に置き換えられます。

Array オブジェクトでは、任意のインデックスに要素を作成できます。ただし、Vector オブジェクトでは、既存のインデックスまたは次に使用可能なインデックスにのみ値を割り当てることができます。次に使用可能なインデックスは、Vector オブジェクトの length プロパティに相当します。Vector オブジェクトに新しい要素を追加する最も安全な方法は、次のようなコードを使用する方法です。

myVector[myVector.length] = valueToAdd;

インデックス配列に要素を挿入する場合は、Array および Vector クラスにある push() 、 unshift() 、および splice() の 3 つのメソッドを使用できます。 push() メソッドでは、配列の末尾に 1 つまたは複数の要素を追加します。したがって、 push() メソッドで挿入した最後の要素には最も大きいインデックス番号が付きます。 unshift() メソッドでは、配列の先頭に 1 つまたは複数の要素を挿入します。したがって、挿入した要素には必ずインデックス番号 0 が付きます。 splice() メソッドでは、配列内の指定されたインデックスに任意の数の要素を挿入します。

これら 3 つのメソッドについて使用例を次に示します。 太陽に近い順に惑星の名前を格納するために、 planets という名前の配列を作成します。まず、 push() メソッドを呼び出して、最初の要素 Mars を追加します。次に、 unshift() メソッドを呼び出して、配列の先頭に位置する要素 Mercury を挿入します。最後に、 splice() メソッドを呼び出して、 Mercury の後、 Mars の前に Venus および Earth を挿入します。 splice() の第 1 パラメーターとして渡している整数 1 は、挿入先をインデックス 1 の場所にするという指定です。また、 splice() 第 2 パラメーターの整数 0 は、既存の要素を 1 つも削除しないという指定です。さらに、 splice() の第 3 および第 4 パラメーターで指定している Venus と Earth は挿入する要素のリストです。

var planets:Array = new Array(); 
planets.push("Mars"); // array contents: Mars 
planets.unshift("Mercury"); // array contents: Mercury,Mars 
planets.splice(1, 0, "Venus", "Earth"); 
trace(planets); // array contents: Mercury,Venus,Earth,Mars

push() および unshift() メソッドはいずれも、変更後の配列の長さを示す符号なし整数値を返します。 splice() は要素の挿入に使用した場合、空の配列を返します。これは奇異な動作のようにも見えますが、 splice() メソッドの幅広い用途を考えると理にかなっています。 splice() メソッドは配列に要素を挿入する場合だけでなく、配列から要素を削除する場合にも使用でき、削除の場合は、元の配列から削除した要素を格納した配列を返します。

インデックス配列から要素の値を取得する最も単純な方法は、配列アクセス（ [] ）演算子を使用する方法です。インデックス配列要素の値を取得するには、代入ステートメントの右側に Array オブジェクトまたは Vector オブジェクトの名前とインデックス番号を使用します。

var myFavoriteSong:String = songTitles[3];

要素を含まないインデックスを使用して、配列またはベクターから値の取得を試みることは可能です。その場合、Array オブジェクトでは未定義の値が返され、Vector オブジェクトでは RangeError 例外がスローされます。

要素を削除する場合は、Array および Vector クラスにある pop() 、 shift() 、および splice() の 3 つのメソッドを使用できます。 pop() メソッドでは、配列の末尾にある 1 個の要素、つまり最も大きいインデックス番号の付いた要素を削除します。 shift() メソッドでは、配列の先頭にある 1 個の要素、つまりインデックス番号が 0 である要素を削除します。 splice() メソッドは要素の挿入にも使用できますが、第 1 引数で指定したインデックス番号が示す位置から任意の数の要素を削除する場合にも使用できます。

これら 3 つのメソッドを使用して配列インスタンスの要素を削除する例を次に示します。この例では、広い海の名前を格納するために oceans という名前の配列を作成していますが、海ではなく湖の名前がいくつか含まれているので、それらを削除します。

まず、 splice() メソッドを使用して Aral および Superior の要素を削除し、 Atlantic および Indian の要素を挿入します。 splice() の第 1 パラメーターとして渡している整数 2 は、3 番目の要素（インデックス 2）から始まる範囲を操作対象にするという指定です。また、第 2 パラメーターの整数 2 は、既存の要素を 2 つ削除するという指定です。残りのパラメーターで指定している Atlantic と Indian はインデックス 2 の位置に挿入する要素のリストです。

次に、 pop() メソッドを使用して、配列の末尾に位置する要素 Huron を削除します。最後に shift() メソッドで、配列の先頭に位置する要素 Victoria を削除します。

var oceans:Array = ["Victoria", "Pacific", "Aral", "Superior", "Indian", "Huron"]; 
oceans.splice(2, 2, "Arctic", "Atlantic"); // replaces Aral and Superior 
oceans.pop(); // removes Huron 
oceans.shift(); // removes Victoria 
trace(oceans);// output: Pacific,Arctic,Atlantic,Indian

pop() および shift() メソッドはいずれも、削除した要素を返します。Array インスタンスでは、配列にはあらゆるデータ型の値を格納できるので、戻り値のデータ型は Object になっています。Vector インスタンスでは、戻り値のデータ型はベクターのベース型になっています。 splice() メソッドは、削除した値を格納した配列またはベクターを返します。 oceans 配列の例を次のように改変すると、 splice() の呼び出しで返される戻り値を新しい配列変数に割り当てることができます。

var lakes:Array = oceans.splice(2, 2, "Arctic", "Atlantic"); 
trace(lakes); // output: Aral,Superior

Array オブジェクトの要素に対して delete 演算子を使用しているコードもありますが、 delete 演算子はその要素の値を undefined に設定するだけであり、配列から要素を削除するわけではありません。例えば次のコードでは、 oceans 配列の 3 番目の要素に対して delete 演算子を使用していますが、配列の要素数はその後も変わらず 5 のままです。

var oceans:Array = ["Arctic", "Pacific", "Victoria", "Indian", "Atlantic"]; 
delete oceans[2]; 
trace(oceans);// output: Arctic,Pacific,,Indian,Atlantic 
trace(oceans[2]); // output: undefined 
trace(oceans.length); // output: 5

配列の length プロパティを使用して配列またはベクターを切り詰めることができます。インデックス配列の length プロパティを配列の現在の長さ未満に設定すると、配列は切り詰められ、 length - 1 という新しい値より大きい番号のインデックスに格納されているエレメントはすべて削除されます。例えば、 oceans 配列のすべての有効なエントリが配列の先頭に格納されていた場合、次のコードに示すように、 length プロパティを使用して配列の末尾のエントリを削除することができます。

var oceans:Array = ["Arctic", "Pacific", "Victoria", "Aral", "Superior"]; 
oceans.length = 2; 
trace(oceans); // output: Arctic,Pacific

インデックス配列要素の並び順を変更する場合は、ソートまたは順序の逆転を行う reverse() 、 sort() 、 sortOn() の 3 つのメソッドを使用できます。いずれのメソッドでも既存の配列が変化します。 次の表に、Array オブジェクトおよび Vector オブジェクトのこれらのメソッドとその動作をまとめます。

var oceans:Array = ["Arctic", "Atlantic", "Indian", "Pacific"]; 
oceans.reverse(); 
trace(oceans); // output: Pacific,Indian,Atlantic,Arctic

var poets:Array = ["Blake", "cummings", "Angelou", "Dante"]; 
poets.sort(); // default sort 
trace(poets); // output: Angelou,Blake,Dante,cummings 
 
poets.sort(Array.CASEINSENSITIVE); 
trace(poets); // output: Angelou,Blake,cummings,Dante 
 
poets.sort(Array.DESCENDING); 
trace(poets); // output: cummings,Dante,Blake,Angelou 
 
poets.sort(Array.DESCENDING | Array.CASEINSENSITIVE); // use two options 
trace(poets); // output: Dante,cummings,Blake,Angelou

var names:Array = new Array("John Q. Smith", "Jane Doe", "Mike Jones"); 
function orderLastName(a, b):int 
{ 
    var lastName:RegExp = /\b\S+$/; 
    var name1 = a.match(lastName); 
    var name2 = b.match(lastName); 
    if (name1 < name2) 
    { 
        return -1; 
    } 
    else if (name1 > name2) 
    { 
        return 1; 
    } 
    else 
    { 
        return 0; 
    } 
} 
trace(names); // output: John Q. Smith,Jane Doe,Mike Jones 
names.sort(orderLastName); 
trace(names); // output: Jane Doe,Mike Jones,John Q. Smith

var poets:Array = new Array(); 
poets.push({name:"Angelou", born:"1928"}); 
poets.push({name:"Blake", born:"1757"}); 
poets.push({name:"cummings", born:"1894"}); 
poets.push({name:"Dante", born:"1265"}); 
poets.push({name:"Wang", born:"701"});

poets.sortOn("born", Array.NUMERIC); 
for (var i:int = 0; i < poets.length; ++i) 
{ 
    trace(poets[i].name, poets[i].born); 
} 
/* output: 
Wang 701 
Dante 1265 
Blake 1757 
cummings 1894 
Angelou 1928 
*/

var indices:Array; 
indices = poets.sortOn("born", Array.NUMERIC | Array.RETURNINDEXEDARRAY); 
for (var i:int = 0; i < indices.length; ++i) 
{ 
    var index:int = indices[i]; 
    trace(poets[index].name, poets[index].born); 
} 
/* output: 
Wang 701 
Dante 1265 
Blake 1757 
cummings 1894 
Angelou 1928 
*/

Array クラスおよび Vector クラスには concat() 、 join() 、 slice() 、 toString() の 4 つのメソッドがあります。これらはいずれもクエリによって配列から情報を取得するものであり、配列に変更を加えることはありません。 concat() および slice() メソッドは新しい配列を返し、 join() および toString() メソッドはストリングを返します。 concat() メソッドのパラメーターには配列または要素リストを指定します。既存の配列と、パラメーターで指定した別の配列または要素とを連結し、新しい配列を作成して返します。 slice() メソッドには、 startIndex および endIndex という 2 つのパラメーターがあります。元の配列から、これらのパラメーターで指定したインデックスの範囲を切り出し、その部分のコピーを格納した新しい配列を返します。ただし、返される範囲は startIndex が指す要素から、 endIndex が指す要素の直前までであり、 endIndex の位置にある要素は含まれません。

次の例では、既存の配列から concat() および slice() を使用して新しい配列を作成します。

var array1:Array = ["alpha", "beta"]; 
var array2:Array = array1.concat("gamma", "delta"); 
trace(array2); // output: alpha,beta,gamma,delta 
 
var array3:Array = array1.concat(array2); 
trace(array3); // output: alpha,beta,alpha,beta,gamma,delta 
 
var array4:Array = array3.slice(2,5); 
trace(array4); // output: alpha,beta,gamma

join() および toString() メソッドでは、配列の内容をストリングとして取得できます。 join() メソッドのパラメーターを指定しない場合、これら 2 つのメソッドはいずれも、すべての配列要素をカンマで区切った内容のストリングを返します。 join() メソッドには、 toString() メソッドにない delimiter というパラメーターがあり、戻り値のストリングで要素間に使用する区切り文字を指定できます。

次の例では rivers という配列を作成し、 join() および toString() を呼び出すことで、配列の内容をストリングとして取得します。 toString() メソッドはカンマ区切りの値（ riverCSV ）を得るため、また、 join() メソッドは + で区切った値を得るために使用しています。

var rivers:Array = ["Nile", "Amazon", "Yangtze", "Mississippi"]; 
var riverCSV:String = rivers.toString(); 
trace(riverCSV); // output: Nile,Amazon,Yangtze,Mississippi 
var riverPSV:String = rivers.join("+"); 
trace(riverPSV); // output: Nile+Amazon+Yangtze+Mississippi

join() メソッドを使用する場合には、メインの配列要素に対して指定する区切り文字に関係なく、次に示す例のように、ネストされた Array インスタンスまたは Vector インスタンスには常にカンマ区切りの値が返されることに注意する必要があります。

var nested:Array = ["b","c","d"]; 
var letters:Array = ["a",nested,"e"];  
var joined:String = letters.join("+"); 
trace(joined); // output: a+b,c,d+e