README

NAME
    IO::AIO::LoadLimited - A tiny IO::AIO extension that allows to load
    multiple files

VERSION
    Version 0.01

SYNOPSIS
        use strict;
        use warnings;
        use IO::AIO;
        use IO::AIO::LoadLimited;

        my @pathnames = ( '/path/to/file', ...);
        my $group = aio_group sub { ... };
        my $limit = 10;
        aio_load_limited @pathnames, sub {
            my ($pathname, $content) = @_;

            warn "could not read $pathname: $!" unless defined $content;
            # whatever is neccessary...
            ...
        }, $group, $limit;

    or

        aio_load_limited @pathnames, sub {
            my ($pathname, $content) = @_;

            warn "could not read $pathname: $!" unless defined $content;
            # whatever is neccessary...
            ...
        }, sub {
             # done cb
        };

        IO::AIO::flush; # or use AnyEvent::AIO

EXPORT
    IO::AIO::LoadLimited exports aio_load_limited.

SUBROUTINES
    aio_load_limited @files, $cb, $group_or_donecb, $limit = 10;
        The function aio_load_limited loads a list of files asynchronously
        where the number of open filehandles used are limited so you don't
        hit the hard limit of your operating system. The limit is archived
        using the group and limit functionality of "IO::AIO". The callback
        $cb gets invoked once for each file with the pathname as the first
        parameter and the content of the file as the second. If the file can
        not be opened or read the content is "undef". The third parameter
        $group_or_donecb is either another callback that thats called when
        everthing is done or an IO::AIO::GRP object. The last parameter
        $limit is optional, its default value is 10.;

SEE ALSO
    IO::AIO
    AnyEvent::IO and AnyEvent::AIO

AUTHOR
    Martin Barth, "<martin at senfdax.de>"

BUGS
    Please report any bugs or feature requests to
    <https://github.com/ufobat/p5-IO-AIO-LoadLimited/issues>

SUPPORT
    You can find documentation for this module with the perldoc command.

        perldoc IO::AIO::LoadLimited

    You can also look for information at:

    *   Github: issue and request tracker (report bugs here)

        <https://github.com/ufobat/p5-IO-AIO-LoadLimited/issues>

    *   AnnoCPAN: Annotated CPAN documentation

        <http://annocpan.org/dist/IO-AIO-LoadLimited>

    *   CPAN Ratings

        <http://cpanratings.perl.org/d/IO-AIO-LoadLimited>

    *   Search CPAN

        <http://search.cpan.org/dist/IO-AIO-LoadLimited/>

ACKNOWLEDGEMENTS
    Thanks to M.Lehmann for IO::AIO and thanks to www.netdescribe.com.
    Thanks to Moritz Lenz and Steffen Winkler for reviewing.

LICENSE AND COPYRIGHT
    Copyright 2017 Martin Barth.

    This program is free software; you can redistribute it and/or modify it
    under the terms of either: the GNU General Public License as published
    by the Free Software Foundation; or the Artistic License.

    See <http://dev.perl.org/licenses/> for more information.