Tüm Bazel dosyaları

Sorun bildir Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

.bzl dosyaları, BUILD, MODULE.bazel, VENDOR.bazel ve WORKSPACE dahil tüm Bazel dosyalarında kullanılabilen yöntemler.

Üyeler

abs

unknown abs(x)

Bir sayının mutlak değerini (aynı büyüklükte negatif olmayan bir sayı) döndürür.
abs(-2.3) == 2.3

Parametreler

Parametre Açıklama
x int veya float; zorunlu
Bir sayı (int veya float)

tümü

bool all(elements)

Tüm öğeler doğru olarak değerlendiriliyorsa veya koleksiyon boşsa doğru değerini döndürür. Öğeler, bool işlevi kullanılarak doğru/yanlış değerine dönüştürülür.
all(["hello", 3, True]) == True
all([-1, 0, 1]) == False

Parametreler

Parametre Açıklama
elements required
Bir dize veya öğe koleksiyonu.

herhangi

bool any(elements)

En az bir öğe Doğru olarak değerlendirilirse true değerini döndürür. Öğeler, bool işlevi kullanılarak boole'ye dönüştürülür.
any([-1, 0, 1]) == True
any([False, 0, ""]) == False

Parametreler

Parametre Açıklama
elements required
Bir dize veya öğe koleksiyonu.

bool

bool bool(x=False)

Bool türünün oluşturucusu. Nesne None, False, boş bir dize (""), 0 sayısı veya boş bir koleksiyon (ör. (), []) ise False değerini döndürür. Aksi takdirde True sonucunu döndürür.

Parametreler

Parametre Açıklama
x varsayılan değer False
Dönüştürülecek değişken.

dikt

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

İsteğe bağlı konum bağımsız değişkeni ve anahtar kelime bağımsız değişkenleri grubundan bir sözlük oluşturur. Aynı anahtarın birden çok kez verildiği durumlarda son değer kullanılır. Anahtar kelime bağımsız değişkenleri aracılığıyla sağlanan girişlerin, konumsal bağımsız değişken aracılığıyla sağlanan girişlerden sonra geldiği kabul edilir.

Parametreler

Parametre Açıklama
pairs varsayılan olarak []'tır.
Öğelerinin her biri 2 uzunluğunda (anahtar, değer) bir dict (dict) veya iterable (yineleme) kullanılabilir.
kwargs gerekli
Ek girişler sözlüğü.

dir

list dir(x)

Bir dize listesi döndürür: Parametre nesnesinin özellik adları ve yöntemleri.

Parametreler

Parametre Açıklama
x gerekli
Kontrol edilecek nesne.

enumerate

list enumerate(list, start=0)

Dizin (int) ve giriş dizisindeki öğeyi içeren çiftlerin (iki öğeli devir) listesini döndürür.
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]

Parametreler

Parametre Açıklama
list gerekli
giriş sırası.
start varsayılan olarak 0
başlangıç dizinidir.

başarısız

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

Yürütme işleminin bir hata vererek başarısız olmasına neden olur.

Parametreler

Parametre Açıklama
msg varsayılan değer None
Desteği sonlandırıldı: Bunun yerine konumsal bağımsız değişkenleri kullanın. Bu argüman, üstü kapalı bir lider konum argümanı olarak işlev görür.
attr string; veya None; varsayılan değer None
Kullanımdan kaldırıldı. Bu dizeyi içeren isteğe bağlı bir ön ekin hata mesajına eklenmesine neden olur.
sep varsayılan değer " "
Nesneler arasındaki ayırıcı dize. Varsayılan değer boşluk (" ") karakteridir.
args required
Hata mesajında görünen, debugPrint ile biçimlendirilmiş (varsayılan olarak str ile eşdeğerdir) ve sep ile birleştirilmiş (varsayılan olarak " ") bir değer listesi.

kayan noktalı

float float(x=unbound)

