streamWrapper::stream_read

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::stream_read — 從串流讀取

說明

public streamWrapper::stream_read(int $count): string|false

這個方法會在呼叫 fread() 和 fgets() 時被呼叫。

注意:
請記得更新串流的讀/寫位置（根據成功讀取的位元組數）。

參數

count: 應從目前位置返回多少位元組的資料。

回傳值

如果可用的位元組數少於 count，則應返回盡可能多的可用位元組數。如果沒有更多可用資料，則應返回空字串。若要表示讀取失敗，應返回 false。

錯誤/例外

如果呼叫此方法失敗（例如：未實作），則會發出 E_WARNING 錯誤。

注意:
如果回傳值長度超過 count，將會發出 E_WARNING 錯誤，且多餘的資料將會遺失。

注意事項

注意:
在呼叫 streamWrapper::stream_read() 之後會直接呼叫 streamWrapper::stream_eof() 來檢查是否已到達檔案結尾（EOF）。如果未實作，則假設已到達檔案結尾（EOF）。

警告

當讀取整個檔案時（例如，使用 file_get_contents()），PHP 會在迴圈中呼叫 streamWrapper::stream_read()，然後呼叫 streamWrapper::stream_eof()，但只要 streamWrapper::stream_read() 返回非空字串，streamWrapper::stream_eof() 的回傳值就會被忽略。

另請參閱

fread() - 二進位安全檔案讀取
fgets() - 從檔案指標取得一行

發現問題了嗎？

瞭解如何改進此頁面 • 提交 Pull Request • 回報錯誤

＋新增註解

使用者貢獻的註解

此頁面沒有使用者貢獻的註解。