.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993, Mitchum DSouza <m.dsouza@mrc-apu.cam.ac.uk>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH catgets 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
catgets \- استلام رسالة من فهرس الرسائل
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <nl_types.h>\fP
.P
\fBchar *catgets(nl_catd \fP\fIcatalog\fP\fB, int \fP\fIset_number\fP\fB, int \fP\fImessage_number\fP\fB,\fP
\fB              const char *\fP\fImessage\fP\fB);\fP
.fi
.SH الوصف
تقرأ \fBcatgets\fP()  الرسالة \fImessage_number\fP، في المجموعة \fIset_number\fP، من
فهرس الرسائل المُعرّف بـ \fIcatalog\fP، حيث \fIcatalog\fP هو واصف فهرس أُعيد من
استدعاء سابق لـ \fBcatopen\fP(3).  الوسيط الرابع، \fImessage\fP، يشير إلى سلسلة
رسالة مبدئية ستعيدها \fBcatgets\fP()  إذا لم يكن فهرس الرسائل المُعرّف متاحًا
حاليًا.  يُحتوى نص الرسالة في منطقة مخبئية داخلية ويجب نسخه من التطبيق إذا
أُريد حفظه أو تعديله.  سلسلة الإعادة تُنهى دائمًا ببايت فارغ
(\[aq]\[rs]0\[aq]).
.SH "قيمة الإرجاع"
عند النجاح، تعيد \fBcatgets\fP()  مؤشرًا إلى منطقة مخبئية داخلية تحتوي على
سلسلة الرسالة المنتهية بفارغ.  عند الفشل، تعيد \fBcatgets\fP()  القيمة
\fImessage\fP.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBcatgets\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001.
.P
دالة \fBcatgets\fP()  متاحة فقط في libc.so.4.4.4c وما فوق.
.P
يحدد دليل قابلية النقل X/Open لكانون الثاني 1987 إعادة خطأ أكثر دقة: تُعاد
\fImessage\fP إذا لم يكن فهرس الرسائل المُحدد بـ \fIcatalog\fP متاحًا، بينما تُعاد
سلسلة فارغة عندما يكون فهرس الرسائل متاحًا لكنه لا يحتوي على الرسالة
المُحددة.  هاتان الإعادتان المحتملتان للخطأ يبدو أنهما أُهملتا في SUSv2
لصالح إعادة \fImessage\fP دائمًا.
.SH "انظر أيضًا"
\fBcatopen\fP(3), \fBsetlocale\fP(3)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .