InputStream 類別

代表輸入 Blob 的類似檔案物件。

繼承

BufferedIOBase

InputStream

ABC

InputStream

建構函式

InputStream()

方法

close	排清並關閉 IO 物件。 如果檔案已經關閉，這個方法就沒有任何作用。
detach	中斷此緩衝區與其基礎原始資料流程的連線，並傳回它。 卸離原始資料流程之後，緩衝區處於無法使用的狀態。
fileno	如果有的話，傳回基礎檔案描述元。 如果 IO 物件不使用檔案描述元，則會引發 OSError。
flush	如果適用，請排清寫入緩衝區。 這不是針對唯讀和非封鎖資料流程實作的。
isatty	傳回這是否為「互動式」資料流程。 如果無法判斷，則傳回 False。
read	傳回並讀取最多 大小 位元組。
read1	讀取並傳回最多 n 個位元組，最多一個讀取 () 呼叫基礎原始資料流程。 簡短的結果不表示 EOF 即將出現。 傳回 EOF 上的空位元組物件。
readable	傳回物件是否已開啟以供讀取。 如果為 False，read () 將會引發 OSError。
readinto
readinto1
readline	從資料流程讀取並傳回一行。 如果指定 size，則最多會讀取大小位元組。 二進位檔的行結束字元一律為 b'n';對於文字檔，要開啟的 newlines 引數可用來選取行結束字元， (辨識 s) 。
readlines	從資料流程傳回行清單。 可以指定 hint 來控制讀取的行數：如果目前為止所有行的總大小 (位元組/字元) 超過提示，則不會再讀取行數。
seek	變更資料流程位置。 將資料流程位置變更為指定的位元組位移。 位移會相對於 whence 所指示的位置進行解譯。 whence 的值包括： 0 – 串流啟動 (預設) ;offset 應該是零或正數 1 – 目前的資料流程位置;位移可能是負數 2 – 資料流程結尾;位移通常是負數 傳回新的絕對位置。
seekable	傳回物件是否支援隨機存取。 如果為 False，則 seek () 、tell () 和 truncate () 會引發 OSError。 此方法可能需要執行測試搜尋 () 。
tell	傳回目前的資料流程位置。
truncate	截斷檔案以調整位元組大小。 檔案指標保持不變。 大小預設為依 tell () 所回報的目前 IO 位置。 傳回新的大小。
writable	傳回物件是否已開啟以供寫入。 如果為 False，write () 將會引發 OSError。
write	將指定的緩衝區寫入 IO 資料流程。 傳回寫入的位元組數目，一律是 b 以位元組為單位的長度。 如果緩衝區已滿，且基礎原始資料流程目前無法接受更多資料，則會引發 BlockingIOError。
writelines	將行清單寫入資料流程。 不會新增行分隔符號，因此通常每個行在結尾都有一個行分隔符號。

close

排清並關閉 IO 物件。

如果檔案已經關閉，這個方法就沒有任何作用。

close()

detach

中斷此緩衝區與其基礎原始資料流程的連線，並傳回它。

卸離原始資料流程之後，緩衝區處於無法使用的狀態。

detach()

fileno

如果有的話，傳回基礎檔案描述元。

如果 IO 物件不使用檔案描述元，則會引發 OSError。

fileno()

flush

如果適用，請排清寫入緩衝區。

這不是針對唯讀和非封鎖資料流程實作的。

flush()

isatty

傳回這是否為「互動式」資料流程。

如果無法判斷，則傳回 False。

isatty()

read

傳回並讀取最多 大小 位元組。

abstract read(size=-1) -> bytes

參數

size

int

預設值: -1

要讀取的位元組數。 如果省略引數、 None 或負數，則會讀取並傳回資料，直到達到 EOF 為止。

傳回

從輸入資料流程讀取的位元組。

read1

讀取並傳回最多 n 個位元組，最多一個讀取 () 呼叫基礎原始資料流程。 簡短的結果不表示 EOF 即將出現。

傳回 EOF 上的空位元組物件。

read1()

readable

傳回物件是否已開啟以供讀取。

如果為 False，read () 將會引發 OSError。

readable()

readinto

readinto(buffer, /)

參數

buffer

必要

readinto1

readinto1(buffer, /)

參數

buffer

必要

readline

從資料流程讀取並傳回一行。

如果指定 size，則最多會讀取大小位元組。

二進位檔的行結束字元一律為 b'n';對於文字檔，要開啟的 newlines 引數可用來選取行結束字元， (辨識 s) 。

readline(size=-1, /)

參數

size

預設值: -1

readlines

從資料流程傳回行清單。

可以指定 hint 來控制讀取的行數：如果目前為止所有行的總大小 (位元組/字元) 超過提示，則不會再讀取行數。

readlines(hint=-1, /)

參數

hint

預設值: -1

seek

變更資料流程位置。

將資料流程位置變更為指定的位元組位移。 位移會相對於 whence 所指示的位置進行解譯。 whence 的值包括：

• 0 – 串流啟動 (預設) ;offset 應該是零或正數

• 1 – 目前的資料流程位置;位移可能是負數

• 2 – 資料流程結尾;位移通常是負數

傳回新的絕對位置。

seek()

seekable

傳回物件是否支援隨機存取。

如果為 False，則 seek () 、tell () 和 truncate () 會引發 OSError。 此方法可能需要執行測試搜尋 () 。

seekable()

tell

傳回目前的資料流程位置。

tell()

truncate

截斷檔案以調整位元組大小。

檔案指標保持不變。 大小預設為依 tell () 所回報的目前 IO 位置。 傳回新的大小。

truncate()

writable

傳回物件是否已開啟以供寫入。

如果為 False，write () 將會引發 OSError。

writable()

write

將指定的緩衝區寫入 IO 資料流程。

傳回寫入的位元組數目，一律是 b 以位元組為單位的長度。

如果緩衝區已滿，且基礎原始資料流程目前無法接受更多資料，則會引發 BlockingIOError。

write()

writelines

將行清單寫入資料流程。

不會新增行分隔符號，因此通常每個行在結尾都有一個行分隔符號。

writelines(lines, /)

參數

lines

必要

屬性

closed

length

name

uri