array

array array ( [mixed ...] )
パラメータの配列を返します。パラメータには、 =>演算子によりインデックスを指定することもできます。配列に関するより詳しい情報は配列型のセクションをご覧ください。
注意: array()は、実際にはリテラル配列を表現するための言語構成要素であり、通常の関数ではありません。

カンマで区切った構文 "index => values" は、インデックスと値を定義します。インデックスは文字列または数値とすることが可能です。インデックスが省略された場合、0から始まる整数インデックスが自動的に生成されます。インデックスが整数の場合、次に生成されるインデックスは、整数インデックスの最大値 + 1 となります。同じインデックスを二度定義した場合、後の定義により最初の定義が上書きされることに注意してください。
一般的ではないですが、最後に定義された配列エントリの後に続くカンマがある場合、これは有効な構文です。
以下の例では、二次元配列の生成方法、連想配列のキーの指定方法、および通常の配列において添字番号をスキップし、それに続く要素にアクセスする方法についてご紹介しています。 例 271. array() の例

 <?php
 $fruits = array (
    "fruits"  => array("a" => "orange", "b" => "banana", "c" => "apple"),
    "numbers" => array(1, 2, 3, 4, 5, 6),
    "holes"  => array("first", 5 => "second", "third")
 );
 ?>

例 272. array() における自動インデックス

 <?php
 $array = array(1, 1, 1, 1,  1, 8 => 1,  4 => 1, 19, 3 => 13);
 print_r($array);
 ?>

上の例の出力は以下となります。

 Array
 (
    [0] => 1
    [1] => 1
    [2] => 1
    [3] => 13
    [4] => 1
    [8] => 1
    [9] => 19
 )

インデックス '3' は二度定義されており、後の値 13 が保持されることに注意してください。インデックス 4 はインデックス 8 の後に定義され、次に生成されるインデックス (値は 19) は、最大のインデックスが 8 であるため、9 となります。
次の例は、1 から始まる配列を作成します。 例 273. array() で 1 から始まる配列を作成

 <?php
 $firstquarter = array(1 => 'January', 'February', 'March');
 print_r($firstquarter);
 ?>

上の例の出力は以下となります。


Array
(
    [1] => January
    [2] => February
    [3] => March
)

Perl では、ダブルクオートで囲まれた配列の値にアクセスすることができます。しかしながら、PHP では配列を中括弧で囲む必要があります。 例 274. ダブルクオートで囲まれた配列にアクセスする

 <?php
 
 $foo = array('bar' => 'baz');
 echo "Hello {$foo['bar']}!"; // Hello baz!
 
 ?>

array_pad()、 list()、 count()、 foreach および range() も参照ください。

配列関数(array)

導入

これらの関数により様々な手法で配列にアクセスし、操作することが可能になります。配列は、変数の組を保存、管理、操作する基本的な要素です。
通常の配列および多次元配列がサポートされており、ユーザが定義したり、他の関数で作成することも可能です。いくつかのデータベース処理関数は、データベースのクエリから配列を返しますし、いくつかの関数は配列を返します。
PHPでの配列の実装や使用方法の詳細については、マニュアルの配列に関する節を参照下さい。その他の配列の操作方法については、配列演算子も参照ください。

要件

外部ライブラリを必要としません。

インストール手順

PHP コアに含まれるため、追加のインストール無しで使用できます。

実行時設定

設定ディレクティブは定義されていません。

リソース型

リソース型は定義されていません。

定義済み定数

以下の定数は、PHP コアに含まれており、常に利用可能です。

CASE_LOWER (integer): CASE_LOWERは、 array_change_key_case()で使用され、配列のキーを小文字に変換するために使用されます。小文字は、 array_change_key_case()のデフォルトのケースでもあります。
CASE_UPPER (integer): CASE_UPPERは、 array_change_key_case()で使用され、配列のキーを大文字に変換するために使用されます。

ソース順のフラグ:

SORT_ASC (integer): SORT_ASCは、 array_multisort()でソート順を昇順にするために使用されます。
SORT_DESC (integer) (integer): SORT_DESCは、 array_multisort()でソート順を降順にするために使用されます。

ソート型のフラグ: 種々のソート関数で使用されます

SORT_REGULAR (integer): SORT_REGULARは通常の比較するために使用されます。
SORT_NUMERIC (integer): SORT_NUMERICは数値で比較を行うために使用されます。
SORT_STRING (integer): SORT_STRINGは文字列として比較を行うために使用されます。
SORT_LOCALE_STRING (integer): SORT_LOCALE_STRINGは現在のロケールに基づいた文字列として比較を行うために使用されます。 PHP 4.4.0と5.0.2で追加されました。

COUNT_NORMAL (integer)
COUNT_RECURSIVE (integer)
EXTR_OVERWRITE (integer)
EXTR_SKIP (integer)
EXTR_PREFIX_SAME (integer)
EXTR_PREFIX_ALL (integer)
EXTR_PREFIX_INVALID (integer)
EXTR_PREFIX_IF_EXISTS (integer)
EXTR_IF_EXISTS (integer)
EXTR_REFS (integer)

参考

is_array(), explode(), implode(), split(), preg_split(), および join() も参照してください。

