أدلة سطر الأوامر¶

وفقًا لمعيار POSIX، يجب أن تكون الملفات المسماة في سطر أوامر awk ملفات نصية. السلوك يكون "غير محدد" إذا لم تكن كذلك. تعامل معظم إصدارات awk وجود دليل في سطر الأوامر كخطأ فادح.

بالنسبة لـ gawk، ينتج عن وجود دليل في سطر الأوامر تحذير، ولكن يتم تخطيه بخلاف ذلك. إذا أُعطي أي من الخيارين --posix أو --traditional، فإن gawk يعود لمعاملة الأدلة في سطر الأوامر كخطأ فادح.

السجلات¶

عادةً ما تُفصل السجلات بمحارف سطر جديد. يمكنك التحكم في كيفية فصل السجلات عن طريق تعيين قيم للمتغير المدمج RS. راجع https://www.gnu.org/software/gawk/manual/html_node/Records.html للمزيد من التفاصيل.

الحقول¶

عند قراءة كل سجل دخل، يقسم gawk السجل إلى حقول، باستخدام قيمة المتغير FS كفاصل للحقول. بالإضافة إلى ذلك، يمكن استخدام FIELDWIDTHS و FPAT للتحكم في تقسيم حقول الدخل. راجع التفاصيل، بدءًا من https://www.gnu.org/software/gawk/manual/html_node/Fields.html.

يمكن الإشارة إلى كل حقل في سجل الدخل من خلال موضعه: $1، و $2، وهكذا. $0 هو السجل بأكمله، بما في ذلك المساحات البيضاء البادئة واللاحقة.

يُضبط المتغير NF على العدد الإجمالي للحقول في سجل الدخل.

تنتج الإشارات إلى حقول غير موجودة (أي الحقول بعد $NF) السلسلة الصفرية (null). ومع ذلك، فإن التعيين لحقل غير موجود (مثلاً $(NF+2) = 5) يزيد من قيمة NF، وينشئ أي حقول متدخلة بقيمة السلسلة الصفرية، ويؤدي إلى إعادة حساب قيمة $0، مع فصل الحقول بقيمة OFS. تسبب الإشارات إلى حقول مرقمة بالسالب خطأً فادحًا. يؤدي تقليل NF إلى فقدان قيم الحقول التي تتجاوز القيمة الجديدة، وإعادة حساب قيمة $0، مع فصل الحقول بقيمة OFS.

يؤدي تعيين قيمة لحقل موجود إلى إعادة بناء السجل بالكامل عند الإشارة إلى $0. وبالمثل، يؤدي تعيين قيمة لـ $0 إلى إعادة تقسيم السجل، مما يؤدي إلى إنشاء قيم جديدة للحقول.

قيم مفصولة بفواصل (CSV)¶

عند استدعائه باستخدام الخيار -k أو --csv، لا يستخدم gawk تحديد السجلات المنتظم وتقسيم الحقول كما هو موضح أعلاه. بدلًا من ذلك، تُنهى السجلات بأسطر جديدة غير مقتبسة، وتُفصل الحقول بفاصلات. يمكن استخدام علامات الاقتباس المزدوجة لإحاطة الحقول التي تحتوي على فواصل، أو أسطر جديدة، أو علامات اقتباس مزدوجة مضاعفة. راجع https://www.gnu.org/software/gawk/manual/html_node/Comma-Separated-Fields.html لمزيد من التفاصيل.

المتغيرات المدمجة¶

متغيرات Gawk المدمجة مدرجة أدناه. هذه القائمة موجزة عمدًا. للتفاصيل، راجع https://www.gnu.org/software/gawk/manual/html_node/Built_002din-Variables.

ARGC

عدد معاملات سطر الأوامر.

ARGIND

الفهرس في ARGV للملف الحالي الذي تتم معالجته.

ARGV

مصفوفة معاملات سطر الأوامر. المصفوفة مفهرسة من 0 إلى ARGC - 1.

BINMODE

في الأنظمة غير المتوافقة مع POSIX، يحدد استخدام الوضع "الثنائي" لجميع عمليات الإدخال والإخراج للملفات. راجع https://www.gnu.org/software/gawk/manual/html_node/PC-Using.html للمزيد من التفاصيل.

CONVFMT

تنسيق التحويل للأرقام، "%.6g" مبدئيًا.

ENVIRON

مصفوفة تحتوي على قيم البيئة الحالية. المصفوفة مفهرسة بواسطة متغيرات البيئة، وكل عنصر هو قيمة ذلك المتغير.

ERRNO

إذا حدث خطأ في النظام سواء أثناء إجراء إعادة توجيه لـ getline، أو أثناء القراءة لـ getline، أو أثناء close()، فسيُضبط ERRNO على سلسلة نصية تصف الخطأ. القيمة قابلة للترجمة في المناطق المحلية غير الإنجليزية.

FIELDWIDTHS

قائمة بعروض الحقول تفصل بينها مسافات بيضاء. عند ضبطها، يحلل gawk الدخل إلى حقول ذات عرض ثابت، بدلًا من استخدام قيمة المتغير FS كفاصل للحقول. قد يُسبق كل عرض حقل اختيارياً بقيمة مفصولة بنقطتين تحدد عدد المحارف المطلوب تخطيها قبل بدء الحقل.

