هيكل التطبيق

تطبيق curses يستخدم معلومات من الإعدادات المحلية للنظام؛ setlocale(3) يُهيِّئها لاستدعاءات مكتبة curses.

setlocale(LC_ALL, "");

إذا لم تُهيَّأ الإعدادات المحلية بهذه الطريقة، تفترض المكتبة أن المحارف قابلة للطباعة كما في ISO 8859-1، للعمل مع بعض البرامج القديمة. يجب عليك تهيئة الإعدادات المحلية؛ لا تتوقع سلوكًا ثابتًا من المكتبة عندما لا تكون الإعدادات المحلية قد أُعدت.

يجب استدعاء initscr(3X) أو newterm(3X) لتهيئة curses قبل استخدام أي دوال تصل إلى النوافذ أو الشاشات أو تعالجها.

للحصول على دخل محرف تلو الآخر بدون صدى — معظم البرامج التفاعلية الموجهة للشاشة تريد هذا — استخدم التسلسل التالي.

initscr(); cbreak(); noecho();

معظم التطبيقات ستُجري إعدادًا إضافيًا على النحو التالي.

noqiflush();
keypad(stdscr, TRUE);

غالبًا ما يدخل برنامج curses بعد ذلك في حلقة معالجة أحداث. استدعِ endwin(3X) قبل الخروج.

نظرة عامة

تُجرّد مكتبة curses الطرفية بهيكل بيانات SCREEN، وتمثل كل أو جزء من شاشتها بهياكل WINDOW. تنطبق خصائص مميزة على كل منها؛ على سبيل المثال، يكون نظام الخط لمشغل طرفية Unix النموذجي في أحد ثلاثة أوضاع: خام، cbreak، أو قانوني (“مطبوخ”). في curses، نظام الخط هو خاصية للشاشة، تنطبق بشكل متطابق على جميع النوافذ المرتبطة بها.

النافذة هي شبكة مستطيلة من خلايا المحارف، تُعنون بإحداثيات السطر والعمود (y, x)، مع الزاوية العليا اليسرى كـ (0, 0). نافذة تُدعى stdscr، مبدئيًا بنفس حجم شاشة الطرفية، متاحة دائمًا. أنشئ أخرى باستخدام newwin(3X).

لا تدير مكتبة curses النوافذ المتداخلة (لكن انظر أدناه). يمكنك إما استخدام stdscr لإدارة نافذة واحدة تملأ الشاشة، أو تجانب الشاشة إلى نوافذ غير متداخلة وعدم استخدام stdscr على الإطلاق. سيؤدي خلط النهجين إلى تأثيرات غير متوقعة وغير مرغوب فيها.

تسمح الدوال بمعالجة نافذة والمؤشر الذي يُحدد الخلية داخلها حيث ستحدث العملية التالية. من بينها، الأكثر أساسية هي move(3X) و addch(3X): تضع هذه المؤشر داخل stdscr وتكتب محرفًا إليه، على التوالي.

يمكن أن تسبب التغييرات المتكررة لشاشة الطرفية وميضًا مزعجًا أو استخدامًا غير فعال لقناة الاتصال بالجهاز، لذلك كقاعدة لا تُحدّثها المكتبة آليًا. لذلك، بعد استخدام دوال curses لتجميع مجموعة من التحديثات المرغوبة التي من المنطقي تقديمها معًا، استدعِ refresh(3X) لإخبار المكتبة بجعل شاشة المستخدم تبدو مثل stdscr. تُحسّن المكتبة مخرجاتها بحساب حجم أدنى من العمليات لتحويل الشاشة من حالتها في التحديث السابق إلى الحالة الجديدة. يتطلب التحسين الفعال معلومات دقيقة عن جهاز الطرفية: إدارة هذه المعلومات هي مجال واجهة برمجة التطبيقات terminfo(3X)، وهي ميزة في كل تطبيق curses قياسي.

يمكن أيضًا معالجة نوافذ خاصة تُدعى الوسادات. هذه ليست مقيدة بحجم شاشة الطرفية ولا يلزم عرض محتوياتها بالكامل. انظر curs_pad(3X).

تدعم العديد من الطرفيات تكوين ألوان المقدمة والخلفية لخلايا المحارف بالإضافة إلى السمات، التي تجعل المحارف تُعرض في أوضاع مثل العريض، المسطر، أو الفيديو المعكوس. انظر curs_color(3X) و curs_attr(3X).

