Tüm Bazel dosyaları

Sorun bildir Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

.bzl dosyaları, BUILD, MODULE.bazel, VENDOR.bazel ve WORKSPACE dahil olmak üzere 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üğe sahip negatif olmayan bir sayı) döndürür.
abs(-2.3) == 2.3

Parametreler

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

tümü

bool all(elements)

Tüm öğeler Doğru olarak değerlendirilirse veya koleksiyon boşsa doğru değerini döndürür. Öğeler, bool işlevi kullanılarak boole 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 True olarak değerlendirilirse True değerini döndürür. Öğeler, bool işlevi kullanılarak boole değerine dönüştürülür.
any([-1, 0, 1]) == True
any([False, 0, ""]) == False

Parametreler

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

bool

bool bool(x=False)

bool türü için oluşturucu. 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 değerini döndürür.

Parametreler

Parametre Açıklama
x Varsayılan değer False
'dir. 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şkenleri grubundan sözlük oluşturur. Aynı anahtarın birden fazla 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 öğeleri 2 uzunluğunda (anahtar, değer) olan bir yinelenebilir öğe.
kwargs gerekli
Ek girişlerin sözlüğü.

dir

list dir(x)

Dizelerin listesini döndürür: parametre nesnesinin özelliklerinin ve yöntemlerinin adları.

Parametreler

Parametre Açıklama
x gerekli
Kontrol edilecek nesne.

numaralandırmak

list enumerate(list, start=0)

Dizine (int) ve giriş dizisindeki öğeye sahip çiftler (iki öğeli demetler) listesini 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
'dir. Kullanımdan kaldırıldı: Bunun yerine konumsal bağımsız değişkenleri kullanın. Bu bağımsız değişken, örtülü bir önde gelen konumsal bağımsız değişken gibi davranır.
attr string; veya None; varsayılan değer None
Kullanımdan kaldırıldı. Bu dizeyi içeren isteğe bağlı bir önekin hata mesajına eklenmesine neden olur.
sep string; varsayılan değer " "
Nesneler arasındaki ayırıcı dize. Varsayılan değer boşluktur (" ").
args zorunlu
Hata mesajında görünen, debugPrint ile biçimlendirilmiş (varsayılan olarak str'ye eşdeğerdir) ve sep ile birleştirilmiş (varsayılan olarak " ") değerlerin listesi.

kayan noktalı

float float(x=unbound)

x'i kayan nokta değeri olarak döndürür.
  • x zaten bir kayan nokta ise float bunu değiştirmeden döndürür.
  • x bir boole değeri ise float, True için 1,0 ve False için 0,0 değerini döndürür.
  • x bir tamsa float, x'e en yakın sonlu kayan nokta değerini veya büyüklük çok büyükse bir hata döndürür.
  • x bir dizeyse geçerli bir kayan nokta değişmezi olmalı veya NaN, Inf ya da Infinity ile eşit olmalıdır (büyük/küçük harf duyarlılığı olmadan). İsteğe bağlı olarak + veya - işaretiyle başlayabilir.
Başka herhangi bir değer hataya neden olur. Bağımsız değişken kullanılmadığında 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)

Verilen ada sahip yapı alanı varsa bu alanı döndürür. Aksi takdirde, default (belirtilmişse) döndürülür veya hata verilir. getattr(x, "foobar"), x.foobar etiketine 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ıda, verilen ada sahip bir özellik yoksa döndürülecek varsayılan değer.

hasattr

bool hasattr(x, name)

x nesnesi, verilen name özelliğine veya yöntemine sahipse True, aksi takdirde False değerini döndürür. Örnek:
hasattr(ctx.attr, "myattr")

Parametreler

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

hash

int hash(value)

Bir dize için karma değeri döndürür. Bu, Java'nın String.hashCode() ile aynı algoritma kullanılarak deterministik olarak hesaplanır. Bu algoritma şöyledir:
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 desteklenmemektedir.

Parametreler

Parametre Açıklama
value string; required
Karma oluşturulacak dize değeri.

int

int int(x, base=unbound)

x değerini tam sayı olarak döndürür.
  • x zaten bir tamsa int bunu değiştirmeden döndürür.
  • x bir boole değeri ise int, True için 1, False için 0 değerini döndürür.
  • x bir dizeyse <sign><prefix><digits> biçiminde olmalıdır. <sign>, "+", "-" veya boş (pozitif olarak yorumlanır) olmalıdır. <digits>, 0'dan base - 1'e kadar olan bir basamak dizisidir. Burada a-z harfleri (veya eşdeğeri olan A-Z) 10-35 için basamak olarak kullanılır. base 2/8/16 olduğunda <prefix> isteğe bağlıdır ve sırasıyla 0b/0o/0x (veya eşdeğeri olarak 0B/0O/0X) olabilir. base bu tabanlar veya özel değer 0 dışında herhangi bir değer olduğunda önek boş olmalıdır. base değerinin 0 olduğu durumlarda, dize bir tam sayı değişmezi olarak yorumlanır. Bu durumda, hangi ön ekin kullanıldığına bağlı olarak 2/8/10/16 tabanlarından biri seçilir. base 0 ise önek kullanılmaz ve birden fazla basamak varsa baştaki basamak 0 olamaz. Bunun nedeni, sekizlik ve ondalık sayılar arasındaki karışıklığı önlemektir. Dizeyle gösterilen sayının büyüklüğü, int türü için izin verilen aralıkta olmalıdır.
  • x bir kayan nokta sayısıysa int, kayan nokta sayısının tam sayı değerini döndürür ve sıfıra doğru yuvarlar. X sonlu değilse (NaN veya sonsuz) hata döndürülür.