FILENAME

اسم ملف الدخل الحالي. إذا لم تُحدد أي ملفات في سطر الأوامر، تكون قيمة FILENAME هي "-". ومع ذلك، FILENAME غير معرف داخل قاعدة BEGIN (ما لم يُضبط بواسطة getline).

FNR

رقم سجل الدخل في ملف الدخل الحالي.

FPAT

تعبير نمطي يصف محتويات الحقول في سجل ما. عند ضبطه، يحلل gawk الدخل إلى حقول، حيث تطابق الحقول التعبير النمطي، بدلًا من استخدام قيمة FS كفاصل للحقول.

FS

فاصل حقول الدخل، وهو مسافة مبدئيًا. راجع https://www.gnu.org/software/gawk/manual/html_node/Field-Separators.html للمزيد من التفاصيل.

FUNCTAB

مصفوفة فهارسها والقيم المقابلة لها هي أسماء جميع الدوال المعرفة من قبل المستخدم أو دوال الامتداد في البرنامج. ملاحظة: لا يجوز لك استخدام جملة delete مع مصفوفة FUNCTAB.

IGNORECASE

يتحكم في حساسية حالة الأحرف لجميع عمليات التعبيرات النمطية وسلاسل النصوص. راجع https://www.gnu.org/software/gawk/manual/html_node/Case_002dsensitivity.html للمزيد من التفاصيل.

LINT

يوفر تحكمًا ديناميكيًا في خيار --lint من داخل برنامج AWK.

NF

عدد الحقول في سجل الدخل الحالي.

NR

العدد الإجمالي لسجلات الدخل التي شوهدت حتى الآن.

OFMT

تنسيق الإخراج للأرقام، "%.6g" مبدئيًا.

OFS

فاصل حقول الإخراج، وهو مسافة مبدئيًا.

ORS

فاصل سجلات الإخراج، وهو سطر جديد مبدئيًا.

PREC

دقة العمل للأرقام ذات الفاصلة العائمة عشوائية الدقة، وهي 53 مبدئيًا.

PROCINFO

توفر عناصر هذه المصفوفة إمكانية الوصول إلى معلومات حول برنامج AWK قيد التشغيل. راجع https://www.gnu.org/software/gawk/manual/html_node/Auto_002dset للمزيد من التفاصيل.

ROUNDMODE

وضع التقريب المراد استخدامه للحساب عشوائي الدقة على الأرقام، مبدئيًا "N" (IEEE-754 وضع roundTiesToEven). راجع https://www.gnu.org/software/gawk/manual/html_node/Setting-the-rounding-mode للمزيد من التفاصيل.

RS

فاصل سجلات الدخل، وهو سطر جديد مبدئيًا.

RT

خاتمة السجل. يضبط Gawk قيمة RT على نص الدخل الذي طابق المحرف أو التعبير النمطي المحدد بواسطة RS.

RSTART

فهرس المحرف الأول الذي طابقته match()؛ 0 إذا لم يوجد تطابق.

RLENGTH

طول السلسلة التي طابقتها match()؛ -1 إذا لم يوجد تطابق.

SUBSEP

السلسلة المستخدمة لفصل العناصر الفرعية المتعددة في عناصر المصفوفة، مبدئيًا "\034".

SYMTAB

مصفوفة فهارسها هي أسماء جميع المتغيرات والمصفوفات العامة المعرفة حاليًا في البرنامج. لا يجوز لك استخدام جملة delete مع مصفوفة SYMTAB، ولا التعيين لعناصر بفهرس ليس اسم متغير.

TEXTDOMAIN

نطاق نص برنامج AWK؛ يُستخدم للعثور على الترجمات المحلية لسلاسل نصوص البرنامج.

المصفوفات¶

تُفهرس المصفوفات بتعبير بين أقواس مربعة ([ و ]). إذا كان التعبير عبارة عن قائمة تعبيرات (تعبير، تعبير ...) فإن فهرس المصفوفة هو سلسلة نصية تتكون من دمج قيمة (السلسلة) لكل تعبير، مفصولة بقيمة متغير SUBSEP. تُستخدم هذه الإمكانية لمحاكاة المصفوفات متعددة الأبعاد. على سبيل المثال:

يعين السلسلة "hello, world\n" لعنصر المصفوفة x المفهرس بالسلسلة "A\034B\034C". جميع المصفوفات في AWK ترابطية، أي أنها مفهرسة بقيم سلاسل نصية.

يمكن استخدام العامل الخاص in لاختبار ما إذا كانت المصفوفة تحتوي على فهرس يتكون من قيمة معينة:

if (val in array) 	print array[val]

إذا كانت المصفوفة تحتوي على فهارس متعددة، فاستخدم (i, j) in array.

يمكن استخدام بنية in أيضًا في حلقة for للتكرار على جميع عناصر المصفوفة. ومع ذلك، فإن بنية (i, j) in array لا تعمل إلا في الاختبارات، وليس في حلقات for.

يمكن حذف عنصر من مصفوفة باستخدام عبارة delete. كما يمكن استخدام عبارة delete لحذف كامل محتويات المصفوفة، وذلك بمجرد تحديد اسم المصفوفة دون دليل سفلي.

