mi32/filepath.h

Go to the documentation of this file.

/****
 * \file mi32/filepath.h
 * \brief Class FILEPATH - Handle filenames (directories and files) on supported platforms
 *
 * Definitions:
 *              
 * Name - The string after the last directory separator (SepMark).
 * Extn - The string after the 'Name' separated by the last extension separator (ExtnMark)
 * Path - The string representing the entire directory path up to 'Name'.
 *
 * Implementation notes:
 *
 * This class is not thread safe.  Most of the time the instance is specific to a 
 *    thread therefore the resource sharing issues are not involved.  If this class is
 *    a shared resource, it is up to the user of the class to guard it using the 
 *    appropriate locking method.
 *
 * \if NODOC
 * $Id: filepath.h_v 1.99 2010/03/30 16:33:04 mju Exp $
 *
 * $Log: filepath.h_v $
 * Revision 1.99  2010/03/30 16:33:04  mju
 * Adjust comments to clarify generateEncodedOSPath/getEncoded/getOSPath.
 *
 * Revision 1.98  2010/01/29 21:26:39  mju
 * Add pathtype_CurInst_Doc.
 *
 * Revision 1.97  2009/11/30 23:44:55  bcolombe
 * Added GetTimeAccessed
 *
 * Revision 1.96  2009/11/23 18:21:04  mju
 * Add isRelativePath variant using MISTRING.
 *
 * Revision 1.95  2009/10/01 20:03:52  mju
 * Remove isExisting as has exists() already.
 *
 * Revision 1.94  2009/10/01 16:52:55  mju
 * Add isExisting.
 *
 * Revision 1.93  2009/09/28 14:00:28  mju
 * Remove unused filesystype defns and document others.
 *
 * Revision 1.92  2009/07/17 14:57:47  mju
 * Add getRelativePath variant with more options.
 *
 * Revision 1.91  2009/01/02 16:05:27  bcolombe
 * Changed Rename to reflect change of moving the file instead of only changing name
 *
 * Revision 1.90  2008/04/18 21:31:52  mju
 * Use mistring as member instead of pointer.
 * Make inline dft/cpy ctor, dtor, op=.
 *
 * Revision 1.89  2008/02/28 15:36:09  mju
 * Add stripToCommon.
 *
 * Revision 1.88  2007/10/18 22:42:22  scowan
 * Removed status callback from copyFileFrom.
 * Added status manager* to copyFileFromDetached.
 *
 * Revision 1.87  2007/10/09 21:39:23  dwilliss
 * Added optional parameter to Generate temp file to specify extension
 *
 * Revision 1.86  2007/09/28 19:35:55  scowan
 * Removed unnecessary file path list fwd decl.
 *
 * Revision 1.85  2007/06/20 16:02:44  mju
 * Add getWindowsVolumeInfo and getVolumeName.
 *
 * Revision 1.84  2007/06/12 14:50:28  mju
 * Add pathtype_appdata_microimages values.
 *
 * Revision 1.83  2007/05/29 16:01:35  scowan
 * Added grant write access method.
 *
 * Revision 1.82  2007/05/11 14:21:54  mju
 * Remove previously deprecate filepathlist inclusion.
 *
 * Revision 1.81  2007/05/09 15:29:39  mju
 * Deprecate inclusion of filepathlist hdr.
 *
 * Revision 1.80  2007/05/08 13:10:06  mju
 * Don't doxy filepathlist hdr inclusion.
 *
 * Revision 1.79  2007/05/08 13:08:11  mju
 * Doxy include.
 *
 * Revision 1.78  2007/05/07 20:39:32  mju
 * Move filepathlist to own hdr, include from here for now.
 *
 * Revision 1.77  2007/04/03 19:54:36  scowan
 * Added updateFilesFrom methods.
 *
 * Revision 1.76  2007/03/26 14:37:34  scowan
 * Removed getMioPath.
 *
 * Revision 1.75  2007/02/02 23:38:51  scowan
 * Moved previous standalone thread classes into mithread namespace
 *
 * Revision 1.74  2007/01/22 16:59:46  scowan
 * Added permission_addchild enum.
 *
 * Revision 1.73  2006/10/09 13:28:27  mju
 * Exclude getMioPath if compiling for no_deprecated.
 *
 * Revision 1.72  2006/10/06 20:12:30  mju
 * Remove searchIterative/Recursive as unused and is job of filefind class.
 *
 * Revision 1.71  2006/10/06 17:47:01  scowan
 * Made filepathlist a class.
 *
 * Revision 1.70  2006/10/04 21:49:15  mju
 * Add searchRecursive.
 *
 * Revision 1.69  2006/07/12 17:23:52  scowan
 * Added method to get optimal transfer size.
 *
 * Revision 1.68  2006/06/14 14:30:10  mju
 * Use charencoding hdr.
 *
 * Revision 1.67  2006/05/04 16:02:55  scowan
 * Added removeFiles method.
 *
 * Revision 1.66  2006/04/28 20:43:42  scowan
 * Added removeFolder method.
 *
 * Revision 1.65  2006/04/25 15:30:34  mju
 * Add getNonValidComponentChars.
 *
 * Revision 1.64  2006/04/25 13:35:09  mju
 * Add makeValidChars.
 *
 * Revision 1.63  2005/12/22 16:02:39  mju
 * Display deprecation warning for getMioPath.
 *
 * Revision 1.62  2005/07/28 23:08:36  scowan
 *  Added another mehtod.
 *
 * Revision 1.61  2005/07/28 22:47:06  scowan
 * Added static methods for component testing.
 *
 * Revision 1.60  2005/07/28 20:57:23  scowan
 * Made static methods non-static.
 *
 * Revision 1.59  2005/07/28 20:27:10  scowan
 * Added two static methods.
 *
 * Revision 1.58  2005/05/17 17:03:12  scowan
 * Define detached version of file copy.
 *
 * Revision 1.57  2005/05/16 23:24:39  scowan
 * Added a createHardLink method.
 *
 * Revision 1.56  2005/04/15 16:30:01  dwilliss
 * Need SetModuleFileName available in all cases
 *
 * Revision 1.55  2005/04/15 16:23:24  dwilliss
 * Need SetModuleFileName for windows to
 *
 * Revision 1.54  2005/03/31 16:57:11  fileserver!dwilliss
 * Rename one of our types to MIUNICODE because it conflicted with a Microsoft #define
 *
 * Revision 1.53  2004/10/15 16:07:36  dwilliss
 * Added new PATHTYPE for logs
 *
 * Revision 1.52  2003/10/03 20:46:58  dwilliss
 * Changed static member from an MISTRING to a poitner to MISTRING.
 *
 * Revision 1.51  2003/09/15 13:49:56  fileserver!dwilliss
 * Doxygen
 *
 * Revision 1.50  2003/07/09 17:20:34  scowan
 * Removed mac 9 stuff and methods that are not used.
 *
 * Revision 1.49  2003/07/03 20:35:41  scowan
 * Removed mac native code.
 *
 * Revision 1.48  2003/06/18 19:31:35  scowan
 * Added convert name static method.
 *
 * Revision 1.47  2003/05/19 15:43:30  mju
 * Add pathtype_InstallationFolder.
 * Remove deprecated pathtype value.
 *
 * Revision 1.46  2003/05/16 17:50:54  mju
 * Add PATHTYPE_Settings values.
 *
 * Revision 1.45  2003/05/15 14:30:21  mju
 * Rename PATHTYPE_Documents enums.
 *
 * Revision 1.44  2003/02/25 22:48:57  mju
 * Make PATHTYPE names consistent and more complete and eliminate obsolete ones.
 *
 * Revision 1.43  2003/02/17 21:05:00  scowan
 * Added new path types.
 *
 * Revision 1.42  2003/02/13 23:22:52  scowan
 * Added static method.
 *
 * Revision 1.41  2002/11/20 16:39:40  mju
 * Add PATHTYPE_MicroImages.
 *
 * Revision 1.40  2002/09/09 16:05:28  mju
 * nc.
 *
 * Revision 1.39  2002/09/04 21:46:37  dwilliss
 * Just a see also on GetOSPath()
 *
 * Revision 1.38  2002/08/27 13:55:59  scowan
 * Allow set mac file type for osx.
 *
 * Revision 1.37  2002/08/21 15:52:38  scowan
 * Minor changes.
 *
 * Revision 1.36  2002/07/03 22:10:01  dwilliss
 * Work around stupid Mac problem with struct tm sometimes being std::tm
 *
 * Revision 1.35  2002/06/28 17:03:29  dwilliss
 * Damn Mac!  Can't get it to stop doing a "using std::tm"
 *
 * Revision 1.32  2002/06/17 14:24:50  mju
 * Remove 'struct' from use of 'tm' as not needed to hopefully fix MacOS9.
 *
 * Revision 1.30  2002/06/07 15:30:16  scowan
 * Added method to get encoded char poath.
 *
 * Revision 1.28  2002/03/27 17:04:38  mju
 * Add operator<< to put filepath 'display string' into MISTRING.
 *
 * Revision 1.27  2002/03/18 16:32:43  scowan
 * Added assign method.
 *
 * Revision 1.26  2002/01/16 18:13:39  scowan
 * Do stupid thing for MAC.
 *
 * Revision 1.25  2002/01/14 17:50:00  scowan
 * Limit use of set module filename to UNIX only.
 *
 * Revision 1.24  2002/01/14 16:29:45  scowan
 * Added strip to folder.
 *
 * Revision 1.23  2001/12/06 17:43:04  scowan
 * Added generate temp file method.
 *
 * Revision 1.22  2001/08/03 21:05:14  mju
 * Add GetQuotedPath implementing old GetOSPath() behavior.
 *
 * Revision 1.21  2001/05/03 19:43:28  scowan
 * Added Haschildren method().
 *
 * Revision 1.20  2001/03/14 15:23:48  scowan
 * Added set osd path for windows.
 *
 * Revision 1.18  2000/09/21 19:33:44  scowan
 * Added is same extn methods.
 *
 * Revision 1.16  2000/08/09 16:48:40  scowan
 * Updated relative path code.
 *
 * Revision 1.15  2000/08/08 13:39:10  mju
 * Don't have Genitor document "removed" and unimplemented methods.
 *
 * Revision 1.14  2000/07/19 16:13:10  scowan
 * Make cosnt versions of Get Relative Path and comment out old versions.
 *
 * Revision 1.13  2000/07/11 17:34:41  mju
 * Need to undef CLASSLIBEXPORT at end.
 *
 * Revision 1.12  2000/07/06 17:53:40  mju
 * Add IsFile and IsFolder methods.
 *
 * Revision 1.11  2000/06/13 14:20:48  mju
 * Use inclusion guards.
 *
 * \endif
****/

