सभी Bazel फ़ाइलें

ये तरीके, Bazel की सभी फ़ाइलों में उपलब्ध होते हैं. इनमें .bzl फ़ाइलें, BUILD, MODULE.bazel, और WORKSPACE शामिल हैं.

सदस्य

एबीएस

unknown abs(x)

किसी संख्या की ऐब्सलूट वैल्यू दिखाता है. यह ऐसी संख्या होती है जो शून्य से कम नहीं होती और जिसका मैग्नीट्यूड मूल संख्या के बराबर होता है.
abs(-2.3) == 2.3

पैरामीटर

पैरामीटर ब्यौरा
x int; या float; required
कोई संख्या (int या फ़्लोट)

सभी

bool all(elements)

अगर सभी एलिमेंट की वैल्यू True है या कलेक्शन खाली है, तो यह फ़ंक्शन True दिखाता है. bool फ़ंक्शन का इस्तेमाल करके, एलिमेंट को बूलियन में बदला जाता है.
all(["hello", 3, True]) == True
all([-1, 0, 1]) == False

पैरामीटर

पैरामीटर ब्यौरा
elements ज़रूरी है
यह स्ट्रिंग या एलिमेंट का कलेक्शन होता है.

कोई

bool any(elements)

अगर कम से कम एक एलिमेंट की वैल्यू 'सही' है, तो यह फ़ंक्शन 'सही' वैल्यू दिखाता है. bool फ़ंक्शन का इस्तेमाल करके, एलिमेंट को बूलियन में बदला जाता है.
any([-1, 0, 1]) == True
any([False, 0, ""]) == False

पैरामीटर

पैरामीटर ब्यौरा
elements ज़रूरी है
यह स्ट्रिंग या एलिमेंट का कलेक्शन होता है.

बूल

bool bool(x=False)

bool टाइप के लिए कंस्ट्रक्टर. अगर ऑब्जेक्ट None, False, खाली स्ट्रिंग (""), संख्या 0 या खाली कलेक्शन (जैसे, (), []) है, तो यह False दिखाता है. इसके अलावा, यह True दिखाता है.

पैरामीटर

पैरामीटर ब्यौरा
x डिफ़ॉल्ट रूप से False
होता है वह वैरिएबल जिसे बदलना है.

dict

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

यह फ़ंक्शन, पोज़ीशनल आर्ग्युमेंट और कीवर्ड आर्ग्युमेंट के सेट से डिक्शनरी बनाता है. अगर एक ही कुंजी को कई बार दिया जाता है, तो आखिरी वैल्यू का इस्तेमाल किया जाएगा. कीवर्ड आर्ग्युमेंट के ज़रिए दी गई एंट्री को, पोज़िशनल आर्ग्युमेंट के ज़रिए दी गई एंट्री के बाद माना जाता है.

पैरामीटर

पैरामीटर ब्यौरा
pairs डिफ़ॉल्ट रूप से []
होता है यह एक डिक्शनरी या ऐसा इटरेबल होता है जिसके हर एलिमेंट की लंबाई 2 होती है (कुंजी, वैल्यू).
kwargs ज़रूरी है
अतिरिक्त एंट्री का शब्दकोश.

dir

list dir(x)

यह स्ट्रिंग की एक सूची दिखाता है: पैरामीटर ऑब्जेक्ट के एट्रिब्यूट और तरीकों के नाम.

पैरामीटर

पैरामीटर ब्यौरा
x ज़रूरी है
वह ऑब्जेक्ट जिसकी जांच करनी है.

गिनती करना

list enumerate(list, start=0)

यह फ़ंक्शन, जोड़े (दो एलिमेंट वाले टपल) की सूची दिखाता है. इसमें इंडेक्स (पूर्णांक) और इनपुट सीक्वेंस का आइटम शामिल होता है. 
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]

पैरामीटर

पैरामीटर ब्यौरा
list ज़रूरी है
इनपुट क्रम.
start डिफ़ॉल्ट वैल्यू 0
स्टार्ट इंडेक्स है.

फ़ेल हो गया

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

इससे गड़बड़ी की वजह से स्क्रिप्ट नहीं चल पाती.

पैरामीटर

