genparse - ອອນລາຍໃນຄລາວ

ໂຄງການ:

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