1BCOPY(P)                   POSIX Programmer's Manual                  BCOPY(P)
2
3
4

NAME

6       bcopy - memory operations (LEGACY)
7

SYNOPSIS

9       #include <strings.h>
10
11       void bcopy(const void *s1, void *s2, size_t n);
12
13

DESCRIPTION

15       The  bcopy() function shall copy n bytes from the area pointed to by s1
16       to the area pointed to by s2.
17
18       The bytes are copied correctly even if the area pointed to by s1  over‐
19       laps the area pointed to by s2.
20

RETURN VALUE

22       The bcopy() function shall not return a value.
23

ERRORS

25       No errors are defined.
26
27       The following sections are informative.
28

EXAMPLES

30       None.
31

APPLICATION USAGE

33       The memmove() function is preferred over this function.
34
35       The following are approximately equivalent (note the order of the argu‐
36       ments):
37
38
39              bcopy(s1,s2,n) ~= memmove(s2,s1,n)
40
41       For maximum portability, it is recommended to replace the function call
42       to bcopy() as follows:
43
44
45              #define bcopy(b1,b2,len) (memmove((b2), (b1), (len)), (void) 0)
46

RATIONALE

48       None.
49

FUTURE DIRECTIONS

51       This function may be withdrawn in a future version.
52

SEE ALSO

54       memmove()  ,  the  Base  Definitions  volume  of  IEEE Std 1003.1-2001,
55       <strings.h>
56

58       Portions of this text are reprinted and reproduced in  electronic  form
59       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
60       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
61       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
62       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
63       event of any discrepancy between this version and the original IEEE and
64       The Open Group Standard, the original IEEE and The Open Group  Standard
65       is  the  referee document. The original Standard can be obtained online
66       at http://www.opengroup.org/unix/online.html .
67
68
69
70IEEE/The Open Group                  2003                             BCOPY(P)
Impressum