ILE C/C++ Run-Time Library Functions


memcpy() -- Copy Bytes

Format

#include <string.h>
void *memcpy(void *dest, const void *src, size_t count);

Language Level: ANSI

Threadsafe: Yes.

Description

The memcpy() function copies count bytes of src to dest. The behavior is undefined if copying takes place between objects that overlap. The memmove() function allows copying between objects that may overlap.

Return Value

The memcpy() function returns a pointer to dest.

Example that uses memcpy()

This example copies the contents of source to target.


#include <string.h>
#include <stdio.h>
 
#define MAX_LEN 80
 
char source[ MAX_LEN ] = "This is the source string";
char target[ MAX_LEN ] = "This is the target string";
 
int main(void)
{
  printf( "Before memcpy, target is \"%s\"\n", target );
  memcpy( target, source, sizeof(source));
  printf( "After memcpy, target becomes \"%s\"\n", target );
}
 
/*********************  Expected output:  ************************
 
Before memcpy, target is "This is the target string"
After memcpy, target becomes "This is the source string"
*/

Related Information


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]