يدعم gawk المصفوفات حقيقية التعدد في الأبعاد. ولا يشترط أن تكون هذه المصفوفات «مستطيلة» كما هو الحال في C أو ++C. راجع https://www.gnu.org/software/gawk/manual/html_node/Arrays لمزيد من التفاصيل.

فضاءات الأسماء¶

يوفر Gawk خاصية فضاء أسماء بسيطة للمساعدة في الالتفاف على حقيقة أن جميع المتغيرات في AWK هي متغيرات عامة.

يتكون الاسم المؤهل من معرفين بسيطين يربط بينهما نقطتان مزدوجتان (::). يمثل المعرف الأيسر فضاء الأسماء، ويمثل المعرف الأيمن المتغير بداخله. تعتبر جميع الأسماء البسيطة (غير المؤهلة) في فضاء الأسماء «الحالي»؛ وفضاء الأسماء المبدئي هو awk. ومع ذلك، فإن المعرفات البسيطة التي تتكون حصراً من أحرف كبيرة تُجبر على الدخول في فضاء أسماء awk، حتى لو كان فضاء الأسماء الحالي مختلفاً.

يمكنك تغيير فضاء الأسماء الحالي باستخدام توجيه @namespace "الاسم".

لا يجوز استخدام أسماء الدوال المدمجة القياسية والمعرفة مسبقاً كأسماء لفضاءات الأسماء. ويمكن استخدام أسماء الدوال الإضافية التي يوفرها gawk كأسماء لفضاءات أسماء أو كمعرفات بسيطة في فضاءات أسماء أخرى. لمزيد من التفاصيل، راجع https://www.gnu.org/software/gawk/manual/html_node/Namespaces.html#Namespaces.

تنميط المتغيرات وتحويلها¶

قد تكون المتغيرات والحقول أرقاماً (بفاصلة عائمة)، أو سلاسل نصية، أو كليهما. وقد تكون أيضاً تعبيرات نمطية. ويعتمد تفسير قيمة المتغير على سياقه. فإذا استخدم في تعبير عددي، عومل كعدد؛ وإذا استخدم كسلسلة نصية عومل كسلسلة نصية.

لإجبار متغير على أن يُعامل كعدد، أضف صفراً إليه؛ ولإجباره على أن يُعامل كسلسلة نصية، ادمجه مع السلسلة الفارغة.

المتغيرات غير المهيأة لها القيمة العددية صفر وقيمة السلسلة النصية "" (السلسلة الصففرية أو الفارغة).

عندما يجب تحويل سلسلة نصية إلى عدد، يُنجز التحويل باستخدام strtod(3). ويُحول العدد إلى سلسلة نصية باستخدام قيمة CONVFMT كسلسلة تنسيق لـ sprintf(3)، مع استخدام القيمة العددية للمتغير كمعامل. ومع ذلك، رغم أن جميع الأعداد في AWK هي بفاصلة عائمة، إلا أن القيم الصحيحة تُحول دائماً كأعداد صحيحة.

يجري Gawk المقارنات على النحو التالي: إذا كان المتغيران عدديين، تجري المقارنة عددياً. وإذا كانت إحدى القيمتين عددية والأخرى لها قيمة نصية وهي عبارة عن «سلسلة نصية عددية»، فتجري المقارنات أيضاً عددياً. خلاف ذلك، تُحول القيمة العددية إلى سلسلة نصية وتُجرى مقارنة نصية. وتتم مقارنة السلسلتين النصيتين، بطبيعة الحال، كسلاسل نصية.

لاحظ أن الثوابت النصية، مثل "57"، ليست سلاسل نصية عددية، بل هي ثوابت نصية. تنطبق فكرة «السلسلة النصية العددية» فقط على الحقول، ومدخلات getline، وFILENAME، وعناصر ARGV، وعناصر ENVIRON وعناصر المصفوفة التي أُنشئت بواسطة split() أو patsplit() والتي تكون سلاسل نصية عددية. الفكرة الأساسية هي أن مدخلات المستخدم، وفقط مدخلات المستخدم التي تبدو عددية، يجب أن تُعامل بهذه الطريقة.

الثوابت الثمانية والست عشرية¶

يمكنك استخدام الثوابت الثمانية والست عشرية بنمط لغة C في كود المصدر لبرنامج AWK الخاص بك. على سبيل المثال، القيمة الثمانية 011 تساوي 9 بالعشري، والقيمة الست عشرية 0x11 تساوي 17 بالعشري.

الثوابت النصية¶

الثوابت النصية في AWK هي تسلسلات من المحارف المحصورة بين علامتي اقتباس مزدوجتين (مثل "قيمة"). داخل السلاسل النصية، يُتعرف على بعض تسلسلات الهروب، كما هو الحال في C. راجع https://www.gnu.org/software/gawk/manual/html_node/Escape-Sequences لمزيد من التفاصيل.

ثوابت التعبيرات النمطية¶

ثابت التعبير النمطي هو تسلسل من المحارف المحصورة بين خطين مائلين للأمام (مثل /قيمة/).

يمكن أيضاً استخدام تسلسلات الهروب الموضحة في الدليل داخل التعبيرات النمطية الثابتة (مثل، /[ \t\f\n\r\v]/ يطابق محارف المسافات البيضاء).

