Python Ms Windows

Python msvcrt



Python Msvcrt



これらの関数は、Windowsプラットフォームのいくつかの便利な機能へのアクセスを提供します。一部の高レベルモジュールは、これらの関数を使用して、サービスのWindows実装を構築します。たとえば、 getpass モジュールは、の実装でこれを使用します getpass（） 関数。

これらの関数の詳細については、PlatformAPIのドキュメントをご覧ください。



このモジュールは、コンソールI / OAPIの通常の文字とワイド文字の両方のバリアントを実装します。通常のAPIはASCII文字のみを扱い、国際化されたアプリケーションでの使用は制限されています。可能な限り、ワイド文字APIを使用する必要があります。

バージョン3.3で変更：このモジュールの操作により、 OSError どこ IOError 提起されました。



ファイル操作

msvcrt.locking（fd、mode、nbytes）

ファイル記述子に基づいてファイルの一部をロックする fd Cランタイムから。上げる OSError 失敗したとき。ファイルのロックされた領域は、現在のファイル位置から拡張されます。 nバイト バイトであり、ファイルの終わりを超えて続く場合があります。 モード のいずれかである必要があります以下にリストされているLK_ *定数。ファイル内の複数の領域を同時にロックすることはできますが、重複することはできません。隣接するリージョンはマージされません。個別にロックを解除する必要があります。

を上げる 監査イベント 引数付きのmsvcrt.lockingfd、モード、nバイト。

msvcrt.LK_LOCK
msvcrt.LK_RLCK

指定されたバイトをロックします。バイトをロックできない場合、プログラムは1秒後にすぐに再試行します。 10回試行した後、バイトをロックできない場合は、 OSError 上げられます。



msvcrt.LK_NBLCK
msvcrt.LK_NBRLCK

指定されたバイトをロックします。バイトをロックできない場合は、 OSError 上げられます。

msvcrt.LK_UNLCK

以前にロックされている必要がある指定されたバイトのロックを解除します。

msvcrt.setmode（fd、flags）

ファイル記述子の行末変換モードを設定します fd 。テキストモードに設定するには、 フラグ する必要があります os.O_TEXT ;バイナリの場合は、 os.O_BINARY 。

msvcrt.open_osfhandle（ハンドル、フラグ）

ファイルハンドルからCランタイムファイル記述子を作成します 取り持つ 。 NS フラグ パラメータはビット単位のORである必要があります os.O_APPEND 、 os.O_RDONLY 、 と os.O_TEXT 。返されたファイル記述子は、次のパラメータとして使用できます。 os.fdopen（） ファイルオブジェクトを作成します。

を上げる 監査イベント 引数付きのmsvcrt.open_osfhandle取り持つ、フラグ。

msvcrt.get_osfhandle（fd）

ファイル記述子のファイルハンドルを返します fd 。上げる OSError もしも fd 認識されません。

を上げる 監査イベント 引数付きのmsvcrt.get_osfhandlefd。

コンソールI / O

msvcrt.kbhit（）

戻るキー押下が読み取られるのを待っている場合はTrue。

msvcrt.getch（）

キー押下を読み取り、結果の文字をバイト文字列として返します。コンソールには何もエコーされません。キー押下がまだ利用できない場合、この呼び出しはブロックされますが、Enterが押されるのを待ちません。押されたキーが特別なファンクションキーだった場合、これは戻ります' 000'または' xe0';次の呼び出しはキーコードを返します。この機能では、Control-Cキーの押下を読み取ることはできません。

msvcrt.get（）

のワイド文字バリアント getch（） 、Unicode値を返します。

msvcrt.getche（）

に似ている getch（） 、ただし、印刷可能な文字を表す場合、キー押下はエコーされます。

msvcrt.getwche（）

のワイド文字バリアント getche（） 、Unicode値を返します。

msvcrt.putch（char）

バイト文字列を出力します char バッファリングせずにコンソールに。

msvcrt.putwch（unicode_char）

のワイド文字バリアント パッチ（） 、Unicode値を受け入れます。

msvcrt.ungetch（char）

バイト文字列を発生させる char コンソールバッファにプッシュバックされます。それはによって読まれる次の文字になります getch（） また getche（） 。

msvcrt.ungetwch（unicode_char）

のワイド文字バリアント ungetch（） 、Unicode値を受け入れます。

その他の機能

msvcrt.heapmin（）

強制するmalloc（）ヒープは、それ自体をクリーンアップし、未使用のブロックをオペレーティングシステムに返します。失敗すると、これは発生します OSError 。