readlines()関数は、ファイルの各行を要素として、リストにまとめて返します。

パラメータhintは、読み込む行数を制限するために使用されます。パラメータhintが負数または0の場合、行数の制限はありません。hintのデフォルト値は -1 で、つまりデフォルトでは読み込む行数に制限はなく、ファイルの全ての行が返されます。

以下の例は、hintの値を指定せずにデフォルト値の -1 を使用した場合を示しています。この場合、全ての行が読み込まれ、それらの行がリストにまとめて返されます。

>>> fd = open("in.dat", "r")   # ファイルin.datを読み取り専用で開く
>>> lines = fd.readlines()     # 全ての行を読み込む
>>> lines                      # 返される値を表示する。リストで、各要素は一行を表す
['this is input text file\n', 'it contains 3 lines\n', 'this is the end
        of file\n']
>>> fd.close()                 # ファイルを閉じる

hintが正数の場合、各行が順番に読み込まれ、読み込まれた文字数がhintより大きいかどうかがチェックされます。hint以上の場合、次の行の読み込みは停止します。hint未満の場合、次の行の読み込みが続けられます。以下の例は、hintが実際のファイルのバイト数より小さい場合を示しています。

>>> fd = open("in.dat", "r")   # ファイルin.datを読み取り専用で開く
>>> lines = fd.readlines(3)    # 読み込んだ文字数が3を超えた場合、次の行の読み込みを停止する
>>> lines                      # そのため、一行だけ読み込んで停止した
['this is input text file\n']
>>> lines = fd.readlines(30)   # 読み込んだ文字数が30を超えた場合、次の行の読み込みを停止する
>>> lines                      # 二行目の文字列は30未満なので、三行目の読み込みを続けた
['it contains 3 lines\n', 'this is the end of file\n']
>>> fd.close()                 # ファイルを閉じる