يُعرّف curses ثوابت لتبسيط الوصول إلى مجموعة صغيرة من رسومات رسم النماذج المقابلة لمجموعة المحارف البديلة DEC (ACS)، وهي ميزة في VT100 وطرفيات أخرى. انظر addch(3X).

يُطبّق curses باستخدام مشغل طرفية نظام التشغيل؛ تُستقبل أحداث المفاتيح ليس كرموز مسح ضوئي بل كتسلسلات بايت. يُبلغ المشغل عن أغطية المفاتيح الرسومية (مفاتيح الأبجدية الرقمية وعلامات الترقيم والمسافة) كما هي. كل شيء آخر، بما في ذلك علامة التبويب، الإدخال/العودة، لوحة المفاتيح الرقمية، الأسهم، ومفاتيح الوظائف، يظهر لـ curses كمحرف تحكم أو تسلسل هروب متعدد البايت. يمكن لـ curses ترجمة الأخير إلى رموز مفاتيح فريدة. انظر keypad(3X) و getch(3X).

يوفر ncurses إعادة تطبيقات لمكتبات SVr4 panel(3X) و form(3X) و menu(3X)؛ تسمح هذه بالنوافذ المتداخلة وتُسهّل بناء واجهات المستخدم باستخدام curses.

التهيئة

اختيار قيمة مناسبة لـ TERM في بيئة العملية ضروري لتشغيل مكتبة curses و terminfo بشكل صحيح. يختار نظام مُهيأ جيدًا قيمة TERM صحيحة آليًا؛ قد يساعد tset(1) في استكشاف المواقف الغريبة.

إذا غيّرت نوع الطرفية من شل، صدّر TERM، ثم شغّل tset(1) أو الأمر “tput init”. انظر القسم الفرعي “علامات التبويب والتهيئة” من terminfo(5).

إذا كانت متغيرات البيئة LINES و COLUMNS مضبوطة، أو إذا كان برنامج curses يُنفّذ في بيئة نوافذ رسومية، فإن المعلومات المُحصلة من هناك تتجاوز تلك المُحصلة بواسطة terminfo. امتداد ncurses يدعم شاشات طرفية قابلة لتغيير الحجم؛ انظر wresize(3X).

إذا كان متغير البيئة TERMINFO مُعرّفًا، يتحقق برنامج curses أولاً من وصف نوع طرفية في الموقع الذي يُحدده. TERMINFO مفيد لتطوير أوصاف الأنواع أو عندما لا تكون صلاحية الكتابة إلى /usr/share/terminfo متاحة.

انظر القسم “البيئة” أدناه.

اتفاقيات التسمية

يقدم curses العديد من الدوال في أشكال متغيرة باستخدام مجموعة منتظمة من البدائل لاسم الدالة الأساسية. تلك المسبوقة بـ “w” تتطلب معامل مؤشر WINDOW؛ تلك التي بادئة “mv” تؤدي أولاً حركة مؤشر باستخدام wmove(3X)؛ بادئة “mvw” تشير إلى كليهما. دالة “w” هي عادةً الأساسية؛ إزالة هذه البادئة تشير عادةً إلى العمل على stdscr.

أربع دوال مسبوقة بـ “p” تتطلب معامل وسادة؛ انظر أدناه.

في ملخصات الدوال، تطبق صفحات دليل ncurses الأسماء التالية على المعاملات. نقدم أنواع المحارف في القسم الفرعي التالي.

تهيئات المحارف العريضة وغير العريضة

تستعرض صفحة الدليل هذه بشكل رئيسي الدوال التي تظهر في أي تهيئة من تهيئات المكتبة. هناك تهيئتان شائعتان؛ للاطلاع على الأخرى، راجع القسم “التهيئات البديلة” أدناه.

ncurses

هي المكتبة في تهيئتها “غير العريضة”، التي تعالج محارف ثمانية البتات فقط. تخزن محرفًا مدمجًا مع سمات ومعرّف زوج ألوان في عنصر بيانات chtype، والذي غالبًا ما يكون اسمًا مستعارًا لـ int. سلسلة محارف curses مشابهة لسلسلة محارف C char؛ تنتهي سلسلة chtype بقيمة صحيحة 0، وهي محرف curses الفارغ.

يمكن تخزين السمات ومعرّف زوج الألوان (بدون محرف مقابل) في متغيرات من نوع chtype أو attr_t. في كلتا الحالتين، يُوصل إليها عبر قناع بتات صحيح.

