जेनपर्स - क्लाउड में ऑनलाइन

कार्यक्रम:

नाम

जेनपर्स - कमांड लाइन पार्सर जनरेटर

SYNOPSIS

genparse [विकल्पों] फ़ाइलों...

वर्णन

genparse एक सामान्य कमांड लाइन पार्सर जनरेटर है। सरल और संक्षिप्त से
विशिष्टता फ़ाइल में, आप कमांड लाइन पैरामीटर और स्विच को परिभाषित कर सकते हैं जो आप करेंगे
अपने प्रोग्राम को पास करने में सक्षम होना पसंद है। जेनपर्से C, C++ या Java कोड बनाता है
आपके लिए पार्सर.

जेनपर्से का मानना ​​है कि जी.एन.यू getopt_long(3) फ़ंक्शन आपकी सी लाइब्रेरी में बनाया गया है। के लिए
जावा आपको अपने जावा कंपाइलर में एक उपयुक्त जार फ़ाइल निर्दिष्ट करनी पड़ सकती है।

विकल्प

genparse इन विकल्पों को स्वीकार करता है:

-c, --cppext विस्तार
सी++ फ़ाइल एक्सटेंशन. (डिफ़ॉल्ट = सीसी)

-d लॉगिंग चालू करें.

-f, --बोटा दस्तावेज नाम
लॉग फ़ाइल नाम. (डिफ़ॉल्ट = genparse.log)

-h, --मदद
सहायता जानकारी प्रदर्शित करें।

-g, --gnulib
GNU संगतता लाइब्रेरी (Gnulib, देखें) का उपयोग करें http://www.gnu.org/software/gnulib/).
केवल C आउटपुट के लिए उपलब्ध है। कुछ और प्रकारों की अनुमति देता है (अहस्ताक्षरित लंबा, intmax_t आदि)
जिसके लिए Gnulib रूपांतरण कार्य प्रदान करता है।

-i, --अंतर्राष्ट्रीयकरण
अंतर्राष्ट्रीयकरण मैक्रो _() को टेक्स्ट आउटपुट के चारों ओर रखें ताकि जेनरेट किया गया प्रोग्राम
GNU गेटटेक्स्ट कमांड का उपयोग करके अंतर्राष्ट्रीयकरण किया जा सकता है। फिलहाल केवल लागू किया गया है
सी आउटपुट के लिए.

-l, --भाषा: हिन्दी lang
आउटपुट भाषा. केवल C, C++ और Java समर्थित हैं। निम्नलिखित में से कोई भी
C++ इंगित करें: "c++", "cpp", "cc", और "cxx"। जावा के लिए उपयोग करें: "जावा" या "जावा"।
(डिफ़ॉल्ट = सी)

-o, --आउटफाइल नाम
आउटपुट फ़ाइल नाम। (डिफ़ॉल्ट = parse_cl)

-m, --लंबे सदस्य
पार्सर वर्ग (संरचना) के सदस्यों के लिए लंबे विकल्पों का उपयोग करें। डिफ़ॉल्ट है
लघु निरूपण का उपयोग करें, सिवाय इसके कि यदि केवल लंबे निरूपण को परिभाषित किया गया हो
जेनपर्स फ़ाइल में। यदि यह विकल्प सेट है तो व्यवहार पूर्ववत हो जाता है।
दीर्घ निरूपण का उपयोग तब किया जाता है जब तक कि केवल लघु निरूपण न हो
परिभाषित।

-o, --आउटफाइल फ़ाइल का नाम
आउटपुट फ़ाइल का रूट नाम. एक्सटेंशन आउटपुट भाषा द्वारा निर्धारित किया जाएगा
और संभवतः अन्य विकल्पों द्वारा. उदाहरण के लिए, जब आउटपुट भाषा C है, तो देना
इस विकल्प में "फ़ाइल" के तर्क के परिणामस्वरूप "फ़ाइल.एच" का आउटपुट फ़ाइल नाम आएगा।
हेडर, पार्सर और कॉलबैक फ़ाइलों के लिए क्रमशः "file.c" और "file_cb.c"।
डिफ़ॉल्ट मान "parse_cl" है।

