函數(shù)名: write - 向文件描述字寫
摘要:
1 #include <unistd.h>
2 ssize_t write(int fd, const void* buf, size_t cnt);
描述:
write()把緩沖區(qū)中從buf起的cnt字節(jié)寫進(jìn)文件描述字fd所引用的文件當(dāng)中。POSIX要求,一個(gè)確定在write()返回后發(fā)生的read()調(diào)用會(huì)返回新的數(shù)據(jù)。注意,不是所有的系統(tǒng)都遵循POSIX標(biāo)準(zhǔn)。
返回值: 如果成功,返回寫入的字節(jié)數(shù)`ret'(非負(fù),0表示沒有字節(jié)寫入)。如果錯(cuò)誤,返回-1,同時(shí)errno置相應(yīng)位。
如果cnt為0并且fd引用一個(gè)常規(guī)文件(regular file),那么在檢測(cè)到如下錯(cuò)誤的時(shí)候write()將返回相應(yīng)的錯(cuò)誤號(hào);沒有檢測(cè)到錯(cuò)誤的時(shí)候,除返回0外不會(huì)有其他影響。如果cnt為0并且fd引用一個(gè)非常規(guī)文件,結(jié)果是未定義行為。
錯(cuò)誤號(hào): EAGAIN 用O_NONBLOCK選擇了非阻塞式I/O但寫動(dòng)作被阻塞。
EBADF fd不是一個(gè)有效的文件描述字或者沒有寫打開。
EFAULT buf在可訪問地址空間之外。
EFBIG 或者是嘗試寫入一個(gè)超出了規(guī)定長(zhǎng)度的文件,該長(zhǎng)度或者是實(shí)現(xiàn)定義的最大文件長(zhǎng)度,或者是進(jìn)程文件長(zhǎng)度限制。也可能是越過允許的最大文件偏移量進(jìn)行寫入。
EINTR 調(diào)用在寫入字節(jié)前被信號(hào)中斷。
EINVAL fd引用一個(gè)不可寫的設(shè)備;或該文件用O_DIRECT標(biāo)志位打開,但是buf指定的地址、cnt的值、或者當(dāng)前文件偏移量中存在不正確的對(duì)齊(align)
EIO 修改inode的時(shí)候遇到了底層I/O錯(cuò)誤
ENOSPC 存放fd所引用文件的設(shè)備中沒有足夠的空間存放數(shù)據(jù)。
EPIPE fd引用的管道(pipe)或者socket的讀端(reading reading)已被關(guān)閉。此情況發(fā)生時(shí),寫進(jìn)程會(huì)收到一個(gè)SIGPIPE信號(hào)。(因?yàn)檫M(jìn)程收到SIGPIPE的默認(rèn)行為是終止程序,所以僅當(dāng)程序捕獲、屏蔽或者忽略了該信號(hào)時(shí),此次寫調(diào)用的錯(cuò)誤值才可見。)
其他錯(cuò)誤也會(huì)發(fā)生,這取決于fd所引用的對(duì)象
規(guī)范: SVr4, BSD 4.3, POSIX.1-2001.
在SVr4下,write()調(diào)用會(huì)在任意點(diǎn)上被中斷,而不僅僅是在寫入任何數(shù)據(jù)前。
注意:
成功調(diào)用write()并不能保證數(shù)據(jù)別寫入fd所引用的設(shè)備,只是提交內(nèi)核。實(shí)際上,在一些存在bug的實(shí)現(xiàn)中,甚至不保證成功為數(shù)據(jù)預(yù)留所需空間。確保成功的唯一方法是在寫入所有數(shù)據(jù)后調(diào)用fsync。
參考:
close(2), fcntl(2), fsync(2), ioctl(2), lseek(2), open(2), pwrite(2), read(2), select(2), writev(2), fwrite(3)