MENU

Pythonのrange関数の使い方|引数3つと業務での例

当ページのリンクには広告(PR)が含まれていることがあります。
【Range関数】Pythonでrange関数使いこなしガイド!rangeの意味から具体的な使い方までを徹底解説!のアイキャッチ
お悩み女子

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つずつ取り出すときに、順に数が作られます。

print(range(5)) とだけ書くと、range(0, 5) と表示されて中身は見えません。中身を確かめたいときは list() で囲みます。

range関数の引数3つ|start・stop・stepの指定方法

range関数に渡す数は1〜3個です。いくつ渡すかで、それぞれの数の意味が変わります。

スクロールできます
書き方作られる数意味
range(5)0, 1, 2, 3, 40から5の手前まで
range(1, 6)1, 2, 3, 4, 51から6の手前まで
range(0, 10, 3)0, 3, 6, 90から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を書きます。

3つの例のうち、エラーで止まるのは小数のときだけです。ほかの2つは気づかないうちに結果がずれるので、list() で中身を表示して確かめる手間を省かないようにします。

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 ドキュメント

この記事を書いた人

Watanabeのアバター Watanabe サイト運営者

2020年よりブログ開始。
SEOが思いのほか性にあっていたようで現在に至る。
モットーは「勝率の高い選択をする」
AIは活用するが吉、最後は人間が息を吹き込む。
アートと科学を追求し、日々精進。
―――
収益:6~7桁をウゴウゴ。
サイト:ペラサイト~中規模サイトまで運営中。
案件:1000円以上の案件をメインに取組中。
打ち手:ブラックSEO~ホワイトSEOまで
―――

目次