-p, --parsefunc समारोह
पार्सिंग फ़ंक्शन/वर्ग का नाम. यह विकल्प उपयोगकर्ता को नाम निर्दिष्ट करने की अनुमति देता है
फ़ंक्शन का (C के लिए) या क्लास का (C++ और Java के लिए) जो वास्तविक कमांड करता है
लाइन पार्सिंग (डिफ़ॉल्ट = "Cmdline")।

-P, --manyprints
एक अलग प्रिंट कमांड में प्रत्येक कमांड लाइन पैरामीटर के लिए आउटपुट सहायता टेक्स्ट।

-q, --शांत
शांत मोड - स्क्रीन पर कोई आउटपुट नहीं।

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

-v, --संस्करण
आउटपुट संस्करण.

-D, --निर्देशिका
परिणाम संग्रहीत करने के लिए निर्देशिका.

इनपुट फ़ाइल

एक जेनपर्स विनिर्देश फ़ाइल (आमतौर पर इसे 'जेनपर्स फ़ाइल' कहा जाता है) में एक संख्या होती है
प्रविष्टियों की संख्या, प्रपत्र के प्रति कमांड लाइन पैरामीटर में से एक:

संक्षिप्त_नाम[*|!] [/ लंबा नाम[*|!][=opt_name]] टाइप [ विकल्पों ]

A संक्षिप्त नाम एक एकल वर्ण (छोटा या बड़ा) या एक अंक है। लंबा नाम एक
लंबा (अधिक वर्णनात्मक) विकल्प नाम. कमांड लाइन पर पहले एक संक्षिप्त नाम होगा
एक डैश से पहले (जैसे '-ए') और एक लंबे संस्करण के पहले दो डैश होंगे (जैसे
'--सभी')। यदि लंबा पैरामीटर नाम आवश्यक नहीं है, तो आप केवल छोटा पैरामीटर निर्दिष्ट कर सकते हैं
(और स्लैश को प्रकट होने की आवश्यकता नहीं है)। एक पैरामीटर निर्दिष्ट करने के लिए जिसमें केवल एक लंबा समय है
नाम सेट संक्षिप्त_नाम सेवा मेरे कोई नहीं. इसके लिए कई छोटे विकल्प होना संभव है
उदाहरण सेटिंग संक्षिप्त नाम 'एए' और लंबा नाम 'सभी' को निर्दिष्ट करने की अनुमति होगी
कमांड लाइन स्विच '-ए' या '-ए' या '--ऑल' के रूप में, ये सभी एक ही काम कर रहे हैं।

A * बाद संक्षिप्त नाम or लंबा नाम तर्क को वैकल्पिक बनाता है। इसके लिए निर्दिष्ट किया जा सकता है
छोटे और लंबे विकल्प अलग-अलग।

A ! बाद संक्षिप्त नाम or लंबा नाम विकल्प को बूलियन बनाता है. यह किसी को एक को संयोजित करने की अनुमति देता है
वैकल्पिक या अनिवार्य तर्क के साथ लंबे विकल्प के साथ बूलियन लघु विकल्प
एक वैकल्पिक या अनिवार्य तर्क के साथ एक बूलियन लंबे विकल्प को एक छोटे विकल्प के साथ संयोजित करें।
A ! यदि विकल्प का प्रकार है तो इसका कोई मतलब नहीं है झंडा.

टाइप में से एक होना चाहिए int नाव टैंक स्ट्रिंग or झंडा. पहले चार स्वयं होने चाहिए-
व्याख्यात्मक. अंतिम एक "स्विच" विकल्प है जिसमें कोई तर्क नहीं होता है। सी आउटपुट के लिए और यदि
--gnulib को कमांड लाइन पर सेट किया गया है, इसके अतिरिक्त निम्नलिखित प्रकारों की अनुमति है: लंबा
(लंबे समय तक int के लिए), Ulong (अहस्ताक्षरित लंबे इंट के लिए), intmax (intmax_t के लिए, Gnulib में परिभाषित),
uintmax (uintmax_t के लिए), डबल.

