xref: /original-bsd/lib/libc/string/memccpy.3 (revision 3705696b)
1.\" Copyright (c) 1990, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)memccpy.3	8.1 (Berkeley) 06/09/93
7.\"
8.Dd
9.Dt MEMCCPY 3
10.Os
11.Sh NAME
12.Nm memccpy
13.Nd copy string until character found
14.Sh SYNOPSIS
15.Fd #include <string.h>
16.Ft void *
17.Fn memccpy "void *dst" "const void *src" "int c" "size_t len"
18.Sh DESCRIPTION
19The
20.Fn memccpy
21function
22copies bytes from string
23.Fa src
24to string
25.Fa dst .
26If the character
27.Fa c
28(as converted to an unsigned char) occurs in the string
29.Fa src ,
30the copy stops and a pointer to the byte after the copy of
31.Fa c
32in the string
33.Fa dst
34is returned.
35Otherwise,
36.Fa len
37bytes are copied, and a NULL pointer is returned.
38.Sh SEE ALSO
39.Xr bcopy 3 ,
40.Xr memcpy 3 ,
41.Xr memmove 3 ,
42.Xr strcpy 3
43.Sh HISTORY
44The
45.Fn memccpy
46function first appeared in 4.4BSD.
47