List クラス

署名

public List<T>()

例

署名

public List<T>(List<T> listToCopy)

パラメータ

listToCopy

型: List<T>

このリストの初期化に使用される要素を含むリスト。T はリスト要素のデータ型で���。

例

署名

public List<T>(Set<T> setToCopy)

パラメータ

setToCopy

型: Set<T>

このリストの初期化で使用する要素を含むセット。T はセット要素のデータ型です。

例

署名

public Void add(Object listElement)

パラメータ

listElement

型: Object

戻り値

型: Void

例

署名

public Void add(Integer index, Object listElement)

パラメータ

index

型: Integer

listElement

型: Object

戻り値

型: Void

例

次の例では 6 つの要素を持つリストが作成され、最初と 2 番目のインデックス位置に整数が追加されます。

署名

public Void addAll(List fromList)

パラメータ

fromList

型: List

戻り値

型: Void

署名

public Void addAll(Set fromSet)

パラメータ

fromSet

型: Set

戻り値

型: Void

署名

public Void clear()

戻り値

型: Void

署名

public List<Object> clone()

戻り値

型: List<Object>

使用方法

コピーされたリストは、現在のリストと同じデータ型です。

これが sObject レコードのリストである場合、重複リストはリストの浅いコピーとなります。つまり、重複には各オブジェクトへの参照がありますが、sObject レコード自体は重複しません。次に例を示します。

sObject レコードもコピーするには、deepClone メソッドを使用する必要があります。

例

署名

public List<Object> deepClone(Boolean preserveId, Boolean preserveReadonlyTimestamps, Boolean preserveAutonumber)

パラメータ

preserveId

型: Boolean

(省略可能) preserveId 引数は、元のオブジェクトの ID を重複で保持するか削除するかを指定します。true に設定すると、ID はコピーされたオブジェクトにコピーされます。デフォルトは false であるため、ID はクリアされます。

preserveReadonlyTimestamps

型: Boolean

(省略可能) preserveReadonlyTimestamps 引数は、参照のみのタイムスタンプとユーザ ID 項目を重複で保持するか削除するかを指定します。true に設定すると、参照のみの項目 CreatedById、CreatedDate、LastModifiedById、および LastModifiedDate は、コピーされたオブジェクトにコピーされます。デフォルトは false であるため、値はクリアされます。

preserveAutonumber

型: Boolean

(省略可能) preserveAutonumber 引数は、元のオブジェクトの自動採番項目を重複で保持するか削除するかを指定します。true に設定すると、自動採番項目はコピーされたオブジェクトにコピーされます。デフォルトは false であるため、自動採番項目はクリアされます。

戻り値

型: List<Object>

使用方法

返されたリストは、現在のリストと同じデータ型です。

含まれる sObject レコードが重複しないようにしてリストの浅いコピーを作成するには、clone メソッドを使用します。

例

この例は、2 つの取引先を含むリストのディープコピーを実行します。

署名

public Boolean equals(List list2)

パラメータ

list2

型: List

このリストと比較するリストです。

戻り値

型: Boolean

使用方法

それぞれの要素が等しく、要素の順序が同じである場合、2 つのリストは等しくなります。== 演算子は、リストの要素を比較するために使用します。

== 演算子は、equals メソッドのコールに相当します。そのため、list1 == list2; の代わりに list1.equals(list2); をコールできます。

署名

public Object get(Integer index)

パラメータ

index

型: Integer

戻り値

型: Object

使用方法

プリミティブデータ型または sObject 型の一次元リストの要素を参照するには、次の例に示すように、リスト名の後に要素のインデックス位置を角括弧で囲んで表記することもできます。

例

署名

public Schema.SObjectType getSObjectType()

戻り値

型: Schema.SObjectType

使用方法

このメソッドを Describe Information と共に使用して、リストに特定のデータ型の sObject を含めるかどうかを指定します。

このメソッドは sObject で構成されているリストでのみ使用できます。

詳細は、「Apex Describe Information について」を参照してください。

例

署名

public Integer hashCode()

戻り値

型: Integer

署名

public Boolean isEmpty()

戻り値

型: Boolean

署名

public Iterator iterator()

戻り値

型: Iterator

使用方法

返されたイテレータから反復可能なメソッド hasNext および next を使用して、リスト内で反復できます。

「カスタムイテレータ」を参照してください。

例

署名

public Object remove(Integer index)

パラメータ

index

型: Integer

戻り値

型: Object

例

署名

public Void set(Integer index, Object listElement)

パラメータ

index

型: Integer

設定するリスト要素のインデックスです。

listElement

型: Object

設定するリスト要素の値です。

戻り値

型: Void

使用方法

プリミティブデータ型または sObject の一次元リストの要素を設定するには、リスト名の後に要素のインデックス位置を角括弧で囲んで表記することもできます。

例

署名

public Integer size()

戻り値

型: Integer

例

署名

public Void sort()

戻り値

型: Void

使用方法

このメソッドを使用して、プリミティブ型、SelectOption 要素、sObject (標準オブジェクトとカスタムオブジェクト) を並び替えできます。sObject に使用される並び替え順についての詳細は、「sObject のリストの並び替え」を参照してください。カスタムデータ型 (Apex クラス) が Comparable インターフェースを実装している場合は、カスタムデータ型も並び替えできます。

15 文字の ID と 18 文字の ID の両方を含む List<Id> で sort() メソッドを使用する場合、API バージョン 35.0 以降では同じレコードの ID がまとめて並び替えられます。

例

次の例で、リストには 3 つの要素があります。リストを並び替えると、最初の要素には値が割り当てられていないため null、2 番目の要素の値は 5 になります。