निम्नलिखित विकल्पों समर्थित हैं. वे किसी भी क्रम में प्रकट हो सकते हैं और सिवाय इसके
विवरण प्रति विकल्प प्रत्येक फ़ील्ड में से केवल एक को परिभाषित किया जा सकता है।

A चूक मूल्य पैरामीटर के लिए. एक स्ट्रिंग के लिए यह केवल सादा डिफ़ॉल्ट है
मूल्य, चाहे वह कुछ भी हो। स्ट्रिंग्स के लिए, ब्रेसिज़ के भीतर एक डिफ़ॉल्ट निर्दिष्ट किया जाना चाहिए
उद्धरण, और इसमें रिक्त स्थान शामिल हो सकता है, उदाहरण के लिए {"मेरा डिफ़ॉल्ट मान"}। एक चार के लिए
पैरामीटर को सिंगल कोट्स में संलग्न किया जाना चाहिए, उदाहरण के लिए 'a' या '\n'।

A रेंज कोष्ठक के भीतर मूल्यों का. निम्न और उच्च मान a के बीच निर्दिष्ट हैं
रेंज विनिर्देशक (या तो '...' या '..')। या तो उच्च या निम्न मूल्य हो सकता है
केवल एक तरफ सीमित सीमा के लिए छोड़ा गया। पैरामीटर की जाँच की जाएगी
सुनिश्चित करें कि यह इस सीमा के भीतर है।

A वापस कॉल करें समारोह. किसी भी रेंज की जाँच के बाद इस फ़ंक्शन को कॉल किया जाता है
प्रदर्शन किया। कॉलबैक का उद्देश्य वैधता जांच करना अधिक है
जेनपर्स फ़ाइल में निर्दिष्ट से अधिक जटिल। उदाहरण के लिए, हो सकता है
एक प्रोग्राम लिखें जिसमें इनपुट के लिए अभाज्य संख्याओं, एक निश्चित स्ट्रिंग की आवश्यकता हो
लंबाई, आदि

A विवरण दोहरे उद्धरण चिह्नों में. द्वारा मुद्रित किया जाता है उपयोग() समारोह। यदि एक
पंक्ति पर्याप्त नहीं है तो एकाधिक विवरण निर्दिष्ट करें, प्रति पंक्ति एक और प्रत्येक
उन्हें दोहरे उद्धरण चिह्नों में. यदि विवरण जेनपर्से में पहले कॉलम से शुरू होता है
फ़ाइल करें तो इसे पहले कॉलम में भी मुद्रित किया जाएगा उपयोग() समारोह.

A #gp_शामिल निर्देश जेनपर्से को एक अन्य जेनपर्से फ़ाइल शामिल करने का निर्देश देगा,
जैसे #gp_शामिल अन्य.जीपी. शामिल में केवल पैरामीटर परिभाषाओं की अनुमति है
फ़ाइल, कोई वैश्विक निर्देश नहीं।

