【Python】IndexError: list index out of rangeエラーの原因と解決方法

IndexError: list index out of rangeエラーの発生原因

Pythonでリストを操作していると以下のエラーが発生することがあります。

IndexError: list index out of rangeエラーが発生する原因は、
リストに対して範囲外のインデックスを指定しているからです。

リストに格納されている要素にはそれぞれインデックスが振られています。リストのインデックスは0から振られているので、要素数-1がインデックスの最大値です。

リストについて詳しく知りたい方は以下記事をご参照ください。

【Python】リスト（list）とは：基本から応用まで使い方をまとめて紹介

IndexError: list index out of rangeエラーが発生する例

次のようなリストを扱ったコードを例に見てみましょう。

>>> lists = [4, 5, 54]
>>> lists[0]
4

上記プログラムでは、要素を３つ格納したlistsを生成しています。これはインデックス番号0～2の要素を持つリストであるということです。そしてlistのインデックス0の要素にアクセスしています。

それでは次のプログラムはどうでしょうか。

>>> lists = [4, 5, 54]
>>> lists[3]
IndexError: list index out of range

上記コードでは、IndexError: list index out of rangeエラーが発生してしまいました。原因はlists[3]にアクセスし、リストに対して範囲外のインデックスを指定しているからです。

このようなエラーがプログラム実行中に発生するとプログラムは異常終了してしまいます。エラーが発生してもプログラムを停止せずに走らせるためには例外処理を組み込みます。例外処理については以下記事をご参照ください。

【Python】エラー発生時にプログラムを止めないで続ける方法：例外処理（try、except）

リストの要素数の確認：len()メソッド

リストに格納されている要素数を得るためにlen()メソッドが使用されます。よくしてしまうミスとして、リストの末尾要素を取得するためにlen()メソッドを使うことです。

>>> lists = [4, 5, 54]
>>> num = len(lists)
>>> lists[num]
IndexError: list index out of range

len()メソッドで得た値で末尾の要素にアクセスするとIndexErrorが発生してしまいます。なぜならリストのインデックスは0から始まるため、len()メソッドでは末尾のインデックスより1大きいのです。

そのため末尾のインデックスを指定するならば、list[要素数-1]とする必要があります。

>>> lists = [4, 5, 54]
>>> num = len(lists)
>>> lists[num-1]
54

または末尾の要素を取得するならば、len()メソッドを使わずに-1を指定することで簡単に末尾の要素を取得できます。

>>> lists = [4, 5, 54]
>>> lists[-1]
54

タプルでもIndexErrorが発生する

範囲外インデックスを指定することで発生する本エラーは、リストだけでなくタプルでも同様にエラーが発生します。

>>> tp = (4, 5, 54)
>>> tp[3]
IndexError: tuple index out of range

リストでもタプルでも範囲外のインデックスは指定しないように気を付けましょう。