पैरामीटर ब्यौरा
msg डिफ़ॉल्ट वैल्यू None
है इस्तेमाल बंद कर दिया गया है: इसके बजाय, पोज़ीशनल आर्ग्युमेंट का इस्तेमाल करें. यह आर्ग्युमेंट, लीडिंग पोज़ीशनल आर्ग्युमेंट की तरह काम करता है.
attr string; या None; डिफ़ॉल्ट रूप से None
होता है अब इस्तेमाल नहीं किया जा सकता. इस स्ट्रिंग को गड़बड़ी के मैसेज में जोड़ने के लिए, एक वैकल्पिक प्रीफ़िक्स बनाता है.
args ज़रूरी है
यह वैल्यू की एक सूची होती है. इसे debugPrint (जो डिफ़ॉल्ट रूप से str के बराबर होता है) का इस्तेमाल करके फ़ॉर्मैट किया जाता है. साथ ही, इसे स्पेस के साथ जोड़ा जाता है. यह गड़बड़ी के मैसेज में दिखती है.

फ़्लोट

float float(x=unbound)

x को फ़्लोट वैल्यू के तौर पर दिखाता है.
  • अगर x पहले से ही फ़्लोट है, तो float इसे बिना किसी बदलाव के दिखाता है.
  • अगर x एक बूल है, तो float, सही के लिए 1.0 और गलत के लिए 0.0 दिखाता है.
  • अगर x एक पूर्णांक है, तो float, x के सबसे करीब फ़ाइनाइट फ़्लोटिंग-पॉइंट वैल्यू दिखाता है. अगर मैग्नीट्यूड बहुत बड़ा है, तो गड़बड़ी दिखाता है.
  • अगर x एक स्ट्रिंग है, तो यह एक मान्य फ़्लोटिंग-पॉइंट लिटरल होना चाहिए. इसके अलावा, यह NaN, Inf या Infinity के बराबर होना चाहिए. हालांकि, ऐसा करते समय केस को अनदेखा किया जाता है. साथ ही, इसके पहले + या - का चिह्न भी लगाया जा सकता है.
कोई अन्य वैल्यू डालने पर गड़बड़ी होती है. कोई आर्ग्युमेंट न होने पर, float() 0.0 दिखाता है.

पैरामीटर

पैरामीटर ब्यौरा
x डिफ़ॉल्ट वैल्यू unbound
है यह वह वैल्यू है जिसे बदलना है.

getattr

unknown getattr(x, name, default=unbound)

अगर दिए गए नाम का स्ट्रक्चर फ़ील्ड मौजूद है, तो उसे दिखाता है. अगर ऐसा नहीं होता है, तो यह default (अगर तय किया गया है) दिखाता है या गड़बड़ी का मैसेज दिखाता है. getattr(x, "foobar"), x.foobar के बराबर है.
getattr(ctx.attr, "myattr")
getattr(ctx.attr, "myattr", "mydefault")

पैरामीटर

पैरामीटर ब्यौरा
x ज़रूरी है
वह स्ट्रक्चर जिसका एट्रिब्यूट ऐक्सेस किया गया है.
name ज़रूरी है
स्ट्रक्ट एट्रिब्यूट का नाम.
default डिफ़ॉल्ट वैल्यू unbound
अगर स्ट्रक्चर में दिए गए नाम का एट्रिब्यूट मौजूद नहीं है, तो डिफ़ॉल्ट वैल्यू दिखाई जाएगी.

hasattr

bool hasattr(x, name)

अगर ऑब्जेक्ट x में, दिए गए name का एट्रिब्यूट या तरीका मौजूद है, तो यह फ़ंक्शन True दिखाता है. अगर ऐसा नहीं है, तो False दिखाता है. उदाहरण:
hasattr(ctx.attr, "myattr")

पैरामीटर

पैरामीटर ब्यौरा
x ज़रूरी है
वह ऑब्जेक्ट जिसकी जांच करनी है.
name ज़रूरी है
एट्रिब्यूट का नाम.

हैश

int hash(value)

किसी स्ट्रिंग के लिए हैश वैल्यू दिखाता है. इसे Java के String.hashCode() के तौर पर एक ही एल्गोरिदम का इस्तेमाल करके तय किया जाता है. जैसे:
फ़िलहाल, स्ट्रिंग के अलावा अन्य वैल्यू को हैश करने की सुविधा उपलब्ध नहीं है.
s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]

पैरामीटर

पैरामीटर ब्यौरा
value ज़रूरी है
हैश करने के लिए स्ट्रिंग वैल्यू.

int

int int(x, base=unbound)

