c_cpp/etc/calc/help/tail

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