NAME

       File::Zglob - Extended globs.

SYNOPSIS

           use File::Zglob;

           my @files = zglob('**/*.{pm,pl}');

DESCRIPTION

       WARNINGS: THIS IS ALPHA VERSION. API MAY CHANGE WITHOUT NOTICE

       Provides a traditional Unix glob(3) functionality; returns a list of pathnames that
       matches the given pattern.

       File::Zglob provides extended glob. It supports "**/*.pm" form.

FUNCTIONS

       zglob($pattern) # => list of matched files
               my @files = zglob('**/*.[ch]');

           Unlike shell's glob, if there's no matching pathnames, () is returned.

Special chars

       A glob pattern also consists of components and separator characters. In a component,
       following characters/syntax have special meanings.

       "*" When it appears at the beginning of a component, it matches zero or more characters
           except a period (.). And it won't match if the component of the input string begins
           with a period.

           Otherwise, it matches zero or more sequence of any characters.

       "**"
           If a component is just **, it matches zero or more number of components that match *.
           For example, src/**/*.h matches all of the following patterns.

               src/*.h
               src/*/*.h
               src/*/*/*.h
               src/*/*/*/*.h
               ...

       "?" When it appears at the beginning of a component, it matches a character except a
           period (.). Otherwise, it matches any single character.

       "[chars]"
           Specifies a character set. Matches any one of the set. The syntax of chars is the same
           as perl's character set syntax.

       "{pm,pl}"
           There is alternation.

           "example.{foo,bar,baz}" matches "example.foo", "example.bar", and "example.baz"

zglob and deep recursion

       "**/*" form makes deep recursion by soft link. zglob throw exception if it's deep
       recursion.

PORTABILITY

       Win32
           Zglob supports Win32. zglob() only uses '/' as a path separator. Since zglob() accepts
           non-utf8 strings. CP932 contains '\' character as a second byte of multibyte chars.

LIMITATIONS

       File order is not compatible with shells.

AUTHOR

       Tokuhiro Matsuno <tokuhirom AAJKLFJEF GMAIL COM>

THANKS TO

       Most code was translated from gauche's fileutil.scm.

       glob_to_regex function is taken from Text::Glob.

SEE ALSO

       File::DosGlob, Text::Glob, gauche's fileutil.scm

LICENSE

       Copyright (C) Tokuhiro Matsuno

       This library is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.