isalpha(3)

الاسم
isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, isxdigit, isalnum_l, isalpha_l, isascii_l, isblank_l, iscntrl_l, isdigit_l, isgraph_l, islower_l, isprint_l, ispunct_l, isspace_l, isupper_l, isxdigit_l - دوال تصنيف المحارف

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

موجز
#include <ctype.h>

int isalnum(int c);
int isalpha(int c);
int iscntrl(int c);
int isdigit(int c);
int isgraph(int c);
int islower(int c);
int isprint(int c);
int ispunct(int c);
int isspace(int c);
int isupper(int c);
int isxdigit(int c);

int isascii(int c);
int isblank(int c);

int isalnum_l(int c, locale_t locale);
int isalpha_l(int c, locale_t locale);
int isblank_l(int c, locale_t locale);
int iscntrl_l(int c, locale_t locale);
int isdigit_l(int c, locale_t locale);
int isgraph_l(int c, locale_t locale);
int islower_l(int c, locale_t locale);
int isprint_l(int c, locale_t locale);
int ispunct_l(int c, locale_t locale);
int isspace_l(int c, locale_t locale);
int isupper_l(int c, locale_t locale);
int isxdigit_l(int c, locale_t locale);

int isascii_l(int c, locale_t locale);

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

isascii():
    _XOPEN_SOURCE
        || /* glibc >= 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _SVID_SOURCE

isblank():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

isalnum_l(), isalpha_l(), isblank_l(), iscntrl_l(), isdigit_l(), isgraph_l(), islower_l(), isprint_l(), ispunct_l(), isspace_l(), isupper_l(), isxdigit_l():
    منذ glibc 2.10:
        _XOPEN_SOURCE >= 700
    قبل glibc 2.10:
        _GNU_SOURCE

isascii_l():
    Since glibc 2.10:
        _XOPEN_SOURCE >= 700 && (_SVID_SOURCE || _BSD_SOURCE)
    Before glibc 2.10:
        _GNU_SOURCE

الوصف
تتحقق هذه الدوال مما إذا كان c، الذي يجب أن تكون قيمته من نوع unsigned char أو EOF، يقع ضمن فئة محارف معينة وفقًا للمحلية المحددة. تؤدي الدوال بدون اللاحقة "_l" الفحص بناءً على المحلية الحالية.

تؤدي الدوال ذات اللاحقة "_l" الفحص بناءً على المحلية المحددة بواسطة كائن المحلية locale. يكون سلوك هذه الدوال غير محدد إذا كان locale هو كائن المحلية الخاص LC_GLOBAL_LOCALE (انظر duplocale(3)) أو لم يكن مقبض كائن محلية صالحًا.

تشرح القائمة أدناه تشغيل الدوال بدون اللاحقة "_l"؛ تختلف الدوال ذات اللاحقة "_l" فقط في استخدام كائن المحلية locale بدلاً من المحلية الحالية.

isalnum()
    تتحقق من وجود محرف أبجدي رقمي؛ وهي مكافئة لـ (isalpha(c) || isdigit(c)).

isalpha()
    تتحقق من وجود محرف أبجدي؛ في المحلية القياسية "C"، تكون مكافئة لـ (isupper(c) || islower(c)). في بعض المحليات، قد توجد محارف إضافية تكون isalpha() صحيحة لها—حروف ليست كبيرة ولا صغيرة.

isascii()
    تتحقق مما إذا كان c قيمة unsigned char ذات 7 بتات تتناسب مع مجموعة محارف ASCII.

isblank()
    تفحص عن محرف فراغ؛ أي مسافة أو علامة جدولة.

iscntrl()
    تفحص عن محرف تحكم.

isdigit()
    تفحص عن رقم (0 إلى 9).

isgraph()
    تفحص عن أي محرف قابل للطباعة باستثناء المسافة.

islower()
    تفحص عن محرف صغير.

isprint()
    تفحص عن أي محرف قابل للطباعة بما في ذلك المسافة.

ispunct()
    تفحص عن أي محرف قابل للطباعة ليس مسافة أو محرفًا أبجديًا رقميًا.

isspace()
    تفحص عن محارف المسافة البيضاء. في الإعدادات المحلية "C" و "POSIX"، هذه هي: مسافة، تغذية نموذج ('\f')، سطر جديد ('\n')، إرجاع عربة ('\r')، جدولة أفقية ('\t')، وجدولة عمودية ('\v').

isupper()
    تفحص عن حرف كبير.

isxdigit()
    تفحص عن أرقام ست عشرية، أي واحد من
    0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F.

قيمة الإرجاع
القيم المُرجَعة تكون غير صفرية إذا وقع الحرف c ضمن الصنف المُختبر، وصفرًا إذا لم يقع.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
isalnum(), isalpha(), isascii(), isblank(), iscntrl(), isdigit(), isgraph(), islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit() | سلامة الخيوط | MT-Safe

المعايير

isalnum()
isalpha()
iscntrl()
isdigit()
isgraph()
islower()
isprint()
ispunct()
isspace()
isupper()
isxdigit()
isblank()
    C11, POSIX.1-2008.

isascii()
isalnum_l()
isalpha_l()
isblank_l()
iscntrl_l()
isdigit_l()
isgraph_l()
islower_l()
isprint_l()
ispunct_l()
isspace_l()
isupper_l()
isxdigit_l()
    POSIX.1-2008.

isascii_l()
    GNU.

التاريخ

isalnum()
isalpha()
iscntrl()
isdigit()
isgraph()
islower()
isprint()
ispunct()
isspace()
isupper()
isxdigit()
    C89, POSIX.1-2001.

isblank()
    C99، POSIX.1-2001.

isascii()
    POSIX.1-2001 (XSI).

    يُصنّفها POSIX.1-2008 كمُهمَلة، مُشيرًا إلى أنه لا يمكن استخدامها بشكل محمول في تطبيق مُعرب.

isalnum_l()
isalpha_l()
isblank_l()
iscntrl_l()
isdigit_l()
isgraph_l()
islower_l()
isprint_l()
ispunct_l()
isspace_l()
isupper_l()
isxdigit_l()
    glibc 2.3. POSIX.1-2008.

isascii_l()
    glibc 2.3.

تحذيرات
تتطلب المعايير أن يكون المُعامل c لهذه الدوال إما EOF أو قيمة قابلة للتمثيل في النوع unsigned char؛ وإلا، فإن السلوك غير مُعرّف. إذا كان المُعامل c من النوع char، فيجب تحويله إلى unsigned char، كما في المثال التالي:

    char c;
    ...
    res = toupper((unsigned char) c);

هذا ضروري لأن char قد يكون مكافئًا لـ signed char، وفي هذه الحالة، سيتم تمديد إشارة بايت حيث البتة العليا مُعيَّنة عند التحويل إلى int، مما يُنتج قيمة خارج نطاق unsigned char.

تفاصيل المحارف التي تنتمي لأي صنف تعتمد على المحلية. على سبيل المثال، الدالة isupper() لن تتعرف على حرف A-umlaut (Ä) كحرف كبير في المحلية المبدئية C.

انظر أيضًا
iswalnum(3), iswalpha(3), iswblank(3), iswcntrl(3), iswdigit(3), iswgraph(3), iswlower(3), iswprint(3), iswpunct(3), iswspace(3), iswupper(3), iswxdigit(3), newlocale(3), setlocale(3), toascii(3), tolower(3), toupper(3), uselocale(3), ascii(7), locale(7)

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

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

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