x değerini kayan noktalı değer olarak döndürür.
  • x zaten kayan noktalı bir değerse float, değeri değiştirmeden döndürür.
  • x bir bool ise float, Doğru için 1,0, Yanlış için 0,0 döndürür.
  • x bir int ise float, x'e en yakın sonlu kayan nokta değerini döndürür veya büyüklük çok büyükse bir hata döndürür.
  • x bir dize ise geçerli bir kayan noktalı değişmez değer veya NaN, Inf ya da Infinity ile eşit (büyük/küçük harf duyarlılığı yoksayılır) olmalıdır. Dilerseniz + veya - işareti de ekleyebilirsiniz.
Diğer herhangi bir değer hataya neden olur. Bağımsız değişken içermeyen float() işlevi 0,0 değerini döndürür.

Parametreler

Parametre Açıklama
x varsayılan değer unbound
Dönüştürülecek değer.

getattr

unknown getattr(x, name, default=unbound)

Varsa yapının, belirtilen ada sahip alanını döndürür. Aksi takdirde default (belirtilmişse) değerini döndürür veya bir hata verir. getattr(x, "foobar"), x.foobar değerine eş değerdir.
getattr(ctx.attr, "myattr")
getattr(ctx.attr, "myattr", "mydefault")

Parametreler

Parametre Açıklama
x gerekli
Özelliğine erişilen struct.
name gerekli
struct özelliğinin adı.
default varsayılan değer unbound
Yapının belirtilen ada sahip bir özelliği olmaması durumunda döndürülecek varsayılan değer.

hasattr

bool hasattr(x, name)

x nesnesi, belirtilen name öğesinde bir özelliğe veya yönteme sahipse Doğru değerini, aksi takdirde Yanlış değerini döndürür. Örnek:
hasattr(ctx.attr, "myattr")

Parametreler

Parametre Açıklama
x gerekli
Kontrol edilecek nesne.
name required
Özelliğin adı.

hash

int hash(value)

Bir dize için karma oluşturma değeri döndürme. Bu değer, Java'nın String.hashCode() ile aynı algoritma kullanılarak belirlenir. Şöyle ki:
s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]
Dizeler dışındaki değerlerin karma oluşturma işlemi şu anda desteklenmiyor.

Parametreler

Parametre Açıklama
value gerekli
Karma oluşturma işlemi için dize değeri.

int

int int(x, base=unbound)

x'i tam sayı değeri olarak döndürür.
  • x zaten bir tam sayı ise int bunu değiştirmeden döndürür.
  • x bir bool ise int, Doğru için 1, Yanlış için 0 değerini döndürür.
  • x bir dize ise <sign><prefix><digits> biçiminde olmalıdır. <sign>, "+" veya "-" değerine sahip ya da boş (pozitif olarak yorumlanır). <digits>, 0 ile base - 1 arasındaki bir basamak dizisidir. Bu dizede, 10-35 için a-z harfleri (veya eşdeğeri olarak A-Z) basamak olarak kullanılır. base 2/8/16 ise <prefix> isteğe bağlıdır ve sırasıyla 0b/0o/0x (veya eşdeğer olarak 0B/0O/0X) olabilir; base bu tabanlar dışında başka bir değer veya özel değer 0 ise ön ek boş olmalıdır. base değerinin 0 olduğu durumlarda, dize bir tam sayı literali olarak yorumlanır. Yani, varsa kullanılan ön eke bağlı olarak 2/8/10/16 tabanlarından biri seçilir. base 0 ise ön ek kullanılmaz ve birden fazla basamak varsa ilk basamak 0 olamaz. Bu, sekizlik ve ondalık sistemler arasındaki karışıklığı önlemek içindir. Dizeyle temsil edilen sayının büyüklüğü, int türü için izin verilen aralık içinde olmalıdır.
  • x bir kayan noktalı sayıysa int, sıfıra yuvarlanarak kayan noktalı değerin tam sayı değerini döndürür. x sonlu değilse (NaN veya sonsuz) hata oluşur.
