Python Métodos de Texto

Um texto no Python vem com uma caixa de ferramentas: deixar tudo em maiúsculas, tirar os espaços que o usuário digitou sem querer, trocar uma palavra por outra, quebrar uma frase em palavras, procurar onde está o @ de um email. Essas ferramentas se chamam métodos, e você as usa com um ponto depois do texto: nome.upper(). Esta aula apresenta os mais usados, um de cada vez, com acentos e cedilha (que funcionam muito bem), e o erro que todo mundo comete: achar que o método muda o texto.

A ideia: o canivete do texto

Pense num canivete suíço: um objeto só, com várias ferramentas dobradas dentro (a faca, a tesoura, o abridor). Você não precisa ir buscar a tesoura em outro lugar; ela já vem com o canivete. Um texto do Python é assim: cada texto já traz as suas ferramentas, e você as "abre" com um ponto.

nome

O texto (ou a variável que guarda o texto) em que a ferramenta vai trabalhar.

.

O ponto quer dizer "a ferramenta deste texto…".

upper

O nome do método (em inglês, "de cima": as letras maiúsculas, que nas gráficas antigas ficavam na caixa de cima).

( )

Os parênteses usam a ferramenta, como numa função. Alguns métodos pedem informações dentro deles, como replace("pão", "bolo").

Um método é uma função que pertence a um tipo de valor. len(nome) é uma função comum, que serve para muitos tipos; nome.upper() é um método, que só os textos têm.

1. Maiúsculas e minúsculas

cidade = "São Luís do Maranhão"

print(cidade.upper())
print(cidade.lower())
print("joão da silva".title())
print("bom dia, ana".capitalize())
print("AÇÃO".lower())
print(cidade)

$ python3 maiusculas2.py
SÃO LUÍS DO MARANHÃO
são luís do maranhão
João Da Silva
Bom dia, ana
ação
São Luís do Maranhão

Repare em três coisas:

• Acentos e cedilha funcionam: ã vira Ã, í vira Í, Ç vira ç. Os textos do Python são Unicode, o padrão que tem as letras de todas as línguas.
• O title() não conhece o português: ele escreveu "Da" com maiúscula, e num nome brasileiro o costume é "João da Silva". Para nomes, use com cuidado.
• A última linha mostra cidade do jeito que era. Nenhum método mudou o texto. É o assunto da próxima seção.

2. O método não muda o texto: ele devolve um novo

Você aprendeu em Strings que textos são imutáveis. Então o upper() não tem como mudar o texto: ele fabrica um texto novo, em maiúsculas, e o devolve. Se você não guardar esse texto novo, ele se perde:

nome = "ana"
nome.upper()
print(nome)

nome = nome.upper()
print(nome)

$ python3 metodo-novo.py
ana
ANA

1. nome.upper() na linha 2 fabricou "ANA"… e ninguém guardou. O Python jogou fora.
2. Por isso, o primeiro print mostrou ana, ainda em minúsculas.
3. nome = nome.upper() fabrica "ANA" e guarda na variável nome. Agora sim.

3. strip(): limpando as pontas

Quando alguém digita o nome num formulário, é comum sobrar espaço no começo ou no fim. O strip() (em inglês, "descascar") tira os espaços das pontas. Os colchetes no exemplo estão ali só para você ver onde o texto começa e termina:

digitado = "   Ana Souza   "

print("[" + digitado + "]")
print("[" + digitado.strip() + "]")
print("[" + digitado.lstrip() + "]")
print("[" + digitado.rstrip() + "]")
print("...ola!!!".strip(".!"))

$ python3 strip.py
[   Ana Souza   ]
[Ana Souza]
[Ana Souza   ]
[   Ana Souza]
ola

• strip() tirou os espaços dos dois lados, mas não o espaço do meio, entre "Ana" e "Souza".
• lstrip() tira só da esquerda (left); rstrip(), só da direita (right).
• Com um texto dentro dos parênteses, ele tira esses caracteres das pontas, em vez de espaços: strip(".!") tirou os pontos e as exclamações.

O strip() também tira das pontas as quebras de linha e as tabulações (os \n e \t da aula Caracteres de Escape). Por isso ele é tão usado com o que vem do teclado e de arquivos.

4. Encadeando métodos

Como cada método devolve um texto, você pode chamar outro método logo em seguida, no resultado: é o encadeamento. O jeito clássico de conferir uma resposta digitada, sem ligar para espaços nem maiúsculas:

