strcasecmp(3)

الاسم
strcasecmp, strncasecmp - مقارنة سلسلتي محارف متجاهلاً حالة الأحرف

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

موجز
#include <strings.h>

int strcasecmp(const char *s1, const char *s2);
int strncasecmp(const char s1[], const char s2[], size_t n);

الوصف
الدالة strcasecmp() تُجري مقارنة بايت ببايت لسلسلتي المحارف s1 و s2، متجاهلة حالة الأحرف. تُرجع عددًا صحيحًا أقل من، أو يساوي، أو أكبر من الصفر إذا وُجدت s1، على التوالي، أقل من، أو مطابقة، أو أكبر من s2.

الدالة strncasecmp() مماثلة، باستثناء أنها تُقارن ما لا يزيد عن n بايت من s1 و s2.

قيمة الإرجاع
الدالتان strcasecmp() و strncasecmp() تُرجعان عددًا صحيحًا أقل من، أو يساوي، أو أكبر من الصفر إذا وُجدت s1، بعد تجاهل حالة الأحرف، أقل من، أو مطابقة، أو أكبر من s2، على التوالي.

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

المعايير
POSIX.1-2008.

التاريخ
4.4BSD، POSIX.1-2001.

الدالتان strcasecmp() و strncasecmp() ظهرتا أولاً في 4.4BSD، حيث أُعلنتا في <string.h>. وبالتالي، لأسباب التوافق التاريخي، ملف الرأس glibc <string.h> يُعلن أيضًا هاتين الدالتين، إذا عُرّف كلي اختبار الميزة _DEFAULT_SOURCE (أو، في glibc 2.19 والإصدارات الأقدم، _BSD_SOURCE).

معيار POSIX.1-2008 يقول عن هاتين الدالتين:

    عندما تكون فئة LC_CTYPE للإعدادات المحلية المستخدمة من الإعدادات المحلية POSIX، تتصرف هاتان الدالتان كما لو أن السلاسل حُوّلت إلى أحرف صغيرة ثم أُجريت مقارنة بايت. وإلا، فالنتائج غير محددة.

انظر أيضًا
memcmp(3)، strcmp(3)، strcoll(3)، string(3)، strncmp(3)، wcscasecmp(3)، wcsncasecmp(3)

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

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

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