2015-03-19 5 views
8

जाओ परीक्षण पैकेज का उल्लेख है example functions के रूप में:गो उदाहरण फ़ंक्शन क्या हैं?

func Example() { ... } 
func ExampleF() { ... } 
func ExampleT() { ... } 
func ExampleT_M() { ... } 

अर्थ क्या है और इन के लिए मामले का उपयोग करें?

+0

मैं प्रलेखन आप लिंक में स्पष्ट नहीं कुछ भी नहीं देखते हैं। आईएमओ, आपका प्रश्न "spec mentions 'int' जैसे कुछ के बराबर है, इसके लिए अर्थ और उपयोग का मामला क्या है?" यानी बहुत अस्पष्ट/मूल या बेकार होने के लिए कोई असली सवाल नहीं है। –

+1

@ आईसीज़ा का जवाब स्पॉट पर था। दस्तावेज़ों का उल्लेख नहीं है कि उदाहरण कार्यों का उपयोग 'गोडोक' के साथ किया जाता है, इसलिए यह मेरे लिए अस्पष्ट था कि आप उनके लिए क्या उपयोग करेंगे। – Calin

उत्तर

8

उदाहरण फ़ंक्शंस पैकेज या फ़ंक्शंस या अन्य कोड जो आप दस्तावेज़ बना रहे हैं उसका उपयोग उदाहरण हैं। उदाहरण कार्यों को स्रोत स्वरूप में उत्पन्न गोडोक में शामिल किया जाएगा (जबकि अन्य कार्य नहीं हैं), उचित स्वरूपण के साथ, कुछ प्रसंस्करण भी लागू होते हैं, उदाहरण के लिए यदि उदाहरण फ़ंक्शन की अंतिम पंक्ति में प्रारूप में आउटपुट होता है:

func ExampleExamples_output() { 
    fmt.Println("Hello") 
    // Output: Hello 
} 

आउटपुट निर्दिष्ट करने वाली अंतिम पंक्ति को अलग-अलग ब्लॉक में विभाजित और प्रस्तुत किया जाएगा, जैसा कि यहां देखा जा सकता है: Example (Output)

यदि आउटपुट प्रदान किया जाता है तो भी: पैकेज के टेस्ट सूट (उदाहरण के साथ go test) को चलाने से आपके द्वारा आगे की व्यवस्था के साथ उदाहरण फ़ंक्शन निष्पादित नहीं होते हैं, और गो अंतिम टिप्पणी पंक्ति में निर्दिष्ट आउटपुट के साथ उदाहरण फ़ंक्शन के आउटपुट की तुलना करता है - इसका नतीजा यह निर्धारित करेगा कि यह उदाहरण "परीक्षण" पास के रूप में कार्य करता है या नहीं। यदि उदाहरण फ़ंक्शन में आउटपुट निर्दिष्ट नहीं है, go test केवल इसे संकलित करेगा लेकिन इसे निष्पादित नहीं करेगा।

चेक बाहर यह पेज: package godoctricks

इसके अलावा एक ब्लॉग लेख के बारे में उदाहरण कार्यों प्रकाशित किया गया है:

Testable Examples in Go