SWISH-LIBRARY - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

SWISH-LIBRARY - ການໂຕ້ຕອບກັບຫ້ອງສະຫມຸດ Swish-e C

ພາບລວມ

ຫ້ອງສະຫມຸດ C ໃນການໂຕ້ຕອບກັບລະຫັດຄົ້ນຫາ Swish-e. ມັນສະຫນອງວິທີການຝັງ
Swish-e ເຂົ້າໄປໃນຄໍາຮ້ອງສະຫມັກຂອງທ່ານ. API ນີ້ແມ່ນອີງໃສ່ Swish-e ເວີຊັນ 2.3.

ຫມາຍ​ເຫດ​: ນີ້ແມ່ນ API ໃໝ່ຂອງ Swish-e ເວີຊັນ 2.3. ການໂຕ້ຕອບພາສາ C ມີການປ່ຽນແປງ
ດັ່ງທີ່ມີການໂຕ້ຕອບ perl ກັບ Swish-e. ການໂຕ້ຕອບ Perl ໃຫມ່ແມ່ນ SWISH::API module ແລະ
ແມ່ນລວມກັບການແຈກຢາຍ Swish-e. ໂມດູນ SWISHE perl ເກົ່າໄດ້ຖືກຂຽນຄືນໃຫມ່
ເພື່ອເຮັດວຽກກັບ API ໃໝ່. ໂມດູນ SWISHE perl ບໍ່ໄດ້ລວມເຂົ້າກັບ Swish-e ອີກຕໍ່ໄປ
ການແຈກຢາຍ, ແຕ່ສາມາດດາວໂຫລດໄດ້ຈາກເວັບໄຊທ໌ Swish-e.

ປະໂຫຍດຂອງຫ້ອງສະຫມຸດແມ່ນວ່າໄຟລ໌ດັດສະນີຫຼືໄຟລ໌ສາມາດເປີດຫນຶ່ງຄັ້ງແລະ
ຫຼາຍຄໍາຖາມທີ່ເຮັດຢູ່ໃນດັດຊະນີເປີດ. ນີ້ຊ່ວຍປະຢັດເວລາເລີ່ມຕົ້ນທີ່ຕ້ອງການເພື່ອສ້ອມແລະແລ່ນ
swish-e binary, ແລະເວລາລາຄາແພງຂອງການເປີດໄຟລ໌ດັດສະນີ. ບາງມາດຕະຖານ
ໄດ້ສະແດງໃຫ້ເຫັນເຖິງການເພີ່ມຂຶ້ນສາມເທົ່າໃນຄວາມໄວ.

ຂໍ້ເສຍແມ່ນວ່າໂຄງການຂອງທ່ານໃນປັດຈຸບັນມີລະຫັດແລະຂໍ້ມູນຫຼາຍຂຶ້ນ (ຕາຕະລາງດັດສະນີສາມາດເຮັດໄດ້
ໃຊ້​ຄວາມ​ຊົງ​ຈໍາ​ທີ່​ຂ້ອນ​ຂ້າງ​ນ້ອຍ​)​, ແລະ​ຖ້າ​ຫາກ​ວ່າ​ຄວາມ​ຜິດ​ພາດ​ທີ່​ຮ້າຍ​ແຮງ​ເກີດ​ຂຶ້ນ​ໃນ swish ມັນ​ຈະ​ເຮັດ​ໃຫ້​ທ່ານ​ຫຼຸດ​ລົງ​
ໂຄງການ. ເຫຼົ່ານີ້ແມ່ນສິ່ງທີ່ຄວນຄິດກ່ຽວກັບ, ໂດຍສະເພາະຖ້າຝັງ swish ເຂົ້າໄປໃນເຄື່ອງແມ່ຂ່າຍເວັບໄຊຕ໌
ເຊັ່ນ Apache ບ່ອນທີ່ມີຫຼາຍຂະບວນການຮັບໃຊ້ການຮ້ອງຂໍ.

ວິທີທີ່ດີທີ່ສຸດທີ່ຈະຮຽນຮູ້ກ່ຽວກັບຫ້ອງສະຫມຸດແມ່ນເບິ່ງສອງໄຟລ໌ທີ່ລວມຢູ່ໃນ Swish-e
ການແຈກຢາຍທີ່ນໍາໃຊ້ຫ້ອງສະຫມຸດ.

src/libtest.c
ໄຟລ໌ນີ້ໃຫ້ພາບລວມພື້ນຖານຂອງການເຊື່ອມໂຍງໂຄງການ C ກັບຫ້ອງສະຫມຸດ Swish-e. ບໍ່ແມ່ນ
ຟັງຊັນທີ່ມີຢູ່ທັງຫມົດແມ່ນຖືກນໍາໃຊ້ໃນຕົວຢ່າງນັ້ນ, ແຕ່ມັນຄວນຈະໃຫ້ທ່ານດີ
ພາບລວມຂອງການສ້າງໂປຼແກຼມ C ດ້ວຍ swish-e.

ເພື່ອສ້າງແລະດໍາເນີນການ libtest chdir ໄປຫາໄດເລກະທໍລີ src ແລະດໍາເນີນການຄໍາສັ່ງ:

$ ເຮັດໃຫ້ libtest
$ ./libtest [ຊື່ທາງເລືອກຂອງໄຟລ໌ດັດສະນີ]

ທ່ານຈະໄດ້ຮັບການເຕືອນສໍາລັບຄໍາຄົ້ນຫາ. ດັດຊະນີເລີ່ມຕົ້ນທີ່ໃຊ້ແມ່ນ index.swish-e.
ນີ້ສາມາດຖືກລົບລ້າງໂດຍການວາງລາຍຊື່ຂອງໄຟລ໌ດັດສະນີໃນສະຕຣິງທີ່ປົກປ້ອງດ້ວຍຄໍາເວົ້າ.

$ ./libtest 'index1 index2 index3'

perl/API.xs
ໄດ້ API.xs ໄຟລ໌ແມ່ນການໂຕ້ຕອບ Perl "xsub" ກັບຫ້ອງສະຫມຸດ C ແລະເປັນສ່ວນຫນຶ່ງຂອງ
SWISH::API Perl module. ນີ້ແມ່ນການໂຕ້ຕອບແບບວັດຖຸກັບຫ້ອງສະໝຸດ Swish-e
ແລະສະແດງໃຫ້ເຫັນວິທີການຄົ້ນຫາຕ່າງໆ "ວັດຖຸ" ຖືກສ້າງຂື້ນໂດຍການໂທຫາ C ແລະວິທີການທີ່ພວກມັນ
ຖືກທໍາລາຍເມື່ອບໍ່ຈໍາເປັນ.

ການຕິດຕັ້ງ ໄດ້ Swish-e ຫ້ອງສະຫມຸດ

ຫ້ອງສະຫມຸດ Swish-e ຖືກຕິດຕັ້ງເມື່ອທ່ານດໍາເນີນການ "ເຮັດການຕິດຕັ້ງ" ເມື່ອສ້າງ Swish-e. ບໍ່
ຂັ້ນຕອນການຕິດຕັ້ງພິເສດແມ່ນຕ້ອງການ.

ຫ້ອງສະຫມຸດປະກອບດ້ວຍໄຟລ໌ສ່ວນຫົວ "swish-eh" ແລະຫ້ອງສະຫມຸດ "libswish-e.*" ທີ່ສາມາດ
ບໍ່ວ່າຈະເປັນຫ້ອງສະໝຸດແບບຄົງທີ່ ຫຼືຫ້ອງສະໝຸດທີ່ໃຊ້ຮ່ວມກັນ ຂຶ້ນກັບເວທີຂອງທ່ານ.

ຫ້ອງສະຫມຸດ ພາບລວມ

