Todos os arquivos do Bazel

Informar um problema

Métodos disponíveis em todos os arquivos do Bazel, incluindo arquivos .bzl, BUILD, MODULE.bazel e WORKSPACE.

Participantes

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) a NaN, Inf ou Infinity, opcionalmente precedido por um sinal + ou -.
Qualquer outro valor causa um erro. Sem nenhum argumento, 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 a base - 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 que base é 2/8/16, <prefix> é opcional e pode ser 0b/0o/0x (ou equivalente, 0B/0O/0X), respectivamente. Se base for qualquer outro valor além dessas bases ou do valor especial 0, o prefixo precisa estar vazio. No caso em que base é 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. Se base 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).
Essa função vai falhar se 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 tuples, 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.