read() 関数は現在位置から読み始め、指定された個数の文字を読み出します。その戻り値は文字列で、読み取ったファイルの内容を表します。

パラメータ size が正の数の場合、最大で size 個の文字を読み出します；size が 0 の場合、何も読み出されず、戻り値は空文字列になります；size が負の数の場合、全内容を読み出します。size のデフォルト値は -1 で、全内容を読み出すことを意味します。

以下の例では、size の値を指定せずにデフォルト値 -1 を使用する場合を示しています。

>>> fd = open("in.dat", "r")   # ファイル in.dat を読み取り専用で開く
>>> ret_str = fd.read()        # すべてのファイル内容を ret_str に読み込む、size=-1
>>> type(ret_str)              # 戻り値の型は文字列
<class 'str'>
>>> len(ret_str)               # 文字列の長さは 68
68
>>> print(ret_str)             # ファイル内容を表示
this is input text file
it contains 3 lines
this is the end of file
>>> fd.close()                 # ファイルを閉じる

以下では、size を指定し、かつ size が正の数の場合を示します。

>>> fd = open("in.dat", "r")   # ファイル in.dat を読み取り専用で開く
>>> str1 = fd.read(40)         # 最大 40 個の文字を読み込み、str1 に保存
>>> str2 = fd.read(40)         # 最大 40 個の文字を読み込み、str2 に保存
>>> len(str1)                  # str1 は 40 個の文字を含む
40
>>> len(str2)                  # str2 は 28 個の文字を含み、合計で 68 個の文字
28
>>> print(str1+str2)           # str1 と str2 を連結すると、ファイルの完全な内容になる
this is input text file
it contains 3 lines
this is the end of file
>>> fd.close()                 # ファイルを閉じる

ファイルの末尾に達すると、空文字列が返されます。

>>> fd = open("in.dat", "r")   # ファイル in.dat を読み取り専用で開く
>>> str1 = fd.read()           # 全内容を読み出す
>>> str2 = fd.read()           # この時点でファイルの末尾に達している
>>> type(str2)                 # 戻り値の型は文字列
<class 'str'>    
>>> len(str2)                  # str2 の長さは 0 なので、空文字列
0
>>> fd.close()                 # ファイルを閉じる