c_cpp/etc/calc/help/join

   1 NAME
   2     join - form a list by concatenation of specified lists
   3
   4 SYNOPSIS
   5     join(x, y, ...)
   6
   7 TYPES
   8     x, y, ...   lists
   9
  10     return      list or null
  11
  12 DESCRIPTION
  13     For lists x, y, ..., join(x, y, ...) returns the list whose length
  14     is the sum of the lengths of x, y, ..., in which the members of each
  15     argument immediately follow those of the preceding argument.
  16     The lists x, y, ... are not changed.
  17
  18     If any argument is not a list, a null value is returned.
  19
  20 EXAMPLE
  21     ; A = list(1, 2, 3)
  22     ; B = list(4, 5)
  23     ; join(A, B)
  24
  25     list (5 elements, 5 nonzero):
  26           [[0]] = 1
  27           [[1]] = 2
  28           [[2]] = 3
  29           [[3]] = 4
  30           [[4]] = 5
  31
  32 LIMITS
  33     none
  34
  35 LINK LIBRARY
  36     none
  37
  38 SEE ALSO
  39     reverse, sort
  40
  41 ## Copyright (C) 1999  Landon Curt Noll
  42 ##
  43 ## Calc is open software; you can redistribute it and/or modify it under
  44 ## the terms of the version 2.1 of the GNU Lesser General Public License
  45 ## as published by the Free Software Foundation.
  46 ##
  47 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  48 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  49 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  50 ## Public License for more details.
  51 ##
  52 ## A copy of version 2.1 of the GNU Lesser General Public License is
  53 ## distributed with calc under the filename COPYING-LGPL.  You should have
  54 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  55 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  56 ##
  57 ## @(#) $Revision: 30.1 $
  58 ## @(#) $Id: join,v 30.1 2007/03/16 11:10:42 chongo Exp $
  59 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/join,v $
  60 ##
  61 ## Under source code control:   1995/07/09 19:41:40
  62 ## File existed as early as:    1995
  63 ##
  64 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  65 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/