strstr(3)

الاسم
strstr, strcasestr - تحديد موقع سلسلة فرعية

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

موجز
#include <string.h>

char *strstr(const char *haystack, const char *needle);

#define _GNU_SOURCE         /* انظر feature_test_macros(7) */
#include <string.h>

char *strcasestr(const char *haystack, const char *needle);

الوصف
الدالة strstr() تجد أول ظهور للسلسلة الفرعية needle في السلسلة haystack. لا تُقارن البايتات الخالية الختامية ('\0').

يكافئ

    memmem(haystack, strlen(haystack), needle, strlen(needle))

الدالة strcasestr() تشبه strstr()، لكنها تتجاهل حالة الأحرف في كلا المعاملين.

قيمة الإرجاع
تُرجع هذه الدوال مؤشرًا إلى بداية السلسلة الفرعية المُحددة، أو NULL إذا لم تُوجد السلسلة الفرعية.

إذا كانت needle سلسلة فارغة، فإن القيمة المُرجعة تكون دائمًا haystack نفسها.

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

المعايير

strstr()
    C11, POSIX.1-2008.

strcasestr()
    GNU.

التاريخ

strstr()
    POSIX.1-2001، C89.

strcasestr()
    GNU.

انظر أيضًا
memchr(3), memmem(3), strcasecmp(3), strchr(3), string(3), strpbrk(3), strsep(3), strspn(3), strtok(3), wcsstr(3)

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

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

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