/* Concatenate variable number of strings.
Copyright (C) 1991-2024 Free Software Foundation, Inc.
Written by Fred Fish @ Cygnus Support
This file is part of the libiberty library.
Libiberty is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
Libiberty 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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with libiberty; see the file COPYING.LIB. If
not, write to the Free Software Foundation, Inc., 51 Franklin Street - Fifth Floor,
Boston, MA 02110-1301, USA. */
Concatenate zero or more of strings and return the result in freshly
@code{xmalloc}ed memory. The argument list is terminated by the first
@code{NULL} pointer encountered. Pointers to empty strings are ignored.
/* First compute the size of the result and get sufficient memory. */
va_start (args, first);
newstr = XNEWVEC (char, vconcat_length (first, args) + 1);
va_end (args);
/* Now copy the individual pieces to the result string. */
va_start (args, first);
vconcat_copy (newstr, first, args);
va_end (args);
Same as @code{concat}, except that if @var{optr} is not @code{NULL} it
is freed after the string is created. This is intended to be useful
when you're extending an existing string or building up a string in a
loop:
@example
str = reconcat (str, "pre-", str, NULL);
@end example
/* First compute the size of the result and get sufficient memory. */
va_start (args, first);
newstr = XNEWVEC (char, vconcat_length (first, args) + 1);
va_end (args);
/* Now copy the individual pieces to the result string. */
va_start (args, first);
vconcat_copy (newstr, first, args);
if (optr) /* Done before VA_CLOSE so optr stays in scope for K&R C. */
free (optr);
va_end (args);