libs/lazy-lists/lazy.facts

   1 ! Copyright (C) 2006 Chris Double.
   2 ! See http://factorcode.org/license.txt for BSD license.
   3
   4 USING: help lazy-lists ;
   5
   6 HELP: LAZY:
   7 { $syntax "LAZY: word definition... ;" }
   8 { $values { "word" "a new word to define" } { "definition" "a word definition" } }
   9 { $description "Creates a lazy word in the current vocabulary. When executed the word will return a " { $link <promise> } " that when forced, executes the word definition. Any values on the stack that are required by the word definition are captured along with the promise." }
  10 { $examples
  11   { $example "LAZY: my-add ( a b -- c ) + ;\n1 2 my-add force ." }
  12 }
  13 { $see-also force promise-with promise-with2 } ;