string

Informar um problema Mostrar fonte

Um tipo integrado de linguagem que aceita 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 iteráveis diretamente. Use o método .elems() para iterar nos caracteres delas. Exemplos:
"bc" in "abcd"   # evaluates to True
x = [c for c in "abc".elems()]  # x == ["a", "b", "c"]
A concatenação implícita de strings não é permitida. Em vez disso, use o operador +. Os operadores de comparação realizam uma comparação lexicográfica. Use == para testar a igualdade.

Participantes

capitalizar

string string.capitalize()

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

count

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

Retorna o número de ocorrências (não sobrepostas) da substring sub na string, com a opção de restrição a [start:end], com 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
Restringir a pesquisa a partir desta posição.
end int; ou None; o padrão é a posição opcional None
antes da qual restringir para a pesquisa.

Elems

sequence string.elems()

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

endswith

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

Retorna "True" se a string termina com sub. Caso contrário, retorna "False", opcionalmente restringindo a [start:end], start sendo inclusivo e end sendo exclusivo.

Parâmetros

Parâmetro Descrição
sub string ou tuple de strings; obrigatório
O sufixo (ou tupla de sufixos alternativos) a corresponder.
start int; ou None; o padrão é 0
Teste começando nessa posição.
end int; ou None; o padrão é a posição opcional None
em que a comparação será interrompida.

find

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

Retorna o primeiro índice onde sub é encontrado, ou -1 se esse índice não existir, opcionalmente restringindo a [start:end], start sendo inclusivo e end sendo exclusivo.

Parâmetros

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

formato

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

Realizar a interpolação de strings. As strings de formato contêm campos de substituição entre chaves {}. Tudo o que não estiver contido entre chaves é considerado texto literal, que é copiado sem alterações na saída.Se você precisar incluir um caractere de chave no texto literal, ele pode ser escapado 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 esse índice não existir, restringindo opcionalmente a inclusão de [start:end]start e a de exclusão de end.

Parâmetros

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

isalnum

bool string.isalnum()

Retorna Verdadeiro 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 da string são alfabéticos ([a-zA-Z]) e há pelo menos um caractere.

isdigit

bool string.isdigit()

Retorna "True" se todos os caracteres na string são dígitos ([0-9]) e há pelo menos um caractere.

islower

bool string.islower()

Retorna "True" se todos os caracteres maiúsculos na string são minúsculos e há pelo menos um caractere.

isspace

bool string.isspace()

Retorna "True" se todos os caracteres são caracteres de espaço em branco e a string contém pelo menos um caractere.

istitle

bool string.istitle()

Retorna "True" se a string está com a primeira letra maiúscula e contém pelo menos um caractere. Isso significa que todos os caracteres maiúsculos precisam vir depois de letras maiúsculas e minúsculas (por exemplo, espaços em branco) e todos os caracteres minúsculos precisam vir depois (por exemplo, letras maiúsculas ou minúsculas).

isupper

bool string.isupper()

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

join

string string.join(elements)

Retorna uma string na qual 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 obrigatório
Os objetos a serem mesclados.

de redução nos custos

string string.lower()

Retorna a versão em letras minúsculas da 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. Observe que 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 nenhum.

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 do formato (antes, separador, depois). Se a string de entrada não contiver o separador, a partição retornará (self, '', '').

Parâmetros

Parâmetro Descrição
sep obrigatório
A string a ser dividida.

removeprefix

string string.removeprefix(prefix)

Se a string começar com prefix, será retornada uma nova string sem o prefixo. Caso contrário, retorna a string.

Parâmetros

Parâmetro Descrição
prefix obrigatório
O prefixo a ser removido, se estiver presente.

removesuffix

string string.removesuffix(suffix)

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

Parâmetros

Parâmetro Descrição
suffix obrigatório
O sufixo a ser removido, se houver.

replace

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 onde sub é encontrado, ou -1 se esse índice não existir, opcionalmente restringindo a [start:end], start sendo inclusivo e end sendo exclusivo.

Parâmetros

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

rindex

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

Retorna o último índice em que sub é encontrado ou gera um erro caso esse índice não exista, com a opção de restrição a [start:end], com 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
Restringir a pesquisa a partir desta posição.
end int; ou None; o padrão é a posição opcional None
antes da qual restringir para 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 do formato (antes, separador, depois). Se a string de entrada não tiver o separador, rpartition retornará ('', '', self).

Parâmetros

Parâmetro Descrição
sep obrigatório
A string a ser dividida.

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 para a divisão pelo lado direito, esse método se comporta como split().

Parâmetros

Parâmetro Descrição
sep obrigatório
A string a ser dividida.
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 à direita que aparecem em chars são removidos. Observe que 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 nenhum.

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 a ser dividida.
maxsplit int; ou None; o padrão é None.
O número máximo de divisões.

splitlines

sequence string.splitlines(keepends=False)

Divida a string nos limites de linha ('\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ça com sub. Caso contrário, retorna "False", opcionalmente restringindo a [start:end], start sendo inclusivo e end sendo exclusivo.

Parâmetros

Parâmetro Descrição
sub string ou tuple de strings; obrigatório
O prefixo (ou tupla de prefixos alternativos) a serem correspondentes.
start int; ou None; o padrão é 0
Teste começando nessa posição.
end int; ou None; o padrão é None
Interrompa a comparação nessa posição.

strip

string string.strip(chars=None)

Retorna uma cópia da string em que os caracteres à esquerda ou à direita que aparecem em chars são removidos. Observe que chars não é um prefixo nem um sufixo: todas as combinações do valor dele 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 nenhum.

title

string string.title()

Converte a string de entrada em iniciais maiúsculas, ou seja, todas as palavras começam com uma letra maiúscula, enquanto as demais são minúsculas. Neste contexto, uma palavra significa estritamente uma sequência de letras. Esse método não aceita caracteres Unicode complementares.

upper

string string.upper()

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