يخزن ncurses كل خلية من نافذة كقيمة chtype. لا تحدد X/Open Curses أحجام رمز المحرف أو معرّف زوج الألوان، ولا عدد بتات السمات، في chtype؛ هذه الأمور تعتمد على التنفيذ. يستخدم ncurses ثمانية بتات لرمز المحرف. يجب على التطبيق الذي يتطلب نوع محرف أوسع، مثل تمثيل Unicode، استخدام واجهة برمجة التطبيقات للمحارف العريضة.

ncursesw

هي المكتبة في تهيئتها “العريضة”، التي تعالج ترميزات المحارف التي تتطلب نوع بيانات أكبر مما يمكن أن يمثله char (نوع بحجم بايت). توفر دوال إضافية تكمل تلك الموجودة في المكتبة غير العريضة حيث يكون حجم نوع المحرف الأساسي مهمًا. تربط اصطلاحية تسمية منتظمة إلى حد ما العديد من المتغيرات العريضة بنظيراتها غير العريضة؛ حيث يحتوي اسم الدالة غير العريضة على “ch” أو “str”، أسبقها بـ “_w” للحصول على النظير العريض. على سبيل المثال، تصبح waddch هي wadd_wch. الاستثناء هو ins_nwstr (ومتغيراته)، مكتوبة هكذا بدلاً من “insn_wstr”. (الاستثناءات التي تضيف فقط “w” تشمل addwstr و inwstr ومتغيراتهما.)

هذه الاصطلاحية غير قابلة للتطبيق على بعض أسماء الدوال غير العريضة، لذا تُستخدم تحويلات أخرى للتهيئة العريضة: دالة إدارة خلفية النافذة “bkgd” تصبح “bkgrnd”؛ دوال رسم ومسح حدود النافذة تُلحق باللاحقة “_set”؛ ودوال معالجة سمات المحرف مثل “attron” تصبح “attr_on”.

فهرس أسماء الدوال

يسرد الجدول التالي دوال curses المقدمة في واجهات برمجة التطبيقات غير العريضة والعريضة وصفحات الدليل المقابلة التي تصفها. تلك المعلَّمة بـ “*” خاصة بـ ncurses، غير موصوفة بواسطة X/Open Curses ولا موجودة في SVr4.

إضافة ncurses لمؤشر الشاشة تُضيف دوال إضافية تُقابل العديد مما سبق، كل منها بلاحقة “_sp”؛ انظر curs_sp_funcs(3X).

توفر بعض الإضافات قابل للتكوين عند تجميع ncurses؛ انظر القسمين “ALTERNATE CONFIGURATIONS” و “EXTENSIONS” أدناه.

BAUDRATE

مكتبة التصحيح تفحص هذا المتغير عندما يُعيد التطبيق توجيه المخرجات إلى ملف. ncurses تُفسر قيمته الصحيحة كسرعة خط الطرفية بالبت في الثانية. إذا كانت تلك القيمة غائبة أو غير صالحة، تستخدم ncurses 9600. هذه الميزة تسمح للمطورين ببناء حالات اختبار قابلة للتكرار تراعي قرارات التحسين التي تعتمد على سرعة خط الطرفية.

CC (حرف الأمر)

عند تعيينه، تتغير قيمة إمكانية command_character (cmdch) لمدخلات terminfo المُحمّلة إلى قيمة هذا المتغير. عدد قليل جدًا من مدخلات terminfo توفر هذه الميزة.

لأن هذا الاسم يُستخدم أيضًا في بيئات التطوير لتخزين اسم مترجم C، فإن ncurses يتجاهل قيمته إذا لم يكن طوله حرفًا واحدًا.

COLUMNS

يحدد هذا المتغير عرض الشاشة بوحدات الخلايا المحرفية. التطبيقات التي تعمل في بيئة النوافذ عادةً ما تستطيع الحصول على عرض النافذة التي تنفذ فيها. يفرض ncurses حدًا أقصى قدره 512 عند قراءة القيمة. إذا لم يُعرف COLUMNS ولم يكن حجم شاشة الطرفية متاحًا من برنامج تشغيل الطرفية، يستخدم ncurses الحجم المحدد بواسطة قدرة columns (cols) لإدخال نوع الطرفية في قاعدة بيانات terminfo، إن وُجد.