array_change_key_case — 配列のキーを全て小文字または大文字にして返す
array_chunk — 配列を分割する
array_combine — 一方の配列をキーとして、もう一方の配列を値として、ひとつの配列を生成する
array_count_values — 配列の値の数を数える
array_diff_assoc — 追加された添字の確認を含めて配列の差を計算する
array_diff_key — キーを基準にして配列の差を計算する
array_diff_uassoc — ユーザが指定したコールバック関数を利用し、追加された添字の確認を含めて配列の差を計算する
array_diff_ukey — キーを基準にし、コールバック関数を用いて配列の差を計算する
array_diff — 配列の差を計算する
array_fill_keys — キーを指定して、配列を値で埋める
array_fill — 配列を指定した値で埋める
array_filter — コールバック関数を使用する配列要素フィルタ
array_flip — 配列のキーと値を反転する
array_intersect_assoc — 追加された添字の確認も含めて配列の共通項を確認する
array_intersect_key — キーを基準にして配列の共通項を計算する
array_intersect_uassoc — 追加された添字の確認も含め、コールバック関数を用いて配列の共通項を確認する
array_intersect_ukey — キーを基準にし、コールバック関数を用いて配列の共通項を計算する
array_intersect — 配列の共通項を計算する
array_key_exists — 指定したキーまたは添字が配列にあるかどうかを調べる
array_keys — 配列のキーをすべて返す
array_map — 指定した配列の要素にコールバック関数を適用する
array_merge_recursive — 二つ以上の配列を再帰的にマージする
array_merge — ひとつまたは複数の配列をマージする
array_multisort — 複数の多次元の配列をソートする
array_pad — 指定長、指定した値で配列を埋める
array_pop — 配列の末尾から要素を取り除く
array_product — 配列の値の積を計算する
array_push — 一つ以上の要素を配列の最後に追加する
array_rand — 配列から一つ以上の要素をランダムに取得する
array_reduce — コールバック関数を用いて配列を普通の値に変更することにより、配列を再帰的に減らす
array_reverse — 要素を逆順にした配列を返す
array_search — 指定した値を配列で検索し、見つかった場合に対応するキーを返す
array_shift — 配列の先頭から要素を一つ取り出す
array_slice — 配列の一部を展開する
array_splice — 配列の一部を削除し、他の要素で置換する
array_sum — 配列の中の値の合計を計算する
array_udiff_assoc — データの比較にコールバック関数を用い、追加された添字の確認を含めて配列の差を計算する
array_udiff_uassoc — データと添字の比較にコールバック関数を用い、追加された添字の確認を含めて配列の差を計算する
array_udiff — データの比較にコールバック関数を用い、配列の差を計算する
array_uintersect_assoc — データの比較にコールバック関数を用い、追加された添字の確認も含めて配列の共通項を計算する
array_uintersect_uassoc — データと添字の比較にコールバック関数を用い、追加された添字の確認も含めて配列の共通項を計算する
array_uintersect — データの比較にコールバック関数を用い、配列の共通項を計算する
array_unique — 配列から重複した値を削除する
array_unshift — 一つ以上の要素を配列の最初に加える
array_values — 配列の全ての値を返す
array_walk_recursive — 配列の全ての要素に、ユーザー関数を再帰的に適用する
array_walk — 配列の全ての要素にユーザ関数を適用する
array — 配列を生成する
arsort — 連想キーと要素との関係を維持しつつ配列を逆順にソートする
asort — 連想キーと要素との関係を維持しつつ配列をソートする
compact — 変数名とその値から配列を作成する
count — 変数に含まれる要素、あるいはオブジェクトに含まれるプロパティの数を数える
current — 配列内の現在の要素を返す
each — 配列から、次のキーと値のペアを返す
end — 配列の内部ポインタを最終要素にセットする
extract — 配列からシンボルテーブルに変数をインポートする
in_array — 配列に値があるかチェックする
key — 連想配列からキーを取り出す
krsort — 配列をキーで逆順にソートする
ksort — 配列をキーでソートする
list — 配列と同様の形式で、複数の変数への代入を行う
natcasesort — 大文字小文字を区別しない"自然順"アルゴリズムを用いて配列をソートする
natsort — "自然順"アルゴリズムで配列をソートする
next — 内部配列ポインタを進める
pos — current() のエイリアス
prev — 内部の配列ポインタをひとつ前に戻す
range — ある範囲の整数を有する配列を作成する
reset — 配列の内部ポインタを先頭の要素にセットする
rsort — 配列を逆順にソートする
shuffle — 配列をシャッフルする
sizeof — count() のエイリアス
sort — 配列をソートする
uasort — ユーザー定義の比較関数で配列をソートし、連想インデックスを保持する
uksort — ユーザー定義の比較関数を用いて、キーで配列をソートする
usort — ユーザー定義の比較関数を使用して、配列を値でソートする

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Array クラス

配列の作成、操作、検索、および並べ替えを行うメソッドを提供します。これにより、共通言語ランタイムのすべての配列の基本クラスとして機能します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public MustInherit Class
 Array
    Implements ICloneable, IList, ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As Array

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public abstract class Array : ICloneable, IList,
 ICollection, 
    IEnumerable

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class Array abstract : ICloneable,
 IList, ICollection, 
    IEnumerable

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public abstract class Array implements ICloneable,
 IList, 
    ICollection, IEnumerable

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public abstract class Array implements ICloneable,
 IList, 
    ICollection, IEnumerable

解説

Array クラスは、配列をサポートする言語による各実装の基本クラスです。ただし、システムとコンパイラに限り、Array クラスから明示的に派生させることができます。開発者は、言語によって提供される配列構造を使用する必要があります。

要素は Array 内の値です。Array の長さは、その配列に含まれる要素の合計数ですArray のランクは、Array の次元数です。Array の次元の下限は、Array のその次元の開始インデックスです。多次元 Array では次元ごとに下限が異なることがあります。