x को पूर्णांक के तौर पर दिखाता है.
  • अगर x पहले से ही एक पूर्णांक है, तो int इसे बिना किसी बदलाव के दिखाता है.
  • अगर x एक बूल है, तो int, सही के लिए 1 और गलत के लिए 0 दिखाता है.
  • अगर x एक स्ट्रिंग है, तो इसका फ़ॉर्मैट <sign><prefix><digits> होना चाहिए. <sign> की वैल्यू "+", "-" या खाली होनी चाहिए. खाली वैल्यू को पॉज़िटिव माना जाता है. <digits>, 0 से लेकर base - 1 तक के अंकों का क्रम है. इसमें a-z (या इसके बराबर, A-Z) अक्षरों का इस्तेमाल 10 से 35 तक के अंकों के लिए किया जाता है. अगर base की वैल्यू 2/8/16 है, तो <prefix> की वैल्यू देना ज़रूरी नहीं है. इसकी वैल्यू 0b/0o/0x (या इसके बराबर, 0B/0O/0X) हो सकती है. अगर base की वैल्यू इन बेस या खास वैल्यू 0 के अलावा कोई और वैल्यू है, तो प्रीफ़िक्स की वैल्यू खाली होनी चाहिए. अगर base की वैल्यू 0 है, तो स्ट्रिंग को पूर्णांक लिटरल के तौर पर माना जाता है. इसका मतलब है कि इस्तेमाल किए गए प्रीफ़िक्स के आधार पर, 2/8/10/16 में से किसी एक बेस को चुना जाता है. अगर base की वैल्यू 0 है, तो किसी भी प्रीफ़िक्स का इस्तेमाल नहीं किया जाता. साथ ही, अगर एक से ज़्यादा अंक हैं, तो पहला अंक 0 नहीं हो सकता. ऐसा इसलिए किया जाता है, ताकि ऑक्टल और डेसिमल के बीच कोई भ्रम न हो. स्ट्रिंग से दिखाई गई संख्या का मैग्नीट्यूड, int टाइप के लिए तय सीमा के अंदर होना चाहिए.
  • अगर x फ़्लोटिंग पॉइंट नंबर है, तो int फ़्लोटिंग पॉइंट नंबर की पूर्णांक वैल्यू दिखाता है. इसमें फ़्लोटिंग पॉइंट नंबर को शून्य की ओर राउंड किया जाता है. अगर x सीमित नहीं है (NaN या अनंत), तो यह एक गड़बड़ी है.
अगर x किसी दूसरे टाइप का है या वैल्यू ऐसी स्ट्रिंग है जो ऊपर दिए गए फ़ॉर्मैट के मुताबिक नहीं है, तो यह फ़ंक्शन काम नहीं करता. Python के int फ़ंक्शन के उलट, यह फ़ंक्शन शून्य आर्ग्युमेंट की अनुमति नहीं देता. साथ ही, स्ट्रिंग आर्ग्युमेंट के लिए अतिरिक्त व्हाइटस्पेस की अनुमति नहीं देता.

उदाहरण:

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

पैरामीटर

पैरामीटर ब्यौरा
x ज़रूरी है
बदलने के लिए स्ट्रिंग.
base डिफ़ॉल्ट वैल्यू unbound
है यह स्ट्रिंग वैल्यू को समझने के लिए इस्तेमाल किया जाने वाला आधार है. इसकी डिफ़ॉल्ट वैल्यू 10 होती है. यह 2 से 36 (दोनों शामिल हैं) के बीच होना चाहिए. इसके अलावा, अगर x को पूर्णांक लिटरल के तौर पर पता लगाना है, तो इसे 0 पर सेट करें. अगर वैल्यू स्ट्रिंग नहीं है, तो यह पैरामीटर नहीं दिया जाना चाहिए.

len

int len(x)

यह फ़ंक्शन, किसी स्ट्रिंग, क्रम (जैसे कि सूची या टपल), शब्दकोश या अन्य दोहराए जा सकने वाले ऑब्जेक्ट की लंबाई दिखाता है.

पैरामीटर

पैरामीटर ब्यौरा
x ज़रूरी है
वह वैल्यू जिसकी लंबाई की रिपोर्ट बनानी है.

सूची

list list(x=[])

यह फ़ंक्शन, दी गई iterable वैल्यू के एलिमेंट वाली नई सूची दिखाता है.
list([1, 2]) == [1, 2]
list((2, 3, 2)) == [2, 3, 2]
list({5: "a", 2: "b", 4: "c"}) == [5, 2, 4]

पैरामीटर

पैरामीटर ब्यौरा
x डिफ़ॉल्ट वैल्यू []
है यह वह ऑब्जेक्ट है जिसे बदलना है.

अधिकतम

unknown max(*args)

