memcpy(3C)

NAME

     memory, memccpy, memchr, memcmp, memcpy, memmove,  memset  -
     memory operations

SYNOPSIS

     #include <string.h>

     void *memccpy(void *s1, const void *s2, int c, size_t n);

     void *memchr(const void *s, int c, size_t n);

     int memcmp(const void *s1, const void *s2, size_t n);

     void *memcpy(void *s1, const void *s2, size_t n);

     void *memmove(void *s1, const void *s2, size_t n);

     void *memset(void *s, int c, size_t n);

  ISO C++
     #include <string.h>

     const void *memchr(const void *s, int c, size_t n);

     #include <cstring>

     void *std::memchr(void *s, int c, size_t n);

DESCRIPTION

     These functions operate as efficiently as possible on memory
     areas (arrays of bytes bounded by a count, not terminated by
     a null character).  They do not check for  the  overflow  of
     any receiving memory area.

     The memccpy() function copies bytes from memory area s2 into
     s1,  stopping  after the first occurrence of c (converted to
     an unsigned char) has been copied, or  after  n  bytes  have
     been  copied, whichever comes first. It returns a pointer to
     the byte after the copy of c in s1, or a null pointer  if  c
     was not found in the first n bytes of s2.

     The  memchr()  function  returns  a  pointer  to  the  first
     occurrence of c (converted to an unsigned char) in the first
     n bytes (each interpreted as an  unsigned  char)  of  memory
     area s, or a null pointer if c does not occur.

     The memcmp() function compares its arguments, looking at the
     first  n  bytes  (each interpreted as an unsigned char), and
     returns an integer less than, equal to, or greater  than  0,
     according as s1 is lexicographically less than, equal to, or
     greater than s2 when taken to be unsigned characters.

     The memcpy() function copies n bytes from memory area s2  to
     s1.  It returns s1.

     The memmove() function copies n bytes from memory  areas  s2
     to s1.  Copying between objects that overlap will take place
     correctly. It returns s1.

     The memset() function sets the first n bytes in memory  area
     s  to  the  value  of c (converted to an unsigned char).  It
     returns s.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|

SEE ALSO

     string(3C), attributes(5)