Semua file Bazel

Laporkan masalah Malam · 7,3 · 7,2 · 7,1 · 7,0 · 6,5

Metode yang tersedia di semua file Bazel, termasuk file .bzl, BUILD, MODULE.bazel, dan WORKSPACE.

Anggota

abs

unknown abs(x)

Menampilkan nilai absolut dari sebuah angka (bilangan non-negatif dengan magnitudo yang sama).
abs(-2.3) == 2.3

Parameter

Parameter Deskripsi
x int; atau float; wajib
Angka (int atau float)

semua

bool all(elements)

Menampilkan true (benar) jika semua elemen bernilai True atau jika kumpulan kosong. Elemen dikonversi ke boolean menggunakan fungsi bool.
all(["hello", 3, True]) == True
all([-1, 0, 1]) == False

Parameter

Parameter Deskripsi
elements wajib
String atau kumpulan elemen.

apa pun

bool any(elements)

Menampilkan true (benar) jika setidaknya satu elemen bernilai True (Benar). Elemen dikonversi ke boolean menggunakan fungsi bool.
any([-1, 0, 1]) == True
any([False, 0, ""]) == False

Parameter

Parameter Deskripsi
elements wajib
String atau kumpulan elemen.

bool

bool bool(x=False)

Konstruktor untuk jenis bool. Metode ini menampilkan False jika objeknya adalah None, False, string kosong (""), angka 0, atau koleksi kosong (misalnya, (), []). Jika tidak, True akan ditampilkan.

Parameter

Parameter Deskripsi
x default adalah False
Variabel yang akan dikonversi.

dik

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

Membuat kamus dari argumen posisi opsional dan kumpulan argumen kata kunci opsional. Jika kunci yang sama diberikan beberapa kali, nilai terakhir akan digunakan. Entri yang diberikan melalui argumen kata kunci dianggap muncul setelah entri diberikan melalui argumen posisi.

Parameter

Parameter Deskripsi
pairs default adalah []
Dikte, atau iterable yang elemennya masing-masing memiliki panjang 2 (kunci, nilai).
kwargs wajib
Kamus entri tambahan.

dir

list dir(x)

Menampilkan daftar string: nama atribut dan metode dari objek parameter.

Parameter

Parameter Deskripsi
x wajib
Objek yang akan diperiksa.

sebutkan

list enumerate(list, start=0)

Menampilkan daftar pasangan (tuple dua elemen), dengan indeks (int) dan item dari urutan input. 
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]

Parameter

Parameter Deskripsi
list wajib
urutan input teks.
start default adalah 0
mulai indeks.

fail

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

Menyebabkan eksekusi gagal dengan error.

Parameter

Parameter Deskripsi
msg default adalah None
Tidak digunakan lagi: sebagai gantinya gunakan argumen posisi. Argumen ini berfungsi seperti argumen posisi utama yang implisit.
attr string; atau None; default adalah None
Tidak digunakan lagi. Menyebabkan awalan opsional yang berisi string ini ditambahkan ke pesan error.
args wajib
Daftar nilai, yang diformat dengan debugPrint (yang secara default setara dengan str) dan digabungkan dengan spasi, yang muncul dalam pesan error.

float

float float(x=unbound)

Menampilkan x sebagai nilai float.
  • Jika x sudah berupa float, float akan menampilkannya tanpa perubahan.
  • Jika x adalah bool, float akan menampilkan 1,0 untuk Benar dan 0,0 untuk Salah.
  • Jika x adalah int, float akan menampilkan nilai floating point terbatas yang terdekat dengan x, atau error jika magnitudonya terlalu besar.
  • Jika x adalah string, nilai tersebut harus berupa literal floating point yang valid, atau sama (mengabaikan huruf besar/kecil) dengan NaN, Inf, atau Infinity, secara opsional didahului dengan tanda + atau -.
Nilai lainnya akan menyebabkan error. Tanpa argumen, float() menampilkan 0.0.

Parameter

Parameter Deskripsi
x default adalah unbound
Nilai yang akan dikonversi.

getattr

unknown getattr(x, name, default=unbound)

Menampilkan kolom struct dari nama yang diberikan, jika ada. Jika tidak, tindakan tersebut akan menampilkan default (jika ditentukan) atau menyebabkan error. getattr(x, "foobar") setara dengan x.foobar.
getattr(ctx.attr, "myattr")
getattr(ctx.attr, "myattr", "mydefault")

Parameter

Parameter Deskripsi
x wajib
Struct yang atributnya diakses.
name wajib
Nama atribut struct.
default default adalah unbound
Nilai default yang akan ditampilkan jika struct tidak memiliki atribut dengan nama yang diberikan.

hasattr

