xref: /original-bsd/lib/libc/string/strcat.3 (revision 08eb28af)
1.\" Copyright (c) 1990, 1991 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" Chris Torek.
6.\" %sccs.include.redist.man%
7.\"
8.\"     @(#)strcat.3	5.5 (Berkeley) 04/19/91
9.\"
10.Dd
11.Dt STRCAT 3
12.Os
13.Sh NAME
14.Nm strcat
15.Nd concatenate strings
16.Sh SYNOPSIS
17.Fd #include <string.h>
18.Ft char *
19.Fn strcat "char *s" "const char *append"
20.Ft char *
21.Fn strncat "char *s" "const char *append" "size_t count"
22.Sh DESCRIPTION
23The
24.Fn strcat
25and
26.Fn strncat
27functions
28append a copy of the null-terminated string
29.Fa append
30to the end of the null-terminated string
31.Fa s ,
32then add a terminating
33.Ql \e0 .
34The string
35.Fa s
36must have sufficient space to hold the result.
37.Pp
38The
39.Fn strncat
40function
41appends not more than
42.Fa count
43characters.
44.Sh RETURN VALUES
45The
46.Fn strcat
47and
48.Fn strncat
49functions
50return the pointer
51.Fa s .
52.Sh SEE ALSO
53.Xr bcopy 3 ,
54.Xr memccpy 3 ,
55.Xr memcpy 3 ,
56.Xr memmove 3 ,
57.Xr strcpy 3
58.Sh STANDARDS
59The
60.Fn strcat
61and
62.Fn strncat
63functions
64conform to
65.St -ansiC .
66