.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993, David Metcalfe <david@prism.demon.co.uk>
.\" Copyright 2004-2007, Michael Kerrisk <mtk.manpages@gmail.com>
.\" 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 setenv 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
setenv \- تغيير أو إضافة متغير بيئة
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <stdlib.h>\fP
.P
\fBint setenv(const char *\fP\fIname\fP\fB, const char *\fP\fIvalue\fP\fB, int \fP\fIoverwrite\fP\fB);\fP
\fBint unsetenv(const char *\fP\fIname\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBsetenv\fP()، \fBunsetenv\fP():
.nf
    _POSIX_C_SOURCE >= 200112L
        || /* glibc <= 2.19: */ _BSD_SOURCE
.fi
.SH الوصف
تضيف الدالة \fBsetenv\fP() المتغير \fIname\fP إلى البيئة بالقيمة \fIvalue\fP، إذا لم
يكن \fIname\fP موجودًا بالفعل. إذا كان \fIname\fP موجودًا في البيئة، فتُغيّر قيمته
إلى \fIvalue\fP إذا كان \fIoverwrite\fP غير صفري؛ إذا كان \fIoverwrite\fP صفريًا، فلا
تُغيّر قيمة \fIname\fP (وتُرجع \fBsetenv\fP() حالة نجاح). تُنشئ هذه الدالة نسخًا
من السلاسل المحارف المشار إليها بواسطة \fIname\fP و\fIvalue\fP (على عكس
\fBputenv\fP(3)).
.P
تحذف الدالة \fBunsetenv\fP() المتغير \fIname\fP من البيئة. إذا لم يكن \fIname\fP
موجودًا في البيئة، فتنجح الدالة، وتبقى البيئة دون تغيير.
.SH "قيمة الإرجاع"
تُرجع الدالتان \fBsetenv\fP() و\fBunsetenv\fP() صفرًا عند النجاح، أو \-1 عند الخطأ،
مع ضبط \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEINVAL\fP
\fIname\fP هو NULL، أو يشير إلى سلسلة محارف طولها 0، أو يحتوي على حرف
\[aq]=\[aq].
.TP 
\fBENOMEM\fP
ذاكرة غير كافية لإضافة متغير جديد إلى البيئة.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBsetenv\fP(),
\fBunsetenv\fP()
T}	سلامة الخيوط	MT\-Unsafe const:env
.TE
.SH المعايير
POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001، 4.3BSD.
.P
قبل glibc 2.2.2، كان النموذج الأولي لـ \fBunsetenv\fP() يُرجع \fIvoid\fP؛ تتبع
إصدارات glibc الأحدث النموذج الأولي المتوافق مع POSIX.1 الموضح في الملخص.
.SH تحذيرات
لا يتطلب POSIX.1 أن تكون \fBsetenv\fP() أو \fBunsetenv\fP() قابلة لإعادة الدخول.
.SH العلل
يحدد POSIX.1 أنه إذا احتوى \fIname\fP على حرف \[aq]=\[aq]، فيجب أن تفشل
\fBsetenv\fP() مع الخطأ \fBEINVAL\fP؛ ومع ذلك، سمحت إصدارات glibc قبل glibc 2.3.4
بعلامة \[aq]=\[aq] في \fIname\fP.
.SH "انظر أيضًا"
\fBclearenv\fP(3)، \fBgetenv\fP(3)، \fBputenv\fP(3)، \fBenviron\fP(7)
.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 .