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 = 0Restringir à pesquisa nessa posição. |
end
|
int; or None ;
default = Noneposiçã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órioO sufixo (ou tupla de sufixos alternativos) a ser correspondido. |
start
|
int; or None ;
default = 0Teste começando nessa posição. |
end
|
int; or None ;
default = Noneposiçã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 = 0Restringir à pesquisa nessa posição. |
end
|
int; or None ;
default = Noneposiçã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 = 0Restringir à pesquisa nessa posição. |
end
|
int; or None ;
default = Noneposiçã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 = NoneOs 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 = 0Restringir à pesquisa nessa posição. |
end
|
int; or None ;
default = Noneposiçã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 = 0Restringir à pesquisa nessa posição. |
end
|
int; or None ;
default = Noneposiçã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 = NoneO 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 = NoneOs 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 = NoneO 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órioO prefixo (ou tupla de prefixos alternativos) a ser correspondido. |
start
|
int; or None ;
default = 0Teste começando nessa posição. |
end
|
int; or None ;
default = NoneInterrompe 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 = NoneOs 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.