PythonのIndexError: list index out of rangeは、リストにない番号の要素を取り出そうとしたときなどに出るエラーです。3個のリストなら、0以上の番号は0・1・2。len(items)が返す3は個数で、最後の番号ではありません。まずエラーの行にある番号と、その時点の個数を比べましょう。
IndexErrorを直すとき、まず見る3点
- どのリストか:エラーの行で取り出しているリストを探す。
- 今、何個あるか:取り出す直前にprint(len(items))で個数を見る。空になっていないかも確認する。
- 何番を使っているか:print(index)で番号を見る。個数ではなく、有効な番号を指定する。
ここではitems = ["地図", "鍵", "ポーション"]を使います。エラーを消すことだけを目指さず、どの道具を取りたかったかも確かめましょう。
| 書き方 | この3個のリストでの結果 |
|---|---|
| len(items) | 3(個数) |
| items[2] | ポーション(0から数えた最後) |
| items[3] | IndexError(3番はない) |
| items[-1] | ポーション(後ろから1個目) |
| items[-4] | IndexError(後ろからも範囲外) |
初めてリストを見る人は、リストの作り方・追加・入れ替えから始められます。エラー全体の読み方はエラー名と行番号の教材へ。
IndexErrorの原因を3つの実験で確かめよう
最初の見本は動くコードです。結果を予想して実行し、番号を1か所変えてエラーも観察します。赤い案内が出ても、直してもう一度試せます。
表示中の実験のコードを保存します。ページを離れると編集内容は消えます。
表示中の実験のコードを保存します。ページを離れると編集内容は消えます。
無料・ログイン不要。PCの最新版Chrome・Edgeを推奨します。初回は読み込みに少し時間がかかります。困ったら「停止する」「元に戻す」を使えます。編集したコードはページを閉じると消えるため、残したいものはコピーしてください。
図解:lenの個数と、前後からの番号
1.3個の道具に、3番はある?
予想:個数は3です。最後の道具を取り出す番号はいくつでしょう?
items = ["地図", "鍵", "ポーション"]
index = 2
print("個数:", len(items))
print("取り出す番号:", index)
print("道具:", items[index])
indexが2ならポーションを取り出せます。3にすると、3番の場所はないのでIndexErrorになります。エラーの前に表示した個数と番号を比べると、原因を追えます。
見本の結果を確かめる
個数: 3 取り出す番号: 2 道具: ポーション
変えてみよう:indexを2から3に変えて実行します。エラーの行を見てから、最後の道具を取れる番号に直しましょう。
考えるヒント
0以上の番号は0、1、2。len(items)は個数で、最後の番号ではありません。
2.最後の道具は、-1でも取れる
予想:2番と-1番は、同じ道具でしょうか? -3番はどの道具でしょう?
items = ["地図", "鍵", "ポーション"]
print("最後:", items[-1])
print("後ろから3個目:", items[-3])
負の番号は後ろから数える書き方です。この3個では-1がポーション、-3が地図です。持ち物を最後に追加すると、-1が指す道具も変わります。負の番号にも範囲があります。
見本の結果を確かめる
最後: ポーション 後ろから3個目: 地図
変えてみよう:-3を-4に変えて実行し、結果を見ます。その後、見本に戻して持ち物を1個追加すると、-1は何を指しますか?
考えるヒント
後ろからは-1、-2、-3と数えます。3個のリストに-4番はありません。
3.1番から選べる、道具メニュー
予想:メニューの3番を選ぶと、リストでは何番を使うでしょう? 0を選ぶとどうなるでしょう?
items = ["地図", "鍵", "ポーション"]
choice = 3
index = choice - 1
if 1 <= choice <= len(items):
print("選んだ道具:", items[index])
else:
print("その番号は選べません")
このメニューでは1〜3を選び、リストには0〜2の番号を使います。範囲を確かめてから取り出すため、0や4では案内だけを表示します。0をそのまま1引くと-1になり最後の道具を取れてしまうので、下限も確認します。
見本の結果を確かめる
選んだ道具: ポーション
変えてみよう:choiceを1・3・4・0に変えて比べます。次にitemsを空のリスト[]にし、choiceを1に戻して試しましょう。
考えるヒント
画面の1番をリストの0番に直すため、1を引きます。取り出す前に、1以上で個数以下かを確認しています。
実験3ではchoiceに整数を使います。1 <= choice <= len(items)は「1以上、かつ個数以下」です。Pythonのリストは負の番号も使えますが、このメニューの選択番号は1からにしています。
空のリストでは、0番も-1番も取れない
空のリスト[]は個数が0で、取り出せる要素がありません。items[0]もitems[-1]もIndexErrorになります。最後の1個を使いたいなら、中身があることを先に確かめます。
items = []
if len(items) > 0:
print("最後の道具:", items[-1])
else:
print("持ち物はまだありません")
変えてみよう:[]を["地図"]に変え、1個ある場合と比べましょう。0個のときにはlen(items) - 1も-1になるだけで、取り出せる場所が増えるわけではありません。
for文の最後だけIndexErrorになるとき
range(len(items) + 1)で番号を作っていないか確認します。3個のリストでrange(4)を使うと0・1・2・3となり、最後の3が範囲外です。番号を使うならrange(len(items))で0・1・2を作れます。中身を順に表示するだけなら、番号を作らずに書けます。
items = ["地図", "鍵", "ポーション"]
for item in items:
print("確認:", item)
このforは空のリストなら中の処理を0回実行します。番号も必要なときは、次のように個数に合わせます。
items = ["地図", "鍵", "ポーション"]
for index in range(len(items)):
print(index, items[index])
この例は、繰り返している途中にリストを増減しません。途中でremoveやpopを使うと、残りの個数や番号が変わるため別の注意が必要です。詳しくはrangeの始まり・終わり・増減へ。
IndexErrorでよくある疑問
list assignment index out of rangeも同じ原因?
items[3] = "ランタン"のように、存在しない場所へ代入してもIndexErrorになります。番号への代入は、すでにある要素を入れ替える操作です。末尾へ1個追加するならitems.append("ランタン")を使います。
負の番号は、すべてエラーになりますか?
いいえ。3個なら-1・-2・-3を使えます。一般に個数がnの空でないリストでは、-nからn-1までが要素を取り出せる整数の番号です。最初は前から0・1・2、後ろから-1・-2・-3と別々に確かめると分かりやすくなります。
items[99:100]ではエラーが出ません。
コロンのある書き方は、範囲を切り出すスライスです。この3個のリストなら空のリスト[]になります。items[99]で1個を取り出す操作とはルールが違います。スライスに変えるだけで直そうとせず、1個の値とリストのどちらが必要かを考えましょう。
ValueErrorやTypeErrorとは何が違いますか?
| 起きたこと | 主なエラー | 確かめる点 |
|---|---|---|
| items[3](3個のリスト) | IndexError | その番号の場所はあるか |
| items.remove("ロープ")(ロープがない) | ValueError | その値が含まれているか |
| items["1"] | TypeError | 番号が整数でなく文字列になっていないか |
items.index("ロープ")も、値が見つからなければValueErrorです。関数名のindexと、エラー名のIndexErrorを混同しないようにしましょう。inputで受け取った文字を番号にしたいときはinputとintの教材で練習できます。
改造:道具が増えても選べるメニューへ
- 実験3の持ち物に「ランタン」を追加し、choiceを4にする。
- 今度は1個のリストにし、choiceが1と2のときを比べる。
- 空のリストでも案内が表示されるか確かめる。
個数が変わっても、len(items)でその時点の個数を調べられます。言葉にする:「何個あるリストの、何番を取り出したか」を説明してみましょう。
次は、持ち物のルールを作ろう
リスト教材の持ち物上限チャレンジでは、道具を追加できる条件を作ります。リストを作品に使うならおみくじへ。
仕様の確認:Python公式:シーケンスの操作 / Python公式:IndexError
