2009-04-03 25 views
114

से docstring हो रही है मैं निम्नलिखित समारोह:एक समारोह

def my_func(): 
    """My docstring is both funny and informative""" 
    pass 

मैं कैसे docstring के लिए उपयोग मिलता है?

+9

नोट। यदि आप दूसरों को अपना कोड वितरित करना चाहते हैं, तो ध्यान रखें कि वे इसे इस तरह से चला सकते हैं। यदि आपका कोड डॉकस्ट्रिंग पर निर्भर करता है तो यह वास्तव में वास्तव में नाखुश बना देगा, लेकिन उस मामले को नहीं पकड़ता जहां वे मौजूद नहीं हैं। – DNS

+1

उसके लिए चीयर्स, यह बहुत उपयोगी जानकारी है। – Teifion

+0

@ डीएनएस धन्यवाद, मैं सोच रहा था कि मेरे सभी डॉकस्ट्रिंग्स क्यों नहीं थे। – Timo

उत्तर

157

सहभागितापूर्ण तरीके से, आप इसे

help(my_func) 

साथ प्रदर्शित कर सकते हैं या कोड से आप के साथ

my_func.__doc__ 
+1

बीटीडब्ल्यू: यह तकनीक अंतर्निहित कार्यों के साथ-साथ मॉड्यूल और कक्षाओं (परीक्षण सहायता() वस्तुओं के साथ भी काम करती है - यह भी काम कर सकती है)। यह आपके अजगर खोल को एक इंटरैक्टिव हेल्प शैल बनाता है! –

+2

ipython प्रॉम्प्ट पर, आप my_func कर सकते हैं ?? और यह डॉकस्ट्रिंग भी दिखाएगा। – ronak

+3

पायथन बहुत मजेदार है – ThorSummoner

56

तुम भी inspect.getdoc उपयोग कर सकते हैं इसे पुनः प्राप्त कर सकते हैं। यह रिक्त स्थान पर टैब को सामान्यीकृत करके __doc__ को साफ़ करता है और सामान्य प्रमुख रिक्त स्थान को निकालने के लिए डॉक्टर निकाय को स्थानांतरित करता है।

+1

अब वही है जो मैं खुद को करने की कोशिश कर रहा था। उसके लिए धन्यवाद। – ereOn

1

IPython या jupyter नोटबुक पर, आप ऊपर वर्णित सभी तरीकों का उपयोग कर सकते हैं, लेकिन मैं दोनों विधि हस्ताक्षर और docstring का त्वरित सारांश के लिए

my_func? 

या

?my_func 

साथ जाना।

मैं

my_func?? 

(के रूप में @rohan द्वारा टिप्पणी की) का उपयोग कर docstring के लिए से बचने और केवल इसका इस्तेमाल -OO साथ अजगर चल बाहर स्ट्रिप्स कि docstrings स्रोत कोड देखने के

संबंधित मुद्दे