NAME
    strcat - concatenate null-terminated strings

SYNOPSIS
    strcat(x1, x2, ...)

TYPES
    x1, x2, ...		strings

    return		string

DESCRIPTION
    strcat(x1, x2, ...) forms a string starting with a copy of
    x1 before the first, if any, null character in x1, followed by the
    initial non-null characters of any later arguments x2, ... The
    length of the resulting string will be the sum of the lengths
    of the component strings considered as null-terminated strings (i.e.
    the lengths as returned by strlen()). The sum function may be used
    to concatenate strings where '\0' is to be considered as an ordinary
    character, either by sum(x1, x2, ...) or sum(list(x1, x2, ...));
    in this case, the size of the resulting string is the sum of the
    sizes of the component strings.


EXAMPLE
    ; A = "abc"; B = "XY"; C = "  ";
    ; print strcat(A, B, C, B, A)
    abcXY  XYabc

LIMITS
    The number of arguments may not to exceed 1024.

LINK LIBRARY
    none

SEE ALSO
    strcmp, strcpy, strerror, strlen, strncmp, strncpy, strpos,
    strprintf, strscan, strscanf, substr

## Copyright (C) 1999-2006  Landon Curt Noll
##
## Calc is open software; you can redistribute it and/or modify it under
## the terms of the version 2.1 of the GNU Lesser General Public License
## as published by the Free Software Foundation.
##
## Calc is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
## or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU Lesser General
## Public License for more details.
##
## A copy of version 2.1 of the GNU Lesser General Public License is
## distributed with calc under the filename COPYING-LGPL.  You should have
## received a copy with calc; if not, write to Free Software Foundation, Inc.
## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
##
## @(#) $Revision: 30.1 $
## @(#) $Id: strcat,v 30.1 2007/03/16 11:10:42 chongo Exp $
## @(#) $Source: /usr/local/src/bin/calc/help/RCS/strcat,v $
##
## Under source code control:	1995/10/05 04:52:27
## File existed as early as:	1995
##
## chongo <was here> /\oo/\	http://www.isthe.com/chongo/
## Share and enjoy!  :-)	http://www.isthe.com/chongo/tech/comp/calc/
