🌨️ ⛹🏻 🍥 मनोरंजक पुरातत्व: मैगनीफाइंग ग्लास के नीचे स्टाइल गाइड आर 🤲🏼 👨‍🌾 👩🏽‍🚀

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

एक स्टाइल गाइड केवल डेवलपर्स के बीच एक मौन समझौता नहीं है - कई नियमों में एक जिज्ञासु पृष्ठभूमि है। क्यों तीर <- बराबर संकेत से बेहतर है = , क्यों आर के पुराने-टाइमर अंडरस्कोर पसंद नहीं करते हैं, अनुशंसित लाइन की लंबाई पंच कार्ड से कैसे संबंधित है, और बहुत कुछ - अधिक।

डिस्क्लेमर: आर स्टाइल गाइड्स

पायथन के विपरीत, आर में एक भी मानक नहीं है। तदनुसार, एक भी मार्गदर्शक नहीं है। हेडली गाइड (या इसके विस्तृत संस्करण के अलावा ) के अलावा, ऐसे अन्य हैं, जैसे कि Google या बायोकॉन्टर ।

हालांकि, हैडली गाइड को सबसे व्यापक माना जा सकता है (जैसे अंतर्निहित RStudio चेक , उदाहरण के लिए), जो हैडली द्वारा बनाई गई पुस्तकालयों की लोकप्रियता से बहुत आसान है (dplyr, ggplot, tidyr, और tidyverse संग्रह से अन्य)।

1. असाइनमेंट ऑपरेटर: `<-` बनाम `=`

सभी उपलब्ध मार्गदर्शक गैर-मानक ऑपरेटर <- का उपयोग करने की सलाह देते हैं, लेकिन समान चिह्न = , जो अन्य आधुनिक भाषाओं के लिए सामान्य है। तीन अन्य ऑपरेटरों ( <<- , -> , ->> ) का भी उल्लेख नहीं किया गया है (जैसे कि जो पहले के संस्करणों में मौजूद था := )। ऐसा लगता है, हमें इस गैर-मानक तीर की आवश्यकता क्यों है?

इतिहास हमें कार्ड का खुलासा करता है: आर में, तीर एस से आया था, जो बदले में एपीएल से विरासत में मिला था। एपीएल में, इसने हमें असाइनमेंट को समानता से अलग करने की अनुमति दी। आर में, समानता ऑपरेटर मानक है, इसलिए अंतर अलग है। यदि तीर प्रारंभ में एक असाइनमेंट ऑपरेटर था, तो समान चिह्न केवल नामित पैरामीटर के लिए मान निर्दिष्ट करता है। 2001 में, समान चिह्न असाइनमेंट ऑपरेटर बन गया, लेकिन कभी भी तीर का पर्याय नहीं बना।

क्या हमें विचार करने की अनुमति देता है = तीर के लिए = पूर्ण प्रतिस्थापन? सबसे पहले, = असाइनमेंट ऑपरेटर केवल शीर्ष स्तर पर कैसे काम करता है। उदाहरण के लिए, फ़ंक्शन के अंदर, सब कुछ पहले की तरह काम करेगा:

 mean(x = 1:5) # [1] 3 x # Error: object 'x' not found mean (x <- 1:5) # [1] 3 x # [1] 1 2 3 4 5

यहां = केवल फ़ंक्शन पैरामीटर सेट करता है, जबकि <- भी चर x को मान प्रदान करता है। हम कोष्ठक में असाइनमेंट ऑपरेशन को लागू करके एक ही प्रभाव प्राप्त कर सकते हैं ~~(नहीं, यह अभी भी लिस्प नहीं है)~~ :

 mean ((x = 1:5)) # [1] 3 x # [1] 1 2 3 4 5

... या ब्रेसिज़ में:

 mean ({x = 1:5}) # [1] 3 x # [1] 1 2 3 4 5

इसके अलावा, तीर समान संकेत पर पूर्वता लेता है:

 x <- y <- 1 # OK x = y = 2 # OK x = y <- 3 # OK x <- y = 4 # Error in x <- y = 4 : could not find function "<-<-"

अंतिम अभिव्यक्ति विफल हो गई क्योंकि यह (x <- y) = 4 बराबर है, और पार्सर इसकी व्याख्या करता है

 `<-<-`(x, y = 4, value = 4)

दूसरे शब्दों में, हम एक गलत संचालन करने की कोशिश कर रहे हैं: पहले x को y और फिर 4 से x को असाइन करने का प्रयास करें। अभिव्यक्ति को बिना त्रुटियों के संसाधित किया जाएगा यदि आप कोष्ठक के साथ संचालन की प्राथमिकता को बदलते हैं: x <- (y = 4) ।

