NAME

File::Glob::Windows - glob routine for Windows environment.

SYNOPSIS

  use File::Glob::Windows;
  
  @list = glob($path);
  
  {
      local $File::Glob::Windows::encoding = getCodePage();
      local $File::Glob::Windows::sorttype = 0;
      local $File::Glob::Windows::nocase   = 1;
      @list = glob($path);
  }

DESCRIPTION

This glob routines works correctly on Windows environment.

• Recognize system's current codepage such as 'cp932', It's multibyte character contains '\\' and '/' and '*' and '?' in second byte.
• Correctly handles current drive and currend cirectory. MS-DOS derived environments has current directory for each drive. current working directory means current directory on current drive. 'G:' means 'G:.' , not 'G:\'.
• It differs from perlglob.exe, this glob can include the wild-card specification also in the middle part of path.

INSTALL

 perl Makefile.PL
 nmake
 nmake test
 nmake install

Notice: If you have no make, and also your OS is 32bit Windows, automatically old nmake.exe is downloaded from site of Microsoft, http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe or ftp://ftp.microsoft.com/Softlib/MSLFILES/Nmake15.exe to same path of perl. You can check nmake install path by:

 perl -e "print $^X"

Notice: If your Windows OS is 64bit, you may get nmake.exe manually. please find "Windows® Server 2003 SP1 Platform SDK" and also "PSDK-amd64.exe".

FUNCTIONS

glob( $path [,$enc [,\%options]);

This function returns array of path that matches to specified $path.

Third argument is reference of hash that indicate glob option.

meta characters in path spec

 *   Match any string of characters
 ?   Match any single character

getCodePage()

This function detect current ANSI Codepage and returrns string such as "cpNNNNNN";

getCodePage_A(), getCodePage_B(),getCodePage_POSIX()

These functions are different implement to get current codepage.

OPTIONS

$File::Glob::Windows::encoding

Encoding of current codepage of OS.

$File::Glob::Windows::sorttype

• 1: sort by name.
• 2: sort by directory,name
• 3: sort by file,name
• 4: sort by name descent.
• other: no sort

$File::Glob::Windows::nocase

• 0: case sensitive
• 1: ignore case

default is 1.

SEE ALSO

perlglob, File::DosGlob, File::Glob

AUTHOR

tateisu <tateisu@gmail.com>