ເມື່ອທ່ານຕິດໄຟລ໌ດັດສະນີ (ຫຼືໄຟລ໌ດັດສະນີ) ທໍາອິດ, ທ່ານຈະຖືກສົ່ງກັບ "swish handle".
ຈາກຕົວຈັບທ່ານສ້າງຫນຶ່ງຫຼືຫຼາຍ "ວັດຖຸຄົ້ນຫາ" ເຊິ່ງຖືພາລາມິເຕີໄປ
ສອບຖາມດັດສະນີ, ເຊັ່ນ: ສາຍຄຳຊອກຫາ, ລຳດັບການຮຽງລຳດັບ, ຕົວຂັ້ນຄຳຊອກຫາ, ຂີດຈຳກັດ.
ພາລາມິເຕີແລະໂຄງສ້າງ HTML bits. "ວັດຖຸ" ແມ່ນພຽງແຕ່ຕົວຊີ້ໄປຫາ C
ໂຄງສ້າງ, ແຕ່ມັນເປັນປະໂຫຍດທີ່ຈະຄິດວ່າມັນເປັນວັດຖຸທີ່ຂໍ້ມູນແລະການເຮັດວຽກ
ກ່ຽວຂ້ອງກັບມັນ.

ວັດຖຸຄົ້ນຫາຖືກນໍາໃຊ້ເພື່ອສອບຖາມດັດສະນີ. ການສອບຖາມສົ່ງຄືນ "ວັດຖຸຜົນໄດ້ຮັບ". ໄດ້
ວັດ​ຖຸ​ຜົນ​ໄດ້​ຮັບ​ຖື​ຈ​ໍ​າ​ນວນ​ຂອງ hits, ການ​ສອບ​ຖາມ​ທີ່​ວິ​ເຄາະ​ຕໍ່​ດັດ​ຊະ​ນີ, ແລະ​ຊຸດ​ຜົນ​ໄດ້​ຮັບ.
ວັດຖຸຜົນໄດ້ຮັບຕິດຕາມຕໍາແຫນ່ງປະຈຸບັນໃນຊຸດຜົນໄດ້ຮັບ. ເຈົ້າອາດຈະ "ຊອກຫາ"
ກັບບັນທຶກສະເພາະພາຍໃນຊຸດຜົນໄດ້ຮັບ (ທີ່ເປັນປະໂຫຍດສໍາລັບການສະແດງຫນ້າຜົນໄດ້ຮັບ).

ສຸດທ້າຍ, ວັດຖຸຜົນໄດ້ຮັບເປັນຕົວແທນຂອງຜົນໄດ້ຮັບດຽວຈາກບັນຊີລາຍຊື່ຜົນໄດ້ຮັບ. ວັດຖຸຜົນ
ໃຫ້ການເຂົ້າເຖິງຄຸນສົມບັດຂອງຜົນໄດ້ຮັບ (ເຊັ່ນ: ຊື່ໄຟລ໌, ອັນດັບ, ແລະອື່ນໆ).

ນອກເໜືອໄປຈາກຜົນໄດ້ຮັບ, ມີຟັງຊັນຕ່າງໆເພື່ອເຂົ້າເຖິງຄ່າ header ທີ່ເກັບໄວ້
ໃນເອກະສານດັດສະນີ, ຫນ້າທີ່ກວດສອບແລະລາຍງານຂໍ້ຜິດພາດ, ແລະຫນ້າທີ່ມີປະໂຫຍດຈໍານວນຫນຶ່ງ.

ມີ ຫນ້າທີ່

ຂ້າງລຸ່ມນີ້ແມ່ນບັນຊີລາຍຊື່ຂອງຟັງຊັນທີ່ມີຢູ່ໃນ Swish-e C language API.

ຫນ້າທີ່ເຫຼົ່ານີ້ (ແລະ typedefs) ຖືກກໍານົດຢູ່ໃນ swish-ເອີ ໄຟລ໌ຫົວ. ທົ່ວໄປ
ວັດຖຸ (ເຊັ່ນ: ໂຄງສ້າງ) ທີ່ໃຊ້ແມ່ນ:

SW_HANDLE - ໂຕຈັບ swish ທີ່ເຊື່ອມໂຍງກັບໄຟລ໌ດັດສະນີ
SW_SEARCH - ຄົ້ນຫາ "ວັດຖຸ" ທີ່ຖືພາລາມິເຕີການຄົ້ນຫາ
SW_RESULTS - ຜົນໄດ້ຮັບ "ວັດຖຸ" ທີ່ຖືຊຸດຜົນໄດ້ຮັບ
SW_RESULT - ຜົນໄດ້ຮັບດຽວທີ່ໃຊ້ສໍາລັບການເຂົ້າເຖິງຄຸນສົມບັດຂອງຜົນໄດ້ຮັບ
SW_FUZZYWORD - ໃຊ້ສໍາລັບການປ່ຽນຄໍາສັບ fuzzy (stemming).

ຊອກຫາ

SW_HANDLE SwishInit(char *IndexFiles);
ຟັງຊັນນີ້ຈະເປີດ ແລະອ່ານຂໍ້ມູນສ່ວນຫົວຂອງໄຟລ໌ດັດສະນີທີ່ລວມຢູ່ໃນ
IndexFiles string. ສະຕຣິງຄວນມີລາຍຊື່ໄຟລ໌ດັດຊະນີທີ່ແຍກກັນຈາກຊ່ອງຫວ່າງ.

SW_HANDLE ມືຈັບຂອງຂ້ອຍ;
myhandle = SwishInit("file1.idx");

ໂດຍປົກກະຕິທ່ານຈະເປີດຕົວຈັບໃນຕອນເລີ່ມຕົ້ນຂອງໂປຼແກຼມຂອງທ່ານແລະໃຊ້ມັນເພື່ອສ້າງ
ຫຼາຍຄໍາຖາມຢູ່ໃນດັດຊະນີ.

ຟັງຊັນນີ້ຈະສົ່ງຄືນຕົວຈັບສະວິດສະເໝີ. ທ່ານຕ້ອງກວດເບິ່ງຄວາມຜິດພາດ, ແລະສຸດ
ຄວາມ​ຜິດ​ພາດ​ບໍ່​ມີ​ຄວາມ​ຊົງ​ຈໍາ​ທີ່​ໃຊ້​ໂດຍ​ມື​ຈັບ​, ຫຼື​ຍົກ​ເລີກ​.

ນີ້ແມ່ນຕົວຢ່າງຂອງການເອົາລູກອອກ:

SW_HANDLE swish_handle;
swish_handle = SwishInit("file1.idx file2.idx");
ຖ້າ ( SwishError( swish_handle ) )
SwishAbortLastError( swish_handle );

ແລະນີ້ແມ່ນຕົວຢ່າງຂອງການຈັບຄວາມຜິດພາດ:

SW_HANDLE swish_handle;
swish_handle = SwishInit("file1.idx file2.idx");
ຖ້າ ( SwishError( swish_handle ) )
{
printf("ການເຊື່ອມຕໍ່ຫາ swish ລົ້ມເຫລວ. %s\n", SwishErrorString( swish_handle ) );
SwishClose( swish_handle ); /* ປົດ​ປ່ອຍ​ຄວາມ​ຊົງ​ຈໍາ​ທີ່​ນໍາ​ໃຊ້ */
return 0
}

ເຈົ້າອາດມີຕົວຈັບຫຼາຍກວ່າໜຶ່ງອັນທີ່ເຮັດວຽກຢູ່ຕໍ່ຄັ້ງ.

