Repository navigation
fs.read documentation does not specify how to detect EOF condition #35363
Description
Activity
The docs probably implicitly assume familiarity with
man 2 readbut to not keep you in suspense any longer: you detect it by observing a short read (fewer bytes than you requested, possibly zero) but, caveat emptor, the next read can return more bytes if the file was modified concurrently.Documentation pull request welcome.
- added a commit that references this issue
on Oct 6, 2020 - added a commit that references this issue
on Jan 8, 2021
As far as I can tell, neither
fs.readnorFileHandle#readspecify how to detect when the end of a file has been reached, nor can I find this information elsewhere in thefsdocumentation.The
fs.createReadStreamimplementation suggests that the answer to this question is "whenbytesReadis 0", but this should be added to the documentation if that is indeed the correct way to detect this condition.