string

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6
Um tipo de linguagem incorporado para oferecer suporte a strings. Exemplos de literais de string:
a = 'abc\ndef'
b = "ab'cd"
c = """multiline string"""

# Strings support slicing (negative index starts from the end):
x = "hello"[2:4]  # "ll"
y = "hello"[1:-1]  # "ell"
z = "hello"[:4]  # "hell"# Slice steps can be used, too:
s = "hello"[::2] # "hlo"
t = "hello"[3:0:-1] # "lle"
As strings não são diretamente iteráveis. Use o método .elems() para iterar pelos caracteres delas. Exemplos:
"bc" in "abcd"   # evaluates to True
x = [c for c in "abc".elems()]  # x == ["a", "b", "c"]
 Não é permitida a concatenação implícita de strings. Use o operador +. Os operadores de comparação realizam uma comparação lexicográfica. Use == para testar a igualdade.

Membros

capitalizar

string string.capitalize()

Retorna uma cópia da string com o primeiro caractere (se houver) em maiúscula e o restante em minúscula. Esse método não aceita caracteres não ASCII.

contagem

int string.count(sub, start=0, end=None)

Retorna o número de ocorrências (não sobrepostas) da substring sub na string, restringindo opcionalmente a [start:end], start (inclusivo) e end (exclusivo).

Parâmetros

Parâmetro Descrição
sub obrigatório
A substring a ser contada.
start int ou None; o padrão é 0
Restringe a pesquisa a partir dessa posição.
end int ou None; o padrão é None
posição opcional antes da qual restringir a pesquisa.

elems

sequence string.elems()

Retorna um valor iterável que contém substrings sucessivas de um elemento da string. Equivalente a [s[i] for i in range(len(s))], exceto que o valor retornado pode não ser uma lista.

endswith

bool string.endswith(sub, start=0, end=None)

Retorna "True" se a string terminar com sub. Caso contrário, retorna "False". É possível restringir opcionalmente a [start:end], sendo start inclusivo e end exclusivo.

Parâmetros

Parâmetro Descrição
sub string ou tupla de strings; obrigatório
O sufixo (ou tupla de sufixos alternativos) a ser correspondido.
start int; ou None; o padrão é 0
O teste começa nessa posição.
end int ou None; o padrão é None
posição opcional em que parar de comparar.

localizar

int string.find(sub, start=0, end=None)

Retorna o primeiro índice em que sub é encontrado ou -1 se não houver esse índice. É possível restringir opcionalmente a [start:end], sendo start inclusivo e end exclusivo.

Parâmetros

Parâmetro Descrição
sub obrigatório
A substring a ser encontrada.
start int ou None; o padrão é 0
Restringe a pesquisa a partir dessa posição.
end int ou None; o padrão é None
posição opcional antes da qual restringir a pesquisa.

formato

string string.format(*args, **kwargs)

Realize a interpolação de strings. As strings de formato contêm campos de substituição entre chaves {}. Tudo o que não estiver entre chaves é considerado texto literal, que é copiado sem alterações para a saída. Se você precisar incluir um caractere de chave no texto literal, ele poderá ser ignorado duplicando: {{ e }}. Um campo de substituição pode ser um nome, um número ou estar vazio. Os valores são convertidos em strings usando a função str.
# Access in order:
"{} < {}".format(4, 5) == "4 < 5"
# Access by position:
"{1}, {0}".format(2, 1) == "1, 2"
# Access by name:
"x{key}x".format(key = 2) == "x2x"

Parâmetros

Parâmetro Descrição
args O padrão é ()
Lista de argumentos.
kwargs O padrão é {}
Dicionário de argumentos.

índice

int string.index(sub, start=0, end=None)

Retorna o primeiro índice em que sub é encontrado ou gera um erro se não houver esse índice. É possível restringir a [start:end]start (inclusivo) e end (exclusivo).

Parâmetros

Parâmetro Descrição
sub obrigatório
A substring a ser encontrada.
start int ou None; o padrão é 0
Restringe a pesquisa a partir dessa posição.
end int ou None; o padrão é None
posição opcional antes da qual restringir a pesquisa.

isalnum

bool string.isalnum()

Retorna True se todos os caracteres na string forem alfanuméricos ([a-zA-Z0-9]) e houver pelo menos um caractere.

isalpha

bool string.isalpha()

Retorna True se todos os caracteres na string forem alfabéticos ([a-zA-Z]) e houver pelo menos um caractere.

isdigit

bool string.isdigit()

Retorna True se todos os caracteres na string forem dígitos ([0-9]) e houver pelo menos um caractere.

islower

bool string.islower()

Retorna True se todos os caracteres em maiúsculas na string forem minúsculos e houver pelo menos um caractere.

isspace

bool string.isspace()

Retorna True se todos os caracteres forem espaços em branco e a string contiver pelo menos um caractere.

istitle

bool string.istitle()

Retorna True se a string estiver em maiúsculas e minúsculas e contiver pelo menos um caractere. Isso significa que todo caractere maiúsculo precisa seguir um sem maiúsculas (por exemplo, espaço em branco) e todo caractere minúsculo precisa seguir um com maiúsculas (por exemplo, maiúsculo ou minúsculo).

isupper

bool string.isupper()

Retorna True se todos os caracteres em maiúsculas na string forem maiúsculas e houver pelo menos um caractere.

agrupamento

string string.join(elements)

Retorna uma string em que os elementos de string do argumento foram unidos por essa string como um separador. Exemplo:
"|".join(["a", "b", "c"]) == "a|b|c"

Parâmetros

Parâmetro Descrição
elements required
Os objetos a serem unidos.

de redução nos custos

string string.lower()

Retorna a versão em minúsculas desta string.

lstrip

string string.lstrip(chars=None)

