Debian Codegraph @

upstream/debian-trixie/man3/memccpy.3

raw
1 '\" t
2 .\" Copyright 1993 David Metcalfe ([email protected])
3 .\"
4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
5 .\"
6 .\" References consulted:
7 .\" Linux libc source code
8 .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
9 .\" 386BSD man pages
10 .\" Modified Sat Jul 24 18:57:24 1993 by Rik Faith ([email protected])
11 .TH memccpy 3 2024-05-02 "Linux man-pages 6.9.1"
12 .SH NAME
13 memccpy \- copy memory area
14 .SH LIBRARY
15 Standard C library
16 .RI ( libc ", " \-lc )
17 .SH SYNOPSIS
18 .nf
19 .B #include <string.h>
20 .P
21 .BI "void *memccpy(void " dest "[restrict ." n "], const void " src "[restrict ." n ],
22 .BI " int " c ", size_t " n );
23 .fi
24 .SH DESCRIPTION
25 The
26 .BR memccpy ()
27 function copies no more than
28 .I n
29 bytes from
30 memory area
31 .I src
32 to memory area
33 .IR dest ,
34 stopping when the
35 character
36 .I c
37 is found.
38 .P
39 If the memory areas overlap, the results are undefined.
40 .SH RETURN VALUE
41 The
42 .BR memccpy ()
43 function returns a pointer to the next character
44 in
45 .I dest
46 after
47 .IR c ,
48 or NULL if
49 .I c
50 was not found in the
51 first
52 .I n
53 characters of
54 .IR src .
55 .SH ATTRIBUTES
56 For an explanation of the terms used in this section, see
57 .BR attributes (7).
58 .TS
59 allbox;
60 lbx lb lb
61 l l l.
62 Interface Attribute Value
63 T{
64 .na
65 .nh
66 .BR memccpy ()
67 T} Thread safety MT-Safe
68 .TE
69 .SH STANDARDS
70 POSIX.1-2008.
71 .SH HISTORY
72 POSIX.1-2001, SVr4, 4.3BSD.
73 .SH SEE ALSO
74 .BR bcopy (3),
75 .BR bstring (3),
76 .BR memcpy (3),
77 .BR memmove (3),
78 .BR strcpy (3),
79 .BR strncpy (3)