help/remove

   1 NAME
   2     remove - remove the last member of a list
   3
   4 SYNOPSIS
   5     remove(lst)
   6
   7 TYPES
   8     lst         lvalue whose current value is a list
   9
  10     return      any
  11
  12 DESCRIPTION
  13     If lst has no members, remove(lst) returns the null value and does
  14     not change lst.
  15
  16     If lst has n members where n > 0, remove(lst) returns the value of
  17     lst[[n-1]] and deletes this value from the end of the lst, so that
  18     lst now has n - 1 members and for 0 <= i < n - 1, lst[[i]] returns
  19     what it would have returned before the remove operation.
  20
  21 EXAMPLE
  22     > lst = list(2,"three")
  23
  24     list (2 elements, 2 nonzero):
  25       [[0]] = 2
  26       [[1]] = "three"
  27
  28     > remove(lst)
  29             "three"
  30     > print lst
  31
  32     list (1 elements, 1 nonzero):
  33       [[0]] = 2
  34
  35     > remove(lst)
  36             2
  37     > print lst
  38     list (0 elements, 0 nonzero)
  39     > remove(lst)
  40     > print lst
  41     list (0 elements, 0 nonzero)
  42
  43 LIMITS
  44     none
  45
  46 LINK LIBRARY
  47     none
  48
  49 SEE ALSO
  50     append, delete, insert, islist, list, push, pop, rsearch, search, size
  51