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