ນີ້ແມ່ນ genparse ຄໍາສັ່ງທີ່ສາມາດດໍາເນີນການໄດ້ໃນ OnWorks ຜູ້ໃຫ້ບໍລິການໂຮດຕິ້ງຟຣີໂດຍໃຊ້ຫນຶ່ງໃນຫຼາຍສະຖານີເຮັດວຽກອອນໄລນ໌ຂອງພວກເຮົາເຊັ່ນ Ubuntu Online, Fedora Online, Windows online emulator ຫຼື MAC OS online emulator
ໂຄງການ:
NAME
genparse - command line parser generator
ສະຫຼຸບສັງລວມ
genparse [ທາງເລືອກໃນການ] ໄຟ...
ລາຍລະອຽດ
genparse ເປັນຕົວແຍກແຍກແຖວຄໍາສັ່ງທົ່ວໄປ. ຈາກງ່າຍດາຍແລະ concise
ໄຟລ໌ສະເພາະ, ທ່ານສາມາດກໍານົດຕົວກໍານົດການເສັ້ນຄໍາສັ່ງແລະສະຫຼັບທີ່ເຈົ້າຈະ
ຢາກສາມາດຜ່ານໄປຫາໂຄງການຂອງເຈົ້າ. Genparse ສ້າງລະຫັດ C, C++ ຫຼື Java ຂອງ
parser ສໍາລັບທ່ານ.
Genparse ສົມມຸດວ່າ GNU getopt_long(3) ຟັງຊັນຖືກສ້າງຢູ່ໃນຫ້ອງສະຫມຸດ C ຂອງທ່ານ. ສໍາລັບ
Java ທ່ານອາດຈະຕ້ອງລະບຸໄຟລ໌ jar ທີ່ເຫມາະສົມກັບ Java compiler ຂອງທ່ານ.
OPTIONS
genparse ຍອມຮັບທາງເລືອກເຫຼົ່ານີ້:
-c, --cppext ການຂະຫຍາຍ
ການຂະຫຍາຍໄຟລ໌ C++. (ຄ່າເລີ່ມຕົ້ນ = cc)
-d ເປີດການບັນທຶກ.
-f, --logfile ຊື່
ຊື່ໄຟລ໌ບັນທຶກ. (ຄ່າເລີ່ມຕົ້ນ = genparse.log)
-h, - ຊ່ວຍ
ສະແດງຂໍ້ມູນການຊ່ວຍເຫຼືອ.
-g, --gnulib
ໃຊ້ GNU Compatibility Library (Gnulib, ເບິ່ງ http://www.gnu.org/software/gnulib/).
ມີໃຫ້ພຽງແຕ່ສໍາລັບຜົນຜະລິດ C. ອະນຸຍາດບາງປະເພດເພີ່ມເຕີມ (unsigned long, intmax_t ແລະອື່ນໆ.)
ສໍາລັບທີ່ Gnulib ສະຫນອງຫນ້າທີ່ການແປງ.
-i, --ສາກົນ
ໃສ່ມະຫາພາກສາກົນ _() ອ້ອມຮອບການສົ່ງອອກຂໍ້ຄວາມເພື່ອໃຫ້ໂຄງການທີ່ສ້າງຂຶ້ນ
ສາມາດເປັນສາກົນໂດຍໃຊ້ຄໍາສັ່ງ GNU gettext. ປະຈຸບັນພຽງແຕ່ປະຕິບັດ
ສໍາລັບຜົນຜະລິດ C.
-l, -- ພາສາ lang
ພາສາອອກ. ຮອງຮັບພຽງແຕ່ C, C++ ແລະ Java ເທົ່ານັ້ນ. ອັນໃດຕໍ່ໄປນີ້
ຊີ້ບອກ C++: "c++", "cpp", "cc", ແລະ "cxx". ສໍາລັບການນໍາໃຊ້ Java: "java" ຫຼື "Java".
(ຄ່າເລີ່ມຕົ້ນ = c)
-o, --outfile ຊື່
ຊື່ໄຟລ໌ທີ່ອອກມາ. (ຄ່າເລີ່ມຕົ້ນ = parse_cl)
-m, -- ສະມາຊິກຍາວ
ໃຊ້ຕົວເລືອກຍາວສໍາລັບສະມາຊິກຂອງຊັ້ນວິເຄາະ (ໂຄງສ້າງ). ຄ່າເລີ່ມຕົ້ນແມ່ນເພື່ອ
ໃຊ້ຕົວແທນສັ້ນ ຍົກເວັ້ນວ່າມີການກຳນົດຕົວແທນຍາວເທົ່ານັ້ນ
ໃນໄຟລ໌ genparse. ຖ້າຕົວເລືອກນີ້ຖືກຕັ້ງ, ພຶດຕິກໍາຈະຖືກກັບຄືນ. ໄດ້
ການເປັນຕົວແທນຍາວແມ່ນໃຊ້ຫຼັງຈາກນັ້ນຍົກເວັ້ນຖ້າຫາກວ່າມີພຽງແຕ່ການເປັນຕົວແທນສັ້ນ
ກໍານົດ.
-o, --outfile ຊື່ເອກະສານ
ຊື່ຮາກຂອງໄຟລ໌ຜົນຜະລິດ. ສ່ວນຂະຫຍາຍຈະຖືກກໍານົດໂດຍພາສາຜົນຜະລິດ
ແລະອາດຈະເປັນທາງເລືອກອື່ນ. ຕົວຢ່າງ, ເມື່ອພາສາຜົນຜະລິດແມ່ນ C, ໃຫ້
ທາງເລືອກນີ້ການໂຕ້ຖຽງຂອງ "ໄຟລ໌" ຈະສົ່ງຜົນໃຫ້ຊື່ໄຟລ໌ຜົນຜະລິດຂອງ "file.h",
"file.c" ແລະ "file_cb.c" ສໍາລັບ header, parser, ແລະ callback files, ຕາມລໍາດັບ.
ຄ່າເລີ່ມຕົ້ນແມ່ນ "parse_cl".
-p, --parsefunc ມ່ວນ
ຊື່ຂອງຟັງຊັນ parsing / class. ຕົວເລືອກນີ້ອະນຸຍາດໃຫ້ຜູ້ໃຊ້ລະບຸຊື່
ຂອງຟັງຊັນ (ສໍາລັບ C) ຫຼືຊັ້ນ (ສໍາລັບ C ++ ແລະ Java) ທີ່ເຮັດຄໍາສັ່ງຕົວຈິງ
ການແຍກເສັ້ນ (ຄ່າເລີ່ມຕົ້ນ = "Cmdline").
-P, --ຫຼາຍພິມ
ຂໍ້ຄວາມຊ່ວຍເຫຼືອອອກສໍາລັບທຸກໆພາລາມິເຕີແຖວຄໍາສັ່ງໃນຄໍາສັ່ງພິມແຍກຕ່າງຫາກ.
-q, --ງຽບ
ໂໝດງຽບ - ບໍ່ມີຜົນອອກມາໃນໜ້າຈໍ.
-s, --static-headers
ຮັກສາສ່ວນຫົວຄຳອະທິບາຍຢູ່ເທິງສຸດຂອງໄຟລ໌ທີ່ສ້າງຂຶ້ນໃຫ້ຄົງທີ່. ໂດຍບໍ່ມີການນີ້
ທາງເລືອກ genparse ພິມວັນທີສ້າງແລະເວລາ, ສະບັບ Linux kernel, kernel build
ເວລາ, ຊື່ສະຖາປັດຕະຍະກໍາຄອມພິວເຕີ, ຊື່ເຈົ້າພາບແລະຊື່ຜູ້ໃຊ້.
-v, - ການປ່ຽນແປງ
ສະບັບອອກ.
-D, -- ບັນຊີລາຍການ
ໄດເລກະທໍລີສໍາລັບການເກັບຮັກສາຜົນໄດ້ຮັບ.
ປັດໄຈນໍາເຂົ້າ ເອກະສານ
ໄຟລ໌ສະເພາະ genparse (ປົກກະຕິແລ້ວເອີ້ນວ່າ 'ໄຟລ໌ genparse') ປະກອບດ້ວຍຕົວເລກ
ຂອງລາຍການ, ຫນຶ່ງຕໍ່ພາລາມິເຕີແຖວຄໍາສັ່ງ, ຂອງແບບຟອມ:
short_names[*|!] [/ long_name[*|!][=opt_name]] ປະເພດ [ ທາງເລືອກໃນການ ]
A ຊື່ສັ້ນ ເປັນຕົວອັກສອນດຽວ (ນ້ອຍ ຫຼື ນະຄອນຫຼວງ) ຫຼື ຕົວເລກດຽວ. long_name ເປັນ
ຊື່ທາງເລືອກທີ່ຍາວກວ່າ (ອະທິບາຍເພີ່ມເຕີມ). ໃນແຖວຄໍາສັ່ງຊື່ສັ້ນຈະຖືກນໍາຫນ້າ
ໂດຍ dash ດຽວ (ເຊັ່ນ '-a') ແລະສະບັບຍາວຈະຖືກນໍາຫນ້າດ້ວຍສອງ dashes (ເຊັ່ນ:
'--ທັງໝົດ'). ຖ້າຊື່ພາລາມິເຕີຍາວບໍ່ຈໍາເປັນ, ທ່ານອາດຈະລະບຸພຽງແຕ່ຊື່ສັ້ນ
(ແລະ slash ບໍ່ຈໍາເປັນຕ້ອງປາກົດ). ເພື່ອກໍານົດພາລາມິເຕີທີ່ມີຄວາມຍາວເທົ່ານັ້ນ
ຕັ້ງຊື່ short_names to NONE. ມັນເປັນໄປໄດ້ທີ່ຈະມີທາງເລືອກສັ້ນຫຼາຍ, ດັ່ງນັ້ນສໍາລັບ
ການຕັ້ງຕົວຢ່າງ ຊື່ສັ້ນ ກັບ 'aA' ແລະ long_name ກັບ 'ທັງຫມົດ' ຈະອະນຸຍາດໃຫ້ລະບຸ
ເສັ້ນຄໍາສັ່ງປ່ຽນເປັນ '-a' ຫຼື '-A' ຫຼື '--all', ພວກມັນທັງຫມົດເຮັດແບບດຽວກັນ.
A * ຫຼັງຈາກ ຊື່ສັ້ນ or long_name ເຮັດໃຫ້ການໂຕ້ຖຽງເປັນທາງເລືອກ. ນີ້ສາມາດຖືກກໍານົດສໍາລັບ
ທາງເລືອກສັ້ນແລະຍາວແຍກຕ່າງຫາກ.
A ! ຫຼັງຈາກ ຊື່ສັ້ນ or long_name ເຮັດໃຫ້ທາງເລືອກ boolean. ນີ້ອະນຸຍາດໃຫ້ຫນຶ່ງເພື່ອສົມທົບ a
ທາງເລືອກສັ້ນ boolean ທີ່ມີທາງເລືອກຍາວທີ່ມີການໂຕ້ຖຽງທາງເລືອກຫຼືບັງຄັບຫຼື to
ສົມທົບທາງເລືອກຍາວ boolean ກັບທາງເລືອກສັ້ນທີ່ມີການໂຕ້ຖຽງທາງເລືອກຫຼືບັງຄັບ.
A ! ບໍ່ມີຄວາມຫມາຍຖ້າຫາກວ່າປະເພດຂອງທາງເລືອກແມ່ນ ທຸງ.
ປະເພດ ຕ້ອງເປັນຫນຶ່ງໃນ int float char string or ທຸງ. ສີ່ອັນທໍາອິດຄວນຈະເປັນຂອງຕົນເອງ.
ອະທິບາຍ. ສຸດທ້າຍແມ່ນທາງເລືອກ "ສະຫຼັບ" ທີ່ບໍ່ມີການໂຕ້ຖຽງ. ສໍາລັບຜົນຜະລິດ C ແລະຖ້າ
--gnulib ຖືກຕັ້ງຢູ່ໃນເສັ້ນຄໍາສັ່ງ ນອກຈາກນັ້ນ, ປະເພດຕໍ່ໄປນີ້ແມ່ນອະນຸຍາດໃຫ້: ຍາວ
(ສໍາລັບ int ຍາວ), ແຜ (ສໍາລັບ unsigned long int), intmax (ສໍາລັບ intmax_t, ກໍານົດໃນ Gnulib),
uintmax (ສໍາລັບ uintmax_t), double.
ຕໍ່ໄປນີ້ ທາງເລືອກໃນການ ໄດ້ຮັບການສະຫນັບສະຫນູນ. ພວກເຂົາເຈົ້າອາດຈະປາກົດຢູ່ໃນຄໍາສັ່ງໃດຫນຶ່ງແລະຍົກເວັ້ນສໍາລັບ
ຄໍາອະທິບາຍ ພຽງແຕ່ຫນຶ່ງຂອງແຕ່ລະພາກສະຫນາມອາດຈະຖືກກໍານົດຕໍ່ທາງເລືອກ.
A Default ມູນຄ່າ ສໍາລັບພາລາມິເຕີ. ສໍາລັບສະຕຣິງນີ້ແມ່ນພຽງແຕ່ຄ່າເລີ່ມຕົ້ນທໍາມະດາ
ມູນຄ່າ, ໃດກໍ່ຕາມມັນເປັນ. ສຳລັບສະຕຣິງ, ຄ່າເລີ່ມຕົ້ນຕ້ອງຖືກລະບຸພາຍໃນວົງເລັບ ແລະ
quotes, ແລະອາດຈະປະກອບມີ whitespace, ເຊັ່ນ: {"ຄ່າເລີ່ມຕົ້ນຂອງຂ້ອຍ"}. ສໍາລັບ char ເປັນ
ພາລາມິເຕີທີ່ມັນຕ້ອງຖືກລວມຢູ່ໃນວົງຢືມດຽວ, ຕົວຢ່າງ 'a' ຫຼື '\n'.
A ລະດັບ ຂອງຄ່າພາຍໃນວົງເລັບ. ຄ່າຕ່ຳ ແລະ ສູງ ແມ່ນກຳນົດລະຫວ່າງ a
ຕົວລະບຸຂອບເຂດ (ທັງ '...' ຫຼື '..'). ບໍ່ວ່າຄ່າສູງຫຼືຕ່ໍາອາດຈະເປັນ
ຖືກລະເວັ້ນສຳລັບໄລຍະທີ່ຜູກມັດຢູ່ຂ້າງໜຶ່ງເທົ່ານັ້ນ. ພາລາມິເຕີຈະຖືກກວດສອບ
ໃຫ້ແນ່ໃຈວ່າມັນຢູ່ໃນຂອບເຂດນີ້.
A ໂທກັບ ຫນ້າທີ່. ຟັງຊັນນີ້ເອີ້ນວ່າຫຼັງຈາກການກວດສອບຂອບເຂດໃດໆ
ປະຕິບັດ. ຈຸດປະສົງຂອງການໂທກັບຄືນໄປບ່ອນເພື່ອເຮັດການກວດສອບຄວາມຖືກຕ້ອງທີ່ຫຼາຍກວ່າ
ສັບສົນກວ່າທີ່ສາມາດລະບຸໄວ້ໃນໄຟລ໌ genparse. ຕົວຢ່າງ, ທ່ານອາດຈະ
ຂຽນໂຄງການທີ່ຮຽກຮ້ອງໃຫ້ມີການປ້ອນຂໍ້ມູນເປັນຕົວເລກຕົ້ນຕໍ, ສະຕິງຂອງສະເພາະໃດຫນຶ່ງ
ຄວາມຍາວ, ແລະອື່ນໆ.
A ຄໍາອະທິບາຍ ໃນວົງຢືມຄູ່. ມັນໄດ້ຖືກພິມອອກໂດຍ ການນໍາໃຊ້ () ຫນ້າທີ່. ຖ້າຫນຶ່ງ
ແຖວບໍ່ພຽງພໍຫຼັງຈາກນັ້ນໃຫ້ລະບຸຫຼາຍຄໍາອະທິບາຍ, ຫນຶ່ງຕໍ່ແຖວແລະແຕ່ລະ
ເຂົາເຈົ້າຢູ່ໃນວົງຢືມຄູ່. ຖ້າຄໍາອະທິບາຍເລີ່ມຕົ້ນຢູ່ໃນຄໍລໍາທີ 1 ໃນ Genparse
ໄຟລ໌ຫຼັງຈາກນັ້ນມັນຍັງຈະຖືກພິມຢູ່ໃນຖັນທີ 1 ໃນ ການນໍາໃຊ້ () function
A #gp_include ຄໍາສັ່ງຈະສັ່ງໃຫ້ genparse ປະກອບມີໄຟລ໌ genparse ອື່ນ,
ຕົວຢ່າງ: #gp_include ອີກ.gp. ອະນຸຍາດໃຫ້ມີພຽງການກຳນົດພາລາມິເຕີເທົ່ານັ້ນ
ໄຟລ໌, ບໍ່ມີຄໍາແນະນໍາທົ່ວໂລກ.
An __ERR_MSG__(err_txt) ຄໍາສັ່ງ. ລະບຸຂໍ້ຄວາມຄວາມຜິດພາດທີ່ພິມອອກ
ເມື່ອການໂຕ້ຖຽງບໍ່ສາມາດປ່ຽນໄດ້. ຕົວຢ່າງ: __ERR_MSG__("%s: ທີ່ບໍ່ຖືກຕ້ອງ
ການໂຕ້ຖຽງ"). ຂໍ້ຄວາມນີ້ຈະຖືກພິມອອກເມື່ອມີຟັງຊັນການແປງ
ລົ້ມເຫລວ ຫຼືເມື່ອການໂຕ້ຖຽງຢູ່ນອກຂອບເຂດ. ຖືວ່າມີອັນນຶ່ງ %s ເຊິ່ງຈະ
ຖືກແທນທີ່ດ້ວຍຂໍ້ຂັດແຍ້ງທີ່ບໍ່ສາມາດປ່ຽນໄດ້. ສາມາດໃຊ້ໄດ້ເມື່ອ
Genparse ແມ່ນ invoked ກັບ --gnulib, ຖືກລະເລີຍຖ້າບໍ່ດັ່ງນັ້ນ.
ທາງເລືອກໃນການປ່ຽນຫນ້າທີ່ສາມາດຖືກເພີ່ມເປັນການໂຕ້ຖຽງທີສອງ, ຕົວຢ່າງ
__ERR_MSG__("%s: ທີ່ບໍ່ຖືກຕ້ອງ ການໂຕ້ຖຽງ", quotearg). ນີ້ຈະນໍາໄປສູ່ການຂໍ້ຄວາມຜິດພາດ
ຄື ຄວາມຜິດພາດ (EXIT_FAILURE, 0, "%s: ທີ່ບໍ່ຖືກຕ້ອງ ການໂຕ້ຖຽງ", quotearg (ເລືອກ)).
An __ADD_FLAG__ ຄໍາສັ່ງ. ເຮັດໃຫ້ຄວາມຮູ້ສຶກພຽງແຕ່ຖ້າຕົວກໍານົດການເສັ້ນຄໍາສັ່ງບໍ່ແມ່ນ
ທຸງແລ້ວ, ໃນກໍລະນີນີ້ຕົວກໍານົດການທຸງເພີ່ມເຕີມຈະຖືກເພີ່ມເຊິ່ງຈະເປັນ
ຕັ້ງຖ້າພາລາມິເຕີແຖວຄໍາສັ່ງຖືກລະບຸໄວ້ໃນເສັ້ນຄໍາສັ່ງ. ທາງເລືອກນີ້
ຖືກຕັ້ງໂດຍອັດຕະໂນມັດຖ້າພາລາມິເຕີມີ argument ທາງເລືອກ.
A __CODE__(ຖະແຫຼງການ) ຄໍາສັ່ງ. ຖະແຫຼງການລະຫັດທີ່ລະບຸໄວ້ຈະຖືກສຳເນົາ
ຮູ້ຫນັງສື. ຕົວຢ່າງ: __CODE__(printf ("ພາລາມິເຕີ x ແມ່ນ ຕັ້ງ");). ລະຫັດທີ່ລະບຸ
ສາມາດຂະຫຍາຍໄດ້ຫຼາຍກວ່າໜຶ່ງເສັ້ນ. ເພື່ອໃຫ້ Genparse ມີໂອກາດ
ຫຍໍ້ໜ້າລະຫັດໃຫ້ຖືກຕ້ອງ, ຢ່າປະສົມຊ່ອງຫວ່າງ ແລະແຖບຫຍໍ້ໜ້າເຂົ້າກັນ __CODE__
ຄໍາຖະແຫຼງທີ່.
A __STORE_LONGINDEX__ ຄໍາສັ່ງ. ແນະນຳ Genparse ເພື່ອເພີ່ມຊ່ອງຂໍ້ມູນປະເພດ interer
ໄປຫາຫ້ອງຮຽນຜົນໄດ້ຮັບເຊິ່ງຈະຖືກຕັ້ງເປັນຕົວແປ longindex (ການໂຕ້ຖຽງສຸດທ້າຍໃນ
ການໂທຫາ @code{getopt_long()}). ຊ່ອງຂໍ້ມູນໃຫມ່ນີ້ຈະໄດ້ຮັບຊື່ດຽວກັນກັບ
ພາກສະຫນາມຜົນໄດ້ຮັບມັນກ່ຽວຂ້ອງກັບແຕ່ກັບ _ລີ postfix.
ຕໍ່ໄປນີ້ ທົ່ວໂລກ directives ໄດ້ຮັບການສະຫນັບສະຫນູນ. ພວກເຂົາເຈົ້າອາດຈະປາກົດຢູ່ໃນຄໍາສັ່ງໃດໆ.
An #include ຄໍາສັ່ງຈະແນະນໍາ genparse ເພື່ອຄັດລອກຄໍາຖະແຫຼງທີ່ກ່າວມາ
ເຂົ້າໄປໃນລະຫັດ C ຫຼື C++ ທີ່ສ້າງຂຶ້ນໂດຍ genparse, ແຕ່ບໍ່ມີໄຟລ໌ header ຫຼື callback
ໄຟລ໌.
A # ບັງຄັບ ຄໍາສັ່ງສາມາດນໍາໃຊ້ມັນເຮັດໃຫ້ການນໍາໃຊ້ () ຟັງຊັນໂທ nicer. ມັນອະນຸຍາດໃຫ້
ທ່ານຈະລະບຸຕົວກໍານົດການເສັ້ນຄໍາສັ່ງບັງຄັບທີ່ອາດຈະຕິດຕາມສະຫຼັບ. ຫມາຍເຫດ
ທີ່ Genparse ບໍ່ໄດ້ກວດເບິ່ງຕົວກໍານົດການບັງຄັບ, ພວກມັນພຽງແຕ່ພິມຢູ່ໃນ
ການນໍາໃຊ້ () ການທໍາງານກັບ __MANDATORIES__ ທິດທາງ. ຄັດສະ ເໜີ: ເພີ່ມ ການບັງຄັບ
ພາລາມິເຕີ in ໄດ້ # ການນໍາໃຊ້ ສ່ວນ ແທນທີ່ຈະເປັນ.
An #exit_value ຄໍາສັ່ງທີ່ລະບຸຄ່າອອກໃນກໍລະນີຂອງຄວາມຜິດພາດ.
ຄ່າເລີ່ມຕົ້ນແມ່ນ EXIT_FAILURE.
A #break_lines ຄໍາສັ່ງທີ່ກໍານົດຄວາມກວ້າງຂອງເສັ້ນທີ່ຈະແຕກ
ໃນຫນ້າຈໍການຊ່ວຍເຫຼືອ. ຖ້າບໍ່ມີ #break_lines ຄໍາສັ່ງແມ່ນຖືກກໍານົດຫຼັງຈາກນັ້ນສາຍຈະເປັນ
ພິມຢ່າງແນ່ນອນຕາມທີ່ໄດ້ລະບຸໄວ້ໃນໄຟລ໌ genparse.
If #no_struct ໄດ້ຖືກລະບຸໄວ້ຫຼັງຈາກນັ້ນບໍ່ມີໂຄງສ້າງຈະຖືກກໍານົດທີ່ຈະເຕັມໄປດ້ວຍ
ຕົວກໍານົດການເສັ້ນຄໍາສັ່ງໃນ parser ທີ່ສ້າງຂຶ້ນ. ນີ້ອາດຈະເປັນປະໂຫຍດຖ້າທ່ານ
ຕ້ອງການເພີ່ມລະຫັດຂອງທ່ານເອງດ້ວຍ __CODE__ ຖະແຫຼງການແທນ. ສະຫນັບສະຫນູນພຽງແຕ່ C
ຜົນຜະລິດ.
A #export_long_options ຄໍາສັ່ງ. ຖ້າ #export_long_options ຖືກກໍານົດຫຼັງຈາກນັ້ນ a
ຫນ້າທີ່ #get_long_options() ຖືກເພີ່ມທີ່ສົ່ງອອກອາເຣ longoptions ທີ່ໃຊ້ໂດຍ
#getpt_long(). ຄໍາສັ່ງນີ້ແມ່ນມີພຽງແຕ່ສໍາລັບຜົນໄດ້ຮັບ C, ສໍາລັບພາສາອື່ນໆ
ມັນຖືກລະເລີຍ.
A ທົ່ວໂລກ ໂທກັບ ຫນ້າທີ່. ຟັງຊັນນີ້ແມ່ນເປັນປະໂຫຍດສໍາລັບການກວດສອບຄວາມຂຶ້ນກັບກັນ
ລະຫວ່າງຕົວກໍານົດການ. ຄວາມເພິ່ງພາອາໄສກັນບໍ່ສາມາດກວດສອບໄດ້ພາຍໃນແຕ່ລະບຸກຄົນ
ຟັງຊັນ callback ເພາະວ່າຄໍາສັ່ງທີ່ຟັງຊັນເຫຼົ່ານີ້ຈະຖືກເອີ້ນວ່າແຕກຕ່າງກັນ,
ຂຶ້ນກັບຄໍາສັ່ງຂອງຕົວກໍານົດການຢູ່ໃນເສັ້ນຄໍາສັ່ງ.
Genparse ຍັງສ້າງ a ການນໍາໃຊ້ () ຟັງຊັນທີ່ພິມຂໍ້ຄວາມຊ່ວຍເຫຼືອເພື່ອ stdout ກ່ຽວກັບ
ການນໍາໃຊ້ໂຄງການທີ່ Genparse ກໍາລັງສ້າງ parser. ມັນສາມາດໄດ້ຮັບການປັບແຕ່ງໂດຍ
ການລະບຸພາກສ່ວນການນຳໃຊ້ຢູ່ລຸ່ມສຸດຂອງໄຟລ໌ Genparse. ຖ້າບໍ່ມີພາກສ່ວນດັ່ງກ່າວ
ລະບຸໄວ້ວ່າມັນເປັນຄ່າເລີ່ມຕົ້ນ
#usage_begin
ການນຳໃຊ້: __PROGRAM_NAME__ __OPTIONS_SHORT__ __MANDATORIES__
__GLOSSARY__
#usage_end
ພາກສ່ວນການນໍາໃຊ້ເລີ່ມຕົ້ນດ້ວຍ #usage_begin ແລະສິ້ນສຸດດ້ວຍ #usage_end. ຂໍ້ຄວາມໃດໆລະຫວ່າງແມ່ນ
ພິມຄຳເວົ້າຍົກເວັ້ນຄຳສັບຕໍ່ໄປນີ້, ເຊິ່ງຈະຖືກແທນທີ່ຕາມລາຍຊື່
ຂ້າງລຸ່ມນີ້:
__PROGRAM_NAME__: ຊື່ໂຄງການ. ໃນ C ແລະ C ++ ຊື່ໂຄງການແມ່ນໄດ້ລະບຸໄວ້ໃນ
argv[0].
__OPTIONS_SHORT__: ບັນຊີລາຍຊື່ຂອງຕົວເລືອກແບບຟອມສັ້ນທີ່ມີຢູ່, ຕົວຢ່າງ [ -abc ].
__MANDATORIES__: ບັນຊີລາຍຊື່ຂອງພາລາມິເຕີບັງຄັບທັງໝົດຕາມທີ່ກຳນົດດ້ວຍ #mandatory
ຄຳ ສັ່ງ. ຄັດສະ ເໜີ: ບັນຊີລາຍຊື່ ການບັງຄັບ ພາລາມິເຕີ ທີ່ນີ້ ໂດຍກົງ.
__GLOSSARY__: ລາຍລະອຽດຂອງຕົວເລືອກແຖວຄໍາສັ່ງທັງໝົດ. ນີ້ແມ່ນຂໍ້ມູນ
ໃຫ້ສໍາລັບຄໍານິຍາມພາລາມິເຕີໃນຮູບແບບທີ່ມະນຸດອ່ານໄດ້. ມັນປະກອບມີ
ປະເພດພາລາມິເຕີ, ຄ່າເລີ່ມຕົ້ນ, ໄລຍະ ແລະຄຳເຫັນໃດໆ. ເສັ້ນທີ່ປະກອບດ້ວຍ
__GLOSSARY__ ຖືກແທນທີ່ດ້ວຍຄໍາສັບຂອງພາລາມິເຕີ, ຂໍ້ຄວາມອື່ນໆໃນ
ເສັ້ນດຽວກັນຖືກລະເລີຍ.
__GLOSSARY_GNU__: ຄືກັນກັບ __GLOSSARY__ ແຕ່ໃນແບບ GNU. ທາງເລືອກຕາມໂດຍການ
ຈຳນວນເຕັມໃນວົງເລັບທີ່ລະບຸການຫຍໍ້ໜ້າຂອງຂໍ້ຄວາມອະທິບາຍ (ຕົວຢ່າງ
__GLOSSARY__(30)). ການຫຍໍ້ໜ້າເລີ່ມຕົ້ນແມ່ນ 24.
__STRING__(ວິ): ເປັນສະຕຣິງຄົງທີ່, ໃນ C ອາດຈະເປັນ macro string ທີ່ກໍານົດດ້ວຍ
# ກໍານົດຄໍາສັ່ງ preprocessor. ມະຫາພາກນີ້ສາມາດຖືກນໍາເຂົ້າຈາກໄຟລ໌ອື່ນໂດຍໃຊ້
ປະກອບມີຄໍາແນະນໍາໃນໄຟລ໌ genparse. ຖືກລະເລີຍເມື່ອສ້າງຜົນຜະລິດ Java.
__INT__(x): ຈໍານວນຄົງທີ່, ໃນ C ອາດຈະເປັນ macro integer ກໍານົດດ້ວຍ
# ກໍານົດຄໍາສັ່ງ preprocessor. ມະຫາພາກນີ້ສາມາດຖືກນໍາເຂົ້າຈາກໄຟລ໌ອື່ນໂດຍໃຊ້
ປະກອບມີຄໍາແນະນໍາໃນໄຟລ໌ genparse. ຖືກລະເລີຍເມື່ອສ້າງຜົນຜະລິດ Java.
__CODE__(ຖະແຫຼງການ): ຄືກັນກັບທາງເລືອກພາລາມິເຕີ, ເບິ່ງຂ້າງເທິງ.
__DO_NOT_DOCUMENT__: ແຖວໃດນຶ່ງທີ່ບັນຈຸມະຫາພາກນີ້ຈະບໍ່ຖືກພິມຢູ່ໃນ
ການນໍາໃຊ້ () ຫນ້າທີ່. ສາມາດໃຊ້ສໍາລັບການປະຕິບັດຕົວກໍານົດການເສັ້ນຄໍາສັ່ງໂດຍບໍ່ມີການ
ລາຍຊື່ພວກມັນຢູ່ໃນຫນ້າຈໍຊ່ວຍເຫຼືອ.
__NL__: ສາຍໃໝ່. ເປັນປະໂຫຍດສໍາລັບການ breaking ສາຍດ້ວຍຕົນເອງໃນຂະນະທີ່ breaking ສາຍອັດຕະໂນມັດ
ເປີດ (ເບິ່ງ #break_lines). ຖືກລະເລີຍເມື່ອສ້າງຜົນຜະລິດ Java.
__NEW_PRINT__: ປິດຄຳສັ່ງພິມທີ່ໃຊ້ງານແລ້ວເລີ່ມອັນໃໝ່.
__COMMENT__(ຂໍ້ຄວາມ): ຄໍາຄິດຄໍາເຫັນໃນລະຫັດສໍາລັບການພິມຂໍ້ຄວາມການນໍາໃຊ້.
ທາງເລືອກຍາວສາມາດປະຕິບັດຕາມດ້ວຍສັນຍາລັກ = ແລະການອອກແບບທາງເລືອກ opt_name ທີ່ສາມາດເຮັດໄດ້
ອ້າງເຖິງຢູ່ໃນຄໍາອະທິບາຍຕໍ່ໄປນີ້. ມັນຈະຖືກນໍາໃຊ້ໃນ ການນໍາໃຊ້ () ຫນ້າທີ່
ເທົ່ານັ້ນ. ຕົວຢ່າງເຊັ່ນເສັ້ນ genparse ຕໍ່ໄປນີ້
s / block-size=SIZE int "ໃຊ້ SIZE-byte blocks"
ຈະນໍາໄປສູ່ເສັ້ນຕໍ່ໄປນີ້ໃນຫນ້າຈໍຊ່ວຍເຫຼືອ
[ -s ] [ --block-size=SIZE ] (type=INTEGER)
ໃຊ້ SIZE-byte blocks
ໃນຮູບແບບ genparse (__GLOSSARY__) ຫຼື
-s, --block-size=SIZE ໃຊ້ SIZE-byte blocks
ໃນແບບ GNU (__GLOSSARY_GNU__).
ມັນຍັງສາມາດໃສ່ວົງເລັບສີ່ຫຼ່ຽມຮອບຊື່ທາງເລືອກເພື່ອຊີ້ບອກ
ວ່າການໂຕ້ຖຽງແມ່ນທາງເລືອກ. ນີ້ບໍ່ມີຄວາມຫມາຍສໍາລັບ parser ທີ່ສ້າງຂຶ້ນຢ່າງໃດກໍ່ຕາມ. ໃຊ້
* postfixes ເພື່ອເຮັດໃຫ້ການໂຕ້ຖຽງທາງເລືອກ.
s* / block*[=SIZE] int "ໃຊ້ບລັອກ."
"ຖ້າ SIZE ບໍ່ໄດ້ໃຫ້, ພວກເຂົາຈະໄດ້ຮັບຂະຫນາດ 1kB."
ຈະນໍາໄປສູ່ເສັ້ນຕໍ່ໄປນີ້ໃນຫນ້າຈໍຊ່ວຍເຫຼືອ
-s, --block[=SIZE] ໃຊ້ບລັອກ.
ຖ້າ SIZE ບໍ່ໄດ້ໃຫ້, ພວກເຂົາຈະໄດ້ຮັບຂະຫນາດ 1kB.
EXAMPLE
ນີ້ແມ່ນຕົວຢ່າງໄຟລ໌ genparse:
#ລວມທັງ
/* ຄໍາເຫັນ */
my_callback()
i / iterations int 100 [10...1000] iter_callback()
"ຈໍານວນການຊໍ້າຄືນທີ່ຈະດໍາເນີນການ."
/*
* ຄໍາຄິດຄໍາເຫັນ
*/
n / ຊື່ສະຕຣິງ {"mike"} name_cb() "ຊື່ຜູ້ໃຊ້"
s / str string "test string"
f ທຸງ "ທຸງໂງ່!"
#usage_begin
ການນຳໃຊ້: __PROGRAM_NAME__ __OPTIONS_SHORT__ ຊື່ໄຟລ໌
ນີ້ແມ່ນພຽງແຕ່ໂຄງການທົດສອບໂງ່.
__GLOSSARY__
#usage_end
ໃຊ້ genparse ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net
