home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _10eefaaa0fea835c83ce6e89b336fadd < prev    next >
Text File  |  2000-03-23  |  5KB  |  133 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>File::DosGlob - DOS like globbing and then some</TITLE>
  5. <LINK REL="stylesheet" HREF="../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> File::DosGlob - DOS like globbing and then some</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#exports (by request only)">EXPORTS (by request only)</A></LI>
  26.     <LI><A HREF="#bugs">BUGS</A></LI>
  27.     <LI><A HREF="#author">AUTHOR</A></LI>
  28.     <LI><A HREF="#history">HISTORY</A></LI>
  29.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  30. </UL>
  31. <!-- INDEX END -->
  32.  
  33. <HR>
  34. <P>
  35. <H1><A NAME="name">NAME</A></H1>
  36. <P>File::DosGlob - DOS like globbing and then some</P>
  37. <P>
  38. <HR>
  39. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  40. <UL>
  41. <LI>Linux</LI>
  42. <LI>Solaris</LI>
  43. <LI>Windows</LI>
  44. </UL>
  45. <HR>
  46. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  47. <PRE>
  48.     require 5.004;</PRE>
  49. <PRE>
  50.     # override CORE::glob in current package
  51.     use File::DosGlob 'glob';</PRE>
  52. <PRE>
  53.     # override CORE::glob in ALL packages (use with extreme caution!)
  54.     use File::DosGlob 'GLOBAL_glob';</PRE>
  55. <PRE>
  56.     @perlfiles = glob  "..\\pe?l/*.p?";
  57.     print <..\\pe?l/*.p?>;</PRE>
  58. <PRE>
  59.     # from the command line (overrides only in main::)
  60.     > perl -MFile::DosGlob=glob -e "print <../pe*/*p?>"</PRE>
  61. <P>
  62. <HR>
  63. <H1><A NAME="description">DESCRIPTION</A></H1>
  64. <P>A module that implements DOS-like globbing with a few enhancements.
  65. It is largely compatible with perlglob.exe (the M$ setargv.obj
  66. version) in all but one respect--it understands wildcards in
  67. directory components.</P>
  68. <P>For example, <CODE><..\\l*b\\file/*glob.p?</CODE>> will work as expected (in
  69. that it will find something like '..\lib\File/DosGlob.pm' alright).
  70. Note that all path components are case-insensitive, and that
  71. backslashes and forward slashes are both accepted, and preserved.
  72. You may have to double the backslashes if you are putting them in
  73. literally, due to double-quotish parsing of the pattern by perl.</P>
  74. <P>Spaces in the argument delimit distinct patterns, so
  75. <A HREF="../../lib/Pod/perlfunc.html#item_glob"><CODE>glob('*.exe *.dll')</CODE></A> globs all filenames that end in <CODE>.exe</CODE>
  76. or <CODE>.dll</CODE>.  If you want to put in literal spaces in the glob
  77. pattern, you can escape them with either double quotes, or backslashes.
  78. e.g. <A HREF="../../lib/Pod/perlfunc.html#item_glob"><CODE>glob('c:/"Program Files"/*/*.dll')</CODE></A>, or
  79. <A HREF="../../lib/Pod/perlfunc.html#item_glob"><CODE>glob('c:/Program\ Files/*/*.dll')</CODE></A>.  The argument is tokenized using
  80. <CODE>Text::ParseWords::parse_line()</CODE>, so see <A HREF="../../lib/Text/ParseWords.html">the Text::ParseWords manpage</A> for details
  81. of the quoting rules used.</P>
  82. <P>Extending it to csh patterns is left as an exercise to the reader.</P>
  83. <P>
  84. <HR>
  85. <H1><A NAME="exports (by request only)">EXPORTS (by request only)</A></H1>
  86. <P><A HREF="../../lib/Pod/perlfunc.html#item_glob"><CODE>glob()</CODE></A></P>
  87. <P>
  88. <HR>
  89. <H1><A NAME="bugs">BUGS</A></H1>
  90. <P>Should probably be built into the core, and needs to stop
  91. pandering to DOS habits.  Needs a dose of optimizium too.</P>
  92. <P>
  93. <HR>
  94. <H1><A NAME="author">AUTHOR</A></H1>
  95. <P>Gurusamy Sarathy <<A HREF="mailto:gsar@activestate.com">gsar@activestate.com</A>></P>
  96. <P>
  97. <HR>
  98. <H1><A NAME="history">HISTORY</A></H1>
  99. <UL>
  100. <LI>
  101. Support for globally overriding <A HREF="../../lib/Pod/perlfunc.html#item_glob"><CODE>glob()</CODE></A> (GSAR 3-JUN-98)
  102. <P></P>
  103. <LI>
  104. Scalar context, independent iterator context fixes (GSAR 15-SEP-97)
  105. <P></P>
  106. <LI>
  107. A few dir-vs-file optimizations result in glob importation being
  108. 10 times faster than using perlglob.exe, and using perlglob.bat is
  109. only twice as slow as perlglob.exe (GSAR 28-MAY-97)
  110. <P></P>
  111. <LI>
  112. Several cleanups prompted by lack of compatible perlglob.exe
  113. under Borland (GSAR 27-MAY-97)
  114. <P></P>
  115. <LI>
  116. Initial version (GSAR 20-FEB-97)
  117. <P></P></UL>
  118. <P>
  119. <HR>
  120. <H1><A NAME="see also">SEE ALSO</A></H1>
  121. <P>perl</P>
  122. <P>perlglob.bat</P>
  123. <P>Text::ParseWords</P>
  124. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  125. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  126. <STRONG><P CLASS=block> File::DosGlob - DOS like globbing and then some</P></STRONG>
  127. </TD></TR>
  128. </TABLE>
  129.  
  130. </BODY>
  131.  
  132. </HTML>
  133.