CAdUiPathname.h

Go to the documentation of this file.

#pragma once
 
//
// (C) Copyright 2005-2024 by Graebert GmbH.
//
// Permission to use, copy, modify, and distribute this software in
// object code form for any purpose and without fee is hereby granted,
// provided that the above copyright notice appears in all copies and
// that both that copyright notice and the limited warranty and
// restricted rights notice below appear in all supporting
// documentation.
//
// GRAEBERT PROVIDES THIS PROGRAM "AS IS" AND WITH ALL FAULTS.
// GRAEBERT SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OF
// MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE.  GRAEBERT GMBH
// DOES NOT WARRANT THAT THE OPERATION OF THE PROGRAM WILL BE
// UNINTERRUPTED OR ERROR FREE.
 
class CAdUiVolumeDescriptor;
class CFile;
template < typename Param1, typename Param2 > class StrTraitMFC_DLL;
 
class ARX_API CAdUiPathname
{
public:
          CAdUiPathname( CAdUiPathname const &);
          CAdUiPathname(void);
          ~CAdUiPathname(void);
          CAdUiPathname const &  operator=( CAdUiPathname const &);
          CAdUiPathname const &  operator=( CAdUiPathname const *);
          CAdUiVolumeDescriptor const *  GetVolumeDescriptor(void)const ;
          PathErr  AddExtensionAlways(wchar_t const *);
          PathErr  AddExtensionIfNoMatch(wchar_t const *);
          PathErr  Append(wchar_t const *);
          PathErr  AppendComponent(wchar_t const *);
          PathErr  AppendSlash(void);
          PathErr  ParseRelative(wchar_t const *, CAdUiPathname const *,int);
          PathErr  ReplaceExtensionAlways(wchar_t const *);
          PathErr  ReplaceExtensionIfNoMatch(wchar_t const *);
          PathErr  Trim(void);
          PathErr  TrimComponent(void);
          PathErr  TrimSlash(void);
          path_type  GetPathType(void)const ;
         int  Exists(void);
         int  GetFullPath( CStringW &)const ;
         int  GetFullPath(wchar_t *)const ;
         int  GetFullPath(wchar_t *,unsigned int)const ;
         int  GetUniqueName( CAdUiPathname &,int)const ;
         int  HadPrefix(void)const ;
         int  IsEmpty(void)const ;
         int  IsPath(void)const ;
         int  Open( CFile &,unsigned int);
         int  Open( _iobuf * *,wchar_t const *);
         int  OpenReadOnly(void * &);
         int  OpenWriteOnly(void * &);
         int  ParseAndOSFind(wchar_t const *);
         int  PathMatch( CAdUiPathname const *)const ;
         int  PathMatch(wchar_t const *)const ;
         int  Remove(void);
         int  Rename(wchar_t const *);
         int  VerifyExtension(wchar_t const *)const ;
         int  WasAbsolute(void)const ;
         int  WasRoot(void)const ;
         virtual  PathErr  Parse(wchar_t const *,int = false);
         void  BaseToLower(void);
         void  BaseToUpper(void);
         void  Empty(void);
         void  GetBasename( CStringW &)const ;
         void  GetDisplayName( CStringW &,int)const ;
         void  GetExtension( CStringW &)const ;
         void  GetFilename( CStringW &)const ;
         void  GetFullUNCPath( CStringW &)const ;
         void  GetParent( CAdUiPathname &)const ;
         void  RemoveExtensionAlways(void);
         void  RemoveExtensionIfMatch(wchar_t const *);
         void  RemoveSpaces(void);
         wchar_t const *  GetPathString(void)const ;
 
protected:
          CAdUiVolumeDescriptor const *  FindVolumeDescriptor( CStringW const &)const ;
          CAdUiVolumeDescriptor const *  NewVolDescriptor( CStringW const &)const ;
          FS_TYPE  GetFileSystem( CStringW &)const ;
         int  IsDeviceName( CStringW const &)const ;
         static void __cdecl Unquote( CStringW &);
         static wchar_t __cdecl GetLastCharacter( CStringW const &);
         virtual void  AssignCopy( CAdUiPathname const &);
         wchar_t  GetSeparator(void)const ;
 
private:
         void  GetAttributes( CStringW const *, CStringW const *, path_type *);
         void  GetFirstExtInList(wchar_t const *, CStringW &)const ;
         void  StripSpaces( CStringW &);
         void  lstrncpy_x(wchar_t *,wchar_t const *,int)const ;
 
};