An __ERR_MSG__(err_txt) निर्देश. मुद्रित होने वाले त्रुटि संदेश को निर्दिष्ट करता है
जब तर्क परिवर्तित नहीं किया जा सका. उदाहरण: __ERR_MSG__("%s: अमान्य
तर्क"). यह संदेश या तो रूपांतरण फ़ंक्शन पर मुद्रित किया जाएगा
विफल रहा या जब तर्क सीमा से बाहर था। एक को शामिल करने का अनुमान है %s जो होगा
उस एग्रीमेंट से प्रतिस्थापित किया जाए जिसे परिवर्तित नहीं किया जा सका। केवल तभी उपलब्ध है जब
जेनपर्से का आह्वान किया जाता है --gnulib, अन्यथा नजरअंदाज कर दिया गया।

वैकल्पिक रूप से एक रूपांतरण फ़ंक्शन को दूसरे तर्क के रूप में जोड़ा जा सकता है, उदाहरण के लिए
__ERR_MSG__("%s: अमान्य तर्क", कोटर्ग). इससे एक त्रुटि संदेश प्राप्त होगा
पसंद त्रुटि (EXIT_FAILURE, 0, "%एस: अमान्य तर्क", quotarg (ऑप्टिंड)).

An __ADD_FLAG__ निर्देश. केवल तभी समझ में आता है जब कमांड लाइन पैरामीटर नहीं है
पहले से ही एक ध्वज, इस मामले में एक अतिरिक्त ध्वज पैरामीटर जोड़ा गया है जो होगा
यदि कमांड लाइन पैरामीटर कमांड लाइन पर निर्दिष्ट किया गया था तो सेट करें। इस विकल्प
यदि किसी पैरामीटर में वैकल्पिक तर्क है तो यह स्वचालित रूप से सेट हो जाता है।

A __CODE__(कथन) निर्देश. निर्दिष्ट कोड विवरण कॉपी किए गए हैं
अक्षरशः। उदाहरण: __CODE__(प्रिंटफ़ ("पैरामीटर x था तय करना");). निर्दिष्ट कोड
एक से अधिक लाइन तक विस्तारित हो सकता है। जेनपर्से को मौका देने के लिए
कोड को ठीक से इंडेंट करें, स्पेस और टैब इंडेंटेशन को एक में न मिलाएं __कोड__
बयान।

A __STORE_LONGINDEX__ निर्देश. जेनपर्से को इंटरर प्रकार का फ़ील्ड जोड़ने का निर्देश देता है
परिणाम वर्ग में जो longindex वैरिएबल (अंतिम तर्क) पर सेट किया जाएगा
@code{getopt_long()}) पर कॉल। इस नए फ़ील्ड को वही नाम मिलेगा जो
परिणाम फ़ील्ड यह संबंधित है लेकिन एक के साथ _ली पोस्टफ़िक्स।

निम्नलिखित वैश्विक निर्देशों समर्थित हैं. वे किसी भी क्रम में प्रकट हो सकते हैं.

An # शामिल निर्देश जेनपर्से को उक्त सम्मिलित कथन की प्रतिलिपि बनाने का निर्देश देगा
जेनपर्स द्वारा उत्पन्न C या C++ कोड में, लेकिन कोई हेडर फ़ाइल या कॉलबैक नहीं
फाइलें.

A #अनिवार्य निर्देश का उपयोग किया जा सकता है, यह उपयोग() फ़ंक्शन कॉल को बेहतर बनाता है। यह अनुमति देता है
आपको अनिवार्य कमांड लाइन पैरामीटर निर्दिष्ट करने होंगे जो स्विच का अनुसरण कर सकते हैं। टिप्पणी
जेनपर्से अनिवार्य मापदंडों की जांच नहीं करता है, वे केवल इसमें मुद्रित होते हैं
प्रयोग () के साथ कार्य करते हैं __अनिवार्य__ निर्देश. बहिष्कृत: जोड़ना अनिवार्य
पैरामीटर in la #उपयोग अनुभाग बजाय.

An #निकास_मूल्य निर्देश जो त्रुटि के मामले में निकास मूल्य निर्दिष्ट करता है।
डिफ़ॉल्ट EXIT_FAILURE है.

A #ब्रेक_लाइन्स निर्देश जो उस चौड़ाई को निर्दिष्ट करता है जिस तक लाइनें तोड़ी जाएंगी
सहायता स्क्रीन पर. अगर कोई नहीं #ब्रेक_लाइन्स निर्देश निर्दिष्ट है तो पंक्तियाँ होंगी
जेनपर्स फ़ाइल में दिए गए अनुसार बिल्कुल मुद्रित।

