Annotation of 43BSDReno/lib/libc/string/strcat.3, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1990 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: .\"
                      7: .\" Redistribution and use in source and binary forms are permitted provided
                      8: .\" that: (1) source distributions retain this entire copyright notice and
                      9: .\" comment, and (2) distributions including binaries display the following
                     10: .\" acknowledgement:  ``This product includes software developed by the
                     11: .\" University of California, Berkeley and its contributors'' in the
                     12: .\" documentation or other materials provided with the distribution and in
                     13: .\" all advertising materials mentioning features or use of this software.
                     14: .\" Neither the name of the University nor the names of its contributors may
                     15: .\" be used to endorse or promote products derived from this software without
                     16: .\" specific prior written permission.
                     17: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     18: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     19: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     20: .\"
                     21: .\"    @(#)strcat.3    5.3 (Berkeley) 6/24/90
                     22: .\"
                     23: .TH STRCAT 3 "June 24, 1990"
                     24: .UC 4
                     25: .SH NAME
                     26: strcat \- concatenate strings
                     27: .SH SYNOPSIS
                     28: .nf
                     29: .ft B
                     30: #include <string.h>
                     31: 
                     32: char *
                     33: strcat(char *s, const char *append);
                     34: 
                     35: char *
                     36: strncat(char *s, const char *append, size_t count);
                     37: .ft R
                     38: .fi
                     39: .SH DESCRIPTION
                     40: .B Strcat
                     41: and
                     42: .B strncat
                     43: append a copy of the null-terminated string
                     44: .I append
                     45: to the end of the null-terminated string
                     46: .IR s ,
                     47: then add a terminating '\e0'.
                     48: The string
                     49: .I s
                     50: must have sufficient space to hold the result.
                     51: .PP
                     52: .B Strncat
                     53: appends at most
                     54: .I count
                     55: characters.
                     56: .PP
                     57: .B Strcat
                     58: and
                     59: .B strncat
                     60: return the pointer
                     61: .IR s .
                     62: .SH SEE ALSO
                     63: bcopy(3), memccpy(3), memcpy(3), memmove(3), strcpy(3)
                     64: .SH STANDARDS
                     65: .B Strcat
                     66: and
                     67: .B strncat
                     68: conform to ANSI X3.159-1989 (``ANSI C'').

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.