diff mayachemtools/docs/modules/html/code/FileUtil.html @ 0:73ae111cf86f draft

Uploaded
author deepakjadmin
date Wed, 20 Jan 2016 11:55:01 -0500
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mayachemtools/docs/modules/html/code/FileUtil.html	Wed Jan 20 11:55:01 2016 -0500
@@ -0,0 +1,448 @@
+<html>
+<head>
+<title>MayaChemTools:Code:FileUtil.pm</title>
+<meta http-equiv="content-type" content="text/html;charset=utf-8">
+<link rel="stylesheet" type="text/css" href="../../../css/MayaChemToolsCode.css">
+</head>
+<body leftmargin="20" rightmargin="20" topmargin="10" bottommargin="10">
+<br/>
+<center>
+<a href="http://www.mayachemtools.org" title="MayaChemTools Home"><img src="../../../images/MayaChemToolsLogo.gif" border="0" alt="MayaChemTools"></a>
+</center>
+<br/>
+<pre>
+<a name="package-FileUtil-"></a>   1 <span class="k">package </span><span class="i">FileUtil</span><span class="sc">;</span>
+   2 <span class="c">#</span>
+   3 <span class="c"># $RCSfile: FileUtil.pm,v $</span>
+   4 <span class="c"># $Date: 2015/02/28 20:47:17 $</span>
+   5 <span class="c"># $Revision: 1.40 $</span>
+   6 <span class="c">#</span>
+   7 <span class="c"># Author: Manish Sud &lt;msud@san.rr.com&gt;</span>
+   8 <span class="c">#</span>
+   9 <span class="c"># Copyright (C) 2015 Manish Sud. All rights reserved.</span>
+  10 <span class="c">#</span>
+  11 <span class="c"># This file is part of MayaChemTools.</span>
+  12 <span class="c">#</span>
+  13 <span class="c"># MayaChemTools is free software; you can redistribute it and/or modify it under</span>
+  14 <span class="c"># the terms of the GNU Lesser General Public License as published by the Free</span>
+  15 <span class="c"># Software Foundation; either version 3 of the License, or (at your option) any</span>
+  16 <span class="c"># later version.</span>
+  17 <span class="c">#</span>
+  18 <span class="c"># MayaChemTools is distributed in the hope that it will be useful, but without</span>
+  19 <span class="c"># any warranty; without even the implied warranty of merchantability of fitness</span>
+  20 <span class="c"># for a particular purpose.  See the GNU Lesser General Public License for more</span>
+  21 <span class="c"># details.</span>
+  22 <span class="c">#</span>
+  23 <span class="c"># You should have received a copy of the GNU Lesser General Public License</span>
+  24 <span class="c"># along with MayaChemTools; if not, see &lt;http://www.gnu.org/licenses/&gt; or</span>
+  25 <span class="c"># write to the Free Software Foundation Inc., 59 Temple Place, Suite 330,</span>
+  26 <span class="c"># Boston, MA, 02111-1307, USA.</span>
+  27 <span class="c">#</span>
+  28 
+  29 <span class="k">use</span> <span class="w">strict</span><span class="sc">;</span>
+  30 <span class="k">use</span> <span class="w">Exporter</span><span class="sc">;</span>
+  31 <span class="k">use</span> <span class="w">Carp</span><span class="sc">;</span>
+  32 <span class="k">use</span> <span class="w">File::stat</span><span class="sc">;</span>
+  33 <span class="k">use</span> <span class="w">Time::localtime</span> <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
+  34 <span class="k">use</span> <span class="w">TextUtil</span> <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
+  35 
+  36 <span class="k">use</span> <span class="w">vars</span> <span class="q">qw(@ISA @EXPORT @EXPORT_OK %EXPORT_TAGS)</span><span class="sc">;</span>
+  37 
+  38 <span class="i">@ISA</span> = <span class="q">qw(Exporter)</span><span class="sc">;</span>
+  39 <span class="i">@EXPORT</span> = <span class="q">qw(CheckFileType ConvertCygwinPath ExpandFileNames FileModificationTimeAndDate FormattedFileModificationTimeAndDate FileSize FormatFileSize GetMayaChemToolsLibDirName GetUsageFromPod ParseFileName)</span><span class="sc">;</span>
+  40 <span class="i">@EXPORT_OK</span> = <span class="q">qw()</span><span class="sc">;</span>
+  41 <span class="i">%EXPORT_TAGS</span> = <span class="s">(</span><span class="w">all</span>  <span class="cm">=&gt;</span> <span class="s">[</span><span class="i">@EXPORT</span><span class="cm">,</span> <span class="i">@EXPORT_OK</span><span class="s">]</span><span class="s">)</span><span class="sc">;</span>
+  42 
+  43 <span class="c"># Setup package variables...</span>
+  44 <span class="k">my</span><span class="s">(</span><span class="i">$MayaChemToolsLibDir</span><span class="s">)</span><span class="sc">;</span>
+  45 
+  46 <span class="c"># Check to see path contains cygdrive and convert it into windows path...</span>
+<a name="ConvertCygwinPath-"></a>  47 <span class="k">sub </span><span class="m">ConvertCygwinPath</span> <span class="s">{</span>
+  48   <span class="k">my</span><span class="s">(</span><span class="i">$Path</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
+  49   <span class="k">my</span><span class="s">(</span><span class="i">$NewPath</span><span class="cm">,</span> <span class="i">$OSName</span><span class="s">)</span><span class="sc">;</span>
+  50 
+  51   <span class="i">$NewPath</span> = <span class="i">$Path</span><span class="sc">;</span> <span class="i">$OSName</span> = <span class="i">$^O</span><span class="sc">;</span>
+  52   <span class="k">if</span> <span class="s">(</span><span class="i">$OSName</span> =~ <span class="q">/cygwin/i</span> &amp;&amp; <span class="i">$Path</span> =~ <span class="q">/cygdrive/i</span> <span class="s">)</span> <span class="s">{</span>
+  53     <span class="k">my</span><span class="s">(</span><span class="i">@PathParts</span><span class="s">)</span> = <span class="k">split</span> <span class="q">&quot;\/&quot;</span><span class="cm">,</span> <span class="i">$Path</span><span class="sc">;</span>
+  54     <span class="k">my</span><span class="s">(</span><span class="i">$Drive</span><span class="s">)</span> = <span class="i">$PathParts</span>[<span class="n">2</span>]<span class="sc">;</span>
+  55     <span class="k">shift</span> <span class="i">@PathParts</span><span class="sc">;</span> <span class="k">shift</span> <span class="i">@PathParts</span><span class="sc">;</span> <span class="k">shift</span> <span class="i">@PathParts</span><span class="sc">;</span>
+  56     <span class="i">$NewPath</span> = <span class="k">join</span> <span class="q">&quot;\/&quot;</span><span class="cm">,</span> <span class="i">@PathParts</span><span class="sc">;</span>
+  57     <span class="i">$NewPath</span> = <span class="i">$Drive</span>. <span class="q">&quot;:\/&quot;</span> . <span class="i">$NewPath</span><span class="sc">;</span>
+  58   <span class="s">}</span>
+  59   <span class="k">return</span> <span class="i">$NewPath</span><span class="sc">;</span>
+  60 <span class="s">}</span>
+  61 
+  62 <span class="c"># Based on the file name extension, figure out its type.</span>
+<a name="CheckFileType-"></a>  63 <span class="k">sub </span><span class="m">CheckFileType</span> <span class="s">{</span>
+  64   <span class="k">my</span><span class="s">(</span><span class="i">$FileName</span><span class="cm">,</span> <span class="i">$FileExts</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
+  65   <span class="k">my</span><span class="s">(</span><span class="i">$Status</span><span class="cm">,</span> <span class="i">@FileExtsList</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">$Ext</span><span class="s">)</span><span class="sc">;</span>
+  66 
+  67   <span class="i">$Status</span> = <span class="n">0</span><span class="sc">;</span>
+  68   <span class="i">@FileExtsList</span> = <span class="k">split</span> <span class="q">&quot; &quot;</span><span class="cm">,</span> <span class="i">$FileExts</span><span class="sc">;</span>
+  69   <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#FileExtsList</span><span class="s">)</span> <span class="s">{</span>
+  70     <span class="i">$Ext</span> = <span class="i">$FileExtsList</span>[<span class="i">$Index</span>]<span class="sc">;</span>
+  71     <span class="k">if</span> <span class="s">(</span><span class="i">$FileName</span> =~ <span class="q">/(\.$Ext)$/i</span><span class="s">)</span> <span class="s">{</span>
+  72       <span class="i">$Status</span> = <span class="n">1</span><span class="sc">;</span>
+  73     <span class="s">}</span>
+  74   <span class="s">}</span>
+  75   <span class="k">return</span> <span class="s">(</span><span class="i">$Status</span><span class="s">)</span><span class="sc">;</span>
+  76 <span class="s">}</span>
+  77 
+  78 <span class="c"># Expand file names using specified directory and/or file names along with any</span>
+  79 <span class="c"># file extensions containing one or more wild cards. And return the expanded</span>
+  80 <span class="c"># list.</span>
+  81 <span class="c">#</span>
+  82 <span class="c"># IncludeDirName controls whether directory prefixes are included in expanded</span>
+  83 <span class="c"># file names. Default is to always append directory name before expanded file</span>
+  84 <span class="c"># name.</span>
+  85 <span class="c">#</span>
+  86 <span class="c"># Notes:</span>
+  87 <span class="c">#   . Multiple file extensions are delimited by spaces.</span>
+  88 <span class="c">#   . Wild card, *, is supported in directory and file names along with file</span>
+  89 <span class="c">#     extensions.</span>
+  90 <span class="c">#   . For a specified directory name in the files list, all the files in the</span>
+  91 <span class="c">#     directory are retrieved using Perl opendir function and files filtered using file</span>
+  92 <span class="c">#     extensions. The file names &quot;.&quot; and &quot;..&quot; returned by opendir are ignored.</span>
+  93 <span class="c">#   . For file names containing wild cards with and without any explicit file</span>
+  94 <span class="c">#     extension specification in the file name, all the files in the directory are retrieved</span>
+  95 <span class="c">#     using Perl opendir function and files filtered using file name along with any</span>
+  96 <span class="c">#     file extension. The file names &quot;.&quot; and &quot;..&quot; returned by opendir are ignored.</span>
+  97 <span class="c">#</span>
+<a name="ExpandFileNames-"></a>  98 <span class="k">sub </span><span class="m">ExpandFileNames</span> <span class="s">{</span>
+  99   <span class="k">my</span><span class="s">(</span><span class="i">$Files</span><span class="cm">,</span> <span class="i">$FileExts</span><span class="cm">,</span> <span class="i">$IncludeDirName</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
+ 100   <span class="k">my</span><span class="s">(</span><span class="i">$FileName</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">$Delimiter</span><span class="cm">,</span> <span class="i">$FileExtsPattern</span><span class="cm">,</span> <span class="i">@FilesList</span><span class="cm">,</span> <span class="i">@DirFileNames</span><span class="s">)</span><span class="sc">;</span>
+ 101 
+ 102   <span class="c"># Check whether to include directory name in expanded file names...</span>
+ 103   <span class="i">$IncludeDirName</span> = <span class="k">defined</span> <span class="i">$IncludeDirName</span> ? <span class="i">$IncludeDirName</span> <span class="co">:</span> <span class="n">1</span><span class="sc">;</span>
+ 104 
+ 105   <span class="c"># Setup file externsions...</span>
+ 106   <span class="i">$FileExtsPattern</span> = <span class="q">&quot;&quot;</span><span class="sc">;</span>
+ 107   <span class="k">if</span> <span class="s">(</span><span class="i">$FileExts</span><span class="s">)</span> <span class="s">{</span>
+ 108     <span class="i">$FileExtsPattern</span> = <span class="k">join</span> <span class="q">&quot;|&quot;</span><span class="cm">,</span> <span class="k">split</span> <span class="q">&quot; &quot;</span><span class="cm">,</span> <span class="i">$FileExts</span><span class="sc">;</span>
+ 109     <span class="k">if</span> <span class="s">(</span><span class="i">$FileExtsPattern</span> =~ <span class="q">/\*/</span><span class="s">)</span> <span class="s">{</span>
+ 110       <span class="c"># Replace * by .*? for greedy match...</span>
+ 111       <span class="i">$FileExtsPattern</span> =~ <span class="q">s/\*/\.\*\?/g</span><span class="sc">;</span>
+ 112     <span class="s">}</span>
+ 113   <span class="s">}</span>
+ 114 
+ 115   <span class="i">@FilesList</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
+ 116 
+ 117   <span class="j">FILEINDEX:</span> <span class="k">for</span> <span class="s">(</span><span class="i">$Index</span> = <span class="n">0</span><span class="sc">;</span> <span class="i">$Index</span> &lt; <span class="i">@$Files</span><span class="sc">;</span> <span class="i">$Index</span>++<span class="s">)</span> <span class="s">{</span>
+ 118     <span class="i">$FileName</span> = <span class="i">@$Files</span>[<span class="i">$Index</span>]<span class="sc">;</span>
+ 119     <span class="i">$Delimiter</span> = <span class="q">&quot;\/&quot;</span><span class="sc">;</span>
+ 120     <span class="k">if</span> <span class="s">(</span><span class="i">$FileName</span> =~ <span class="q">/\\/</span> <span class="s">)</span> <span class="s">{</span>
+ 121       <span class="i">$Delimiter</span> = <span class="q">&quot;\\&quot;</span><span class="sc">;</span>
+ 122     <span class="s">}</span>
+ 123 
+ 124     <span class="k">if</span> <span class="s">(</span><span class="k">-d</span> <span class="i">$FileName</span><span class="s">)</span> <span class="s">{</span>
+ 125       <span class="k">my</span><span class="s">(</span><span class="i">$DirName</span><span class="cm">,</span> <span class="i">$DirNamePrefix</span><span class="s">)</span><span class="sc">;</span>
+ 126 
+ 127       <span class="i">$DirName</span> = <span class="i">$FileName</span><span class="sc">;</span>
+ 128       <span class="i">$DirNamePrefix</span> = <span class="i">$IncludeDirName</span> ? <span class="q">&quot;$DirName$Delimiter&quot;</span> <span class="co">:</span> <span class="q">&quot;&quot;</span><span class="sc">;</span>
+ 129 
+ 130       <span class="c"># glob doesn&#39;t appear to work during command line invocation from Windows.</span>
+ 131       <span class="c"># So, use opendir to make it work...</span>
+ 132       <span class="c">#</span>
+ 133       <span class="c"># push @FilesList,  map {glob(&quot;$DirName/*.$_&quot;)} split &quot; &quot;, $FileExts;</span>
+ 134       <span class="c">#</span>
+ 135       <span class="i">@DirFileNames</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
+ 136       <span class="k">if</span> <span class="s">(</span>!<span class="k">opendir</span> <span class="w">DIRNAME</span><span class="cm">,</span> <span class="i">$DirName</span><span class="s">)</span> <span class="s">{</span>
+ 137         <span class="w">carp</span> <span class="q">&quot;Warning: Ignoring directory $DirName: Couldn&#39;t open it: $! ...&quot;</span><span class="sc">;</span>
+ 138         <span class="k">next</span> <span class="j">FILEINDEX</span><span class="sc">;</span>
+ 139       <span class="s">}</span>
+ 140 
+ 141       <span class="c"># Collect file names without &#39;.&#39; and &#39;..&#39; as readdir function places them on the list...</span>
+ 142       <span class="c">#</span>
+ 143       <span class="i">@DirFileNames</span> = <span class="k">map</span> <span class="s">{</span> <span class="q">&quot;$DirNamePrefix$_&quot;</span>  <span class="s">}</span> <span class="k">grep</span> <span class="s">{</span> !<span class="q">/^(\.|\.\.)$/</span> <span class="s">}</span> <span class="k">readdir</span> <span class="w">DIRNAME</span><span class="sc">;</span>
+ 144       <span class="k">closedir</span> <span class="w">DIRNAME</span><span class="sc">;</span>
+ 145 
+ 146       <span class="c"># Collect files with any specified file extensions...</span>
+ 147       <span class="k">if</span> <span class="s">(</span><span class="i">$FileExtsPattern</span><span class="s">)</span> <span class="s">{</span>
+ 148         <span class="i">@DirFileNames</span> = <span class="k">grep</span> <span class="s">{</span> <span class="q">/\.$FileExtsPattern$/</span> <span class="s">}</span> <span class="i">@DirFileNames</span><span class="sc">;</span>
+ 149       <span class="s">}</span>
+ 150 
+ 151       <span class="k">push</span> <span class="i">@FilesList</span><span class="cm">,</span> <span class="i">@DirFileNames</span><span class="sc">;</span>
+ 152     <span class="s">}</span>
+ 153     <span class="k">elsif</span> <span class="s">(</span><span class="i">$FileName</span> =~ <span class="q">/\*/</span><span class="s">)</span> <span class="s">{</span>
+ 154       <span class="k">my</span><span class="s">(</span><span class="i">$FileDir</span><span class="cm">,</span> <span class="i">$Name</span><span class="cm">,</span> <span class="i">$FileExt</span><span class="cm">,</span> <span class="i">$DirNamePrefix</span><span class="s">)</span><span class="sc">;</span>
+ 155 
+ 156       <span class="c"># Filenames are not expanded during command line invocation from Windows...</span>
+ 157       <span class="s">(</span><span class="i">$FileDir</span><span class="cm">,</span> <span class="i">$Name</span><span class="cm">,</span> <span class="i">$FileExt</span><span class="s">)</span> = <span class="i">ParseFileName</span><span class="s">(</span><span class="i">$FileName</span><span class="s">)</span><span class="sc">;</span>
+ 158 
+ 159       <span class="i">$DirNamePrefix</span> = <span class="i">$IncludeDirName</span> ? <span class="q">&quot;$FileDir$Delimiter&quot;</span> <span class="co">:</span> <span class="q">&quot;&quot;</span><span class="sc">;</span>
+ 160 
+ 161       <span class="i">@DirFileNames</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
+ 162       <span class="k">if</span> <span class="s">(</span>!<span class="k">opendir</span> <span class="w">FILEDIR</span><span class="cm">,</span> <span class="i">$FileDir</span><span class="s">)</span> <span class="s">{</span>
+ 163         <span class="w">carp</span> <span class="q">&quot;Warning: Ignoring files $FileName: Couldn&#39;t open directory $FileDir: $! ...&quot;</span><span class="sc">;</span>
+ 164         <span class="k">next</span> <span class="j">FILEINDEX</span><span class="sc">;</span>
+ 165       <span class="s">}</span>
+ 166 
+ 167       <span class="c"># Collect file names without &#39;.&#39; and &#39;..&#39; as readdir function places them on the list...</span>
+ 168       <span class="c">#</span>
+ 169       <span class="i">@DirFileNames</span> = <span class="k">map</span> <span class="s">{</span> <span class="q">&quot;$DirNamePrefix$_&quot;</span>  <span class="s">}</span> <span class="k">grep</span> <span class="s">{</span> !<span class="q">/^(\.|\.\.)$/</span> <span class="s">}</span> <span class="k">readdir</span> <span class="w">FILEDIR</span><span class="sc">;</span>
+ 170       <span class="k">closedir</span> <span class="w">FILEDIR</span><span class="sc">;</span>
+ 171 
+ 172       <span class="k">if</span> <span class="s">(</span><span class="k">length</span><span class="s">(</span><span class="i">$Name</span><span class="s">)</span> &gt; <span class="n">1</span><span class="s">)</span> <span class="s">{</span>
+ 173         <span class="c"># Replace * by .*? for greedy match...</span>
+ 174         <span class="i">$Name</span> =~ <span class="q">s/\*/\.\*\?/g</span><span class="sc">;</span>
+ 175         <span class="i">@DirFileNames</span> =  <span class="k">grep</span> <span class="s">{</span> <span class="q">/$Name/</span> <span class="s">}</span> <span class="i">@DirFileNames</span><span class="sc">;</span>
+ 176       <span class="s">}</span>
+ 177 
+ 178       <span class="k">if</span> <span class="s">(</span><span class="i">$FileExt</span><span class="s">)</span> <span class="s">{</span>
+ 179         <span class="i">$FileExt</span> =~ <span class="q">s/\*/\.\*\?/g</span><span class="sc">;</span>
+ 180         <span class="i">@DirFileNames</span> =  <span class="k">grep</span> <span class="s">{</span> <span class="q">/\.$FileExt$/</span> <span class="s">}</span> <span class="i">@DirFileNames</span><span class="sc">;</span>
+ 181       <span class="s">}</span>
+ 182       <span class="k">elsif</span> <span class="s">(</span><span class="i">$FileExtsPattern</span><span class="s">)</span> <span class="s">{</span>
+ 183         <span class="i">@DirFileNames</span> = <span class="k">grep</span> <span class="s">{</span> <span class="q">/\.$FileExtsPattern$/</span> <span class="s">}</span> <span class="i">@DirFileNames</span><span class="sc">;</span>
+ 184       <span class="s">}</span>
+ 185 
+ 186       <span class="k">push</span> <span class="i">@FilesList</span><span class="cm">,</span> <span class="i">@DirFileNames</span><span class="sc">;</span>
+ 187     <span class="s">}</span>
+ 188     <span class="k">else</span> <span class="s">{</span>
+ 189       <span class="k">push</span> <span class="i">@FilesList</span><span class="cm">,</span> <span class="i">$FileName</span><span class="sc">;</span>
+ 190     <span class="s">}</span>
+ 191   <span class="s">}</span>
+ 192   <span class="k">return</span> <span class="i">@FilesList</span><span class="sc">;</span>
+ 193 <span class="s">}</span>
+ 194 
+ 195 <span class="c"># Formatted file modification time...</span>
+<a name="FormattedFileModificationTimeAndDate-"></a> 196 <span class="k">sub </span><span class="m">FormattedFileModificationTimeAndDate</span> <span class="s">{</span>
+ 197   <span class="k">my</span><span class="s">(</span><span class="i">$FileName</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
+ 198   <span class="k">my</span><span class="s">(</span><span class="i">$TimeString</span><span class="cm">,</span> <span class="i">$DateString</span><span class="s">)</span> = <span class="s">(</span><span class="q">&#39;&#39;</span><span class="s">)</span> x <span class="n">2</span><span class="sc">;</span>
+ 199 
+ 200   <span class="k">if</span> <span class="s">(</span>! <span class="k">-e</span> <span class="i">$FileName</span><span class="s">)</span> <span class="s">{</span>
+ 201     <span class="k">return</span> <span class="s">(</span><span class="i">$TimeString</span><span class="cm">,</span> <span class="i">$DateString</span><span class="s">)</span><span class="sc">;</span>
+ 202   <span class="s">}</span>
+ 203   <span class="k">my</span><span class="s">(</span><span class="i">$Hours</span><span class="cm">,</span> <span class="i">$Mins</span><span class="cm">,</span> <span class="i">$Secs</span><span class="cm">,</span> <span class="i">$DayName</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="cm">,</span> <span class="i">$Month</span><span class="cm">,</span> <span class="i">$Year</span><span class="s">)</span> = <span class="i">FileModificationTimeAndDate</span><span class="s">(</span><span class="i">$FileName</span><span class="s">)</span><span class="sc">;</span>
+ 204 
+ 205   <span class="c"># Setup time suffix...</span>
+ 206   <span class="k">my</span><span class="s">(</span><span class="i">$TimeSuffix</span><span class="s">)</span> = <span class="q">&#39;&#39;</span><span class="sc">;</span>
+ 207   <span class="k">if</span> <span class="s">(</span><span class="i">$Hours</span> &lt; <span class="n">12</span><span class="s">)</span> <span class="s">{</span>
+ 208     <span class="i">$TimeSuffix</span> = <span class="q">&#39;AM&#39;</span><span class="sc">;</span>
+ 209   <span class="s">}</span>
+ 210   <span class="k">elsif</span> <span class="s">(</span><span class="i">$Hours</span> &gt; <span class="n">12</span><span class="s">)</span> <span class="s">{</span>
+ 211     <span class="i">$TimeSuffix</span> = <span class="q">&#39;PM&#39;</span><span class="sc">;</span>
+ 212     <span class="i">$Hours</span> = <span class="i">$Hours</span> - <span class="n">12</span><span class="sc">;</span>
+ 213   <span class="s">}</span>
+ 214   <span class="k">elsif</span> <span class="s">(</span><span class="i">$Hours</span> == <span class="n">12</span> &amp;&amp; <span class="s">(</span><span class="i">$Mins</span> &gt; <span class="n">0</span> || <span class="i">$Secs</span> &gt; <span class="n">0</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
+ 215     <span class="i">$TimeSuffix</span> = <span class="q">&#39;PM&#39;</span><span class="sc">;</span>
+ 216   <span class="s">}</span>
+ 217   <span class="k">elsif</span> <span class="s">(</span><span class="i">$Hours</span> == <span class="n">12</span> &amp;&amp; <span class="i">$Mins</span> == <span class="n">0</span> &amp;&amp; <span class="i">$Secs</span> == <span class="n">0</span><span class="s">)</span> <span class="s">{</span>
+ 218     <span class="i">$TimeSuffix</span> = <span class="q">&#39;Noon&#39;</span><span class="sc">;</span>
+ 219   <span class="s">}</span>
+ 220 
+ 221   <span class="i">$Month</span> = <span class="i">TextUtil::AddNumberSuffix</span><span class="s">(</span><span class="i">$Month</span><span class="s">)</span><span class="sc">;</span>
+ 222 
+ 223   <span class="i">$TimeString</span> = <span class="q">&quot;${DayName} ${Hours}:${Mins}:${Secs} ${TimeSuffix}&quot;</span><span class="sc">;</span>
+ 224   <span class="i">$DateString</span> = <span class="q">&quot;${MonthName} ${Month}, ${Year}&quot;</span><span class="sc">;</span>
+ 225 
+ 226   <span class="k">return</span> <span class="s">(</span><span class="i">$TimeString</span><span class="cm">,</span> <span class="i">$DateString</span><span class="s">)</span><span class="sc">;</span>
+ 227 <span class="s">}</span>
+ 228 
+ 229 <span class="c"># File modifcation time and date...</span>
+<a name="FileModificationTimeAndDate-"></a> 230 <span class="k">sub </span><span class="m">FileModificationTimeAndDate</span> <span class="s">{</span>
+ 231   <span class="k">my</span><span class="s">(</span><span class="i">$FileName</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
+ 232   <span class="k">my</span><span class="s">(</span><span class="i">$Hours</span><span class="cm">,</span> <span class="i">$Mins</span><span class="cm">,</span> <span class="i">$Secs</span><span class="cm">,</span> <span class="i">$DayName</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="cm">,</span> <span class="i">$Month</span><span class="cm">,</span> <span class="i">$Year</span><span class="s">)</span> = <span class="s">(</span><span class="q">&#39;&#39;</span><span class="s">)</span> x <span class="n">7</span><span class="sc">;</span>
+ 233 
+ 234   <span class="k">if</span> <span class="s">(</span>! <span class="k">-e</span> <span class="i">$FileName</span><span class="s">)</span> <span class="s">{</span>
+ 235     <span class="k">return</span> <span class="s">(</span><span class="i">$Hours</span><span class="cm">,</span> <span class="i">$Mins</span><span class="cm">,</span> <span class="i">$Secs</span><span class="cm">,</span> <span class="i">$DayName</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="cm">,</span> <span class="i">$Month</span><span class="cm">,</span> <span class="i">$Year</span><span class="s">)</span><span class="sc">;</span>
+ 236   <span class="s">}</span>
+ 237 
+ 238   <span class="k">my</span><span class="s">(</span><span class="i">$CTimeString</span><span class="cm">,</span> <span class="i">$FileStatRef</span><span class="cm">,</span> <span class="i">$TimeStamp</span><span class="s">)</span><span class="sc">;</span>
+ 239   <span class="i">$FileStatRef</span> = <span class="k">stat</span><span class="s">(</span><span class="i">$FileName</span><span class="s">)</span><span class="sc">;</span>
+ 240 
+ 241   <span class="i">$CTimeString</span> = <span class="i">Time::localtime::ctime</span><span class="s">(</span><span class="i">$FileStatRef</span><span class="i">-&gt;mtime</span><span class="s">)</span><span class="sc">;</span>
+ 242 
+ 243   <span class="c"># ctime returns: Thu Aug 3 10:13:53 2006</span>
+ 244   <span class="s">(</span><span class="i">$DayName</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="cm">,</span> <span class="i">$Month</span><span class="cm">,</span> <span class="i">$TimeStamp</span><span class="cm">,</span> <span class="i">$Year</span><span class="s">)</span> = <span class="k">split</span> <span class="q">/[ ]+/</span><span class="cm">,</span> <span class="i">$CTimeString</span><span class="sc">;</span>
+ 245   <span class="s">(</span><span class="i">$Hours</span><span class="cm">,</span> <span class="i">$Mins</span><span class="cm">,</span> <span class="i">$Secs</span><span class="s">)</span> = <span class="k">split</span> <span class="q">/\:/</span><span class="cm">,</span> <span class="i">$TimeStamp</span><span class="sc">;</span>
+ 246 
+ 247   <span class="k">return</span> <span class="s">(</span><span class="i">$Hours</span><span class="cm">,</span> <span class="i">$Mins</span><span class="cm">,</span> <span class="i">$Secs</span><span class="cm">,</span> <span class="i">$DayName</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="cm">,</span> <span class="i">$Month</span><span class="cm">,</span> <span class="i">$Year</span><span class="s">)</span><span class="sc">;</span>
+ 248 <span class="s">}</span>
+ 249 
+ 250 <span class="c"># Format file size...</span>
+<a name="FormatFileSize-"></a> 251 <span class="k">sub </span><span class="m">FormatFileSize</span> <span class="s">{</span>
+ 252   <span class="k">my</span><span class="s">(</span><span class="i">$Precision</span><span class="cm">,</span> <span class="i">$Size</span><span class="s">)</span><span class="sc">;</span>
+ 253 
+ 254   <span class="i">$Precision</span> = <span class="n">1</span><span class="sc">;</span>
+ 255   <span class="k">if</span> <span class="s">(</span><span class="i">@_</span> == <span class="n">2</span><span class="s">)</span> <span class="s">{</span>
+ 256     <span class="s">(</span><span class="i">$Size</span><span class="cm">,</span> <span class="i">$Precision</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
+ 257   <span class="s">}</span>
+ 258   <span class="k">else</span> <span class="s">{</span>
+ 259     <span class="s">(</span><span class="i">$Size</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
+ 260   <span class="s">}</span>
+ 261   <span class="k">my</span><span class="s">(</span><span class="i">$SizeDenominator</span><span class="cm">,</span> <span class="i">$SizeSuffix</span><span class="s">)</span><span class="sc">;</span>
+ 262   <span class="j">FORMAT:</span> <span class="s">{</span>
+ 263       <span class="k">if</span> <span class="s">(</span><span class="i">$Size</span> &lt; <span class="n">1024</span><span class="s">)</span> <span class="s">{</span> <span class="i">$SizeDenominator</span> = <span class="n">1</span><span class="sc">;</span> <span class="i">$SizeSuffix</span> = <span class="q">&#39;bytes&#39;</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span><span class="s">}</span>
+ 264       <span class="k">if</span> <span class="s">(</span><span class="i">$Size</span> &lt; <span class="s">(</span><span class="n">1024</span>*<span class="n">1024</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span> <span class="i">$SizeDenominator</span> = <span class="n">1024</span><span class="sc">;</span> <span class="i">$SizeSuffix</span> = <span class="q">&#39;KB&#39;</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span><span class="s">}</span>
+ 265       <span class="k">if</span> <span class="s">(</span><span class="i">$Size</span> &lt; <span class="s">(</span><span class="n">1024</span>*<span class="n">1024</span>*<span class="n">1024</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span> <span class="i">$SizeDenominator</span> = <span class="n">1024</span>*<span class="n">1024</span><span class="sc">;</span> <span class="i">$SizeSuffix</span> = <span class="q">&#39;MB&#39;</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span><span class="s">}</span>
+ 266       <span class="k">if</span> <span class="s">(</span><span class="i">$Size</span> &lt; <span class="s">(</span><span class="n">1024</span>*<span class="n">1024</span>*<span class="n">1024</span>*<span class="n">1024</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span> <span class="i">$SizeDenominator</span> = <span class="n">1024</span>*<span class="n">1024</span>*<span class="n">1024</span><span class="sc">;</span> <span class="i">$SizeSuffix</span> = <span class="q">&#39;GB&#39;</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span><span class="s">}</span>
+ 267       <span class="i">$SizeDenominator</span> = <span class="n">1</span><span class="sc">;</span> <span class="i">$SizeSuffix</span> = <span class="q">&#39;bytes&#39;</span><span class="sc">;</span>
+ 268     <span class="s">}</span>
+ 269   <span class="i">$Size</span> /= <span class="i">$SizeDenominator</span><span class="sc">;</span>
+ 270   <span class="i">$Size</span> = <span class="k">sprintf</span><span class="s">(</span><span class="q">&quot;%.${Precision}f&quot;</span><span class="cm">,</span> <span class="i">$Size</span><span class="s">)</span> + <span class="n">0</span><span class="sc">;</span>
+ 271   <span class="i">$Size</span> = <span class="q">&quot;$Size $SizeSuffix&quot;</span><span class="sc">;</span>
+ 272 
+ 273   <span class="k">return</span> <span class="i">$Size</span><span class="sc">;</span>
+ 274 <span class="s">}</span>
+ 275 
+ 276 <span class="c"># Get file size in bytes...</span>
+<a name="FileSize-"></a> 277 <span class="k">sub </span><span class="m">FileSize</span> <span class="s">{</span>
+ 278   <span class="k">my</span><span class="s">(</span><span class="i">$File</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
+ 279 
+ 280   <span class="k">if</span> <span class="s">(</span>! <span class="k">-e</span> <span class="i">$File</span><span class="s">)</span> <span class="s">{</span>
+ 281     <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span>
+ 282   <span class="s">}</span>
+ 283   <span class="k">return</span> <span class="s">(</span><span class="k">-s</span> <span class="i">$File</span><span class="s">)</span>
+ 284 <span class="s">}</span>
+ 285 
+ 286 <span class="c"># Get MayaChemTool&#39;s lib directory name using @INC to extract</span>
+ 287 <span class="c"># &lt;MAYACHEMTOOLS&gt;/lib directory location: first entry in @INC path should contain</span>
+ 288 <span class="c"># MayaChemTools modules location</span>
+ 289 <span class="c">#</span>
+<a name="GetMayaChemToolsLibDirName-"></a> 290 <span class="k">sub </span><span class="m">GetMayaChemToolsLibDirName</span> <span class="s">{</span>
+ 291 
+ 292   <span class="k">if</span> <span class="s">(</span><span class="k">defined</span> <span class="i">$MayaChemToolsLibDir</span><span class="s">)</span> <span class="s">{</span>
+ 293     <span class="k">return</span> <span class="i">$MayaChemToolsLibDir</span><span class="sc">;</span>
+ 294   <span class="s">}</span>
+ 295 
+ 296   <span class="i">$MayaChemToolsLibDir</span> = <span class="q">&quot;&quot;</span><span class="sc">;</span>
+ 297   <span class="k">if</span> <span class="s">(</span><span class="i">$INC</span>[<span class="n">0</span>] =~ <span class="q">/MayaChemTools/i</span><span class="s">)</span> <span class="s">{</span>
+ 298     <span class="i">$MayaChemToolsLibDir</span> = <span class="i">$INC</span>[<span class="n">0</span>]<span class="sc">;</span>
+ 299   <span class="s">}</span>
+ 300   <span class="k">else</span> <span class="s">{</span>
+ 301     <span class="c"># Go through rest of the entries...</span>
+ 302     <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="s">)</span><span class="sc">;</span>
+ 303     <span class="j">INDEX:</span> <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">1</span> .. <span class="i">$#INC</span><span class="s">)</span> <span class="s">{</span>
+ 304       <span class="k">if</span> <span class="s">(</span><span class="i">$INC</span>[<span class="i">$Index</span>] =~ <span class="q">/MayaChemTools/i</span><span class="s">)</span> <span class="s">{</span>
+ 305         <span class="i">$MayaChemToolsLibDir</span> = <span class="i">$INC</span>[<span class="i">$Index</span>]<span class="sc">;</span>
+ 306         <span class="k">last</span> <span class="j">INDEX</span><span class="sc">;</span>
+ 307       <span class="s">}</span>
+ 308     <span class="s">}</span>
+ 309     <span class="k">if</span> <span class="s">(</span>!<span class="i">$MayaChemToolsLibDir</span><span class="s">)</span> <span class="s">{</span>
+ 310       <span class="w">carp</span> <span class="q">&quot;Warning: MayaChemTools lib directory location doesn&#39;t appear to exist in library search path specified by \@INC ...&quot;</span><span class="sc">;</span>
+ 311     <span class="s">}</span>
+ 312   <span class="s">}</span>
+ 313   <span class="k">return</span> <span class="i">$MayaChemToolsLibDir</span><span class="sc">;</span>
+ 314 <span class="s">}</span>
+ 315 
+ 316 <span class="c"># Get Usage from Pod...</span>
+<a name="GetUsageFromPod-"></a> 317 <span class="k">sub </span><span class="m">GetUsageFromPod</span> <span class="s">{</span>
+ 318   <span class="k">my</span><span class="s">(</span><span class="i">$Usage</span><span class="cm">,</span> <span class="i">$ScriptPath</span><span class="s">)</span><span class="sc">;</span>
+ 319 
+ 320   <span class="s">(</span><span class="i">$ScriptPath</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
+ 321   <span class="i">$Usage</span> = <span class="q">&quot;Script usage not available: pod2text or pod2text.bat doesn&#39;t exist in your Perl installation and direct invocation of Pod::Text also failed\n&quot;</span><span class="sc">;</span>
+ 322 
+ 323   <span class="c"># Get pod documentation: try pod2text first followed by perdoc.bat in case it fails to</span>
+ 324   <span class="c"># to handle ActiveState Perl...</span>
+ 325   <span class="k">my</span><span class="s">(</span><span class="i">$PodStatus</span><span class="s">)</span><span class="sc">;</span>
+ 326   <span class="i">$PodStatus</span> = <span class="s">(</span><span class="k">open</span> <span class="w">CMD</span><span class="cm">,</span> <span class="q">&quot;pod2text $ScriptPath|&quot;</span><span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span> <span class="s">(</span><span class="s">(</span><span class="k">open</span> <span class="w">CMD</span><span class="cm">,</span> <span class="q">&quot;pod2text.bat $ScriptPath|&quot;</span><span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="s">)</span><span class="sc">;</span>
+ 327   <span class="k">if</span> <span class="s">(</span>!<span class="i">$PodStatus</span><span class="s">)</span> <span class="s">{</span>
+ 328     <span class="c"># Try direct invocation of Pod::Text before giving up...</span>
+ 329     <span class="k">my</span><span class="s">(</span><span class="i">$PodTextCmd</span><span class="s">)</span><span class="sc">;</span>
+ 330     <span class="i">$PodTextCmd</span> = <span class="q">&quot;perl -e \&#39;use Pod::Text (); \$TextFormatter = Pod::Text-&gt;new(); \$TextFormatter-&gt;parse_from_file(\&quot;$ScriptPath\&quot;);\&#39;&quot;</span><span class="sc">;</span>
+ 331     <span class="i">$PodStatus</span> = <span class="s">(</span><span class="k">open</span> <span class="w">CMD</span><span class="cm">,</span> <span class="q">&quot;$PodTextCmd|&quot;</span><span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
+ 332     <span class="k">if</span> <span class="s">(</span>!<span class="i">$PodStatus</span><span class="s">)</span> <span class="s">{</span>
+ 333       <span class="k">return</span> <span class="i">$Usage</span><span class="sc">;</span>
+ 334     <span class="s">}</span>
+ 335   <span class="s">}</span>
+ 336   <span class="k">my</span><span class="s">(</span><span class="i">$ProcessingSection</span><span class="cm">,</span> <span class="i">$InParametersSection</span><span class="cm">,</span> <span class="i">$InOptionsSection</span><span class="cm">,</span> <span class="i">@LineWords</span><span class="s">)</span><span class="sc">;</span>
+ 337   <span class="i">$ProcessingSection</span> = <span class="n">0</span><span class="sc">;</span> <span class="i">$InParametersSection</span> = <span class="n">0</span><span class="sc">;</span> <span class="i">$InOptionsSection</span> = <span class="n">0</span><span class="sc">;</span>
+ 338   <span class="j">PODLINE:</span> <span class="k">while</span> <span class="s">(</span><span class="q">&lt;CMD&gt;</span><span class="s">)</span> <span class="s">{</span>
+ 339     <span class="k">if</span> <span class="s">(</span><span class="q">/^SYNOPSIS/</span><span class="s">)</span> <span class="s">{</span>
+ 340       <span class="i">$_</span> = <span class="q">&lt;CMD&gt;</span><span class="sc">;</span> <span class="k">chomp</span><span class="sc">;</span> <span class="q">s/^ +//g</span><span class="sc">;</span>
+ 341       <span class="s">(</span><span class="i">@LineWords</span><span class="s">)</span> = <span class="k">split</span> <span class="q">/ /</span><span class="sc">;</span>
+ 342       <span class="i">$Usage</span> = <span class="q">qq(Usage: $LineWords[0] [-options]... )</span><span class="sc">;</span>
+ 343       <span class="k">shift</span> <span class="i">@LineWords</span><span class="sc">;</span>
+ 344       <span class="i">$Usage</span> .= <span class="k">join</span><span class="s">(</span><span class="q">&quot; &quot;</span><span class="cm">,</span> <span class="i">@LineWords</span><span class="s">)</span> . <span class="q">&quot;\n&quot;</span><span class="sc">;</span>
+ 345     <span class="s">}</span>
+ 346     <span class="k">elsif</span> <span class="s">(</span><span class="q">/^(DESCRIPTION|PARAMETERS|OPTIONS|EXAMPLES|AUTHOR|SEE ALSO|COPYRIGHT)/i</span><span class="s">)</span> <span class="s">{</span>
+ 347       <span class="c"># Various sections...</span>
+ 348       <span class="k">chomp</span><span class="sc">;</span>
+ 349       <span class="i">$Usage</span> .= <span class="k">ucfirst</span><span class="s">(</span><span class="k">lc</span><span class="s">(</span><span class="i">$_</span><span class="s">)</span><span class="s">)</span> . <span class="q">&quot;:\n&quot;</span><span class="sc">;</span>
+ 350       <span class="i">$ProcessingSection</span> = <span class="n">1</span><span class="sc">;</span>
+ 351       <span class="i">$InOptionsSection</span> = <span class="q">/^OPTIONS/</span> ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
+ 352       <span class="i">$InParametersSection</span> = <span class="q">/^PARAMETERS/</span> ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
+ 353     <span class="s">}</span>
+ 354     <span class="k">elsif</span> <span class="s">(</span><span class="i">$InParametersSection</span>|<span class="i">$InOptionsSection</span><span class="s">)</span> <span class="s">{</span>
+ 355       <span class="k">if</span> <span class="s">(</span><span class="q">/^[ ]+\-/</span> || <span class="q">/^[ ]{4,4}/</span><span class="s">)</span> <span class="s">{</span>
+ 356         <span class="c"># Start of option line: any number of spaces followed by - sign.</span>
+ 357         <span class="c"># Put back in &lt;&gt; which pod2text replaced to **</span>
+ 358         <span class="k">my</span><span class="s">(</span><span class="i">$OptionLine</span><span class="s">)</span> = <span class="q">qq($_)</span><span class="sc">;</span>
+ 359            <span class="j">OPTIONLINE:</span> <span class="k">while</span> <span class="s">(</span><span class="q">&lt;CMD&gt;</span><span class="s">)</span> <span class="s">{</span>
+ 360           <span class="k">if</span> <span class="s">(</span><span class="q">/^(    )/</span><span class="s">)</span> <span class="s">{</span>
+ 361             <span class="i">$OptionLine</span> .= <span class="q">qq($_)</span><span class="sc">;</span>
+ 362           <span class="s">}</span>
+ 363           <span class="k">else</span> <span class="s">{</span>
+ 364             <span class="i">$OptionLine</span> =~ <span class="q">s/\*(([a-zA-Z0-9])|(\[)|(\#)|(\&quot;))/&quot;\&lt;&quot; . substr($&amp;, -1, 1)/e</span><span class="sc">;</span>
+ 365             <span class="i">$OptionLine</span> =~ <span class="q">s/(([a-zA-Z0-9])|(\])|(\#)|(\&quot;))\*/substr($&amp;, 0, 1) . &quot;\&gt;&quot;/e</span><span class="sc">;</span>
+ 366             <span class="i">$Usage</span> .= <span class="q">qq($OptionLine$_)</span><span class="sc">;</span>
+ 367             <span class="k">last</span> <span class="j">OPTIONLINE</span><span class="sc">;</span>
+ 368           <span class="s">}</span>
+ 369         <span class="s">}</span>
+ 370       <span class="s">}</span>
+ 371     <span class="s">}</span>
+ 372     <span class="k">else</span> <span class="s">{</span>
+ 373       <span class="k">if</span> <span class="s">(</span><span class="i">$ProcessingSection</span><span class="s">)</span> <span class="s">{</span> <span class="i">$Usage</span> .= <span class="q">qq($_)</span><span class="sc">;</span> <span class="s">}</span>
+ 374     <span class="s">}</span>
+ 375   <span class="s">}</span>
+ 376   <span class="k">close</span> <span class="w">CMD</span><span class="sc">;</span>
+ 377 
+ 378   <span class="c"># Take out **which pod2text puts in for &lt;&gt;</span>
+ 379   <span class="i">$Usage</span> =~ <span class="q">s/\*(([a-zA-Z0-9;#-])|(\&quot;)|(\()|(\[)|(\.))/substr($&amp;, -1, 1)/eg</span><span class="sc">;</span>
+ 380   <span class="i">$Usage</span> =~ <span class="q">s/(([a-zA-Z0-9;#-])|(\&quot;)|(\))|(\])|(\.))\*/substr($&amp;, 0, 1)/eg</span><span class="sc">;</span>
+ 381 
+ 382   <span class="k">return</span> <span class="i">$Usage</span><span class="sc">;</span>
+ 383 <span class="s">}</span>
+ 384 
+ 385 <span class="c"># Split full file name into directory path, file name, and the extension.</span>
+<a name="ParseFileName-"></a> 386 <span class="k">sub </span><span class="m">ParseFileName</span> <span class="s">{</span>
+ 387   <span class="k">my</span><span class="s">(</span><span class="i">$FullName</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
+ 388   <span class="k">my</span><span class="s">(</span><span class="i">$FileDir</span><span class="cm">,</span> <span class="i">$FileName</span><span class="cm">,</span> <span class="i">$FileExt</span><span class="cm">,</span> <span class="i">@FullFileNameParts</span><span class="cm">,</span> <span class="i">@FileNameParts</span><span class="cm">,</span> <span class="i">$Delimiter</span><span class="s">)</span><span class="sc">;</span>
+ 389 
+ 390   <span class="i">$Delimiter</span> = <span class="q">&quot;\/&quot;</span><span class="sc">;</span>
+ 391   <span class="k">if</span> <span class="s">(</span><span class="i">$FullName</span> =~ <span class="q">/\\/</span> <span class="s">)</span> <span class="s">{</span>
+ 392     <span class="i">$Delimiter</span> = <span class="q">&quot;\\&quot;</span><span class="sc">;</span>
+ 393     <span class="i">$FullName</span> =~ <span class="q">s/\\/\//g</span><span class="sc">;</span>
+ 394   <span class="s">}</span>
+ 395   <span class="i">$FileDir</span> = <span class="q">&quot;&quot;</span><span class="sc">;</span> <span class="i">$FileName</span> = <span class="q">&quot;&quot;</span><span class="sc">;</span> <span class="i">$FileExt</span> = <span class="q">&quot;&quot;</span><span class="sc">;</span>
+ 396   <span class="i">@FullFileNameParts</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="i">@FileNameParts</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
+ 397 
+ 398   <span class="i">@FullFileNameParts</span> = <span class="k">split</span> <span class="q">&quot;\/&quot;</span><span class="cm">,</span> <span class="i">$FullName</span><span class="sc">;</span>
+ 399   <span class="i">@FileNameParts</span> = <span class="k">split</span> <span class="q">/\./</span><span class="cm">,</span> <span class="i">$FullFileNameParts</span>[<span class="i">$#FullFileNameParts</span>]<span class="sc">;</span>
+ 400 
+ 401   <span class="c"># Setup file dir...</span>
+ 402   <span class="k">if</span> <span class="s">(</span><span class="i">@FullFileNameParts</span> == <span class="n">1</span><span class="s">)</span> <span class="s">{</span>
+ 403     <span class="i">$FileDir</span> = <span class="q">&quot;\.&quot;</span><span class="sc">;</span>
+ 404   <span class="s">}</span>
+ 405   <span class="k">else</span> <span class="s">{</span>
+ 406     <span class="k">pop</span> <span class="i">@FullFileNameParts</span><span class="sc">;</span>
+ 407     <span class="i">$FileDir</span> = <span class="k">join</span> <span class="i">$Delimiter</span><span class="cm">,</span> <span class="i">@FullFileNameParts</span><span class="sc">;</span>
+ 408   <span class="s">}</span>
+ 409 
+ 410   <span class="c"># Setup file name and ext...</span>
+ 411   <span class="k">if</span> <span class="s">(</span><span class="i">@FileNameParts</span> == <span class="n">1</span><span class="s">)</span> <span class="s">{</span>
+ 412     <span class="i">$FileName</span> = <span class="i">$FileNameParts</span>[<span class="n">0</span>]<span class="sc">;</span>
+ 413     <span class="i">$FileExt</span> = <span class="q">&quot;&quot;</span><span class="sc">;</span>
+ 414   <span class="s">}</span>
+ 415   <span class="k">elsif</span> <span class="s">(</span><span class="i">@FileNameParts</span> == <span class="n">2</span><span class="s">)</span> <span class="s">{</span>
+ 416     <span class="i">$FileName</span> = <span class="i">$FileNameParts</span>[<span class="n">0</span>]<span class="sc">;</span>
+ 417     <span class="i">$FileExt</span> = <span class="i">$FileNameParts</span>[<span class="n">1</span>]<span class="sc">;</span>
+ 418   <span class="s">}</span>
+ 419   <span class="k">elsif</span> <span class="s">(</span><span class="i">@FileNameParts</span> &gt; <span class="n">2</span><span class="s">)</span> <span class="s">{</span>
+ 420     <span class="c"># Use the last entry as file extension and the rest for file name...</span>
+ 421     <span class="i">$FileExt</span> = <span class="i">$FileNameParts</span>[<span class="i">$#FileNameParts</span>]<span class="sc">;</span>
+ 422     <span class="k">pop</span> <span class="i">@FileNameParts</span><span class="sc">;</span>
+ 423     <span class="i">$FileName</span> = <span class="k">join</span> <span class="q">&#39;.&#39;</span><span class="cm">,</span> <span class="i">@FileNameParts</span><span class="sc">;</span>
+ 424   <span class="s">}</span>
+ 425   <span class="k">return</span> <span class="s">(</span><span class="i">$FileDir</span><span class="cm">,</span> <span class="i">$FileName</span><span class="cm">,</span> <span class="i">$FileExt</span><span class="s">)</span><span class="sc">;</span>
+ 426 <span class="s">}</span>
+ 427 
+<a name="EOF-"></a></pre>
+<p>&nbsp;</p>
+<br />
+<center>
+<img src="../../../images/h2o2.png">
+</center>
+</body>
+</html>