x farklı bir türdeyse veya değer yukarıdaki biçimi karşılamayan bir dizeyse bu işlev başarısız olur. Python'un int işlevinin aksine bu işlev, sıfır bağımsız değişkene ve dize bağımsız değişkenlerinde gereksiz boşluklara izin vermez.

Örnekler:

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

Parametreler

Parametre Açıklama
x gerekli
Dönüştürülecek dize.
base varsayılan değer unbound
Bir dize değerini yorumlamak için kullanılan taban; varsayılan olarak 10 değerine ayarlanır. 2 ile 36 arasında (dahil) veya x bir tam sayı değişmeziymiş gibi taban değerini algılamak için 0 olmalıdır. Değer bir dize değilse bu parametre sağlanmamalıdır.

Len

int len(x)

Bir dizenin, dizinin (ör. liste veya tuple), sözlüğün veya başka bir iterlenebilir öğenin uzunluğunu döndürür.

Parametreler

Parametre Açıklama
x required
Uzunluğu raporlanacak değer.

list

list list(x=[])

Belirtilen yinelenebilir değerle aynı öğeleri içeren yeni bir liste döndürür.
list([1, 2]) == [1, 2]
list((2, 3, 2)) == [2, 3, 2]
list({5: "a", 2: "b", 4: "c"}) == [5, 2, 4]

Parametreler

Parametre Açıklama
x varsayılan değer []
Dönüştürülecek nesne.

maks.

unknown max(key=None, *args)

Verilen tüm bağımsız değişkenler arasından en büyük olanı döndürür. Yalnızca bir konumsal bağımsız değişken sağlanırsa bu bağımsız değişken boş olmayan bir iteratör olmalıdır. Öğeler karşılaştırılabilir değilse (ör. tamsayı ile dize) veya bağımsız değişken sağlanmamışsa hata oluşur.
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

Parametreler

Parametre Açıklama
key callable; veya None; varsayılan değer None
Karşılaştırmadan önce her öğeye uygulanan isteğe bağlı bir işlev.
args gerekli
Kontrol edilecek öğeler.

dk

unknown min(key=None, *args)

Verilen tüm bağımsız değişkenlerden en küçük olanı döndürür. Yalnızca bir konumsal bağımsız değişken sağlanırsa bu bağımsız değişken boş olmayan bir iteratör olmalıdır. Öğeler karşılaştırılamazsa (örneğin, dizeyle int) veya bağımsız değişken belirtilmediyse bu bir hatadır.
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

Parametreler

Parametre Açıklama
key callable; veya None; varsayılan değer None
Karşılaştırmadan önce her öğeye uygulanan isteğe bağlı bir işlev.
args gerekli
Kontrol edilecek öğeler.

yazdır

None print(sep=" ", *args)

args öğesini hata ayıklama çıktısı olarak yazdırır. Öncesine "DEBUG" dizesi ve bu çağrının konumu (dosya ve satır numarası) eklenir. Bağımsız değişkenlerin dizelere tam olarak nasıl dönüştürüldüğü belirtilmemiştir ve herhangi bir zamanda değişebilir. Özellikle, str() ve repr() tarafından yapılan biçimlendirmeden farklı (ve bundan daha ayrıntılı) olabilir.

Kullanıcılar için spam oluşturduğundan, üretim kodunda print kullanılması önerilmez. Desteğin sonlandırılması için mümkün olduğunda fail() kullanımıyla ilgili ağır bir hata oluşturmayı tercih edin.

Parametreler

Parametre Açıklama
sep varsayılan değer " "
Nesneler arasındaki ayırıcı dize. Varsayılan değer boşluk (" ") karakteridir.
args required
Yazdırılacak nesneler.

aralık

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

step artışı kullanılarak öğelerin start ile stop arasında olduğu bir liste oluşturur. Tek bir bağımsız değişken sağlanırsa öğeler 0 ile ilgili öğe arasında değişir.
range(4) == [0, 1, 2, 3]
range(3, 9, 2) == [3, 5, 7]
range(3, 0, -1) == [3, 2, 1]