resposta = "  SIM  "

limpa = resposta.strip()
limpa = limpa.lower()
print(limpa)

print(resposta.strip().lower())
print(resposta.strip().lower() == "sim")

$ python3 encadear.py
sim
sim
True

resposta.strip().lower() se lê da esquerda para a direita: primeiro o strip() devolve "SIM"; depois o lower() trabalha nesse texto novo e devolve "sim". As duas formas (passo a passo, ou encadeada) dão o mesmo resultado.

resposta = "  Sim "
print(resposta == "sim")

resposta = "  Sim "
print(resposta.strip().lower() == "sim")

5. replace(): trocando pedaços

O replace() (em inglês, "substituir") troca um pedaço do texto por outro. Ele pede dois textos: o que procurar e o que pôr no lugar.

recado = "Comprar pão, pão doce e leite"

print(recado.replace("pão", "bolo"))
print(recado.replace("pão", "bolo", 1))
print(recado.replace(" e leite", ""))
print("86 99999-0000".replace(" ", "").replace("-", ""))
print(recado.replace("queijo", "requeijão"))

$ python3 replace.py
Comprar bolo, bolo doce e leite
Comprar bolo, pão doce e leite
Comprar pão, pão doce
86999990000
Comprar pão, pão doce e leite

replace("pão", "bolo")

Troca todos os "pão" por "bolo". Eram dois.

replace("pão", "bolo", 1)

O terceiro valor, opcional, limita quantas trocas fazer: só a primeira.

replace(" e leite", "")

Trocar por um texto vazio é o jeito de apagar um pedaço.

.replace(" ", "").replace("-", "")

Encadeado: apaga os espaços, depois os traços. Sobram só os algarismos do telefone.

replace("queijo", …)

Se o pedaço não existe, nada é trocado, e não dá erro: volta o texto igual.

placa = "Bolo de fuba: R$ 25"
print(placa)

placa = "Bolo de fuba: R$ 25"
print(placa.replace("fuba", "fubá"))

6. split(): quebrando em pedaços

O split() (em inglês, "dividir") faz o contrário do join() da aula Juntar e Repetir Textos: ele quebra o texto onde encontra um separador e devolve uma lista com os pedaços (as listas têm aula própria: Listas).

compras = "pão, leite, café"
print(compras.split(", "))

frase = "a Ana foi à feira"
print(frase.split())

data = "18/10/2026"
dia, mes, ano = data.split("/")
print(dia, mes, ano)
print(len(frase.split()))

$ python3 split.py
['pão', 'leite', 'café']
['a', 'Ana', 'foi', 'à', 'feira']
18 10 2026
5

• split(", ") quebrou onde havia vírgula e espaço. O separador some do resultado.
• split() sem nada nos parênteses quebra nos espaços (quantos houver): é o jeito de separar as palavras de uma frase.
• dia, mes, ano = data.split("/") guarda cada pedaço numa variável, de uma vez (a Atribuição Múltipla).
• len(frase.split()) conta as palavras da frase: 5.

7. Procurando: find(), index(), startswith(), endswith(), count()

O in da aula is e in responde "tem ou não tem?". Estes métodos respondem mais: onde está, se está no começo ou no fim, e quantas vezes aparece.

find() e index(): em que posição?

email = "ana.souza@email.com"

print(email.find("@"))
print(email.find("souza"))
print(email.find("gmail"))
print(email.index("@"))
print(email[:email.find("@")])

$ python3 find.py
9
4
-1
9
ana.souza

• find("@") devolve o índice onde o pedaço começa: o @ está na posição 9 (contando do zero, como em Índices e Fatias).
• find("souza") dá 4: a palavra começa no índice 4.
• Quando não acha, o find() devolve -1.
• index() faz a mesma busca, mas, quando não acha, dá erro (você vai ver em Quando dá errado).
• Junto com uma fatia, o find() recorta: email[:9] é tudo antes do @, o nome do usuário.

startswith() e endswith(): começa com? termina com?

arquivo = "foto-praia.jpg"

print(arquivo.startswith("foto"))
print(arquivo.endswith(".jpg"))
print(arquivo.endswith(".png"))
print(arquivo.endswith((".jpg", ".png")))
print("Foto".startswith("foto"))

$ python3 comeca.py
True
True
False
True
False

