Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer


Copies characters from a buffer.

void *_memccpy(
   void *dest,
   const void *src,
   int c,
   size_t count 


Pointer to destination.
Pointer to source.
Last character to copy.
Number of characters.

Return Value

If the character c is copied, _memccpy returns a pointer to the char in dest that immediately follows the character. If c is not copied, it returns NULL.


The _memccpy function copies 0 or more chars of src to dest, halting when the character c has been copied or when count chars have been copied, whichever comes first.

Security Note   Make sure that the destination buffer is the same size or larger than the source buffer. For more information, see Avoiding Buffer Overruns.


Routine Required header Compatibility
_memccpy <memory.h> or <string.h> Win 98, Win Me, Win NT, Win 2000, Win XP

For additional compatibility information, see Compatibility in the Introduction.


All versions of the C run-time libraries.


// crt_memccpy.c

#include <memory.h>
#include <stdio.h>
#include <string.h>

char string1[60] = "The quick brown dog jumps over the lazy fox";

int main( void )
   char buffer[61];
   char *pdest;

   printf( "Function: _memccpy 60 characters or to character 's'\n" );
   printf( "Source: %s\n", string1 );
   pdest = _memccpy( buffer, string1, 's', 60 );
   *pdest = '\0';
   printf( "Result: %s\n", buffer );
   printf( "Length: %d characters\n", strlen( buffer ) );


Function: _memccpy 60 characters or to character 's'
Source: The quick brown dog jumps over the lazy fox
Result: The quick brown dog jumps
Length: 25 characters

See Also

Buffer Manipulation Routines | memchr | memcmp | memcpy | memset | Run-Time Routines and .NET Framework Equivalents

© 2015 Microsoft