basis/concurrency/combinators/combinators-docs.factor

   1 USING: help.markup help.syntax sequences ;\r
   2 IN: concurrency.combinators\r
   3 \r
   4 HELP: parallel-map\r
   5 { $values { "seq" sequence } { "quot" "a quotation with stack effect " { $snippet "( elt -- newelt )" } } { "newseq" sequence } }\r
   6 { $description "Spawns a new thread for applying " { $snippet "quot" } " to every element of " { $snippet "seq" } ", collecting the results at the end." }\r
   7 { $errors "Throws an error if one of the iterations throws an error." } ;\r
   8 \r
   9 HELP: 2parallel-map\r
  10 { $values { "seq1" sequence } { "seq2" sequence } { "quot" "a quotation with stack effect " { $snippet "( elt -- newelt )" } } { "newseq" sequence } }\r
  11 { $description "Spawns a new thread for applying " { $snippet "quot" } " to pairwise elements of " { $snippet "seq1" } " and " { $snippet "seq2" } ", collecting the results at the end." }\r
  12 { $errors "Throws an error if one of the iterations throws an error." } ;\r
  13 \r
  14 HELP: parallel-each\r
  15 { $values { "seq" sequence } { "quot" "a quotation with stack effect " { $snippet "( elt -- )" } } }\r
  16 { $description "Spawns a new thread for applying " { $snippet "quot" } " to every element of " { $snippet "seq" } ", blocking until all quotations complete." }\r
  17 { $errors "Throws an error if one of the iterations throws an error." } ;\r
  18 \r
  19 HELP: 2parallel-each\r
  20 { $values { "seq1" sequence } { "seq2" sequence } { "quot" "a quotation with stack effect " { $snippet "( elt -- )" } } }\r
  21 { $description "Spawns a new thread for applying " { $snippet "quot" } " to pairwise elements of " { $snippet "seq1" } " and " { $snippet "seq2" } ", blocking until all quotations complete." }\r
  22 { $errors "Throws an error if one of the iterations throws an error." } ;\r
  23 \r
  24 HELP: parallel-filter\r
  25 { $values { "seq" sequence } { "quot" "a quotation with stack effect " { $snippet "( elt -- ? )" } } { "newseq" sequence } }\r
  26 { $description "Spawns a new thread for applying " { $snippet "quot" } " to every element of " { $snippet "seq" } ", collecting the elements for which the quotation yielded a true value." }\r
  27 { $errors "Throws an error if one of the iterations throws an error." } ;\r
  28 \r
  29 ARTICLE: "concurrency.combinators" "Concurrent combinators"\r
  30 "The " { $vocab-link "concurrency.combinators" } " vocabulary provides concurrent variants of " { $link each } ", " { $link map } " and " { $link filter } ":"\r
  31 { $subsection parallel-each }\r
  32 { $subsection 2parallel-each }\r
  33 { $subsection parallel-map }\r
  34 { $subsection 2parallel-map }\r
  35 { $subsection parallel-filter } ;\r
  36 \r
  37 ABOUT: "concurrency.combinators"\r