2. रिक्ति

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

 x <-1

यह क्या है X -1 से कम है? या x को 1 पर सेट करें?

हालाँकि, अतिरिक्त स्थान मिसिंग से बेहतर नहीं है, उदाहरण के लिए:

 x <- 0 ifelse(x <-1, T, F) # [1] TRUE x <- 0 ifelse(x < -1, T, F) # [1] FALSE

पहले मामले में, < और - बीच कोई स्थान नहीं है, जो एक असाइनमेंट ऑपरेटर बनाता है।

3. कार्यों और चर के नाम

स्टाइल गाइड नामों के सवाल पर असहमत हैं: हेडली गाइड सभी नामों के लिए अंडरस्कोर की सिफारिश करता है; Google गाइड - कार्यों के लिए पहले लोअरकेस के साथ चर और ऊंट शैली के लिए डॉट्स द्वारा जुदाई; बायोकॉन्टर दोनों कार्यों और चर के लिए लोअरकेमेल की सिफारिश करता है। इस मुद्दे पर आर समुदाय में कोई एकता नहीं है, और सभी संभव शैलियों को पाया जा सकता है:

 lowerCamel period.separation lower_case_with_underscores allowercase UpperCamel

आधार R नामों के लिए भी कोई समान शैली नहीं है (उदाहरण के लिए, rownames और row.names अलग कार्य हैं!)। यदि आप अपठनीय एलोवरकेस (केवल मैटलैब उपयोगकर्ता इसे प्यार कर सकते हैं) को ध्यान में रखते हैं, तो तीन सबसे लोकप्रिय शैलियाँ हैं: लोअरकेमेल, लोअर केस विथ, और डॉट सेपरेशन के साथ लोअर केस।

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

2012 में एक ही बात

स्रोत: बाथ (2012)। " आर में नामकरण सम्मेलनों की स्थिति "। आर जर्नल वॉल्यूम। 4/2, पी। 74-75।

पॉइंट-टू-पॉइंट अलगाव ऑब्जेक्ट ओरिएंटेड प्रोग्रामिंग में तरीकों के उपयोग की याद ताजा करती है, लेकिन ऐतिहासिक रूप से सामान्य है। यह इतना सामान्य है कि इस विशेष शैली को सही मायने में R'vsky माना जा सकता है। उदाहरण के लिए, अधिकांश बुनियादी कार्य इसे विशेष रूप से उपयोग करते हैं (और हर कोई बस डेटा से मिलता है। as औरfactor)।

लेकिन जुदाई _ कम से कम लोकप्रिय शैलियों में से एक है (और यहां हैडली बहुमत के खिलाफ जाती है)। कई आर उपयोगकर्ताओं के लिए, अंडरस्कोर परेशान होगा: लोकप्रिय Emacs Speaks सांख्यिकी एक्सटेंशन में, इसे असाइनमेंट ऑपरेटर के साथ डिफ़ॉल्ट रूप से बदल दिया जाता है <- । और डिफ़ॉल्ट सेटिंग्स, ज़ाहिर है, ~~लगभग~~ कोई भी नहीं बदलता है।

हालांकि, एमएसीएस ईएसएस का प्रभाव अभी भी "पूंछ वैग्स डॉग" की श्रेणी से एक स्पष्टीकरण है। एक अधिक प्राचीन कारण है: आर के पुराने संस्करणों में, अंडरस्कोर तीर का पर्याय था <- । उदाहरण के लिए, 2000 में आप इसे पूरा कर सकते हैं:

 #      R c <- c(1,2,3,4,5) mean(c) [1] 3 c_mean <- mean(c) c [1] 3

यहाँ, वेरिएबल c_mean बनाने के बजाय c_mean R ने वैल्यू 3 को पहले वेरिएबल माध्य के लिए असाइन किया, और फिर वेरिएबल c को। आधुनिक आर में, ऐसे रूपांतर, निश्चित रूप से नहीं होंगे।

अलोकप्रियता के कारण, इस शैली के कार्य लगभग मूल लोगों में नहीं पाए जाते हैं:

 #  3.5.1  25  grep("^[^\\.]*$", apropos("_"), value = T)

अंत में, लंबे नामों का उपयोग करते समय निचली शैली खराब रूप से पठनीय होती है:

 # ! GrossNationalIncomePerCapitaAtlasMethodCurrentUnitedStatesDollars

इस प्रकार, नामों के संदर्भ में, मार्गदर्शिका सिफारिशों को असंदिग्ध नहीं माना जा सकता है; आखिरकार, यह स्वाद का मामला है (जब तक इसमें स्थिरता है)।

4. घुंघराले ब्रेसिज़

