.TH zzat 1 "2015-01-06" "zzat 0.15"
.SH "نام (NAME)"
zzat \- الحاق فایل‌ها با استفاده از دنباله‌های گوناگون دستورالعمل‌ها
.SH "خلاصه دستور (SYNOPSIS)"
\fBzzat\fR [\fB\-AbdeEntTv\fR] [\fB\-r\fR \fIloops\fR]
[\fB\-x\fR \fIsequence\fR] [\fIFILE\fR]...
.br
\fBzzat \-l\fR | \fB\-\-list\fR
.br
\fBzzat \-h\fR | \fB\-\-help\fR
.br
\fBzzat \-V\fR | \fB\-\-version\fR
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار \fBzzat\fR فایل‌ها را به صورت ترتیبی می‌خواند و آن‌ها را در خروجی
استاندارد می‌نویسد. کاربر می‌تواند تصمیم بگیرد که کدام دنباله از
فراخوانی‌های کتابخانه‌ای برای پیمایش و خواندن داده‌ها استفاده شود.

\fBzzat\fR در درجه اول به عنوان یک ابزار اشکال‌زدایی برای \fBzzuf\fR استفاده
می‌شود، زیرا می‌تواند روش‌های مختلف برنامه‌ها برای خواندن فایل‌ها را
شبیه‌سازی کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-A\fR, \fB\-\-show\-all\fR
معادل \fB\-vET\fR است.
.TP
\fB\-b\fR, \fB\-\-number\-nonblank\fR
شماره‌گذاری خطوط غیرخالی خروجی.
.TP
\fB\-d\fR, \fB\-\-debug\fR
نمایش اطلاعات اشکال‌زدایی در خروجی.
.TP
\fB\-e\fR
معادل \fB\-vET\fR است.
.TP
\fB\-E\fR, \fB\-\-show\-ends\fR
نمایش نماد $ در انتهای هر خط.
.TP
\fB\-n\fR, \fB\-\-number\fR
شماره‌گذاری همه خطوط خروجی.
.TP
\fB\-r\fR, \fB\-\-repeat\fR=\fIloops\fR
الحاق همه فایل‌ها به تعداد \fIloops\fR بار.
.TP
\fB\-t\fR
معادل \fB\-vT\fR است.
.TP
\fB\-T\fR, \fB\-\-show\-tabs\fR
نمایش نویسه‌های TAB به صورت ^I.
.TP
\fB\-v\fR, \fB\-\-show\-nonprinting\fR
استفاده از نمادگذاری ^ و M-، به جز برای LFD و TAB.
.TP
\fB\-x\fR, \fB\-\-execute\fR=\fIsequence\fR
خواندن یک فایل یا یک جریان با استفاده از دنباله دستورالعمل‌های مشخص‌شده در
\fIsequence\fR.

دستورالعمل‌ها به صورت ترتیبی تا انتهای برنامه اجرا می‌شوند.
پایان فایل شرط خروج نیست، مگر در مواردی که از کلیدواژه \fBfeof\fR استفاده
شده باشد:

\fB    fread(1,10); feof(1); fread(1,10)\fR

حلقه‌ها با استفاده از کلیدواژه \fBrepeat\fR مجاز هستند. مجدداً، \fBfeof\fR
می‌تواند برای خروج زودهنگام از یک حلقه استفاده شود:

\fB    repeat(10000, fgetc() feof(1))\fR

دستورالعمل‌ها می‌توانند با فاصله، ویرگول یا نقطه‌ویرگول از هم جدا شوند.
فهرستی از تمام دستورالعمل‌ها و کلیدواژه‌های کنترلی موجود را می‌توان با
استفاده از این دستور به دست آورد:

\fB    zzat \-l\fR

اگر هیچ دنباله‌ای مشخص نشود، دنباله پیش‌فرض زیر استفاده می‌شود:

\fB    repeat(\-1, fread(1,32768), feof(1))\fR

.TP
\fB\-l\fR, \fB\-\-list\fR
نمایش فهرست کلیدواژه‌ها و توابع پشتیبانی‌شده و خروج.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش یک پیام راهنمای کوتاه و خروج.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نگارش و خروج.
.SH "مثال‌ها (EXAMPLES)"
.PP
خواندن ۱۰۰۰ بایت نخست از f و سپس خروج:
.PP
\fB    zzat \-x \(aqfread(1,1000)\(aq f\fR
.PP
خواندن چهار بایت نخست از f با استفاده از چهار دستورالعمل متفاوت:
.PP
\fB    zzat \-x \(aqgetc(),fgetc(),getc_unlocked(),_IO_getc()\(aq f\fR
.PP
خواندن کامل f، با فراخوانی مکرر \fBgetc()\fR تا زمانی که به پایان فایل
برسد:
.PP
\fB    zzat \-x \(aqrepeat(\-1, getc(), feof(1))\(aq \fRf
.PP
خواندن کامل f در قطعات ۳۲۷۶۸ بایتی تا زمانی که به پایان فایل برسد:
.PP
\fB    zzat \-x \(aqrepeat(\-1, fread(1,32768), feof(1))\(aq \fRf
.\" .PP
.\" خواندن فقط بایت‌های فرد، بازگردانی فایل به ابتدا، سپس خواندن تمام بایت‌های زوج:
.\" .PP
.\" \fB    zzat \-x \(aqrepeat(\-1, getc(), feof(1), fseek(1,SEEK_CUR)),
.\" \fB              rewind(),
.\" \fB              repeat(\-1, fseek(1,SEEK_CUR), getc(), feof(1))\(aq
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBzzuf(3)\fR, \fBlibzzuf(3)\fR
.SH "نویسندگان (AUTHORS)"
.PP
حق نشر \(co 2002\-2015 متعلق به Sam Hocevar <sam@hocevar.net> است.
.PP
برنامه \fBzzat\fR و این صفحه راهنما، نرم‌افزار آزاد هستند. آن‌ها تا حد مجاز
طبق قوانین قابل اعمال، بدون هرگونه ضمانت ارائه می‌شوند. شما می‌توانید
آن‌ها را تحت شرایط مجوز Do What the Fuck You Want to Public License،
نگارش ۲، همان‌طور که توسط WTFPL Task Force منتشر شده است، بازتوزیع کنید
و/یا تغییر دهید. برای جزئیات بیشتر \fBhttp://www.wtfpl.net\fR را ببینید.
.PP
وبگاه \fBzzuf\fR در \fBhttp://caca.zoy.org/wiki/zzuf\fR در دسترس است.
نمای کلی معماری و سازوکارهای درونی در
\fBhttp://caca.zoy.org/wiki/zzuf/internals\fR قرار دارد.