source: project/wiki/man/5/Module (chicken continuation) @ 37357

Last change on this file since 37357 was 37357, checked in by svnwiki, 21 months ago

Anonymous wiki edit for IP [96.61.125.198]: Update the URL for Marc Feeley's paper; the previous link seems to have it's domain (readscheme.org) taken over by a spam site.

File size: 1.5 KB
Line 
1[[tags: manual]]
2[[toc:]]
3
4== Module (chicken continuation)
5
6This module provides a more powerful interface for continuations than that
7provided by {{call/cc}}.
8
9More information about this continuation API can be found in the paper
10[[http://www.iro.umontreal.ca/~feeley/papers/FeeleySW01.pdf|A Better
11API for First-Class Continuations]] by Marc Feeley.
12
13=== Continuations API
14
15==== continuation-capture
16
17<procedure>(continuation-capture PROCEDURE)</procedure>
18
19Creates a continuation object representing the current continuation and
20tail-calls {{PROCEDURE}} with this continuation as the single argument.
21
22
23==== continuation?
24
25<procedure>(continuation? X)</procedure>
26
27Returns {{#t}} if {{X}} is a continuation object, or {{#f}} otherwise. Please
28note that this applies only to continuations created by the Continuation API,
29but not by call/cc, i.e.: {{(call-with-current-continuation continuation?)}}
30returns {{#f}}, whereas {{(continuation-capture continuation?)}} returns
31{{#t}}.
32
33
34==== continuation-graft
35
36<procedure>(continuation-graft CONT THUNK)</procedure>
37
38Calls the procedure {{THUNK}} with no arguments and the implicit continuation
39{{CONT}}.
40
41
42==== continuation-return
43
44<procedure>(continuation-return CONT VALUE ...)</procedure>
45
46Returns the value(s) to the continuation {{CONT}}. {{continuation-return}} could
47be implemented like this:
48
49<enscript highlight=scheme>
50(define (continuation-return k . vals)
51  (continuation-graft
52    k
53    (lambda () (apply values vals))))
54</enscript>
55
56
57----
58Previous: [[Module (chicken condition)]]
59
60Next: [[Module (chicken csi)]]
Note: See TracBrowser for help on using the repository browser.