गाइड के अनुसार, एक नई लाइन को उद्घाटन घुंघराले ब्रेस का पालन करना चाहिए, और समापन एक अलग लाइन पर होना चाहिए (जब तक कि कोई अन्य अनुसरण न करें)। यानी कुछ इस तरह:

 if (x >= 0) { log(x) } else { message("Not applicable!") }

यहां सब कुछ बहुत दिलचस्प नहीं है: यह K & R की मानक इंडेंटेशन शैली है, जो C भाषा और किर्निगन और रिची द्वारा प्रसिद्ध पुस्तक "द सी प्रोग्रामिंग लैंग्वेज" (या लेखकों के नाम से K & R) को वापस डेटिंग है।

इस शैली की उत्पत्ति भी काफी स्पष्ट है: यह पठनीयता को बनाए रखते हुए आपको लाइनों को बचाने की अनुमति देता है। शुरुआती कंप्यूटरों के लिए, ऊर्ध्वाधर स्थान बहुत अधिक लक्जरी था। उदाहरण के लिए, सी को पीडीपी -11 पर विकसित किया गया था, जिसके टर्मिनल में केवल 24 लाइनें थीं। और जब एक के एंड आर पुस्तक को प्रिंट करते हैं, तो इस शैली ने कागज को बचाया!

5. 80 वर्ण का तार

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

पहली बार प्रोग्रामिंग में, यह संख्या मानक आईबीएम पंच कार्ड के बजाय 1928 में दिखाई दी, जहां डेटा के लिए बिल्कुल 80 कॉलम थे। एक और अधिक दिलचस्प सवाल यह है कि ऐसा मानक क्यों चुना गया? आखिरकार, एक अलग लंबाई (24 या 45 स्तंभों के लिए) के पंच कार्ड पहले इस्तेमाल किए गए थे।

सबसे लोकप्रिय जवाब टाइपराइटर की लाइन की लंबाई के लिए एक पंच कार्ड की लंबाई से संबंधित है। पहली मशीनों को अमेरिकी मानक पेपर 8 machines x 11 इंच के लिए डिज़ाइन किया गया था, और मार्जिन के आकार के आधार पर 72 से 90 वर्णों तक प्रिंट करने की अनुमति दी गई थी। इसलिए, प्रति पंक्ति 80 वर्णों का संस्करण काफी प्रशंसनीय लगता है, हालांकि अंतिम उपाय में यह सच नहीं है। यह संभव है कि एर्गोनॉमिक्स के संदर्भ में 80 अक्षर सिर्फ मध्य का मैदान है।

6. लाइन इंडेंट: रिक्त स्थान बनाम टैब

गाइड द्वारा सुझाई गई शैली दो स्थान है, न कि टैब। सारणीकरण से इनकार करना काफी समझ में आता है: TAB की लंबाई अलग-अलग पाठ संपादकों में भिन्न होती है (यह 2 से 8 स्थानों से कुछ भी हो सकता है)। उन्हें मना करने पर, हमें एक ही बार में दो फायदे मिलते हैं: सबसे पहले, कोड बिल्कुल वैसा ही दिखेगा जैसा हमने उसे टाइप किया था; दूसरे, अनुशंसित स्ट्रिंग लंबाई का कोई आकस्मिक उल्लंघन नहीं होगा। इस मामले में, निश्चित रूप से, हम फ़ाइल का आकार बढ़ाते हैं (जो 2k19 में इस तरह के माइक्रोपोटिमिटेशन से निपटना चाहते हैं)?

विवाद स्थानों बनाम टैब का एक लंबा इतिहास है, और धार्मिक लोगों (जैसे विन बनाम लिनक्स, एंड्रॉइड बनाम आईओएस, और इसी तरह) के साथ बराबरी की जा सकती है। हालांकि, हम पहले से ही जानते हैं कि इसे किसने जीता है: स्टैक ओवरफ्लो अध्ययन के अनुसार, रिक्त स्थान का उपयोग करने वाले डेवलपर्स टैब का उपयोग करने वालों की तुलना में अधिक कमाते हैं। स्टाइल गाइड के नियमों की तुलना में अधिक शक्तिशाली तर्क, सही है?

निष्कर्ष के बजाय: स्टाइल गाइड के नियम अजीब और अतार्किक लग सकते हैं। वास्तव में, क्यों तीर <- यदि कोई मानक ऑपरेटर है = ? लेकिन अगर आप गहरी खुदाई करते हैं, तो प्रत्येक नियम के पीछे कुछ तर्क है, अक्सर पहले से ही भूल गए।

मनोरंजक पुरातत्व: मैगनीफाइंग ग्लास के नीचे स्टाइल गाइड आर