… | |
… | |
41 | |
41 | |
42 | our $idle; # idle handler |
42 | our $idle; # idle handler |
43 | our $main; # main coroutine |
43 | our $main; # main coroutine |
44 | our $current; # current coroutine |
44 | our $current; # current coroutine |
45 | |
45 | |
46 | our $VERSION = '2.5'; |
46 | our $VERSION = '3.0'; |
47 | |
47 | |
48 | our @EXPORT = qw(async cede schedule terminate current); |
48 | our @EXPORT = qw(async cede schedule terminate current); |
49 | our %EXPORT_TAGS = ( |
49 | our %EXPORT_TAGS = ( |
50 | prio => [qw(PRIO_MAX PRIO_HIGH PRIO_NORMAL PRIO_LOW PRIO_IDLE PRIO_MIN)], |
50 | prio => [qw(PRIO_MAX PRIO_HIGH PRIO_NORMAL PRIO_LOW PRIO_IDLE PRIO_MIN)], |
51 | ); |
51 | ); |
… | |
… | |
171 | |
171 | |
172 | Create a new asynchronous process and return it's process object |
172 | Create a new asynchronous process and return it's process object |
173 | (usually unused). When the sub returns the new process is automatically |
173 | (usually unused). When the sub returns the new process is automatically |
174 | terminated. |
174 | terminated. |
175 | |
175 | |
|
|
176 | Calling C<exit> in a coroutine will not work correctly, so do not do that. |
|
|
177 | |
176 | When the coroutine dies, the program will exit, just as in the main |
178 | When the coroutine dies, the program will exit, just as in the main |
177 | program. |
179 | program. |
178 | |
180 | |
179 | # create a new coroutine that just prints its arguments |
181 | # create a new coroutine that just prints its arguments |
180 | async { |
182 | async { |
… | |
… | |
230 | Create a new process and return it. When the sub returns the process |
232 | Create a new process and return it. When the sub returns the process |
231 | automatically terminates as if C<terminate> with the returned values were |
233 | automatically terminates as if C<terminate> with the returned values were |
232 | called. To make the process run you must first put it into the ready queue |
234 | called. To make the process run you must first put it into the ready queue |
233 | by calling the ready method. |
235 | by calling the ready method. |
234 | |
236 | |
|
|
237 | Calling C<exit> in a coroutine will not work correctly, so do not do that. |
|
|
238 | |
235 | =cut |
239 | =cut |
236 | |
240 | |
237 | sub _new_coro { |
241 | sub _new_coro { |
238 | $current->_clear_idle_sp; # (re-)set the idle sp on the following cede |
|
|
239 | _set_cede_self; # ensures that cede cede's us first |
|
|
240 | cede; |
|
|
241 | terminate &{+shift}; |
242 | terminate &{+shift}; |
242 | } |
243 | } |
243 | |
244 | |
244 | sub new { |
245 | sub new { |
245 | my $class = shift; |
246 | my $class = shift; |
246 | |
247 | |
247 | $class->SUPER::new (\&_new_coro, @_) |
248 | $class->SUPER::new (\&_new_coro, @_) |
248 | } |
249 | } |
249 | |
250 | |
250 | =item $process->ready |
251 | =item $success = $process->ready |
251 | |
252 | |
252 | Put the given process into the ready queue. |
253 | Put the given process into the ready queue (according to it's priority) |
|
|
254 | and return true. If the process is already in the ready queue, do nothing |
|
|
255 | and return false. |
253 | |
256 | |
254 | =cut |
257 | =item $is_ready = $process->is_ready |
|
|
258 | |
|
|
259 | Return wether the process is currently the ready queue or not, |
255 | |
260 | |
256 | =item $process->cancel (arg...) |
261 | =item $process->cancel (arg...) |
257 | |
262 | |
258 | Terminates the given process and makes it return the given arguments as |
263 | Terminates the given process and makes it return the given arguments as |
259 | status (default: the empty list). |
264 | status (default: the empty list). |