يوفر Gawk ثوابت تعبيرات نمطية قوية التنميط. وتُكتب مبدوءة برمز @ (مثل هكذا: @/قيمة/). يمكن تخصيص هذه الثوابت للمتغيرات القياسية (متغيرات، عناصر مصفوفة) وتمريرها إلى الدوال التي يعرفها المستخدم. المتغيرات التي خصصت بهذه الطريقة تصبح من نوع تعبير نمطي.

الأنماط¶

قد تكون أنماط AWK أحد ما يلي:

BEGIN
END
BEGINFILE
ENDFILE
/تعبير نمطي/
تعبير علائقي
نمط && نمط
نمط || نمط
نمط ? نمط : نمط
(نمط)
! نمط
نمط1, نمط2

BEGIN وEND هما نوعان خاصان من الأنماط لا يتم اختبارهما مقابل المدخلات. تُدمج أجزاء الإجراء لجميع أنماط BEGIN كما لو كانت جميع العبارات قد كُتبت في قاعدة BEGIN واحدة. وتُنفذ قبل قراءة أي من المدخلات. وبالمثل، تُدمج جميع قواعد END، وتُنفذ عند نفاد جميع المدخلات (أو عند تنفيذ عبارة exit). لا يمكن دمج نمطي BEGIN وEND مع أنماط أخرى في تعبيرات الأنماط. كما لا يمكن أن يغيب جزء الإجراء في نمطي BEGIN وEND.

BEGINFILE وENDFILE هما أنماط خاصة إضافية تُنفذ إجراءاتها قبل قراءة السجل الأول من كل ملف مدخلات في سطر الأوامر وبعد قراءة السجل الأخير من كل ملف. داخل قاعدة BEGINFILE، تكون قيمة ERRNO هي السلسلة الفارغة إذا فُتح الملف بنجاح. وخلاف ذلك، فهناك مشكلة ما في الملف ويجب أن يستخدم الكود nextfile لتخطيه. إذا لم يُفعل ذلك، فإن gawk يصدر خطأه الفادح المعتاد للملفات التي لا يمكن فتحها.

بالنسبة لأنماط /التعبير النمطي/، تُنفذ العبارة المرتبطة به لكل سجل مدخلات يطابق التعبير النمطي. التعبيرات النمطية هي نفسها جوهرياً تلك الموجودة في egrep(1). راجع https://www.gnu.org/software/gawk/manual/html_node/Regexp.html لمزيد من التفاصيل حول التعبيرات النمطية.

قد يستخدم التعبير العلائقي أي من المعاملات المحددة أدناه في قسم الإجراءات. وهذه تختبر عموماً ما إذا كانت حقول معينة تطابق تعبيرات نمطية معينة.

المعاملات && و|| و! هي معامل «و» المنطقي، و«أو» المنطقي، و«ليس» المنطقي على التوالي، كما في C. وهي تجري تقييماً قصير المدى (short-circuit)، كما في C أيضاً، وتُستخدم لدمج تعبيرات الأنماط الأكثر بساطة. وكما هو الحال في معظم اللغات، يمكن استخدام الأقواس لتغيير ترتيب التقييم.

المعامل ?: هو مثل نفس المعامل في C. إذا كان النمط الأول صحيحاً فإن النمط المستخدم للاختبار هو النمط الثاني، وإلا فهو الثالث. يتم تقييم واحد فقط من النمطين الثاني أو الثالث.

يُسمى شكل التعبير نمط1, نمط2 بـ نمط النطاق. فهو يطابق جميع سجلات المدخلات بدءاً من السجل الذي يطابق نمط1، ويستمر حتى السجل الذي يطابق نمط2، بما في ذلك السجلين. ولا يمتزج مع أي نوع آخر من تعبيرات الأنماط.

الإجراءات¶

تُحصر عبارات الإجراء بين أقواس معقوفة، { و}. وتتكون عبارات الإجراء من عبارات التخصيص والشرط والحلقات المعتادة الموجودة في معظم اللغات. والمعاملات وعبارات التحكم وعبارات الإدخال/الإخراج المتاحة مصممة على غرار تلك الموجودة في لغة C.

المعاملات¶

المعاملات في AWK، بترتيب تنازلي للأولوية، هي:

(...)

التجميع

$

مرجع الحقل.

++ --

الزيادة والنقصان، كلاهما قبلي وبعدي.

^

الرفع للقوة (الأس).

+ - !

الزائد الأحادي، والناقص الأحادي، والنفي المنطقي.

* / %

الضرب والقسمة وباقي القسمة.

+ -

الجمع والطرح.

space

دمج السلاسل النصية.

| |&

دخل/خرج موجه لكل من getline وprint وprintf.

< > <= >= == !=

المعاملات العلائقية العادية.

~ !~

مطابقة التعبير النمطي، والمطابقة المنفية.

in

عضوية المصفوفة.

&&

«و» المنطقية.

||

«أو» المنطقية.

?:

التعبير الشرطي للغة C. وله الصيغة تعبير1 ? تعبير2 : تعبير3. إذا كان تعبير1 صحيحاً، فإن قيمة التعبير هي تعبير2، وإلا فهي تعبير3. يتم تقييم واحد فقط من التعبيرين تعبير2 أو تعبير3.

