file.detach() 元のストリームを分離する
最終更新：2026-09-22
file.detach() 元のストリームを分離する
file.detach() は基盤となるバイナリバッファをテキストストリームから分離する；分離後、テキストストリームは再び使用できない。
| カテゴリ | ファイルメソッド |
|---|---|
| 種類 | 組み込み型メソッド |
| Python バージョン | all |
📝 構文
file.detach()戻り値：The separated underlying binary stream (e.g. FileIO); the text stream becomes unusable.
元のオブジェクトを変更するか：いいえ（新しいオブジェクトを返す）
💥 例外
ValueError— Raised when the stream is already detached or the raw stream has been used.UnsupportedOperation— Raised when the stream does not support detaching.
▶ 例
下のコードを編集し「実行」をクリックすると、出力パネルに結果が表示されます：
実行結果：
FileIO💡 関連するケース
さらに多くのケースは近日公開予定です。
❓ よくある質問
Qdetach() は何をしますか？
Aテキストストリームの基になるバイナリバッファを分離して返します。detach 後、テキストストリームは使用できなくなり、以降の操作は ValueError を投げます。
Qいつ使うべきですか？
A基になるバイナリオブジェクトへの直接操作が必要なときです。通常のケースでは不要で、日常の読み書きには with 文で十分です。
Qどのような場合に例外が発生しますか？
Aストリームがすでに detach されている、または基になるストリームがすでに使用されている（読み書きなど）場合に ValueError を投げます。detach をサポートしないストリームは UnsupportedOperation を投げます。
