पुस्तकालय कोड के कार्यान्वयन की सूक्ष्मता। एक भाग

C ++ में लाइब्रेरी लिखते समय, कई को कोड लिखने और व्यवस्थित करने में कुछ कठिनाइयों का सामना करना पड़ता है। कुछ के पास पहले से तैयार समाधान हैं, दूसरों के पास नहीं हैं और वे इन समाधानों को खोजने की कोशिश कर रहे हैं।

लाइब्रेरी कोड लिखने में कुछ कठिनाइयाँ, जो "सेल्फ-डॉक्यूमेंटेशन" से अधिक चिंतित हैं, "वर्किंग" नेमस्पेस की मदद से हल की जा सकती हैं।

शुरू करने के लिए, हम इन कठिनाइयों का वर्णन करते हैं और सामान्य समाधान प्रस्तुत करते हैं।

मान लीजिए कि एक पुस्तकालय कुछ इकाई some_class को लागू करता है, जो उसे पुस्तकालय उपयोगकर्ता को प्रदान करता है। Some_class की परिभाषा detail_class लाइब्रेरी की एक अन्य इकाई पर निर्भर करती है, जो कार्यान्वयन का हिस्सा है और उपयोगकर्ता को प्रदान नहीं की जाती है। लाइब्रेरी को केवल हेडर फ़ाइलों के रूप में आपूर्ति की जाती है।

इस विषय में फ़ाइलों पर कोड का वितरण नहीं माना जाता है।

मानक समाधान 1

namespace lib_namespace { class detail_class { }; class some_class { public: //   private: detail_class a_; //    }; } 

इस समाधान का प्लस:
1) इसके कार्यान्वयन के लिए आवश्यक न्यूनतम मात्रा का कोड।

विपक्ष:
1) कोड का खराब "स्व-प्रलेखन"। कार्यान्वयन कक्षाएं के नाम से यह निर्धारित करना हमेशा संभव नहीं होता है कि वे उपयोगकर्ता-परिभाषित हैं या नहीं।
2) जंक लाइब्रेरी नेमस्पेस। इस नाम स्थान का उपयोग करते समय कुछ विकास वातावरण, यह दिखाएगा कि पुस्तकालय उपयोगकर्ता को क्या आवश्यकता नहीं है:

मानक समाधान 2

 namespace lib_namespace { namespace impl { class detail_class { }; }} namespace lib_namespace { class some_class { public: //   private: impl::detail_class a_; //    }; } 

यह समाधान पिछले दृष्टिकोण की कमियों को पूरी तरह से दूर कर देता है, लेकिन स्वयं को जोड़ता है:
1) एक अतिरिक्त नामस्थान की शुरूआत;
2) उपयोगकर्ता को प्रदान की गई किसी भी लाइब्रेरी क्लास में और lib_namespace में स्थित, इम्प्लीफिक्स :: प्रीफिक्स को सभी कार्यान्वयन तत्वों के लिए निर्दिष्ट किया जाना चाहिए।

लाभ:
1) अच्छा "स्व-दस्तावेज" कोड।

कार्यक्षेत्र नाम स्थान समाधान

 namespace work_lib_namespace { class detail_class { }; class some_class { public: //   private: detail_class a_; //    }; } namespace lib_namespace { using ::work_lib_namespace::some_class; } 

सभी लाइब्रेरी कोड को work_lib_namespace नामस्थान में होस्ट किया गया है। लाइब्रेरी को उपयोगकर्ता को प्रदान करने वाली सभी संस्थाओं का उपयोग करके मुख्य लाइब्रेरी नेमस्पेस में जोड़ा जाता है।

इस दृष्टिकोण का नुकसान:
1) एक अतिरिक्त नामस्थान की शुरूआत।

लाभ:
1) "स्व-दस्तावेज" कोड;
2) नामस्थान के अंदर some_ns नामस्थान का उपयोग करने की क्षमता (यहां तक ​​कि उन पुस्तकालय हेडर फ़ाइलों में जो उपयोगकर्ता सीधे कनेक्ट करता है):

 namespace work_lib_namespace { using namespace std; class detail_class { public: //  private: vector<int> data_; }; } 

निष्कर्ष

पुस्तकालय को व्यवस्थित करने की प्रस्तुत विधि, एक ओर, कोड के अच्छे "स्व-प्रलेखन" को प्राप्त करने की अनुमति देती है, और दूसरी ओर, पुस्तकालय डेवलपर्स को न केवल cpp कार्यान्वयन फ़ाइलों में नामस्थान का उपयोग करने की अनुमति देती है, बल्कि हेडर फ़ाइलों में भी।