من المهم أن يستخدم تطبيقك حجم الشاشة الصحيح. الكشف الآلي عنه ليس ممكنًا دائمًا لأن التطبيق قد يعمل على مضيف لا يحترم NAWS (مفاوضات حول حجم النافذة) أو بهوية مستخدم مختلفة عن مالك ملف جهاز الطرفية. تعيين COLUMNS و/أو LINES يتجاوز استخدام المكتبة لحجم الشاشة المُحصل عليه من نظام التشغيل.

يمكن تحديد المتغيرين COLUMNS و LINES بشكل مستقل. هذه الخاصية مفيدة لتجاوز العيوب في أوصاف أنواع الطرفيات القديمة؛ أوصاف xterm(1) التي تحدد 65 سطرًا كانت سيئة السمعة يومًا. للحصول على أفضل النتائج، تجنب تحديد رموز القدرة cols و lines في أوصاف terminfo لمحاكيات الطرفيات.

يمكن لـ use_env(3X) تعطيل استخدام بيئة العملية في تحديد حجم الشاشة. يمكن لـ use_tioctl(3X) تحديث COLUMNS و LINES لمطابقة حجم الشاشة المُحصل عليه من استدعاءات النظام أو قاعدة بيانات الطرفيات.

ESCDELAY

لكي يميز curses حرف ESC الناتج عن ضغط المستخدم لمفتاح “Escape” على جهاز الإدخال عن ذلك الذي يبدأ تسلسل هروب (كما يُنتج عادةً بواسطة مفاتيح الوظائف)، ينتظر بعد استقبال حرف الهروب ليرى ما إذا كانت محارف إضافية متاحة في دفق الإدخال خلال فترة قصيرة. يخزن متغير عام ESCDELAY هذه الفترة بالمللي ثانية. القيمة المبدئية 1000 (ثانية واحدة) كافية لمعظم الاستخدامات. يتجاوز متغير البيئة هذا هذه القيمة؛ يفرض ncurses حدًا أقصى قدره 30,000 (30 ثانية) عند قراءة القيمة.

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

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

لا ينبغي للتطبيقات المحمولة الاعتماد على وجود ESCDELAY بأي شكل، لكن تعيين متغير البيئة بدلاً من المتغير العام لا يخلق مشاكل عند ترجمة تطبيق.

إذا كان keypad(3X) معطلًا لنافذة curses التي تستقبل الإدخال، فإن ESCDELAY غير ذي صلة ويجب على البرنامج إزالة الغموض عن تسلسلات الهروب بنفسه.

HOME

قد يقرأ ncurses ويكتب أوصاف طرفيات مساعدة في ملفات .termcap و .terminfo في دليل المستخدم الرئيسي.

LINES

هذا النظير لـ COLUMNS يحدد ارتفاع الشاشة بالمحارف. القدرة والرمز المقابلان في terminfo هما lines. انظر وصف المتغير COLUMNS أعلاه.

MOUSE_BUTTONS_123

(منفذ OS/2 EMX فقط) يُرقم OS/2 فأرة ثلاثية الأزرار بشكل غير متسق مع المنصات الأخرى، بحيث يكون 1 هو الزر الأيسر، 2 الأيمن، و3 الأوسط. يخصص هذا المتغير ترقيم أزرار الفأرة. يجب أن تكون قيمته ثلاثة أرقام 1-3 بأي ترتيب. افتراضيًا، يفترض ncurses ترقيمًا “132”.

NCURSES_ASSUMED_COLORS

إذا عُيّن، يتجاوز هذا المتغير افتراض المكتبة ncurses المُضمّن في الترجمة بأن ألوان الطرفية المبدئية هي أبيض على أسود؛ انظر default_colors(3X). عيّن قيم لون المقدمة والخلفية باستخدام متغير البيئة هذا بتعيين قيمتين صحيحتين مفصولتين بفاصلة، تشيران إلى رقمي لون المقدمة والخلفية، على التوالي.

على سبيل المثال، لإخبار ncurses بعدم افتراض أي شيء عن الألوان، استخدم قيمة “-1,-1”. لجعل مخطط الألوان المبدئي أخضر على أسود على طرفية تستخدم تعيينات ألوان ANSI X3.64/ECMA-48/ISO 6429، استخدم “2,0”. يقبل ncurses قيمًا صحيحة من -1 حتى قيمة قدرة terminfo max_colors (colors) لنوع الطرفية المحدد.

NCURSES_CONSOLE2

