Todos los archivos de Bazel

Informar un problema

Métodos disponibles en todos los archivos de Bazel, incluidos los archivos .bzl, BUILD, MODULE.bazel y WORKSPACE.

Miembros

abs

unknown abs(x)

Muestra el valor absoluto de un número (un número no negativo con la misma magnitud).
abs(-2.3) == 2.3

Parámetros

Parámetro Descripción
x int; o float; obligatorio
Un número (int o float)

todos

bool all(elements)

Muestra true si todos los elementos se evalúan como True o si la colección está vacía. Los elementos se convierten en booleanos usando la función bool.
all(["hello", 3, True]) == True
all([-1, 0, 1]) == False

Parámetros

Parámetro Descripción
elements obligatorio
Es una cadena o una colección de elementos.

cualquiera

bool any(elements)

Muestra true si al menos un elemento se evalúa como True. Los elementos se convierten en booleanos usando la función bool.
any([-1, 0, 1]) == True
any([False, 0, ""]) == False

Parámetros

Parámetro Descripción
elements obligatorio
Es una cadena o una colección de elementos.

bool

bool bool(x=False)

Constructor del tipo bool. Muestra False si el objeto es None, False, una cadena vacía (""), el número 0 o una colección vacía (p.ej., () o []). De lo contrario, muestra True.

Parámetros

Parámetro Descripción
x el valor predeterminado es False
La variable que se va a convertir.

dict

dict dict(pairs=[], **kwargs)

Crea un diccionario a partir de un argumento posicional opcional y un conjunto opcional de argumentos de palabras clave. Si se proporciona la misma clave varias veces, se usará el último valor. Se considera que las entradas proporcionadas mediante argumentos de palabras clave aparecen después de las entradas proporcionadas mediante el argumento posicional.

Parámetros

Parámetro Descripción
pairs el valor predeterminado es []
Un dict o un iterable cuyos elementos son de longitud 2 (clave, valor).
kwargs obligatorio
Diccionario de entradas adicionales.

dir

list dir(x)

Muestra una lista de cadenas: los nombres de los atributos y métodos del objeto del parámetro.

Parámetros

Parámetro Descripción
x required
El objeto que se debe verificar.

enumerar

list enumerate(list, start=0)

Muestra una lista de pares (tuplas de dos elementos), con el índice (int) y el elemento de la secuencia de entrada. 
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]

Parámetros

Parámetro Descripción
list secuencia de entrada
requerida.
start el valor predeterminado es el índice de inicio 0
.

desaprobado

None fail(msg=None, attr=None, *args)

Hace que la ejecución falle con un error.

Parámetros

Parámetro Descripción
msg el valor predeterminado es None
Obsoleto: usa argumentos posicionales en su lugar. Este argumento actúa como un argumento posicional inicial implícito.
attr string o None; el valor predeterminado es None
Obsoleto. Hace que un prefijo opcional que contenga esta cadena se agregue al mensaje de error.
args obligatorio
Una lista de valores, con el formato de debugPrint (que es equivalente a str de forma predeterminada) y unidos con espacios, que aparecen en el mensaje de error.

float

float float(x=unbound)

Muestra x como valor flotante.
  • Si x ya es un número de punto flotante, float lo muestra sin cambios.
  • Si x es un bool, float muestra 1.0 para True y 0.0 para False.
  • Si x es un int, float muestra el valor de punto flotante finito más cercano a x, o un error si la magnitud es demasiado grande.
  • Si x es una string, debe ser un literal de punto flotante válido o ser igual (sin distinguir entre mayúsculas y minúsculas) a NaN, Inf o Infinity, opcionalmente precedido por un signo + o -.
Cualquier otro valor genera un error. Sin argumentos, float() muestra 0.0.

Parámetros

Parámetro Descripción
x el valor predeterminado es unbound
El valor para convertir.

getattr

unknown getattr(x, name, default=unbound)

Muestra el campo del struct del nombre dado, si existe. De lo contrario, muestra default (si se especifica) o genera un error. getattr(x, "foobar") es igual a x.foobar.
getattr(ctx.attr, "myattr")
getattr(ctx.attr, "myattr", "mydefault")

