36.2.1 ファイル操作関連

36.2.1 ファイル操作関連

locking( fd, mode, nbytes): C 言語による実行時システムにおけるファイル記述子 fd に基づいて、ファイルの一部にロックをかけます。ロックされるファイルの領域は、現在のファイル位置から nbytes バイトで、ファイルの末端まで延長することができます。mode は以下に列挙する LK_* のいずれか一つでなければなりません。一つのファイルの複数の領域を同時にロックすることは可能ですが、領域が重複してはなりません。連接する領域をまとめて指定することはできません; それらの領域は個別にロック解除しなければなりません。

LK_LOCK
LK_RLCK: 指定されたバイト列にロックをかけます。指定領域がロックできなかった場合、プログラムは 1 秒後に再度ロックを試みます。10 回再試行した後でもロックをかけられない場合、IOError が送出されます。

LK_NBLCK
LK_NBRLCK: 指定されたバイト列にロックをかけます。指定領域がロックできなかった場合、IOError が送出されます。

LK_UNLCK: 指定されたバイト列のロックを解除します。指定領域はあらかじめロックされていなければなりません。

setmode( fd, flags): ファイル記述子 fd に対して、行末文字の変換モードを設定します。テキストモードに設定するには、flags を os.O_TEXT にします; バイナリモードにするには os.O_BINARY にします。

open_osfhandle( handle, flags): C 言語による実行時システムにおけるファイル記述子をファイルハンドル handle から生成します。flags パラメタは os.O_APPEND、 os.O_RDONLY、および os.O_TEXT をビット単位で OR したものになります。返されるファイル記述子は os.fdopen() でファイルオブジェクトを生成するために使うことができます。

get_osfhandle( fd): ファイル記述子 fd のファイルハンドルを返します。fd が認識できない場合、 IOError を送出します。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。