= += -= *= /= %= ^=

التخصيص. كلاهما مدعوم: التخصيص المطلق (متغير = قيمة) وتخصيص المعامل (الأشكال الأخرى).

عبارات التحكم¶

عبارات التحكم هي كما يلي:

if (شرط) عبارة [ else عبارة ]
while (شرط) عبارة
do عبارة while (شرط)
for (تعبير1; تعبير2; تعبير3) عبارة
for (متغير in مصفوفة) عبارة
break
continue
delete مصفوفة[دليل]
delete مصفوفة
exit [ تعبير ]
{ عبارات }
switch (تعبير) { case قيمة|تعبير_نمطي : عبارة ... [ default: عبارة ]
}

عبارات الدخل/الخرج¶

عبارات الإدخال/الإخراج هي كما يلي:

close(ملف [, كيف])

أغلق ملفاً مفتوحاً أو أنبوباً أو عملية مرافقة. المعامل الاختياري كيف يجب استخدامه فقط عند إغلاق طرف واحد من أنبوب ثنائي الاتجاه إلى عملية مرافقة. يجب أن يكون قيمة نصية، إما "to" أو "from".

getline

عيّن قيمة $0 من سجل المدخلات التالي؛ وعيّن قيم NF وNR وFNR وRT.

getline <ملف

عيّن قيمة $0 من السجل التالي في الملف؛ وعيّن قيم NF وRT.

getline متغير

عيّن قيمة المتغير من سجل المدخلات التالي؛ وعيّن قيم NR وFNR وRT.

getline متغير <ملف

عيّن قيمة المتغير من السجل التالي في الملف؛ وعيّن قيمة RT.

أمر | getline [متغير]

نفذ الأمر، مع توجيه الخرج إما إلى $0 أو المتغير، كما هو موضح أعلاه، وإلى RT.

أمر |& getline [متغير]

نفذ الأمر كعملية مرافقة مع توجيه الخرج إما إلى $0 أو المتغير، كما هو موضح أعلاه، وإلى RT. (يمكن أن يكون الأمر أيضاً مقبساً. راجع القسم الفرعي أسماء الملفات الخاصة أدناه.)

fflush([ملف])

أفرغ أي مخازن وسيطة مرتبطة بـ الملف أو الأنبوب المفتوح للخرج. إذا كان الملف غائباً أو كان سلسلة صفرية، فأفرغ جميع ملفات وأنابيب الخرج المفتوحة.

next

توقف عن معالجة سجل المدخلات الحالي. اقرأ سجل المدخلات التالي وابدأ المعالجة من جديد مع النمط الأول في برنامج AWK. عند الوصول إلى نهاية بيانات المدخلات، تُنفذ أي قاعدة (قواعد) END.

nextfile

توقف عن معالجة ملف المدخلات الحالي. سجل المدخلات التالي الذي سيُقرأ سيأتي من ملف المدخلات التالي. حَدّث FILENAME وARGIND، وأعد تعيين FNR إلى 1، وابدأ المعالجة من جديد مع النمط الأول في برنامج AWK. عند الوصول إلى نهاية بيانات المدخلات، تُنفذ أي قاعدة (قواعد) ENDFILE وEND.

print

اطبع السجل الحالي. يُنهى سجل المخرجات بقيمة ORS.

print expr-list

اطبع التعبيرات. يُفصل بين كل تعبير بكلمة OFS. يُنهى سجل المخرجات بقيمة ORS.

print expr-list >file

اطبع التعبيرات في file. يُفصل بين كل تعبير بقيمة OFS. يُنهى سجل المخرجات بقيمة ORS.

printf fmt, expr-list

نسّق واطبع.

printf fmt, expr-list >file

نسّق واطبع في file.

system(cmd-line)

نفّذ الأمر cmd-line، وأعد حالة الخروج. (قد لا يتوفر هذا في أنظمة غير POSIX.) راجع https://www.gnu.org/software/gawk/manual/html_node/I_002fO-Functions.html#I_002fO-Functions للحصول على كامل التفاصيل حول حالة الخروج.

يُسمح بإعادة توجيه مخرجات إضافية لـ print و printf.

print ... >> file

ألحق المخرجات بـ file.

print ... | command

اكتب في أنبوب.

print ... |& command

أرسل البيانات إلى عملية مرافقة أو مقبس. (راجع أيضًا القسم الفرعي Special File Names أدناه.)

تُعيد دالة getline القيمة 1 عند النجاح، وصفرًا عند نهاية الملف، و -1 عند حدوث خطأ. إذا أشارت قيمة errno(3) إلى إمكانية إعادة محاولة عملية الإدخال/الإخراج، وضُبطت PROCINFO["input", "RETRY"]، تُعاد القيمة -2 بدلًا من -1، ويمكن محاولة استدعاءات أخرى لـ getline. عند حدوث خطأ، تُضبط ERRNO بسلسلة تصف المشكلة.

ملاحظة: الفشل في فتح مقبس ثنائي الاتجاه يؤدي إلى إرجاع خطأ غير فتاك إلى الدالة المستدعِية. في حال استخدام أنبوب أو عملية مرافقة أو مقبس مع getline، أو من print أو printf داخل حلقة، يجب استخدام close() لإنشاء نسخ جديدة من الأمر أو المقبس. لا يغلق AWK الأنابيب أو المقابس أو العمليات المرافقة آليًا عند إرجاعها لعلامة نهاية الملف (EOF).