x başka bir türdeyse veya değer yukarıdaki biçimi karşılamayan bir dizeyse bu işlev başarısız olur. Python'daki int işlevinin aksine, bu işlev sıfır bağımsız değişkene 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 zorunlu
Dönüştürülecek dize.
base Varsayılan değer unbound
'dir. Bir dize değerini yorumlamak için kullanılan taban. Varsayılan olarak 10'dur. 2 ile 36 arasında (bu sayılar dahil) veya 0 olmalıdır. 0 değeri, tabanı x tam sayı değişmezmiş gibi algılamak için kullanılır. Değer bir dize değilse bu parametre sağlanmamalıdır.

len

int len(x)

Dize, dizi (liste veya tanımlama grubu gibi), sözlük, küme ya da diğer yinelenebilir öğelerin uzunluğunu döndürür.

Parametreler

Parametre Açıklama
x gerekli
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; default is []
The object to convert.

maks.

unknown max(key=None, *args)

Belirtilen tüm bağımsız değişkenler arasında en büyüğünü 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 yineleme yapılabilir olmalıdır. Öğeler karşılaştırılabilir değilse (ör. dize ile int) veya bağımsız değişken verilmemişse 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; or None; default is None
An optional function applied to each element before comparison.
args gerekli
Kontrol edilecek öğeler.

dk

unknown min(key=None, *args)

Belirtilen tüm bağımsız değişkenler arasındaki en küçüğü 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 yinelenebilir olmalıdır. Öğeler karşılaştırılamıyorsa (ör. int ile string) veya bağımsız değişken verilmemişse 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; or None; default is None
An optional function applied to each element before comparison.
args gerekli
Kontrol edilecek öğeler.

yazdır

None print(sep=" ", *args)

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

Üretim kodunda print kullanılması, kullanıcılar için oluşturduğu spam nedeniyle önerilmez. Kullanımdan kaldırma işlemleri için mümkün olduğunda fail() kullanarak kesin bir hata vermeyi tercih edin.

Parametreler

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

aralık

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

Öğelerin step artışıyla start'dan stop'a gittiği bir liste oluşturur. Tek bir bağımsız değişken sağlanırsa öğeler 0 ile bu öğ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; required
Durdurma sağlanırsa başlangıç öğesinin değeri, aksi takdirde durdurma değeri ve gerçek başlangıç 0'dır.
stop_or_none int veya None; varsayılan değer None
sonuç listesine dahil edilmeyecek ilk öğenin isteğe bağlı dizini; liste oluşturma işlemi stop'ye ulaşılmadan önce durdurulur.
step int; varsayılan değer 1
Artış (varsayılan değer 1'dir). Negatif olabilir.

repr

string repr(x)

Herhangi bir nesneyi dize gösterimine 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 çevrilmiş

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
Ters çevrilecek yinelenebilir sıra (ör. liste).

grup

set set(elements=[])

Yineleme sırasını koruyarak belirli bir yinelenebilir öğenin benzersiz öğelerini içeren yeni bir küme oluşturur.

Bağımsız değişken olmadan çağrılırsa set() yeni bir boş küme döndürür.

Örneğin,

set()                          # an empty set
set([3, 1, 1, 2])              # set([3, 1, 2]), a set of three elements
set({"k1": "v1", "k2": "v2"})  # set(["k1", "k2"]), a set of two elements

Parametreler

Parametre Açıklama
elements varsayılan değer []
Bir küme, karma oluşturulabilir değerler dizisi veya sözlük.

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 ve y öğe çiftlerinden herhangi biri x < y kullanılarak karşılaştırılamıyorsa hata oluşabilir. Öğeler, ters bağımsız değişkeni Doğru olmadığı sürece artan düzende sıralanır. Bu durumda sıralama azalan olur. Sıralama sabittir: Eşit 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 iterable; required
Sıralanacak yinelenebilir dizi.
key callable; or None; default is None
An optional function applied to each element before comparison.
reverse bool; varsayılan değer False
Sonuçları azalan düzende döndürür.

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.

demet

tuple tuple(x=())

Belirtilen yinelenebilir değerle aynı öğeleri içeren 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 iterable; default is ()
The object to convert.

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önüş değerlerini karşılaştırmak üzere kullanın:
if type(x) == type([]):  # if x is a list

Parametreler

Parametre Açıklama
x required
Türünü kontrol edilecek nesne.

zip

list zip(*args)

list dizisi döndürür. Buradaki i. unsur, bağımsız değişken dizilerinin veya yinelenebilirlerin her birinden alınan i. öğeyi içerir.tuple Liste, en kısa girişin boyutuna sahiptir. Tek bir yinelenebilir bağımsız değişkenle 1 öğeli demetlerden oluşan bir liste döndürür. Bağımsız değişken olmadan 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 ZIP olarak sıkıştırın.