Métodos disponíveis em todos os arquivos do Bazel, incluindo arquivos .bzl, BUILD, MODULE.bazel, VENDOR.bazel e WORKSPACE.
Membros
- abs
- todos
- qualquer um
- bool
- dict
- dir
- enumerar
- falha
- float
- getattr
- hasattr
- hash
- int
- len
- list
- max
- min
- Intervalo
- repr
- revertido
- ordenado
- str
- tupla
- type
- 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
|
required Uma string ou uma coleção de elementos. |
qualquer um
bool any(elements)Retorna "true" 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
|
required Uma string ou uma coleção de elementos. |
bool
bool bool(x=False)Construtor para o tipo bool. Ele 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, ele 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 com base em um argumento posicional opcional e um conjunto opcional de argumentos de palavra-chave. Quando a mesma chave é informada várias vezes, o último valor é 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 é [] Uma matriz ou um iterável cujos elementos têm comprimento 2 (chave, valor). |
kwargs
|
required 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
|
required 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
|
int;
o padrão é o índice inicial 0 . |
fail
None
fail(msg=None, attr=None, sep=" ", *args)
Faz com que a execução falhe com um erro.
Parâmetros
Parâmetro | Descrição |
---|---|
msg
|
O padrão é None Descontinuado: use argumentos posicionais. Esse argumento funciona como um argumento posicional principal implícito. |
attr
|
string ou None .
O padrão é None . Obsoleto. Faz com que um prefixo opcional que contém essa string seja adicionado à mensagem de erro. |
sep
|
string;
o padrão é " " A string separadora entre os objetos. O padrão é espaço (" "). |
args
|
obrigatório Uma lista de valores, formatadas com debugPrint (que é equivalente a str por padrão) e unidas com sep (o padrão é " "), que aparecem na mensagem de erro. |
float
float float(x=unbound)Retorna x como um valor de ponto flutuante.
- Se
x
já for um número flutuante,float
vai retornar o valor sem alterações. - Se
x
for um booleano,float
vai retornar 1,0 para "true" e 0,0 para "false". - Se
x
for um int,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, ela precisa 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 do struct com o nome fornecido, 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
|
required A estrutura cujo atributo é acessado. |
name
|
string;
obrigatório O nome do atributo struct. |
default
|
o padrão é unbound O valor padrão a ser retornado caso o struct não tenha um atributo com o nome determinado. |
hasattr
bool hasattr(x, name)Retorna "True" se o objeto
x
tiver um atributo ou método do name
fornecido. Caso contrário, retorna "False". Exemplo:hasattr(ctx.attr, "myattr")
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
required O objeto a ser verificado. |
name
|
string;
obrigatório O nome do atributo. |
jogo da velha
int hash(value)Retorna um valor hash para uma string. Isso é calculado de forma determinística usando o mesmo algoritmo do
String.hashCode()
do Java, ou seja: s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]No momento, não há suporte para hash de valores além de strings.
Parâmetros
Parâmetro | Descrição |
---|---|
value
|
string:
obrigatório valor de string para gerar hash. |
int
int int(x, base=unbound)Retorna x como um valor inteiro.
- Se
x
já for um int,int
o retornará inalterado. - Se
x
for um tipo bool,int
vai retornar 1 para "True" e 0 para "False". - Se
x
for uma string, ela precisará ter o formato<sign><prefix><digits>
.<sign>
é"+"
,"-"
ou vazio (interpretado como positivo).<digits>
são uma sequência de dígitos de 0 atébase
- 1, em que as letras a-z (ou, de forma equivalente, A-Z) são usadas como dígitos de 10 a 35. No caso em quebase
é 2/8/16,<prefix>
é opcional e pode ser 0b/0o/0x (ou equivalentemente, 0B/0O/0X). Se obase
for qualquer outro valor além dessas bases ou o valor especial 0, o prefixo precisará estar vazio. No caso em quebase
é 0, a string é interpretada como um literal inteiro, no sentido de que uma das bases 2/8/10/16 é escolhida dependendo do prefixo, se for usado. Sebase
for 0, nenhum prefixo será usado e, se houver mais de um dígito, o dígito inicial não poderá ser 0. Isso é para evitar 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 ponto flutuante,int
retornará o valor inteiro do ponto flutuante, arredondando até zero. Ocorrerá um erro se x for não finito (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 nulos nem espaços em branco extras 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
|
required 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 pode ser fornecido se o valor não for uma string.
|
len
int len(x)Retorna o comprimento de uma string, sequência (como uma lista ou tupla), dict ou outro iterável.
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
required O valor cujo comprimento 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
|
iterable;
o padrão é [] O objeto a ser convertido. |
max
unknown max(key=None, *args)Retorna o maior de todos os argumentos fornecidos. Se apenas um argumento posicional for fornecido, ele precisa ser um iterável não vazio.Será 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 max("two", "three", "four", key = len) =="three" # the longest max([1, -1, -2, 2], key = abs) == -2 # the first encountered with maximal key value
Parâmetros
Parâmetro | Descrição |
---|---|
key
|
callable ou None ;
o padrão é None . Uma função opcional aplicada a cada elemento antes da comparação. |
args
|
required Os elementos a serem verificados. |
min
unknown min(key=None, *args)Retorna o menor de todos os argumentos fornecidos. Se apenas um argumento posicional for fornecido, ele precisará ser um iterável não vazio. Será um erro se os elementos não forem comparáveis (por exemplo, int com string) ou se nenhum argumento for fornecido.
min(2, 5, 4) == 2 min([5, 6, 3]) == 3 min("six", "three", "four", key = len) == "six" # the shortest min([2, -2, -1, 1], key = abs) == -1 # the first encountered with minimal key value
Parâmetros
Parâmetro | Descrição |
---|---|
key
|
callable ou None ;
o padrão é None . Uma função opcional aplicada a cada elemento antes da comparação. |
args
|
required Os elementos a serem verificados. |
mostrar
None
print(sep=" ", *args)
Imprime args
como saída de depuração. Ele será prefixado 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, pode ser diferente (e mais detalhado) do formato feito por str()
e repr()
.Não é recomendável usar print
no código de produção devido ao spam que ele cria para os usuários. Para descontinuações, prefira um erro grave usando fail()
sempre que possível.
Parâmetros
Parâmetro | Descrição |
---|---|
sep
|
string:
o padrão é " " . A string de separação entre os objetos, o padrão é o espaço (" "). |
args
|
required Os objetos a serem impressos. |
período
sequence range(start_or_stop, stop_or_none=None, step=1)Cria uma lista em que os itens vão de
start
a stop
, usando um incremento step
. Se um único argumento for fornecido, os itens vão variar de 0 até 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
|
int;
obrigatório Valor do elemento de início, se "stop" for fornecido. Caso contrário, o valor de "stop" e o início real serão 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 .
|
step
|
int;
O padrão é 1 O incremento (padrão é 1). Ele pode ser negativo. |
repr
string repr(x)Converte qualquer objeto em uma representação de 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 nova lista descongelada que contém os elementos da sequência iterável original na ordem inversa.
reversed([3, 5, 4]) == [4, 5, 3]
Parâmetros
Parâmetro | Descrição |
---|---|
sequence
|
iterable;
obrigatório A sequência iterável (por exemplo, lista) a ser revertida. |
ordenada
list sorted(iterable, key=None, *, reverse=False)Retorna uma nova lista classificada contendo todos os elementos da sequência iterável fornecida. Um erro pode ocorrer 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 verdadeiro. Nesse caso, a ordem é decrescente. A ordenação é estável: elementos que são comparados como iguais mantêm a ordem relativa original.
sorted([3, 5, 4]) == [3, 4, 5] sorted([3, 5, 4], reverse = True) == [5, 4, 3] sorted(["two", "three", "four"], key = len) == ["two", "four", "three"] # sort by length
Parâmetros
Parâmetro | Descrição |
---|---|
iterable
|
iterable;
obrigatório A sequência iterável a ser classificada. |
key
|
chamável; ou None ; o padrão é None . Uma função opcional aplicada a cada elemento antes da comparação. |
reverse
|
bool;
o padrão é False Retorna 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
|
required 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
|
iterável;
o padrão é () O objeto a ser convertido. |
tipo
string type(x)Retorna o nome do tipo de seu argumento. Isso é útil para depuração e verificação de tipo. Exemplos:
type(2) == "int" type([1]) == "list" type(struct(a = 2)) == "struct"Essa função pode mudar no futuro. Para escrever código compatível com Python e estar preparado para o futuro, use-o apenas para comparar valores de retorno:
if type(x) == type([]): # if x is a list
Parâmetros
Parâmetro | Descrição |
---|---|
x
|
obrigatório O tipo de objeto que será verificado. |
zip
list zip(*args)Retorna um
list
de tuple
s, em que a tupla i contém o elemento i de cada uma das sequências de argumentos ou iteráveis. A lista tem o tamanho da entrada mais curta. Com um único argumento iterável, ele retorna uma lista de tuplas de 1. Sem argumentos, ele 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. |