diff options
Diffstat (limited to 'man3/strcat.3')
-rw-r--r-- | man3/strcat.3 | 62 |
1 files changed, 62 insertions, 0 deletions
diff --git a/man3/strcat.3 b/man3/strcat.3 new file mode 100644 index 000000000..fbb370130 --- /dev/null +++ b/man3/strcat.3 @@ -0,0 +1,62 @@ +.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" +.\" References consulted: +.\" Linux libc source code +.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) +.\" 386BSD man pages +.\" Modified Sat Jul 24 18:11:47 1993 by Rik Faith (faith@cs.unc.edu) +.TH STRCAT 3 1993-04-11 "GNU" "Linux Programmer's Manual" +.SH NAME +strcat, strncat \- concatenate two strings +.SH SYNOPSIS +.nf +.B #include <string.h> +.sp +.BI "char *strcat(char *" dest ", const char *" src ); +.sp +.BI "char *strncat(char *" dest ", const char *" src ", size_t " n ); +.fi +.SH DESCRIPTION +The \fBstrcat()\fP function appends the \fIsrc\fP string to the +\fIdest\fP string overwriting the `\\0' character at the end of +\fIdest\fP, and then adds a terminating `\\0' character. The +strings may not overlap, and the \fIdest\fP string must have +enough space for the result. +.PP +The \fBstrncat()\fP function is similar, except that it will use +at most \fIn\fP characters from \fIsrc\fP. +Since the result is always terminated with `\\0', at most \fIn\fP+1 +characters are written. +.SH "RETURN VALUE" +The \fBstrcat()\fP and \fBstrncat()\fP functions return a pointer +to the resulting string \fIdest\fP. +.SH "CONFORMING TO" +SVID 3, POSIX, BSD 4.3, ISO 9899 +.SH "SEE ALSO" +.BR bcopy (3), +.BR memccpy (3), +.BR memcpy (3), +.BR strcpy (3), +.BR strncpy (3), +.BR wcscat (3), +.BR wcsncat (3) |