HP 3000 Manuals HP 3000 Manuals
memccpy
Copies characters from one memory location to another until a specified
character is found or until the specified count is reached.
Syntax
#include <memory.h>
char *memccpy (char *s1, char *s2, int c, int n)
Parameters
s1 A pointer to the target string.
s2 A pointer to the source string.
c The character used to signal the end of the source string.
n The number of bytes to be copied.
Return Values
x A character pointer to the first character in s1 after c.
NULL The c parameter was not found in s2.
Description
The memccpy function copies characters from memory area s2 into s1,
stopping after the first occurrence of c has been copied or after n
characters have been copied, whichever comes first. It returns a pointer
to the character after the copy of c in s1, or a null pointer if c was
not found in the first n characters of s2. This function operates as
efficiently as possible on memory areas (arrays of characters bound by a
count that are not terminated by a null character). There is no check
for the overflow of the destination memory area. Character movement is
performed differently in different implementations. Therefore, avoid
overlapping moves.
See Also
memcpy(), memcmp(), memchr()