Pythonでページネーション（ページ送り）を実装する方法

本記事では、Pythonを使ってページネーション（ページ分割）の処理を実装する方法を解説します。リストから指定したページに該当する要素だけを取り出す、シンプルかつ実用的なテクニックを学びましょう。

問題の概要

文字列のリスト「book」が与えられているとします。ここに、ページ番号 page（0始まりのインデックス）と、1ページあたりの項目数 page_size を指定すると、そのページに表示される単語のリストを返す必要があります。もし指定されたページが範囲外であれば、空のリストを返すものとします。

例として、以下のような入力を考えてみます。

• book = ["hello", "world", "programming", "language", "python", "c++", "java"]
• page = 1
• page_size = 3

この場合、出力は ['language', 'python', 'c++'] となります。0ページ目には最初の3つの要素が割り当てられ、1ページ目にはその次の3つの要素が対応するためです。

解決のアプローチ

この問題は、リストのスライス（スライシング）を活用することで非常に簡単に解決できます。手順は以下の通りです。

1. 開始インデックス l を「page × page_size」として計算します。
2. book の l 番目から「l + page_size - 1」番目までの要素をスライスで取り出して返します。

Pythonのスライスでは、範囲がリストの長さを超えてもエラーにならず自動的に切り詰められるため、ページが範囲外の場合でも自然に空のリストが返されるという利点があります。

実装例

それでは、実際のコードを見てみましょう。

class Solution:
    def solve(self, book, page, page_size):
        l = page * page_size
        return book[l:l + page_size]

ob = Solution()
book = ["hello", "world", "programming", "language", "python", "c++", "java"]
page = 1
page_size = 3
print(ob.solve(book, page, page_size))

入力

["hello", "world", "programming", "language", "python", "c++", "java"], 1, 3

出力

['language', 'python', 'c++']

コードの解説

このソリューションのポイントは、たった1行のスライス処理 book[l:l + page_size] にあると言えます。

• l = page * page_size： 指定したページの先頭要素が、元のリストの何番目に位置するかを計算しています。
• book[l:l + page_size]： 開始インデックス l から終了インデックスの手前までの要素を取得します。終了位置がリストの長さを超えていても、Pythonは余分な部分を無視するためエラーは発生しません。
• さらに、開始位置 l がリストの長さ以上であれば、結果は自動的に空のリスト [] になります。これにより、「ページが範囲外なら空のリストを返す」という条件も追加のコードなしで満たされます。

このように、Pythonのスライス機能を理解しておくと、ページネーションのようなデータ分割処理を簡潔かつ安全に記述できるようになります。Webアプリケーションの検索結果表示や、大量データの一覧画面など、さまざまな場面で応用できる基本的なパターンです。