If #नहीं_संरचना निर्दिष्ट किया गया है तो कोई संरचना परिभाषित नहीं की जाएगी जिसे भरा जाएगा
उत्पन्न पार्सर में कमांड लाइन पैरामीटर। यह उपयोगी हो सकता है यदि आप
के साथ अपना स्वयं का कोड जोड़ना चाहते हैं __कोड__ इसके बजाय बयान. केवल C के लिए समर्थित है
उत्पादन.

A #निर्यात_लंबे_विकल्प निर्देश. अगर #निर्यात_लंबे_विकल्प परिभाषित किया गया है तो ए
समारोह #लंबे_विकल्प प्राप्त करें() जोड़ा गया है जो उपयोग किए गए longoptions सरणी को निर्यात करता है
#getopt_long(). यह निर्देश केवल C आउटपुट के लिए, अन्य भाषाओं के लिए उपलब्ध है
इसे नजरअंदाज कर दिया जाता है.

A वैश्विक वापस कॉल करें समारोह. यह फ़ंक्शन अन्योन्याश्रितताओं की जाँच के लिए उपयोगी है
मापदंडों के बीच. प्रत्येक व्यक्ति के भीतर परस्पर निर्भरता की जाँच नहीं की जा सकती
कॉलबैक फ़ंक्शन क्योंकि इन फ़ंक्शन को कॉल करने का क्रम भिन्न होता है,
कमांड लाइन पर पैरामीटर्स के क्रम के आधार पर।

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

#उपयोग_शुरू
उपयोग: __कार्यक्रम_नाम__ __विकल्प_संक्षिप्त__ __अनिवार्य__
__शब्दावली__
#उपयोग_समाप्ति

उपयोग अनुभाग प्रारंभ होता है #उपयोग_शुरू और साथ समाप्त होता है #उपयोग_समाप्ति. के बीच कोई भी पाठ है
निम्नलिखित कीवर्ड को छोड़कर शब्दशः मुद्रित किया जाएगा, जिन्हें सूचीबद्ध के रूप में प्रतिस्थापित किया जाएगा
नीचे:

__कार्यक्रम का नाम__: कार्यक्रम का नाम. C और C++ में प्रोग्राम का नाम दिया गया है
argv[0].

__विकल्प_छोटा__: उपलब्ध संक्षिप्त फॉर्म विकल्पों की एक सूची, उदाहरण के लिए [-एबीसी]।

__अनिवार्य__: #अनिवार्य के साथ परिभाषित सभी अनिवार्य मापदंडों की एक सूची
आदेश देता है। बहिष्कृत: सूची अनिवार्य पैरामीटर यहाँ उत्पन्न करें सीधे.

__शब्दावली__: सभी कमांड लाइन विकल्पों का विवरण। ये है जानकारी
मानव पठनीय रूप में पैरामीटर परिभाषाओं के लिए दिया गया। इसमें शामिल है
पैरामीटर प्रकार, डिफ़ॉल्ट, रेंज और कोई टिप्पणी। एक पंक्ति जिसमें शामिल है
__शब्दावली__ मापदंडों की शब्दावली द्वारा प्रतिस्थापित किया जाता है, किसी भी अन्य पाठ में
उसी पंक्ति को नजरअंदाज कर दिया जाता है।

__शब्दावली_जीएनयू__: के समान __शब्दावली__ लेकिन जीएनयू शैली में. वैकल्पिक रूप से इसके बाद एक
कोष्ठक में पूर्णांक जो वर्णनात्मक पाठ के इंडेंटेशन को निर्दिष्ट करता है (जैसे
__शब्दावली__(30)). डिफ़ॉल्ट इंडेंटेशन 24 है.

__स्ट्रिंग__(s): एक स्ट्रिंग स्थिरांक, सी में संभवतः एक स्ट्रिंग मैक्रो के साथ परिभाषित किया गया है
#प्रीप्रोसेसर कमांड को परिभाषित करें। इस मैक्रो का उपयोग करके किसी अन्य फ़ाइल से आयात किया जा सकता है
जेनपर्स फ़ाइल में निर्देश शामिल करें। जावा आउटपुट जनरेट करते समय अनदेखा किया गया।

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

