library/list-namespaces.factor

   1 !:folding=indent:collapseFolds=1:
   2
   3 ! $Id$
   4 !
   5 ! Copyright (C) 2003, 2004 Slava Pestov.
   6 !
   7 ! Redistribution and use in source and binary forms, with or without
   8 ! modification, are permitted provided that the following conditions are met:
   9 !
  10 ! 1. Redistributions of source code must retain the above copyright notice,
  11 !    this list of conditions and the following disclaimer.
  12 !
  13 ! 2. Redistributions in binary form must reproduce the above copyright notice,
  14 !    this list of conditions and the following disclaimer in the documentation
  15 !    and/or other materials provided with the distribution.
  16 !
  17 ! THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
  18 ! INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
  19 ! FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  20 ! DEVELOPERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  21 ! SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  22 ! PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
  23 ! OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  24 ! WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  25 ! OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
  26 ! ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27
  28 IN: lists
  29 USE: combinators
  30 USE: kernel
  31 USE: namespaces
  32 USE: stack
  33
  34 : append@ ( [ list ] var -- )
  35     #! Append a proper list stored in a variable with another
  36     #! list, storing the result back in the variable.
  37     #! given variable using 'append'.
  38     tuck get swap append put ;
  39
  40 : add@ ( elem var -- )
  41     #! Add an element at the end of a proper list stored in a
  42     #! variable, storing the result back in the variable.
  43     tuck get swap add put ;
  44
  45 : cons@ ( x var -- )
  46     #! Prepend x to the list stored in var.
  47     tuck get cons put ;
  48
  49 : remove@ ( obj var -- )
  50     #! Remove all occurrences of the object from the list
  51     #! stored in the variable.
  52     tuck get remove put ;
  53
  54 : unique@ ( elem var -- )
  55     #! Prepend an element to the proper list stored in a
  56     #! variable if it is not already contained in the list.
  57     tuck get unique put ;
  58
  59 : [, ( -- )
  60     #! Begin constructing a list.
  61     <namespace> >n f "list-buffer" set ;
  62
  63 : , ( obj -- )
  64     #! Append an object to the currently constructing list.
  65     "list-buffer" cons@ ;
  66
  67 : list, ( list -- )
  68     #! Append each element to the currently constructing list.
  69     [ , ] each ;
  70
  71 : ,] ( -- list )
  72     #! Finish constructing a list and push it on the stack.
  73     "list-buffer" get nreverse n> drop ;