.\"  Copyright (c) 1990-2009 Info-ZIP.  All rights reserved.
.\"
.\"  See the accompanying file LICENSE, version 2009-Jan-02 or later
.\"  (the contents of which are also included in unzip.h) for terms of use.
.\"  If, for some reason, all these files are missing, the Info-ZIP license
.\"  also may be found at:  ftp://ftp.info-zip.org/pub/infozip/license.html
.\"
.\" zipgrep.1 by Greg Roelofs.
.\"
.\" =========================================================================
.TH ZIPGREP 1L "20 April 2009" "Info-ZIP"
.SH "نام (NAME)"
zipgrep \- جستجوی خطوط منطبق با یک الگو در فایل‌های درون یک بایگانی ZIP
.PD
.SH "خلاصه دستور (SYNOPSIS)"
\fBzipgrep\fP [\fBegrep_options\fP] \fIpattern\fP
\fIfile\fP[\fI.zip\fP] [\fIfile(s)\fP\ .\|.\|.]
[\fB\-x\fP\ \fIxfile(s)\fP\ .\|.\|.]
.PD
.\" =========================================================================
.SH "توضیحات (DESCRIPTION)"
دستور
\fIzipgrep\fP
فایل‌های درون یک بایگانی ZIP را برای یافتن خطوط منطبق با رشته یا الگوی داده‌شده جستجو می‌کند.
\fIzipgrep\fP
یک اسکریپت شل است و برای کارکرد به
\fIegrep\fP(1)
و
\fIunzip\fP(1L)
نیاز دارد. خروجی آن کاملاً یکسان با خروجی
\fIegrep\fP(1)
است.
.PD
.\" =========================================================================
.SH "آرگومان‌ها (ARGUMENTS)"
.TP
.IP \fIpattern\fP
الگویی که باید در بایگانی ZIP پیدا شود. هر رشته یا عبارت باقاعده‌ای که توسط
\fIegrep\fP(1)
پذیرفته شود، می‌تواند استفاده شود.
.IR file [ .zip ]
مسیر بایگانی ZIP. (عبارات نویسه عام یا wildcard برای نام بایگانی ZIP پشتیبانی نمی‌شوند.) اگر نام دقیق فایل یافت نشود، پسوند
\fC.zip\fR
اضافه می‌شود. توجه داشته باشید که فایل‌های خوداستخراج‌گر ZIP نیز مانند هر بایگانی ZIP دیگری پشتیبانی می‌شوند؛ کافی است پسوند
\fC.exe\fR
(در صورت وجود) را صریحاً مشخص کنید.
.IP [\fIfile(s)\fP]
فهرست اختیاری از اعضای بایگانی برای پردازش که با فاصله از هم جدا شده‌اند. اگر هیچ فایل عضوی مشخص نشود، تمامی اعضای بایگانی ZIP جستجو می‌شوند. برای تطبیق چندین عضو می‌توان از عبارات باقاعده (نویسه‌های عام) استفاده کرد:
.RS
.IP *
با دنباله‌ای از ۰ یا چند نویسه تطبیق می‌یابد
.IP ?
دقیقاً با ۱ نویسه تطبیق می‌یابد
.IP [.\|.\|.]
با هر تک‌نویسه موجود در داخل براکت‌ها تطبیق می‌یابد؛ بازه‌ها با یک نویسه آغازین، خط تیره، و یک نویسه پایانی مشخص می‌شوند. اگر بلافاصله پس از براکت چپ یک علامت تعجب یا علامت توان («!» یا «^») بیاید، بازه نویسه‌های درون براکت‌ها متمم می‌شود (یعنی هر چیزی
\fIبه‌جز\fR
نویسه‌های درون براکت‌ها منطبق در نظر گرفته می‌شود).
.RE
.IP
(حتماً هر نویسه‌ای را که ممکن است در غیر این صورت توسط سیستم‌عامل تفسیر یا تغییر داده شود، درون گیومه قرار دهید.)
.IP [\fB\-x\fP\ \fIxfile(s)\fP]
فهرستی اختیاری از اعضای بایگانی که باید از پردازش مستثنی شوند. از آنجا که نویسه‌های عام با جداکننده‌های دایرکتوری («/») تطبیق می‌یابند، این گزینه می‌تواند برای مستثنی کردن فایل‌هایی که در زیردایرکتوری‌ها هستند به کار رود. برای مثال، دستور
«\fCzipgrep grumpy foo *.[ch] -x */*\fR»
رشته «grumpy» را در تمامی فایل‌های منبع C در دایرکتوری اصلی بایگانی «foo» جستجو می‌کند، اما در هیچ‌یک از زیردایرکتوری‌ها جستجو نخواهد کرد. بدون گزینه
\fB\-x\fP،
تمامی فایل‌های منبع C در همه دایرکتوری‌های درون فایل zip جستجو می‌شدند.
.\" =========================================================================
.SH "گزینه‌ها (OPTIONS)"
تمامی گزینه‌های قبل از نام فایل بایگانی ZIP به
\fIegrep\fP(1)
ارسال می‌شوند.
.PD
.\" =========================================================================
.SH "همچنین ببینید (SEE ALSO)"
\fIegrep\fP(1), \fIunzip\fP(1L), \fIzip\fP(1L), \fIfunzip\fP(1L),
\fIzipcloak\fP(1L), \fIzipinfo\fP(1L), \fIzipnote\fP(1L), \fIzipsplit\fP(1L)
.PD
.\" =========================================================================
.SH "نشانی‌های وب (URL)"
صفحه اصلی Info-ZIP در حال حاضر در نشانی زیر قرار دارد:
.EX
\fChttp://www.info-zip.org/pub/infozip\fR
.EE
یا
.EX
\fCftp://ftp.info-zip.org/pub/infozip\fR .
.EE
.PD
.\" =========================================================================
.SH "نویسندگان (AUTHORS)"
برنامه
\fIzipgrep\fP
توسط Jean-loup Gailly نوشته شده است.
.PD