الاسم¶

memchr, memrchr, rawmemchr - مسح الذاكرة بحثًا عن محرف

المكتبة¶

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

موجز¶

#include <string.h>

void *memchr(const void s[.n], int c, size_t n);
void *memrchr(const void s[.n], int c, size_t n);

[[deprecated]] void *rawmemchr(const void *s, int c);

memrchr(), rawmemchr():

    _GNU_SOURCE

الوصف¶

تفحص الدالة memchr() أول n بايت من منطقة الذاكرة المشار إليها بـ s بحثًا عن أول ظهور لـ c. يُفسَّر كل من c وبايتات منطقة الذاكرة المشار إليها بـ s على أنها unsigned char.

الدالة memrchr() مماثلة للدالة memchr()، إلا أنها تبحث بالعكس من نهاية n بايت المشار إليها بـ s بدلاً من الأمام من البداية.

الدالة rawmemchr() مشابهة لـ memchr()، لكنها تفترض (أي يعلم المبرمج يقينًا) أن مثيلاً من c يوجد في مكان ما في منطقة الذاكرة التي تبدأ من الموقع المشار إليه بـ s. إذا لم يُعثر على مثيل من c، فالسلوك غير مُحدد. استخدم إما strlen(3) أو memchr(3) بدلاً من ذلك.

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

تُرجع الدالتان memchr() و memrchr() مؤشرًا إلى البايت المطابق أو NULL إذا لم يظهر المحرف في منطقة الذاكرة المُعطاة.

تُرجع الدالة rawmemchr() مؤشراً إلى البايت المطابق.

السمات¶

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

المعايير¶

memchr()

C11, POSIX.1-2008.

memrchr()

rawmemchr()

GNU.

التاريخ¶

memchr()

POSIX.1-2001، C89، SVr4، 4.3BSD.

memrchr()

glibc 2.2.

rawmemchr()

glibc 2.1.

انظر أيضًا¶

bstring(3), ffs(3), memmem(3), strchr(3), strpbrk(3), strrchr(3), strsep(3), strspn(3), strstr(3), wmemchr(3)

ترجمة¶

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

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

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