view release on metacpan or  search on metacpan

lib/AnyEvent/Filesys/Watcher/ReadDirectoryChanges/Queue.pod  view on Meta::CPAN

You can also read from this handle but this is unnecessary and dangerous.

It is unnecessary because C<dequeue()> (see below) implicitely reads from the
handle until it has no more data available.  And what you can read from the
handle is nonsense (currently an arbitrary number of "1" characters).

It is also dangerous, at least for single-threaded applications, because the
call will block if there is no data available in the queue. For a
single-threaded application that would lead to a deadlock, because while
being blocked, no data can be enqueued.

=item B<enqueue(ITEMS)>

See L<Thread;:Queue/enqueue>.

=item B<dequeue([COUNT])>

See L<Thread;:Queue/dequeue>.

Note: Even if the L<handle()|/handle> you have received is ready for reading,