ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/AnyEvent/lib/AE.pm
(Generate patch)

Comparing AnyEvent/lib/AE.pm (file contents):
Revision 1.10 by root, Thu Aug 11 21:26:39 2011 UTC vs.
Revision 1.16 by root, Mon Apr 9 02:25:48 2012 UTC

… …
26 }; 26 };
27 27
28 # called when event loop idle (if applicable) 28 # called when event loop idle (if applicable)
29 my $w = AE::idle sub { ... }; 29 my $w = AE::idle sub { ... };
30 30
31 my $w = AE::cv; # stores whether a condition was flagged 31 my $cv = AE::cv; # stores whether a condition was flagged
32 $w->send; # wake up current and all future recv's 32 $cv->send; # wake up current and all future recv's
33 $w->recv; # enters "main loop" till $condvar gets ->send 33 $cv->recv; # enters "main loop" till $condvar gets ->send
34 # use a condvar in callback mode: 34 # use a condvar in callback mode:
35 $w->cb (sub { $_[0]->recv }); 35 $cv->cb (sub { $_[0]->recv });
36 36
37 37
38=head1 DESCRIPTION 38=head1 DESCRIPTION
39 39
40This module documents the new simpler AnyEvent API. 40This module documents the new simpler AnyEvent API.
… …
53 53
54Also, some backends (Perl and EV) are so fast that the method call 54Also, some backends (Perl and EV) are so fast that the method call
55overhead is very noticeable (with EV it increases the execution time five- 55overhead is very noticeable (with EV it increases the execution time five-
56to six-fold, with Perl the method call overhead is about a factor of two). 56to six-fold, with Perl the method call overhead is about a factor of two).
57 57
58At the moment, there is no checking (L<AnyEvent::Strict> does not
59affect this API), so the L<AnyEvent> API still has a definite advantage
60here.
61
62Note that the C<AE> API is an alternative to, not the future version of, 58Note that the C<AE> API is an alternative to, not the future version of,
63the AnyEvent API. Both APIs can be used interchangeably and and there are 59the AnyEvent API. Both APIs can be used interchangeably and there are
64no plans to "switch", so if in doubt, feel free to use the L<AnyEvent> 60no plans to "switch", so if in doubt, feel free to use the L<AnyEvent>
65API in new code. 61API in new code.
66 62
67As the AE API is complementary, not everything in the AnyEvent API is 63As the AE API is complementary, not everything in the AnyEvent API is
68available, and you still need to use AnyEvent for the finer stuff. Also, 64available, and you still need to use AnyEvent for the finer stuff. Also,
69you should not C<use AE> directly, C<use AnyEvent> will provide the AE 65you should not C<use AE> directly, C<use AnyEvent> will provide the AE
70namespace. 66namespace.
71 67
68At the moment, these functions will become slower then their method-call
69counterparts when using L<AnyEvent::Strict> or L<AnyEvent::Debug>::wrap.
70
72=head2 FUNCTIONS 71=head2 FUNCTIONS
73 72
74This section briefly describes the alternative watcher 73This section briefly describes the alternative watcher constructors and
75constructors. Semantics are not described here; please 74other functions available inside the C<AE> namespace. Semantics are not
75described here; please refer to the description of the function or method
76refer to the L<AnyEvent> manpage for the details. 76with the same name in the L<AnyEvent> manpage for the details.
77 77
78=over 4 78=over 4
79 79
80=cut 80=cut
81 81
… …
159 159
160=item AE::postpone { BLOCK } 160=item AE::postpone { BLOCK }
161 161
162Exactly the same as C<AnyEvent:::postpone>. 162Exactly the same as C<AnyEvent:::postpone>.
163 163
164=item AE::log $level, $msg[, @args]
165
166Exactly the same as C<AnyEvent::log> (or C<AnyEvent::Log::log>).
167
164=back 168=back
165 169
166=head1 AUTHOR 170=head1 AUTHOR
167 171
168 Marc Lehmann <schmorp@schmorp.de> 172 Marc Lehmann <schmorp@schmorp.de>
169 http://home.schmorp.de/ 173 http://anyevent.schmorp.de
170 174
171=cut 175=cut
172 176
1731 1771
174 178

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines