.\"   Part of publib.
.\"  
.\"   Copyright (c) 1994-2006 Lars Wirzenius.  All rights reserved.
.\"  
.\"   Redistribution and use in source and binary forms, with or without
.\"   modification, are permitted provided that the following conditions
.\"   are met:
.\"  
.\"   1. Redistributions of source code must retain the above copyright
.\"      notice, this list of conditions and the following disclaimer.
.\"  
.\"   2. Redistributions in binary form must reproduce the above
.\"      copyright notice, this list of conditions and the following
.\"      disclaimer in the documentation and/or other materials provided
.\"      with the distribution.
.\"  
.\"   THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
.\"   OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
.\"   WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\"   ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
.\"   DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\"   DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
.\"   GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\"   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
.\"   WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
.\"   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
.\"   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"  
.\" part of publib
.\" "@(#)publib-strutil:$Id: stracat.3,v 1.1.1.1 1994/02/03 17:25:30 liw Exp $"
.\"
.TH STRACAT 3pub "C Programmer's Manual" Publib "C Programmer's Manual"
.SH NAME
stracat \- concatenate many strings into an allocated memory block
.SH SYNOPSIS
.nf
#include <publib.h>
char *\fBstracat\fR(const char *\fIs\fR, ...);
.SH DESCRIPTION
\fIstracat\fR will allocate a block of memory with malloc and concatenate
all arguments strings into this block.  The user is supposed
to free the returned block.  The end of the argument list is signalled
by a null pointer.
.SH "RETURN VALUE"
\fIstracat\fR returns a pointer to the allocated block,
or NULL if it could not be allocated.
.SH EXAMPLE
To concatenate "hello, " and "world", one might say the following.
.sp 1
.nf
.in +5
p = stracat("hello, ", "world", (char *)NULL);
if (p != NULL)
	puts(p);
.in -5
.sp 1
Please note that it is necessary to case NULL as in the example above,
since there is no information about the type of the argument available
in the prototype, and since an unadorned NULL might not be of the 
correct type.  (See any good C reference book or the comp.lang.c FAQ for
more information.)
.SH "SEE ALSO"
publib(3), strcat(3)
.SH AUTHOR
Lars Wirzenius (lars.wirzenius@helsinki.fi)