الاسم¶

wordexp, wordfree - أداء توسيع الكلمات مثل قشرة posix

المكتبة¶

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

موجز¶

#include <wordexp.h>

int wordexp(const char *restrict s, wordexp_t *restrict p, int flags);
void wordfree(wordexp_t *p);

wordexp()، wordfree():

    _XOPEN_SOURCE

الوصف¶

الدالة wordexp() تؤدي توسيعًا شبيهًا بالقشرة لسلسلة المحارف s وتُعيد النتيجة في البنية المشار إليها بواسطة p. نوع البيانات wordexp_t هو بنية تحتوي على الأقل على الحقول we_wordc وwe_wordv وwe_offs. الحقل we_wordc هو من نوع size_t يُعطي عدد الكلمات في توسيع s. الحقل we_wordv هو char ** يُشير إلى مصفوفة الكلمات التي وُجدت. الحقل we_offs من نوع size_t يُستخدم أحيانًا (اعتمادًا على flags، انظر أدناه) للإشارة إلى عدد العناصر الأولية في مصفوفة we_wordv التي ينبغي ملؤها بقيم NULL.

الدالة wordfree() تُحرر الذاكرة المُخصصة مرة أخرى. بشكل أدق، لا تُحرر وسيطها، بل تُحرر المصفوفة we_wordv وسلاسل المحارف التي تُشير إليها.

قيمة الإرجاع¶

عند النجاح، تُرجع wordexp() 0. عند الفشل، تُرجع wordexp() إحدى القيم غير الصفرية التالية:

WRDE_BADCHAR

ظهور غير قانوني لسطر جديد أو أحد الرموز |, &, ;, <, >, (, ), {, }.

WRDE_BADVAL

تمت الإشارة إلى متغير شل غير مُعرَّف، وأخبرتنا العَلَمة WRDE_UNDEF باعتبار هذا خطأً.

WRDE_CMDSUB

طُلب استبدال الأوامر، لكن العَلَمة WRDE_NOCMD أخبرتنا باعتبار هذا خطأً.

WRDE_NOSPACE

نفدت الذاكرة.

WRDE_SYNTAX

خطأ في نحو الشل، مثل أقواس غير متوازنة أو علامات اقتباس غير متطابقة.

السمات¶

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

في الجدول أعلاه، يشير utent في race:utent إلى أنه إذا استُخدمت أي من الدوال setutent(3) أو getutent(3) أو endutent(3) بالتوازي في خيوط مختلفة من برنامج، فقد تحدث سباقات بيانات. تستدعي wordexp() تلك الدوال، لذا نستخدم race:utent لتذكير المستخدمين.

المعايير¶

POSIX.1-2008.

التاريخ¶

POSIX.1-2001. glibc 2.1.

أمثلة¶

مخرج البرنامج المثالي التالي يقارب مخرج "ls [a-c]*.c".

#include <stdio.h>
#include <stdlib.h>
#include <wordexp.h>
int
main(void)
{


    wordexp_t p;


    char **w;


    wordexp("[a-c]*.c", &p, 0);


    w = p.we_wordv;


    for (size_t i = 0; i < p.we_wordc; i++)


        printf("%s\n", w[i]);


    wordfree(&p);


    exit(EXIT_SUCCESS);
}

انظر أيضًا¶

fnmatch(3), glob(3)

ترجمة¶

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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