تتشابه إصدارات AWK من جملة printf ودالة sprintf() مع تلك الموجودة في لغة C. للتفاصيل، راجع https://www.gnu.org/software/gawk/manual/html_node/Printf.html.

أسماء الملفات الخاصة¶

عند إجراء إعادة توجيه للإدخال/الإخراج من print أو printf إلى ملف، أو عبر getline من ملف، يتعرف gawk على أسماء ملفات خاصة داخليًا. تسمح أسماء الملفات هذه بالوصول إلى واصفات الملفات المفتوحة الموروثة من العملية الأب لـ gawk (عادةً الصدفة). يمكن أيضًا استخدام أسماء الملفات هذه في سطر الأوامر لتسمية ملفات البيانات. أسماء الملفات هي:

-

الإدخال القياسي.

/dev/stdin

الإدخال القياسي.

/dev/stdout

المخرجات القياسية.

/dev/stderr

مخرجات الخطأ القياسية.

/dev/fd/n

الملف المرتبط بواصف الملف المفتوح n.

يمكن استخدام أسماء الملفات الخاصة التالية مع عامل العملية المرافقة |& لإنشاء اتصالات شبكة TCP/IP:

/inet/tcp/lport/rhost/rport

/inet4/tcp/lport/rhost/rport

/inet6/tcp/lport/rhost/rport

ملفات لاتصال TCP/IP على المنفذ المحلي lport بالمضيف البعيد rhost على المنفذ البعيد rport. استخدم المنفذ 0 ليقوم النظام باختيار منفذ. استخدم /inet4 لفرض اتصال IPv4، و /inet6 لفرض اتصال IPv6. تستخدم /inet المجردة القيمة المبدئية للنظام (على الأرجح IPv4). صالحة للاستخدام فقط مع عامل الإدخال/الإخراج ثنائي الاتجاه |&.

/inet/udp/lport/rhost/rport

/inet4/udp/lport/rhost/rport

/inet6/udp/lport/rhost/rport

مشابه، لكنه يستخدم UDP/IP بدلاً من TCP/IP.

الدوال العددية¶

يحتوي AWK على الدوال الحسابية المضمنة التالية:

atan2(y, x)

أعد ظل الزاوية العكسي لـ y/x بالراديان.

cos(expr)

أعد جيب تمام expr، والمقدر بالراديان.

exp(expr)

الدالة الأسية.

int(expr)

بتر إلى عدد صحيح.

log(expr)

دالة اللوغاريتم الطبيعي.

rand()

أعد عددًا عشوائيًا N، بين الصفر والواحد، بحيث يكون 0 ≤ N < 1.

sin(expr)

أعد جيب expr، والمقدر بالراديان.

sqrt(expr)

أعد الجذر التربيعي لـ expr.

srand([expr])

استخدم expr كبذرة جديدة لمولد الأعداد العشوائية. إذا لم يُوفّر expr، استخدم وقت اليوم. أعد البذرة السابقة لمولد الأعداد العشوائية.

دوال السلاسل النصية¶

يحتوي Gawk على دوال السلاسل النصية المضمنة التالية؛ التفاصيل متوفرة في https://www.gnu.org/software/gawk/manual/html_node/String-Functions.

asort(s [, d [, how] ])

أعد عدد العناصر في المصفوفة المصدر s. فرز محتويات s باستخدام قواعد gawk العادية لمقارنة القيم، واستبدل فهارس القيم المفروزة s بأعداد صحيحة متسلسلة تبدأ من 1. إذا حُددت مصفوفة الوجهة الاختيارية d، انسخ s أولًا إلى d، ثم افرز d، مع ترك فهارس المصفوفة المصدر s دون تغيير. تتحكم السلسلة النصية الاختيارية how في اتجاه ووضع المقارنة. القيم الصالحة لـ how موصوفة في https://www.gnu.org/software/gawk/manual/html_node/String-Functions.html#String-Functions. يُسمح لـ s و d بأن يكونا نفس المصفوفة؛ وهذا يكون منطقيًا فقط عند توفير الوسيط الثالث أيضًا.

asorti(s [, d [, how] ])

أعد عدد العناصر في المصفوفة المصدر s. السلوك هو نفسه سلوك asort()، باستثناء استخدام فهارس (indices) المصفوفة للفرز، وليس قيم المصفوفة. عند الانتهاء، تُفهرس المصفوفة عدديًا، وتكون القيم هي الفهارس الأصلية. تُفقد القيم الأصلية؛ لذا وفّر مصفوفة ثانية إذا كنت ترغب في الحفاظ على الأصل. الغرض من السلسلة النصية الاختيارية how هو نفسه في asort(). هنا أيضًا، يُسمح لـ s و d بأن يكونا نفس المصفوفة؛ وهذا يكون منطقيًا فقط عند توفير الوسيط الثالث أيضًا.

gensub(r, s, h [, t])

