.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2001, John Levon <moz@compsoc.man.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 clearenv 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
clearenv \- امسح البيئة
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <stdlib.h>\fP
.P
\fBint clearenv(void);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBclearenv\fP():
.nf
    /* glibc >= 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
.fi
.SH الوصف
الدالة \fBclearenv\fP() تمسح البيئة من كل أزواج الاسم\-القيمة وتضبط قيمة المتغير
الخارجي \fIenviron\fP إلى NULL. بعد هذه الاستدعاء، يمكن إضافة متغيرات جديدة إلى
البيئة باستخدام \fBputenv\fP(3) و\fBsetenv\fP(3).
.SH "قيمة الإرجاع"
.\" Most versions of UNIX return -1 on error, or do not even have errors.
.\" glibc info and the Watcom C library document "a nonzero value".
الدالة \fBclearenv\fP() تُرجع صفرًا عند النجاح، وقيمة غير صفرية عند الفشل.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBclearenv\fP()
T}	سلامة الخيوط	MT\-Unsafe const:env
.TE
.SH المعايير
.TP 
\fBputenv\fP()
POSIX.1\-2008.
.TP 
\fBclearenv\fP()
لا شيء.
.SH التاريخ
.TP 
\fBputenv\fP()
glibc 2.0.  POSIX.1\-2001.
.TP 
\fBclearenv\fP()
glibc 2.0.
.P
متغيرات UNIX مختلفة (DG/UX, HP\-UX, QNX, ...). POSIX.9 (روابط لـ
FORTRAN77). لم يقبل POSIX.1\-1996 \fBclearenv\fP() و\fBputenv\fP(3)، لكنه غير رأيه
وجدول هذه الدوال لإصدار لاحق من هذا المعيار (انظر \[sc]B.4.6.1). ومع ذلك،
يضيف POSIX.1\-2001 فقط \fBputenv\fP(3)، ورفض \fBclearenv\fP().
.SH ملاحظات
على الأنظمة حيث \fBclearenv\fP() غير متوفرة، التعيين
.P
.in +4n
.EX
environ = NULL;
.EE
.in
.P
سيفي بالغرض غالبًا.
.P
الدالة \fBclearenv\fP() قد تكون مفيدة في التطبيقات الواعية بالأمان التي تريد
التحكم بدقة في البيئة التي تُمرر إلى البرامج المنفذة باستخدام
\fBexec\fP(3). ستفعل التطبيق ذلك بمسح البيئة أولاً ثم إضافة متغيرات بيئة محددة.
.P
لاحظ أن التأثير الرئيسي لـ \fBclearenv\fP() هو ضبط قيمة المؤشر \fBenviron\fP(7)؛
هذه الدالة لا تمسح محتويات المخازن المؤقتة التي تحتوي على تعريفات البيئة.
.P
.\" .P
.\" HP-UX has a ENOMEM error return.
صفحات الدليل لـ DG/UX وTru64 تكتب: إذا عُدل \fIenviron\fP بأي شيء غير دوال
\fBputenv\fP(3) أو \fBgetenv\fP(3) أو \fBclearenv\fP()، فإن \fBclearenv\fP() سترجع خطأ
وستبقى بيئة العملية دون تغيير.
.SH "انظر أيضًا"
\fBgetenv\fP(3), \fBputenv\fP(3), \fBsetenv\fP(3), \fBunsetenv\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 .