お悩み女子for文でよく見る range(5) が、なぜ0から4までなのか分からない……
range関数は指定した範囲の整数を順番に作る関数です。for文と組み合わせると、「12か月分のファイル名を作る」「Excelの2行目から最後の行まで処理する」といったくり返しを短く書けます。
range関数の3つの引数の意味と、業務の作業で使うときの書き方を、動くコードつきで紹介します。載せているコードはWindows 11 と Python 3.12 で動くことを確かめています。
- range関数が作る数の範囲と「stopを含まない」決まり
- start・stop・stepの3つの引数の指定方法
- 逆順や1つ飛ばしの数を作る方法
- つまずきやすい3つの例と直し方
- Excelの表に番号を振る実務の例
range関数が作る整数の範囲
range関数は Python に最初から入っている関数で、追加のインストールは要りません。まずは、どんな数が作られるかを見てみます。
print(list(range(5)))
実行結果は次のとおりです。
[0, 1, 2, 3, 4]
range(5) は0から始まり、5の手前の4で止まります。「5を数える」のではなく「0から数えて5個」と覚えると、結果と一致します。
list() で囲んでいるのは、中身を一覧で表示するためです。range関数が返すのはリストではなく、rangeオブジェクトという「数の並びの決まりごと」です。for文で1つずつ取り出すときに、順に数が作られます。
range関数の引数3つ|start・stop・stepの指定方法
range関数に渡す数は1〜3個です。いくつ渡すかで、それぞれの数の意味が変わります。
| 書き方 | 作られる数 | 意味 |
|---|---|---|
| range(5) | 0, 1, 2, 3, 4 | 0から5の手前まで |
| range(1, 6) | 1, 2, 3, 4, 5 | 1から6の手前まで |
| range(0, 10, 3) | 0, 3, 6, 9 | 0から10の手前まで、3つおき |
stopだけを指定する形
数を1つだけ渡すと、それがstop(止まる位置)になります。開始は0で決まっています。「n回くり返したい」ときは、この形がいちばん短く書けます。
startとstopを指定する形
2つ渡すと、1つ目がstart(開始)、2つ目がstopです。1から5までほしいときは、stopに「最後の数 + 1」の6を書きます。
print(list(range(1, 6)))
# [1, 2, 3, 4, 5]
stepで刻み幅を指定する形
3つ目のstepはいくつずつ増やすかの指定です。省略すると1になります。
print(list(range(0, 10, 3)))
# [0, 3, 6, 9]
結果に10は入りません。stepを付けても、stopの手前で止まる決まりは同じです。
range関数とfor文|決まった回数だけ処理をくり返す
range関数がいちばん活躍するのは、for文で同じ処理を決まった回数くり返す場面です。基本の形と、業務で使う例を1つずつ見ます。
n回くり返す基本の形
for i in range(3):
print(f"{i + 1}回目の処理")
実行すると、次のように表示されます。
1回目の処理
2回目の処理
3回目の処理
変数 i には 0、1、2 が順に入ります。画面に出す番号は i + 1 にすると、1から数えた表示になります。
12か月分のファイル名を作る例
毎月の売上ファイルのように、名前に月が入るファイルを順に扱うときにも使えます。
for month in range(1, 13):
print(f"売上_2026-{month:02d}.csv")
売上_2026-01.csv
売上_2026-02.csv
(中略)
売上_2026-12.csv
{month:02d} は「2けたにそろえ、足りないときは前を0で埋める」という指定です。01、02…と2けたにそろえておくと、フォルダで名前順に並べたときに月の順になります。1、2…のままだと、10月から12月が1月と2月の間に並んでしまいます。
range関数の逆順と1つ飛ばし|stepの指定
stepの数を変えると、数を減らしながら作ったり、間を飛ばしたりできます。
大きい数から小さい数へ(逆順)
print(list(range(10, 0, -1)))
# [10, 9, 8, 7, 6, 5, 4, 3, 2, 1]
stepにマイナスの数を書くと、数が減っていきます。このときもstopの0は含まれず、1で止まります。0まで入れたいときは、stopを-1にします。
2つおき・偶数だけ
print(list(range(2, 11, 2)))
# [2, 4, 6, 8, 10]
偶数だけ、1行おきなど、一定の間隔で処理したいときに使えます。たとえば表で見出しの行と明細の行が交互に並んでいるとき、明細の行番号だけを順に作れます。
range関数でつまずきやすい3つの例|数のずれ・小数・空の結果
range関数で困りやすいのは、エラーが出ないまま結果がずれるケースです。動かしたあとに最初と最後の数を確かめると、早く気づけます。
最後の数の抜け
1月から12月までのつもりで range(1, 12) と書くと、12が入りません。
print(list(range(1, 12))[-1]) # 11(12月が抜ける)
print(list(range(1, 13))[-1]) # 12
[-1] は「最後の要素」という意味です。stopには「最後にほしい数 + 1」を書くと覚えておくと、このずれを防げます。
小数を渡したときのTypeError
range関数に渡せるのは整数だけです。range(0.5) のように小数を渡すと、次のエラーで止まります。
TypeError: 'float' object cannot be interpreted as an integer
「float(小数)は整数として扱えません」という意味です。0.1ずつ増える数がほしいときは、整数で数を作ってから割ります。
print([i / 10 for i in range(0, 5)])
# [0.0, 0.1, 0.2, 0.3, 0.4]
stepの書き忘れによる空の結果
range(5, 1) のように、startがstopより大きいのにstepを書かないと、エラーは出ずに中身が空になります。
print(list(range(5, 1))) # []
print(list(range(5, 1, -1))) # [5, 4, 3, 2]
for文の中が一度も動かないので、「処理は終わったのに何も変わっていない」という形で表れます。減らしながら数えたいときは、stepに-1を書きます。
range関数でExcelに連番を振る例
最後に、Excelの表に連番を振る例です。Excelを Python から操作するライブラリ openpyxl を使います。入っていない場合は、コマンドプロンプトで pip install openpyxl を実行すると入れられます。
openpyxlで行に番号を振るコード
例として、A列の「No」が空のまま、B列に店舗名、C列に売上が3行並んだ「売上一覧.xlsx」を用意しました。1行目は見出しです。
from openpyxl import load_workbook
wb = load_workbook("売上一覧.xlsx")
ws = wb.active
# 1行目は見出しなので、2行目から最終行まで番号を振る
for row in range(2, ws.max_row + 1):
ws.cell(row=row, column=1, value=row - 1)
wb.save("売上一覧_番号付き.xlsx")
print(f"{ws.max_row - 1}行に番号を振りました")
実行すると「3行に番号を振りました」と表示され、A2からA4に1、2、3が入った「売上一覧_番号付き.xlsx」が保存されます。
1行目は見出しなので、rangeは2から始めます。そして、ws.max_row(データが入っている最後の行の番号)に1を足してstopにします。この2つがポイントです。1を足し忘れると、最後の行だけ番号が入りません。
元のファイルを上書きしないよう、保存するファイル名を変えています。動きを確かめるまでは、別の名前で保存するか、コピーしたファイルで試すと元のデータを壊さずに済みます。
番号と中身を同時に使うときのenumerate
リストの中身と番号を同時に使いたいときは、range関数よりenumerate関数の方が読みやすく書けます。
stores = ["東京", "大阪", "名古屋"]
for i, name in enumerate(stores, start=1):
print(i, name)
# 1 東京
# 2 大阪
# 3 名古屋
for i in range(len(stores)) と書いて stores[i] で中身を取り出す方法もあります。ただ、番号と中身を一度に受け取れる enumerate の方が、書き間違いが起きにくくなります。range関数は「回数」や「行番号」そのものがほしいとき、と使い分けると迷いません。
range関数に関するよくある質問
range関数について、よくある疑問をまとめました。
- range関数の結果はリストですか?
-
リストではなく、rangeオブジェクトです。list(range(5)) のように list() で囲むとリストに変換できます。個数を数える len() や、含まれているかを調べる in は、変換しなくても使えます(len(range(1, 13)) は12です)。
- 古いコードで見かける xrange とは何が違いますか?
-
xrange は Python 2 の関数で、Python 3 ではなくなりました。今の range が同じ役割を引き継いでいます。古い記事やコードで xrange を見かけたら、range に読み替えてください。
- 0.5刻みのような小数の範囲は作れますか?
-
range関数だけではできません。[i / 2 for i in range(0, 6)] のように、整数で作ってから割る方法が手軽です(結果は 0.0 から 2.5 までの0.5刻み)。数値計算用のライブラリ NumPy の arange 関数を使う方法もあります。
range関数の引数とstopの手前で止まる決まり
range関数のポイントを整理します。
range関数とは:指定した範囲の整数を順に作る関数。
3つの引数:start(開始)・stop(止まる位置)・step(刻み幅)。stopの数は含まれない。
よく使う場面:決まった回数のくり返し、連番のファイル名、表の行を順に処理する作業。
つまずきやすい点:最後の数のずれ、小数のエラー、stepの書き忘れで結果が空になること。
迷ったら、list() で囲んで中身を表示し、最初と最後の数を確かめるのが近道です。
range関数と一緒に使うことの多い処理は、次の記事でも扱っています。
参考資料
組み込み型 range | Python 3 ドキュメント
range() 関数 | Python チュートリアル
openpyxl ドキュメント
