file.detach() Desanexa o fluxo bruto
Última atualização: 2026-09-22
file.detach() Desanexa o fluxo bruto
file.detach() separa o buffer binário subjacente do fluxo de texto; após a separação, o fluxo de texto não pode mais ser usado.
| Categoria | Métodos de Arquivo |
|---|---|
| Tipo | Método de tipo interno |
| Versão do Python | all |
📝 Sintaxe
file.detach()Retorno：The separated underlying binary stream (e.g. FileIO); the text stream becomes unusable.
Modifica o original：Não (retorna um novo objeto)
💥 Exceções
ValueError— Raised when the stream is already detached or the raw stream has been used.UnsupportedOperation— Raised when the stream does not support detaching.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
FileIO💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QO que faz detach()?
AEle separa e retorna o buffer binário subjacente do fluxo de texto; após a separação, o fluxo de texto não pode mais ser usado e novas operações lançam ValueError.
QQuando usar?
AUse quando você precisar de operações diretas sobre o objeto binário subjacente; em casos comuns não é necessário, e para leitura/gravação diárias a instrução with é suficiente.
QEm quais casos é lançada uma exceção?
AQuando o fluxo já foi separado ou o fluxo subjacente já foi usado (ex.: leitura/gravação), lança ValueError; fluxos que não suportam a separação lançam UnsupportedOperation.
