.\" -*- 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 catopen 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
catopen, catclose \- فتح/إغلاق كتالوج رسائل
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <nl_types.h>\fP
.P
\fBnl_catd catopen(const char *\fP\fIname\fP\fB, int \fP\fIflag\fP\fB);\fP
\fBint catclose(nl_catd \fP\fIcatalog\fP\fB);\fP
.fi
.SH الوصف
تفتح الدالة \fBcatopen\fP() كتالوج رسائل وتُعيد واصف كتالوج. يبقى الواصف صالحًا
حتى \fBcatclose\fP() أو \fBexecve\fP(2). إذا استُخدم واصف ملف لتنفيذ واصفات
الكتالوج، فسيُضبط العلم \fBFD_CLOEXEC\fP.
.P
يحدد الوسيط \fIname\fP اسم كتالوج الرسائل الذي سيُفتح. إذا حدد \fIname\fP مسارًا
مطلقًا (أي يحتوي على \[aq]/\[aq])، فإن \fIname\fP يحدد اسم مسار لكتالوج
الرسائل. وإلا، يُستخدم المتغير البيئي \fBNLSPATH\fP مع استبدال \fIname\fP بـ \fB%N\fP
(انظر \fBlocale\fP(7)). غير محدد ما إذا كان \fBNLSPATH\fP سيُستخدم عندما تملك
العملية صلاحيات الجذر. إذا لم يوجد \fBNLSPATH\fP في البيئة، أو إذا تعذر فتح
كتالوج رسائل في أي من المسارات المحددة به، فسيُستخدم مسار محدد بالتنفيذ. قد
يعتمد هذا المسار المبدئي الأخير على إعداد لغة \fBLC_MESSAGES\fP عندما يكون
الوسيط \fIflag\fP هو \fBNL_CAT_LOCALE\fP وعلى المتغير البيئي \fBLANG\fP عندما يكون
الوسيط \fIflag\fP هو 0. قد يُبطل تغيير جزء \fBLC_MESSAGES\fP من اللغة واصفات
الكتالوج المفتوحة.
.P
يُستخدم الوسيط \fIflag\fP لـ \fBcatopen\fP() للإشارة إلى مصدر اللغة المستخدمة. إذا
ضُبط على \fBNL_CAT_LOCALE\fP، فسيستخدم إعداد اللغة الحالي لـ
\fBLC_MESSAGES\fP. وإلا، فسيستخدم المتغير البيئي \fBLANG\fP.
.P
تغلق الدالة \fBcatclose\fP() كتالوج الرسائل المُعرّف بـ \fIcatalog\fP. تُبطل أي
مراجع لاحقة لكتالوج الرسائل المُعرّف بـ \fIcatalog\fP.
.SH "قيمة الإرجاع"
تُعيد الدالة \fBcatopen\fP() واصف كتالوج رسائل من النوع \fInl_catd\fP عند
النجاح. عند الفشل، تُعيد \fI(nl_catd)\ \-1\fP وتضبط \fIerrno\fP للإشارة إلى
الخطأ. تشمل قيم الأخطاء المحتملة جميع القيم الممكنة لاستدعاء \fBopen\fP(2).
.P
تُعيد الدالة \fBcatclose\fP() 0 عند النجاح، أو \-1 عند الفشل.
.SH البيئة
.TP 
\fBLC_MESSAGES\fP
قد يكون مصدر إعداد لغة \fBLC_MESSAGES\fP، وبالتالي يحدد اللغة المستخدمة إذا
ضُبط \fIflag\fP على \fBNL_CAT_LOCALE\fP.
.TP 
\fBLANG\fP
اللغة المستخدمة إذا كان \fIflag\fP هو 0.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBcatopen\fP()
T}	سلامة الخيوط	بيئة آمنة لتعدد الخيوط (MT\-Safe)
T{
.na
.nh
\fBcatclose\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH الإصدارات
.\" (Compare
.\" .B MCLoadAll
.\" below.)
.\" .SS Linux notes
.\" These functions are available for Linux since libc 4.4.4c.
.\" In the case of linux libc4 and libc5, the catalog descriptor
.\" .I nl_catd
.\" is a
.\" .BR mmap (2)'ed
.\" area of memory and not a file descriptor.
.\" The
.\" .I flag
.\" argument to
.\" .BR catopen ()
.\" should be either
.\" .B MCLoadBySet
.\" (=0) or
.\" .B MCLoadAll
.\" (=1).
.\" The former value indicates that a set from the catalog is to be
.\" loaded when needed, whereas the latter causes the initial call to
.\" .BR catopen ()
.\" to load the entire catalog into memory.
.\" The default search path varies, but usually looks at a number of places below
.\" .I /etc/locale
.\" and
.\" .IR /usr/lib/locale .
ما سبق هو وصف POSIX.1. قيمة glibc لـ \fBNL_CAT_LOCALE\fP هي 1. يختلف المسار
المبدئي، لكنه عادةً يبحث في عدد من الأماكن أسفل \fI/usr/share/locale\fP.
.SH المعايير
POSIX.1\-2008.
.SH التاريخ
.\" In XPG 1987, Vol.\& 3 it says:
.\" .I "The flag argument of catopen is reserved for future use"
.\" .IR "and should be set to 0" .
.\"
.\" It is unclear what the source was for the constants
.\" .B MCLoadBySet
.\" and
.\" .B MCLoadAll
.\" (see below).
POSIX.1\-2001.
.SH "انظر أيضًا"
\fBcatgets\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 .