इंडेंटेशन शैली

कंप्यूटर प्रोग्रामिंग में एक अभिस्थापन शैली प्रोग्राम संरचना को संप्रेषित करने के लिए कोड के ब्लॉक (प्रोग्रामिंग) के अभिस्थापन को नियंत्रित करने वाला एक सम्मेलन है। यह लेख फ्री-फॉर्म भाषाओं को संबोधित करता है जैसे [[सी (प्रोग्रामिंग भाषा)]] और इसके वंश अधिकांश अन्य प्रोग्रामिंग भाषाओं (विशेष रूप से मध्यम कोष्ठक प्रोग्रामिंग भाषा में) पर लागू हो सकते हैं जहां व्हॉट्सएप वर्ण अन्यथा नगण्य हैं। अभिस्थापन शैली प्रोग्रामिंग शैली का केवल एक पहलू है।

अभिस्थापन अधिकांश प्रोग्रामिंग भाषाओं की आवश्यकता नहीं है जहां इसे द्वितीयक संकेतन के रूप में उपयोग किया जाता है। इसके अतिरिक्त मांगपत्र मानव पाठकों को प्रोग्राम की संरचना को सही ढंग से व्यक्त करने में सहायता करती है। विशेष रूप से इसका उपयोग नियंत्रण प्रवाह निर्माणों जैसे स्थितियों या लूपों और उनके भीतर और बाहर निहित कोड के बीच की कड़ी को स्पष्ट करने के लिए किया जाता है। हालाँकि कुछ भाषाएँ जैसे कि पायथन (प्रोग्रामिंग भाषा) और ओकैम (प्रोग्रामिंग भाषा) धनुकोष्ठक या कीवर्ड का उपयोग करने के अतिरिक्त संरचना का निर्धारण करने के लिए अभिस्थापन का उपयोग करती हैं और इसे ऑफ-साइड नियम कहा जाता है। ऐसी भाषाओं में संकलक या दुभाषिया के लिए अभिस्थापन अर्थपूर्ण है। यह केवल एक स्पष्टता या शैली के विषय से अधिक है।

इस लेख में कोष्ठक को संदर्भित करने के लिए शब्द कोष्ठक का उपयोग किया गया है और मध्यम कोष्ठक को संदर्भित करने के लिए शब्द कोष्ठक का उपयोग किया गया है।

यौगिक कथनो में कोष्ठक स्थान

अभिस्थापन शैली के बीच मुख्य अंतर यौगिक कथन के धनुकोष्ठक लगाने में निहित है ({...}) जो प्रायः एक नियंत्रण कथन का अनुसरण करता है (if, while, for...). नीचे दी गई तालिका इस आलेख में चर्चा की गई बयानों की शैली के लिए इस स्थान को दर्शाती है कार्य घोषणा शैली एक और स्थितिया है। बयानों में कोष्ठक स्थान की शैली कार्य परिभाषा से भिन्न हो सकती है। स्थिरता के लिए प्रत्येक शैली की पसंदीदा अभिस्थापन गहराई को 4 रिक्त स्थान पर स्थिर रखा गया है।

Brace placement	Styles
while (x == y) { something(); something_else(); }	Allman
while (x == y) { something (); something_else (); }	GNU
while (x == y) { something(); something_else(); }	Whitesmiths
while (x == y) { something(); something_else(); }	K&R
while (x == y) { something(); something_else(); }	Ratliff
while (x == y) { something(); something_else(); }	Horstmann
while (x == y) { something(); something_else(); }	Pico
while (x == y) { something(); something_else(); }	Lisp
#define W(c,b) {while(c){b}} W(x==y,s();se();)	APL

टैब, रिक्त स्थान और अभिस्थापन का आकार

टैब के लिए प्रदर्शित चौड़ाई अधिकांश प्रोग्रामिंग संपादकों में मनमाने मूल्यों पर तय की जा सकती है जिसमें नोटपैड++ (एमएस-विंडोज), टेक्स्टएडिट (मैकओएस/एक्स), एमएसीएस (यूनिक्स), vi (यूनिक्स), और नैनो (यूनिक्स) सम्मिलित हैं। इसके अतिरिक्त इन संपादकों को विशिष्ट अभिस्थापन योजनाओं से मेल खाने के लिए टैब और रिक्त स्थान का मिश्रण उत्पन्न करने के लिए विन्यास किया जा सकता है। यूनिक्स में टैब की चौड़ाई को टर्मिनल पेजर में भी तय किया जा सकता है जैसे कम (यूनिक्स) और फ़िल्टर द्वारा फ्लाई पर परिवर्तित किया जा सकता है जैसे विस्तृत / अनएक्सपैंड।

यूनिक्स संपादक आठ स्तंभों के अंतराल पर स्थिति निर्धारण टैब के लिए गलत हैं जबकि मैक (कंप्यूटर) और माइक्रोसॉफ़्ट विंडोज़ | एमएस-विंडोज वातावरण चार कॉलमों के लिए गलत हैं। यह अंतर स्रोत कोड मिसलिग्न्मेंट का कारण बनता है जब टैब और रिक्त स्थान को मिलाने वाला अभिस्थापन एक विन्यास के तहत प्रदर्शित होता है जो लेखक के विन्यास से अलग टैब प्रदर्शित करता है।

हार्ड टैब और जगह के बीच चुनाव को लेकर प्रोग्रामरों के बीच बहस चल रही है। कई प्रारंभिक प्रोग्रामर मांगपत्र को टाइप करने में आसानी के लिए और स्रोत फ़ाइल आकार को बचाने के लिए टैब कुंजी वर्णों का उपयोग करते थे। कुछ प्रोग्रामर जैसे जेमी ज़विंस्की कहते हैं कि टैब के अतिरिक्त स्थान का उपयोग करने से क्रॉस-प्लेटफ़ॉर्म पोर्टेबिलिटी बढ़ जाती है। अन्य जैसे कि वर्डप्रेस कोडिंग मानकों के लेखक इसके विपरीत कहते हैं कि हार्ड टैब पोर्टेबिलिटी बढ़ाते हैं। गिटहब पर शीर्ष 400,000 कोष के एक सर्वेक्षण में पाया गया कि रिक्त स्थान अधिक सामान्य हैं।

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