Swish-e ຈະບໍ່ບອກທ່ານວ່າໄຟລ໌ດັດສະນີມີການປ່ຽນແປງຢູ່ໃນແຜ່ນ (ເຊັ່ນ: ຫຼັງຈາກ
reindexing). ໃນສະພາບແວດລ້ອມຄົງທີ່ (ເຊັ່ນ: mod_perl) ໂຄງການການໂທຄວນ
ກວດເບິ່ງວ່າໄຟລ໌ດັດສະນີມີການປ່ຽນແປງຢູ່ໃນແຜ່ນ. ວິທີການທົ່ວໄປທີ່ຈະເຮັດນີ້ແມ່ນເພື່ອ
ເກັບຮັກສາຕົວເລກ inode ກ່ອນທີ່ຈະເປີດໄຟລ໌ດັດສະນີ, ແລະຫຼັງຈາກນັ້ນລະບຸຊື່ໄຟລ໌
ເລື້ອຍໆແລະເປີດໄຟລ໌ດັດສະນີຄືນໃຫມ່ຖ້າຕົວເລກ inode ປ່ຽນແປງ.

void SwishClose(SW_HANDLE handle);
ຟັງຊັນນີ້ປິດແລະປ່ອຍຄວາມຊົງຈໍາຂອງຕົວຈັບ Swish. ທຸກໆ swish handle
ຄວນຈະໄດ້ຮັບການປົດປ່ອຍເມື່ອເຮັດການຄົ້ນຫາດັດສະນີ. ລົ້ມເຫລວໃນການປິດ handle ຈະ
ສົ່ງຜົນໃຫ້ຄວາມຊົງຈໍາຮົ່ວໄຫຼ.

SW_SEARCH New_Search_Object(SW_HANDLE handle, const char *query);
ສົ່ງຄືນການຄົ້ນຫາໃຫມ່ "object". ວັດຖຸຄົ້ນຫາຖືພາລາມິເຕີທີ່ໃຊ້ສໍາລັບ
ຄົ້ນຫາດັດສະນີ. ວັດຖຸຄົ້ນຫາອັນດຽວສາມາດຖືກນໍາໃຊ້ເພື່ອສອບຖາມດັດສະນີຫຼາຍ
ເທື່ອ. ການ​ຕັ້ງ​ຄ່າ​ທີ່​ມີ​ຢູ່​ຂ້າງ​ລຸ່ມ​ນີ້​ແມ່ນ "ຕິດ​" ທີ່​ພວກ​ເຂົາ​ເຈົ້າ​ຍັງ​ຄົງ​ຕັ້ງ​ຢູ່​
ຈຸດປະສົງຄົ້ນຫາຈົນກ່ວາການປ່ຽນແປງ.

int SwishGetStructure( SW_SEARCH srch );
ຕອບທຸງ "ໂຄງສ້າງ" ຂອງວັດຖຸຊອກຫາທີ່ຜ່ານ ຫຼື 0 ຖ້າວັດຖຸຊອກຫາແມ່ນ
NULL.

void SwishPhraseDelimiter( SW_SEARCH srch, char delimiter );
ກໍານົດຕົວອັກສອນຕົວຂັ້ນປະໂຫຍກ. ຄ່າເລີ່ມຕົ້ນແມ່ນສອງວົງຢືມ.

char SwishGetPhraseDelimiter( SW_SEARCH srch );
ສົ່ງຄ່າຕົວຂັ້ນປະໂຫຍກທີ່ໃຊ້ໃນວັດຖຸຊອກຫາ ຫຼື 0 ຖ້າການຄົ້ນຫາ
ວັດຖຸແມ່ນ NULL.

void SwishSetStructure( SW_SEARCH srch, ໂຄງສ້າງ int );
ກໍານົດທຸງ "ໂຄງສ້າງ" ໃນວັດຖຸຄົ້ນຫາ. ທຸງໂຄງສ້າງຖືກນໍາໃຊ້ເພື່ອຈໍາກັດ
ຄົ້ນຫາພາກສ່ວນຂອງໄຟລ໌ HTML (ເຊັ່ນ: ຫົວຂໍ້ ຫຼືສ່ວນຫົວ). ຄ່າເລີ່ມຕົ້ນແມ່ນເພື່ອ
ບໍ່ຈໍາກັດ. ນີ້ສະຫນອງການເຮັດວຽກຂອງສະຫຼັບເສັ້ນຄໍາສັ່ງ -H.

void SwishPhraseDelimiter( SW_SEARCH srch, char delimiter );
ກໍານົດຕົວອັກສອນຕົວຂັ້ນປະໂຫຍກ. ຄ່າເລີ່ມຕົ້ນແມ່ນສອງວົງຢືມ.

void SwishSetSort( SW_SEARCH srch, char *sort );
ກໍານົດລໍາດັບການຈັດລຽງຂອງຜົນໄດ້ຮັບ. ນີ້ແມ່ນຄືກັນກັບສະວິດ -s ທີ່ໃຊ້ກັບ
swish-e ຄູ່.

void SwishSetQuery( SW_SEARCH srch, char *query );
ຕັ້ງສະຕຣິງແບບສອບຖາມໃນວັດຖຸຊອກຫາ. ໂດຍທົ່ວໄປແລ້ວນີ້ບໍ່ຈໍາເປັນເພາະວ່າມັນສາມາດເຮັດໄດ້
ຕັ້ງຄ່າເມື່ອສ້າງວັດຖຸຊອກຫາ ຫຼືເມື່ອດຳເນີນການສອບຖາມ.

void SwishSetSearchLimit( SW_SEARCH srch, char *propertyname, char *low, char *hi);
ກໍານົດຂອບເຂດຈໍາກັດສໍາລັບການຄົ້ນຫາ. ສະຫນອງຫນ້າທີ່ດຽວກັນກັບ -L
ສະຫຼັບເສັ້ນຄໍາສັ່ງ. ທ່ານອາດຈະກໍານົດຂອບເຂດຂອງມູນຄ່າຊັບສິນທີ່ຜົນການຄົ້ນຫາ
ຕ້ອງຢູ່ໃນ. ເຈົ້າອາດຈະໂທຫາ SwishSetSearchLimit() ພຽງແຕ່ຫນຶ່ງຄັ້ງສໍາລັບແຕ່ລະຊັບສິນ
(ແຕ່ສາມາດກໍານົດຂອບເຂດຈໍາກັດຫຼາຍກວ່າຫນຶ່ງຊັບສິນໃນເວລາດຽວ).

ບໍ່ເຫມືອນກັບການຕັ້ງຄ່າອື່ນໆໃນວັດຖຸຊອກຫາ, ເມື່ອທ່ານດໍາເນີນການສອບຖາມໃນການຄົ້ນຫາ
ວັດຖຸທີ່ທ່ານຕ້ອງໂທຫາ SwishResetSearchLimit() ເພື່ອປ່ຽນ ຫຼືລຶບລ້າງພາລາມິເຕີຂີດຈຳກັດ.

void SwishResetSearchLimit( SW_SEARCH srch );
ປັບ​ຂໍ້​ຈໍາ​ກັດ​ທີ່​ກໍາ​ນົດ​ໄວ້​ໃນ​ວັດ​ຖຸ​ການ​ຊອກ​ຫາ​ທີ່​ກໍາ​ນົດ​ໄວ້​ໂດຍ​ SwishSetSearchLimit().

void Free_Search_Object( SW_SEARCH srch );
ປົດປ່ອຍວັດຖຸຊອກຫາ. ອັນນີ້ຕ້ອງຖືກເອີ້ນເມື່ອເຮັດກັບວັດຖຸຊອກຫາ.
ໂດຍ​ທົ່ວ​ໄປ​ແລ້ວ​, ທ່ານ​ສາ​ມາດ​ນໍາ​ໃຊ້​ຄືນ​ໃຫມ່​ວັດ​ຖຸ​ການ​ຄົ້ນ​ຫາ​ສໍາ​ລັບ​ການ​ສອບ​ຖາມ​ຫຼາຍ​ສະ​ນັ້ນ​ໂດຍ​ປົກ​ກະ​ຕິ​ທ່ານ​ຈະ​
ໂທຫາສິດນີ້ກ່ອນທີ່ຈະໂທຫາ SwishClose().

