.de EX
.nf
.ft CW
..
.de EE
.br
.fi
.ft 1
..
.de TF
.IP "" "\w'\fB\\$1\ \ \fP'u"
.PD 0
..
.TH NAWK 1
.CT 1 files prog_other
.SH "نام (NAME)"
nawk \- زبان پیمایش و پردازش متن مبتنی بر الگو
.SH "خلاصه دستور (SYNOPSIS)"
.B nawk
[
.BI \-F
.I fs
|
.B \-\^\-csv
]
[
.BI \-v
.I var=value
]
[
.I 'prog'
|
.BI \-f
.I progfile
]
[
.I file ...
]
.SH "توضیحات (DESCRIPTION)"
دستور
.I Nawk
هر
.I file
ورودی را برای یافتن خطوطی که با هر یک از مجموعه‌ای از الگوهای مشخص‌شده به صورت صریح در
.I prog
یا در یک یا چند فایل مشخص‌شده با
.B \-f
.I progfile
مطابقت داشته باشند، پیمایش می‌کند. همراه با هر الگو
می‌تواند یک عمل مرتبط وجود داشته باشد که با منطبق شدن خطی از یک
.I file
با الگو اجرا خواهد شد.
هر خط با بخش الگوی هر دستور الگو-عمل تطبیق داده می‌شود؛
عمل مرتبط برای هر الگوی منطبق اجرا می‌گردد.
نام فایل
.B \-
نشان‌دهنده ورودی استاندارد است.
هر
.I file
به فرم
.I var=value
به عنوان یک مقداردهی و انتساب در نظر گرفته می‌شود، نه یک نام فایل،
و در همان زمانی اجرا می‌شود که اگر نام فایل بود باز می‌شد.
گزینه
.B \-v
همراه با
.I var=value
انتسابی است که پیش از اجرای
.I prog
انجام می‌شود؛
هر تعداد از گزینه‌های
.B \-v
می‌توانند مشخص شوند.
گزینه
.B \-F
.I fs
جداکننده فیلدهای ورودی را به عبارت باقاعده
.IR fs
تعیین می‌کند.
گزینه
.B \-\^\-csv
باعث می‌شود که
.I awk
رکوردها را با استفاده از قالب استاندارد مقادیر جداشده با کاما (CSV) پردازش کند.
.PP
یک خط ورودی معمولاً از فیلدهایی تشکیل شده است که با فاصله یا با عبارت باقاعده
.BR FS
از یکدیگر جدا شده‌اند. این فیلدها با
.BR $1 ،
.BR $2 ،
\&... نشان داده می‌شوند، در حالی که
.B $0
به کل خط اشاره دارد.
اگر
.BR FS
تهی باشد، خط ورودی به ازای هر نویسه به یک فیلد تفکیک می‌شود.
.PP
یک دستور الگو-عمل دارای فرم زیر است:
.IP
.IB pattern " { " action " }
.PP
نبود
.BI { " action " }
به معنای چاپ خط است؛
نبود الگو همیشه منطبق در نظر گرفته می‌شود.
دستورهای الگو-عمل با خط جدید یا نقطه-ویرگول از هم جدا می‌شوند.
.PP
یک عمل، توالی‌ای از گزاره‌ها است.
یک گزاره می‌تواند یکی از موارد زیر باشد:
.PP
.EX
.ta \w'\f(CWdelete array[expression]\fR'u
.RS
.nf
.ft CW
if(\fI expression \fP)\fI statement \fP\fR[ \fPelse\fI statement \fP\fR]\fP
while(\fI expression \fP)\fI statement\fP
for(\fI expression \fP;\fI expression \fP;\fI expression \fP)\fI statement\fP
for(\fI var \fPin\fI array \fP)\fI statement\fP
do\fI statement \fPwhile(\fI expression \fP)
break
continue
{\fR [\fP\fI statement ... \fP\fR] \fP}
\fIexpression\fP	#\fR معمولاً\fP\fI var = expression\fP
print\fR [ \fP\fIexpression-list \fP\fR] \fP\fR[ \fP>\fI expression \fP\fR]\fP
printf\fI format \fP\fR[ \fP,\fI expression-list \fP\fR] \fP\fR[ \fP>\fI expression \fP\fR]\fP
return\fR [ \fP\fIexpression \fP\fR]\fP
next	#\fR نادیده گرفتن الگوهای باقی‌مانده روی این خط ورودی\fP
nextfile	#\fR نادیده گرفتن ادامه این فایل و رفتن به فایل بعدی از ابتدا\fP
delete\fI array\fP[\fI expression \fP]	#\fR حذف یک عنصر آرایه\fP
delete\fI array\fP	#\fR حذف تمامی عناصر آرایه\fP
exit\fR [ \fP\fIexpression \fP\fR]\fP	#\fR خروج فوری؛ وضعیت خروج \fP\fIexpression\fP است
.fi
.RE
.EE
.DT
.PP
گزاره‌ها با نقطه-ویرگول، خط جدید یا آکوالاد بسته خاتمه می‌یابند.
یک
.I expression-list
خالی نشان‌دهنده
.BR $0
است.
ثابت‌های رشته‌ای درون \&\f(CW"\ "\fR قرار می‌گیرند،
و نویسه‌های گریز رایج در C در آن‌ها شناسایی می‌شوند.
عبارات بسته به کاربرد، مقادیر رشته‌ای یا عددی به خود می‌گیرند،
و با استفاده از عملگرهای
.B + \- * / % ^
(به‌توان‌رسانی) و الحاق (مشخص‌شده با فاصله) ساخته می‌شوند.
عملگرهای
.B
! ++ \-\- += \-= *= /= %= ^= > >= < <= == != ?:
نیز در عبارات در دسترس هستند.
متغیرها می‌توانند مقادیر عددی یا رشته‌ای ساده، عناصر آرایه
(نشان‌داده‌شده با
.IB x  [ i ] \fR)
یا فیلدها باشند.
متغیرها با رشته تهی مقداردهی اولیه می‌شوند.
اندیس‌های آرایه می‌توانند هر رشته‌ای باشند و لزوماً عددی نیستند؛
این قابلیت امکان ایجاد نوعی حافظه انتسابی (آرایه انجمنی) را فراهم می‌آورد.
اندیس‌های چندگانه مانند
.B [i,j,k]
مجاز هستند؛ اجزای آن‌ها به هم متصل شده و با مقدار
.BR SUBSEP
از هم جدا می‌شوند.
.PP
گزاره
.B print
آرگومان‌های خود را در خروجی استاندارد چاپ می‌کند
(یا در یک فایل در صورتی که
.BI > " file
یا
.BI >> " file
حضور داشته باشد، یا روی یک پایپ اگر
.BI | " cmd
مشخص شده باشد)، که با جداکننده فیلد خروجی فعلی از هم جدا شده
و با جداکننده رکورد خروجی خاتمه می‌یابند.
.I file
و
.I cmd
می‌توانند نام‌های صریح یا عبارات داخل پرانتز باشند؛
مقادیر رشته‌ای یکسان در گزاره‌های مختلف نشان‌دهنده همان فایل بازشده یکسان هستند.
گزاره
.B printf
فهرست عبارات خود را مطابق با
.I format
قالب‌بندی می‌کند (به
.IR printf (3)
مراجعه کنید).
تابع توکار
.BI close( expr )
فایل یا پایپ
.IR expr
را می‌بندد.
تابع توکار
.BI fflush( expr )
هرگونه خروجی بافرشده را برای فایل یا پایپ
.IR expr
تخلیه می‌کند.
.PP
توابع ریاضی
.BR atan2 ،
.BR cos ،
.BR exp ،
.BR log ،
.BR sin
و
.B sqrt
به صورت توکار در دسترس هستند.
سایر توابع توکار:
.TF "\fBlength(\fR[\fIv\^\fR]\fB)\fR"
.TP
\fBlength(\fR[\fIv\^\fR]\fB)\fR
طول آرگومان آن به صورت یک رشته،
تعداد عناصر موجود در آرایه در صورت ارائه یک آرگومان آرایه‌ای،
یا در صورت عدم ارائه آرگومان، طول
.B $0 .
.TP
.B rand()
یک عدد تصادفی در بازه [0,1).
.TP
\fBsrand(\fR[\fIs\^\fR]\fB)\fR
تنظیم دانه برای
.B rand
و بازگرداندن دانه قبلی.
.TP
.BI int( x\^ )
کوتاه کردن به یک مقدار صحیح.
.TP
\fBsubstr(\fIs\fB, \fIm\fR [\fB, \fIn\^\fR]\fB)\fR
زیررشته
.IR n -نویسه‌ای
از
.I s
که از موقعیت
.I m
(با شروع از ۱) آغاز می‌شود.
در صورت عدم مشخص شدن
.IR n ،
از باقیمانده رشته استفاده می‌شود.
.TP
.BI index( s , " t" )
موقعیت وقوع رشته
.I t
در
.I s ،
یا 0 در صورت عدم وقوع.
.TP
.BI match( s , " r" )
موقعیت وقوع عبارت باقاعده
.I r
در
.I s ،
یا 0 در صورت عدم وقوع.
متغیرهای
.B RSTART
و
.B RLENGTH
روی موقعیت و طول رشته منطبق‌شده تنظیم می‌شوند.
.TP
\fBsplit(\fIs\fB, \fIa \fR[\fB, \fIfs\^\fR]\fB)\fR
رشته
.I s
را به عناصر آرایه
.IB a [1] \fR،
.IB a [2] \fR،
\&...،
.IB a [ n ] \fR
تقسیم می‌کند و مقدار
.IR n
را برمی‌گرداند.
جداسازی با عبارت باقاعده
.I fs
یا با جداکننده فیلد
.B FS
(در صورتی که
.I fs
داده نشده باشد) انجام می‌گیرد.
یک رشته خالی به عنوان جداکننده فیلد، رشته را به ازای هر نویسه به یک عنصر آرایه تقسیم می‌کند.
.TP
\fBsub(\fIr\fB, \fIt \fR[, \fIs\^\fR]\fB)
رشته
.I t
را جایگزین اولین رخداد عبارت باقاعده
.I r
در رشته
.IR s
می‌کند.
اگر
.I s
داده نشود، از
.B $0
استفاده خواهد شد.
.TP
\fBgsub(\fIr\fB, \fIt \fR[, \fIs\^\fR]\fB)
مشابه با
.B sub
است، با این تفاوت که تمام رخدادهای عبارت باقاعده جایگزین می‌شوند؛
.B sub
و
.B gsub
تعداد جایگزینی‌های انجام‌شده را برمی‌گردانند.
.TP
.BI sprintf( fmt , " expr" , " ...\fB)
رشته حاصل از قالب‌بندی
.I expr ...
مطابق با قالب
.IR fmt
در
.IR printf (3).
.TP
.BI system( cmd )
دستور
.I cmd
را اجرا کرده و وضعیت خروج آن را برمی‌گرداند. این مقدار در صورت بروز خطا \-1 خواهد بود،
در صورت خروج عادی وضعیت خروج
.IR cmd ،
در صورت بسته شدن با سیگنال مقدار 256 +
.I sig
(که در آن
.I sig
شماره سیگنال کشنده است)،
یا 512 +
.I sig
در صورت ایجاد core dump.
.TP
.BI tolower( str )
یک رونوشت از
.I str
را برمی‌گرداند که تمام نویسه‌های بزرگ آن به معادل‌های کوچک مربوطه‌شان تبدیل شده‌اند.
.TP
.BI toupper( str )
یک رونوشت از
.I str
را برمی‌گرداند که تمام نویسه‌های کوچک آن به معادل‌های بزرگ مربوطه‌شان تبدیل شده‌اند.
.PD
.PP
«تابع»
.B getline
مقدار
.B $0
را روی رکورد ورودی بعدی از فایل ورودی جاری قرار می‌دهد؛
.B getline
.BI < " file
مقدار
.B $0
را روی رکورد بعدی از
.IR file
قرار می‌دهد.
.B getline
.I x
به جای آن، متغیر
.I x
را مقداردهی می‌کند.
در نهایت،
.IB cmd " | getline
خروجی
.I cmd
را به
.BR getline
هدایت می‌کند؛
هر فراخوانی
.B getline
خط بعدی خروجی از
.IR cmd
را برمی‌گرداند.
در همه موارد،
.B getline
در صورت ورودی موفقیت‌آمیز مقدار 1، برای پایان فایل مقدار 0، و در صورت بروز خطا مقدار \-1 را برمی‌گرداند.
.PP
الگوها ترکیبات بولی اختیاری
(با
.BR "! || &&" )
از عبارات باقاعده و
عبارات رابطه‌ای هستند.
عبارات باقاعده مانند
.IR egrep
هستند؛
به
.IR grep (1)
مراجعه کنید.
عبارات باقاعده منفرد در یک الگو برای کل خط اعمال می‌شوند.
عبارات باقاعده می‌توانند در عبارات رابطه‌ای نیز حضور داشته باشند، با استفاده از عملگرهای
.B ~
و
.BR !~ .
عبارت
.BI / re /
یک عبارت باقاعده ثابت است؛
هر رشته‌ای (ثابت یا متغیر) می‌تواند به عنوان یک عبارت باقاعده استفاده شود، به جز در جایگاه یک عبارت باقاعده منفرد در یک الگو.
.PP
یک الگو می‌تواند شامل دو الگو باشد که با کاما از هم جدا شده‌اند؛
در این حالت، عمل برای تمام خطوط از زمان وقوع الگوی اول تا وقوع الگوی دوم (شامل هر دو) انجام می‌شود.
.PP
یک عبارت رابطه‌ای یکی از موارد زیر است:
.IP
.I expression matchop regular-expression
.br
.I expression relop expression
.br
.IB expression " in " array-name
.br
.BI ( expr ,\| expr ,\| ... ") in " array-name
.PP
که در آن
.I relop
هر یک از شش عملگر رابطه‌ای در C است،
و
.I matchop
یا
.B ~
(منطبق است)
یا
.B !~
(منطبق نیست)
است. یک گزاره شرطی یک عبارت حسابی، یک عبارت رابطه‌ای،
یا یک ترکیب بولی
از این‌ها است.
.PP
الگوهای ویژه
.B BEGIN
و
.B END
می‌توانند برای در دست گرفتن کنترل پیش از خواندن اولین خط ورودی
و پس از آخرین خط استفاده شوند.
.B BEGIN
و
.B END
با دیگر الگوها ترکیب نمی‌شوند.
آن‌ها می‌توانند چندین بار در یک برنامه ظاهر شوند و به همان ترتیبی که توسط
.I nawk
خوانده می‌شوند، اجرا گردند.
.PP
نام‌های متغیر با معانی خاص:
.TF FILENAME
.TP
.B ARGC
تعداد آرگومان‌ها، قابل انتساب.
.TP
.B ARGV
آرایه آرگومان‌ها، قابل انتساب؛
اعضای غیرتهی به عنوان نام فایل‌ها در نظر گرفته می‌شوند.
.TP
.B CONVFMT
قالب تبدیل مورد استفاده هنگام تبدیل اعداد
(پیش‌فرض
.BR "%.6g" ).
.TP
.B ENVIRON
آرایه متغیرهای محیطی؛ اندیس‌ها نام متغیرها هستند.
.TP
.B FILENAME
نام فایل ورودی فعلی.
.TP
.B FNR
شماره ترتیبی رکورد جاری در فایل فعلی.
.TP
.B FS
عبارت باقاعده مورد استفاده برای جداسازی فیلدها؛ همچنین با گزینه
.BI \-F fs\fR
قابل تنظیم است.
.TP
.BR NF
تعداد فیلدها در رکورد جاری.
.TP
.B NR
شماره ترتیبی رکورد جاری.
.TP
.B OFMT
قالب خروجی برای اعداد (پیش‌فرض
.BR "%.6g" ).
.TP
.B OFS
جداکننده فیلد خروجی (پیش‌فرض فاصله).
.TP
.B ORS
جداکننده رکورد خروجی (پیش‌فرض خط جدید).
.TP
.B RLENGTH
طول رشته منطبق‌شده توسط
.BR match .
.TP
.B RS
جداکننده رکورد ورودی (پیش‌فرض خط جدید).
در صورت خالی بودن، خطوط خالی رکوردها را از هم جدا می‌کنند.
اگر طول آن بیش از یک نویسه باشد،
.B RS
به عنوان یک عبارت باقاعده در نظر گرفته می‌شود و رکوردها
با متنی که با این عبارت تطبیق یابد جدا می‌شوند.
.TP
.B RSTART
موقعیت شروع رشته تطبیق‌یافته توسط
.BR match .
.TP
.B SUBSEP
جداکننده اندیس‌های چندگانه (پیش‌فرض 034).
.PD
.PP
توابع را می‌توان (در جایگاه دستور الگو-عمل) به این شکل تعریف کرد:
.IP
.B
function foo(a, b, c) { ... }
.PP
پارامترها در صورتی که اسکالر باشند با مقدار (by value) و در صورتی که نام آرایه باشند با ارجاع (by reference) ارسال می‌شوند؛
توابع می‌توانند به صورت بازگشتی فراخوانی شوند.
پارامترها برای تابع محلی هستند؛ تمام متغیرهای دیگر سراسری می‌باشند.
بنابراین می‌توان متغیرهای محلی را با تعیین پارامترهای اضافی در تعریف تابع ایجاد کرد.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
اگر
.B POSIXLY_CORRECT
در محیط تنظیم شده باشد،
.I awk
از قوانین POSIX برای
.B sub
و
.B gsub
با توجه به بک‌اسلش‌ها و علامت‌های آمپرسند پیاپی پیروی می‌کند.
.SH "مثال‌ها (EXAMPLES)"
.TP
.EX
length($0) > 72
.EE
چاپ خطوط طولانی‌تر از ۷۲ نویسه.
.TP
.EX
{ print $2, $1 }
.EE
چاپ دو فیلد اول با ترتیب معکوس.
.PP
.EX
BEGIN { FS = ",[ \et]*|[ \et]+" }
      { print $2, $1 }
.EE
.ns
.IP
مشابه مثال قبل، با فیلدهای ورودی که با کاما و/یا فاصله و تب جدا شده‌اند.
.PP
.EX
.nf
	{ s += $1 }
END	{ print "sum is", s, " average is", s/NR }
.fi
.EE
.ns
.IP
جمع زدن مقادیر ستون اول، و چاپ مجموع و میانگین.
.TP
.EX
/start/, /stop/
.EE
چاپ تمامی خطوط بین جفت‌های start/stop.
.PP
.EX
.nf
BEGIN	{	# Simulate echo(1)
	for (i = 1; i < ARGC; i++) printf "%s ", ARGV[i]
	printf "\en"
	exit }
.fi
.EE
.SH "همچنین ببینید (SEE ALSO)"
.IR grep (1),
.IR lex (1),
.IR sed (1)
.br
A. V. Aho, B. W. Kernighan, P. J. Weinberger,
.IR "The AWK Programming Language, Second Edition" ,
Addison-Wesley, 2024.  ISBN 978-0-13-826972-2, 0-13-826972-6.
.SH "اشکالات (BUGS)"
هیچ تبدیل صریحی بین اعداد و رشته‌ها وجود ندارد.
برای وادار کردن رفتار با یک عبارت به عنوان عدد، مقدار 0 را به آن اضافه کنید؛
برای وادار کردن رفتار با آن به عنوان یک رشته،
\&\f(CW""\fP
را با آن الحاق نمایید.
.PP
قوانین محدوده دسترسی (scope) برای متغیرها در توابع دارای اشکال است؛
نحو نوشتاری آن نیز حتی بدتر است.
.PP
انتظار می‌رود ورودی دارای کدگذاری UTF-8 باشد. سایر مجموعه‌نویسه‌های
چندبایتی پشتیبانی نمی‌شوند.
با این حال، در لوکال‌های هشت بیتی،
.I awk
با هر بایت ورودی به عنوان یک نویسه جداگانه رفتار می‌کند.
.SH "مقادیر ممیز شناور نامتعارف (UNUSUAL FLOATING-POINT VALUES)"
دستور
.I Awk
پیش از آنکه محاسبات IEEE 754 مقادیر Not-A-Number (NaN)
و بی‌نهایت (Infinity) را تعریف کند طراحی شد؛ مقادیری که توسط تمام سخت‌افزارهای
ممیز شناور مدرن پشتیبانی می‌شوند.
.PP
به دلیل اینکه
.I awk
از توابع
.IR strtod (3)
و
.IR atof (3)
برای تبدیل مقادیر رشته‌ای به مقادیر ممیز شناور با دقت مضاعف استفاده می‌کند،
کتابخانه‌های مدرن C نیز رشته‌هایی را که با
.B inf
و
.B nan
شروع می‌شوند، به ترتیب به مقادیر بی‌نهایت و NaN تبدیل می‌کنند. این امر منجر به نتایج عجیبی می‌شد،
مانند این مورد:
.PP
.EX
.nf
echo nancy | awk '{ print $1 + 0 }'
.fi
.EE
.PP
که به جای صفر، مقدار
.B nan
را چاپ می‌کرد.
.PP
اکنون
.I Awk
از GNU AWK پیروی می‌کند و پیش از تلاش برای تبدیل رشته‌ها به اعداد،
مقادیر رشته‌ای را به صورت زیر پیش‌فیلتر می‌کند:
.TP
.I "مقادیر هگزادسیمال"
مقادیر هگزادسیمال (که از استاندارد C99 مجاز شده‌اند)، همان‌طور که پیش
از C99 بود به صفر تبدیل می‌شوند.
.TP
.I "مقادیر NaN"
دو رشته
.B +nan
و
.B \-nan
(بدون حساسیت به حروف کوچک و بزرگ) به NaN تبدیل می‌شوند؛ هیچ رشته دیگری این‌گونه نیست.
(NaNها می‌توانند علامت داشته باشند.)
.TP
.I "مقادیر بی‌نهایت"
دو رشته
.B +inf
و
.B \-inf
(بدون حساسیت به حروف کوچک و بزرگ) به ترتیب به بی‌نهایت مثبت و منفی تبدیل می‌شوند.
هیچ رشته دیگری این‌گونه نیست.