#ifndef  INC_MI32_FILEPATH_H
#define  INC_MI32_FILEPATH_H

#ifndef  INC_MI32_MISTRING_H
#include <mi32/mistring.h>
#endif

#ifndef  INC_TIME_H
#include <time.h>
#define  INC_TIME_H
#endif

#ifdef MISYSTEMDLL
   #define CLASSLIBEXPORT MI_DLLCLASSEXPORT
#else
   #define CLASSLIBEXPORT MI_DLLCLASSIMPORT
#endif

#ifndef GENERATING_DOXYGEN_OUTPUT
// Forward declarations
class FILE_RAW;
class MISTATUSMANAGER;
#endif // GENERATING_DOXYGEN_OUTPUT


class CLASSLIBEXPORT FILEPATH {     
   public:

      enum PERMISSION {                   
         PERMISSION_Invalid = 0,
         PERMISSION_Exists = 1,
         PERMISSION_Read = 2,
         PERMISSION_Write = 3,
         PERMISSION_ReadWrite = 4,
         PERMISSION_Execute = 5,
         PERMISSION_AddChild = 6          // Path must be a directory, cannot be used in SetPermission()
         };

      enum FILESYSTYPE {                  
         FILESYSTYPE_Unknown,
         FILESYSTYPE_NoRootDir,           
         FILESYSTYPE_Removable,           
         FILESYSTYPE_Fixed,               
         FILESYSTYPE_Network,             
         FILESYSTYPE_CDROM,               
         FILESYSTYPE_RamDisk,             
         };