उपकरण

अभिस्थापन शैलियों के बीच परिवर्तित करने के लिए कई उपकरण हैं जैसेमांगपत्रकई यूनिक्स जैसे प्रचालन तंत्र के साथ सम्मिलित एक प्रोग्राम है।

Emacs में हिटिंग सहित अभिस्थापन समस्याओं को स्वचालित रूप से ठीक करने के लिए विभिन्न कमांड उपलब्ध हैंटैबकिसी दिए गए पंक्ति पर (गलत विन्यास में)। M-x indent-regionकोड के बड़े हिस्से को ठीक से मांगपत्र करने के लिए इस्तेमाल किया जा सकता है। मोड के आधार पर Emacs प्रमुख अभिस्थापन जगह को रिक्त स्थान के बाद उचित संख्या में टैब के साथ बदल सकता है, जिसके परिणामस्वरूप प्रत्येक स्रोत पंक्ति को मांगपत्र करने के लिए वर्णों की न्यूनतम संख्या होती है।

लोचदार टैबस्टॉप एक सारणीकरण शैली है जिसे पाठ संपादक से समर्थन की आवश्यकता होती है जहां ब्लॉक में एक पंक्ति की लंबाई बदलने पर टेक्स्ट के पूरे ब्लॉक को स्वचालित रूप से संरेखित रखा जाता है।

शैलियाँ

के एंड आर शैली

के एंड आर शैली (कर्निघन और रिची शैली) और हैकर शब्दजाल में बारीकी से संबंधित एक सच्ची कोष्ठक शैली (1TBS के रूप में संक्षिप्त) प्राय: सी, सी ++, और अन्य मध्यम-कोष्ठक प्रोग्रामिंग भाषाओं में उपयोग की जाती हैं। यह मूल यूनिक्स कर्नेल, ब्रायन कर्निघन और डेनिस रिची में इस्तेमाल की जाने वाली शैली थी। रिची की पुस्तक द [[मध्यम-कोष्ठक प्रोग्रामिंग भाषा ]] साथ ही कर्निघन और पी. जे. प्लेगर की पुस्तक प्रोग्रामिंग शैली के तत्व के एंड आर का पालन करते समय प्रत्येक कार्य में अगली पंक्ति में उसी अभिस्थापन स्तर पर उसके शीर्षलेख के रूप में उद्घाटन कोष्ठक होता है, धनुकोष्ठक के भीतर बयान मांगपत्र होते हैं और अंत में समापन कोष्ठक कार्य के शीर्षलेख के समान अपनी खुद की एक पंक्ति में अभिस्थापन स्तर पर होता है।

एक कार्य के अंदर बहु-पंक्ति ब्लॉक हालांकि उनके संबंधित नियंत्रण बयानों के समान पंक्ति पर उनके उद्घाटन धनुकोष्ठक होते हैं। समापन धनुकोष्ठक स्वयं की एक पंक्ति में रहते हैं जब तक कि एक कीवर्ड द्वारा पीछा नहीं किया जाताelse या whileइस तरह के गैर-टाइपोग्राफिक संरेखण धनुकोष्ठक को मिस्र के धनुकोष्ठक से जाना जाता है जो प्राचीन मिस्र के कुछ काल्पनिक पोज़ में हथियारों के समान हैं। के एंड आर में सिंगल-पंक्ति ब्लॉक में धनुकोष्ठक नहीं होते हैं।

int main(int argc, char *argv[])
{
    ...
    while (x == y) {
        something();
        something_else();

        if (some_error)
            do_correct(); // In K&R a single-statement block does not have braces.
        else
            continue_as_usual();
    }

    final_thing();
    ...
}

सी प्रोग्रामिंग भाषा प्रभाव इस शैली को स्पष्ट रूप से निर्दिष्ट नहीं करता है हालांकि पूरी किताब में इसका लगातार पालन किया जाता है। पुस्तक से धनुकोष्ठक की स्थिति कम महत्वपूर्ण है हालांकि लोग भावुक विश्वास रखते हैं। हमने कई लोकप्रिय शैलियों में से एक को चुना है।

सी भाषा के पुराने संस्करणों में तर्क प्रकारों को बाद की पंक्ति पर घोषित करने की आवश्यकता होती है (यानी कार्य के शीर्षलेख के ठीक बाद):

   /* कार्य प्रोटोटाइप के बिना मूल प्री-आईएसओ सी स्टाइल */

/* Original pre-ISO C style without function prototypes */
int main(argc, argv)
    int   argc;
    char  *argv[];
{
    ...
}

वैरिएंट: 1TBS (OTBS)

