xref: /csrg-svn/lib/libc/string/strcat.3 (revision 48351)
1*48351Scael.\" Copyright (c) 1990, 1991 The Regents of the University of California.
241965Sbostic.\" All rights reserved.
341965Sbostic.\"
441965Sbostic.\" This code is derived from software contributed to Berkeley by
541965Sbostic.\" Chris Torek.
641965Sbostic.\" %sccs.include.redist.man%
741965Sbostic.\"
8*48351Scael.\"     @(#)strcat.3	5.5 (Berkeley) 04/19/91
941965Sbostic.\"
10*48351Scael.Dd
11*48351Scael.Dt STRCAT 3
12*48351Scael.Os
13*48351Scael.Sh NAME
14*48351Scael.Nm strcat
15*48351Scael.Nd concatenate strings
16*48351Scael.Sh SYNOPSIS
17*48351Scael.Fd #include <string.h>
18*48351Scael.Ft char *
19*48351Scael.Fn strcat "char *s" "const char *append"
20*48351Scael.Ft char *
21*48351Scael.Fn strncat "char *s" "const char *append" "size_t count"
22*48351Scael.Sh DESCRIPTION
23*48351ScaelThe
24*48351Scael.Fn strcat
2543629Sbosticand
26*48351Scael.Fn strncat
27*48351Scaelfunctions
2843629Sbosticappend a copy of the null-terminated string
29*48351Scael.Fa append
3041965Sbosticto the end of the null-terminated string
31*48351Scael.Fa s ,
32*48351Scaelthen add a terminating
33*48351Scael.Ql \e0 .
3443629SbosticThe string
35*48351Scael.Fa s
3641965Sbosticmust have sufficient space to hold the result.
37*48351Scael.Pp
38*48351ScaelThe
39*48351Scael.Fn strncat
40*48351Scaelfunction
41*48351Scaelappends not more than
42*48351Scael.Fa count
4343628Sbosticcharacters.
44*48351Scael.Sh RETURN VALUES
45*48351ScaelThe
46*48351Scael.Fn strcat
4743629Sbosticand
48*48351Scael.Fn strncat
49*48351Scaelfunctions
5043629Sbosticreturn the pointer
51*48351Scael.Fa s .
52*48351Scael.Sh SEE ALSO
53*48351Scael.Xr bcopy 3 ,
54*48351Scael.Xr memccpy 3 ,
55*48351Scael.Xr memcpy 3 ,
56*48351Scael.Xr memmove 3 ,
57*48351Scael.Xr strcpy 3
58*48351Scael.Sh STANDARDS
59*48351ScaelThe
60*48351Scael.Fn strcat
6143628Sbosticand
62*48351Scael.Fn strncat
63*48351Scaelfunctions
64*48351Scaelconform to
65*48351Scael.St -ansiC .
66