str.partition() Divide em três partes por sep
Última atualização: 2026-09-22
str.partition() Divide em três partes por sep
str.partition(sep) retorna uma tupla (before, sep, after); se sep não for encontrado, retorna (string original, '', '').
| Categoria | Métodos de string |
|---|---|
| Tipo | Método de tipo interno |
| Versão do Python | all |
📝 Sintaxe
str.partition(sep)
⚙️ Parâmetros
| sep Obrigatório | The separator substring to split at. |
|---|
Retorno:tuple. (head, sep, tail); if sep is absent, returns (string, '', '').
Modifica o original:Não (retorna um novo objeto)
💥 Exceções
ValueError— Raised when sep is an empty string.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída:
('a', '=', 'b=c')
('hello', '', '')
💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QO que é retornado quando o separador não é encontrado?
A(original_string, '', ''), sem lançar erro.
QQue tipo ele retorna?
AEle sempre retorna uma tupla de 3 elementos (before, sep, after). 'a=b=c'.partition('=') retorna ('a', '=', 'b=c'), dividindo apenas na primeira ocorrência.
QO que acontece quando sep é uma string vazia?
AUm ValueError: empty separator é lançado.
QQual é a diferença em relação a split()?
Apartition() divide uma vez, retorna uma tupla de 3 elementos e mantém o separador; split() divide várias vezes, retorna uma lista e descarta o separador.