Parámetros

Parámetro Descripción
x required
El struct al que se accede al atributo.
name required
Nombre del atributo struct.
default predeterminado es unbound
Valor predeterminado que se muestra en caso de que la struct no tenga un atributo con el nombre dado.

hasattr

bool hasattr(x, name)

Muestra el valor True si el objeto x tiene un atributo o método de la name especificada; de lo contrario, muestra False. Ejemplo:
hasattr(ctx.attr, "myattr")

Parámetros

Parámetro Descripción
x required
El objeto que se debe verificar.
name required
El nombre del atributo.

hash

int hash(value)

Muestra un valor de hash para una cadena. Esto se calcula de manera determinista con el mismo algoritmo que String.hashCode() de Java, es decir: 
s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]
Por el momento, no se admite el hash de valores además de las cadenas.

Parámetros

Parámetro Descripción
value required
Valor de cadena para el hash.

int

int int(x, base=unbound)

Muestra x como un valor int.
  • Si x ya es un int, int lo muestra sin cambios.
  • Si x es un bool, int muestra 1 para Verdadero y 0 para Falso.
  • Si x es una cadena, debe tener el formato <sign><prefix><digits>. <sign> es "+", "-" o está vacío (se interpreta como positivo). <digits> son una secuencia de dígitos del 0 al base -1, en la que las letras de la “a” a la “z” (o de la “A” a la “Z) se usan como dígitos del 10 al 35. En el caso en que base sea 2/8/16, <prefix> es opcional y puede ser 0b/0o/0x (o, de manera equivalente, 0B/0O/0X) respectivamente. Si base es cualquier otro valor además de estas bases o el valor especial 0, el prefijo debe estar vacío. En el caso en que base sea 0, la cadena se interpreta como un literal de número entero, en el sentido de que se elige una de las bases 2/8/10/16 según el prefijo que se usa. Si base es 0, no se usa ningún prefijo y hay más de un dígito, el dígito inicial no puede ser 0. De esta manera, se evita la confusión entre el octal y el decimal. La magnitud del número representado por la cadena debe estar dentro del rango permitido para el tipo int.
  • Si x es un número de punto flotante, int muestra el valor entero del número de punto flotante y se redondea hacia cero. Es un error si x no es finito (NaN o infinito).
Esta función falla si x es de cualquier otro tipo o si el valor es una string que no cumple con el formato anterior. A diferencia de la función int de Python, esta función no permite cero argumentos ni permite espacios en blanco irrelevantes para argumentos de cadena.

Ejemplos:

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 Descripción
x required
Es la cadena que se va a convertir.
base el valor predeterminado es unbound
La base que se usa para interpretar un valor de cadena; el valor predeterminado es 10. Debe estar entre 2 y 36 (inclusive), o 0 para detectar la base como si x fuera un literal de número entero. No se debe proporcionar este parámetro si el valor no es una cadena.

len

int len(x)

Muestra la longitud de una string, una secuencia (como una lista o una tupla), el dict o algún otro iterable.

Parámetros

Parámetro Descripción
x obligatorio
Es el valor cuya longitud se informará.

list

list list(x=[])

Muestra una lista nueva con los mismos elementos que el valor iterable determinado.
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 Descripción
x el valor predeterminado es []
El objeto que se convertirá.

max

unknown max(*args)

Muestra el mayor de todos los argumentos especificados. Si solo se proporciona un argumento, este debe ser un elemento iterable que no esté vacío.Si los elementos no son comparables (por ejemplo, int con string) o si no se proporcionan argumentos, se producirá un error. 
max(2, 5, 4) == 5
max([5, 6, 3]) == 6

Parámetros

Parámetro Descripción
args obligatorio
Los elementos que se deben verificar.

min

unknown min(*args)

Muestra el más pequeño de todos los argumentos especificados. Si solo se proporciona un argumento, este debe ser un iterable que no esté vacío. Es un error si los elementos no son comparables (por ejemplo, int con una string) o si no se proporcionan argumentos. 
min(2, 5, 4) == 2
min([5, 6, 3]) == 3

Parámetros

