memory(3C)																memory(3C)

NAME

       memory: memccpy(), memchr(), memcmp(), memcpy(), memmove(), memset(), bcmp(), bcopy(), bzero(), ffs() - memory operations

SYNOPSIS


   Remarks
       and  are  provided solely for portability of BSD applications, and are not recommended for new applications where portability is important.
       For portable applications, use and respectively.  has no portable equivalent.

DESCRIPTION

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

       Definitions for all these functions, the type and the constant are provided in the header file.

       Copy bytes from the object pointed to by
		      s2  into	the  object pointed to by s1, stopping after the first occurrence of byte c has been copied, or after n bytes have
		      been copied, whichever comes first.  If copying takes place  between  objects  that  overlap,  the  behavior  is	undefined.
		      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.

       Locate the first occurrence of
		      c  (converted  to  an  in  the initial n bytes (each interpreted as of the object pointed to by s.  returns a pointer to the
		      located byte, or a NULL pointer if the byte does not occur in the object.

       Compare the first
		      n bytes of the object pointed to by s1 to the first n bytes of the object pointed to by  s2.   returns  an  integer  greater
		      than,  equal to, or less than zero, according to whether the object pointed to by s1 is greater than, equal to, or less than
		      the object pointed to by s2.  The sign of a non-zero return value is determined by the sign of the  difference  between  the
		      values of the first pair of bytes (both interpreted as that differ in the objects being compared.

       Copy	      n  bytes	from  the  object  pointed to by s2 into the object pointed to by s1.  If copying takes place between objects that
		      overlap, the behavior is undefined.  returns the value of s1.

       Copy	      n bytes from the object pointed to by s2 into the object pointed to by s1.  Copying takes place as if the n bytes  from  the
		      object  pointed  to by s2 are first copied into a temporary array of n bytes that does not overlap the objects pointed to by
		      s1 and s2, and then the n bytes from the temporary array are copied into the object pointed to by s1.  returns the value	of
		      s1.

       Copy the value of
		      c (converted to an into each of the first n bytes of the object pointed to by s.	returns the value of s.

       copies	      n bytes from the area pointed to by s1 to the area pointed to by s2.

       Compare the first
		      n  bytes	of  the area pointed to by s1 with the area pointed to by s2.  returns zero if they are identical; non-zero other-
		      wise.  Both areas are assumed to be n bytes in length.

       Clear	      n bytes in the area pointed to by s by setting them to zero.

       Find the first bit set
		      (beginning with the least significant bit) and return the index of that bit.  Bits are numbered starting at one.	 A  return
		      value of 0 indicates that i is zero.

   International Code Set Support
       These functions support only single-byte byte code sets.

WARNINGS

       The functions defined in were previously defined in

FILES

SEE ALSO

       string(3C), thread_safety(5), glossary(9).

STANDARDS CONFORMANCE

																	memory(3C)