Tüm Bazel dosyaları

Sorun bildir Nightly · 7.4 .

.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 gerekli
Bir dize veya öğe koleksiyonu.

herhangi

bool any(elements)

En az bir öğe doğru olarak değerlendirilirse doğru 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ü için kurucu. Nesne None, False, boş dize (""), 0 sayısı veya boş bir koleksiyon (ör. (), []) ise False döndürür. Aksi takdirde True 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ı bir konumsal bağımsız değişkenden ve isteğe bağlı bir anahtar kelime bağımsız değişkeni 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 değer []
Bir sözlük veya öğelerinin her biri 2 uzunlukta (anahtar, değer) olan bir iterlenebilir.
kwargs gerekli
Ek girişler sözlüğü.

dir

list dir(x)

Parametre nesnesinin özelliklerinin ve yöntemlerinin adlarını içeren bir dize listesi döndürür.

Parametreler

Parametre Açıklama
x required
Kontrol edilecek nesne.

enumerate

list enumerate(list, start=0)

Giriş dizisindeki dizini (int) ve öğeyi içeren bir çiftler listesi (iki öğeli tuple) döndürür.
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]

Parametreler

Parametre Açıklama
list gerekli
giriş dizisi.
start varsayılan değer 0
başlangıç dizinidir.

başarısız

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

Yürütmenin bir hatayla 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 bağımsız değişken, gizli bir başlangıç konumsal bağımsız değişkeni gibi davranır.
attr dize; veya None; varsayılan değer None
Desteği sonlandı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 gerekli
DebugPrint (varsayılan olarak str ile eş değerdir) biçimlendirilmiş ve hata mesajında görünen sep (" " değerine ayarlanır) ile birleştirilmiş değerlerin listesi.

kayan noktalı

float float(x=unbound)

x değerini kayan noktalı değer olarak döndürür.
  • x zaten bir kayan noktalı sayıysa float, bunu değiştirmeden döndürür.
  • x bir boole ise float, True için 1,0 ve False için 0,0 değerini döndürür.
  • x bir tam sayıysa float, en yakın sonlu kayan nokta değerini x olarak döndürür veya büyüklük çok büyükse hata mesajı 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.
Başka 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 değerini (belirtilmişse) döndürür veya hata oluşturur. getattr(x, "foobar"), x.foobar değerine eş değerdir.
getattr(ctx.attr, "myattr")
getattr(ctx.attr, "myattr", "mydefault")

Parametreler

Parametre Açıklama
x required
Özelliğine erişilen yapı.
name required
Yapı ö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 özelliğine veya yöntemine sahipse True (Doğru), aksi takdirde False (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, belirleyici bir şekilde Java'nın String.hashCode() algoritması kullanılarak hesaplanır. Diğer bir deyişle:
s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]
Dizelerin dışındaki değerlerin karma oluşturma işlemi şu anda desteklenmiyor.

Parametreler

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

int

int int(x, base=unbound)

x değerini tam sayı olarak döndürür.
  • x zaten int ise int, değeri değiştirilmeden döndürür.
  • x bir boole ise int, True için 1 ve False için 0 değerini döndürür.
  • x bir dize ise <sign><prefix><digits> biçiminde olmalıdır. <sign>, "+", "-" veya boştur (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 durumda dize, kullanılan ön eke bağlı olarak 2/8/10/16 tabanlarından birinin seçilmesi anlamında tam sayı sabit değeri olarak yorumlanır. 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. Dizenin temsil ettiği sayının büyüklüğü, tam türü için izin verilen aralıkta olmalıdır.
  • x bir kayan noktaysa int, kayan noktanın tam sayı değerini sıfıra yuvarlayarak döndürür. x sonlu değilse (NaN veya sonsuzluk) bir hatadır.
x başka bir türse veya değer yukarıdaki biçimi karşılamayan bir dizeyse bu işlev başarısız olur. Python'un int işlevinden farklı olarak bu işlev, sıfır bağımsız değişkene izin vermez ve dize bağımsız değişkenleri için fazladan boşluk bırakmaz.

Ö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 required
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'dur. 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 ç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.
args gerekli
Kontrol edilecek öğeler.

dk

unknown min(key=None, *args)

Verilen tüm bağımsız değişkenler arasından 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ılabilir değilse (ör. tam sayı ile dize) veya bağımsız değişken verilmezse hata oluşur.
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 ç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.
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 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 değer None
Sonuçta elde edilen listeye dahil edilmeyecek ilk öğenin isteğe bağlı dizini; liste oluşturma işlemi stop değerine ulaşılmadan durdurulur.
step varsayılan değer 1
Artış (varsayılan değer 1). Olumsuz olabilir.

repr

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 required
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 required
Tersine çevrilecek iterlenebilir sıra (ör. liste).

sıralanmış

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

Sağlanan yinelenebilir 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 sabittir: Eşit oranda karşılaştırılan öğeler orijinal göreli 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 gerekli
Sıralama yapılacak yinelenebilir adım sırası.
key callable; veya None; varsayılan değer None
Karşılaştırmadan önce her öğ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 konusunda faydalı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ı öğeleri içeren bir tuple 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şkeninin 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 ileride değişebilir. Python ile uyumlu kod yazmak ve gelecekte sorun yaşamamak için yalnızca döndürülen değerleri karşılaştırmak için kullanın:
if type(x) == type([]):  # if x is a list

Parametreler

Parametre Açıklama
x gerekli
Kontrol edilecek nesne 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. Tek bir iterlenebilir bağımsız değişkenle 1-tuple listesi döndürür. Bağımsız değişken olmadan çağrıldığında boş bir liste döndürür. Ö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.