Todos os arquivos do Bazel

Reportar um problema Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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

Membros

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 float)

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 a partir de um argumento posicional opcional e um conjunto opcional de argumentos de palavra-chave. No caso em que a mesma chave é 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 é []
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 de separação entre os objetos, o padrão é o espaço (" ").
args obrigatório
Uma lista de valores formatados com debugPrint (equivalente a str por padrão) e unidos com sep (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) 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 da struct do nome fornecido, se ele existir. 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 do struct.
default default é unbound
O valor padrão a ser retornado caso a struct não tenha um atributo com o nome especificado.

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 int.
  • Se x já for um int, int vai retornar o valor sem alterações.
  • Se x for um tipo bool, int vai retornar 1 para "True" e 0 para "False".
  • Se x for uma string, ela precisa 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 que base é 2/8/16, <prefix> é opcional e pode ser 0b/0o/0x (ou equivalentemente, 0B/0O/0X). Se o base for qualquer outro valor além dessas bases ou o valor especial 0, o prefixo precisará estar vazio. No caso em que base é 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. Se base 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 número flutuante, int vai retornar o valor inteiro do número flutuante, arredondando para zero. Ocorrerá um erro se x for não finito (NaN ou infinito).
Essa função falha 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 nulos e não permite 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 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), dicionário, conjunto 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 iterável; 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 precisa ser iterável e 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 vai ter o prefixo da 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 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 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 required
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 iterável; obrigatório
A sequência iterável (por exemplo, lista) a ser revertida.

set

set set(elements=[])

Experimental. Essa API é experimental e pode mudar a qualquer momento. Não dependa dele. Ele pode ser ativado de forma experimental definindo --experimental_enable_starlark_set.

Cria um novo conjunto, opcionalmente inicializado para conter os elementos de um iterável especificado.

Parâmetros

Parâmetro Descrição
elements O padrão é []
Um conjunto, uma sequência ou um dicionário.

ordenada

list sorted(iterable, key=None, *, reverse=False)

Retorna uma nova lista ordenada 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 iterável; obrigatório
A sequência iterável a ser classificada.
key callable 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 do 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 required
O objeto a ser verificado.

zip

list zip(*args)

Retorna um list de tuples, 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.