シャイタナの巨大コースター

listは、順序 を持つ要素の可変コレクションです。ほとんどのコレクション（組み込みのtuple、dict、setを参照）と同様に、配列は他の配列も含め、任意の（あるいは複数の）データ型への参照を保持できます。配列は、スライス記法を使うか、<list>.copy()を使うことで、全体または一部をコピーできます。他のシーケンス型と同じく、lists内の要素は、左からの0-based index番号、または右からの-1-based index番号で参照されます。

配列は、共通のシーケンス操作と可変シーケンス操作の両方をサポートしており、たとえばmin(<list>)/max(<list>)、<list>.index()、<list>.append()、<list>.reverse()などがあります。list内の要素は、for item in <list>という構文で繰り返し処理できます。要素のインデックスと値の両方が必要な場合は、for index, item in enumerate(<list>)を使えます。

Pythonには、配列を扱うための便利な配列のメソッドも多数用意されています。ここでは、その中の一部のlist methodsを紹介します。

listをlist-methodで操作すると、渡された配列オブジェクトそのものが変更される点に注意してください。元のlistを変更したくない場合は、少なくともスライスか<list>.copy()を使ってshallow copyを作る必要があります。

要素の追加

既存の配列の末尾（「右端」）に要素を追加するには、<list>.append(<item>)を使います：

>>> numbers = [1, 2, 3]
>>> numbers.append(9)

>>> numbers
[1, 2, 3, 9]

単に_追加_するのではなく、<list>.insert()を使えば、配列内の_特定のインデックス_に要素を追加できます。引数は2つです：

1. 要素を挿入したい<index>。
2. 挿入する<item>。

注意：指定したindexが0の場合、要素はlistの先頭（「左端」）に追加されます。指定したindexがlistの最後のindexより大きい場合、要素は最後の位置に追加されます。これは<list>.append(<item>)を使った場合と同じです。

>>> numbers = [1, 2, 3]
>>> numbers.insert(0, -2)

>>> numbers
[-2, 1, 2, 3]

>>> numbers.insert(1, 0)

>>> numbers
[-2, 0, 1, 2, 3]

<list>.extend(<item>)を使うと、既存の配列に、別のイテラブル（たとえばset、tuple、str、list）の要素を組み合わせられます。イテラブルは_展開_ され、要素が順番に追加されます（この場面で<list>.append(<item>)を使うと、イテラブル全体が1つの要素として追加されてしまいます）。

>>> numbers = [1, 2, 3]
>>> other_numbers = [5, 6, 7]

>>> numbers.extend(other_numbers)

>>> numbers
[1, 2, 3, 5, 6, 7]

>>> numbers.extend([8, 9])

>>> numbers
[1, 2, 3, 5, 6, 7, 8, 9]

>>> numbers.append([8,9])

>>> numbers
[1, 2, 3, 5, 6, 7, 8, 9, [8, 9]]

要素の削除

配列から要素を削除するには、<list>.remove(<item>)を使い、削除したい要素を引数として渡します。<list>.remove(<item>)は、その要素がlistに存在しない場合、ValueErrorを送出します。

>>> numbers = [1, 2, 3]
>>> numbers.remove(2)

>>> numbers
[1, 3]

# Trying to remove a value that is not in the list throws a ValueError
>>> numbers.remove(0)
ValueError: list.remove(x): x not in list

別の方法として、<list>.pop(<index>)メソッドを使うと、要素を削除すると同時にその要素をreturnして利用できます。

<list>.pop(<index>)は省略可能な引数を1つ取ります。削除して返す要素のindexです。（省略可能な）index引数を指定しない場合、listの最後の要素が削除されて返されます。指定したindexが最後の要素のindexより大きい場合、IndexErrorが発生します。

>>> numbers = [1, 2, 3]

>>> numbers.pop(0)
1

>>> numbers
[2, 3]

>>> numbers.pop()
3

>>> numbers
[2]

>>> numbers.pop(1)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
IndexError: pop index out of range

list.clear()を使えば、listからすべての要素を削除できます。引数はありません。

>>> numbers = [1, 2, 3]
>>> numbers.clear()

>>> numbers
[]

逆順と並べ替え

<list>.reverse()メソッドは、要素の順序をその場で逆にします。

>>> numbers = [1, 2, 3]
>>> numbers.reverse()

>>> numbers
[3, 2, 1]

配列は、<list>.sort()を使うと その場で 並べ替えられます。デフォルトの並べ替え順は、左からの_昇順_です。Pythonのドキュメントには、並べ替えに関する追加のヒントとテクニックが紹介されています。

>>> names = ["Tony", "Natasha", "Thor", "Bruce"]

# The default sort order is *ascending*.
>>> names.sort()

>>> names
["Bruce", "Natasha", "Thor", "Tony"]

降順 にしたい場合は、reverse=Trueを渡します：

>>> names = ["Tony", "Natasha", "Thor", "Bruce"]
>>> names.sort(reverse=True)

>>> names
["Tony", "Thor", "Natasha", "Bruce"]

元の配列を変更したくない場合は、組み込みのsorted(<iterable>)関数を使って、並べ替え済みのコピーを返すことができます。

>>> names = ["Tony", "Natasha", "Thor", "Bruce"]

>>> sorted(names)
['Bruce', 'Natasha', 'Thor', 'Tony']

配列内の要素の出現回数

配列内にある要素の出現回数は、list.count(<item>)を使うと数えられます。数えたいitemを引数に取り、その要素がlistに現れる合計回数を返します。

>>> items = [1, 4, 7, 8, 2, 9, 2, 1, 1, 0, 4, 3]

>>> items.count(1)
3

要素のインデックスを調べる

<list>.index(<item>)は、渡された要素が_最初に出現する_位置のindex番号を返します。出現しない場合は、ValueErrorが発生します。要素の正確な位置が必要ない場合は、組み込みのin演算子を使うほうが、配列に特定の値が含まれているかを調べるのに効率的です。

インデックスは左から0始まりなので、「最初」の要素の位置は0です。インデックスは右からも数えられ、-1から始まります。

>>> items = [7, 4, 1, 0, 2, 5]

>>> items.index(4)
1

>>> items.index(10)
ValueError: 10 is not in list

startとendのインデックスを指定して、listの特定の範囲に検索を絞ることもできます：

>>> names = ["Tina", "Leo", "Thomas", "Tina", "Emily", "Justin"]

>>> names.index("Tina")
0

>>> names.index("Tina", 2, 5)
3