पाठ्यक्रम 250 में से पाठ 25 · फ़ंक्शन
फ़ंक्शन

Docstring और टाइप हिंट

दो छोटे स्पर्श काम करने वाले फ़ंक्शन को पेशेवर बनाते हैं: एक docstring और टाइप हिंट।

एक docstring एक स्ट्रिंग है जो फ़ंक्शन बॉडी की बिल्कुल पहली पंक्ति के रूप में रखी जाती है। यह बताती है कि फ़ंक्शन क्या करता है। टूल और help() इसे पढ़ते हैं, और Python इसे function.__doc__ पर रखता है:

def add(a, b):
    """Return the sum of a and b."""
    return a + b

print(add.__doc__)   # Return the sum of a and b.

तिहरे उद्धरण चिह्न docstring को कई पंक्तियों में फैलने देते हैं, जो लंबी व्याख्याओं के लिए काम का है।

टाइप हिंट बताते हैं कि पैरामीटर और लौटाए गए मान किस प्रकार के होने की उम्मीद है। आप हर पैरामीटर के लिए name: type और return के लिए -> type लिखते हैं:

def add(a: int, b: int) -> int:
    """Return the sum of a and b."""
    return a + b

हिंट चलते समय कुछ भी मजबूर नहीं करते। Python आपको स्ट्रिंग भेजने से नहीं रोकेगा। वे ऐसे दस्तावेज़ हैं जिन्हें एडिटर और जाँचने वाले गलतियाँ जल्दी पकड़ने के लिए इस्तेमाल करते हैं, और वे आपके सिग्नेचर को ख़ुद समझाने वाला बनाते हैं। आम हिंट प्रकारों में int, float, str और bool हैं।

अब से, फ़ंक्शन दोनों के साथ लिखें: एक साफ़ docstring और ईमानदार टाइप हिंट।

आपकी बारी

टाइप हिंट def multiply(a: int, b: int) -> int: और एक docstring (उसकी पहली पंक्ति) के साथ, जो ठीक Return the product of a and b. पढ़े, एक फ़ंक्शन multiply परिभाषित करें। बॉडी को return a * b करना चाहिए।

इस पाठ में कोई समस्या दिखी? बताएँ · इस पाठ के बारे में पूछें

यह अभ्यास जल्द खुलेगा

इससे पहले वाला पाठ पूरा करें और यह खुल जाएगा। पूरा कोर्स मुफ़्त है, कोई खाता नहीं चाहिए, और आप यह पाठ अभी पढ़ सकते हैं।