startswith é "começa com" (starts with), e endswith, "termina com" (ends with). São ótimos para conferir a extensão de um arquivo. Com vários textos entre parênteses duplos, endswith((".jpg", ".png")) pergunta "termina com algum destes?" (os parênteses de dentro formam uma tupla). E, como sempre, maiúsculas contam: "Foto" não começa com "foto".

count(): quantas vezes?

frase = "O rato roeu a roupa do rei de Roma"

print(frase.count("r"))
print(frase.count("R"))
print(frase.lower().count("r"))
print(frase.count("ro"))
print("banana".count("ana"))

$ python3 count.py
4
1
5
2
1

São 4 erres minúsculos e 1 maiúsculo (o de Roma); com tudo em minúsculas, 5. O count("ro") achou "roeu" e "roupa" (o "Ro" de Roma tem maiúscula). E a última linha tem uma pegadinha: "banana" tem "ana" duas vezes, sobrepostas (banana e banana), mas o count() só conta pedaços que não se sobrepõem: depois de achar o primeiro, ele continua a busca depois dele.

8. Perguntas sobre o texto: isdigit() e isalpha()

Os métodos que começam com is ("é…?") respondem True ou False sobre o texto inteiro:

print("2026".isdigit())
print("20,5".isdigit())
print("Ana".isalpha())
print("Ana Maria".isalpha())
print("ção".isalpha())
print("".isdigit())

$ python3 testes.py
True
False
True
False
True
False

• isdigit(): só tem algarismos? "2026" sim; "20,5" não, por causa da vírgula.
• isalpha(): só tem letras? "Ana" sim; "Ana Maria" não, por causa do espaço; "ção" sim: letras com acento e cedilha são letras.
• Texto vazio dá False: não tem algarismo nenhum.

Um uso comum é conferir, antes de converter com int(), se o que foi digitado é mesmo um número. A outra forma de fazer isso, mais completa, é a aula try e except.

Formas diferentes de fazer a mesma coisa

Quando dá errado

nome = "ana"
print(nome.upper)

$ python3 sem-parenteses.py
<built-in method upper of str object at 0x7fd6517949c0>

nome = "ana"
print(nome.uper())

$ python3 nome-errado.py
Traceback (most recent call last):
  File "/home/ana/nome-errado.py", line 2, in <module>
    print(nome.uper())
          ^^^^^^^^^
AttributeError: 'str' object has no attribute 'uper'. Did you mean: 'upper'?

print(upper("ana"))

$ python3 lower-variavel.py
Traceback (most recent call last):
  File "/home/ana/lower-variavel.py", line 1, in <module>
    print(upper("ana"))
          ^^^^^
NameError: name 'upper' is not defined. Did you mean: 'super'?

email = "ana.souza.email.com"
posicao = email.index("@")
print(posicao)

$ python3 index-erro.py
Traceback (most recent call last):
  File "/home/ana/index-erro.py", line 2, in <module>
    posicao = email.index("@")
ValueError: substring not found

preco = "R$ 10"
print(preco.replace(10, 12))

$ python3 replace-numero.py
Traceback (most recent call last):
  File "/home/ana/replace-numero.py", line 2, in <module>
    print(preco.replace(10, 12))
          ~~~~~~~~~~~~~^^^^^^^^
TypeError: replace() argument 1 must be str, not int

Referência rápida

Os métodos desta aula. A lista completa, com todos os métodos de texto, está em Métodos de String.

Exercícios

Missão final: o usuário do email

email = "ana.souza@email.com"
print(email)

email = "ana.souza@email.com"
usuario = email[:email.find("@")]
print(usuario.upper())

Resumo

• Um método é uma ferramenta do próprio texto, usada com ponto e parênteses: texto.upper().
• Os métodos não mudam o texto (ele é imutável): devolvem um texto novo. Guarde o resultado: nome = nome.strip().
• upper/lower/title/capitalize mudam maiúsculas, com acentos e cedilha funcionando; strip limpa as pontas; replace troca; split quebra numa lista.
• find diz onde (ou -1); index também, mas dá ValueError se não achar; startswith, endswith e count respondem "começa?", "termina?", "quantas vezes?".
• Métodos se encadeiam: resposta.strip().lower() == "sim".
• Nome errado dá AttributeError … Did you mean: 'upper'?; sem parênteses, aparece <built-in method …> em vez do resultado.