'\" t
.\"     Title: amqp-consume
.\"    Author: The RabbitMQ Team <\m[blue]\fB<info@rabbitmq.com>\fR\m[]>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-15
.\"    Manual: RabbitMQ C Client
.\"    Source: RabbitMQ C Client
.\"  Language: Persian
.\"
.TH "AMQP\-CONSUME" "1" "2026\-06\-15" "RabbitMQ C Client" "RabbitMQ C Client"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
amqp-consume \- مصرف پیام‌ها از یک صف در کارساز AMQP
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBamqp\-consume\fR\ 'u
\fBamqp\-consume\fR [\fIOPTION\fR...] {\fIcommand\fR} [\fIargs\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBamqp\-consume\fR
پیام‌ها را از یک صف در کارساز AMQP دریافت و مصرف می‌کند\&. به ازای هر پیام دریافتی، یک دستور گیرنده اجرا می‌شود و بدنهٔ پیام از طریق ورودی استاندارد در اختیار آن قرار می‌گیرد\&.
.PP
دستور
\fBamqp\-consume\fR
می‌تواند پیام‌ها را از یک صف موجود مصرف کند، یا می‌تواند یک صف جدید ایجاد نماید\&. همچنین به صورت اختیاری می‌تواند صف را به یک exchange موجود متصل (bind) کند\&.
.PP
به طور پیش‌فرض، پیام‌ها با تایید دریافت صریح (explicit acknowledgements) مصرف می‌شوند\&. یک پیام تنها در صورتی تایید (acknowledge) می‌شود که دستور گیرنده با موفقیت خارج شود (یعنی با کد وضعیت خروج صفر)\&. حالت
\(lqno ack\(rq
در AMQP (که با نام حالت auto\-ack نیز شناخته می‌شود) می‌تواند با گزینهٔ
\fB\-A\fR
فعال شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-q\fR, \fB\-\-queue\fR=\fIqueue name\fR
.RS 4
نام صفی که قرار است پیام‌ها از آن دریافت و مصرف شوند\&.
.sp
اگر گزینهٔ
\fB\-\-queue\fR
حذف شود، کارساز AMQP یک نام یکتا به صف اختصاص می‌دهد و آن نام اختصاص‌یافته توسط کارساز در stderr نمایش داده خواهد شد؛ این حالت به این معنی است که باید یک صف اختصاصی (exclusive) اعلان شود\&.
.RE
.PP
\fB\-e\fR, \fB\-\-exchange\fR=\fIexchange name\fR
.RS 4
مشخص می‌کند که یک صف اختصاصی (exclusive) اعلان شود و به exchange داده‌شده متصل گردد\&. exchange مشخص‌شده باید از قبل وجود داشته باشد، مگر اینکه از گزینهٔ
\fB\-\-exchange\-type\fR
برای درخواست ایجاد یک exchange استفاده شود\&.
.RE
.PP
\fB\-r\fR, \fB\-\-routing\-key\fR=\fIrouting key\fR
.RS 4
کلید مسیریابی (routing key) برای اتصال (binding)\&. در صورت حذف، یک کلید مسیریابی خالی در نظر گرفته می‌شود\&.
.RE
.PP
\fB\-d\fR, \fB\-\-declare\fR
.RS 4
اعلان یک صف اختصاصی (exclusive) را اجباری می‌کند، حتی زمانی که در حالت عادی چنین نباشد\&. یعنی زمانی که نام صف با گزینهٔ
\fB\-\-queue\fR
مشخص شده است، اما هیچ اتصالی به exchange با گزینهٔ
\fB\-\-exchange\fR
درخواست نشده باشد\&. توجه: این گزینه منسوخ شده است و ممکن است در نسخه‌های بعدی حذف شود؛ از گزینهٔ
\fB\-\-exclusive\fR
برای اعلان صریح یک صف اختصاصی استفاده کنید\&.
.RE
.PP
\fB\-x\fR, \fB\-\-exclusive\fR
.RS 4
صف‌های اعلان‌شده به طور پیش‌فرض غیر اختصاصی هستند؛ این گزینه اعلان صف‌های اختصاصی (exclusive) را اجباری می‌کند\&.
.RE
.PP
\fB\-A\fR, \fB\-\-no\-ack\fR=\fIrouting key\fR
.RS 4
فعال‌سازی حالت
\(lqno ack\(rq:
کارساز AMQP بدون قید و شرط هر پیامی را که تحویل داده می‌شود تایید می‌کند، صرف‌نظر از اینکه دستور مقصد با موفقیت به پایان برسد یا خیر\&.
.RE
.PP
\fB\-c\fR, \fB\-\-count\fR=\fIlimit\fR
.RS 4
توقف مصرف پس از دریافت تعداد مشخص‌شده از پیام‌ها\&.
.RE
.PP
\fB\-p\fR, \fB\-\-prefetch\-count\fR=\fIlimit\fR
.RS 4
از کارساز درخواست می‌کند که در هر نوبت تنها
\fIlimit\fR
پیام ارسال کند\&.
.sp
اگر مقداری به
\fB\-\-count\fR
داده شده باشد، مقدار ارائه‌شده به
\fB\-\-prefetch\-count\fR
باید از آن کوچک‌تر باشد، در غیر این صورت نادیده گرفته خواهد شد\&.
.sp
در صورت استفاده از
\fB\-A\fR/\fB\-\-no\-ack\fR،
این گزینه هیچ تاثیری نخواهد داشت\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
مصرف پیام‌ها از یک صف موجود به نام \(lqmyqueue\(rq و نمایش بدنهٔ پیام‌ها در خروجی استاندارد از طریق \fBcat\fR:
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBamqp\-consume \-q myqueue cat\fR
.fi
.if n \{\
.RE
.\}
.RE
.PP
اتصال یک صف اختصاصی جدید به exchange با نام \(lqmyexch\(rq و ارسال بدنهٔ هر پیام به اسکریپت myscript به همراه تایید خودکار دریافت آن‌ها در کارساز:
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBamqp\-consume \-A \-e myexch \&./myscript\fR
.fi
.if n \{\
.RE
.\}
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBlibrabbitmq-tools\fR(7)
گزینه‌های مربوط به اتصال را که بین تمام ابزارهای RabbitMQ C Client مشترک است شرح می‌دهد\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBThe RabbitMQ Team <\fR\fB\m[blue]\fB<info@rabbitmq\&.com>\fR\m[]\fR\fB>\fR