string (original) (raw)

Report an issue View source Nightly ·8.2·8.1·8.0·7.6·7.5

Um tipo de linguagem integrado 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 = [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

• capitalize
• count
• elems
• endswith
• localizar
• formato
• index
• isalnum
• isalpha
• isdigit
• islower
• isspace
• istitle
• isupper
• join
• menor
• lstrip
• partição
• removeprefix
• removesuffix
• replace
• rfind
• rindex
• partição
• rsplit
• rstrip
• split
• splitlines
• startswith
• tira
• title
• superior

capitalizar

string string.capitalize()

Retorna uma cópia da string com o primeiro caractere (se houver) em maiúsculas 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

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

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

formato

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

Realize a interpolação de strings. As strings de formato contêm campos de substituição entre chaves {}. Qualquer coisa que não esteja contida entre chaves é considerada 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 com duplicação: {{ e }}. Um campo de substituição pode ser um nome, um número ou 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

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

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 contiver 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 em maiúsculas na string forem maiúsculos 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

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. chars não é um prefixo: todas as combinações do valor são removidas:

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

Parâmetros

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

removeprefix

string string.removeprefix(prefix)

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

Parâmetros

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

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

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

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

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

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

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 são removidas:

"abcbaa".rstrip("ab") == "abc"

Parâmetros

dividir

list string.split(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.

Parâmetros

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

startswith

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

Retorna Verdadeiro se a string começar com sub. Caso contrário, retorna Falso, restringindo opcionalmente a [start:end], sendo start inclusivo e end exclusivo.

Parâmetros

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

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 suplementares.

superior

string string.upper()

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