ເຈົ້າອາດຈະປ່ອຍວັດຖຸຊອກຫາກ່ອນທີ່ຈະປ່ອຍ ແລະສ້າງຜົນໄດ້ຮັບ.

SW_RESULTS SwishExecute( SW_SEARCH ຄົ້ນຫາ, const char *query);
ຄົ້ນຫາດັດສະນີຫຼືດັດສະນີໂດຍອີງໃສ່ພາລາມິເຕີໃນວັດຖຸຄົ້ນຫາ. ສົ່ງຄືນ ກ
ຈຸດປະສົງຜົນໄດ້ຮັບ. ເບິ່ງຂ້າງລຸ່ມນີ້ສໍາລັບຫນ້າທີ່ໃນການເຂົ້າເຖິງຂໍ້ມູນທີ່ເກັບໄວ້ໃນຜົນໄດ້ຮັບ
ວັດຖຸ

ທ່ານຄວນກວດເບິ່ງຄວາມຜິດພາດຢູ່ສະເໝີຫຼັງຈາກການໂທ SwishExecute().

SW_RESULTS SwishQuery(SW_HANDLE, const char *words );
ນີ້​ແມ່ນ​ການ​ທໍາ​ງານ​ການ​ຕັດ​ສັ້ນ​ທີ່​ຂ້າມ​ການ​ສ້າງ​ຂອງ​ການ​ຄົ້ນ​ຫາ (ທີ່​ຈິງ​ແລ້ວ​,
bypasses ຄວາມຕ້ອງການທີ່ຈະສ້າງແລະປົດປ່ອຍວັດຖຸຊອກຫາ). ນີ້ພຽງແຕ່ອະນຸຍາດໃຫ້ຜ່ານໃນ a
string query; ຕົວກໍານົດການຊອກຫາອື່ນໆບໍ່ສາມາດຖືກຕັ້ງ. ຜົນໄດ້ຮັບແມ່ນຈັດຮຽງຕາມລໍາດັບ.

ທ່ານຄວນກວດເບິ່ງຄວາມຜິດພາດຢູ່ສະເໝີຫຼັງຈາກການໂທ SwishQuery().

ອ່ານ ຜົນການຄົ້ນຫາ

int SwishHits( SW_RESULTS ຜົນໄດ້ຮັບ );
ຕອບຈໍານວນຜົນໄດ້ຮັບໃນວັດຖຸຜົນໄດ້ຮັບ.

SWISH_HEADER_VALUE SwishParsedWords( SW_RESULTS, const char *index_name );
ສົ່ງຄືນການສອບຖາມໂທເຄນ. ຄໍາສັບຕ່າງໆແມ່ນແບ່ງອອກໂດຍ WordCharacters ແລະຄໍາຢຸດແມ່ນ
ເອົາອອກ. ຄຳສັບທີ່ແຍກອອກແມ່ນເປັນປະໂຫຍດສຳລັບການເນັ້ນຄຳຊອກຫາໃນໂປຣແກຣມຂອງທ່ານ.

"index_name" ແມ່ນຊື່ຂອງດັດຊະນີທີ່ສະຫນອງໃຫ້ຢູ່ໃນ SwishInit() ໂທຟັງຊັນ.

ໃຫ້ຜົນເປັນສະກຸນ SWISH_HEADER_VALUE ຂອງປະເພດ SWISH_LIST ເຊິ່ງເປັນຕົວອັກສອນ **. ເບິ່ງ
src/libtest.c ສໍາລັບຕົວຢ່າງຂອງການເຂົ້າເຖິງ strings ໃນບັນຊີລາຍຊື່ນີ້, ແຕ່ໂດຍທົ່ວໄປແລ້ວທ່ານ
ອາດຈະໂຍນນີ້ເປັນ (char **).

SWISH_HEADER_VALUE SwishRemovedStopwords( SW_RESULTS, const char *index_name );
ສົ່ງຄືນລາຍຊື່ຂອງຄຳຢຸດທີ່ຖອດອອກຈາກການສອບຖາມຂໍ້ມູນເຂົ້າ.

ໃຫ້ຜົນເປັນສະກຸນ SWISH_HEADER_VALUE ຂອງປະເພດ SWISH_LIST ເຊິ່ງເປັນຕົວອັກສອນ **. ເບິ່ງ
src/libtest.c ສໍາລັບຕົວຢ່າງຂອງການເຂົ້າເຖິງ strings ໃນບັນຊີລາຍຊື່ນີ້, ແຕ່ໂດຍທົ່ວໄປແລ້ວທ່ານ
ອາດຈະໂຍນນີ້ເປັນ (char **).

int SwishSeekResult( SW_RESULTS, ຕຳແໜ່ງ int );
ກຳນົດຕຳແໜ່ງສະແຫວງຫາປັດຈຸບັນໃນລາຍການຜົນໄດ້ຮັບ, ໂດຍມີຕຳແໜ່ງສູນເປັນ
ບັນທຶກທໍາອິດ (ບໍ່ຄືກັບ -b ບ່ອນທີ່ຫນຶ່ງແມ່ນຜົນໄດ້ຮັບທໍາອິດ).

ສົ່ງຄືນຕໍາແໜ່ງ ຫຼືຕົວເລກລົບຍ້ອນຄວາມຜິດພາດ.

SW_RESULT SwishNextResult( SW_RESULTS );
ຕອບຜົນໄດ້ຮັບຕໍ່ໄປ, ຫຼື NULL ຖ້າບໍ່ມີຜົນໄດ້ຮັບເພີ່ມເຕີມ.

ຈຸດ​ປະ​ສົງ​ທີ່​ໄດ້​ຮັບ​ກັບ​ຄືນ​ມາ​ບໍ່​ຈໍາ​ເປັນ​ຕ້ອງ​ໄດ້​ຮັບ​ການ​ປົດ​ປ່ອຍ​ຫຼັງ​ຈາກ​ການ​ນໍາ​ໃຊ້ (ບໍ່​ເຫມືອນ​ກັບ swish ໄດ້​
handle, search object, and results object).

const char *SwishResultPropertyStr(SW_RESULT, char *propertyname);
ຟັງຊັນນີ້ສ່ວນໃຫຍ່ແມ່ນເປັນປະໂຫຍດສໍາລັບການທົດສອບຍ້ອນວ່າມັນສົ່ງຄືນຜົນໄດ້ຮັບທີ່ແປກປະຫຼາດໃນຄວາມຜິດພາດ.

ຍົກເລີກຫາກຖືກເອີ້ນດ້ວຍວັດຖຸ NULL SW_RESULT

ຕອບຄ່າສະຕຣິງຂອງຄຸນສົມບັດທີ່ລະບຸ.

ຕອບສະຕຣິງຫວ່າງເປົ່າ "" ຖ້າຜົນໄດ້ຮັບປັດຈຸບັນບໍ່ມີຄຸນສົມບັດທີ່ລະບຸ
ມອບຫມາຍ.

ຕອບສະຕຣິງ "(null)" ໃນຊື່ຊັບສິນທີ່ບໍ່ຖືກຕ້ອງ (ເຊັ່ນ: ຊື່ຄຸນສົມບັດບໍ່ແມ່ນ
ກໍານົດຢູ່ໃນດັດຊະນີ) ແລະກໍານົດຄວາມຜິດພາດ (ເບິ່ງຂ້າງລຸ່ມນີ້) ຊີ້ໃຫ້ເຫັນຊັບສິນທີ່ບໍ່ຖືກຕ້ອງ
ຊື່