bool hasattr(x, name)

Menampilkan Benar jika objek x memiliki atribut atau metode dari name yang diberikan, jika tidak, Salah. Contoh:
hasattr(ctx.attr, "myattr")

Parameter

Parameter Deskripsi
x wajib
Objek yang akan diperiksa.
name wajib
Nama atribut.

hash

int hash(value)

Menampilkan nilai hash untuk string. Hashing nilai ini dihitung secara deterministik menggunakan algoritma yang sama seperti String.hashCode() Java, yaitu: 
s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]
Hashing nilai selain string saat ini tidak didukung.

Parameter

Parameter Deskripsi
value wajib
Nilai string yang akan di-hash.

int

int int(x, base=unbound)

Menampilkan x sebagai nilai int.
  • Jika x sudah merupakan int, int akan menampilkannya tanpa perubahan.
  • Jika x adalah bool, int akan menampilkan 1 untuk Benar dan 0 untuk Salah.
  • Jika x berupa string, maka harus memiliki format <sign><prefix><digits>. <sign> adalah "+", "-", atau kosong (ditafsirkan sebagai positif). <digits> adalah urutan digit dari 0 hingga base - 1, dengan huruf a-z (atau ekuivalen, A-Z) digunakan sebagai digit untuk 10-35. Jika base adalah 2/8/16, <prefix> bersifat opsional dan dapat berupa 0b/0o/0x (atau ekuivalen, 0B/0O/0X); jika base adalah nilai lain selain basis ini atau nilai khusus 0, awalan harus kosong. Jika base adalah 0, string ditafsirkan sebagai literal bilangan bulat, dalam artian bahwa salah satu basis 2/8/10/16 dipilih bergantung pada awalan mana jika ada digunakan. Jika base adalah 0, tidak ada awalan yang digunakan, dan ada lebih dari satu digit, digit di awal tidak boleh 0; ini untuk menghindari kebingungan antara oktal dan desimal. Besarnya angka yang diwakili oleh string harus berada dalam rentang yang diizinkan untuk jenis int.
  • Jika x adalah float, int akan menampilkan nilai bilangan bulat float, yang dibulatkan ke nol. Ini adalah kesalahan jika x tidak terbatas (NaN atau tak terhingga).
Fungsi ini akan gagal jika x adalah jenis lain, atau jika nilai adalah string yang tidak memenuhi format di atas. Tidak seperti fungsi int Python, fungsi ini tidak mengizinkan argumen nol, dan tidak mengizinkan spasi kosong yang tidak relevan untuk argumen string.

Contoh:

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

Parameter

Parameter Deskripsi
x wajib
String yang akan dikonversi.
base default adalah unbound
Basis yang digunakan untuk menafsirkan nilai string; defaultnya adalah 10. Harus antara 2 dan 36 (inklusif), atau 0 untuk mendeteksi dasar seolah-olah x adalah literal bilangan bulat. Parameter ini tidak boleh diberikan jika nilainya bukan string.

Len

int len(x)

Menampilkan panjang string, urutan (seperti daftar atau tuple), dict, atau iterable lainnya.

Parameter

Parameter Deskripsi
x wajib
Nilai yang durasinya dilaporkan.

list

list list(x=[])

Menampilkan daftar baru dengan elemen yang sama dengan nilai iterable yang diberikan.
list([1, 2]) == [1, 2]
list((2, 3, 2)) == [2, 3, 2]
list({5: "a", 2: "b", 4: "c"}) == [5, 2, 4]

Parameter

Parameter Deskripsi
x default adalah []
Objek yang akan dikonversi.

maks

unknown max(*args)

Menampilkan salah satu terbesar dari semua argumen yang diberikan. Jika hanya ada satu argumen yang diberikan, argumen tersebut harus berupa iterable yang tidak kosong.Argumen tersebut akan error jika elemen tidak sebanding (misalnya, int dengan string), atau jika tidak ada argumen yang diberikan. 
max(2, 5, 4) == 5
max([5, 6, 3]) == 6

Parameter

Parameter Deskripsi
args wajib
Elemen yang akan diperiksa.

mnt

unknown min(*args)

Menampilkan nilai terkecil dari semua argumen yang diberikan. Jika hanya satu argumen yang diberikan, argumen tersebut harus berupa iterable yang tidak kosong. Akan muncul error jika elemen tidak sebanding (misalnya, int dengan string), atau jika tidak ada argumen yang diberikan. 
min(2, 5, 4) == 2
min([5, 6, 3]) == 3

Parameter

Parameter Deskripsi
args wajib
Elemen yang akan diperiksa.

cetak

None print(sep=" ", *args)

