'\" t
.TH "CARGO\-SEARCH" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-search \- جستجوی بسته‌ها در رجیستری. رجیستری پیش‌فرض crates.io است
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo search\fR [\fIoptions\fR] [\fIquery\fR\[u2026]]
.SH "توضیحات (DESCRIPTION)"
این دستور یک جستجوی متنی برای کریت‌ها (crates) در <https://crates.io>\& انجام می‌دهد. کریت‌های
منطبق به همراه توضیحاتشان در قالب TOML مناسب برای کپی کردن درون مانیفست
\fBCargo.toml\fR نمایش داده می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های جستجو (Search Options)"
.sp
\fB\-\-limit\fR \fIlimit\fR
.RS 4
محدود کردن تعداد نتایج (پیش‌فرض: 10، حداکثر: 100).
.RE
.sp
\fB\-\-index\fR \fIindex\fR
.RS 4
نشانی وب (URL) اندیس رجیستری مورد استفاده.
.RE
.sp
\fB\-\-registry\fR \fIregistry\fR
.RS 4
نام رجیستری مورد استفاده. نام‌های رجیستری در \fIفایل‌های پیکربندی Cargo\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& تعریف شده‌اند. در صورت عدم تعیین، از رجیستری پیش‌فرض استفاده می‌شود که توسط کلید پیکربندی \fBregistry.default\fR مشخص شده و به صورت پیش‌فرض \fBcrates\-io\fR است.
.RE
.SS "گزینه‌های نمایش (Display Options)"
.sp
\fB\-v\fR, 
\fB\-\-verbose\fR
.RS 4
استفاده از خروجی پرجزئیات. می‌تواند دو بار برای خروجی \[lq]بسیار پرجزئیات\[rq] مشخص شود که
شامل اطلاعات اضافی از قبیل هشدارهای وابستگی و خروجی اسکریپت ساخت است.
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.verbose\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& تعیین شود.
.RE
.sp
\fB\-q\fR, 
\fB\-\-quiet\fR
.RS 4
عدم چاپ پیام‌های لاگ cargo.
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.quiet\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& تعیین شود.
.RE
.sp
\fB\-\-color\fR \fIwhen\fR
.RS 4
کنترل زمان استفاده از خروجی رنگی. مقادیر معتبر:
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBauto\fR (پیش‌فرض): تشخیص خودکار در دسترس بودن پشتیبانی از رنگ در ترمینال.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBalways\fR: نمایش همیشگی رنگ‌ها.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBnever\fR: عدم نمایش رنگ‌ها در هیچ حالتی.
.RE
.sp
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.color\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& تعیین شود.
.RE
.SS "گزینه‌های عمومی (Common Options)"
.sp
\fB+\fR\fItoolchain\fR
.RS 4
اگر Cargo توسط rustup نصب شده باشد و اولین آرگومان \fBcargo\fR با \fB+\fR
آغاز شود، به عنوان نام زنجیره‌ابزار (toolchain) در rustup تفسیر می‌شود (مانند
\fB+stable\fR یا \fB+nightly\fR).
برای اطلاعات بیشتر درباره نحوه کارکرد رونویسی زنجیره‌ابزار، به \fIمستندات rustup\fR <https://rust\-lang.github.io/rustup/overrides.html>
مراجعه کنید.
.RE
.sp
\fB\-\-config\fR \fIKEY=VALUE\fR یا \fIPATH\fR
.RS 4
یک مقدار پیکربندی Cargo را رونویسی می‌کند. آرگومان باید در قالب نحو TOML به صورت \fBKEY=VALUE\fR
یا به عنوان مسیری به یک فایل پیکربندی اضافه ارائه شود. این پرچم می‌تواند چندین بار مشخص شود.
برای اطلاعات بیشتر به \fIبخش رونویسی‌های خط فرمان\fR <https://doc.rust\-lang.org/cargo/reference/config.html#command\-line\-overrides> مراجعه کنید.
.RE
.sp
\fB\-C\fR \fIPATH\fR
.RS 4
دایرکتوری کاری جاری را قبل از اجرای هرگونه عملیات تعیین‌شده تغییر می‌دهد. این گزینه بر
مواردی مانند محل جستجوی پیش‌فرض cargo برای مانیفست پروژه (\fBCargo.toml\fR)، و همچنین
دایرکتوری‌های جستجو شده برای کشف \fB\&.cargo/config.toml\fR تأثیر می‌گذارد. این گزینه باید
قبل از نام دستور قرار گیرد؛ به عنوان مثال: \fBcargo \-C path/to/my\-project build\fR\&.
.sp
این گزینه تنها در \fIکانال nightly\fR <https://doc.rust\-lang.org/book/appendix\-07\-nightly\-rust.html> در دسترس است و
برای فعال‌سازی به پرچم \fB\-Z unstable\-options\fR نیاز دارد (مشاهده کنید:
\fI#10098\fR <https://github.com/rust\-lang/cargo/issues/10098>).
.RE
.sp
\fB\-h\fR, 
\fB\-\-help\fR
.RS 4
اطلاعات راهنما را چاپ می‌کند.
.RE
.sp
\fB\-Z\fR \fIflag\fR
.RS 4
پرچم‌های ناپایدار (تنها در nightly) برای Cargo. برای جزئیات، دستور \fBcargo \-Z help\fR را اجرا کنید.
.RE
.SH "محیط (ENVIRONMENT)"
برای جزئیات درباره متغیرهای محیطی که Cargo می‌خواند، \fIمرجع\fR <https://doc.rust\-lang.org/cargo/reference/environment\-variables.html> را
مشاهده کنید.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB0\fR: عملیات Cargo با موفقیت به پایان رسید.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: اجرای Cargo با خطا مواجه شد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'جستجوی یک بسته از crates.io:
.sp
.RS 4
.nf
cargo search serde
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-install\fR(1), \fBcargo\-publish\fR(1)