      enum PATHTYPE {
         PATHTYPE_Current = 0,                     
         PATHTYPE_Home = 1,                        
         PATHTYPE_ExecutableFile = 2,              
         PATHTYPE_Desktop = 3,
         PATHTYPE_Font = 4,
         #if defined(WIN32)
            PATHTYPE_Windows = 5,                  
            PATHTYPE_WindowsSystem = 6,            
         #endif
         PATHTYPE_InstallationFolder = 7,          
         PATHTYPE_ExecutableFolder = 8,            
         PATHTYPE_Documents_AllUsers = 9,          
         PATHTYPE_MicroImages_Shared = 10,         
         PATHTYPE_Documents_CurrentUser = 11,      
         PATHTYPE_MicroImages_User = 12,           
         PATHTYPE_Settings_CurInst_CurUser = 13,   
         PATHTYPE_Settings_CurInst_AllUsers = 14,  
         PATHTYPE_Settings_AllInst_CurUser = 15,   
         PATHTYPE_Settings_AllInst_AllUsers = 16,  
         PATHTYPE_MicroImages_Logs = 17,           
         PATHTYPE_AppData_MicroImages_CurUser = 18,   
         PATHTYPE_AppData_MicroImages_AllUsers = 19,  
         PATHTYPE_MicroImages_CurInst_Doc = 20,       
         };

