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