Participantes
- abs
- todos
- any
- bool
- dict
- dir
- enumerate
- falha
- float
- getattr (em inglês)
- hasattr (em inglês)
- hash (em inglês)
- int
- len
- list
- max
- min
- range
- repr
- revertido
- classificado
- str
- tuple
- tipo
- zip
abs
unknown abs(x)Retorna o valor absoluto de um número (um número não negativo com a mesma magnitude).
abs(-2.3) == 2.3
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
int; ou float;
obrigatório Um número (int ou flutuante) |
todas
bool all(elements)Retorna verdadeiro se todos os elementos forem avaliados como verdadeiros ou se a coleção estiver vazia. Os elementos são convertidos em booleanos usando a função bool.
all(["hello", 3, True]) == True all([-1, 0, 1]) == False
Parâmetros
Parâmetro | Descrição |
---|---|
elements
|
obrigatório Uma string ou uma coleção de elementos. |
qualquer um
bool any(elements)Retorna verdadeiro se pelo menos um elemento for avaliado como verdadeiro. Os elementos são convertidos em booleanos usando a função bool.
any([-1, 0, 1]) == True any([False, 0, ""]) == False
Parâmetros
Parâmetro | Descrição |
---|---|
elements
|
obrigatório Uma string ou uma coleção de elementos. |
bool
bool bool(x=False)Construtor para o tipo booleano. Ela retorna
False
se o objeto for None
, False
, uma string vazia (""
), o número 0
ou uma coleção vazia (por exemplo, ()
, []
). Caso contrário, retorna True
.
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
o padrão é False A variável a ser convertida. |
dict
dict dict(pairs=[], **kwargs)Cria um dicionário a partir de um argumento posicional opcional e um conjunto opcional de argumentos de palavras-chave. Caso a mesma chave seja fornecida várias vezes, o último valor será usado. As entradas fornecidas por argumentos de palavra-chave são consideradas depois das entradas fornecidas pelo argumento posicional.
Parâmetros
Parâmetro | Descrição |
---|---|
pairs
|
o padrão é [] Um dict ou um iterável cujos elementos têm comprimento 2 (chave, valor). |
kwargs
|
obrigatório Dicionário de entradas adicionais. |
dir
list dir(x)Retorna uma lista de strings: os nomes dos atributos e métodos do objeto de parâmetro.
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
obrigatório O objeto a ser verificado. |
enumerar
list enumerate(list, start=0)Retorna uma lista de pares (tuplas de dois elementos), com o índice (int) e o item da sequência de entrada.
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]
Parâmetros
Parâmetro | Descrição |
---|---|
list
|
sequência de entrada necessária. |
start
|
o padrão é 0 índice inicial. |
fail
None
fail(msg=None, attr=None, *args)
Faz com que a execução falhe com um erro.
Parâmetros
Parâmetro | Descrição |
---|---|
msg
|
o padrão é None Obsoleto: use argumentos posicionais. Esse argumento atua como um argumento posicional principal implícito. |
attr
|
string; ou None ;
o padrão é None Descontinuado. Faz com que um prefixo opcional contendo essa string seja adicionado à mensagem de erro. |
args
|
obrigatório Uma lista de valores, formatados com debugPrint (que é equivalente a str por padrão) e unidos com espaços, que aparece na mensagem de erro. |
float
float float(x=unbound)Retorna x como um valor flutuante.
- Se
x
já for um flutuante,float
a retornará inalterada. - Se
x
for um booleano,float
retornará 1.0 para True e 0.0 para False. - Se
x
for um inteiro,float
vai retornar o valor de ponto flutuante finito mais próximo de x ou um erro se a magnitude for muito grande. - Se
x
for uma string, ele precisará ser um literal de ponto flutuante válido ou ser igual (ignorando maiúsculas e minúsculas) aNaN
,Inf
ouInfinity
, opcionalmente precedido por um sinal+
ou-
.
float()
retorna 0,0.
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
o padrão é unbound O valor a ser convertido. |
Getattr
unknown getattr(x, name, default=unbound)Retorna o campo de struct com o nome informado, se houver. Caso contrário, ele retorna
default
(se especificado) ou gera um erro. getattr(x, "foobar")
é equivalente a x.foobar
.getattr(ctx.attr, "myattr") getattr(ctx.attr, "myattr", "mydefault")
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
obrigatório O struct cujo atributo é acessado. |
name
|
obrigatório O nome do atributo struct. |
default
|
padrão é unbound O valor padrão a ser retornado caso o struct não tenha um atributo com o nome fornecido. |
Hasattr
bool hasattr(x, name)Retorna "True" se o objeto
x
tem um atributo ou método do name
especificado. Caso contrário, "False". Exemplo:hasattr(ctx.attr, "myattr")
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
obrigatório O objeto a ser verificado. |
name
|
obrigatório O nome do atributo. |
jogo da velha
int hash(value)Retorna um valor de hash para uma string. Isso é calculado deterministicamente usando o mesmo algoritmo do
String.hashCode()
do Java, ou seja: s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]o hash de valores além das strings não é compatível no momento.
Parâmetros
Parâmetro | Descrição |
---|---|
value
|
obrigatório Valor de string a ser gerado com hash. |
int
int int(x, base=unbound)Retorna x como um valor int.
- Se
x
já for um int,int
o retornará sem alterações. - Se
x
for um booleano,int
retornará 1 para True e 0 para False. - Se
x
for uma string, ela precisa ter o formato<sign><prefix><digits>
.<sign>
é"+"
,"-"
ou está vazio (interpretado como positivo).<digits>
são uma sequência de dígitos de 0 abase
- 1, em que as letras de a a z (ou equivalente de A a Z) são usadas como dígitos para 10 a 35. No caso em quebase
é 2/8/16,<prefix>
é opcional e pode ser 0b/0o/0x (ou equivalente, 0B/0O/0X), respectivamente. Sebase
for qualquer outro valor além dessas bases ou do valor especial 0, o prefixo precisa estar vazio. No caso em quebase
é 0, a string é interpretada como um literal de número inteiro, no sentido de que uma das bases 2/8/10/16 é escolhida dependendo de qual prefixo, se houver. Sebase
for 0, nenhum prefixo será usado e houver mais de um dígito, o dígito inicial não poderá ser 0. Isso evita confusão entre octal e decimal. A magnitude do número representado pela string precisa estar dentro do intervalo permitido para o tipo int. - Se
x
for um valor flutuante,int
vai retornar o valor inteiro, arredondando para zero. Se x for não finito, ocorrerá um erro (NaN ou infinito).
x
for de qualquer outro tipo ou se o valor for uma string que não atende ao formato acima. Ao contrário da função int
do Python, essa função não permite argumentos zero nem espaços em branco irrelevantes para argumentos de string.Exemplos:
int("123") == 123 int("-123") == -123 int("+123") == 123 int("FF", 16) == 255 int("0xFF", 16) == 255 int("10", 0) == 10 int("-0x10", 0) == -16 int("-0x10", 0) == -16 int("123.456") == 123
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
obrigatório A string a ser convertida. |
base
|
o padrão é unbound A base usada para interpretar um valor de string. O padrão é 10. Precisa estar entre 2 e 36 (inclusive) ou 0 para detectar a base como se x fosse um literal de número inteiro. Esse parâmetro não poderá ser fornecido se o valor não for uma string.
|
len
int len(x)Retorna o tamanho de uma string, sequência (como uma lista ou um conjunto de dados), um dict ou outro iterável.
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
obrigatório O valor com o tamanho a ser informado. |
list
list list(x=[])Retorna uma nova lista com os mesmos elementos do valor iterável fornecido.
list([1, 2]) == [1, 2] list((2, 3, 2)) == [2, 3, 2] list({5: "a", 2: "b", 4: "c"}) == [5, 2, 4]
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
O padrão é [] O objeto a ser convertido. |
máx
unknown max(*args)Retorna o maior de todos os argumentos fornecidos. Se apenas um argumento for fornecido, ele precisará ser um iterável não vazio.É um erro se os elementos não forem comparáveis (por exemplo, int com string) ou se nenhum argumento for fornecido.
max(2, 5, 4) == 5 max([5, 6, 3]) == 6
Parâmetros
Parâmetro | Descrição |
---|---|
args
|
obrigatório Os elementos a serem verificados. |
min
unknown min(*args)Retorna o menor de todos os argumentos fornecidos. Se apenas um argumento for fornecido, ele precisará ser um iterável não vazio. É um erro se os elementos não são comparáveis (por exemplo, int com string) ou se nenhum argumento é fornecido.
min(2, 5, 4) == 2 min([5, 6, 3]) == 3
Parâmetros
Parâmetro | Descrição |
---|---|
args
|
obrigatório Os elementos a serem verificados. |
mostrar
None
print(sep=" ", *args)
Mostra args
como saída de depuração. Ela será prefixada com a string "DEBUG"
e o local (arquivo e número da linha) dessa chamada. A maneira exata em que os argumentos são convertidos em strings não é especificada e pode mudar a qualquer momento. Em particular, ele pode ser diferente e mais detalhado do que a formatação feita por str()
e repr()
.Não é recomendável usar print
no código de produção devido ao spam criado para os usuários. Para descontinuações, prefira um erro físico usando fail()
sempre que possível.
Parâmetros
Parâmetro | Descrição |
---|---|
sep
|
O padrão é " " A string do separador entre os objetos. O padrão é espaço (" "). |
args
|
obrigatório Os objetos a serem impressos. |
range
sequence range(start_or_stop, stop_or_none=None, step=1)Cria uma lista em que os itens vão de
start
para stop
, usando um incremento step
. Se um único argumento for fornecido, os itens vão variar de 0 a esse elemento.range(4) == [0, 1, 2, 3] range(3, 9, 2) == [3, 5, 7] range(3, 0, -1) == [3, 2, 1]
Parâmetros
Parâmetro | Descrição |
---|---|
start_or_stop
|
obrigatório Valor do elemento de início se a parada for fornecida. Caso contrário, o valor da parada e do início real será 0 |
stop_or_none
|
int; ou None ;
o padrão é None índice opcional do primeiro item não a ser incluído na lista resultante. A geração da lista é interrompida antes de stop ser alcançado.
|
step
|
o padrão é 1 O incremento (o padrão é 1). Ela pode ser negativa. |
Repr
string repr(x)Converte qualquer objeto em uma representação em string. Isso é útil para depuração.
repr("ab") == '"ab"'
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
obrigatório O objeto a ser convertido. |
anulou
list reversed(sequence)Retorna uma lista nova e descongelada que contém os elementos da sequência iterável original em ordem invertida.
reversed([3, 5, 4]) == [4, 5, 3]
Parâmetros
Parâmetro | Descrição |
---|---|
sequence
|
obrigatório A sequência iterável (por exemplo, lista) a ser revertida. |
ordenado
list sorted(iterable, *, key=None, reverse=False)Retorna uma nova lista classificada contendo todos os elementos da sequência iterável fornecida. Pode ocorrer um erro se qualquer par de elementos x, y não puder ser comparado usando x < y. Os elementos são classificados em ordem crescente, a menos que o argumento reverso seja True. Nesse caso, a ordem é decrescente. A classificação é estável: elementos iguais mantêm sua ordem relativa original.
sorted([3, 5, 4]) == [3, 4, 5]
Parâmetros
Parâmetro | Descrição |
---|---|
iterable
|
obrigatório A sequência iterável a ser classificada. |
key
|
o padrão é None Uma função opcional aplicada a cada elemento antes da comparação. |
reverse
|
O padrão é False Retorna os resultados em ordem decrescente. |
str
string str(x)Converte qualquer objeto em string. Isso é útil para depuração.
str("ab") == "ab" str(8) == "8"
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
obrigatório O objeto a ser convertido. |
tuple
tuple tuple(x=())Retorna uma tupla com os mesmos elementos do valor iterável fornecido.
tuple([1, 2]) == (1, 2) tuple((2, 3, 2)) == (2, 3, 2) tuple({5: "a", 2: "b", 4: "c"}) == (5, 2, 4)
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
O padrão é () O objeto a ser convertido. |
digitar
string type(x)Retorna o nome do tipo do argumento. Isso é útil para depuração e verificação de tipo. Exemplos:
type(2) == "int" type([1]) == "list" type(struct(a = 2)) == "struct"Esta função pode mudar no futuro. Para escrever um código compatível com Python e se preparar para o futuro, use-o somente para comparar valores de retorno:
if type(x) == type([]): # if x is a list
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
obrigatório O objeto que terá o tipo verificado. |
zip
list zip(*args)Retorna uma
list
de tuple
s, em que a tupla i-th contém o elemento i-th de cada uma das sequências ou iteráveis de argumentos. A lista tem o tamanho da entrada mais curta. Com um único argumento iterável, ela retorna uma lista de 1 tuplas. Sem argumentos, ela retorna uma lista vazia. Exemplos:zip() # == [] zip([1, 2]) # == [(1,), (2,)] zip([1, 2], [3, 4]) # == [(1, 3), (2, 4)] zip([1, 2], [3, 4, 5]) # == [(1, 3), (2, 4)]
Parâmetros
Parâmetro | Descrição |
---|---|
args
|
listas necessárias para compactar. |