      enum RELATIVEPATH {
         RELATIVEPATH_Default =           0x00,
         RELATIVEPATH_NoEncoding =        0x01, 
         RELATIVEPATH_NoDotSlashPrefix =  0x02, 
         };

      enum CHILDTYPE {                    
         CHILDTYPE_Directory = 1,
         CHILDTYPE_File
         };

      static MISTRING ConvertDisplayToName (
         const MISTRING& name
         );

      static MISTRING ConvertNameToDisplay (
         const MISTRING& name
         );

      static int GetDriveList (           
         MISTRINGLIST& DriveList
         );

      static bool GetEnvPath (            
         const char *name,
         MISTRING& EnvPathStr
         );

      static const MISTRING& GetNonValidComponentChars (
         );
         
      static bool IsRelativePath (
         const MISTRING& path                
         );

      static bool IsRelativePath (
         const MIUNICODE *path               
         );

      static bool IsValidName (
         const MISTRING& name
         );

      static bool MakeValidChars (
         MISTRING& name
         );

      static bool MakeValidName (
         MISTRING& name
         );

      static void SetModuleFileName (
         const char *name,                
         CHAR_ENCODING encoding           
         );

      FILEPATH (                       
         ) { }

      FILEPATH (                       
         const FILEPATH& rhs
         ): m_pathstr(rhs.m_pathstr) { }

      FILEPATH (                       
         const FILEPATH& dir,
         const MISTRING& name
         );

      FILEPATH (                       
         const FILEPATH& dir,
         const MIUNICODE *name
         );

      FILEPATH (                       
         const FILEPATH& dir,
         const char *name,
         CHAR_ENCODING encoding = CHAR_ENCODING_ASCII
         );

      explicit FILEPATH (                 
         PATHTYPE type
         );

      explicit FILEPATH (                 
         const MISTRING& rhs
         );

      FILEPATH (                       
         const MIUNICODE *rhs
         );

      explicit FILEPATH (                 
         const char *rhs,
         CHAR_ENCODING encoding = CHAR_ENCODING_ASCII
         );

      FILEPATH (                          
         void *IniHandle,                 
         const char *group,               
         const char *field                
         );

      ~FILEPATH (                         
         ) { }

      FILEPATH& operator= (               
         const FILEPATH& rhs
         ) { if (this != &rhs) m_pathstr = rhs.m_pathstr; return (*this); }

      FILEPATH& operator= (               
         const MISTRING& rhs
         );

      FILEPATH& operator= (               
         const MIUNICODE* rhs
         );

      FILEPATH& operator+= (              
         const MISTRING& rhs
         );

      FILEPATH& operator+= (              
         const MIUNICODE* rhs
         );

      FILEPATH& operator+= (              
         const char *rhs                     
         );

      FILEPATH& Append (                  
         const char *q,                   
         CHAR_ENCODING encoding           
         );

      FILEPATH& Assign (
         const char *p,
         CHAR_ENCODING encoding = CHAR_ENCODING_ASCII
         );
         
      ERRVALUE CheckAccess (
         const PERMISSION perm = PERMISSION_Read      
         ) const;

      void Clear (                     
         );

      bool Contains (                     
         const FILEPATH& SubPath          
         ) const;

      ERRVALUE CopyFileFrom (
         const FILEPATH& SourcePath,         
         bool ShowStatus = false
         ) const;

      void CopyFileFromDetached (
         const FILEPATH& SourcePath,         
         MISTATUSMANAGER* DftManager = 0     
         ) const;

      bool Exists (
         ) const;

      ERRVALUE GenerateTempFile (
         const FILEPATH& BasePath,
         const MISTRING& Basename,
         const char* extn = "tmp"
         );
         
      char* GenerateEncodedOSPath (
         ) const;

      INT64 GetAvailableSpace (           
         ) const;

      int GetChildren (
         MISTRINGLIST& ChildList,         
         CHILDTYPE ChildType              
         ) const;
      
      int GetChildren (
         MISTRINGLIST& ChildList,         
         const MISTRING& pattern,         
         CHILDTYPE ChildType              
         ) const;