(منفذ MinGW فقط) يعالج برنامج Console2 بشكل معيب استدعاء واجهة برمجة تطبيقات وحدة التحكم من Microsoft CreateConsoleScreenBuffer. التطبيقات التي تستخدمه ستتوقف. ومع ذلك، من الممكن محاكاة إجراء هذا الاستدعاء عن طريق تعيين الإحداثيات، وحفظ واستعادة محتويات الشاشة الأصلية بشكل صريح. تعيين متغير البيئة NCGDB له نفس التأثير.

NCURSES_GPM_TERMS

(لينكس فقط) عندما يُهيأ ncurses لاستخدام واجهة GPM، قد يُدرج هذا المتغير اسم نوع طرفية واحد أو أكثر، مفصولة بخطوط عمودية (|) أو نقطتين رأسيتين (:)، يُطابق بها متغير TERM (انظر أدناه). القيمة الفارغة تُعطل واجهة GPM، مستخدمةً دعم ncurses المدمج لبروتوكولات فأر xterm(1) بدلاً من ذلك. إذا غاب المتغير، يحاول ncurses فتح GPM إذا احتوى TERM على “linux”.

NCURSES_NO_HARD_TABS

قد يستخدم ncurses محارف الجدولة في تحسين حركة المؤشر. في بعض الحالات، قد لا يعالج برنامج تشغيل طرفيتك هذه المحارف بشكل صحيح. عيّن هذا المتغير البيئي إلى أي قيمة لتعطيل الميزة. يمكنك أيضاً ضبط إعدادات stty(1) لتجنب المشكلة.

NCURSES_NO_MAGIC_COOKIE

تخزن العديد من الأطراف خصائص الفيديو كخصائص لخلية محرف، كما يفعل curses. تاريخياً، سجلت بعض التغييرات في خصائص الفيديو كبيانات احتلت منطقياً (لكن بشكل غير مرئي) خلايا محرف على الشاشة، مُشغّلة أو مُعطّلة الخصائص، مشابهاً للوسوم في لغة ترميز، والتي كان يجب طباعتها فوقياً لتصوير المحتويات المرغوبة للخلايا؛ تُسمى هذه “الكعكات السحرية”. إذا كان إدخال terminfo لنوع طرفيتك لا يصف معالجتها للكعكات السحرية بشكل كافٍ، عيّن هذا المتغير إلى أي قيمة لتوجيه ncurses لتعطيل الخصائص بالكامل.

NCURSES_NO_PADDING

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

الحل الذي لا يكلف أجهزة هو أن يوقف التطبيق الإرسال بعد توجيه طرفية لتنفيذ عملية تؤديها ببطء، مثل مسح الشاشة. تضمن العديد من أوصاف أنواع الأطراف، بما في ذلك وصف VT100، مواصفات تأخير في الإمكانيات. قد ترغب في استخدام هذه الأوصاف الطرفية دون دفع ثمن الأداء. عيّن NCURSES_NO_PADDING إلى أي قيمة لتعطيل كل الحشو باستثناء الإلزامي. يُستخدم الحشو الإلزامي بواسطة إمكانيات طرفية مثل flash_screen (flash).

NCURSES_NO_SETBUF

(مهمل) قبل التغييرات الداخلية المطورة في ncurses 5.9 (التصحيحات من 20120825 إلى 20130126)، استخدمت المكتبة setbuf(3) لتمكين الإخراج المخزن بالكامل عند تهيئة الطرفية. فُعل هذا، كما في SVr4 curses، لزيادة الأداء. لأغراض الاختبار، لكل من ncurses وبعض التطبيقات، جُعلت هذه الميزة اختيارية. تعطيل هذا المتغير عطل تخزين الإخراج مؤقتاً، تاركاً دفق الإخراج في الوضع الأصلي (عادةً تخزين سطري مؤقت).

في الوقت الحالي، يقوم ncurses بتخزينه المؤقت الخاص ولا يحتاج هذا الحل البديل؛ لا يعدل تخزين دفق الإخراج القياسي. هذا النهج يجعل معالجة المكتبة للإشارات المبدوءة بلوحة المفاتيح أكثر متانة. العيب هو أن بعض البرامج غير التقليدية خلطت استدعاءات stdio(3) مع استدعاءات ncurses وحصلت (عادةً) على السلوك الذي توقعته. لم يعد هذا هو الحال؛ لا يكتب ncurses إلى واصف ملف الإخراج القياسي عبر دفق مخزن مؤقتاً بواسطة stdio.