__CODE__(कथन): पैरामीटर विकल्पों के समान, ऊपर देखें।

__दस्तावेज़_नहीं_करें__: कोई भी पंक्ति जिसमें यह मैक्रो शामिल है, मुद्रित नहीं की जाएगी
उपयोग() समारोह। बिना कमांड लाइन पैरामीटर लागू करने के लिए इस्तेमाल किया जा सकता है
उन्हें सहायता स्क्रीन पर सूचीबद्ध करना।

__एनएल__: नई पंक्ति। स्वचालित लाइन ब्रेकिंग के दौरान लाइनों को मैन्युअल रूप से तोड़ने के लिए उपयोगी
चालू है (देखें) #ब्रेक_लाइन्स). जावा आउटपुट जनरेट करते समय अनदेखा किया गया।

__नया_प्रिंट__: सक्रिय प्रिंट कमांड बंद करें और एक नया प्रारंभ करें।

__टिप्पणी__(पाठ): उपयोग पाठ को प्रिंट करने के लिए कोड में टिप्पणी करें।

लंबे विकल्पों के बाद = चिह्न और एक वैकल्पिक पदनाम लगाया जा सकता है opt_name किसे कर सकते हैं
निम्नलिखित विवरण में संदर्भित किया जाएगा। इसका उपयोग में किया जाएगा उपयोग() समारोह
केवल। उदाहरण के लिए निम्नलिखित जेनपर्स लाइन

s / ब्लॉक-आकार = आकार int "साइज़-बाइट ब्लॉक का उपयोग करें"

सहायता स्क्रीन में निम्न पंक्ति की ओर ले जाएगा

[ -s ] [ --ब्लॉक-आकार=आकार ] (प्रकार=पूर्णांक)
SIZE-बाइट ब्लॉक का उपयोग करें

जेनपर्स शैली में (__शब्दावली__) या

-s, --ब्लॉक-आकार = आकार आकार-बाइट ब्लॉक का उपयोग करें

जीएनयू शैली में (__शब्दावली_जीएनयू__).

इंगित करने के लिए वैकल्पिक नाम के चारों ओर वर्गाकार ब्रेसिज़ लगाना भी संभव है
यह तर्क वैकल्पिक है. हालाँकि जेनरेट किए गए पार्सर के लिए इसका कोई अर्थ नहीं है। उपयोग
* किसी तर्क को वैकल्पिक बनाने के लिए उपसर्ग।

s* / ब्लॉक*[=आकार] int "ब्लॉक का उपयोग करें।"
"यदि SIZE नहीं दिया गया है तो उन्हें 1kB का साइज़ मिलेगा।"

सहायता स्क्रीन में निम्न पंक्ति की ओर ले जाएगा

-s, --block[=SIZE] ब्लॉक का उपयोग करें।
यदि SIZE नहीं दिया गया है तो उन्हें 1kB का साइज़ मिलेगा।

उदाहरण

यहाँ एक नमूना जेनपर्स फ़ाइल है:

#शामिल करना

/* टिप्पणी */
my_callback()

i / पुनरावृत्ति int 100 [10...1000] iter_callback()
"चलाने के लिए पुनरावृत्तियों की संख्या।"

/*
* टिप्पणी
*/

n / नाम स्ट्रिंग {"माइक"} name_cb() "उपयोगकर्ता का नाम"
एस / स्ट्र स्ट्रिंग "टेस्ट स्ट्रिंग"
f झंडा "एक मूर्खतापूर्ण झंडा!"

#उपयोग_शुरू
उपयोग: __PROGRAM_NAME__ __OPTIONS_SHORT__ फ़ाइल नाम
यह केवल एक मूर्खतापूर्ण परीक्षण कार्यक्रम है.
__शब्दावली__
#उपयोग_समाप्ति

onworks.net सेवाओं का उपयोग करके ऑनलाइन जेनपर्स का उपयोग करें