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 "true" se todos os elementos são avaliados como "True" 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 um conjunto de elementos.

qualquer um

bool any(elements)

Retorna "true" se pelo menos um elemento for avaliado como "True". 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 um conjunto de elementos.

bool

bool bool(x=False)

Construtor para o tipo booleano. Ela retornará False se o objeto for None, False, uma string vazia (""), o número 0 ou uma coleção vazia (por exemplo, (), []). Caso contrário, retornará 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 é []
Um dict ou um iterável com elementos de 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 obrigatória.
start o padrão é o índice inicial 0
.

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 implícito inicial.
attr string; ou None; o padrão é None
. Uso suspenso. Faz com que um prefixo opcional que contenha essa string seja adicionado à mensagem de erro.
args obrigatório
Uma lista de valores, formatadas com debugPrint (que é equivalente a str por padrão) e unidas com espaços, que aparecem na mensagem de erro.

float

float float(x=unbound)

Retorna x como um valor flutuante.
  • Se x já for um ponto flutuante, float o retornará inalterado.
  • Se x for booleano, float retornará 1,0 para "True" e 0,0 para "False".
  • Se x for um int, float 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, 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 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 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 obrigatório
O struct com o atributo acessado.
name 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 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)

Retorne um valor de hash para uma string. Ela é calculada de forma determinista usando o mesmo algoritmo da String.hashCode() do Java, a saber: 
s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]
No momento, não há suporte para o hash de valores além das strings.

Parâmetros

Parâmetro Descrição
value 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 booleano, int retornará 1 para "True" e 0 para "False".
  • Se x for uma string, ela precisará 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, A a Z) são usadas como dígitos de 10 a 35. Quando 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 o valor especial 0, o prefixo precisa estar vazio. Quando base é 0, a string é interpretada como um literal inteiro, ou seja, uma das bases 2/8/10/16 é escolhida dependendo de qual prefixo, se houver, é usado. 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 é 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. Um erro será ocorrido se x não for finito (NaN ou infinito).
Essa função falhará se x for de qualquer outro tipo ou se o valor for uma string que não satisfaz o formato acima. Ao contrário da função int do Python, essa função não permite nenhum argumento nem espaço em branco externo 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 comprimento de uma string, sequência (como uma lista ou tupla), dict ou outro iterável.

Parâmetros

Parâmetro Descrição
x obrigatório
O valor que tem o tamanho a ser informado.

lista

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.

max

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

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

Parâmetros

Parâmetro Descrição
args Obrigatório
Os elementos a serem verificados.

mostrar

None print(sep=" ", *args)

Exibe 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 como os argumentos são convertidos em strings não é especificada e pode mudar a qualquer momento. Em particular, ela pode ser diferente e mais detalhada que a formatação feita por str() e repr().

O uso de print no código de produção não é recomendado devido ao spam criado para os usuários. Para descontinuações, prefira um erro grave usando fail() sempre que possível.

Parâmetros

Parâmetro Descrição
sep o padrão é " "
A string separadora entre os objetos. O padrão é um espaço (" ").
args Obrigatório
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 para 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 obrigatório
Valor do elemento inicial se a parada for informada. Caso contrário, o valor de parada e início real será 0.
stop_or_none int; ou None; o padrão é None
índice opcional do primeiro item que não 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). Ele pode ser negativo.

rep.

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 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 e y não for comparado usando x < y. Os elementos são classificados em ordem crescente, a menos que o argumento inverso seja True, caso em que a ordem é decrescente. A classificação é estável: elementos que se comparam iguais mantêm a 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 especificado.
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.

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"
esta função pode mudar no futuro. Para escrever um código compatível com Python e se preparar 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 tuples, em que a tupla i-ésima contém o elemento i-ésimo de cada uma das sequências de argumento ou iteráveis. A lista tem o tamanho da entrada mais curta. Com um único argumento iterável, ela retorna uma lista de tuplas únicas. 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.