ابحث في السلسلة المستهدفة t عن تطابقات للتعبير النمطي r. إذا كانت h سلسلة تبدأ بـ g أو G، فاستبدل كل تطابقات r بـ s. خلاف ذلك، h هو رقم يشير إلى أي تطابق لـ r يجب استبداله. إذا لم يُوفّر t، استخدم $0 بدلًا منه. داخل نص الاستبدال s، يمكن استخدام التسلسل \n، حيث n رقم من 1 إلى 9، للإشارة فقط إلى النص الذي طابق التعبير الفرعي المحصور بين قوسين رقم n. يمثل التسلسل \0 كامل النص المطابق، وكذلك يفعل الحرف &. على عكس sub() و gsub()، تُعاد السلسلة المعدلة كنتيجة للدالة، ولا تُغير السلسلة المستهدفة الأصلية.

gsub(r, s [, t])

لكل سلسلة فرعية تطابق التعبير النمطي r في السلسلة t، استبدلها بالسلسلة s، وأعد عدد الاستبدالات. إذا لم يُوفّر t، استخدم $0. يُستبدل أي وسم & في نص الاستبدال بالنص الذي طُوبق فعليًا. استخدم \& للحصول على & حرفي. (يجب كتابة هذا كـ "\\&"؛ راجع https://www.gnu.org/software/gawk/manual/html_node/Gory-Details.html#Gory-Details لمناقشة أوفى حول قواعد علامات الآند (ampersands) والشرطات المائلة الخلفية في نص الاستبدال لـ sub() و gsub() و gensub().)

index(s, t)

أعد فهرس السلسلة t في السلسلة s، أو صفرًا إذا كانت t غير موجودة. (وهذا يعني أن فهارس الحروف تبدأ من واحد.)

length([s])

أعد طول السلسلة s، أو طول $0 إذا لم تُوفّر s. مع وسيط مصفوفة، تعيد length() عدد العناصر في المصفوفة.

match(s, r [, a])

أعد الموضع في s حيث يظهر التعبير النمطي r، أو صفرًا إذا كان r غير موجود، واضبط قيم RSTART و RLENGTH. لاحظ أن ترتيب الوسائط هو نفسه بالنسبة لعامل ~: str ~ re. راجع https://www.gnu.org/software/gawk/manual/html_node/String-Functions.html#String-Functions لوصف كيفية ملء المصفوفة a إذا تم توفيرها.

patsplit(s, a [, r [, seps] ])

قسّم السلسلة s إلى المصفوفة a ومصفوفة الفواصل seps بناءً على التعبير النمطي r، وأعد عدد الحقول. قيم العناصر هي أجزاء s التي طابقت r. قيمة seps[i] هي الفاصل (الذي قد يكون فارغًا) الذي ظهر بعد a[i]. قيمة seps[0] هي الفاصل البادئ (الذي قد يكون فارغًا). إذا حُذف r، تُستخدم FPAT بدلًا منه. تُمسح المصفوفتان a و seps أولًا. يسلك التقسيم سلوكًا مطابقًا لتقسيم الحقول باستخدام FPAT.

split(s, a [, r [, seps] ])

قسّم السلسلة s إلى المصفوفة a ومصفوفة الفواصل seps بناءً على التعبير النمطي r، وأعد عدد الحقول. إذا حُذف r، تُستخدم FS بدلًا منه. تُمسح المصفوفتان a و seps أولًا. seps[i] هو فاصل الحقول الذي طابقه r بين a[i] و a[i+1]. يسلك التقسيم سلوكًا مطابقًا لتقسيم الحقول.

sprintf(fmt, expr-list)

اطبع expr-list وفقًا لـ fmt، وأعد السلسلة الناتجة.

strtonum(str)

افحص str، وأعد قيمتها العددية. إذا بدأت str بصفر 0 بادئ، فتعامل معها كعدد ثماني. إذا بدأت بـ 0x أو 0X بادئة، فتعامل معها كعدد ست عشري. خلاف ذلك، افترض أنها عدد عشري.

sub(r, s [, t])

تمامًا مثل gsub()، ولكن تستبدل فقط أول سلسلة فرعية مطابقة. تعيد إما صفرًا أو واحدًا.

substr(s, i [, n])

أعد السلسلة الفرعية المكونة من n حرفًا على الأكثر من s بدءًا من i. إذا حُذف n، استخدم بقية s.

tolower(str)

أعد نسخة من السلسلة str، مع تحويل جميع الأحرف الكبيرة في str إلى مقابلاتها الصغيرة. تُترك الأحرف غير الأبجدية دون تغيير.

toupper(str)

أعد نسخة من السلسلة str، مع تحويل جميع الأحرف الصغيرة في str إلى مقابلاتها الكبيرة. تُترك الأحرف غير الأبجدية دون تغيير.

يدعم Gawk المحارف متعددة البايتات. وهذا يعني أن index() و length() و substr() و match() تعمل جميعها من منظور المحارف، وليس البايتات.

دوال الوقت¶

يوفر Gawk الدوال التالية للحصول على الطوابع الزمنية وتنسيقها. التفاصيل متوفرة في https://www.gnu.org/software/gawk/manual/html_node/Time-Functions.

mktime(datespec [, utc-flag])

حوّل datespec إلى طابع زمني بنفس الشكل الذي تعيده دالة systime()، وأعد النتيجة. إذا وُجد utc-flag وكان غير صفري أو غير فارغ، يُفترض أن الوقت بنظام UTC؛ وخلاف ذلك، يُفترض أن الوقت بالتوقيت المحلي. إذا لم تحتوي datespec على عناصر كافية أو إذا كان الوقت الناتج خارج النطاق، تعيد mktime() القيمة -1. راجع https://www.gnu.org/software/gawk/manual/html_node/Time-Functions.html#Time-Functions لتفاصيل datespec.

strftime([التنسيق [, الطابع_الزمني[, علم_utc]]])

يُنَسَّق الطابع_الزمني وفقًا للمواصفات في التنسيق. إذا وُجد علم_utc وكان غير صفري أو غير فارغ، فستكون النتيجة بتوقيت UTC، وإلا فستكون النتيجة بالتوقيت المحلي. يجب أن يكون الطابع_الزمني على نفس الهيئة التي تعيدها systime(). إذا فُقد الطابع_الزمني، فسيُستخدم وقت اليوم الحالي. إذا فُقد التنسيق، فسيُستخدم تنسيق مبدئي يعادل مخرجات date(1). التنسيق المبدئي متاح في PROCINFO["strftime"]. انظر مواصفات دالة strftime() في ISO C لمعرفة تحويلات التنسيق المضمون توافرها.

systime()

تُعيد وقت اليوم الحالي كعدد الثواني منذ حقبة (1970-01-01 00:00:00 UTC على أنظمة POSIX).

دوال معالجة البتات¶

يوفر Gawk دوال معالجة البتات التالية. وتعمل عن طريق تحويل قيم الفاصلة العائمة مزدوجة الدقة إلى أعداد صحيحة من نوع uintmax_t، ثم تُجرى العملية، وتُحول النتيجة مرة أخرى إلى فاصلة عائمة. يؤدي تمرير معاملات سالبة إلى أي من هذه الدوال إلى حدوث خطأ فادح.

الدوال هي:

and(v1, v2 [, ...])

تُعيد نتيجة عملية AND الثنائية (bitwise) للقيم المقدمة في قائمة المعاملات. يجب تقديم اثنين على الأقل.

compl(val)

تُعيد المتمم الثنائي (bitwise complement) لـ val.

lshift(val, count)

تُعيد قيمة val، بعد إزاحتها لليسار بمقدار count من البتات.

or(v1, v2 [, ...])

تُعيد نتيجة عملية OR الثنائية للقيم المقدمة في قائمة المعاملات. يجب تقديم اثنين على الأقل.

rshift(val, count)

تُعيد قيمة val، بعد إزاحتها لليمين بمقدار count من البتات.

xor(v1, v2 [, ...])

تُعيد نتيجة عملية XOR الثنائية للقيم المقدمة في قائمة المعاملات. يجب تقديم اثنين على الأقل.

دوال الأنواع¶

توفر الدوال التالية معلومات متعلقة بالأنواع حول معاملاتها.

isarray(x)

تُعيد صحيحًا (true) إذا كان x مصفوفة، وخاطئًا (false) خلاف ذلك.

typeof(x)

يعيد سلسلة نصية تشير إلى نوع x. ستكون السلسلة واحدة من "array"، أو "number"، أو "regexp"، أو "string"، أو "strnum"، أو "unassigned"، أو "undefined".

دوال التدويل¶

يمكن استخدام الدوال التالية من داخل برنامج AWK لترجمة السلاسل النصية أثناء وقت التشغيل. للحصول على التفاصيل الكاملة، انظر https://www.gnu.org/software/gawk/manual/html_node/I18N-Functions.html#I18N-Functions.

bindtextdomain(الدليل [, النطاق])

تحدد الدليل الذي يبحث فيه gawk عن ملفات .gmo، في حال لم توضع أو تعذر وضعها في المواقع "القياسية". وتُعيد الدليل الذي "رُبط" به النطاق.

النطاق المبدئي هو قيمة TEXTDOMAIN. إذا كان الدليل سلسلة فارغة ("")، فإن bindtextdomain() تعيد الربط الحالي لـ النطاق المعطى.

dcgettext(السلسلة [, النطاق [, الفئة]])

تُعيد ترجمة السلسلة في نطاق النص النطاق لفئة المحلية الفئة. القيمة المبدئية لـ النطاق هي القيمة الحالية لـ TEXTDOMAIN. والقيمة المبدئية لـ الفئة هي "LC_MESSAGES".

dcngettext(سلسلة1, سلسلة2, العدد [, النطاق [, الفئة]])

تُعيد صيغة الجمع المستخدمة لـ العدد من ترجمة سلسلة1 و سلسلة2 في نطاق النص النطاق لفئة المحلية الفئة. القيمة المبدئية لـ النطاق هي القيمة الحالية لـ TEXTDOMAIN. والقيمة المبدئية لـ الفئة هي "LC_MESSAGES".

الدوال ذات القيم المنطقية¶

يمكنك إنشاء قيم خاصة من النوع المنطقي (Boolean)؛ انظر الدليل لمعرفة كيف تعمل ولماذا هي موجودة.

mkbool(تعبير)

بناءً على القيمة المنطقية لـ تعبير، تُعيد إما قيمة صواب أو قيمة خطأ. قيم الصواب لها القيمة العددية واحد، وقيم الخطأ لها القيمة العددية صفر.