Retorna uma cópia da string em que os caracteres iniciais que aparecem em chars são removidos. chars não é um prefixo: todas as combinações do valor dele são removidas:
"abcba".lstrip("ba") == "cba"

Parâmetros

Parâmetro Descrição
chars string; ou None; o padrão é None
Os caracteres a serem removidos ou todos os espaços em branco se None.

partição

tuple string.partition(sep)

Divide a string de entrada na primeira ocorrência do separador sep e retorna a partição resultante como uma tupla de três elementos no formato (antes, separador, depois). Se a string de entrada não contiver o separador, a partição vai retornar (self, '', '').

Parâmetros

Parâmetro Descrição
sep obrigatório
A string em que será feita a divisão.

removeprefix

string string.removeprefix(prefix)

Se a string começar com prefix, vai retornar uma nova string com o prefixo removido. Caso contrário, retorna a string.

Parâmetros

Parâmetro Descrição
prefix required
O prefixo a ser removido, se presente.

removesuffix

string string.removesuffix(suffix)

Se a string terminar com suffix, vai retornar uma nova string com o sufixo removido. Caso contrário, retorna a string.

Parâmetros

Parâmetro Descrição
suffix required
O sufixo a ser removido, se presente.

substituir

string string.replace(old, new, count=-1)

Retorna uma cópia da string em que as ocorrências de old foram substituídas por new, restringindo opcionalmente o número de substituições a count.

Parâmetros

Parâmetro Descrição
old obrigatório
A string a ser substituída.
new obrigatório
A string a ser substituída.
count O padrão é -1
O número máximo de substituições. Se omitido ou se o valor for negativo, não haverá limite.

rfind

int string.rfind(sub, start=0, end=None)

Retorna o último índice em que sub é encontrado ou -1 se não houver esse índice, restringindo opcionalmente a [start:end], sendo start inclusivo e end exclusivo.

Parâmetros

Parâmetro Descrição
sub obrigatório
A substring a ser encontrada.
start int ou None; o padrão é 0
Restringe a pesquisa a partir dessa posição.
end int ou None; o padrão é None
posição opcional antes da qual restringir a pesquisa.

rindex

int string.rindex(sub, start=0, end=None)

Retorna o último índice em que sub é encontrado ou gera um erro se não houver esse índice, restringindo opcionalmente a [start:end], sendo start inclusivo e end exclusivo.

Parâmetros

Parâmetro Descrição
sub obrigatório
A substring a ser encontrada.
start int ou None; o padrão é 0
Restringe a pesquisa a partir dessa posição.
end int ou None; o padrão é None
posição opcional antes da qual restringir a pesquisa.

rpartition

tuple string.rpartition(sep)

Divide a string de entrada na última ocorrência do separador sep e retorna a partição resultante como uma tupla de três elementos da forma (antes, separador, depois). Se a string de entrada não contiver o separador, rpartition vai retornar ('', '', self).

Parâmetros

Parâmetro Descrição
sep obrigatório
A string em que será feita a divisão.

rsplit

list string.rsplit(sep, maxsplit=None)

Retorna uma lista de todas as palavras na string, usando sep como separador, limitando opcionalmente o número de divisões a maxsplit. Exceto pela divisão da direita, esse método se comporta como split().

Parâmetros

Parâmetro Descrição
sep obrigatório
A string em que será feita a divisão.
maxsplit int; ou None; o padrão é None
O número máximo de divisões.

rstrip

string string.rstrip(chars=None)

Retorna uma cópia da string em que os caracteres finais que aparecem em chars são removidos. chars não é um sufixo: todas as combinações do valor dele são removidas:
"abcbaa".rstrip("ab") == "abc"

Parâmetros

Parâmetro Descrição
chars string; ou None; o padrão é None
Os caracteres a serem removidos ou todos os espaços em branco se None.

dividir

list string.split(sep, maxsplit=None)

Retorna uma lista de todas as palavras na string, usando sep como separador, limitando opcionalmente o número de divisões a maxsplit.

Parâmetros

Parâmetro Descrição
sep obrigatório
A string em que será feita a divisão.
maxsplit int; ou None; o padrão é None
O número máximo de divisões.

splitlines

sequence string.splitlines(keepends=False)

Divide a string nos limites de linha ("\n", "\r\n", "\r") e retorna o resultado como uma nova lista mutável.

Parâmetros

Parâmetro Descrição
keepends O padrão é False
Indica se as quebras de linha precisam ser incluídas na lista resultante.

startswith

bool string.startswith(sub, start=0, end=None)

Retorna "True" se a string começar com sub. Caso contrário, retorna "False". É possível restringir opcionalmente a [start:end], sendo start inclusivo e end exclusivo.

Parâmetros

Parâmetro Descrição
sub string ou tupla de strings; obrigatório
O prefixo (ou tupla de prefixos alternativos) a ser correspondido.
start int; ou None; o padrão é 0
O teste começa nessa posição.
end int; ou None; o padrão é None
Pare de comparar nesta posição.

strip

string string.strip(chars=None)

Retorna uma cópia da string em que os caracteres iniciais ou finais que aparecem em chars são removidos. chars não é um prefixo nem um sufixo: todas as combinações do valor são removidas:
"aabcbcbaa".strip("ab") == "cbc"

Parâmetros

Parâmetro Descrição
chars string; ou None; o padrão é None
Os caracteres a serem removidos ou todos os espaços em branco se None.

título

string string.title()

Converte a string de entrada em letras maiúsculas, ou seja, cada palavra começa com uma letra maiúscula, enquanto as letras restantes são minúsculas. Nesse contexto, uma palavra significa estritamente uma sequência de letras. Esse método não é compatível com caracteres Unicode suplementares.

superior

string string.upper()

Retorna a versão em maiúsculas desta string.