home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _49f6e4ed9e4e3f3d35955147f75cc430 < prev    next >
Text File  |  2000-03-23  |  6KB  |  164 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>File::Spec::Win32 - methods for Win32 file specs</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::Spec::Win32 - methods for Win32 file specs</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="#see also">SEE ALSO</A></LI>
  26. </UL>
  27. <!-- INDEX END -->
  28.  
  29. <HR>
  30. <P>
  31. <H1><A NAME="name">NAME</A></H1>
  32. <P>File::Spec::Win32 - methods for Win32 file specs</P>
  33. <P>
  34. <HR>
  35. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  36. <UL>
  37. <LI>Linux</LI>
  38. <LI>Solaris</LI>
  39. <LI>Windows</LI>
  40. </UL>
  41. <HR>
  42. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  43. <PRE>
  44.  require File::Spec::Win32; # Done internally by File::Spec if needed</PRE>
  45. <P>
  46. <HR>
  47. <H1><A NAME="description">DESCRIPTION</A></H1>
  48. <P>See File::Spec::Unix for a documentation of the methods provided
  49. there. This package overrides the implementation of these methods, not
  50. the semantics.</P>
  51. <DL>
  52. <DT><STRONG><A NAME="item_devnull">devnull</A></STRONG><BR>
  53. <DD>
  54. Returns a string representation of the null device.
  55. <P></P>
  56. <DT><STRONG><A NAME="item_tmpdir">tmpdir</A></STRONG><BR>
  57. <DD>
  58. Returns a string representation of the first existing directory
  59. from the following list:
  60. <PRE>
  61.     $ENV{TMPDIR}
  62.     $ENV{TEMP}
  63.     $ENV{TMP}
  64.     /tmp
  65.     /</PRE>
  66. <P></P>
  67. <DT><STRONG><A NAME="item_catfile">catfile</A></STRONG><BR>
  68. <DD>
  69. Concatenate one or more directory names and a filename to form a
  70. complete path ending with a filename
  71. <P></P>
  72. <DT><STRONG><A NAME="item_canonpath">canonpath</A></STRONG><BR>
  73. <DD>
  74. No physical check on the filesystem, but a logical cleanup of a
  75. path. On UNIX eliminated successive slashes and successive ``/.''.
  76. <P></P>
  77. <DT><STRONG><A NAME="item_splitpath">splitpath</A></STRONG><BR>
  78. <DD>
  79. <PRE>
  80.     ($volume,$directories,$file) = File::Spec->splitpath( $path );
  81.     ($volume,$directories,$file) = File::Spec->splitpath( $path, $no_file );</PRE>
  82. <P>Splits a path in to volume, directory, and filename portions. Assumes that 
  83. the last file is a path unless the path ends in '\\', '\\.', '\\..'
  84. or $no_file is true.  On Win32 this means that $no_file true makes this return 
  85. ( $volume, $path, undef ).</P>
  86. <P>Separators accepted are \ and /.</P>
  87. <P>Volumes can be drive letters or UNC sharenames (\\server\share).</P>
  88. <P>The results can be passed to <A HREF="#catpath">catpath</A> to get back a path equivalent to
  89. (usually identical to) the original path.</P>
  90. <DT><STRONG><A NAME="item_splitdir">splitdir</A></STRONG><BR>
  91. <DD>
  92. The opposite of <A HREF="#catdir()">catdir()</A>.
  93. <PRE>
  94.     @dirs = File::Spec->splitdir( $directories );</PRE>
  95. <P>$directories must be only the directory portion of the path on systems 
  96. that have the concept of a volume or that have path syntax that differentiates
  97. files from directories.</P>
  98. <P>Unlike just splitting the directories on the separator, leading empty and 
  99. trailing directory entries can be returned, because these are significant
  100. on some OSs. So,</P>
  101. <PRE>
  102.     File::Spec->splitdir( "/a/b/c" );</PRE>
  103. <P>Yields:</P>
  104. <PRE>
  105.     ( '', 'a', 'b', '', 'c', '' )</PRE>
  106. <P></P>
  107. <DT><STRONG><A NAME="item_catpath">catpath</A></STRONG><BR>
  108. <DD>
  109. Takes volume, directory and file portions and returns an entire path. Under
  110. Unix, $volume is ignored, and this is just like catfile(). On other OSs,
  111. the $volume become significant.
  112. <P></P>
  113. <DT><STRONG><A NAME="item_abs2rel">abs2rel</A></STRONG><BR>
  114. <DD>
  115. Takes a destination path and an optional base path returns a relative path
  116. from the base path to the destination path:
  117. <PRE>
  118.     $rel_path = File::Spec->abs2rel( $destination ) ;
  119.     $rel_path = File::Spec->abs2rel( $destination, $base ) ;</PRE>
  120. <P>If $base is not present or '', then <A HREF="#cwd()">cwd()</A> is used. If $base is relative, 
  121. then it is converted to absolute form using <A HREF="#rel2abs()">rel2abs()</A>. This means that it
  122. is taken to be relative to <EM>cwd()</EM>.</P>
  123. <P>On systems with the concept of a volume, this assumes that both paths 
  124. are on the $destination volume, and ignores the $base volume.</P>
  125. <P>On systems that have a grammar that indicates filenames, this ignores the 
  126. $base filename as well. Otherwise all path components are assumed to be
  127. directories.</P>
  128. <P>If $path is relative, it is converted to absolute form using <A HREF="#rel2abs()">rel2abs()</A>.
  129. This means that it is taken to be relative to <A HREF="#cwd()">cwd()</A>.</P>
  130. <P>Based on code written by Shigio Yamaguchi.</P>
  131. <P>No checks against the filesystem are made.</P>
  132. <P></P>
  133. <DT><STRONG><A NAME="item_rel2abs">rel2abs</A></STRONG><BR>
  134. <DD>
  135. Converts a relative path to an absolute path.
  136. <PRE>
  137.     $abs_path = File::Spec->rel2abs( $destination ) ;
  138.     $abs_path = File::Spec->rel2abs( $destination, $base ) ;</PRE>
  139. <P>If $base is not present or '', then <EM>cwd()</EM> is used. If $base is relative, 
  140. then it is converted to absolute form using <A HREF="#rel2abs()">rel2abs()</A>. This means that it
  141. is taken to be relative to <A HREF="#cwd()">cwd()</A>.</P>
  142. <P>Assumes that both paths are on the $base volume, and ignores the 
  143. $destination volume.</P>
  144. <P>On systems that have a grammar that indicates filenames, this ignores the 
  145. $base filename as well. Otherwise all path components are assumed to be
  146. directories.</P>
  147. <P>If $path is absolute, it is cleaned up and returned using <A HREF="#canonpath()">canonpath()</A>.</P>
  148. <P>Based on code written by Shigio Yamaguchi.</P>
  149. <P>No checks against the filesystem are made.</P>
  150. <P></P></DL>
  151. <P>
  152. <HR>
  153. <H1><A NAME="see also">SEE ALSO</A></H1>
  154. <P><A HREF="../../../lib/File/Spec.html">the File::Spec manpage</A></P>
  155. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  156. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  157. <STRONG><P CLASS=block> File::Spec::Win32 - methods for Win32 file specs</P></STRONG>
  158. </TD></TR>
  159. </TABLE>
  160.  
  161. </BODY>
  162.  
  163. </HTML>
  164.