Parámetro Descripción
args obligatorio
Los elementos que se deben verificar.

imprimir

None print(sep=" ", *args)

Imprime args como resultado de depuración. Tendrá el prefijo de la cadena "DEBUG" y la ubicación (archivo y número de línea) de esta llamada. No se especificó la forma exacta en que los argumentos se convierten en cadenas y puede cambiar en cualquier momento. En particular, puede ser diferente (y más detallado) que el formato de str() y repr().

No se recomienda usar print en el código de producción debido al spam que crea para los usuarios. Para las bajas, es preferible que uses un error grave con fail() siempre que sea posible.

Parámetros

Parámetro Descripción
sep el valor predeterminado es " "
La cadena del separador entre los objetos; el valor predeterminado es un espacio (" ").
args requerido
Los objetos que se imprimirán.

rango

sequence range(start_or_stop, stop_or_none=None, step=1)

Crea una lista en la que los elementos van de start a stop, con un incremento de step. Si se proporciona un solo argumento, los elementos van desde 0 hasta ese 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 Descripción
start_or_stop obligatorio
Valor del elemento de inicio si se proporciona una parada; de lo contrario, el valor de la parada y el inicio real es 0
stop_or_none int o None; el valor predeterminado es un índice opcional None
del primer elemento que no se incluirá en la lista resultante; la generación de la lista se detiene antes de alcanzar el stop.
step el valor predeterminado es 1
El incremento (el valor predeterminado es 1). Puede ser negativa.

representante

string repr(x)

Convierte cualquier objeto en una representación de cadena. Esto es útil para la depuración.
repr("ab") == '"ab"'

Parámetros

Parámetro Descripción
x requerido
El objeto que se desea convertir.

Revertida

list reversed(sequence)

Muestra una lista nueva y descongelada que contiene los elementos de la secuencia iterable original en orden inverso.
reversed([3, 5, 4]) == [4, 5, 3]

Parámetros

Parámetro Descripción
sequence obligatorio
La secuencia iterable (p.ej., lista) que se revertirá.

ordenado

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

Muestra una lista ordenada nueva que contiene todos los elementos de la secuencia iterable proporcionada. Un error puede producirse si no se puede comparar cualquier par de elementos x, y mediante x < y. Los elementos se clasifican en orden ascendente, a menos que el argumento inverso sea True, en cuyo caso el orden es descendente. El orden es estable: los elementos que comparan por igual conservan su orden relativo original. 
sorted([3, 5, 4]) == [3, 4, 5]

Parámetros

Parámetro Descripción
iterable required
La secuencia iterable para ordenar.
key el valor predeterminado es None
Es una función opcional que se aplica a cada elemento antes de la comparación.
reverse el valor predeterminado es False.
Muestra los resultados en orden descendente.

str

string str(x)

Convierte cualquier objeto en una cadena. Esto es útil para la depuración.
str("ab") == "ab"
str(8) == "8"

Parámetros

Parámetro Descripción
x requerido
El objeto que se desea convertir.

tuple

tuple tuple(x=())

Muestra una tupla con los mismos elementos que el valor iterable determinado.
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 Descripción
x el valor predeterminado es ()
El objeto que se convertirá.

Tipo

string type(x)

Muestra el nombre de tipo de su argumento. Esto es útil para la depuración y la verificación de tipo. Ejemplos:
type(2) == "int"
type([1]) == "list"
type(struct(a = 2)) == "struct"
Esta función podría cambiar en el futuro. Si deseas escribir código compatible con Python y prepararte para el futuro, úsalo solo para comparar los valores que se devuelven: 
if type(x) == type([]):  # if x is a list

Parámetros

Parámetro Descripción
x required
El objeto del que se verificará el tipo.

zip

list zip(*args)

Muestra un list de tuple, en el que la tupla i-ésima contiene el elemento i-ésimo de cada una de las secuencias de argumentos o iterables. La lista tiene el tamaño de la entrada más corta. Con un solo argumento iterable, muestra una lista de 1-tuplas. Si no hay argumentos, se muestra una lista vacía. Ejemplos:
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 Descripción
args listas
obligatorias para comprimir.