एक सच्ची कोष्ठक शैली (1TBS या OTBS के रूप में संक्षिप्त के एंड आर के समान है। मुख्य दो अंतर यह हैं कि कार्यों में उनके शुरुआती धनुकोष्ठक एक ही पंक्ति पर एक स्थान से अलग होते हैं और यह कि धनुकोष्ठक को नियंत्रण कथन के लिए छोड़ा नहीं जाता है इसके दायरे में केवल एक कथन होता है।

इस शैली में नए कोड पंक्तिों के सम्मिलन की अनुमति देने वाले निर्माण अलग-अलग पंक्तिपर होते हैं और सम्मिलन को प्रतिबंधित करने वाले निर्माण एक पंक्ति पर होते हैं। इस सिद्धांत को एकल-पंक्ति सशर्त सहित आदि को मजबूत करके बढ़ाया जाता है ताकि कोड की एक नई पंक्ति को कहीं भी सम्मिलित करना हमेशा सुरक्षित रहे (यानी इस तरह के सम्मिलन से निष्पादन का प्रवाह असहमत नहीं होगा)।

इस शैली के सुझाए गए फायदे यह हैं कि शुरुआती कोष्ठक को अकेले अतिरिक्त पंक्ति की आवश्यकता नहीं होती है और समापन कोष्ठक उस कथन के साथ पंक्ति ऊपर करता है जो वैचारिक रूप से संबंधित है। इस शैली की एक लागत यह है कि एक ब्लॉक के अंतिम कोष्ठक को अकेले एक पूरी पंक्ति की आवश्यकता होती है जिसे आंशिक रूप से if/else ब्लॉक और डू/जबकि ब्लॉक में हल किया जा सकता है:

void check_negative(x) {
    if (x < 0) {
        puts("Negative");
    } else {
        nonnegative(x);
    }
}

द वन ट्रू कोष्ठक शैली के कई उल्लेख हैं लेकिन इसके वास्तविक रूप को लेकर कुछ भ्रम है। कुछ सूत्रों का कहना है कि यह ऊपर निर्दिष्ट भिन्नता हैजबकि अन्य ध्यान दें कि यह के एंड आर के लिए सिर्फ एक और हैकर शब्दजाल के रूप में है।

संस्करण: लिनक्स कर्नेल

के एंड आर शैली का एक लघु संस्करण लिनक्स कर्नेल शैली है जो लिनक्स कर्नेल के स्रोत ट्री में इसके व्यापक उपयोग के लिए जानी जाती है। लिनस टोरवाल्ड्स दृढ़ता से सभी योगदानकर्ताओं को इसका पालन करने की सलाह देते हैं। शैली के एंड आर से कई तत्वों को उधार लेती है।

कर्नेल शैली अभिस्थापन के लिए टैब का विश्राम स्थान का उपयोग करती है (टैब स्टॉप प्रत्येक 8 वर्ण तय करता है)। किसी कार्य के मध्यम धनुकोष्ठक को खोलना कार्य हेडर के बाद पंक्ति की शुरुआत में जाता है। कोई भी अन्य खुला मध्यम धनुकोष्ठक उसी पंक्ति पर चलते हैं जिस पर संबंधित कथन एक जगह द्वारा अलग किया जाता है। ए में स्तर स्विचबयान संलग्न ब्लॉक के साथ गठबंधन कर रहे हैं (मांगपत्र का केवल एक स्तर है)। पंक्ति की लंबाई 80 वर्णों तक सीमित हुआ करती थी – इसे 2020 में बढ़ाकर 100 कर दिया गया था लेकिन मूल सीमा को अभी भी पसंद किया जाता है। यौगिक कथन के एकल-विधान शरीर को मध्यम धनुकोष्ठक से घिरा नहीं होना चाहिए। यदि एक में एक या एक से अधिक सब कथनif-else कथन में धनुकोष्ठक की आवश्यकता होती है तो दोनों सब कथन को मध्यम धनुकोष्ठक के अंदर लपेटा जाना चाहिए:

int power(int x, int y)
{
        int result;

        if (y < 0) {
                result = 0;
        } else {
                result = 1;
                while (y-- > 0)
                        result *= x;
        }
        return result;
}

संस्करण: अनिवार्य धनुकोष्ठक

कुछ लोग अपने दायरे में केवल एक कथन के साथ नियंत्रण बयानों के लिए अनिवार्य धनुकोष्ठक की वकालत करते हैं यानी एक पंक्ति सशर्त समेत जबकि इत्यादि को कोष्ठक करना ताकि कहीं भी कोड की एक नई पंक्ति का सम्मिलन हमेशा सुरक्षित रहे।

इस शैली की लागत यह है कि अंतिम ब्लॉक के लिए एक अतिरिक्त पूर्ण पंक्ति की आवश्यकता होती है (मध्यवर्ती ब्लॉकों को छोड़कर if/else निर्माण करता है)।

संस्करण: जावा

जबकि जावा (प्रोग्रामिंग भाषा) को कभी-कभी अन्य शैलियों में लिखा जाता है जावा कोड का एक महत्वपूर्ण निकाय के एंड आर शैली के एक सामान्य संस्करण का उपयोग करता है जिसमें खुला कोष्ठक एक ही पंक्ति पर होता है न कि केवल एक कार्य के अंदर ब्लॉक के लिए लेकिन कक्षा या विधि घोषणाओं के लिए भी।

यह शैली काफी हद तक व्यापक है क्योंकि सन सूक्ष्मतंत्र की मूल शैली मार्गदर्शक करती है इस के एंड आर संस्करण का उपयोग किया और परिणामस्वरूप वर्ग ग्रंथालय के लिए अधिकांश मानक स्रोत कोड इस शैली में लिखे गए हैं। यह ऑलमैन शैली के साथ-साथ एक्शनस्क्रिप्ट और जावास्क्रिप्ट के लिए भी एक लोकप्रिय अभिस्थापन शैली है।

संस्करण: स्ट्रॉस्ट्रुप

स्ट्रॉस्ट्रुप शैली बज़्ने स्ट्रॉस्ट्रुप का सी ++ के लिए के एंड आर शैली का अनुकूलन है जैसा कि उनकी पुस्तकों में प्रयोग किया जाता है जैसे कि प्रोग्रामिंग सिद्धांतों और अभ्यास का उपयोग करना सी ++ और सी ++ प्रोग्रामिंग भाषा

ऊपर दिए गए वेरिएंट के विपरीत स्ट्रॉस्ट्रुप एक कडलड एल्स का उपयोग नहीं करता है। इस प्रकार स्ट्राउस्ट्रप लिखेंगे:

    if (x < 0) {
        puts("Negative");
        negative(x);
    }
    else {
        puts("Non-negative");
        nonnegative(x);
    }

स्ट्रॉस्ट्रुप कक्षाओं के लिए के एंड आर शैली का विस्तार करता है उन्हें निम्नानुसार लिखता है:

    class Vector {
    public:
        Vector(int s) :elem(new double[s]), sz(s) { }   // construct a Vector
        double& operator[](int i) { return elem[i]; }   // element access: subscripting
        int size() { return sz; }
    private:
        double * elem;    // pointer to the elements
        int sz;           // number of elements
    };

स्ट्रॉस्ट्रुप स्तर को मांगपत्र नहीं करता है public:और private: इसके अतिरिक्त इस शैली में जबकि एक कार्य की खुला कोष्ठक एक नई पंक्ति पर शुरू होती है एक क्लास की खुला कोष्ठक उसी पंक्ति पर होती है जिस पर क्लास का नाम होता है।

स्ट्रॉस्ट्रुप छोटे कार्यों को एक पंक्ति में लिखने की अनुमति देता है। स्ट्राउस्ट्रप शैली एक नामांकित अभिस्थापन शैली है जो संपादक Emacs में उपलब्ध है। स्ट्रॉस्ट्रुप अपने आधुनिक सी++ कोर दिशानिर्देशों में बताए गए अनुसार सी++ के साथ एक के एंड आर-व्युत्पन्न शैली लेआउट को प्रोत्साहित करता है।

वैरिएंट: बीएसडी केएनएफ

कर्नेल सामान्य रूप भी कहा जाता है, यह बर्कले सॉफ्टवेयर वितरण (BSD) प्रचालन तंत्र में उपयोग किए जाने वाले अधिकांश कोड का रूप है। हालांकि ज्यादातर कर्नेल कोड के लिए अभिप्रेत है, यह यूजरलैंड (कंप्यूटिंग) कोड में भी व्यापक रूप से उपयोग किया जाता है। बेल लैब्स संस्करण 6 और 7 यूनिक्स स्रोत कोड में उपयोग किए जाने के रूप में यह अनिवार्य रूप से के एंड आर शैली का एक पूरी तरह से प्रलेखित संस्करण है।

SunOS कर्नेल और यूजरलैंड एक समान अभिस्थापन शैली का उपयोग करते हैं।केएनएफ की तरह यह भी एटी एंड टी शैली के दस्तावेजों पर आधारित था और इसे कभी-कभी बिल जॉय नॉर्मल फॉर्म भी कहा जाता है। SunOS दिशानिर्देश 1996 में प्रकाशित हुआ था और एएनएसआई सी पर संक्षेप में चर्चा की गई है। स्रोत फ़ाइलों की सूची के अभिस्थापन की शुद्धता को बिल शैनन द्वारा लिखित cstyle प्रोग्राम द्वारा सत्यापित किया जा सकता है।

इस शैली में कठिन सारणी (ts in vi) को आठ कॉलम में रखा जाता है जबकि एक सॉफ्ट सारणी को प्रायः एक सहायक (sw in vi) के रूप में भी परिभाषित किया जाता है और चार पर तय किया जाता है। कठिन सारणी का उपयोग कोड ब्लॉक मांगपत्र करने के लिए किया जाता है जबकि अतिरिक्त अभिस्थापन के सॉफ्ट सारणी (चार रिक्त स्थान) का उपयोग उन सभी निरंतर पंक्तिओ के लिए किया जाता है जिन्हें कई पंक्ति में विभाजित किया जाना चाहिए।

इसके अतिरिक्त कार्य कॉल कोष्ठक से पहले एक स्थान का उपयोग नहीं करते हैं हालांकि सी-भाषा मूल कथन जैसे if, while, do, switch और return। ऐसे कार्य जो अपने शीर्ष-स्तरीय ब्लॉक में कोई स्थानीय चर घोषित नहीं करते हैं उनके शुरुआती ब्लॉक कोष्ठक के बाद भी एक खाली पंक्ति छोड़नी चाहिए।

यहाँ कुछ नमूने देखें:

while (x == y) {
        something();
        something_else();
}
final_thing();

if (data != NULL && res > 0) {
        if (JS_DefineProperty(cx, o, "data",
            STRING_TO_JSVAL(JS_NewStringCopyN(cx, data, res)),
            NULL, NULL, JSPROP_ENUMERATE) != 0) {
                QUEUE_EXCEPTION("Internal error!");
                goto err;
        }
        PQfreemem(data);
} else {
        if (JS_DefineProperty(cx, o, "data", OBJECT_TO_JSVAL(NULL),
            NULL, NULL, JSPROP_ENUMERATE) != 0) {
                QUEUE_EXCEPTION("Internal error!");
                goto err;
        }
}

static JSBool
pgresult_constructor(JSContext *cx, JSObject *obj, uintN argc,
    jsval *argv, jsval *rval)
{

        QUEUE_EXCEPTION("PGresult class not user-instantiable");

        return (JS_FALSE);
}

ऑलमैन शैली

ऑलमैन शैली का नाम एरिक एलमैन के नाम पर रखा गया है। इसे कभी-कभी बीएसडी शैली भी कहा जाता है क्योंकि ऑलमैन ने बर्कले सॉफ्टवेयर वितरण यूनिक्स के लिए कई उपयोगिताओं को लिखा था (हालांकि इसे अलग-अलग बीएसडी केएनएफ शैली के साथ भ्रमित नहीं होना चाहिए; ऊपर देखें)।

यह शैली अगली पंक्ति पर नियंत्रण कथन से जुड़े कोष्ठक को नियंत्रण कथन के समान स्तर पर मांगपत्र करती है।

while (x == y)
{
    something();
    something_else();
}

final_thing();

यह शैली पास्कल (प्रोग्रामिंग भाषा) भाषाओं और कारोबार-एसक्यूएल द्वारा उपयोग किए जाने वाले मानक अभिस्थापन के समान है जहां धनुकोष्ठक कीवर्ड के बराबर हैं I begin और end.

(* Example Allman code indentation style in Pascal *)
procedure dosomething(x, y: Integer);
begin
    while x = y do
    begin
        something();
        something_else();
    end;
end;

इस शैली के परिणाम यह हैं कि मांगपत्र कोड स्पष्ट रूप से उन पंक्तियों के द्वारा युक्त कथन से अलग होता है जो लगभग सभी व्हाइट जगह वर्ण होते हैं और समापन कोष्ठक उसी कॉलम में होते हैं जो उद्घाटन कोष्ठक के रूप में होते हैं। कुछ लोगों को लगता है कि इससे मिलान धनुकोष्ठक ढूंढना आसान हो जाता है। अवरुद्ध शैली संबंधित नियंत्रण कथन से कोड के ब्लॉक को भी चित्रित करती है। नियंत्रण कथन या कोड के ब्लॉक या कोड पुनर्रचना पर टिप्पणी करने या हटाने से लटकने या लापता धनुकोष्ठक के माध्यम से वाक्य - विन्यास त्रुटियों को प्रस्तुत करने की संभावना कम होती है। साथ ही यह बाहरी कार्य ब्लॉक के लिए कोष्ठक स्थान के अनुरूप है।

उदाहरण के लिए निम्नलिखित अभी भी वाक्य रचनात्मक रूप से सही है:

// while (x == y)
{
    something();
    something_else();
}

As is this:

    int c;
#ifdef HAS_GETCH
    while ((c = getch()) != EOF)
#else
    while ((c = getchar()) != EOF)
#endif
    {
        do_something(c);
    }

वैरिएंट: ऑलमैन-8

शिक्षा में उपयोग के लिए एक लोकप्रिय संस्करण ऑलमैन-8 8-जगह अभिस्थापन टैब और के एंड आर के लिनक्स कर्नेल वेरिएंट की 80-कॉलम सीमा का उपयोग करता है। शैली कथित तौर पर प्रोजेक्टर पर पठनीयता में सुधार करने में सहायता करती है। साथ ही अभिस्थापन आकार और कॉलम प्रतिबंध कोड ब्लॉक के अत्यधिक नेस्टिंग की पहचान करने के लिए एक दृश्य क्यू बनाने में सहायता करता है। ये लाभ नए डेवलपर्स और शिक्षार्थियों को कोड जटिलता को प्रबंधित करने के लिए निहित मार्गदर्शन प्रदान करने में सहायता करने के लिए गठबंधन करते हैं।

व्हाइटस्मिथ शैली

व्हाइटस्मिथ शैली जिसे कभी-कभी विशरट शैली भी कहा जाता है मूल रूप से पहले वाणिज्यिक सी संकलक, व्हाइटस्मिथ संकलक के लिए प्रलेखन में उपयोग की गई थी। यह विंडोज के शुरुआती दिनों में भी लोकप्रिय था क्योंकि इसका उपयोग तीन प्रभावशाली विंडोज प्रोग्रामिंग किताबों में किया गया था, डेविड ड्यूरेंट, कार्लसन की क्षमता और पॉल याओ द्वारा प्रोग्रामर गाइड टू विंडोज, चार्ल्स पेटज़ोल्ड द्वारा प्रोग्रामिंग विंडोज और पीटर द्वारा विंडोज 3.0 पावर प्रोग्रामिंग तकनीक नॉर्टन और याओ।

जार्गन फ़ाइल के अनुसार व्हाईटस्मिथ, ऑलमैन शैली के साथ समान लोकप्रियता के साथ सबसे आम कोष्ठकिंग शैली रही है।

यह शैली नियंत्रण कथन से जुड़े कोष्ठक को अगली पंक्ति पर मांगपत्र करती है। धनुकोष्ठक के भीतर कथन् को धनुकोष्ठक के समान स्तर पर मांगपत्र किया जाता है।

रैटलिफ़ शैली की तरह समापन कोष्ठक को धनुकोष्ठक के भीतर बयानों के समान ही मांगपत्र किया जाता है।

while (x == y)
    {
    something();
    something_else();
    }

final_thing();

इस शैली के फायदे ऑलमैन शैली के समान हैं। ब्लॉक स्पष्ट रूप से नियंत्रण बयानों से अलग हैं। ब्लॉक के साथ धनुकोष्ठक का संरेखण इस बात पर जोर देता है कि पूर्ण ब्लॉक संकल्पनात्मक और प्रोग्रामेटिक रूप से एक मिश्रित कथन है। धनुकोष्ठक को मांगपत्र करना इस बात पर जोर देता है कि वे नियंत्रण कथन के अधीन हैं। अंतिम कोष्ठक अब कथन के अनुरूप नहीं है बल्कि खुला कोष्ठक के साथ है।

एक उदाहरण:

if (data != NULL && res > 0)
    {
    if (!JS_DefineProperty(cx, o, "data", STRING_TO_JSVAL(JS_NewStringCopyN(cx, data, res)), NULL, NULL, JSPROP_ENUMERATE))
        {
        QUEUE_EXCEPTION("Internal error!");
        goto err;
        }
    PQfreemem(data);
    }
else if (!JS_DefineProperty(cx, o, "data", OBJECT_TO_JSVAL(NULL), NULL, NULL, JSPROP_ENUMERATE))
    {
    QUEUE_EXCEPTION("Internal error!");
    goto err;
    }

else ifप्रीप्रोसेसर कथन की तरह कथन के रूप में माना जाता है।

जीएनयू शैली

1. ऑलमैन शैली और व्हाईटस्मिथ्स शैली शैली की तरह जीएनयू शैली एक पंक्ति पर खुद से धनुकोष्ठक लगाती है, दो जगह द्वारा मांगपत्र किया जाता है सिवाए कार्य परिभाषा को जहां वे मांगपत्र नहीं होते हैं। किसी भी स्थिति में निहित कोड को धनुकोष्ठक से दो रिक्त स्थान द्वारा मांगपत्र किया जाता है।

रिचर्ड स्टालमैन द्वारा लोकप्रिय लेआउट लिस्प (प्रोग्रामिंग भाषा) कोड लिखने की उनकी पृष्ठभूमि से प्रभावित हो सकता है। लिस्प में एक ब्लॉक (एक प्रोग्न) के बराबर एक प्रथम श्रेणी की डेटा इकाई है और इसे अपना अभिस्थापन स्तर देने से उस पर जोर देने में सहायता मिलती है जबकि सी में एक ब्लॉक केवल वाक्य - विन्यास है। यह शैली 1960 और 1970 के दशक की कुछ ALGOL और XPL प्रोग्रामिंग भाषा पाठ्यपुस्तकों में भी पाई जा सकती है। हालांकि सीधे अभिस्थापन से संबंधित नहीं है। जीएनयू कोडिंग शैली में कार्य के तर्कों की ब्रैकेटेड सूची से पहले एक स्थान भी सम्मिलित है।

static char *
concat (char *s1, char *s2)
{
  while (x == y)
    {
      something ();
      something_else ();
    }
  final_thing ();
}

यह शैली ऑलमैन शैली और व्हाईटस्मिथ शैली के लाभों को जोड़ती है जिससे ब्लॉक से बाहर नहीं खड़े होने वाले धनुकोष्ठक के संभावित व्हाइटस्मिथ नुकसान को दूर किया जाता है। एक नुकसान यह है कि अंतिम कोष्ठक अब उस कथन के अनुरूप नहीं है जिससे यह अवधारणात्मक रूप से संबंधित है। एक और संभावित नुकसान यह है कि यह एक वैचारिक स्तर के लिए मांगपत्र के दो दृश्य स्तरों का उपयोग करके स्थान को बर्बाद कर सकता है लेकिन वास्तव में यह संभावना नहीं है क्योंकि एकल-स्तरीय अभिस्थापन वाले तंत्र में प्रत्येक स्तर प्राय: कम से कम 4 रिक्त स्थान होता है जैसा कि 2 * जीएनयू शैली में 2 रिक्त स्थान।

जीएनयू कोडिंग मानक इस शैली की अनुशंसा करते हैं और जीएनयू परियोजना सॉफ़्टवेयर के लगभग सभी अनुरक्षक इसका उपयोग करते हैं।

जीएनयू Emacs टेक्स्ट एडिटर और जीएनयू तंत्र का मांगपत्र (यूनिक्स) कमांड गलत रूप से इस शैली के अनुसार कोड को रिफॉर्मेट करेगा। जो लोग जीएनयू Emacs या समान रूप से अनुकूलन योग्य संपादकों का उपयोग नहीं करते हैं। उनके संपादक की स्वचालित अभिस्थापन शैली के लिए अनुपयोगी हैं। हालांकि केएनएफ शैली के लिए खराब करने वाले कई संपादक जीएनयू शैली के साथ अच्छी तरह से सामना करते हैं जब टैब की चौड़ाई दो स्थानों पर तय होती है। इसी तरह जीएनयू Emacs केवल टैब की चौड़ाई को आठ स्थानों पर तय करके केएनएफ शैली के अनुकूल हो जाता है। दोनों ही स्थिति में स्वचालित सुधार मूल रिक्ति को नष्ट कर देता है लेकिन स्वचालित पंक्ति मांगपत्र ठीक से काम करेगी।

स्टीव मैककोनेल अपनी पुस्तक कोड पूर्ण में इस शैली का उपयोग करने के विपरीत सलाह देते हैं। वह एक कोड नमूना चिह्नित करता है जो कोडिंग हॉरर आइकन के साथ इसका उपयोग करता है।विशेष रूप से खतरनाक कोड का प्रतीक है और कहता है कि यह पठनीयता को बाधित करता है। लिनक्स कर्नेल कोडिंग शैली प्रलेखन भी इस शैली के विपरीत दृढ़ता से अनुशंसा करता है और पाठकों से जीएनयू कोडिंग मानकों की एक प्रति को एक महान प्रतीकात्मक संकेत के रूप में जलाने का आग्रह करता है।

होर्स्टमैन शैली

के एस. होर्स्टमैन द्वारा सह संगणकीय संकल्पना सी++ एसेंशियल्स का 1997 का संस्करण खुला कोष्ठक के समान पंक्ति पर एक ब्लॉक के पहले कथन को रखकर ऑलमैन शैली को अपनाता है। इस शैली का उपयोग जेन्सेन और विर्थ के पास्कल उपयोगकर्ता पुस्तिका और प्रतिवेदन के उदाहरणों में भी किया जाता है।

  जबकि (एक्स == वाई)

while (x == y)
{   something();
    something_else();
    //...
    if (x < 0)
    {   printf("Negative");
        negative(x);
    }
    else
    {   printf("Non-negative");
        nonnegative(x);
    }
}
final_thing();

यह शैली के एंड आर शैली की एक पंक्ति की बचत के साथ पठनीयता के लिए धनुकोष्ठक के ऊर्ध्वाधर संरेखण को बनाए रखते हुए और आसानी से ब्लॉक की पहचान करके ऑलमैन शैली के लाभों को जोड़ती है। हालाँकि 2003 का संस्करण अब ऑलमैन शैली का उपयोग करता है।

पिको शैली

यह शैली पिको (प्रोग्रामिंग भाषा) भाषा में इसके डिजाइनरों द्वारा सबसे अधिक उपयोग की जाती है। पिको में वापिस कथन का अभाव है और समापक के अतिरिक्त अर्धविराम को कथन विभाजक के रूप में उपयोग करता है। यह इस वाक्यविन्यास को उत्पन्न करता है:

stuff(n):
{ x: 3 * n;
  y: do_stuff(x);
  y + x }

फायदे और नुकसान के एंड आर शैली के साथ स्क्रीन रियल एस्टेट को बचाने के समान हैं। एक अतिरिक्त लाभ यह है कि प्रारंभिक और समापन धनुकोष्ठक के एंड आर शैली के सापेक्ष अनुप्रयोग में सुसंगत हैं (दोनों कोड की एक पंक्ति के साथ स्थान साझा करते हैं) जहां एक कोष्ठक कोड की एक पंक्ति के साथ स्थान साझा करता है और एक कोष्ठक में केवल एक पंक्ति होती है।

रैटलिफ शैली

प्रोग्रामर एट वर्क पुस्तक में सी. वेन रैटलिफ़ ने नीचे दी गई शैली का उपयोग करते हुए चर्चा की। शैली 1TBS की तरह शुरू होती है लेकिन फिर नेस्टेड ब्लॉक के अभिस्थापन के साथ समापन कोष्ठक पंक्ति ऊपर हो जाती है। रैटलिफ़ लोकप्रिय dBase-II और -III चौथी पीढ़ी की प्रोग्रामिंग भाषाओं के पीछे मूल प्रोग्रामर थे। उन्होंने संकेत दिया कि यह मूल रूप से डिजिटल अनुसंधान इंक से सामग्री में प्रलेखित था। इस शैली को कभी-कभी बैनर शैली कहा जाता है इस शैली में जो कि व्हाईटस्मिथ शैली के लिए है जैसे के एंड आर ऑलमैन के लिए है। समापन नियंत्रण को सूची में अंतिम वस्तु के समान ही मांगपत्र किया गया है।शैली कुछ लोगों के लिए दृश्य स्कैनिंग को आसान बना सकती है क्योंकि किसी भी ब्लॉक के हेडर ही उस स्तर पर प्रचलित होते हैं (सिद्धांत यह है कि पूर्व ब्लॉक का समापन नियंत्रण के एंड आर में अगले ब्लॉक हेडर के दृश्य प्रवाह के साथ हस्तक्षेप करता है और ऑलमैन शैली)। सॉफ्टवेयर उपकरण मे रैटफोर कोड में कर्निघन और प्लेगर इस शैली का उपयोग करते हैं।

 // In C
 for (i = 0; i < 10; i++) {
     if (i % 2 == 0) {
         do_something(i);
         }
     else {
         do_something_else(i);
         }
     }

or, in a markup language...

{|
|-
| lots of stuff...
      more stuff
      || alternative for short lines || etc. 
|}


{|
|-
... etc
|}

लिस्प शैली

एक प्रोग्रामर यहां तक ​​कि एक ब्लॉक की अंतिम पंक्ति में समापन धनुकोष्ठक डालने के लिए भी जा सकता है। यह शैली अभिस्थापन को कोड के ब्लॉकों को अलग करने का एकमात्र तरीका बनाती है लेकिन इसमें बिना सूचना वाली पंक्ति होने का लाभ है। इसे आसानी से लिस्प शैली कहा जा सकता है (क्योंकि यह शैली लिस्प कोड में बहुत आम है) या पायथन शैली (पायथन में कोई धनुकोष्ठक नहीं है लेकिन लेआउट बहुत समान है जैसा कि नीचे दिए गए कोड ब्लॉक में दिखाया गया है)। पायथन में लेआउट भाषा का एक हिस्सा है जिसे ऑफ़-साइड नियम कहा जाता है।

// In C
for (i = 0; i < 10; i++)
    {if (i % 2 == 0)
        {do_something(i);}
     else
        {do_something_else(i);
         do_third_thing(i);}}

पायथन में  

# In Python
for i in range(10):
    if i % 2 == 0:
        do_something(i)
    else:
        do_something_else(i)
        do_third_thing(i)

 

;; In Lisp
(dotimes (i 10)
  (if (= (rem i 2) 0)
      (do-something i)
    (progn
      (do-something-else i)
      (do-third-thing i))))

हास्केल शैली

हास्केल (प्रोग्रामिंग भाषा) लेआउट धनुकोष्ठक के स्थान को वैकल्पिक बना सकता है हालांकि भाषा में धनुकोष्ठक और अर्धविरामों की अनुमति है। नीचे दिए गए दो खंड संकलक के लिए समान रूप से स्वीकार्य हैं:

braceless = do
  text <- getContents
  let
    firstWord = head $ words text
    bigWord = map toUpper firstWord
  putStrLn bigWord

braceful = do
  { text <- getContents
  ; let
      { firstWord = head $ words text
      ; bigWord = map toUpper firstWord
      }
  ; putStrLn bigWord
  }

 

हास्केल में लेआउट धनुकोष्ठक को बदल सकता है। प्राय: प्रक्रियात्मक प्रोग्रामिंग के लिए धनुकोष्ठक और अर्धविराम छोड़े जाते हैंdoवर्गों और सामान्य रूप से कार्यक्रम पाठ लेकिन शैली का उपयोग प्राय: सूचियों, अभिलेखों और अन्य वाक्य-विन्यास तत्वों के लिए किया जाता है जो कोष्ठक या धनुकोष्ठक की कुछ जोड़ी से बना होता है जो अल्पविराम या अर्धविराम से अलग होते हैं। यदि कोड कीवर्ड का अनुसरण करता हैwhere, letया ofधनुकोष्ठक और अर्धविराम छोड़ देता है तो अभिस्थापन महत्वपूर्ण है।

एपीएल शैली

प्राय: एपीएल कितना संक्षिप्त है इसके उदाहरण के लिए यहां जीवन का नाटक के लिए स्टेप कार्य का कार्यान्वयन है:

जीवन←{⊃1⍵∨.∧3 4=+/+⌿¯1 0 1∘.⊖¯1 0 1⌽¨⊂⍵}

एपीएल (प्रोग्रामिंग भाषा) शैली सी एपीएल कोड की संक्षिप्त शैली जैसा दिखता है और प्राय: उनके कार्यान्वयन में उपयोग किया जाता है। इस शैली का नेतृत्व आर्थर व्हिटनी (कंप्यूटर वैज्ञानिक) द्वारा किया गया था और इसका उपयोग के (प्रोग्रामिंग भाषा) आर्थर की अपनी परियोजना के कार्यान्वयन में किया जाता है। J (प्रोग्रामिंग भाषा ) प्रोग्रामिंग भाषा को भी इस शैली में लागू किया गया है। विशेष रूप से एपीएल के सभी कार्यान्वयन C की इस शैली का उपयोग नहीं करते हैं अर्थात् जीएनयू एपीएल।

एपीएल शैली सी अभिस्थापन के अतिरिक्त प्राय: नामों को एकल या दोहरे वर्णों में छोटा किया जाता है अभिस्थापन की मात्रा को कम करने के लिए और कई पंक्तियों में फैले भाव।

अन्य विचार

ब्लॉक का ट्रैक खोना

कुछ स्थितियों में ब्लॉक सीमाओं का ट्रैक खोने का डर होता है। यह प्रायः कोड के बड़े वर्गों में देखा जाता है जिसमें अभिस्थापन के कई स्तरों के लिए नेस्टेड कई यौगिक कथन होते हैं। जब तक प्रोग्रामर नेस्टेड कथन के एक विशाल तय के नीचे स्क्रॉल करता है तब तक हो सकता है कि वे इस बात का ट्रैक खो चुके हों कि कौन से नियंत्रण कथन कहां जाते हैं। हालाँकि अत्यधिक लंबे कोड के अन्य कारण हो सकते हैं जैसे कि बहुत अधिक चक्रीय जटिलता और इस समस्या का सामना करने वाला एक प्रोग्रामर इसके अतिरिक्त विचार कर सकता है कि क्या कोड पुनर्रचना लंबी अवधि में सहायता करेगा।

प्रोग्रामर जो शुरुआती धनुकोष्ठक की गिनती पर भरोसा करते हैं उन्हें के एंड आर जैसे अभिस्थापन शैलियों में कठिनाई हो सकती है जहां शुरुआती कोष्ठक अपने नियंत्रण प्रवाह से दृष्टि से अलग नहीं होते हैं। प्रोग्रामर जो अभिस्थापन पर अधिक भरोसा करते हैं उन शैलियों से अधिक लाभ प्राप्त करेंगे जो लंबवत रूप से कॉम्पैक्ट हैं जैसे के एंड आर क्योंकि ब्लॉक छोटे हैं।

जैसे नियंत्रण बयानों का ट्रैक खोने से बचने के लिए forएक बड़े अभिस्थापन का उपयोग किया जा सकता है जैसे कि 8-यूनिट-चौड़ा हार्ड टैब बड़े कार्यों को छोटे और अधिक पठनीय कार्यों में विभाजित करने के साथ। लिनक्स इस तरह से किया जाता है जबकि के एंड आर शैली का उपयोग किया जाता है।

vi परिवार के पाठ संपादकों में ब्लॉक सीमाओं को ट्रैक करने का एक तरीका यह है कि टेक्स्ट कर्सर को धनुकोष्ठक में से किसी एक पर रखें और दबाएं % चाबी। इसके बाद कर्सर विपरीत कोष्ठक पर कूद जाता है। चूंकि टेक्स्ट कर्सर next कुंजी (अर्थातnkey) ने दिशात्मक स्थिति निर्धारण जानकारी को बनाए रखा (चाहे up या down कुंजी को पहले दबाया गया था)मैक्रो (कंप्यूटर विज्ञान) कीबोर्ड और माउस मैक्रोज़ (. key) का उपयोग टेक्स्ट कर्सर को अगले कोष्ठक पर रखने के लिए किया जा सकता है एक उपयुक्त कोडिंग शैली दी गई। इसके अतिरिक्त % कुंजी का उपयोग कोडिंग मानक को लागू करने के लिए किया जा सकता है।

समापन कोष्ठक के बाद जोड़े गए इनपंक्ति टिप्पणियों का उपयोग करने का दूसरा तरीका है:

    के लिए ( int i = 0 ; i < कुल ; i ++ ) {फू ( बार );
} // के लिए (मैं) 

अगर ( एक्स < 0 ) {

बार ( फू );

} // अगर (एक्स <0)

इस पद्धति का प्रमुख नुकसान कई स्थानों पर डुप्लिकेट कोड बनाए रखना है।

एक अन्य समाधान एक तह संपादक में लागू किया गया है जो कोड के ब्लॉक को उनके अभिस्थापन स्तर या यौगिक कथन संरचना के माध्यम से प्रकट कर सकता है। जब कर्सर (उपयोगकर्ता अंतराफलक) में स्थित होता है तो कई संपादक मेल खाने वाले कोष्ठक या धनुकोष्ठक को भी हाइलाइट करेंगे।

वक्तव्य सम्मिलन

मानक यूनिक्स पंक्ति संपादक एड (टेक्स्ट एडिटर) का उपयोग करते समय के एंड आर शैली एक और सामान्य त्रुटि को रोकती है। नियंत्रण कथन और लूप ब्लॉक के खुला कोष्ठक के बीच गलती से डाला गया एक कथन लूप की बॉडी को सिंगल ट्रिप में बदल देता है।

 के लिए ( इंट आई = 0 ; मैं < 10 ; मैं ++ )        

    वूप्स ( बार ); /* 10 बार दोहराया, i 0 से 9 तक */   
{
    केवल_वन्स (); /* प्रोग्रामर ने इसे 10 बार करने का इरादा किया था */   

} // for (i) ← यह टिप्पणी अब मान्य नहीं है और बहुत भ्रामक है!

के एंड आर शैली नियंत्रण कथन और खुला कोष्ठक को एक ही पंक्ति पर रखकर इस समस्या से बचा जाता है।

यह भी देखें

• माध्यमिक संकेतन
• वाक्य - विन्यास पर प्रकाश डालना
• अभिस्थापन (टाइपतय िंग) # प्रोग्रामिंग में अभिस्थापन

बाहरी संबंध

• C Style: Standards and Guidelines: Defining Programming Standards for Professional C Programmers, Prentice Hall, ISBN 0-13-116898-3 / ISBN 978-0-13-116898-5 (full text is also online). Straker, David (1992).
• Contextual Indent
• जीएनयू Coding Standards
• Source Code Formatters at Curlie

टैब और जगह

• टैब बनाम जगह: एक शाश्वत पवित्र युद्ध जेमी ज़विंस्की द्वारा
• क्यों मैं स्रोत कोड में कोई टैब पसंद नहीं करता एडम स्पियर्स द्वारा
• मुझे स्रोत कोड में टैब रखना क्यों पसंद है (संग्रहीत)
• इलास्टिक टैबस्टॉप - टैब-बनाम-जगह समस्या का समाधान

श्रेणी:सॉफ़्टवेयर युद्ध श्रेणी:पाठ संपादक सुविधाएँ श्रेणी:स्रोत कोड