5.5 memccpy—copy memory regions with end-token check

Synopsis

     #include <string.h>
     void* memccpy(void *out, const void *in,
         int endchar, size_t n);
     

Description
This function copies up to n bytes from the memory region pointed to by in to the memory region pointed to by out. If a byte matching the endchar is encountered, the byte is copied and copying stops.

If the regions overlap, the behavior is undefined.

Returns
memccpy returns a pointer to the first byte following the endchar in the out region. If no byte matching endchar was copied, then NULL is returned.

Portability
memccpy is a GNU extension.

memccpy requires no supporting OS subroutines.