Tüm Bazel dosyaları

Sorun bildir Nightly · 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 (negatif olmayan, aynı büyüklüğe sahip) mutlak değerini 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 boole'ye dönüştürülür.
all(["hello", 3, True]) == True
all([-1, 0, 1]) == False

Parametreler

Parametre Açıklama
elements zorunlu
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ü için kurucu. 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
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 verilmesi durumunda 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 zorunlu
Ek girişlerin 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 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 zorunlu
giriş sırası.
start int; varsayılan değer 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 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 eklenmesini sağlar.
sep string; varsayılan değer: " "
Nesneler arasındaki ayırıcı dize, varsayılan olarak boşluk (" ") şeklindedir.
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)

Kayan noktalı değer olarak x'i 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 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 dizeyse geçerli bir kayan nokta sabit değeri olmalı veya NaN, Inf ya da Infinity değerine eşit (büyük/küçük harfe duyarlı değil) olmalı ve isteğe bağlı olarak + ya da - işareti getirilmelidir.
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)

Yapının, varsa belirtilen ada ait 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 ile eşdeğerdir.
getattr(ctx.attr, "myattr")
getattr(ctx.attr, "myattr", "mydefault")

Parametreler

Parametre Açıklama
x zorunlu
Özelliğine erişilen struct.
name string; 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 ö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 zorunlu
Kontrol edilecek nesne.
name string; gerekli
Özelliğin adı.

hash

int hash(value)

Bir dize için karma değer döndürür. Bu değer, Java'nın String.hashCode() işleviyle 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'i tam sayı değeri olarak döndürür.
  • x zaten int ise int, değeri değiştirmeden 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 dizeyse <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 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. 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 sonsuzluk) bir hatadır.
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ş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 zorunlu
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 (dahil) arasında veya x, tam sayı bir tam sayıymış gibi tabanın algılanması için 0 arasında 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 zorunlu
Uzunluğu bildirilecek 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 (yinelenebilir) 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 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ş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ı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 çağrılabilir; veya None; varsayılan değer None
Karşılaştırmadan önce her öğeye uygulanan isteğe bağlı bir işlev.
args zorunlu
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 oluşturduğu spam nedeniyle ü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 zorunlu
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
oluşturulan listeye dahil edilmeyen ilk öğenin isteğe bağlı dizini; stop tamamlanmadan önce duraklarının oluşturulduğu anlamına gelir.
step int; varsayılan değer 1
Artış (varsayılan değer 1). Negatif 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 (yinelenebilir) zorunlu
Tersine çevrilecek yinelemeli adım sırası (ö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 elemanlarından herhangi biri x < y. 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 iterable; required
Sıralamanın yapılacağı iterable dizi.
key çağrılabilir; 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ü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 zorunlu
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 iterable (yinelenebilir) 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 yararlıdır. Örnekler:
type(2) == "int"
type([1]) == "list"
type(struct(a = 2)) == "struct"
Bu işlev gelecekte değişebilir. Python 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 zorunlu
Türü kontrol edilecek nesne.

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