c_cpp/etc/calc/help/push

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