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 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.
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.

dict

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 iteratör.
kwargs required
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 int; 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, açık 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 dize; 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 boole ise float, True için 1,0 ve False için 0,0 değerini 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 eklenebilir.
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 string; 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 required
Kontrol edilecek nesne.
name string; 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 string; zorunlu
Karma oluşturmak için kullanılacak 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 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 sistem 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 noktaysa int, kayan noktanın tam sayı değerini sıfıra yuvarlayarak döndürür. x sonlu değilse (NaN veya sonsuz) hata oluşur.
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şlevinin aksine bu işlev sıfır bağımsız değişkene izin vermez ve dize bağımsız değişkenleri için 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 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 (liste veya tuple gibi), sözlüğün, kümenin 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 iterable; 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 required
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. tamsayı 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 callable; veya None; varsayılan değer None
Karşılaştırmadan önce her öğeye uygulanan isteğe bağlı bir işlev.
args required
Kontrol edilecek öğeler.

yazdır

None print(sep=" ", *args)

Hata ayıklama çıkışı olarak args yazdırır. Öncesine "DEBUG" dizesi ve bu çağrının konumu (dosya ve satır numarası) eklenir. Argümanların dizelere dönüştürülme şekli belirtilmez 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ği sonlandırılan özellikler için mümkün olduğunda fail() kullanarak kesin hata tercih edin.

Parametreler

Parametre Açıklama
sep dize; 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 int; zorunlu
stop sağlanırsa start öğesinin değeri, aksi takdirde stop değeri ve gerçek start değeri 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 int; 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 iterable; required
Tersine çevrilecek iterlenebilir sıra (ör. liste).

grup

set set(elements=[])

Deneysel. Bu API deneme aşamasındadır ve herhangi bir zamanda değişebilir. Lütfen bu yönteme güvenmeyin. --experimental_enable_starlark_set ayarlanarak deneme amaçlı olarak etkinleştirilebilir.

İsteğe bağlı olarak belirli bir iterlenebilir öğedeki öğeleri içerecek şekilde başlatılan yeni bir set oluşturur.

Parametreler

Parametre Açıklama
elements varsayılan değer []
Bir küme, sıra veya sözlük.

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şkeni doğru olmadığı sürece öğeler artan düzende sıralanır. Ters bağımsız değişken doğruysa sıralama azalan düzende olur. 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 iterable; required
Sıralamanın yapılacağı iteratif sıra.
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 bool; varsayılan değer False
Sonuçları azalan düzende döndürme.

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ı öğ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 iterable; 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 gelecekte değişebilir. Python ile uyumlu kod yazmak ve gelecekte sorun yaşamamak için bu işlevi 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 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.list 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 gerekli
listeleri sıkıştırın.