كحالة خاصة، لا تزال استدعاءات واجهة برمجة التطبيقات منخفضة المستوى مثل putp(3X) تستخدم دفق الإخراج القياسي. استدعاءات curses عالية المستوى مثل printw(3X) لا تفعل ذلك.

NCURSES_NO_UTF8_ACS

عند التهيئة، يفحص ncurses المتغير البيئي TERM للحالات الخاصة حيث محارف رسم الأشكال VT100 (وإمكانيات مجموعة المحارف البديلة المقابلة terminfo) معروفة بأنها غير مدعومة بأنواع أطراف تدعي خلاف ذلك توافق VT100. تحديداً، عند التشغيل في بيئة محلية UTF-8، يتجاهلها جهاز وحدة التحكم الافتراضية لينكس وبرنامج GNU screen(1). عيّن هذا المتغير إلى قيمة غير صفرية لتوجيه ncurses بأن دعم ACS للطرفية معطل؛ ثم تُخرج المكتبة نقاط رمز Unicode التي تتوافق مع محارف رسم الأشكال. عيّنه إلى صفر (أو غير عدد صحيح) لتعطيل الفحص الخاص لأسماء أنواع الأطراف المطابقة لـ “linux” أو “screen”، موجهاً ncurses لافتراض أن ميزة ACS تعمل إذا أعلن وصف نوع الطرفية عنها.

كبديل لاستخدام هذا المتغير، يفحص ncurses إمكانية رقمية موسعة terminfo U8 يمكن تجميعها باستخدام “tic -x”. الأمثلة تتبع.

# linux console, if patched to provide working
# VT100 shift-in/shift-out, with corresponding font.
linux-vt100|linux console with VT100 line-graphics,
        U8#0, use=linux,
# uxterm with vt100Graphics resource set to false
xterm-utf8|xterm relying on UTF-8 line-graphics,
        U8#1, use=xterm,

اختير الاسم المكون من محرفين “U8” للسماح باستخدامه عبر واجهة termcap الخاصة بـ ncurses.

NCURSES_TRACE

عند التهيئة، يفحص ncurses (في تكوين التصحيح الخاص به) وجود هذا المتغير. إذا عُرف بقيمة صحيحة، تستدعي المكتبة curses_trace(3X) بتلك القيمة كمعامل.

TERM

المتغير TERM يُشير إلى نوع الطرفية. كل نوع متميز، رغم تشابه العديد منها. يُضبط عادةً بواسطة محاكيات الطرفية لمساعدة التطبيقات في إيجاد وصف طرفية قابل للعمل. بعضها يختار تقريبًا شائعًا مثل “ansi” أو “vt100” أو “xterm” بدلاً من تطابق دقيق مع قدراتها. ليس نادرًا أن يواجه تطبيق مشاكل مع هذا النهج؛ على سبيل المثال، قد لا تعمل ضغطة مفتاح بشكل صحيح، أو لا تُنتج أي تأثير سوى أحرف تبدو غير مفهومة على الشاشة.

ضبط TERM ليس له تأثير على تشغيل العتاد؛ بل يؤثر على طريقة تواصل التطبيقات مع الطرفية. وبالمثل، كقاعدة عامة (xterm(1) استثناء نادر)، محاكيات الطرفية التي تسمح لك بتحديد TERM كمعامل أو قيمة تهيئة لا تُغير سلوكها ليتطابق مع ذلك الضبط.

TERMCAP

إذا كان ncurses مُهيأ بدعم termcap، فإنه يتحقق من وجود وصف نوع طرفية بصيغة termcap إذا لم يتوفر وصف بصيغة terminfo. ضبط هذا المتغير يُوجّه ncurses لتجاهل موقع قاعدة بيانات termcap المعتاد، /etc/termcap؛ انظر TERMPATH أدناه. يجب أن يحتوي TERMCAP إما على وصف طرفية (مع إزالة الأسطر الجديدة)، أو اسم ملف يُشير إلى مكان تخزين المعلومات المطلوبة بواسطة متغير البيئة TERM.

TERMINFO

يمكن تهيئة ncurses لقراءة قواعد بيانات أوصاف أنواع الطرفيات في مواقع مختلفة باستخدام صيغ متنوعة. هذا المتغير يُلغي الموقع المبدئي.

