string

Um tipo integrado de linguagem 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 os caracteres. Exemplos:

"bc" in "abcd"   # evaluates to True
x = [s for s.elems() in "abc"]  # x == ["a", "b", "c"]

A concatenação implícita de strings não é permitida. Use o operador +. Os operadores de comparação realizam uma comparação lexicográfica. Use == para testar a igualdade.

Participantes

• maiúsculas
• count
• elems (link em inglês)
• endswith
• localizar
• formato
• índice
• isalnum (em inglês)
• isalpha (link em inglês)
• isdigit
• islower
• isspace (link em inglês)
• istitle (link em inglês)
• isupper (link em inglês)
• join
• de redução
• lstrip (link em inglês)
• partição
• removeprefix
• removesuffix (em inglês)
• replace
• rfind (link em inglês)
• rindex (link em inglês)
• rpartition (link em inglês)
• rsplit.
• rstrip (link em inglês)
• split
• linhas de divisão
• startswith
• tira
• title
• superior

capitalizar

string string.capitalize()

Retorna uma cópia da string com o primeiro caractere (se houver) em maiúscula e o restante em letras 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, restringindo opcionalmente a [start:end], sendo start inclusivo e end exclusivo.

Parâmetros

Parâmetro	Descrição
sub	obrigatório A substring a ser contada.
start	int; or None; padrão = 0 Restringir à pesquisa nessa posição.
end	int; or None; default = None posição opcional antes da qual restringir a pesquisa.

Elems

sequence string.elems()

Retorna um valor iterável contendo substrings sucessivas com 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 termina com sub. Caso contrário, retorna "False", restringindo opcionalmente a [start:end], sendo start inclusivo e end exclusivo.

Parâmetros

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

localizar

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

Retorna o primeiro índice em que sub é encontrado, ou -1 se esse índice não existir, 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; or None; padrão = 0 Restringir à pesquisa nessa posição.
end	int; or None; default = None posição opcional antes da qual restringir a pesquisa.

formato

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

Realizar interpolação de string. As strings de formato contêm campos de substituição cercados por chaves {}. Tudo o que não estiver entre chaves é considerado texto literal e copiado sem alterações na saída.Se você precisar incluir um caractere de chave no texto literal, ele poderá ser escapado dobrando: {{ e }}Um campo substituto 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	default = () Lista de argumentos.
kwargs	default = {} Dicionário de argumentos.

index

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, opcionalmente restringindo [start:end]start a ser inclusivo e end ser exclusivo.

Parâmetros

Parâmetro	Descrição
sub	obrigatório A substring a ser encontrada.
start	int; or None; padrão = 0 Restringir à pesquisa nessa posição.
end	int; or None; default = 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 com maiúsculas 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 letras maiúsculas e minúsculas e contém pelo menos um caractere. Isso significa que todos os caracteres maiúsculos e minúsculos precisam vir depois de um caractere não maiúscula (por exemplo, espaço em branco).

isupper

bool string.isupper()

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

join

string string.join(elements)

Retorna uma string na qual os elementos da 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 que serão mesclados.

de redução nos custos

string string.lower()

Retorna a versão em letras minúsculas dessa 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 serão removidas:

"abcba".lstrip("ba") == "cba"

Parâmetros

Parâmetro	Descrição
chars	string; or None; default = 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 do formulário (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, vai retornar uma nova string com o prefixo removido. Caso contrário, retorna a string.

Parâmetros

Parâmetro	Descrição
prefix	obrigatório O prefixo que será removido, se estiver 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	obrigatório 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 maxsplit.

Parâmetros

Parâmetro	Descrição
old	obrigatório A string a ser substituída.
new	obrigatório A string pela qual substituir.
count	default = -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 esse índice não existir, 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; or None; padrão = 0 Restringir à pesquisa nessa posição.
end	int; or None; default = 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 esse índice não existir, opcionalmente restringindo 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; or None; padrão = 0 Restringir à pesquisa nessa posição.
end	int; or None; default = 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 do formulário (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.

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 para maxsplit. Exceto pela divisão a partir da direita, esse método se comporta como split().

Parâmetros

Parâmetro	Descrição
sep	obrigatório A string a ser dividida.
maxsplit	int; or None; 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; or None; default = 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 para maxsplit.

Parâmetros

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

splitlines

sequence string.splitlines(keepends=False)

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

Parâmetros

Parâmetro	Descrição
keepends	default = False Define 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", restringindo opcionalmente a [start:end], sendo start inclusivo e end exclusivo.

Parâmetros

Parâmetro	Descrição
sub	string; or tuple of strings; obrigatório O prefixo (ou tupla de prefixos alternativos) a ser correspondido.
start	int; or None; default = 0 Teste começando nessa posição.
end	int; or None; default = None Interrompe 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; or None; default = 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 e as restantes em minúsculas. Nesse contexto, uma palavra significa estritamente uma sequência de letras. Esse método não é compatível com caracteres Unicode complementares.

upper

string string.upper()

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