c_cpp/etc/calc/help/head

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