Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the simple-parallel-tasks Reference Manual, version 1.0, generated automatically by Declt version 3.0 "Montgomery Scott" on Wed Oct 13 12:32:10 2021 GMT+0.
| • Introduction | What simple-parallel-tasks is all about | |
| • Systems | The systems documentation | |
| • Files | The files documentation | |
| • Packages | The packages documentation | |
| • Definitions | The symbols documentation | |
| • Indexes | Concepts, functions, variables and data types |
#+TITLE: simple-parallel-tasks
This is a simple Common Lisp library to evaluate some forms in parallel.
* Installation
/simple-parallel-tasks/ requires the /chanl/ library.
** With Quicklisp
#+BEGIN_SRC lisp
(ql:quickload "simple-parallel-tasks")
#+END_SRC
** With ASDF
Put the directories of /simple-parallel-tasks/ and the dependencies where
/ASDF/ can find them and use:
#+BEGIN_SRC lisp
(asdf:load-system "simple-parallel-tasks")
#+END_SRC
* API
#+BEGIN_SRC lisp
(defmacro plist (&rest forms))
#+END_SRC
Evaluate /forms/ in parallel and return the results in a list.
#+BEGIN_SRC lisp
(defmacro pvalues (&rest forms))
#+END_SRC
Evaluate /forms/ in parallel and return the results as multiple values.
#+BEGIN_SRC lisp
(defmacro plet (bindings &body body))
#+END_SRC
Like /let/, but the /bindings/ are evaluated in parallel.
#+BEGIN_SRC lisp
(defmacro pprog1 (first-form &body forms))
#+END_SRC
Evaluate /first-form/ and /forms/ in parallel and return the result of the
evaluation of /first-form/.
#+BEGIN_SRC lisp
(defmacro pprogn (&rest forms))
#+END_SRC
Evaluate /forms/ in parallel and return the result of the evaluation of the
last form.
* Examples
#+BEGIN_SRC lisp
(time (simple-parallel-tasks:plist 1 (+ 4 5) (sleep 2) 8 (sleep 1) (/ 3 5)))
Evaluation took:
2.004 seconds of real time
(1 9 NIL 8 NIL 3/5)
#+END_SRC
#+BEGIN_SRC lisp
(time (simple-parallel-tasks:pvalues 1 (+ 4 5) (sleep 2) 8 (sleep 1) (/ 3 5)))
Evaluation took:
2.007 seconds of real time
1
9
NIL
8
NIL
3/5
#+END_SRC
#+BEGIN_SRC lisp
(time (simple-parallel-tasks:plet ((x (sleep 2))
(y (+ 3 4))
a
(b (sleep 3))
(z (floor 12 5)))
(list x y a b z)))
Evaluation took:
3.0000 seconds of real time
(NIL 7 NIL NIL 2)
#+END_SRC
* Tests
The tests require the /fiveam/ library.
#+BEGIN_SRC lisp
(asdf:test-system "simple-parallel-tasks")
#+END_SRC
Next: Files, Previous: Introduction, Up: Top [Contents][Index]
The main system appears first, followed by any subsystem dependency.
| • The simple-parallel-tasks system |
Guillaume Le Vaillant
GPL-3
Evaluate forms in parallel
1.0
chanl
simple-parallel-tasks.asd (file)
simple-parallel-tasks.lisp (file)
Files are sorted by type and then listed depth-first from the systems components trees.
| • Lisp files |
| • The simple-parallel-tasks.asd file | ||
| • The simple-parallel-tasks/simple-parallel-tasks.lisp file |
Next: The simple-parallel-tasks/simple-parallel-tasks․lisp file, Previous: Lisp files, Up: Lisp files [Contents][Index]
simple-parallel-tasks.asd
simple-parallel-tasks (system)
Previous: The simple-parallel-tasks․asd file, Up: Lisp files [Contents][Index]
simple-parallel-tasks (system)
simple-parallel-tasks.lisp
Next: Definitions, Previous: Files, Up: Top [Contents][Index]
Packages are listed by definition order.
| • The simple-parallel-tasks package |
simple-parallel-tasks.lisp (file)
Definitions are sorted by export status, category, package, and then by lexicographic order.
| • Exported definitions |
Previous: Definitions, Up: Definitions [Contents][Index]
| • Exported macros |
Previous: Exported definitions, Up: Exported definitions [Contents][Index]
Like LET, but the BINDINGS are evaluated in parallel.
simple-parallel-tasks.lisp (file)
Evaluate FORMS in parallel and return the results in a list.
simple-parallel-tasks.lisp (file)
Evaluate FIRST-FORM and FORMS in parallel and return the result of the evaluation of FIRST-FORM.
simple-parallel-tasks.lisp (file)
Evaluate FORMS in parallel and return the result of the evaluation of the last form.
simple-parallel-tasks.lisp (file)
Evaluate FORMS in parallel and return the results as multiple values.
simple-parallel-tasks.lisp (file)
Previous: Definitions, Up: Top [Contents][Index]
| • Concept index | ||
| • Function index | ||
| • Variable index | ||
| • Data type index |
Next: Function index, Previous: Indexes, Up: Indexes [Contents][Index]
| Jump to: | F L S |
|---|
| Jump to: | F L S |
|---|
Next: Variable index, Previous: Concept index, Up: Indexes [Contents][Index]
| Jump to: | M P |
|---|
| Jump to: | M P |
|---|
Next: Data type index, Previous: Function index, Up: Indexes [Contents][Index]
Previous: Variable index, Up: Indexes [Contents][Index]
| Jump to: | P S |
|---|
| Jump to: | P S |
|---|