Pythonで「Python list index out of range」エラーが出た時の対処法を現役エンジニアが解説【初心者向け】

初心者向けにPythonで「Python list index out of range」エラーが出た時の対処法について現役エンジニアが解説しています。このエラーはシーケンス(配列)に対して、範囲外のインデックスを指定してしまうことにより発生します。rangeメソッドを使うとエラーを防ぐことが出来ます。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営。初心者向けに解説した記事が4,000以上あります。現役エンジニアの方はこちらをご覧ください。

Pythonで「Python list index out of range」エラーが出た時の対処法について解説します。

そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

 

なお本記事は、TechAcademyのオンラインブートキャンプPython講座の内容をもとに紹介しています。

 

田島悠介

今回は、Pythonに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

Pythonで「Python list index out of range」エラーが出た時の対処法について詳しく説明していくね!

大石ゆかり

お願いします!

 

「Python list index out of range」エラーの原因

Pythonで複数の要素をまとめて管理する型をシーケンスと呼びます。シーケンスにはリストやタプル、文字列などがあります。

シーケンスに含まれる要素には、先頭から順番にインデックスが振られています。インデックスは0から始まります。例えば以下のリストの場合、要素「’aa’」に対応するインデックスは「0」、要素「’cc’」に対応するインデックスは「2」となります。

mylist = ['aa', 'bb', 'cc', 'dd']

シーケンスに対してインデックスを指定することで要素を取り出すことができます。以下の例では item に「’aa’」が取得されます。

item = mylist[0]

この時、範囲外のインデックスを指定してしまうと、エラー「list index out of range」が発生します。具体例を確認しましょう。

mylist = ['aa', 'bb', 'cc', 'dd']
item = mylist[10]

実行結果は以下のようになります。範囲外のインデックス「10」を指定したことで、エラー「list index out of range」が発生していることが確認できます。

IndexError      Traceback (most recent call last)
<ipython-input-34-2972c6cb2098> in <module>
      1 mylist = ['aa', 'bb', 'cc', 'dd']
      2 
----> 3 item = mylist[10]

IndexError: list index out of range

 

対処法

エラー「list index out of range」を発生させないようにするには、範囲外のインデックスを指定しないことです。

対処法1

もっとも発生しやすいのが、末尾を要素数で指定してしまうことです。例を上げましょう。

mylist = ['aa', 'bb', 'cc', 'dd']
idx = len(mylist)
item = mylist[idx]

この場合、len関数で取得した要素数でインデックスを指定してしまっています。インデックスは0から開始するため、末尾のインデックスは「要素数-1」となります。

mylist = ['aa', 'bb', 'cc', 'dd']
idx = len(mylist)
item = mylist[idx - 1]

または、「-1」を指定することで末尾の要素を取得することができます。

item = mylist[-1]

 

対処法2

上記の問題はrangeを使うことでも解決できます。

range(開始, 終了, 増分)

rangeには終了の値を含まないという決まりがあります。そのため、終了の値に要素数を指定することで、末尾の要素を取得することができます。

mylist = ['aa', 'bb', 'cc', 'dd']

for idx in range(0, len(mylist)):
  print(mylist[idx])

実行結果は以下のようになります。

aa
bb
cc
dd

 

[PR] Pythonで挫折しない学習方法を動画で公開中

監修してくれたメンター

太田和樹(おおたかずき)

ITベンチャー企業のPM兼エンジニア

普段は主に、Web系アプリケーション開発のプロジェクトマネージャーとプログラミング講師を行っている。守備範囲はフロントエンド、モバイル、サーバサイド、データサイエンティストと幅広い。その幅広い知見を生かして、複数の領域を組み合わせた新しい提案をするのが得意。

開発実績:画像認識技術を活用した駐車場混雑状況把握(実証実験)、音声認識を活用したヘルプデスク支援システム、Pepperを遠隔操作するアプリの開発、大規模基幹系システムの開発・導入マネジメント。

地方在住。仕事のほとんどをリモートオフィスで行う。通勤で消耗する代わりに趣味のDIYや家庭菜園、家族との時間を楽しんでいる。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

 

TechAcademyでは、初心者でも最短4週間でPythonを使った人工知能(AI)や機械学習の基礎を習得できるオンラインブートキャンプPython講座を開催しています。

挫折しない学習方法を知れる説明動画や、現役エンジニアとのビデオ通話とチャットサポート、学習用カリキュラムを体験できる無料体験も実施しているので、ぜひ参加してみてください。