.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH TRIETOOL 1 "DECEMBER 2008"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH "نام (NAME)"
trietool \- ابزاری برای کار با ساختار داده ترای (trie)
.SH "خلاصه دستور (SYNOPSIS)"
\fBtrietool\fP [ \fIoptions\fP ] \fItrie command arg\fP ...
.SH "توضیحات (DESCRIPTION)"
دستور \fBtrietool\fP یک ابزار خط فرمانی برای دستکاری داده‌های ترای دو آرایه‌ای (double-array trie) است. از این ابزار می‌توان برای پرس‌وجو، افزودن و حذف واژه‌ها در یک ترای استفاده کرد.
.P
.SS ساختار ترای (The Trie)
آرگومان \fItrie\fP نام ترای مورد نظر را برای دستکاری مشخص می‌کند.
یک ترای در فایلی با پسوند \`.tri' ذخیره می‌شود. با این حال، برای ایجاد یک ترای جدید، باید فایلی با پسوند \`.abm' تهیه شود که محدوده‌های یونیکد (Unicode) مجموعه الفبای ترای را توصیف می‌کند. فایل ABM مجموعه‌ای از بردارها را تعریف می‌کند که نویسه‌های یونیکد را به یک بازه پیوسته از اعداد صحیح نگاشت می‌کنند.
اعداد صحیح نگاشت‌شده به عنوان الفبای داخلی ترای استفاده خواهند شد.
چنین نگاشتی بدون در نظر گرفتن ناپیوستگی مجموعه نویسه‌های مورد استفاده، تخصیص فضا را در داده‌های ترای بهبود می‌بخشد، زیرا بازه نگاشت‌شده همیشه پیوسته است.
.P
فایل ABM یک فایل متنی ساده است که در هر خط آن محدوده‌ای از یونیکدهای ۳۲-بیتی که باید به مجموعه الفبا افزوده شوند، در قالب زیر مشخص می‌شود:
.IP
[0xSSSS,0xTTTT]
.P
که در آن \`0xSSSS' و \`0xTTTT' به ترتیب مقادیر هگزادسیمال کدهای نویسه آغازین و پایانی این بازه هستند.
.P
برای نمونه، برای یک واژه‌نامه که تنها شامل واژه‌های انگلیسی بدون هیچ علامت نگارشی است، می‌توان فایل \`\fItrie\fP.abm' را به صورت زیر آماده کرد:
.IP
[0x0041,0x005a]
.br
[0x0061,0x007a]
.P
خط نخست کدهای ASCII مربوط به A-Z و خط دوم کدهای مربوط به a-z را مشخص می‌کند.
.P
بیش از ۲۵۵ نویسه الفبا در یک ترای مجاز نیست.
.P
فایل \`.tri' ایجادشده داده‌های ABM را در خود ادغام خواهد کرد؛ بنابراین، فایل \`.abm' پس از نخستین ساخت دیگر نیاز نبوده و نادیده گرفته می‌شود.
.SH "دستورها (COMMANDS)"
دستورهای در دسترس عبارتند از:
.TP
\fBadd\fP \fIword data\fP ...
افزودن \fIword\fP به ترای، همراه با داده عدد صحیح \fIdata\fP مرتبط با آن. تعداد دلخواهی از جفت‌های واژه-داده را می‌توان تعیین کرد. در هر بار دو آرگومان خوانده می‌شود که نخستین به عنوان \fIword\fP و دومی به عنوان \fIdata\fP در نظر گرفته خواهد شد.
.TP
\fBadd-list\fP [ \fIoptions\fP ] \fIlist-file\fP
افزودن واژه‌ها به همراه داده‌های مرتبط فهرست‌شده در \fIlist-file\fP به ترای. فایل \fIlist-file\fP باید یک فایل متنی باشد که در هر خط آن یک واژه فهرست شده باشد. داده مرتبط را می‌توان پس از واژه در همان خط، جداشده با نویسه تب (\`\\t') قرار داد. اگر فیلد داده حذف شود، یک مقدار پیش‌فرض (\-1) به جای آن به کار خواهد رفت.
.TP
.B " "
\fIگزینه‌های\fP در دسترس برای این دستور:
.RS
.TP
.B \-e, \-\-encoding \fIenc\fP
تعیین رمزگذاری نویسه محتویات \fIlist-file\fP، مانند \`UTF-8'. اگر مشخص نشود، مجموعه کد محلی (locale codeset) فعلی در نظر گرفته می‌شود.
.RE
.TP
\fBdelete\fP \fIword\fP ...
حذف \fIword\fP از ترای. تعداد دلخواهی از واژه‌ها برای حذف را می‌توان مشخص کرد.
.TP
\fBdelete-list\fP [ \fIoptions\fP ] \fIlist-file\fP
حذف واژه‌های فهرست‌شده در \fIlist-file\fP از ترای. فایل \fIlist-file\fP باید یک فایل متنی باشد که در هر خط آن یک واژه فهرست شده است.
.TP
.B " "
\fIگزینه‌های\fP در دسترس برای این دستور:
.RS
.TP
.B \-e, \-\-encoding \fIenc\fP
تعیین رمزگذاری نویسه محتویات \fIlist-file\fP، مانند \`UTF-8'. اگر مشخص نشود، مجموعه کد محلی فعلی در نظر گرفته می‌شود.
.RE
.TP
\fBquery\fP \fIword\fP
جستجو برای \fIword\fP در ترای. اگر \fIword\fP وجود داشته باشد، داده‌های مرتبط با آن در خروجی استاندارد چاپ می‌شود. در غیر این صورت، پیام خطایی در خروجی خطای استاندارد چاپ شده و هیچ چیز در خروجی استاندارد چاپ نمی‌شود.
.TP
\fBlist\fP
فهرست کردن همه واژه‌های موجود در ترای در خروجی استاندارد. خروجی در هر خط یک جفت واژه-داده جداشده با نویسه تب (\`\\t') را فهرست می‌کند که قالبی مناسب برای استفاده به عنوان \fIlist-file\fP در دستور \fBadd-list\fP است.
.SH "گزینه‌ها (OPTIONS)"
این برنامه از نحو خط فرمان معمول GNU پیروی می‌کند، که در آن گزینه‌های طولانی با دو خط تیره (\`\-\-\') آغاز می‌شوند.
خلاصه‌ای از گزینه‌ها در زیر آمده است.
.TP
.B \-p, \-\-path \fIdir\fP
تنظیم پوشه ترای به \fIdir\fP [پیش‌فرض=\`.']
.TP
.B \-h, \-\-help
نمایش خلاصه گزینه‌ها.
.TP
.B \-V, \-\-version
نمایش نسخه برنامه.
.SH "نویسندگان (AUTHORS)"
کتابخانه libdatrie توسط Theppitak Karoonboonyanan نوشته شده است.
.PP
این صفحه راهنما توسط Theppitak Karoonboonyanan <theppitak@gmail.com> نوشته شده است.