ສະຕຣິງທີ່ສົ່ງຄືນບໍ່ຈໍາເປັນຕ້ອງຖືກປົດປ່ອຍ, ແຕ່ໃຊ້ໄດ້ກັບປັດຈຸບັນເທົ່ານັ້ນ
ຜົນໄດ້ຮັບ. ຖ້າທ່ານຕ້ອງການບັນທຶກສະຕຣິງ, ທ່ານຕ້ອງຄັດລອກມັນຢູ່ໃນເຄື່ອງ.

ວັນທີຖືກຈັດຮູບແບບໂດຍໃຊ້ສະຕຣິງຮູບແບບທີ່ຫາຍາກ: "%Y-%m-%d %H:%M:%S" ໃນ
ເວລາທ້ອງຖິ່ນ.

unsigned long SwishResultPropertyULong(SW_RESULT r, char *propertyname);
ໃຫ້ຜົນເປັນຊັບສິນຕົວເລກເປັນຄວາມຍາວທີ່ບໍ່ມີລາຍເຊັນ. ຄຸນສົມບັດຕົວເລກແມ່ນໃຊ້ສໍາລັບທັງສອງ
PropertyNamesNumeric ແລະ PropertyNamesDate ປະເພດຂອງຄຸນສົມບັດ. ວັນທີຖືກສົ່ງຄືນເປັນ
unix timestamp ຕາມການລາຍງານໂດຍລະບົບເມື່ອດັດສະນີຖືກສ້າງຂຶ້ນ.

Swish-e ຈະຍົກເລີກຫາກຖືກເອີ້ນດ້ວຍວັດຖຸ NULL SW_RESULT. ໂດຍບໍ່ມີການ SW_RESULT
object swish-e ບໍ່ສາມາດຕັ້ງລະຫັດຂໍ້ຜິດພາດໃດໆ.

ດ້ວຍຄວາມຜິດພາດສົ່ງຄືນ UMAX_LONG. ນີ້ຖືກກໍານົດໂດຍທົ່ວໄປໃນ limits.h. ກວດສອບ SwishError()
(ເບິ່ງຂ້າງລຸ່ມນີ້) ສໍາລັບປະເພດຂອງຄວາມຜິດພາດ.

If SwishError() ກັບຄືນ false (ສູນ) ຫຼັງຈາກນັ້ນມັນພຽງແຕ່ຫມາຍຄວາມວ່າຜົນໄດ້ຮັບນີ້ບໍ່ໄດ້
ມີຂໍ້ມູນໃດໆສໍາລັບຊັບສິນທີ່ລະບຸໄວ້.

If SwishError() ໃຫ້ຜົນເປັນຈິງ (ບໍ່ແມ່ນສູນ) ຈາກນັ້ນຊື່ຊັບສິນທີ່ລະບຸໄວ້ແມ່ນ
ບໍ່ຖືກຕ້ອງ, ຫຼືຊັບສິນທີ່ຮ້ອງຂໍບໍ່ແມ່ນຕົວເລກ (ຫຼືວັນທີ) ຊັບສິນ (ເຊັ່ນ: ມັນເປັນ
ຄຸນສົມບັດສະຕຣິງ).

ເບິ່ງຂ້າງລຸ່ມນີ້ກ່ຽວກັບວິທີການດຶງຂໍ້ຄວາມສະແດງຂໍ້ຜິດພາດສະເພາະໃນເວລາທີ່ SwishError() ແມ່ນຄວາມຈິງ.

PropValue *getResultPropValue (SW_RESULT r, char *propertyname, int ID );
ນີ້ແມ່ນຟັງຊັນລະດັບຕໍ່າເພື່ອດຶງຊັບສິນໂດຍບໍ່ຄໍານຶງເຖິງປະເພດ. ນີ້ແມ່ນເປັນໄປໄດ້
ຫນ້າທີ່ທີ່ດີທີ່ສຸດສໍາລັບການເຂົ້າເຖິງຄຸນສົມບັດ.

Swish-e ຈະຍົກເລີກຫາກຖືກເອີ້ນດ້ວຍວັດຖຸ NULL SW_RESULT. ຊື່ຊັບສິນແມ່ນຊື່
ຂອງຊັບສິນ. ID ແມ່ນໝາຍເລກ id ຂອງຊັບສິນ, ຖ້າຮູ້ຈັກ. ID ແມ່ນບໍ່ປົກກະຕິ
ໃຊ້ໃນ API, ແຕ່ຈຸດປະສົງຂອງມັນແມ່ນເພື່ອຫຼີກເວັ້ນການຊອກຫາ ID ຊັບສິນສໍາລັບທຸກໆ
ຜົນ​ໄດ້​ຮັບ​ສະ​ແດງ​ອອກ​.

ການກັບຄືນ PropValue ແມ່ນໂຄງສ້າງທີ່ມີທຸງເພື່ອຊີ້ບອກປະເພດ, ແລະ a
ສະຫະພັນທີ່ຖືມູນຄ່າຊັບສິນ. ພວກເຂົາທຸງແລະໂຄງສ້າງແມ່ນຖືກກໍານົດໄວ້ໃນ
swish-ເອີ

ຊັບສິນຕ້ອງຖືກສຳເນົາຢູ່ໃນເຄື່ອງ ແລະຄ່າ "PropValue" ທີ່ສົ່ງມາຈະຕ້ອງຖືກປົດປ່ອຍ
ໂດຍການໂທຫາ freeResultPropValue() ເພື່ອຫຼີກເວັ້ນການຮົ່ວໄຫຼຂອງຄວາມຊົງຈໍາ.

ເມື່ອເກີດຄວາມຜິດພາດກັບຄືນມາ NULL. ກວດສອບ SwishError() (ເບິ່ງຂ້າງລຸ່ມນີ້) ສໍາລັບປະເພດຂອງຄວາມຜິດພາດ.

ຖ້າກັບຄືນ NULL ແຕ່ SwishError() ກັບຄືນ false (ສູນ) ຫຼັງຈາກນັ້ນມັນພຽງແຕ່ຫມາຍຄວາມວ່ານີ້
ຜົນໄດ້ຮັບບໍ່ມີຂໍ້ມູນໃດໆສໍາລັບຄຸນສົມບັດທີ່ລະບຸ.

If SwishError() ໃຫ້ຜົນເປັນຈິງ (ບໍ່ແມ່ນສູນ) ຈາກນັ້ນຊື່ຊັບສິນທີ່ລະບຸນັ້ນບໍ່ຖືກຕ້ອງ
(ie ບໍ່ໄດ້ກໍານົດສໍາລັບດັດຊະນີ).

ເບິ່ງຂ້າງລຸ່ມນີ້ກ່ຽວກັບວິທີການດຶງຂໍ້ຄວາມສະແດງຂໍ້ຜິດພາດສະເພາະໃນເວລາທີ່ SwishError() ແມ່ນຄວາມຈິງ.

ເບິ່ງ perl/API.xs ສໍາລັບຕົວຢ່າງການນໍາໃຊ້ຟັງຊັນນີ້.

void freeResultPropValue(void)
ປົດປ່ອຍ "PropValue" ກັບຄືນມາຫຼັງຈາກການໂທ getResultPropValue().

void Free_Results_Object( SW_RESULTS ຜົນໄດ້ຮັບ );
ປົດປ່ອຍວັດຖຸຜົນໄດ້ຮັບ (ປົດປ່ອຍຊຸດຜົນໄດ້ຮັບ). ອັນນີ້ຕ້ອງເອີ້ນວ່າເມື່ອເຮັດແລ້ວ
ອ່ານຜົນໄດ້ຮັບແລະກ່ອນທີ່ຈະໂທຫາ SwishClose().

