Help on class file in module __builtin__:
class file(object)
| file(name[, mode[, buffering]]) -> file object
|
| Open a file. The mode can be ‘r‘, ‘w‘ or ‘a‘ for reading (default),
| writing or appending. The file will be created if it doesn‘t exist
| when opened for writing or appending; it will be truncated when
| opened for writing. Add a ‘b‘ to the mode for binary files.
| Add a ‘+‘ to the mode to allow simultaneous reading and writing.
| If the buffering argument is given, 0 means unbuffered, 1 means line
| buffered, and larger numbers specify the buffer size. The preferred way
| to open a file is with the builtin open() function.
| Add a ‘U‘ to mode to open the file for input with universal newline
| support. Any line ending in the input file will be seen as a ‘\n‘
| in Python. Also, a file so opened gains the attribute ‘newlines‘;
| the value for this attribute is one of None (no newline read yet),
| ‘\r‘, ‘\n‘, ‘\r\n‘ or a tuple containing all the newline types seen.
|
| ‘U‘ cannot be combined with ‘w‘ or ‘+‘ mode.
|
| Methods defined here:
|
| __delattr__(...)
| x.__delattr__(‘name‘) <==> del x.name
|
| __enter__(...)
| __enter__() -> self.
|
| __exit__(...)
| __exit__(*excinfo) -> None. Closes the file.
|
| __getattribute__(...)
| x.__getattribute__(‘name‘) <==> x.name
|
| __init__(...)
| x.__init__(...) initializes x; see help(type(x)) for signature
|
| __iter__(...)
| x.__iter__() <==> iter(x)
|
| __repr__(...)
| x.__repr__() <==> repr(x)
|
| __setattr__(...)
| x.__setattr__(‘name‘, value) <==> x.name = value
|
| close(...)
| close() -> None or (perhaps) an integer. Close the file.
|
| Sets data attribute .closed to True. A closed file cannot be used for
| further I/O operations. close() may be called more than once without
| error. Some kinds of file objects (for example, opened by popen())
| may return an exit status upon closing.
|
| fileno(...)
| fileno() -> integer "file descriptor".
|
| This is needed for lower-level file interfaces, such os.read().
|
| flush(...)
| flush() -> None. Flush the internal I/O buffer.
|
| isatty(...)
| isatty() -> true or false. True if the file is connected to a tty device.
|
| next(...)
| x.next() -> the next value, or raise StopIteration
|
| read(...)
| read([size]) -> read at most size bytes, returned as a string.
|
| If the size argument is negative or omitted, read until EOF is reached.
| Notice that when in non-blocking mode, less data than what was requested
| may be returned, even if no size parameter was given.
|
| readinto(...)
| readinto() -> Undocumented. Don‘t use this; it may go away.
|
| readline(...)
| readline([size]) -> next line from the file, as a string.
|
| Retain newline. A non-negative size argument limits the maximum
| number of bytes to return (an incomplete line may be returned then).
| Return an empty string at EOF.
|
| readlines(...)
| readlines([size]) -> list of strings, each a line from the file.
|
| Call readline() repeatedly and return a list of the lines so read.
| The optional size argument, if given, is an approximate bound on the
| total number of bytes in the lines returned.
|
| seek(...)
| seek(offset[, whence]) -> None. Move to new file position.
|
| Argument offset is a byte count. Optional argument whence defaults to
| 0 (offset from start of file, offset should be >= 0); other values are 1
| (move relative to current position, positive or negative), and 2 (move
| relative to end of file, usually negative, although many platforms allow
| seeking beyond the end of a file). If the file is opened in text mode,
| only offsets returned by tell() are legal. Use of other offsets causes
| undefined behavior.
| Note that not all file objects are seekable.
|
| tell(...)
| tell() -> current file position, an integer (may be a long integer).
|
| truncate(...)
| truncate([size]) -> None. Truncate the file to at most size bytes.
|
| Size defaults to the current file position, as returned by tell().
|
| write(...)
| write(str) -> None. Write string str to file.
|
| Note that due to buffering, flush() or close() may be needed before
| the file on disk reflects the data written.
|
| writelines(...)
| writelines(sequence_of_strings) -> None. Write the strings to the file.
|
| Note that newlines are not added. The sequence can be any iterable object
| producing strings. This is equivalent to calling write() for each string.
|
| xreadlines(...)
| xreadlines() -> returns self.
|
| For backward compatibility. File objects now include the performance
| optimizations previously implemented in the xreadlines module.
|
| ----------------------------------------------------------------------
| Data descriptors defined here:
|
| closed
| True if the file is closed
|
| encoding
| file encoding
|
| errors
| Unicode error handler
|
| mode
| file mode (‘r‘, ‘U‘, ‘w‘, ‘a‘, possibly with ‘b‘ or ‘+‘ added)
|
| name
| file name
|
| newlines
| end-of-line convention used in this file
|
| softspace
| flag indicating that a space needs to be printed; used by print
|
| ----------------------------------------------------------------------
| Data and other attributes defined here:
|
| __new__ = <built-in method __new__ of type object>
| T.__new__(S, ...) -> a new object with type S, a subtype of T
file(name[, mode[, buffering]])
Constructor function for the file type, described further in section File Objects. The constructor’s arguments are the same as those of the open() built-in function described below.
When opening a file, it’s preferable to use open() instead of invoking this constructor directly. file is more suited to type testing (for example, writing isinstance(f, file)).
中文说明:
读出一个文件的内容。
file()函数是2.2中新增的函数,它与open()函数一样,相当于open()的别名,不过比open()更直观一些。
lines = file(filename).readlines()
for line in lines:
print line
序号 方法及描述
1 file.close()
关闭文件。关闭后文件不能再进行读写操作。
2 file.flush()
刷新文件内部缓冲,直接把内部缓冲区的数据立刻写入文件, 而不是被动的等待输出缓冲区写入。
3 file.fileno()
返回一个整型的文件描述符(file descriptor FD 整型), 可以用在如os模块的read方法等一些底层操作上。
4 file.isatty()
如果文件连接到一个终端设备返回 True,否则返回 False。
5 file.next()
返回文件下一行。
6 file.read([size])
从文件读取指定的字节数,如果未给定或为负则读取所有。
7 file.readline([size])
读取整行,包括 "\n" 字符。
8 file.readlines([sizehint])
读取所有行并返回列表,若给定sizeint>0,返回总和大约为sizeint字节的行, 实际读取值可能比sizhint较大, 因为需要填充缓冲区。
9 file.seek(offset[, whence])
设置文件当前位置
10 file.tell()
返回文件当前位置。
11 file.truncate([size])
截取文件,截取的字节通过size指定,默认为当前文件位置。
12 file.write(str)
将字符串写入文件,没有返回值。
13 file.writelines(sequence)
向文件写入一个序列字符串列表,如果需要换行则要自己加入每行的换行符。