• الأوصاف بصيغة terminfo تُخزّن عادةً في شجرة أدلة باستخدام أدلة فرعية مُسمّاة بأول حرف شائع لأنواع الطرفيات المذكورة فيها. استخدم System V هذا المخطط.
• إذا كان ncurses مُهيأ لاستخدام قواعد بيانات مُجزّأة، فقد يُسمي TERMINFO موقعها، مثل /usr/share/terminfo.db، بدلاً من /usr/share/terminfo/.

قاعدة البيانات المُجزّأة تستخدم مساحة قرص أقل وتكون أسرع قليلاً من شجرة الأدلة. ومع ذلك، تفترض بعض التطبيقات وجود شجرة الأدلة وتقرأها مباشرةً، متجاهلة واجهة برمجة التطبيقات terminfo.

• إذا كان ncurses مُهيأ بدعم termcap، فقد يحتوي هذا المتغير على موقع ملف termcap.
• إذا بدأت قيمة TERMINFO بـ “hex:” أو “b64:”، يستخدم ncurses باقي القيمة كوصف terminfo مُجمّع. يمكنك إنتاج صيغة base64 باستخدام infocmp(1M).

يستخدم ncurses الوصف المُجمّع فقط إذا تطابق مع نوع الطرفية المُعرّف بواسطة TERM.

ضبط TERMINFO هو أبسط طريقة، ولكن ليست الوحيدة، لتوجيه ncurses إلى قاعدة بيانات طرفية. مسار البحث كما يلي.

• آخر قاعدة بيانات طرفية كتب إليها تطبيق ncurses الجاري، إن وُجدت
• الموقع المُحدد بواسطة متغير البيئة TERMINFO
• $HOME/.terminfo
• المواقع المُدرجة في متغير البيئة TERMINFO_DIRS
• location(s) configured and compiled into ncurses

TERMINFO_DIRS

هذا المتغير يُحدد قائمة من المواقع، شبيهة بـ PATH، حيث يبحث ncurses عن أوصاف أنواع الطرفيات الموصوفة بواسطة TERMINFO أعلاه. عناصر القائمة مفصولة بنقطتين رأسيتين في Unix وفواصل منقوطة في OS/2 EMX. يفتقر System V terminfo إلى ميزة مقابلة؛ TERMINFO_DIRS هو امتداد لـ ncurses.

TERMPATH

إذا لم يحتوِ TERMCAP على وصف لنوع طرفية أو اسم ملف، فإن ncurses يتحقق من محتويات TERMPATH، وهي قائمة مواقع، تشبه PATH، يبحث فيها عن أوصاف أنواع الطرفيات termcap. تُفصل عناصر القائمة بنقطتين رأسيتين في يونكس وفواصل منقوطة في OS/2 EMX.

إذا كان كل من TERMCAP و TERMPATH غير مُعيَّنين أو غير صالحين، فإن ncurses يبحث عن الملفات /etc/termcap و /usr/share/misc/termcap و $HOME/.termcap، بهذا الترتيب.

التحقق من الأخطاء

في حالات عديدة، يكون X/Open Curses غامضًا بشأن حالات الخطأ، متجاهلاً بعض توثيق SVr4.

على عكس التطبيقات الأخرى، يتحقق ncurses من معاملات المؤشر، مثل تلك الخاصة بهياكل WINDOW، لضمان أنها ليست فارغة. يُفعل ذلك بشكل أساسي للحماية من أخطاء المبرمج. لا توفر الواجهة القياسية طريقة للمكتبة لإخبار التطبيق بأي من الأخطاء المحتملة حدث. يحد التطبيق الذي يعتمد على ncurses للتحقق من صحة معاملات دواله من قابلية نقله ومتانته.

اختلافات الحشو

في تطبيقات curses التاريخية، فعّلت التأخيرات المضمنة في قدرات terminfo carriage_return (cr) و scroll_forward (ind) و cursor_left (cub1) و form_feed (ff) و tab (ht) بتات التأخير المقابلة في مشغل طرفية يونكس. يُنفذ ncurses كل الحشو بإرسال بايتات NUL إلى الجهاز. هذه الطريقة أغلى قليلاً، لكنها تضيّق الواجهة مع نواة يونكس بشكل كبير وتزيد من قابلية نقل الحزمة بالمقابل.

ملفات الرأس

يتضمن ملف الرأس curses.h نفسه ملفي الرأس stdio.h و unctrl.h.

لدى X/Open Curses المزيد ليقوله،