दिए गए सभी आर्ग्युमेंट में से सबसे बड़ी वैल्यू दिखाता है. अगर सिर्फ़ एक आर्ग्युमेंट दिया गया है, तो यह ज़रूरी है कि वह खाली न हो.अगर एलिमेंट की तुलना नहीं की जा सकती (उदाहरण के लिए, int की तुलना string से करना) या कोई आर्ग्युमेंट नहीं दिया गया है, तो गड़बड़ी होगी. 
max(2, 5, 4) == 5
max([5, 6, 3]) == 6

पैरामीटर

पैरामीटर ब्यौरा
args ज़रूरी है
वे एलिमेंट जिनकी जांच करनी है.

कम से कम

unknown min(*args)

दिए गए सभी तर्कों में से सबसे छोटा तर्क दिखाता है. अगर सिर्फ़ एक तर्क दिया गया है, तो यह एक ऐसा इटरेटबल होना चाहिए जो खाली न हो. अगर एलिमेंट की तुलना नहीं की जा सकती (उदाहरण के लिए, पूर्णांक की तुलना स्ट्रिंग से करना) या कोई आर्ग्युमेंट नहीं दिया गया है, तो यह एक गड़बड़ी है. 
min(2, 5, 4) == 2
min([5, 6, 3]) == 3

पैरामीटर

पैरामीटर ब्यौरा
args ज़रूरी है
वे एलिमेंट जिनकी जांच करनी है.

प्रिंट करें

None print(sep=" ", *args)

यह args को डीबग आउटपुट के तौर पर प्रिंट करता है. इसके पहले "DEBUG" स्ट्रिंग और इस कॉल की जगह (फ़ाइल और लाइन नंबर) का प्रीफ़िक्स लगाया जाएगा. आर्ग्युमेंट को स्ट्रिंग में बदलने का सटीक तरीका तय नहीं किया गया है. इसे किसी भी समय बदला जा सकता है. खास तौर पर, यह str() और repr() के फ़ॉर्मैटिंग से अलग हो सकता है. साथ ही, इसमें ज़्यादा जानकारी भी हो सकती है.

हमारा सुझाव है कि प्रोडक्शन कोड में print का इस्तेमाल न करें, क्योंकि इससे लोगों के लिए स्पैम जनरेट होता है. बंद की जा रही सुविधाओं के लिए, जब भी हो सके fail() का इस्तेमाल करके, हार्ड एरर को प्राथमिकता दें.

पैरामीटर

पैरामीटर ब्यौरा
sep डिफ़ॉल्ट वैल्यू " "
है ऑब्जेक्ट के बीच सेपरेटर स्ट्रिंग. डिफ़ॉल्ट वैल्यू स्पेस (" ") है.
args ज़रूरी है
प्रिंट किए जाने वाले ऑब्जेक्ट.

सीमा

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

इस फ़ंक्शन से एक ऐसी सूची बनती है जिसमें आइटम start से stop तक जाते हैं. इसमें step का इंक्रीमेंट इस्तेमाल किया जाता है. अगर एक ही आर्ग्युमेंट दिया जाता है, तो आइटम की संख्या 0 से लेकर उस एलिमेंट तक होगी.
range(4) == [0, 1, 2, 3]
range(3, 9, 2) == [3, 5, 7]
range(3, 0, -1) == [3, 2, 1]

पैरामीटर

पैरामीटर ब्यौरा
start_or_stop ज़रूरी है
अगर स्टॉप की जानकारी दी गई है, तो स्टार्ट एलिमेंट की वैल्यू. अगर स्टॉप की जानकारी नहीं दी गई है, तो स्टॉप की वैल्यू और असल स्टार्ट की वैल्यू 0 होती है
stop_or_none int; या None; डिफ़ॉल्ट रूप से None
होता है यह पहली ऐसी आइटम का इंडेक्स होता है जिसे नतीजे के तौर पर मिली सूची में शामिल नहीं किया जाना चाहिए. सूची जनरेट करने की प्रोसेस, stop तक पहुंचने से पहले ही रुक जाती है.
step डिफ़ॉल्ट वैल्यू 1
है इंक्रीमेंट (डिफ़ॉल्ट वैल्यू 1 है). यह नेगेटिव हो सकता है.

repr

string repr(x)

यह फ़ंक्शन, किसी भी ऑब्जेक्ट को स्ट्रिंग में बदलता है. यह डीबग करने के लिए काम का है.
repr("ab") == '"ab"'

पैरामीटर