重要 :
.NET Framework Version 2.0 では、Array クラスは System.Collections.Generic.IList、System.Collections.Generic.ICollection、および System.Collections.Generic.IEnumerable の各ジェネリックインターフェイスを実装します。この実装は、実行時に配列に提供されるため、ドキュメント作成ツールでは表示できません。したがって、ジェネリックインターフェイスは Array クラスの宣言構文には表示されないので、配列をジェネリックインターフェイス型にキャストすること (明示的なインターフェイスの実装) によってのみアクセスできるインターフェイスメンバに関する参照トピックはありません。配列をこれらのインターフェイスのいずれかにキャストする場合には、要素を追加、挿入、または削除するメンバが NotSupportedException をスローすることに特に注意する必要があります。

重要 :

.NET Framework Version 2.0 では、Array クラスは System.Collections.Generic.IList、System.Collections.Generic.ICollection、および System.Collections.Generic.IEnumerable の各ジェネリックインターフェイスを実装します。この実装は、実行時に配列に提供されるため、ドキュメント作成ツールでは表示できません。したがって、ジェネリックインターフェイスは Array クラスの宣言構文には表示されないので、配列をジェネリックインターフェイス型にキャストすること (明示的なインターフェイスの実装) によってのみアクセスできるインターフェイスメンバに関する参照トピックはありません。配列をこれらのインターフェイスのいずれかにキャストする場合には、要素を追加、挿入、または削除するメンバが NotSupportedException をスローすることに特に注意する必要があります。

Type オブジェクトは、配列型宣言の情報を提供します。配列型が同じである Array オブジェクトは、同じ Type オブジェクトを共有します。

配列を Array 型にキャストした場合に、結果が配列ではなくオブジェクトになることもあるため、Type.IsArray および Type.GetElementType は、Array について予測される結果を返さない場合があります。つまり、typeof(System.Array).IsArray は false を返し、typeof(System.Array).GetElementType は null 参照 (Visual Basic では Nothing) を返します。

ほとんどのクラスとは異なり、Array は、遅延バインディングによるアクセスを可能にするために、パブリックコンストラクタではなく CreateInstance メソッドを用意しています。

Array.Copy メソッドでは、同じ型の配列間だけでなく、異なる型の標準配列間でも要素がコピーされます。つまり、自動的に型キャストが処理されます。

CreateInstance、Copy、CopyTo、GetValue および SetValue など、メソッドによっては大容量の配列に対応するために 64 ビット整数をパラメータとして受け取るオーバーロードが用意されています。LongLength および GetLongLength は、配列の長さを示す 64 ビット整数を返します。

Array が並べ替えられることは保証されていません。Array を並べ替える必要のある操作 (BinarySearch など) を実行する前に、Array を並べ替える必要があります。

使用例

Array.Copy メソッドを使用して、整数型の配列と Object 型の配列間で要素をコピーする方法を次のコード例で示します。

Visual Basic

