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 iteráveis diretamente. Use o método
.elems()
para iterar os caracteres. 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. Use o operador
+
. Os operadores de comparação realizam uma comparação lexicográfica. Use ==
para testar a igualdade.
Membros
- capitalizar
- count
- elems (link em inglês)
- endswith
- localizar
- formato
- index
- isalnum
- isalpha
- isdigit
- islower (link em inglês)
- isspace
- istitle
- isupper
- join
- menor
- lstrip
- partição
- removeprefix
- removesuffix
- replace
- rfind (link em inglês)
- rindex
- rpartition (em inglês)
- rsplit
- rstrip
- split
- linhas de divisão
- começa com
- 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 minúsculas. Esse método não oferece suporte a 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-se opcionalmente a [start:end]
, sendo start
incluído e end
excluído.
Parâmetros
Parâmetro | Descrição |
---|---|
sub
|
string;
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 é None uma posição opcional antes da qual restringir para 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 Verdadeiro se a string terminar com
sub
. Caso contrário, retorna Falso, restringindo 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 Teste começando nessa posição. |
end
|
int; ou None
o padrão é None posição opcional na qual parar a comparação. |
localizar
int string.find(sub, start=0, end=None)Retorna o primeiro índice em que
sub
é encontrado ou -1 se nenhum índice existir. Opcionalmente, restringe a [start:end]
, sendo start
inclusivo e end
exclusivo.
Parâmetros
Parâmetro | Descrição |
---|---|
sub
|
string;
obrigatório A substring a ser encontrada. |
start
|
int ou None ;
o padrão é 0 Restringe a pesquisa a partir desta posição. |
end
|
int; ou None
o padrão é None uma posição opcional antes da qual restringir para 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 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. |
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, restringindo opcionalmente a [start:end]
start
como inclusiva e end
como exclusiva.
Parâmetros
Parâmetro | Descrição |
---|---|
sub
|
string;
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 é None uma posição opcional antes da qual restringir para 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 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 forem dígitos ([0-9]) e houver 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 cada caractere em maiúsculas precisa seguir um caractere sem distinção entre maiúsculas e minúsculas (por exemplo, espaço em branco) e cada caractere em minúsculas precisa seguir um caractere com distinção entre maiúsculas e minúsculas (por exemplo, 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.
agrupamento
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 que serão mesclados. |
de redução nos custos
string string.lower()Retorna a versão em letras 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 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 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
|
string;
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
|
string;
obrigatório O prefixo a ser removido, se estiver presente. |
removesuffix
string string.removesuffix(suffix)Se a string terminar com
suffix
, retornará uma nova string com o sufixo removido. Caso contrário, retorna a string.
Parâmetros
Parâmetro | Descrição |
---|---|
suffix
|
string:
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 count
.
Parâmetros
Parâmetro | Descrição |
---|---|
old
|
string;
obrigatório A string a ser substituída. |
new
|
string;
required A string a ser substituída. |
count
|
int;
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 nenhum índice existir. Opcionalmente, restringe a [start:end]
, sendo start
inclusivo e end
exclusivo.
Parâmetros
Parâmetro | Descrição |
---|---|
sub
|
string;
obrigatório A substring a ser encontrada. |
start
|
int ou None ;
o padrão é 0 Restringe a pesquisa a partir desta posição. |
end
|
int; ou None
o padrão é None uma posição opcional 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 se esse índice não existir, restringindo-o opcionalmente a [start:end]
, sendo start
inclusivo e end
exclusivo.
Parâmetros
Parâmetro | Descrição |
---|---|
sub
|
string;
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 é None uma posição opcional 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 formulário (antes, separador, depois). Se a string de entrada não contiver o separador, rpartition retornará ('', '', self).
Parâmetros
Parâmetro | Descrição |
---|---|
sep
|
string;
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 o separador, opcionalmente limitando 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
|
string;
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 finais que aparecem em
chars
são removidos. Observe que chars
não é um sufixo: todas as combinações do valor 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
|
string;
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)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
|
bool;
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 tupla de stringss
obrigatório O prefixo (ou tupla de prefixos alternativos) a serem correspondidos. |
start
|
int ou None ;
o padrão é 0 O teste começa nessa posição. |
end
|
int ou None ;
o padrão é None Interrompe a comparação nessa 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 letra maiúscula, ou seja, cada palavra começa com uma letra maiúscula, enquanto as demais são minúsculas. Nesse contexto, uma palavra significa estritamente uma sequência de letras. Esse método não aceita caracteres Unicode complementares.
superior
string string.upper()Retorna a versão em maiúsculas desta string.