os.writev() behaviour unpredictable when hitting file system full (28)

Bug report

os.writev() has an unpredictable behaviour when writing on a file system that becomes full:

For example:

try:
    fd=os.open(file,  os.O_WRONLY|os.O_CREAT|os.O_APPEND)
    result = os.writev(fd,iovtable[0:MAXIOV])
except OSError as e:
    ...
    # at this point result might return some bytes written (not necessarly corresponding to iov lengths, or even not be defined at all.

Your environment

centos 7.
Python 3.9 (but probably the same on 3.11)

This can easily be worked around by specifying in the documentation that os.writev() returns the actual number of bytes written in case of success, but the contents of the return value are unpredicatbale in case of errors.

从 os.writev() 的文档开始，检查其中目前如何描述返回值和 OSError 行为。将这些措辞与报告的文件系统已满情况进行比较；完成的标准是文档明确说明调用方在成功后和发生错误后可以依赖什么。