File I/O is provided by simple wrappers around standard POSIX functions. To
use this module do require('fs'). All the methods have asynchronous and
synchronous forms.
文件的I/O是由标准POSIX函数封装而成。需要使用require('fs')访问这个模块。所有的方法都提供了异步和同步两种方式。
The asynchronous form always take a completion callback as its last argument.
The arguments passed to the completion callback depend on the method, but the
first argument is always reserved for an exception. If the operation was
completed successfully, then the first argument will be null or undefined.
异步形式下，方法的最后一个参数需要传入一个执行完成时的回调函数。传给回调函数的参数取决于具体的异步方法，但第一个参数总是保留给异常对象。如果操作成功，那么该异常对象就变为null或者undefined。
Here is an example of the asynchronous version:
这里是一个异步调用的例子：
var fs = require('fs');
fs.unlink('/tmp/hello', function (err) {
if (err) throw err;
console.log('successfully deleted /tmp/hello');
});Here is the synchronous version:
这里是进行相同操作的同步调用的例子：
var fs = require('fs');
fs.unlinkSync('/tmp/hello')
console.log('successfully deleted /tmp/hello');With the asynchronous methods there is no guaranteed ordering. So the following is prone to error:
由于异步方法调用无法保证执行的顺序，所以下面的代码容易导致出现错误。
fs.rename('/tmp/hello', '/tmp/world', function (err) {
if (err) throw err;
console.log('renamed complete');
});
fs.stat('/tmp/world', function (err, stats) {
if (err) throw err;
console.log('stats: ' + JSON.stringify(stats));
});It could be that fs.stat is executed before fs.rename.
The correct way to do this is to chain the callbacks.
这样做有可能导致fs.stat在fs.rename之前执行，正确的做法是链式调用回调函数。
fs.rename('/tmp/hello', '/tmp/world', function (err) {
if (err) throw err;
fs.stat('/tmp/world', function (err, stats) {
if (err) throw err;
console.log('stats: ' + JSON.stringify(stats));
});
});In busy processes, the programmer is strongly encouraged to use the asynchronous versions of these calls. The synchronous versions will block the entire process until they complete--halting all connections.
当需要频繁操作时，强烈建议使用异步方法。同步方式在其完成之前将会阻塞当前的整个进程，即搁置所有连接。
Asynchronous rename(2). No arguments other than a possible exception are given to the completion callback.
异步调用rename(2)，重命名某个文件，除非回调函数执行过程出现了异常，否则不会传递任何参数。
Synchronous rename(2).
同步调用重命名rename(2)，重命名某个文件。
Asynchronous ftruncate(2). No arguments other than a possible exception are given to the completion callback.
异步调用ftruncate(2)，截断某个文件，除非回调函数执行过程出现了异常，否则不会传递任何参数。
Synchronous ftruncate(2).
同步调用重命名ftruncate(2)，截断某个文件s。
Asynchronous chmod(2). No arguments other than a possible exception are given to the completion callback.
异步调用chmod(2)，修改文件权限，除非回调函数执行过程出现了异常，否则不会传递任何参数。
Synchronous chmod(2).
同步调用chmod(2)，修改文件权限。
Asynchronous stat(2). The callback gets two arguments (err, stats) where
stats is a fs.Stats object. It looks like this:
异步调用stat(2)，读取文件元信息，回调函数将返回两个参数(err, stats)，其中stats是fs.Stats的一个对象，如下所示：
{ dev: 2049,
ino: 305352,
mode: 16877,
nlink: 12,
uid: 1000,
gid: 1000,
rdev: 0,
size: 4096,
blksize: 4096,
blocks: 8,
atime: '2009-06-29T11:11:55Z',
mtime: '2009-06-29T11:11:40Z',
ctime: '2009-06-29T11:11:40Z' }See the fs.Stats section below for more information.
有关详细信息，请参阅下面的fs.Stats部分
Asynchronous lstat(2). The callback gets two arguments (err, stats) where
stats is a fs.Stats object. lstat() is identical to stat(), except that if
path is a symbolic link, then the link itself is stat-ed, not the file that it
refers to.
异步形式调用lstat(2)，回调函数返回两个参数(err, stats)，其中stats是fs.Stats的一个对象，lstat()和stat()类似，区别在于当path是一个符号链接时，它指向该链接的属性，而不是所指向文件的属性.
Asynchronous fstat(2). The callback gets two arguments (err, stats) where
stats is a fs.Stats object.
异步形式调用fstat(2)，回调函数返回两个参数(err, stats)，其中stats是fs.Stats的一个对象。
Synchronous stat(2). Returns an instance of fs.Stats.
同步形式调用stat(2)，返回fs.Stats的一个实例。
Synchronous lstat(2). Returns an instance of fs.Stats.
同步形式调用lstat(2)，返回fs.Stats的一个实例。
Synchronous fstat(2). Returns an instance of fs.Stats.
同步形式调用fstatSync(2)，返回fs.Stats的一个实例。
Asynchronous link(2). No arguments other than a possible exception are given to the completion callback.
异步调用link(2)，创建符号连接，除非回调函数执行过程出现了异常，否则不会传递任何参数。
Synchronous link(2).
同步调用link(2)。
Asynchronous symlink(2). No arguments other than a possible exception are given to the completion callback.
异步调用symlink(2)，除非回调函数执行过程出现了异常，否则不会传递任何参数。
Synchronous symlink(2).
同步调用symlink(2)。
Asynchronous readlink(2). The callback gets two arguments (err,
resolvedPath).
异步调用readlink，回调函数返回两个参数(err,resolvedPath)，resolvedPath为解析后的文件路径。
Synchronous readlink(2). Returns the resolved path.
同步调用readlink(2)，返回解析后的文件路径。
Asynchronous realpath(2). The callback gets two arguments (err,
resolvedPath).
异步调用realpath(2)，回调函数返回两个参数(err,resolvedPath)，resolvedPath为解析后的文件路径。
Synchronous realpath(2). Returns the resolved path.
同步调用realpath(2)，返回解析后的文件路径。
Asynchronous unlink(2). No arguments other than a possible exception are given to the completion callback.
异步调用unlink(2)，删除链接或者文件，除非回调函数执行过程出现了异常，否则不会传递任何参数。
Synchronous unlink(2).
同步调用unlink(2)。
Asynchronous rmdir(2). No arguments other than a possible exception are given to the completion callback.
异步调用rmdir(2)，除非回调函数执行过程出现了异常，否则不会传递任何参数。
Synchronous rmdir(2).
同步调用rmdir(2)。
Asynchronous mkdir(2). No arguments other than a possible exception are given to the completion callback.
异步调用mkdir(2)，除非回调函数执行过程出现了异常，否则不会传递任何参数。
Synchronous mkdir(2).
同步调用mkdir(2)。
Asynchronous readdir(3). Reads the contents of a directory.
The callback gets two arguments (err, files) where files is an array of
the names of the files in the directory excluding '.' and '..'.
异步调用readdir(3)，读取目录中的内容。回调函数接受两个参数(err, files)，其中files参数是保存了目录中所有文件名的数组（'.'和'..'除外）。
Synchronous readdir(3). Returns an array of filenames excluding '.' and
'..'.
同步调用readdir(3)。返回目录中文件名数组('.'与'..'除外)。
Asynchronous close(2). No arguments other than a possible exception are given to the completion callback.
异步同步调用close(2)，关闭文件，除非回调函数执行过程出现了异常，否则不会传递任何参数。
Synchronous close(2).
同步调用close(2)。
Asynchronous file open. See open(2). Flags can be 'r', 'r+', 'w', 'w+', 'a',
or 'a+'. The callback gets two arguments (err, fd).
异步开启文件，详阅open(2)。标签可为'r', 'r+', 'w', 'w+', 'a', 或 'a+'。回调函数接受两个参数(err, fd)。
Synchronous open(2).
同步调用open(2)。
Change file timestamps.
更改文件时间戳。
Change file timestamps with the difference that if filename refers to a symbolic link, then the link is not dereferenced.
另一种更改文件时间戳的方式。区别在于如果文件名指向一个符号链接，则改变此符号链接的时间戳，而不改变所引用文件的时间戳。
Write buffer to the file specified by fd.
将buffer缓冲器内容写入fd文件描述符。
offset and length determine the part of the buffer to be written.
offset和length决定了将缓冲器中的哪部分写入文件。
position refers to the offset from the beginning of the file where this data
should be written. If position is null, the data will be written at the
current position.
See pwrite(2).
position指明将数据写入文件从头部算起的偏移位置，若position为null，数据将从当前位置开始写入，详阅pwrite(2)。
The callback will be given two arguments (err, written) where written
specifies how many bytes were written.
回调函数接受两个参数(err, written)，其中written标识有多少字节的数据已经写入。
Synchronous version of buffer-based fs.write(). Returns the number of bytes
written.
基于缓冲器的fs.write()的同步版本，返回写入数据的字节数。
Synchronous version of string-based fs.write(). Returns the number of bytes
written.
基于字符串的fs.write()的同步版本，返回写入数据的字节数。
Read data from the file specified by fd.
从fd文件描述符中读取数据。
buffer is the buffer that the data will be written to.
buffer为写入数据的缓冲器。
offset is offset within the buffer where writing will start.
offset为写入到缓冲器的偏移地址。
length is an integer specifying the number of bytes to read.
length指明了欲读取的数据字节数。
position is an integer specifying where to begin reading from in the file.
If position is null, data will be read from the current file position.
position为一个整形变量，标识从哪个位置开始读取文件，如果position参数为null，数据将从文件当前位置开始读取。
The callback is given the two arguments, (err, bytesRead).
回调函数接受两个参数，(err, bytesRead)。
Synchronous version of buffer-based fs.read. Returns the number of
bytesRead.
基于缓冲器的fs.read的同步版本，返回读取到的bytesRead字节数。
Synchronous version of string-based fs.read. Returns the number of
bytesRead.
基于字符串的fs.read的同步版本，返回已经读入的数据的字节数。
Asynchronously reads the entire contents of a file. Example:
异步读取一个文件的所有内容，例子如下：
fs.readFile('/etc/passwd', function (err, data) {
if (err) throw err;
console.log(data);
});The callback is passed two arguments (err, data), where data is the
contents of the file.
回调函数将传入两个参数(err, data)，其中data为文件内容。
If no encoding is specified, then the raw buffer is returned.
如果没有设置编码，那么将返回原始内容格式的缓冲器。
Synchronous version of fs.readFile. Returns the contents of the filename.
同步调用fs.readFile的版本，返回指定文件filename的文件内容。
If encoding is specified then this function returns a string. Otherwise it
returns a buffer.
如果设置了encoding参数，将返回一个字符串。否则返回一个缓冲器。
Asynchronously writes data to a file. data can be a string or a buffer.
异步写入数据到某个文件中，data可以是字符串或者缓冲器。
Example:
例子：
fs.writeFile('message.txt', 'Hello Node', function (err) {
if (err) throw err;
console.log('It\'s saved!');
});The synchronous version of fs.writeFile.
同步调用fs.writeFile的方式。
Watch for changes on filename. The callback listener will be called each
time the file is accessed.
监听指定文件filename的变化，回调函数listener将在每次该文件被访问时被调用。
The second argument is optional. The options if provided should be an object
containing two members a boolean, persistent, and interval, a polling
value in milliseconds. The default is { persistent: true, interval: 0 }.
第二个参数是可选项，如果指定了options参数，它应该是一个包含如下内容的对象：名为persistent的布尔值，和名为interval单位为毫秒的轮询时间间隔，默认值为{ persistent: true, interval: 0 }。
The listener gets two arguments the current stat object and the previous
stat object:
listener监听器将获得两个参数，分别标识当前的状态对象和改变前的状态对象。
fs.watchFile(f, function (curr, prev) {
console.log('the current mtime is: ' + curr.mtime);
console.log('the previous mtime was: ' + prev.mtime);
});These stat objects are instances of fs.Stat.
这些状态对象为fs.Stat的实例。
If you want to be notified when the file was modified, not just accessed
you need to compare curr.mtime and `prev.mtime.
如果你想在文件被修改而不是被访问时得到通知，你还需要比较curr.mtime和prev.mtime的值。
Stop watching for changes on filename.
停止监听文件filename的变化。
Objects returned from fs.stat() and fs.lstat() are of this type.
fs.stat()和 fs.lstat()方法返回的对象为此类型。
stats.isFile()stats.isDirectory()stats.isBlockDevice()stats.isCharacterDevice()stats.isSymbolicLink() (only valid with fs.lstat())
stats.isSymbolicLink() （仅对fs.lstat()有效）stats.isFIFO()stats.isSocket()ReadStream is a Readable Stream.
ReadStream是一个Readable Stream可读流。
Returns a new ReadStream object (See Readable Stream).
返回一个新的可读流对象（参见Readable Stream）。
options is an object with the following defaults:
options是包含如下默认值的对象：
{ flags: 'r',
encoding: null,
fd: null,
mode: 0666,
bufferSize: 64 * 1024
}options can include start and end values to read a range of bytes from
the file instead of the entire file. Both start and end are inclusive and
start at 0. When used, both the limits must be specified always.
如果不想读取文件的全部内容，可以在options参数中设置start和end属性值以读取文件中指定范围的内容。start和end包含在范围中（闭集合），取值从0开始。这两个参数需要同时设置。
An example to read the last 10 bytes of a file which is 100 bytes long:
一个例子演示了从一个长度为100字节的文件中读取最后10个字节：
fs.createReadStream('sample.txt', {start: 90, end: 99});WriteStream is a Writable Stream.
WriteStream为可写流。
function (fd) { }
fd is the file descriptor used by the WriteStream.
fd是可写流所使用的文件描述符。
Returns a new WriteStream object (See Writable Stream).
返回一个新的可写流对象（参见Writable Stream）。
options is an object with the following defaults:
options参数是包含如下默认值的对象：
{ flags: 'w',
encoding: null,
mode: 0666 }