catgets(3)

الاسم
catgets - استلام رسالة من فهرس الرسائل

المكتبة
مكتبة سي المعيارية (libc، -lc)

موجز
#include <nl_types.h>

char *catgets(nl_catd catalog, int set_number, int message_number,
              const char *message);

الوصف
تقرأ catgets() الرسالة message_number، في المجموعة set_number، من فهرس الرسائل المُعرّف بـ catalog، حيث catalog هو واصف فهرس أُعيد من استدعاء سابق لـ catopen(3). الوسيط الرابع، message، يشير إلى سلسلة رسالة مبدئية ستعيدها catgets() إذا لم يكن فهرس الرسائل المُعرّف متاحًا حاليًا. يُحتوى نص الرسالة في منطقة مخبئية داخلية ويجب نسخه من التطبيق إذا أُريد حفظه أو تعديله. سلسلة الإعادة تُنهى دائمًا ببايت فارغ ('\0').

قيمة الإرجاع
عند النجاح، تعيد catgets() مؤشرًا إلى منطقة مخبئية داخلية تحتوي على سلسلة الرسالة المنتهية بفارغ. عند الفشل، تعيد catgets() القيمة message.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
catgets() | سلامة الخيوط | MT-Safe

المعايير
POSIX.1-2008.

التاريخ
POSIX.1-2001.

دالة catgets() متاحة فقط في libc.so.4.4.4c وما فوق.

يحدد دليل قابلية النقل X/Open لكانون الثاني 1987 إعادة خطأ أكثر دقة: تُعاد message إذا لم يكن فهرس الرسائل المُحدد بـ catalog متاحًا، بينما تُعاد سلسلة فارغة عندما يكون فهرس الرسائل متاحًا لكنه لا يحتوي على الرسالة المُحددة. هاتان الإعادتان المحتملتان للخطأ يبدو أنهما أُهملتا في SUSv2 لصالح إعادة message دائمًا.

انظر أيضًا
catopen(3), setlocale(3)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.