पैरामीटर ब्यौरा
x ज़रूरी है
वह ऑब्जेक्ट जिसे बदलना है.

रिवर्स किया गया

list reversed(sequence)

यह फ़ंक्शन, एक नई और अनफ़्रीज़ की गई सूची दिखाता है. इसमें ओरिजनल इटरेटिव सीक्वेंस के एलिमेंट, उल्टे क्रम में होते हैं.
reversed([3, 5, 4]) == [4, 5, 3]

पैरामीटर

पैरामीटर ब्यौरा
sequence ज़रूरी है
यह एक ऐसी क्रमवार सूची (जैसे कि सूची) होती है जिसे उलटा करना होता है.

क्रम से लगाया गया

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

यह फ़ंक्शन, क्रम से लगाई गई एक नई सूची दिखाता है. इसमें दिए गए इटरेट किए जा सकने वाले क्रम के सभी एलिमेंट शामिल होते हैं. अगर x < y का इस्तेमाल करके, x और y के किसी भी पेयर की तुलना नहीं की जा सकती, तो गड़बड़ी हो सकती है. अगर reverse आर्ग्युमेंट की वैल्यू True नहीं है, तो एलिमेंट को बढ़ते क्रम में लगाया जाता है. अगर reverse आर्ग्युमेंट की वैल्यू True है, तो एलिमेंट को घटते क्रम में लगाया जाता है. सॉर्टिंग स्थिर होती है: तुलना करने पर बराबर पाए गए एलिमेंट, अपने मूल क्रम में ही रहते हैं. 
sorted([3, 5, 4]) == [3, 4, 5]

पैरामीटर

पैरामीटर ब्यौरा
iterable ज़रूरी है
सॉर्ट करने के लिए, दोहराई जा सकने वाली सीक्वेंस.
key डिफ़ॉल्ट रूप से None
होता है तुलना करने से पहले, हर एलिमेंट पर लागू किया जाने वाला एक वैकल्पिक फ़ंक्शन.
reverse डिफ़ॉल्ट रूप से False
होता है नतीजों को घटते क्रम में दिखाता है.

str

string str(x)

किसी भी ऑब्जेक्ट को स्ट्रिंग में बदलता है. यह डीबग करने के लिए काम का है.
str("ab") == "ab"
str(8) == "8"

पैरामीटर

पैरामीटर ब्यौरा
x ज़रूरी है
वह ऑब्जेक्ट जिसे बदलना है.

टपल

tuple tuple(x=())

यह फ़ंक्शन, दिए गए इटरेट किए जा सकने वाले ऑब्जेक्ट की वैल्यू के बराबर एलिमेंट वाला टपल दिखाता है.
tuple([1, 2]) == (1, 2)
tuple((2, 3, 2)) == (2, 3, 2)
tuple({5: "a", 2: "b", 4: "c"}) == (5, 2, 4)

पैरामीटर

पैरामीटर ब्यौरा
x डिफ़ॉल्ट वैल्यू ()
है यह वह ऑब्जेक्ट है जिसे बदलना है.

टाइप

string type(x)

यह फ़ंक्शन, अपने आर्ग्युमेंट के टाइप का नाम दिखाता है. यह डीबग करने और टाइप की जांच करने के लिए उपयोगी है. उदाहरण:
type(2) == "int"
type([1]) == "list"
type(struct(a = 2)) == "struct"
आने वाले समय में, इस फ़ंक्शन में बदलाव हो सकता है. Python के साथ काम करने वाला कोड लिखने और आने वाले समय में इसका इस्तेमाल करने के लिए, इसका इस्तेमाल सिर्फ़ रिटर्न वैल्यू की तुलना करने के लिए करें: 
if type(x) == type([]):  # if x is a list

पैरामीटर

पैरामीटर ब्यौरा
x required
वह ऑब्जेक्ट जिसका टाइप जांचना है.

zip

list zip(*args)

यह फ़ंक्शन, list के list दिखाता है. इसमें i-th टपल में, हर आर्ग्युमेंट सीक्वेंस या इटरेबल का i-th एलिमेंट होता है.tuple इस सूची का साइज़, सबसे छोटे इनपुट के साइज़ के बराबर होता है. एक बार दोहराए जा सकने वाले आर्ग्युमेंट के साथ, यह 1-टपल की सूची दिखाता है. कोई भी तर्क न देने पर, यह एक खाली सूची दिखाता है. उदाहरण:
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)]

पैरामीटर

पैरामीटर ब्यौरा
args ज़रूरी है
ज़िप करने के लिए सूचियां.