Public Class SamplesArray    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new integer array and a new Object
 array.
        Dim myIntArray() As Integer
 = {1, 2, 3, 4, 5}
        Dim myObjArray() As Object
 = {26, 27, 28, 29, 30}
        
        ' Prints the initial values of both arrays.
        Console.WriteLine("Initially,")
        Console.Write("integer array:")
        PrintValues(myIntArray)
        Console.Write("Object array: ")
        PrintValues(myObjArray)
        
        ' Copies the first two elements from the integer array to the
 Object array.
        Array.Copy(myIntArray, myObjArray, 2)
        
        ' Prints the values of the modified arrays.
        Console.WriteLine(ControlChars.NewLine + "After copying
 the first two" _
           + " elements of the integer array to the Object array
,")
        Console.Write("integer array:")
        PrintValues(myIntArray)
        Console.Write("Object array: ")
        PrintValues(myObjArray)
        
        ' Copies the last two elements from the Object array to the
 integer array.
        Array.Copy(myObjArray, myObjArray.GetUpperBound(0) - 1, myIntArray, _
           myIntArray.GetUpperBound(0) - 1, 2)
        
        ' Prints the values of the modified arrays.
        Console.WriteLine(ControlChars.NewLine + "After copying
 the last two" _
           + " elements of the Object array to the integer array
,")
        Console.Write("integer array:")
        PrintValues(myIntArray)
        Console.Write("Object array: ")
        PrintValues(myObjArray)
    End Sub
    
    Overloads Public Shared
 Sub PrintValues(myArr() As Object)
        Dim i As Object
        For Each i In  myArr
            Console.Write(ControlChars.Tab + "{0}",
 i)
        Next i
        Console.WriteLine()
    End Sub    
    
    Overloads Public Shared
 Sub PrintValues(myArr() As Integer)
        Dim i As Integer
        For Each i In  myArr
            Console.Write(ControlChars.Tab + "{0}",
 i)
        Next i
        Console.WriteLine()
    End Sub
End Class

' This code produces the following output.
' 
' Initially,
' integer array:  1       2       3       4       5
' Object array:   26      27      28      29      30
' 
' After copying the first two elements of the integer array to the Object
 array,
' integer array:  1       2       3       4       5
' Object array:   1       2       28      29      30
' 
' After copying the last two elements of the Object array to the integer
 array,
' integer array:  1       2       3       29      30
' Object array:   1       2       28      29      30

public class SamplesArray  {

   public static void Main()
  {

      // Creates and initializes a new integer array and a new Object
 array.
      int[] myIntArray = new int[5]
 { 1, 2, 3, 4, 5 };
      Object[] myObjArray = new Object[5] { 26, 27, 28, 29, 30
 };

      // Prints the initial values of both arrays.
      Console.WriteLine( "Initially," );
      Console.Write( "integer array:" );
      PrintValues( myIntArray );
      Console.Write( "Object array: " );
      PrintValues( myObjArray );

      // Copies the first two elements from the integer array to the
 Object array.
      Array.Copy( myIntArray, myObjArray, 2 );

      // Prints the values of the modified arrays.
      Console.WriteLine( "\nAfter copying the first two elements of the integer
 array to the Object array," );
      Console.Write( "integer array:" );
      PrintValues( myIntArray );
      Console.Write( "Object array: " );
      PrintValues( myObjArray );

      // Copies the last two elements from the Object array to the integer
 array.
      Array.Copy( myObjArray, myObjArray.GetUpperBound(0) - 1, myIntArray, myIntArray.GetUpperBound(0)
 - 1, 2 );

      // Prints the values of the modified arrays.
      Console.WriteLine( "\nAfter copying the last two elements of the Object
 array to the integer array," );
      Console.Write( "integer array:" );
      PrintValues( myIntArray );
      Console.Write( "Object array: " );
      PrintValues( myObjArray );
   }


   public static void PrintValues(
 Object[] myArr )  {
      foreach ( Object i in myArr )  {
         Console.Write( "\t{0}", i );
      }
      Console.WriteLine();
   }

   public static void PrintValues(
 int[] myArr )  {
      foreach ( int i in
 myArr )  {
         Console.Write( "\t{0}", i );
      }
      Console.WriteLine();
   }
}
/* 
This code produces the following output.

Initially,
integer array:  1       2       3       4       5
Object array:   26      27      28      29      30

After copying the first two elements of the integer array to the Object array,
integer array:  1       2       3       4       5
Object array:   1       2       28      29      30

After copying the last two elements of the Object array to the integer array,
integer array:  1       2       3       29      30
Object array:   1       2       28      29      30
*/

C++

using namespace System;
void main1();
void main2();
void main()
{
   main1();
   Console::WriteLine();
   main2();
}

void PrintValues( array<Object^>^myArr );
void PrintValues( array<int>^myArr );
void main1()
{
   // Creates and initializes a new int array and a new Object array.
   array<int>^myIntArray = {1,2,3,4,5};
   array<Object^>^myObjArray = {26,27,28,29,30};

   // Prints the initial values of both arrays.
   Console::WriteLine(  "Initially," );
   Console::Write(  "int array:   " );
   PrintValues( myIntArray );
   Console::Write(  "Object array:" );
   PrintValues( myObjArray );

   // Copies the first two elements from the int array to the Object
 array.
   Array::Copy( myIntArray, myObjArray, 2 );

   // Prints the values of the modified arrays.
   Console::WriteLine(  "\nAfter copying the first two elements of the int
 array to the Object array," );
   Console::Write(  "int array:   " );
   PrintValues( myIntArray );
   Console::Write(  "Object array:" );
   PrintValues( myObjArray );

   // Copies the last two elements from the Object array to the int
 array.
   Array::Copy( myObjArray, myObjArray->GetUpperBound( 0 ) - 1, myIntArray, myIntArray->GetUpperBound(
 0 ) - 1, 2 );

   // Prints the values of the modified arrays.
   Console::WriteLine(  "\nAfter copying the last two elements of the Object
 array to the int array," );
   Console::Write(  "int array:   " );
   PrintValues( myIntArray );
   Console::Write(  "Object array:" );
   PrintValues( myObjArray );
}

void PrintValues( array<Object^>^myArr )
{
   for ( int i = 0; i < myArr->Length;
 i++ )
   {
      Console::Write(  "\t{0}", myArr[ i ] );

   }
   Console::WriteLine();
}

void PrintValues( array<int>^myArr )
{
   for ( int i = 0; i < myArr->Length;
 i++ )
   {
      Console::Write(  "\t{0}", myArr[ i ] );

   }
   Console::WriteLine();
}


/* 
 This code produces the following output.
 
 Initially,
 int array:       1    2    3    4    5
 Object array:    26    27    28    29    30
 After copying the first two elements of the int array to the
 Object array,
 int array:       1    2    3    4    5
 Object array:    1    2    28    29    30
 After copying the last two elements of the Object array to the int
 array,
 int array:       1    2    3    29    30
 Object array:    1    2    28    29    30
 */

public class SamplesArray
{
    public static void main(String[]
 args)
    {
        // Creates and initializes a new integer array and a new Object
 array.
        int myIntArray[] = new int[]
 { 1, 2, 3, 4, 5 };
        Object myObjArray[] = new Object[] { (Int32)26, (Int32)27,
 (Int32)28, 
            (Int32)29, (Int32)30};
        // Prints the initial values of both arrays.
        Console.WriteLine("Initially,");
        Console.Write("integer array:");
        PrintValues(myIntArray);
        Console.Write("Object array: ");
        PrintValues(myObjArray);
        // Copies the first two elements from the integer array to the
 
        // Object array.
        Array.Copy(myIntArray, myObjArray, 2);
        // Prints the values of the modified arrays.
        Console.WriteLine("\nAfter copying the first two elements of the"
            + " integer array to the Object array,");
        Console.Write("integer array:");
        PrintValues(myIntArray);
        Console.Write("Object array: ");
        PrintValues(myObjArray);
        // Copies the last two elements from the Object array to the
        // integer array.
        Array.Copy(myObjArray, myObjArray.GetUpperBound(0) - 1, myIntArray, 
            myIntArray.GetUpperBound(0) - 1, 2);
        // Prints the values of the modified arrays.
        Console.WriteLine("\nAfter copying the last two elements of the Object"
            + " array to the integer array,");
        Console.Write("integer array:");
        PrintValues(myIntArray);
        Console.Write("Object array: ");
        PrintValues(myObjArray);
    } //main

    public static void PrintValues(Object
 myArr[])
    {
        Object i = null;
        for (int iCtr = 0; iCtr < myArr.get_Length();
 iCtr++) {
            i = myArr[iCtr];
            Console.Write("\t{0}", i);
        }
        Console.WriteLine();
    } //PrintValues

    public static void PrintValues(int
 myArr[])
    { 
        int i = 0;
        for (int iCtr = 0; iCtr < myArr.get_Length();
 iCtr++) {
            i = myArr[iCtr];
            Console.Write("\t{0}", (Int32)i);
        }
        Console.WriteLine();
    } //PrintValues
} //SamplesArray

/* 
 This code produces the following output.
 
 Initially,
 integer array:  1       2       3       4       5
 Object array:   26      27      28      29      30

 After copying the first two elements of the integer array to the Object array,
 integer array:  1       2       3       4       5
 Object array:   1       2       28      29      30

 After copying the last two elements of the Object array to the integer array,
 integer array:  1       2       3       29      30
 Object array:   1       2       28      29      30
 */

Array を作成および初期化し、そのプロパティと要素を表示するコード例を次に示します。

Visual Basic

Public Class SamplesArray2    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new three-dimensional Array of
        ' type Int32.
        Dim myArr As Array = Array.CreateInstance(GetType(Int32),
 2, 3, 4)
        Dim i As Integer
        For i = myArr.GetLowerBound(0) To myArr.GetUpperBound(0)
            Dim j As Integer
            For j = myArr.GetLowerBound(1) To
 myArr.GetUpperBound(1)
                Dim k As Integer
                For k = myArr.GetLowerBound(2) To
 myArr.GetUpperBound(2)
                    myArr.SetValue(i * 100 + j * 10 + k, i, j, k)
                Next k
            Next j 
        Next i ' Displays the properties of the Array.
        Console.WriteLine("The Array has {0} dimension(s) and
 a " _
           + "total of {1} elements.", myArr.Rank,
 myArr.Length)
        Console.WriteLine(ControlChars.Tab + "Length"
 + ControlChars.Tab _
           + "Lower" + ControlChars.Tab + "Upper")
        For i = 0 To myArr.Rank - 1
            Console.Write("{0}:" + ControlChars.Tab
 + "{1}", i, _
               myArr.GetLength(i))
            Console.WriteLine(ControlChars.Tab + "{0}"
 + ControlChars.Tab _
               + "{1}", myArr.GetLowerBound(i), myArr.GetUpperBound(i))
        Next i
        
        ' Displays the contents of the Array.
        Console.WriteLine("The Array contains the following values:")
        PrintValues(myArr)
    End Sub
    
    Public Shared Sub PrintValues(myArr
 As Array)
        Dim myEnumerator As System.Collections.IEnumerator
 = _
           myArr.GetEnumerator()
        Dim i As Integer
 = 0
        Dim cols As Integer
 = myArr.GetLength(myArr.Rank - 1)
        While myEnumerator.MoveNext()
            If i < cols Then
                i += 1
            Else
                Console.WriteLine()
                i = 1
            End If
            Console.Write(ControlChars.Tab + "{0}",
 myEnumerator.Current)
        End While
        Console.WriteLine()
    End Sub
End Class

' This code produces the following output.
' 
' The Array has 3 dimension(s) and a total of 24 elements.
'     Length    Lower    Upper
' 0:    2    0    1
' 1:    3    0    2
' 2:    4    0    3
' The Array contains the following values:
'     0    1    2    3
'     10    11    12    13
'     20    21    22    23
'     100    101    102    103
'     110    111    112    113
'     120    121    122    123

public class SamplesArray2{

   public static void Main()
  {

      // Creates and initializes a new three-dimensional Array of type
 Int32.
      Array myArr = Array.CreateInstance( typeof(Int32), 2, 3, 4 );
      for ( int i = myArr.GetLowerBound(0);
 i <= myArr.GetUpperBound(0); i++ )
         for ( int j = myArr.GetLowerBound(1);
 j <= myArr.GetUpperBound(1); j++ )
            for ( int k = myArr.GetLowerBound(2);
 k <= myArr.GetUpperBound(2); k++ )  {
               myArr.SetValue( (i*100)+(j*10)+k, i, j, k );
            }

      // Displays the properties of the Array.
      Console.WriteLine( "The Array has {0} dimension(s) and a total of {1}
 elements.", myArr.Rank, myArr.Length );
      Console.WriteLine( "\tLength\tLower\tUpper" );
      for ( int i = 0; i < myArr.Rank; i++
 )  {
         Console.Write( "{0}:\t{1}", i, myArr.GetLength(i) );
         Console.WriteLine( "\t{0}\t{1}", myArr.GetLowerBound(i), myArr.GetUpperBound(i)
 );
      }

      // Displays the contents of the Array.
      Console.WriteLine( "The Array contains the following values:" );
      PrintValues( myArr );
   }


   public static void PrintValues(
 Array myArr )  {
      System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
      int i = 0;
      int cols = myArr.GetLength( myArr.Rank - 1 );
      while ( myEnumerator.MoveNext() )  {
         if ( i < cols )  {
            i++;
         } else  {
            Console.WriteLine();
            i = 1;
         }
         Console.Write( "\t{0}", myEnumerator.Current );
      }
      Console.WriteLine();
   }
}
/* 
This code produces the following output.

The Array has 3 dimension(s) and a total of 24 elements.
    Length    Lower    Upper
0:    2    0    1
1:    3    0    2
2:    4    0    3
The Array contains the following values:
    0    1    2    3
    10    11    12    13
    20    21    22    23
    100    101    102    103
    110    111    112    113
    120    121    122    123
*/

C++

void PrintValues( Array^ myArr );
void main2()
{
   // Creates and initializes a new three-dimensional Array instance
 of type Int32.
   Array^ myArr = Array::CreateInstance( Int32::typeid, 2, 3, 4 );
   for ( int i = myArr->GetLowerBound( 0
 ); i <= myArr->GetUpperBound( 0 ); i++ )
   {
      for ( int j = myArr->GetLowerBound(
 1 ); j <= myArr->GetUpperBound( 1 ); j++ )
      {
         for ( int k = myArr->GetLowerBound(
 2 ); k <= myArr->GetUpperBound( 2 ); k++ )
            myArr->SetValue( (i * 100) + (j * 10) + k, i, j, k );

      }
   }
   
   // Displays the properties of the Array.
   Console::WriteLine(  "The Array instance has {0} dimension(s) and a total
 of {1} elements.", myArr->Rank, myArr->Length );
   Console::WriteLine(  "\tLength\tLower\tUpper" );
   for ( int i = 0; i < myArr->Rank;
 i++ )
   {
      Console::Write(  "{0}:\t{1}", i, myArr->GetLength( i ) );
      Console::WriteLine(  "\t{0}\t{1}", myArr->GetLowerBound( i ),
 myArr->GetUpperBound( i ) );

   }
   Console::WriteLine(  "The Array instance contains the following values:"
 );
   PrintValues( myArr );
}

void PrintValues( Array^ myArr )
{
   System::Collections::IEnumerator^ myEnumerator = myArr->GetEnumerator();
   int i = 0;
   int cols = myArr->GetLength( myArr->Rank - 1 );
   while ( myEnumerator->MoveNext() )
   {
      if ( i < cols )
            i++;
      else
      {
         Console::WriteLine();
         i = 1;
      }

      Console::Write(  "\t{0}", myEnumerator->Current );
   }

   Console::WriteLine();
}

/* 
 This code produces the following output.
 
 The Array instance has 3 dimension(s) and a total of 24 elements.
     Length    Lower    Upper
 0:    2    0    1
 1:    3    0    2
 2:    4    0    3
 The Array instance contains the following values:
     0    1    2    3
     10    11    12    13
     20    21    22    23
     100    101    102    103
     110    111    112    113
     120    121    122    123
 */

public class SamplesArray2
{
    public static void main(String[]
 args)
    {
        // Creates and initializes a new three-dimensional Array of type
 Int32.
        Array myArr = Array.CreateInstance(Int32.class.ToType(),
 2, 3, 4);
        for (int i = myArr.GetLowerBound(0);
 i <= myArr.GetUpperBound(0); i++) {
            for (int j = myArr.GetLowerBound(1);
 j <= myArr.GetUpperBound(1);
                j++) {
                for (int k = myArr.GetLowerBound(2);
 k <= myArr.
                    GetUpperBound(2); k++) {
                    myArr.SetValue((Int32)(i * 100 + j * 10 + k), i, j, k);
                }
            }
        }  // Displays the properties of the Array.
        Console.WriteLine("The Array has {0} dimension(s) and a total of"
            + " {1} elements.", System.Convert.ToString(myArr.get_Rank()),
 
            System.Convert.ToString(myArr.get_Length()));
        Console.WriteLine("\tLength\tLower\tUpper");
        for (int i = 0; i < myArr.get_Rank();
 i++) {
            Console.Write("{0}:\t{1}", System.Convert.ToString(i), 
                System.Convert.ToString(myArr.GetLength(i)));
            Console.WriteLine("\t{0}\t{1}", System.Convert.ToString(myArr.
                GetLowerBound(i)), System.Convert.ToString(myArr.
                GetUpperBound(i)));
        }
        // Displays the contents of the Array.
        Console.WriteLine("The Array contains the following values:");
        PrintValues(myArr);
    } //main

    public static void PrintValues(Array
 myArr)
    {
        System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
        int i = 0;
        int cols = myArr.GetLength(myArr.get_Rank() - 1);
        while (myEnumerator.MoveNext()) {
            if (i < cols) {
                i++;
            }
            else {
                Console.WriteLine();
                i = 1;
            }
            Console.Write("\t{0}", myEnumerator.get_Current());
        }
        Console.WriteLine();
    } //PrintValues
} //SamplesArray2

/* 
 This code produces the following output.
 
 The Array has 3 dimension(s) and a total of 24 elements.
     Length    Lower    Upper
 0:    2    0    1
 1:    3    0    2
 2:    4    0    3
 The Array contains the following values:
     0    1    2    3
     10    11    12    13
     20    21    22    23
     100    101    102    103
     110    111    112    113
     120    121    122    123
 */

継承階層

System.Object
System.Array

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバは、スレッドセーフです。すべてのインスタンスメンバがスレッドセーフになるかどうかは保証されていません。

この実装は、Array 用の同期された (スレッドセーフな) ラッパーは提供しませんが、Array に基づく .NET Framework クラスでは、SyncRoot プロパティを使用して、独自にコレクションを同期させることができます。

コレクションの列挙処理は、本質的にはスレッドセーフな処理ではありません。コレクションが同期されている場合でも、他のスレッドがそのコレクションを変更する可能性はあり、そのような状況が発生すると列挙子は例外をスローします。列挙処理を確実にスレッドセーフに行うには、列挙中にコレクションをロックするか、他のスレッドによって行われた変更によってスローされる例外をキャッチします。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Array メンバ
System 名前空間
Object
Type
その他の技術情報
カルチャを認識しない配列の操作の実行

Array プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	SyncRoot	Array へのアクセスを同期するために使用できるオブジェクトを取得します。

明示的インターフェイスの実装

	名前	説明
	System.Collections.IList.Item	指定したインデックスにある要素を取得または設定します。

参照

その他の技術情報

カルチャを認識しない配列の操作の実行

Array メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	AsReadOnly	指定した配列をラップする読み取り専用のラッパーを作成します。
	BinarySearch	オーバーロードされます。バイナリサーチアルゴリズムを使用して、並べ替え済みの 1 次元の Array 内で値を検索します。
	Clear	Array 内の要素の範囲を、要素の型に応じて、0 (ゼロ)、false、または null 参照 (Visual Basic では Nothing) に設定します。
	Clone	Array の簡易コピーを作成します。
	ConstrainedCopy	指定したコピー元インデックスを開始位置として Array から要素の範囲をコピーし、指定したコピー先インデックスを開始位置として他の Array にそれらの要素を貼り付けます。コピーが完全に成功しない限り、変更は一切適用されません。
	ConvertAll	ある型の配列を別の型の配列に変換します。
	Copy	オーバーロードされます。一方の Array の要素範囲を他方の Array にコピーし、必要に応じて型キャストとボックス化を実行します。
	CopyTo	オーバーロードされます。現在の 1 次元 Array のすべての要素を、指定した 1 次元 Array にコピーします。
	CreateInstance	オーバーロードされます。 Array クラスの新しいインスタンスを初期化します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Exists	指定された配列に、指定された述語によって定義された条件と一致する要素が含まれているかどうかを判断します。
	Find	指定された述語によって定義された条件と一致する要素を検索し、Array 全体の中で最もインデックス番号の小さい要素を返します。
	FindAll	指定された述語によって定義された条件と一致するすべての要素を取得します。
	FindIndex	オーバーロードされます。
	FindLast	指定された述語によって定義された条件と一致する要素を、Array 全体を対象に検索し、最もインデックス番号の大きい要素を返します。
	FindLastIndex	オーバーロードされます。
	ForEach	指定された配列内の各要素に対して、指定された処理を実行します。
	GetEnumerator	Array の IEnumerator を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLength	Array の指定した次元にある要素の数を表す 32 ビット整数を取得します。
	GetLongLength	Array の指定した次元にある要素の数を表す 64 ビット整数を取得します。
	GetLowerBound	Array 内の指定した次元の下限を取得します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetUpperBound	Array 内の指定した次元の上限を取得します。
	GetValue	オーバーロードされます。現在の Array 内の指定した要素の値を取得します。
	IndexOf	オーバーロードされます。 1 次元 Array 内または Array 内で値が最初に見つかった位置のインデックス番号を返します。
	Initialize	値型の既定のコンストラクタを呼び出して、この値型 Array の各要素を初期化します。
	LastIndexOf	オーバーロードされます。 1 次元 Array 内または Array の範囲内で値が最後に見つかった位置のインデックス番号を返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Resize	配列のサイズを、新たに指定したサイズに変更します。
	Reverse	オーバーロードされます。 1 次元 Array 内または Array の範囲内の要素の順序を反転させます。
	SetValue	オーバーロードされます。現在の Array 内の指定した要素を指定した値に設定します。
	Sort	オーバーロードされます。 1 次元 Array オブジェクト内の要素を並べ替えます。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	TrueForAll	配列内のすべての要素が、指定された述語によって定義された条件と一致するかどうかを調べます。

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.Collections.IList.Add	IList.Add を実装します。常に NotSupportedException をスローします。
	System.Collections.IList.Clear	Array 内のすべての要素を、要素の型に応じて、0 (ゼロ)、false、または null 参照 (Visual Basic では Nothing) に設定します。
	System.Collections.IList.Contains	ある要素が Array 内に存在するかどうかを判断します。
	System.Collections.IList.IndexOf	指定したオブジェクトを検索し、現在の 1 次元インスタンス内でそのオブジェクトが最初に見つかった位置のインデックス番号を返します。
	System.Collections.IList.Insert	IList.Insert を実装します。常に NotSupportedException をスローします。
	System.Collections.IList.Remove	IList.Remove を実装します。常に NotSupportedException をスローします。
	System.Collections.IList.RemoveAt	IList.RemoveAt を実装します。常に NotSupportedException をスローします。

参照

その他の技術情報

カルチャを認識しない配列の操作の実行

Array メンバ

Array データ型で公開されるメンバを以下の表に示します。

パブリックプロパティ

	名前	説明
	SyncRoot	Array へのアクセスを同期するために使用できるオブジェクトを取得します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	AsReadOnly	指定した配列をラップする読み取り専用のラッパーを作成します。
	BinarySearch	オーバーロードされます。バイナリサーチアルゴリズムを使用して、並べ替え済みの 1 次元の Array 内で値を検索します。
	Clear	Array 内の要素の範囲を、要素の型に応じて、0 (ゼロ)、false、または null 参照 (Visual Basic では Nothing) に設定します。
	Clone	Array の簡易コピーを作成します。
	ConstrainedCopy	指定したコピー元インデックスを開始位置として Array から要素の範囲をコピーし、指定したコピー先インデックスを開始位置として他の Array にそれらの要素を貼り付けます。コピーが完全に成功しない限り、変更は一切適用されません。
	ConvertAll	ある型の配列を別の型の配列に変換します。
	Copy	オーバーロードされます。一方の Array の要素範囲を他方の Array にコピーし、必要に応じて型キャストとボックス化を実行します。
	CopyTo	オーバーロードされます。現在の 1 次元 Array のすべての要素を、指定した 1 次元 Array にコピーします。
	CreateInstance	オーバーロードされます。 Array クラスの新しいインスタンスを初期化します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Exists	指定された配列に、指定された述語によって定義された条件と一致する要素が含まれているかどうかを判断します。
	Find	指定された述語によって定義された条件と一致する要素を検索し、Array 全体の中で最もインデックス番号の小さい要素を返します。
	FindAll	指定された述語によって定義された条件と一致するすべての要素を取得します。
	FindIndex	オーバーロードされます。
	FindLast	指定された述語によって定義された条件と一致する要素を、Array 全体を対象に検索し、最もインデックス番号の大きい要素を返します。
	FindLastIndex	オーバーロードされます。
	ForEach	指定された配列内の各要素に対して、指定された処理を実行します。
	GetEnumerator	Array の IEnumerator を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLength	Array の指定した次元にある要素の数を表す 32 ビット整数を取得します。
	GetLongLength	Array の指定した次元にある要素の数を表す 64 ビット整数を取得します。
	GetLowerBound	Array 内の指定した次元の下限を取得します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetUpperBound	Array 内の指定した次元の上限を取得します。
	GetValue	オーバーロードされます。現在の Array 内の指定した要素の値を取得します。
	IndexOf	オーバーロードされます。 1 次元 Array 内または Array 内で値が最初に見つかった位置のインデックス番号を返します。
	Initialize	値型の既定のコンストラクタを呼び出して、この値型 Array の各要素を初期化します。
	LastIndexOf	オーバーロードされます。 1 次元 Array 内または Array の範囲内で値が最後に見つかった位置のインデックス番号を返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Resize	配列のサイズを、新たに指定したサイズに変更します。
	Reverse	オーバーロードされます。 1 次元 Array 内または Array の範囲内の要素の順序を反転させます。
	SetValue	オーバーロードされます。現在の Array 内の指定した要素を指定した値に設定します。
	Sort	オーバーロードされます。 1 次元 Array オブジェクト内の要素を並べ替えます。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	TrueForAll	配列内のすべての要素が、指定された述語によって定義された条件と一致するかどうかを調べます。

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.Collections.IList.Add	IList.Add を実装します。常に NotSupportedException をスローします。
	System.Collections.IList.Clear	Array 内のすべての要素を、要素の型に応じて、0 (ゼロ)、false、または null 参照 (Visual Basic では Nothing) に設定します。
	System.Collections.IList.Contains	ある要素が Array 内に存在するかどうかを判断します。
	System.Collections.IList.IndexOf	指定したオブジェクトを検索し、現在の 1 次元インスタンス内でそのオブジェクトが最初に見つかった位置のインデックス番号を返します。
	System.Collections.IList.Insert	IList.Insert を実装します。常に NotSupportedException をスローします。
	System.Collections.IList.Remove	IList.Remove を実装します。常に NotSupportedException をスローします。
	System.Collections.IList.RemoveAt	IList.RemoveAt を実装します。常に NotSupportedException をスローします。
	System.Collections.IList.Item	指定したインデックスにある要素を取得または設定します。

参照

その他の技術情報

カルチャを認識しない配列の操作の実行

ウィキペディア小見出し辞書

索引トップ用語の索引ランキング

Array

出典: フリー百科事典『ウィキペディア（Wikipedia）』 (2021/09/08 09:24 UTC 版)

「アレー」の記事における「Array」の解説

配列アレイ・ネットワークス - アメリカ合衆国の企業。

※この「Array」の解説は、「アレー」の解説の一部です。
「Array」を含む「アレー」の記事については、「アレー」の概要を参照ください。

array

出典: フリー百科事典『ウィキペディア（Wikipedia）』 (2019/04/29 13:43 UTC 版)

「Standard Template Library」の記事における「array」の解説

(*) 固定長配列。

※この「array」の解説は、「Standard Template Library」の解説の一部です。
「array」を含む「Standard Template Library」の記事については、「Standard Template Library」の概要を参照ください。

ウィキペディア小見出し辞書の「Array」の項目はプログラムで機械的に意味や本文を生成しているため、不適切な項目が含まれていることもあります。ご了承くださいませ。お問い合わせ。

固有名詞の分類

PHP	realpath define array exit ocicolumnsize >>固有名詞 >>製品一覧 >>コンピュータ一覧 >>プログラミング言語一覧

>> 「Array」を含む用語の索引
Arrayのページへのリンク


	Copyright © 2024実用日本語表現辞典 All Rights Reserved.
	(C)Shogakukan Inc. 株式会社小学館
	©COPYRIGHT ASIAL CORPORATION ALL RIGHTS RESERVED.
	Copyright © 2005-2024 Weblio 辞書 IT用語辞典バイナリさくいん。この記事は、IT用語辞典バイナリの配列の記事を利用しております。
	Copyright © 1997 - 2024 by the PHP Documentation Group.
	© 2024 Microsoft.All rights reserved.
	Text is available under GNU Free Documentation License (GFDL). Weblio辞書に掲載されている「ウィキペディア小見出し辞書」の記事は、Wikipediaのアレー (改訂履歴)、Standard Template Library (改訂履歴)の記事を複製、再配布したものにあたり、GNU Free Documentation Licenseというライセンスの下で提供されています。

Arrayとは？わかりやすく解説

array

「array」の意味

「array」の発音・読み方

「array」の定義を英語で解説

「array」の類語

「array」に関連する用語・表現

「array」の例文

アレイ【array】

配列連想配列

配列

array

説明

配列関数(array)

導入

要件

インストール手順

実行時設定

リソース型

定義済み定数

参考

目次

Array クラス

Array プロパティ

関連項目

その他の技術情報

Array メソッド

関連項目

その他の技術情報

Array メンバ

関連項目

その他の技術情報

Array

array

「Array」の関連用語

Arrayとは？ わかりやすく解説

array

「array」の意味

「array」の発音・読み方

「array」の定義を英語で解説

「array」の類語

「array」に関連する用語・表現

「array」の例文

アレイ【array】

配列 連想配列

配列

array

説明

配列関数(array)

導入

要件

インストール手順

実行時設定

リソース型

定義済み定数

参考

目次

Array クラス

Array プロパティ

関連項目

その他の技術情報

Array メソッド

関連項目

その他の技術情報

Array メンバ

関連項目

その他の技術情報

Array

array

「Array」の関連用語

Arrayとは？わかりやすく解説

配列連想配列