xref: /csrg-svn/lib/libc/string/strcat.3 (revision 61193)
1*61193Sbostic.\" Copyright (c) 1990, 1991, 1993
2*61193Sbostic.\"	The Regents of the University of California.  All rights reserved.
341965Sbostic.\"
441965Sbostic.\" This code is derived from software contributed to Berkeley by
550320Sbostic.\" Chris Torek and the American National Standards Committee X3,
650320Sbostic.\" on Information Processing Systems.
750320Sbostic.\"
841965Sbostic.\" %sccs.include.redist.man%
941965Sbostic.\"
10*61193Sbostic.\"     @(#)strcat.3	8.1 (Berkeley) 06/04/93
1141965Sbostic.\"
1248351Scael.Dd
1348351Scael.Dt STRCAT 3
1448351Scael.Os
1548351Scael.Sh NAME
1648351Scael.Nm strcat
1748351Scael.Nd concatenate strings
1848351Scael.Sh SYNOPSIS
1948351Scael.Fd #include <string.h>
2048351Scael.Ft char *
2148351Scael.Fn strcat "char *s" "const char *append"
2248351Scael.Ft char *
2348351Scael.Fn strncat "char *s" "const char *append" "size_t count"
2448351Scael.Sh DESCRIPTION
2548351ScaelThe
2648351Scael.Fn strcat
2743629Sbosticand
2848351Scael.Fn strncat
2948351Scaelfunctions
3043629Sbosticappend a copy of the null-terminated string
3148351Scael.Fa append
3241965Sbosticto the end of the null-terminated string
3348351Scael.Fa s ,
3448351Scaelthen add a terminating
3548351Scael.Ql \e0 .
3643629SbosticThe string
3748351Scael.Fa s
3841965Sbosticmust have sufficient space to hold the result.
3948351Scael.Pp
4048351ScaelThe
4148351Scael.Fn strncat
4248351Scaelfunction
4348351Scaelappends not more than
4448351Scael.Fa count
4543628Sbosticcharacters.
4648351Scael.Sh RETURN VALUES
4748351ScaelThe
4848351Scael.Fn strcat
4943629Sbosticand
5048351Scael.Fn strncat
5148351Scaelfunctions
5243629Sbosticreturn the pointer
5348351Scael.Fa s .
5448351Scael.Sh SEE ALSO
5548351Scael.Xr bcopy 3 ,
5648351Scael.Xr memccpy 3 ,
5748351Scael.Xr memcpy 3 ,
5848351Scael.Xr memmove 3 ,
5948351Scael.Xr strcpy 3
6048351Scael.Sh STANDARDS
6148351ScaelThe
6248351Scael.Fn strcat
6343628Sbosticand
6448351Scael.Fn strncat
6548351Scaelfunctions
6648351Scaelconform to
6748351Scael.St -ansiC .
68