لكنه لا يُكمل القصة. يلي ذلك شرح أكثر اكتمالاً.

•

وفر أول curses، في 4BSD، ملف curses.h.

ضمّن كود BSD curses ملفي curses.h و unctrl.h من ملف رأس داخلي curses.ext، حيث اختصر “ext” “externs”.

استخدمت تطبيقات printw و scanw دوال داخلية غير موثقة لمكتبة الإدخال/الإخراج القياسية (_doprnt و _doscan)، لكن لم يعتمد أي شيء في curses.h نفسه على stdio.h.

•

أضاف SVr2 curses الدالة newterm، التي تعتمد على stdio.h لأن نموذج دالتها يستخدم النوع FILE.

أضاف SVr4 curses الدالتين putwin و getwin، اللتين تستخدمان أيضًا stdio.h.

يحدد X/Open Curses هذه الدوال الثلاث جميعها.

SVr4 curses و X/Open Curses لا تطلبان من المطور تضمين stdio.h قبل curses.h. كلاهما يوثق استخدام curses على أنه يتطلب فقط curses.h.

ونتيجة لذلك، يتضمن curses.h القياسي دائمًا stdio.h.

•

X/Open Curses و SVr4 curses غير متسقين فيما يتعلق بـ unctrl.h.

كما ذُكر في curs_util(3X)، يتضمن ncurses unctrl.h من curses.h (كما تفعل SVr4).

•

قد تشير تعليقات X/Open Curses حول term.h و termios.h إلى HP-UX و AIX.

يتضمن HP-UX curses term.h من curses.h للإعلان عن setupterm في curses.h، لكن ncurses و Solaris curses لا يفعلان ذلك.

يتضمن AIX curses term.h و termios.h. مرة أخرى، ncurses و Solaris curses لا يفعلان ذلك.

•

يقول X/Open Curses أن curses.h قد يتضمن term.h، لكنه لا يطلب ذلك.

تستخدم بعض البرامج دوال معلنة في كل من curses.h و term.h، ويجب تضمين كلا ملفي الرأس في نفس وحدة الترجمة.

تتضمن ملفات الرأس المقدمة من ncurses رؤوس المكتبة القياسية المطلوبة لإعلاناتها، لذا يمكن تضمين ملفات رأس ncurses الخاصة بأي ترتيب. من أجل قابلية النقل حتى لأنظمة AIX القديمة، ضمّن curses.h قبل term.h.

•

يقول X/Open Curses “قد يجعل مرئيًا” لأن تضمين ملف رأس لا يجعل بالضرورة جميع الرموز فيه مرئية (ضع في اعتبارك #ifdef وما شابه).

على سبيل المثال، قد يتضمن curses.h الخاص بـ ncurses wchar.h إذا تم تعريف الرمز المناسب، وإذا تم تكوين ncurses لدعم الأحرف العريضة. إذا تم تضمين wchar.h، قد تُجعل رموزه مرئية اعتمادًا على قيمة ماكرو اختبار الميزة _XOPEN_SOURCE.

•

يفرض X/Open Curses تضمين التطبيق لملف رأس واحد من مكتبة C القياسية في حالة خاصة: stdarg.h قبل curses.h لإنشاء نموذج أولي للدوال vw_printw و vw_scanw (بالإضافة إلى vwprintw و vwscanw القديمتين). تأخذ كل من هذه قائمة وسائط متغيرة، معامل va_list، مثل معامل printf(3).

قدم SVr3 curses الدالتين القديمتين، وقدم X/Open Curses الباقي. في ما بين ذلك، وفر SVr4 curses إمكانية أن يتضمن التطبيق إما varargs.h أو stdarg.h. مثلت هذه نهجين متباينين لمعالجة قوائم الوسائط المتغيرة. استخدمت الواجهة الأقدم، varargs.h، مؤشرًا إلى char لمعامل va_list للدوال المتغيرة. لاحقًا، اكتسبت القائمة نوع بياناتها القياسي الخاص، va_list، المُعرّف في stdarg.h، مما مكّن المترجم من التحقق من أنواع المعاملات الفعلية لاستدعاء دالة مقابل تلك الرسمية المعلنة في نموذجها الأولي.

لا تتطلب أي تطبيقات متوافقة مع X/Open Curses من التطبيق تضمين stdarg.h قبل curses.h لأنها إما سمحت بنوع خاص، أو، مثل ncurses، تضمن stdarg.h بنفسها لتوفير واجهة محمولة.