Todos los archivos de Bazel

Informar un problema . . Por la noche · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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

Miembros

abdominales

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 (interno o flotante)

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.

diccionario

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 tienen cada 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 obligatorio
El objeto que se va a comprobar.

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 obligatorio
secuencia de entrada.
start el valor predeterminado es 0
índice de inicio.

desaprobado

None fail(msg=None, attr=None, sep=" ", *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.
sep el valor predeterminado es " "
Cadena de separador entre los objetos. El valor predeterminado es un espacio (" ").
args obligatorio
Una lista de valores, con el formato de debugPrint (que es equivalente a str de forma predeterminada) y unidos con sep (el valor predeterminado es “ ”), 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
Valor que se va a 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 obligatorio
El struct al que se accede al atributo.
name obligatorio
Es el nombre del atributo struct.
default el valor predeterminado es unbound
El 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 obligatorio
El objeto que se va a comprobar.
name obligatorio
Es 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 obligatorio
Valor de cadena para generar un 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. esto es para evitar confusiones entre octal y 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 obligatorio
Cadena que se va a convertir
base el valor predeterminado es unbound
La base utilizada 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
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á.

máx.

unknown max(key=None, *args)

Muestra el mayor de todos los argumentos especificados. Si solo se proporciona un argumento posicional, este debe ser un iterable que no esté vacío.Es un error si los elementos no son comparables (por ejemplo, int con string) o si no se proporcionan argumentos.
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 Descripción
key que se puede llamar; o None; el valor predeterminado es None
Una función opcional que se aplica a cada elemento antes de la comparación.
args obligatorio
Elementos que se deben comprobar.

min

unknown min(key=None, *args)

Muestra el más pequeño de todos los argumentos especificados. Si solo se proporciona un argumento posicional, 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
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 Descripción
key que se puede llamar; o None; el valor predeterminado es None
Una función opcional que se aplica a cada elemento antes de la comparación.
args obligatorio
Elementos que se deben comprobar.

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 " "
Cadena de separador entre los objetos. El valor predeterminado es un espacio (" ").
args obligatorio
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 parada; de lo contrario, el valor de parada y el inicio real es 0
stop_or_none int; o None; el valor predeterminado es None
índice opcional del primer elemento que no se incluirá en la lista resultante generación de la lista se detiene antes de que se alcance 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 obligatorio
El objeto que se 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 cualquier par de elementos x, y no se puede comparar mediante x < s. 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]
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 Descripción
iterable obligatorio
La secuencia iterable para ordenar.
key que se puede llamar; o None; el valor predeterminado es None
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 obligatorio
El objeto que se 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 obligatorio
El objeto del que se va a comprobar 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 obligatorio
listas para comprimir.