2011-06-06 18 views
16

पायथन के लिए सी एक्सटेंशन बनाते समय, क्या किसी भी तरह की टिप्पणियों को लिखने में सक्षम होना संभव है जो एक्सटेंशन के उपयोगकर्ताओं को docstrings के रूप में उजागर किया जा सकता है?सी एक्सटेंशन में पाइथन के लिए डॉकस्ट्रिंग?

+0

आप पहले से ही इसके बारे में जानते हैं, लेकिन यदि नहीं: तो आप साइथन की जांच करना चाहेंगे। आप पाइथन-स्टाइल कोड लिखते हैं, कुछ प्रकार की घोषणाएं जोड़ते हैं, और इसे सी में संकलित किया जाता है और संकलित किया जाता है। –

उत्तर

17

Docstrings रूप PyTypeObject संरचना में tp_doc सदस्य, an example in the docs देखना शामिल किया जा सकता। कार्यों के लिए

Docstrings module's method table की ml_doc क्षेत्र में शामिल किया जा सकता है। यदि आप अपने कार्यों को वास्तविक कार्यों में "शारीरिक रूप से बंद" करना चाहते हैं, तो आप विधि तालिका में संदर्भित अपनी फ़ंक्शन परिभाषाओं के ऊपर स्ट्रिंग स्थिरांक शामिल कर सकते हैं। तरीकों के लिए

Docstrings type's member table में doc क्षेत्र में रख दिया जा सकता है। मॉड्यूल के लिए

Docstrings Py_InitModule3() या Py_InitModule4() कार्यों के लिए एक पैरामीटर के रूप में पारित किया जा सकता है।

+0

ग्रेट उत्तर, धन्यवाद स्वेन। सीधा लिंक बहुत आसान हैं। –

-3

मुझे ऐसा नहीं लगता है, लेकिन आप उन वस्तुओं के दस्तावेज़ों को पाइथन से छेड़छाड़ करने में सक्षम होना चाहिए। अधिक के लिए python docs देखें। प्रकार के लिए