cfree(3)

الاسم
cfree - تحرير الذاكرة المخصصة

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

موجز

#include <stdlib.h>

/* في SunOS 4 */
int cfree(void *ptr);

/* في glibc أو FreeBSD libcompat */
void cfree(void *ptr);

/* في SCO OpenServer */
void cfree(unsigned int n, unsigned int size;
           char ptr[size * n], unsigned int n, unsigned int size);

/* في Solaris watchmalloc.so.1 */
void cfree(size_t n, size_t size;
           void ptr[size * n], size_t n, size_t size);

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

cfree():
    منذ glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 وما قبله:
        _BSD_SOURCE || _SVID_SOURCE

الوصف
لا ينبغي استخدام هذه الدالة أبدًا. استخدم free(3) بدلاً منها. ابتداءً من glibc 2.26، أُزيلت من glibc.

  cfree بوسيط واحد
في glibc، الدالة cfree() مرادف لـ free(3)، "أُضيفت للتوافق مع SunOS".

الأنظمة الأخرى تحتوي دوال أخرى بهذا الاسم. الإعلان يكون أحيانًا في <stdlib.h> وأحيانًا في <malloc.h>.

  cfree بثلاث وسائط
بعض إصدارات SCO وSolaris تحتوي مكتبات malloc مع cfree() بثلاث وسائط، ظاهريًا كتناظر لـ calloc(3).

إذا احتجتها أثناء نقل شيء، أضف

    #define cfree(p, n, s) free((p))

إلى ملفك.

سؤال متكرر هو "هل يمكنني استخدام free(3) لتحرير الذاكرة المخصصة بواسطة calloc(3)، أم أحتاج cfree()؟" الإجابة: استخدم free(3).

دليل SCO يكتب: "إجراء cfree مُقدم للامتثال لمعيار iBCSe2 ويستدعي free ببساطة. وسيطا n وsize لـ cfree غير مستخدمين."

قيمة الإرجاع
إصدار SunOS من cfree() (وهو مرادف لـ free(3)) يُرجع 1 عند النجاح و0 عند الفشل. في حالة الخطأ، يُضبط errno على EINVAL: قيمة ptr لم تكن مؤشرًا إلى كتلة خُصصت سابقًا بواسطة أحد الإجراءات في عائلة malloc(3).

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

الإصدارات
إصدار cfree() ذو الـ3 وسائط كما يُستخدم بواسطة SCO يتوافق مع معيار iBCSe2: مواصفات التوافق الثنائي Intel386، الإصدار 2.

المعايير
لا شيء.

التاريخ
أُزيل في glibc 2.26.

انظر أيضًا
malloc(3)

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

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

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