canonicalize_file_name(3)

الاسم
canonicalize_file_name - إرجاع مسار المطلق المُقنن

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

موجز
#define _GNU_SOURCE         /* See feature_test_macros(7) */
#include <stdlib.h>

char *canonicalize_file_name(const char *path);

الوصف
الدالة canonicalize_file_name() تُرجع سلسلة منتهية بقيمة خالية تحتوي على مسار المطلق المُقنن المُطابق لـ path. في السلسلة المُرجعة، تُحل الروابط الرمزية، وكذلك مكونات المسار . و ... تُستبدل أحرف الشرطة المائلة المتتالية (/) بشرطة مائلة واحدة.

السلسلة المُرجعة تُخصص ديناميكيًا بواسطة canonicalize_file_name() ويجب على المُستدعي تحريرها باستخدام free(3) عندما لا تكون مطلوبة بعد الآن.

الاستدعاء canonicalize_file_name(path) يُعادل الاستدعاء:

    realpath(path, NULL);

قيمة الإرجاع
عند النجاح، تُرجع canonicalize_file_name() سلسلة منتهية بقيمة خالية. عند الخطأ (مثلًا، مكون مسار غير قابل للقراءة أو غير موجود)، تُرجع canonicalize_file_name() NULL وتُعين errno للإشارة إلى الخطأ.

الأخطاء
راجع realpath(3).

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

المعايير
GNU.

انظر أيضًا
readlink(2), realpath(3)

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

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

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