mempcpy   (3) manpage
mempcpy
3
2003-11-11
GNU
Linux Programmer's Manual
  • NAME
      mempcpy, wmempcpy  - copy memory area
  • SYNOPSIS
      
       #define _GNU_SOURCE
      
       #include <string.h>
      
       void *mempcpy(void * dest , const void * src , size_t  n );
      

      #define _GNU_SOURCE

      #include <wchar.h>

      wchar_t *wmempcpy(wchar_t * dest , const wchar_t * src , size_t n );
  • DESCRIPTION
      The
      mempcpy() function is nearly identical to the
      memcpy() function.  It copies
      n
      bytes from the object beginning at
      src
      into the object pointed to by
      dest.  
      But instead of returning the value of
      dest
      it returns a pointer to the byte following the last written byte.



      This function is useful in situations where a number of objects
      shall be copied to consecutive memory positions.



      The
      wmempcpy() function is identical but takes wchar_t type arguments and copies
      n
      wide characters.
  • RETURN VALUE
      dest + n .
  • EXAMPLE
      
      void *
      combine (void *o1, size_t s1, void *o2, size_t s2) {
           void *result = malloc(s1 + s2);
           if (result != NULL)
                mempcpy(mempcpy(result, o1, s1), o2, s2);
           return result;
      }
      
  • CONFIRMING TO
      This function is a GNU extension.
  • SEE ALSO
Current Users: 19 © 1999-2006 Linux.com.hk PenguinSoft
All trademarks and copyrights on this page are owned by their respective companies. Linux is a trademark of Linus Torvalds.