c_cpp/etc/calc/help/strcat

   1 NAME
   2     strcat - concatenate null-terminated strings
   3
   4 SYNOPSIS
   5     strcat(x1, x2, ...)
   6
   7 TYPES
   8     x1, x2, ...         strings
   9
  10     return              string
  11
  12 DESCRIPTION
  13     strcat(x1, x2, ...) forms a string starting with a copy of
  14     x1 before the first, if any, null character in x1, followed by the
  15     initial non-null characters of any later arguments x2, ... The
  16     length of the resulting string will be the sum of the lengths
  17     of the component strings considered as null-terminated strings (i.e.
  18     the lengths as returned by strlen()). The sum function may be used
  19     to concatenate strings where '\0' is to be considered as an ordinary
  20     character, either by sum(x1, x2, ...) or sum(list(x1, x2, ...));
  21     in this case, the size of the resulting string is the sum of the
  22     sizes of the component strings.
  23
  24
  25 EXAMPLE
  26     ; A = "abc"; B = "XY"; C = "  ";
  27     ; print strcat(A, B, C, B, A)
  28     abcXY  XYabc
  29
  30 LIMITS
  31     The number of arguments may not to exceed 1024.
  32
  33 LINK LIBRARY
  34     none
  35
  36 SEE ALSO
  37     strcmp, strcpy, strerror, strlen, strncmp, strncpy, strpos,
  38     strprintf, strscan, strscanf, substr
  39
  40 ## Copyright (C) 1999-2006  Landon Curt Noll
  41 ##
  42 ## Calc is open software; you can redistribute it and/or modify it under
  43 ## the terms of the version 2.1 of the GNU Lesser General Public License
  44 ## as published by the Free Software Foundation.
  45 ##
  46 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  47 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  48 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  49 ## Public License for more details.
  50 ##
  51 ## A copy of version 2.1 of the GNU Lesser General Public License is
  52 ## distributed with calc under the filename COPYING-LGPL.  You should have
  53 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  54 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  55 ##
  56 ## @(#) $Revision: 30.1 $
  57 ## @(#) $Id: strcat,v 30.1 2007/03/16 11:10:42 chongo Exp $
  58 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/strcat,v $
  59 ##
  60 ## Under source code control:   1995/10/05 04:52:27
  61 ## File existed as early as:    1995
  62 ##
  63 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  64 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/