      int GetComponents (
         MISTRINGLIST& CompList           
         ) const;

      MISTRING GetDisplay (
         ) const;

      MISTRING GetEncoded (
         ) const;

      MISTRING GetExtension (
         ) const;

      FILESYSTYPE GetFileSysType (     
         ) const;

      UINT32 GetFullPathSizeLimit (    
         ) const;

   #if defined(MAC_OSX)
      ERRVALUE GetMacFileType (       
         char *creator, 
         char *type
         ) const;
   #endif

      MISTRING GetName (                  
         ) const;

      MISTRING GetNameOnly (
         ) const;

      UINT32 GetNameSizeLimit (     
         ) const;
         
      INT32 GetOptimalTransferSize (
         ) const;

      MISTRING GetOSPath (
         ) const;

      FILEPATH GetPathOnly (              
         ) const;

      PERMISSION GetPermission (         
         ) const;

      MISTRING GetQuotedPath (
         ) const;

      MISTRING GetRelativePath (          
         const FILEPATH& BasePath      
         ) const;

      MISTRING GetRelativePath (
         const FILEPATH& BasePath,     
         RELATIVEPATH flags,           
         int maxoutlevels = -1,        
         char separator = 0            
         ) const;

      INT64 GetSize (                     
         ) const;

      INT64 GetSystemMaxSize (            
         ) const;

      ERRVALUE GetTimeAccessed (          
         time_t *rettime                  
         ) const;

      ERRVALUE GetTimeCreated (           
         time_t *rettime                  
         ) const;

      ERRVALUE GetTimeModified (          
         time_t *rettime                  
         ) const;

      void GetVolumeName (
         MISTRING& VolumeName                
         ) const;

   #if defined(WIN32)
      bool GrantWriteAccessTo (
         const MISTRING& AccountName         
         );
   #endif

      bool HasChildren (
         CHILDTYPE ChildType              
         ) const;
      
      bool HasExtension (                 
         ) const;

      bool IniRead (                   
         void *IniHandle,                 
         const char *group,               
         const char *field                
         );

      void IniWrite (                     
         void *IniHandle,                 
         const char *group,               
         const char *field                
         ) const;

      bool IsChildPath (
         const FILEPATH& BasePath
         ) const;
      
      bool IsEmpty (                   
         ) const;

      bool IsEqual (                     
         const FILEPATH& TestPath
         ) const;

      bool IsFile (
         ) const;

      bool IsFolder (
         ) const;

      bool IsLessThan (                  
         const FILEPATH& TestPath
         ) const;

      bool IsPathOnly (                  
         ) const;

      bool IsReadable (                
         ) const;

      bool IsRootOnly (                
         ) const;

      bool IsSameExtn (
         const char *extn        
         ) const;

      bool IsSameExtn (
         const MISTRING& extn       
         ) const;

      // Note: back slashes in the comment below are doubled up for Doxygen
      bool IsUNCHostOnly (             
         ) const;

      // Note: back slashes in the comment below are doubled up for Doxygen
      bool IsUNCRoot (                 
         ) const;

      bool IsWritable (                   
         ) const;

      ERRVALUE Make (
         bool MakeTree = false              
         ) const;

      ERRVALUE MakeHardLinkTo (
         const FILEPATH& SrcFile
         ) const;

      ERRVALUE Remove (
         ) const;

      ERRVALUE RemoveFiles (
         bool RemoveReadOnlyFiles = false
         ) const;

      ERRVALUE RemoveFolder (
         ) const;

      ERRVALUE Rename (                
         const MISTRING& newname          
         );                                  

      ERRVALUE Rename (
         const FILEPATH& newname          
         ) const;

      FILEPATH& ReplaceRoot (             
         const FILEPATH& SourcePath       
         );

      bool SearchCase (
         );

      FILEPATH& SetExtension (            
         const MISTRING& extn
         );

      FILEPATH& SetExtension (            
         const char* extn,
         CHAR_ENCODING encoding = CHAR_ENCODING_ASCII
         );
         
   #if defined(MAC_OSX)
      ERRVALUE SetMacFileType (        
         const char *creator, 
         const char *type
         ) const;
   #endif

      FILEPATH& SetName (                 
         const MISTRING& name
         );

      FILEPATH& SetName (                
         const char* name,
         CHAR_ENCODING encoding = CHAR_ENCODING_ASCII
         );

   #if defined(WIN32)
      void SetOSPath (
         const char* path
         );

      void SetOSPath (
         const MIUNICODE* path
         );
   #endif

