We're back after a server migration that caused effbot.org to fall over a bit harder than expected. Expect some glitches.

file.read

read( [size])

Read at most size bytes from the file (less if the read hits end of file (EOF) before obtaining size bytes). If the size argument is negative or omitted, read all data until EOF is reached. The bytes are returned as a string object.

An empty string is returned when EOF is encountered immediately. (For certain files, like ttys, it makes sense to continue reading after an EOF is hit.)

Note that this method may call the underlying C function fread() more than once in an effort to acquire as close to size bytes as possible. Also note that when in non-blocking mode, less data than what was requested may be returned, even if no size parameter was given.