memmem(3) — Linux manual page

memmem(3)               Library Functions Manual               memmem(3)

NAME         top

       memmem - locate a substring

LIBRARY         top

       Standard C library (libc, -lc)

SYNOPSIS         top

       #define _GNU_SOURCE         /* See feature_test_macros(7) */
       #include <string.h>

       void *memmem(const void haystack[.haystacklen], size_t haystacklen,
                    const void needle[.needlelen], size_t needlelen);

DESCRIPTION         top

       The memmem() function finds the start of the first occurrence of
       the substring needle of length needlelen in the memory area
       haystack of length haystacklen.

RETURN VALUE         top

       The memmem() function returns a pointer to the beginning of the
       substring, or NULL if the substring is not found.

ATTRIBUTES         top

       For an explanation of the terms used in this section, see
       attributes(7).

       ┌──────────────────────────────────────┬───────────────┬─────────┐
       │Interface                             │ Attribute     │ Value   │
       ├──────────────────────────────────────┼───────────────┼─────────┤
       │memmem()                              │ Thread safety │ MT-Safe │
       └──────────────────────────────────────┴───────────────┴─────────┘

STANDARDS         top

       None.

HISTORY         top

       musl libc 0.9.7; FreeBSD 6.0, OpenBSD 5.4, NetBSD, Illumos.

BUGS         top

       In glibc 2.0, if needle is empty, memmem() returns a pointer to
       the last byte of haystack.  This is fixed in glibc 2.1.

SEE ALSO         top

       bstring(3), strstr(3)

Linux man-pages 6.04           2023-03-30                      memmem(3)

Pages that refer to this page: bstring(3),  memchr(3),  strstr(3)

HTML rendering created 2023-06-24 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.