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 pro‐
vided 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 copy‐
ing takes place between objects that overlap, the behav‐
ior 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 inter‐
preted 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 inte‐
ger 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 otherwise. 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
FILESSEE ALSOstring(3C), thread_safety(5), glossary(9).
STANDARDS CONFORMANCEmemory(3C)