ການເຂົ້າເຖິງ ໄດ້ ດັດຊະນີ Header ມູນຄ່າ

ແຕ່ລະໄຟລ໌ດັດສະນີມີຄ່າສ່ວນຫົວທີ່ກ່ຽວຂ້ອງທີ່ອະທິບາຍດັດຊະນີ. ຫນ້າທີ່ເຫຼົ່ານີ້
ໃຫ້ການເຂົ້າເຖິງຂໍ້ມູນນີ້. ຂໍ້​ມູນ​ສ່ວນ​ຫົວ​ແມ່ນ​ໄດ້​ກັບ​ຄືນ​ມາ​ເປັນ​ສະ​ຫະ​ພາບ SWISH_HEADER_VALUE,
ແລະຕົວຊີ້ໄປຫາ SWISH_HEADER_TYPE ຖືກສົ່ງເຂົ້າ ແລະຄ່າທີ່ສົ່ງຄືນມາສະແດງເຖິງ
ປະເພດຂອງຂໍ້ມູນທີ່ສົ່ງຄືນ. ເບິ່ງ src/libtest.c ແລະ perl/API.xs ສໍາລັບຕົວຢ່າງ.

const char **SwishHeaderNames(SW_HANDLE );
ສົ່ງຄືນລາຍຊື່ຂອງຊື່ສ່ວນຫົວທີ່ເປັນໄປໄດ້. ບັນຊີລາຍຊື່ນີ້ແມ່ນຄືກັນສໍາລັບໄຟລ໌ດັດສະນີທັງຫມົດ
ສະບັບທີ່ໃຫ້ໄວ້ຂອງ Swish-e. ມັນສະຫນອງວິທີການເຂົ້າເຖິງສ່ວນຫົວທັງຫມົດ
ໂດຍ​ບໍ່​ຈໍາ​ເປັນ​ຕ້ອງ​ລາຍ​ຊື່​ໃຫ້​ເຂົາ​ເຈົ້າ​ຢູ່​ໃນ​ໂຄງ​ການ​ຂອງ​ທ່ານ​.

const char **SwishIndexNames( SW_HANDLE );
ສົ່ງຄືນລາຍຊື່ຂອງໄຟລ໌ດັດສະນີທີ່ເປີດ. ນີ້ແມ່ນພຽງແຕ່ບັນຊີລາຍຊື່ຂອງໄຟລ໌ດັດສະນີທີ່ລະບຸໄວ້
ໃນ SwishInit() ໂທ. ທ່ານຕ້ອງການຊື່ຂອງໄຟລ໌ດັດສະນີເພື່ອເຂົ້າເຖິງສະເພາະ
ຄ່າສ່ວນຫົວຂອງດັດຊະນີ.

SWISH_HEADER_VALUE SwishHeaderValue( SW_HANDLE, const char *index_name, const char
*cur_header, SWISH_HEADER_TYPE *ປະເພດ );
ດຶງເອົາຄ່າສ່ວນຫົວຂອງໄຟລ໌ດັດຊະນີທີ່ໃຫ້, ແລະຊື່ສ່ວນຫົວ. ຊຸດການໂທ
"ປະເພດ" ເຂົ້າໄປໃນປະເພດຂອງມູນຄ່າທີ່ສົ່ງຄືນ.

ເບິ່ງ src/libtest.c ແລະ perl/API.xs ສໍາລັບຕົວຢ່າງ.

SWISH_HEADER_VALUE SwishResultIndexValue( SW_RESULT, const char *name, SWISH_HEADER_TYPE
* ປະ​ເພດ​)​;
ນີ້ແມ່ນຄ້າຍຄື SwishHeaderValue() ຂ້າງເທິງ, ແຕ່ແທນທີ່ຈະສະຫນອງຊື່ໄຟລ໌ດັດສະນີແລະ
ຈັບ swish, ສະຫນອງວັດຖຸຜົນໄດ້ຮັບແລະມູນຄ່າ header ແມ່ນ fetched ຈາກ
ໄຟລ໌ດັດສະນີທີ່ກ່ຽວຂ້ອງຂອງຜົນໄດ້ຮັບ.

ການເຂົ້າເຖິງ ຄຸນສົມບັດ Meta ຂໍ້ມູນ

ນອກເຫນືອໄປຈາກຄຸນສົມບັດມາດຕະຖານທີ່ກໍານົດໄວ້ລ່ວງຫນ້າ, ທ່ານມີທາງເລືອກທີ່ຈະເພີ່ມ
ຄຸນສົມບັດ "meta" ເພີ່ມເຕີມທີ່ຈະຖືກດັດສະນີແລະ/ຫຼືເພີ່ມໃສ່ລາຍຊື່ຄຸນສົມບັດທີ່ສົ່ງຄືນ
ກັບແຕ່ລະຜົນໄດ້ຮັບ. ປຶກສາກັບພາກສ່ວນຕ່າງໆໃນຄໍາສັ່ງ MetaNames ແລະ PropteryNames ໃນ
ໄຟລ໌ CONFIGURATION ສໍາລັບຄໍາອະທິບາຍກ່ຽວກັບວິທີເຮັດສິ່ງນີ້.

ຫນ້າທີ່ເຫຼົ່ານີ້ສະຫນອງການເຂົ້າເຖິງຂໍ້ມູນ meta ທີ່ເກັບໄວ້ໃນດັດຊະນີ. ທ່ານສາມາດນໍາໃຊ້ໃຫ້ເຂົາເຈົ້າ
ກໍານົດວ່າຂໍ້ມູນ meta/property ໃດມີຢູ່ສໍາລັບດັດສະນີລວມທັງທັງຫມົດກ່ອນ.
ຄຸນສົມບັດມາດຕະຖານທີ່ກໍານົດ. ເບິ່ງ libtest.c ເປັນຕົວຢ່າງ.

SWISH_META_LIST SwishMetaList( SW_HANDLE, const char *index_name );
ສົ່ງຄືນລາຍຊື່ meta entries ສໍາລັບໄຟລ໌ດັດຊະນີທີ່ໃຫ້ມາເປັນ array null-terminated
ຂອງວັດຖຸ SW_META. ໃຊ້ຟັງຊັນລຸ່ມນີ້ເພື່ອສະກັດຊ່ອງຂໍ້ມູນສະເພາະຈາກ
ໂຄງສ້າງ SW_META. Metas ແມ່ນແຕກຕ່າງຈາກຄຸນສົມບັດ.

SWISH_META_LIST SwishPropertyList(SW_HANDLE, const char *index_name );
ຟັງຊັນນີ້ແມ່ນຄືກັນກັບ SwishMetaList() ແຕ່ມັນສົ່ງຄືນ array ຂອງຄຸນສົມບັດເປັນ
ກົງກັນຂ້າມກັບວັດຖຸ meta. ຄຸນລັກສະນະຂອງຊັບສິນສາມາດຖືກສະກັດອອກມາໃນແບບດຽວກັນກັບ meta
ວັດຖຸທີ່ໃຊ້ຫນ້າທີ່ຂ້າງລຸ່ມນີ້.

SWISH_META_LIST SwishResultMetaList( SW_RESULT );
ນີ້ແມ່ນຄ້າຍຄື SwishMetaList() ຂ້າງເທິງແຕ່ກໍານົດດັດຊະນີທີ່ຈະນໍາໃຊ້ຈາກຜົນໄດ້ຮັບ
ວັດຖຸ

SWISH_META_LIST SwishResultPropertyList( SW_RESULT );
ນີ້ແມ່ນຄ້າຍຄື SwishPropertyList() ຂ້າງເທິງແຕ່ມັກ SwishResultMetaList() ໃຊ້ຜົນໄດ້ຮັບ
object ແທນຊື່ດັດສະນີ.