      ERRVALUE SetPermission (
         PERMISSION perm                  
         ) const;

      void SetSystemPath (
         PATHTYPE pt                      
         );

      ERRVALUE SetTimeCreated (
         const tm*const timeval     
         ) const;

      ERRVALUE SetTimeCreated (
         time_t value                     
         ) const;

      ERRVALUE SetTimeModified (
         const tm*const timeval     
         ) const;

      ERRVALUE SetTimeModified (
         time_t value                     
         ) const;

      FILEPATH& StripExtension (
         );

      FILEPATH& StripLastComponent (
         );

      FILEPATH& StripToExisting (
         );

      bool StripToCommon (
         const FILEPATH& testpath
         );

      FILEPATH& StripToFolder (
         );

      FILEPATH& StripToRoot (
         );

      ERRVALUE UpdateFilesFrom (
         const FILEPATH& SourcePath,            
         bool RecurseSubDirectories = true      
         ) const;

      ERRVALUE UpdateFilesFrom (
         const FILEPATH& SourcePath,            
         const MISTRING& pattern,               
         bool RecurseSubDirectories = true      
         ) const;

   private:
      #ifndef GENERATING_DOXYGEN_OUTPUT

      void AppendPath (const MISTRING& name);      // Appends name to the end of the FILEPATH
      ERRVALUE GenerateErrorCode (ERRVALUE DftErrCode) const;        // Generate a MicroImages error code based on system error code
      char *GenerateOSPath () const;         // Generate Operating system specific path
      int GetExtnPosn () const;              // Returns the position of the extn marker
      int GetRootEndPosn () const;           // Return position of end of the root path
      void GetWindowsFolderPath (int folder);
   #ifdef WIN32
      bool GetWindowsVolumeInfo (
         MISTRING *pVolumeName,
         UINT32 *pSerialNum,
         UINT32 *pMaxComponentLength,
         UINT32 *pFlags,
         MISTRING *pFileSystemName
         ) const;
   #endif
      void JoinRelativePath (const MISTRING& str);             // Join relative path to stored path
      ERRVALUE MakePath () const;            // Creates a path using the end path name

      MISTRING m_pathstr;                    // String that holds the path

      static const MIUNICODE s_ExtnMark;     // System extension marker (.)
      static const MIUNICODE s_SepMark;      // System path separator marker (\\, /, :)
      static const MIUNICODE s_RelMark;      // System path relative marker (., :, .)
      static const char *s_BackTagStr;       // System directory backup string (..\\, ../, :)
      static const char *s_SameDirStr;       // System directory same directory string (.\\, ./, Invalid for the MAC)
      static const char *s_EncodeStr;        // Encode system marker
      static MISTRING *s_argv0;              // Internal module path stored for SetSystemPath()
      
      friend class FILE_RAW;                 // To give FILE_RAW access to GenerateOSPath()

      #endif // GENERATING_DOXYGEN_OUTPUT
   };

#ifndef GENERATING_DOXYGEN_OUTPUT
DEFINE_ENUM_OP_BITWISE(FILEPATH::PERMISSION)
DEFINE_ENUM_OP_BITWISE(FILEPATH::RELATIVEPATH)
#endif


inline bool operator== (               
   const FILEPATH& p,
   const FILEPATH& q
   ) { return (p.IsEqual(q)); }

inline bool operator!= (               
   const FILEPATH& p,
   const FILEPATH& q
   ) { return (!p.IsEqual(q)); }

inline bool operator< (                
   const FILEPATH& p,
   const FILEPATH& q
   ) { return (p.IsLessThan(q)); }

inline bool operator> (                
   const FILEPATH& p,
   const FILEPATH& q
   ) { return (!p.IsLessThan(q) && !p.IsEqual(q)); }

inline bool operator<= (               
   const FILEPATH& p,
   const FILEPATH& q
   ) { return (p.IsLessThan(q) || p.IsEqual(q)); }

inline bool operator>= (               
   const FILEPATH& p,
   const FILEPATH& q
   ) { return (!p.IsLessThan(q)); }

inline FILEPATH operator+ (            
   const FILEPATH& q,
   const MISTRING& p
   ) {
   FILEPATH temp(q);
   return (temp += p);
   }

inline MISTRING& operator<< (
   MISTRING& lhs,
   const FILEPATH& rhs
   ) { return (lhs.operator<<(rhs.GetDisplay())); }


#undef   CLASSLIBEXPORT

#endif

---