Parametreler

Parametre Açıklama
start_or_stop required
durma sağlanırsa başlangıç öğesinin değeri, aksi takdirde durma değerinin değeri ve gerçek başlangıç 0 olur
stop_or_none int; veya None; varsayılan olarak, sonuç listesine dahil edilmeyecek ilk öğenin None
isteğe bağlı dizinidir. Listenin oluşturulması, stop değerine ulaşmadan önce durur.
step varsayılan değer 1
Artış (varsayılan değer 1). Olumsuz olabilir.

yir

string repr(x)

Herhangi bir nesneyi dize temsiline dönüştürür. Bu, hata ayıklama için yararlıdır.
repr("ab") == '"ab"'

Parametreler

Parametre Açıklama
x gerekli
Dönüştürülecek nesne.

tersine çevrildi

list reversed(sequence)

Orijinal yinelenebilir dizinin öğelerini ters sırada içeren yeni ve dondurulmamış bir liste döndürür.
reversed([3, 5, 4]) == [4, 5, 3]

Parametreler

Parametre Açıklama
sequence gerekli
Tersine çevrilecek yinelenebilir adım sırası (ör. liste).

sıralanmış

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

Sağlanan iterlenebilir dizinin tüm öğelerini içeren yeni bir sıralanmış liste döndürür. x < y kullanılarak x, y öğe çifti karşılaştırılamazsa hata oluşabilir. Ters bağımsız değişken Doğru değerine sahip olmadığı sürece öğeler artan düzende sıralanır. True olarak ayarlanmış bu durumda, sıra azalan düzendedir. Sıralama sabit kalır: Eşit olarak karşılaştırılan öğeler orijinal göreceli sıralarını korur.
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

Parametreler

Parametre Açıklama
iterable required
Sırlanacak iterlenebilir sıra.
key çağrılabilir; veya None; varsayılan olarak None şeklindedir
Karşılaştırmadan önce her bir öğeye uygulanan isteğe bağlı bir işlev.
reverse varsayılan False şeklindedir
Sonuçları azalan düzende döndürün.

str

string str(x)

Herhangi bir nesneyi dizeye dönüştürür. Bu, hata ayıklama için yararlıdır.
str("ab") == "ab"
str(8) == "8"

Parametreler

Parametre Açıklama
x required
Dönüştürülecek nesne.

tuple

tuple tuple(x=())

Belirtilen yinelenebilir değerle aynı öğelere sahip bir demet döndürür.
tuple([1, 2]) == (1, 2)
tuple((2, 3, 2)) == (2, 3, 2)
tuple({5: "a", 2: "b", 4: "c"}) == (5, 2, 4)

Parametreler

Parametre Açıklama
x varsayılan değer ()
Dönüştürülecek nesne.

tür

string type(x)

Bağımsız değişkenin tür adını döndürür. Bu, hata ayıklama ve tür kontrolü için kullanışlıdır. Örnekler:
type(2) == "int"
type([1]) == "list"
type(struct(a = 2)) == "struct"
Bu işlev gelecekte değişebilir. Python ile uyumlu kod yazmak ve geleceğe hazır olmak için bu kodu yalnızca döndürülen değerleri karşılaştırmak amacıyla kullanın:
if type(x) == type([]):  # if x is a list

Parametreler

Parametre Açıklama
x required
Kontrol edilecek nesnenin türü.

zip

list zip(*args)

i. tuplinin, bağımsız değişken dizilerinin veya yinelenebilir öğelerin her birinden i. öğeyi içerdiği bir tuple döndürür. Liste, en kısa girişin boyutuna sahiptir. Yinelenebilir tek bir bağımsız değişkenle, 1 unsurlu bir liste döndürür. Bağımsız değişken olmadan boş bir liste döndürüyor. Örnekler:
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)]

Parametreler

Parametre Açıklama
args sıkıştırılması gereken
listelerdir.