c_cpp/etc/calc/help/append

   1 NAME
   2     append - append one or more values to end of list
   3
   4 SYNOPSIS
   5     append(x, y_0, y_1, ...)
   6
   7 TYPES
   8     x           lvalue whose value is a list
   9     y_0, ...    any
  10
  11     return      null value
  12
  13 DESCRIPTION
  14     If after evaluation of y_0, y_1, ..., x is a list with contents
  15     (x_0, x_1, ...), then after append(x, y_0, y_1, ...), x has
  16     contents (x_0, x_1, ..., y_0, y_1, ...).
  17
  18     If after evaluation of y_0, y_1, ..., x has size n,
  19     append(x, y_0, y_1, ...) is equivalent to insert(x, n, y_0, y_1, ...).
  20
  21 EXAMPLE
  22     ; x = list(2,3,4)
  23     ; append(x, 5, 6)
  24     ; print x
  25
  26     list (5 elements, 5 nonzero):
  27       [[0]] = 2
  28       [[1]] = 3
  29       [[2]] = 4
  30       [[3]] = 5
  31       [[4]] = 6
  32
  33     ; append(x, pop(x), pop(x))
  34     ; print x
  35
  36     list (5 elements, 5 nonzero):
  37       [[0]] = 4
  38       [[1]] = 5
  39       [[2]] = 6
  40       [[3]] = 2
  41       [[4]] = 3
  42
  43     ; append(x, (remove(x), 7))
  44     ; print x
  45
  46     list (5 elements, 5 nonzero):
  47       [[0]] = 4
  48       [[1]] = 5
  49       [[2]] = 6
  50       [[3]] = 2
  51       [[4]] = 7
  52
  53 LIMITS
  54     append() can have at most 100 arguments
  55
  56 LINK LIBRARY
  57     none
  58
  59 SEE ALSO
  60      delete, insert, islist, pop, push, remove, rsearch, search,
  61      select, size
  62
  63 ## Copyright (C) 1999-2006  Landon Curt Noll
  64 ##
  65 ## Calc is open software; you can redistribute it and/or modify it under
  66 ## the terms of the version 2.1 of the GNU Lesser General Public License
  67 ## as published by the Free Software Foundation.
  68 ##
  69 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  70 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  71 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  72 ## Public License for more details.
  73 ##
  74 ## A copy of version 2.1 of the GNU Lesser General Public License is
  75 ## distributed with calc under the filename COPYING-LGPL.  You should have
  76 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  77 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  78 ##
  79 ## @(#) $Revision: 30.1 $
  80 ## @(#) $Id: append,v 30.1 2007/03/16 11:10:42 chongo Exp $
  81 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/append,v $
  82 ##
  83 ## Under source code control:   1994/03/19 03:13:17
  84 ## File existed as early as:    1994
  85 ##
  86 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  87 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/