Mencetak args sebagai output debug. Nama ini akan diawali dengan string "DEBUG" dan lokasi (file dan nomor baris) panggilan ini. Cara persis argumen dikonversi ke string tidak ditentukan dan dapat berubah kapan saja. Secara khusus, pemformatan ini mungkin berbeda dengan (dan lebih mendetail dibandingkan) pemformatan yang dilakukan oleh str() dan repr().

Menggunakan print dalam kode produksi tidak disarankan karena spam yang dibuat untuk pengguna. Untuk penghentian penggunaan, pilih error berat menggunakan fail() jika memungkinkan.

Parameter

Parameter Deskripsi
sep default adalah " "
String pemisah antar-objek, defaultnya adalah spasi (" ").
args wajib
Objek yang akan dicetak.

rentang

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

Membuat daftar tempat item berpindah dari start ke stop, menggunakan penambahan step. Jika satu argumen diberikan, item akan berkisar dari 0 hingga elemen tersebut.
range(4) == [0, 1, 2, 3]
range(3, 9, 2) == [3, 5, 7]
range(3, 0, -1) == [3, 2, 1]

Parameter

Parameter Deskripsi
start_or_stop wajib
Nilai elemen awal jika perhentian diberikan, jika tidak, nilai perhentian dan awal yang sebenarnya adalah 0
stop_or_none int; atau None; default adalah None
indeks opsional item pertama tidak untuk disertakan dalam daftar yang dihasilkan; pembuatan daftar akan berhenti sebelum stop tercapai.
step default adalah 1
Penambahan (defaultnya adalah 1). Ini mungkin negatif.

repr

string repr(x)

Mengonversi objek apa pun menjadi representasi string. Hal ini berguna untuk proses debug.
repr("ab") == '"ab"'

Parameter

Parameter Deskripsi
x wajib
Objek yang akan dikonversi.

dibalik

list reversed(sequence)

Menampilkan daftar baru yang tidak dibekukan yang berisi elemen urutan iterable asli dalam urutan terbalik.
reversed([3, 5, 4]) == [4, 5, 3]

Parameter

Parameter Deskripsi
sequence wajib
Urutan iterable (misalnya, daftar) yang akan dibalik.

diurutkan

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

Menampilkan daftar baru yang diurutkan yang berisi semua elemen urutan iterable yang disediakan. Kesalahan dapat terjadi jika sepasang elemen x, y mungkin tidak dibandingkan menggunakan x < t Elemen diurutkan ke dalam urutan menaik, kecuali jika argumen terbaliknya adalah True, dalam hal ini urutannya menurun. Penyortiran stabil: elemen yang membandingkan sama dengan mempertahankan urutan relatif aslinya. 
sorted([3, 5, 4]) == [3, 4, 5]

Parameter

Parameter Deskripsi
iterable wajib
Urutan iterable untuk mengurutkan.
key default adalah None
Fungsi opsional yang diterapkan pada setiap elemen sebelum perbandingan.
reverse default adalah False
Tampilkan hasil dalam urutan menurun.

str

string str(x)

Mengonversi objek apa pun menjadi string. Hal ini berguna untuk proses debug.
str("ab") == "ab"
str(8) == "8"

Parameter

Parameter Deskripsi
x wajib
Objek yang akan dikonversi.

tuple

tuple tuple(x=())

Menampilkan tuple dengan elemen yang sama seperti nilai iterable yang diberikan.
tuple([1, 2]) == (1, 2)
tuple((2, 3, 2)) == (2, 3, 2)
tuple({5: "a", 2: "b", 4: "c"}) == (5, 2, 4)

Parameter

Parameter Deskripsi
x default adalah ()
Objek yang akan dikonversi.

jenis

string type(x)

Menampilkan nama jenis argumennya. Ini berguna untuk proses debug dan pemeriksaan jenis. Contoh:
type(2) == "int"
type([1]) == "list"
type(struct(a = 2)) == "struct"
Fungsi ini mungkin berubah di masa mendatang. Untuk menulis kode yang kompatibel dengan Python dan membuatnya siap menghadapi masa depan, gunakan kode tersebut hanya untuk membandingkan nilai yang ditampilkan: 
if type(x) == type([]):  # if x is a list

Parameter

Parameter Deskripsi
x wajib
Objek untuk diperiksa jenisnya.

zip

list zip(*args)

Menampilkan list dari tuple, dengan tuple ke-i berisi elemen ke-i dari setiap urutan argumen atau iterable. Daftar ini memiliki ukuran input terpendek. Dengan satu argumen iterable, fungsi ini menampilkan daftar 1-tuple. Tanpa argumen, kueri akan menampilkan daftar kosong. Contoh:
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)]

Parameter

Parameter Deskripsi
args wajib
ke file ZIP.