const char *SwishMetaName( SW_META );
ເນື່ອງຈາກວັດຖຸ SW_META ທີ່ສົ່ງຄືນໂດຍອັນໃດອັນໜຶ່ງຂ້າງເທິງ, ຟັງຊັນນີ້ຈະສົ່ງຄືນ
ຊື່ meta/property. ທ່ານສາມາດນໍາໃຊ້ຊື່ນີ້ເພື່ອເຂົ້າເຖິງມູນຄ່າຂອງຊັບສິນສໍາລັບການໃຫ້
ດັ່ງທີ່ໄດ້ອະທິບາຍຂ້າງເທິງ.

int SwishMetaType( SW_META );
ເອົາປະເພດຂໍ້ມູນສໍາລັບ meta/property ທີ່ໃຫ້. ປະເພດທີ່ຮູ້ຈັກແມ່ນລະບຸໄວ້ໃນ swish-eh

SwishMetaID( SW_META );
ເອົາເລກ ID ພາຍໃນສໍາລັບ meta/property ທີ່ໃຫ້. ids ເຫຼົ່ານີ້ແມ່ນເປັນເອກະລັກຕໍ່
ໄຟລ໌ດັດສະນີແຕ່ບໍ່ເປັນເອກະລັກຕໍ່ຜົນໄດ້ຮັບ.

ການກວດສອບ ສໍາລັບການ ຂໍ້ຜິດພາດ

ທ່ານຄວນກວດເບິ່ງຄວາມຜິດພາດຫຼັງຈາກການໂທທັງຫມົດ. ຂໍ້ຜິດພາດສຸດທ້າຍຖືກເກັບໄວ້ໃນຕົວຈັບ swish
ວັດຖຸ, ແລະພຽງແຕ່ຖືກຕ້ອງຈົນກ່ວາການດໍາເນີນການຕໍ່ໄປ (ເຊິ່ງປັບຄ່າທຸງຄວາມຜິດພາດ).

ໃນປັດຈຸບັນ, ບາງຂໍ້ຜິດພາດຖືກໝາຍວ່າເປັນຄວາມຜິດພາດ "ສໍາຄັນ". ໃນກໍລະນີດັ່ງກ່າວນີ້, ທ່ານຄວນ
ທໍາລາຍ (ໂດຍການໂທຫາ SwishClose() function ) ຈັບ ​​swish ໃນປັດຈຸບັນ. ຖ້າເຈົ້າມີ
ວັດຖຸອື່ນໃນຂອບເຂດ (ເຊັ່ນ: ວັດຖຸຊອກຫາ ຫຼືວັດຖຸຜົນໄດ້ຮັບ) ທໍາລາຍສິ່ງເຫຼົ່ານັ້ນກ່ອນ.

ປະເພດຂອງຄວາມຜິດພາດທີ່ມີຄວາມສໍາຄັນສາມາດເຫັນໄດ້ໃນ src/error.c. ໃນປັດຈຸບັນບັນຊີລາຍຊື່
ປະກອບມີ:

ບໍ່ສາມາດເປີດໄຟລ໌ດັດສະນີໄດ້
ຮູບແບບໄຟລ໌ດັດຊະນີທີ່ບໍ່ຮູ້ຈັກ
ໄຟລ໌ດັດສະນີຫວ່າງເປົ່າ
ໄຟລ໌ດັດສະນີຜິດພາດ
ດ້າມຫວິດບໍ່ຖືກຕ້ອງ
ວັດຖຸຜົນໄດ້ຮັບບໍ່ຖືກຕ້ອງ

int SwishError( SW_HANDLE );
ອັນນີ້ໃຫ້ຜົນເປັນຈິງຖ້າມີເງື່ອນໄຂຂໍ້ຜິດພາດ. ມັນສົ່ງຄືນຕົວເລກຄວາມຜິດພາດ, ເຊິ່ງແມ່ນ
ຈຳນວນເຕັມໜ້ອຍກວ່າສູນໃນຄວາມຜິດພາດ. ນີ້ຄວນຈະຖືກກວດສອບກ່ອນທີ່ຈະໂທຫາໃດໆຂອງ
ຫນ້າທີ່ຜິດພາດອື່ນໆຂ້າງລຸ່ມນີ້.

const char *SwishErrorString( SW_HANDLE );
ນີ້ສົ່ງຄືນຄໍາອະທິບາຍຂໍ້ຄວາມທົ່ວໄປຂອງຄວາມຜິດພາດໃນປະຈຸບັນ.

const char *SwishLastErrorMsg( SW_HANDLE );
ໃນບາງກໍລະນີນີ້ຈະສົ່ງຄືນສະຕຣິງທີ່ມີສະເພາະກ່ຽວກັບຄວາມຜິດພາດໃນປະຈຸບັນ. ສໍາລັບ
ຍົກຕົວຢ່າງ, SwishErrorString() ອາດຈະກັບຄືນ "ຊື່ metaname ທີ່ບໍ່ຮູ້", ແຕ່ SwishLastErrorMsg()
ຈະສົ່ງຄືນສະຕຣິງທີ່ມີຊື່ຂອງ metaname ທີ່ບໍ່ຮູ້ຈັກ.

int SwishCriticalError( SW_HANDLE );
ໃຫ້​ຜົນ​ເປັນ​ຖືກ​ຖ້າ​ຫາກ​ວ່າ​ເງື່ອນ​ໄຂ​ຄວາມ​ຜິດ​ພາດ​ປະ​ຈຸ​ບັນ​ເປັນ​ຄວາມ​ຜິດ​ພາດ​ທີ່​ສໍາ​ຄັນ​. ກ່ຽວກັບຄວາມຜິດພາດທີ່ສໍາຄັນ
ທ່ານ​ຄວນ​ຈະ​ປ່ອຍ​ໃຫ້​ເຖິງ​ວັດ​ຖຸ​ປະ​ຈຸ​ບັນ​ໃດ​ຫນຶ່ງ​ແລະ​ໂທ​ຫາ​ SwishClose() ເປັນ swish ອາດຈະຢູ່ໃນ
ສະຖານະບໍ່ໝັ້ນຄົງ.

void SwishAbortLastError( SW_HANDLE );
ນີ້​ແມ່ນ​ຫນ້າ​ທີ່​ສະ​ດວກ​ສະ​ບາຍ​ທີ່​ຈະ​ຈັດ​ຮູບ​ແບບ​ແລະ​ພິມ​ຂໍ້​ຄວາມ​ຜິດ​ພາດ​ສຸດ​ທ້າຍ​, ແລະ​
ຫຼັງຈາກນັ້ນຍົກເລີກໂຄງການ.

void set_error_handle( FILE *ບ່ອນ );
ກໍານົດບ່ອນທີ່ຄວາມຜິດພາດແລະຄໍາເຕືອນຖືກພິມອອກ (ເມື່ອພິມໂດຍ swish). ສໍາລັບປະຫວັດສາດ
ເຫດຜົນ, ເມື່ອ swish-e ທໍາອິດເລີ່ມຕົ້ນຄວາມຜິດພາດແລະການເຕືອນໄພຖືກສົ່ງໄປຫາ stdout.

void SwishErrorsToStderr( void );
ວິທີທີ່ສະດວກສະບາຍທີ່ຈະສົ່ງຂໍ້ຜິດພາດໄປຫາ stderr ແທນ stdout.

ຜົນປະໂຫຍດ ຫນ້າທີ່

const char *SwishWordsByLetter(SWISH * sw, char *indexname, char c);
ສົ່ງຄືນທຸກຄໍາທີ່ຢູ່ໃນດັດຊະນີ "indexname" ທີ່ເລີ່ມຕົ້ນດ້ວຍຕົວອັກສອນທີ່ຜ່ານເຂົ້າ.
ຕອບ NULL ຖ້າຊື່ຂອງໄຟລ໌ດັດຊະນີບໍ່ຖືກຕ້ອງ.

fuction ນີ້ອາດຈະມີການປ່ຽນແປງໃນອະນາຄົດເນື່ອງຈາກວ່າພຽງແຕ່ 8-bit chars ສາມາດຖືກນໍາໃຊ້ໃນປັດຈຸບັນ.

char * SwsishStemWord( SW_HANDLE sw, char *in_word );
Deprecated

ນີ້ສາມາດຖືກນໍາໃຊ້ເພື່ອປ່ຽນຄໍາໄປຫາລໍາຂອງມັນ. ມັນໃຊ້ພຽງແຕ່ Porter ຕົ້ນສະບັບ
ຕົ້ນ.

SW_FUZZYWORD SwishFuzzyWord( SW_RESULT r, char *word );
ລໍາ "ຄໍາ" ໂດຍອີງໃສ່ຮູບແບບ fuzzy ທີ່ເລືອກໃນລະຫວ່າງການດັດສະນີ.

ຮູບແບບ fuzzy ທີ່ໃຊ້ໃນລະຫວ່າງການດັດສະນີແມ່ນເກັບໄວ້ໃນໄຟລ໌ດັດສະນີ. ເນື່ອງຈາກວ່າແຕ່ລະຜົນໄດ້ຮັບແມ່ນ
ການເຊື່ອມໂຍງກັບໄຟລ໌ດັດສະນີທີ່ໃຫ້ວິທີການນີ້ອະນຸຍາດໃຫ້ stemming ຄໍາໂດຍອີງໃສ່ດັດຊະນີຂອງມັນ
ຍື່ນ.

ການນໍາໃຊ້ທີ່ເປັນໄປໄດ້ສໍາລັບການນີ້ແມ່ນເພື່ອເນັ້ນໃສ່ຄໍາຄົ້ນຫາໃນບົດສະຫຼຸບເອກະສານ, ເຊິ່ງ
ຈະອີງໃສ່ຜົນໄດ້ຮັບ.

ວິທີການຂ້າງລຸ່ມນີ້ສາມາດຖືກນໍາໃຊ້ເພື່ອເຂົ້າເຖິງຂໍ້ມູນທີ່ສົ່ງຄືນ. ວັດຖຸ SW_FUZZYWORD
ຕ້ອງໄດ້ຮັບການປົດປ່ອຍເມື່ອເຮັດເພື່ອຫຼີກເວັ້ນການຮົ່ວໄຫຼຂອງຫນ່ວຍຄວາມຈໍາ.

const char **SwishFuzzyWordList( SW_FUZZYWORD fw );
ສົ່ງຄືນລາຍຊື່ສະຕຣິງທີ່ຖືກຍົກເລີກ null ທີ່ສົ່ງຄືນໂດຍ stemmer. ໃນກໍລະນີຫຼາຍທີ່ສຸດ, ນີ້
ຈະເປັນສາຍດຽວ.

ນີ້ແມ່ນຕົວຢ່າງ:

SW_FYZZYWORD fuzzy_word = SwishFuzzyWord(ຜົນ);
const char **word_list = SwishFuzzyWordList(fuzzy_word );
ໃນຂະນະທີ່ ( *word_list )
{
printf("%s\n", *word_list );
word_list++;
}
SwishFuzzyWordFree( fuzzy_word );

ຖ້າ stemmer ບໍ່ປ່ຽນສະຕຣິງ (ຕົວຢ່າງການພະຍາຍາມ stem ຕົວເລກ
data) ລາຍການ word_list ຈະມີຄໍາຕົ້ນສະບັບ. ເພື່ອບອກວ່າ stemmer ຕົວຈິງແລ້ວ
stemmed ຄໍາກວດເບິ່ງມູນຄ່າກັບຄືນດ້ວຍ SwishFuzzyWordError().

int SwishFuzzyWordError( SW_FUZZYWORD fw );
ນີ້ຈະສົ່ງຄ່າເປັນສູນ ຖ້າການດຳເນີນການ stemming ສຳເລັດ, ຖ້າບໍ່ດັ່ງນັ້ນ ມັນຈະສົ່ງຄືນ a
ຄ່າທີ່ຊີ້ບອກເຫດຜົນຂອງຄໍາທີ່ບໍ່ໄດ້ຖືກຕັ້ງໄວ້. ຄ່າກັບຄືນແມ່ນຖືກກໍານົດ
ໃນໄຟລ໌ swish-e src/stemmer.h.

ບໍ່ແມ່ນ stemmers ທັງຫມົດກໍານົດຄ່ານີ້ຢ່າງຖືກຕ້ອງ. ແຕ່ນັບຕັ້ງແຕ່ SwishFuzzyWordList() ຈະກັບຄືນ
ສະຕຣິງທີ່ຖືກຕ້ອງໂດຍບໍ່ຄໍານຶງເຖິງມູນຄ່າກັບຄືນມາ, ທ່ານພຽງແຕ່ສາມາດລະເລີຍການຕັ້ງຄ່ານີ້.
ນັ້ນແມ່ນສິ່ງທີ່ຂ້ອຍເຮັດ.

int SwishFuzzyWordCount( SW_FUZZYWORD fw );
ສົ່ງຄືນການນັບສະຕຣິງໃນລາຍການຄຳສັບທີ່ມີຢູ່ໂດຍການໂທຫາ
SwishFuzzyWordList().

ນີ້ແມ່ນປົກກະຕິພຽງແຕ່ຫນຶ່ງ, ແຕ່ໃນກໍລະນີຂອງ DoubleMetaphone ມັນສາມາດເປັນຫນຶ່ງຫຼືສອງ
(ເຊັ່ນ DoubleMetaphone ສາມາດສົ່ງຄືນນຶ່ງ ຫຼືສອງສາຍ).

const char *SwishFuzzyMode( SW_RESULT r );
ຕອບຊື່ຂອງ stemmer ທີ່ໃຊ້ສໍາລັບຜົນໄດ້ຮັບ (ເຊິ່ງກ່ຽວຂ້ອງກັບ an
ດັດຊະນີ).

void SwishFuzzyWordFree( SW_FUZZYWORD fw );
ປົດປ່ອຍຄວາມຊົງຈຳທີ່ໃຊ້ໂດຍ SW_FUZZYWORD.

ລາຍງານຂໍ້ຜິດພາດ

ກະ​ລຸ​ນາ​ລາຍ​ງານ​ບົດ​ລາຍ​ງານ bug ກັບ​ກຸ່ມ​ສົນ​ທະ​ນາ Swish-e​. ຮູ້ສຶກວ່າບໍ່ເສຍຄ່າເພື່ອປັບປຸງຫຼື
ປັບປຸງຄຸນສົມບັດນີ້.

ຜູ້ຂຽນ

ການໂຕ້ຕອບຕົ້ນສະບັບ: ສິງຫາ 2000 Jose Ruiz [email protected]

ອັບເດດ: ວັນທີ 22 ສິງຫາ 2002 - Bill Moseley

ອິນເຕີເຟດອອກແບບໃໝ່ສຳລັບ Swish-e ເວີຊັນ 2.3 ວັນທີ 17 ຕຸລາ 2002 - Bill Moseley

ເອກະສານ ຂໍ້ມູນ

$Id: SWISH-LIBRARY.pod 1906 2007-02-07 19:25:16Z moseley $

.

ໃຊ້ SWISH-LIBRARY ອອນໄລນ໌ ໂດຍໃຊ້ບໍລິການ onworks.net