//
//////////////////////////////////////////////////////////////////////////////
//
//          (C) Copyright 1995-2008 by Autodesk, Inc.
//
// 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.
//
// AUTODESK PROVIDES THIS PROGRAM "AS IS" AND WITH ALL FAULTS. 
// AUTODESK SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OF
// MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE.  AUTODESK, INC. 
// DOES NOT WARRANT THAT THE OPERATION OF THE PROGRAM WILL BE
// UNINTERRUPTED OR ERROR FREE.
//
// Use, duplication, or disclosure by the U.S. Government is subject to 
// restrictions set forth in FAR 52.227-19 (Commercial Computer
// Software - Restricted Rights) and DFAR 252.227-7013(c)(1)(ii)
// (Rights in Technical Data and Computer Software), as applicable.
//
// NOTE: This file is also built as part of acdb16.dll separately from the
// rest of AdUi.  So, any changes made to this file must work in both
// AdUi and AcDb.

#pragma once

#pragma pack (push, 8)

#include "aduivolumedescriptor.h"

class ADUI_PORT CAdUiPathname {

public:

// methods
        // constructor (initializes private data)
        CAdUiPathname(void);
        CAdUiPathname(const CAdUiPathname&);

        // destructor (frees allocated storage)
        ~CAdUiPathname(void);

        // *******************************************
        // Methods to set up a path
        // *******************************************

        // reinitialize the data without destroying the object
        void Empty(void);

        // parse a string, validate the format and fill in the data
        //  This routine actually calls ParseRelative with the
        //  current document path (if any) or the current application
        //  path as the relative path.
virtual PathErr Parse( LPCTSTR, const BOOL wildcard_ok = FALSE );

        // parse a string relative to a supplied path, validate the
        //  format, and fill in the data.  The third parameter
        //  indicates whether an absolute path will be accepted
        //  or cause an error.  NOTE: this routine will recognize
        //  device names and proceed accordingly.
        PathErr ParseRelative( LPCTSTR name,
                               const CAdUiPathname* relpath,
                               const BOOL wildcard_ok = FALSE );

        // parse a string and attempt to find a matching file by OS
        //  rules, ie, whatever the current OS search path is.  Like
        //  an implicit ParseRelative.  NOTE: this does NOT call
        //  ParseRelative, it uses OS calls to find the file and get
        //  the path.  This means that it doesn't recognize device names
        BOOL ParseAndOSFind( LPCTSTR );

        // create an assignment operator that does the right thing.
        const CAdUiPathname& CAdUiPathname::operator=(const CAdUiPathname& pathSrc);
        const CAdUiPathname& CAdUiPathname::operator=(const CAdUiPathname* pathSrc);
 
        // generate a unique pathname based on this one.
        // returns a pointer to a new CAdUiPathname object if successful
        // returns FALSE if no success after 200 tries.
        BOOL CAdUiPathname::GetUniqueName(
                               CAdUiPathname&, 
                               BOOL alwaysMangle = FALSE ) const;

        // *******************************************
        // Methods to get parts of the path
        // *******************************************

        // return the string to left of last period in
        //  the rightmost component.  Returns NULL if
        //  this is not a file.
        void GetFilename(CString&) const;

        // return the string to right of last period in 
        //  the rightmost component.  Returns NULL if
        //  this is not a file.
        void GetExtension(CString&) const;

        // return the rightmost component of the path
        //  (a directory name or file.ext).  If the
        //  path terminates in a slash, return NULL.
        void GetBasename(CString&) const;

        // return the parent path of the current path
        //  c:\foo is the parent of c:\foo\bar
        void GetParent(CAdUiPathname& ) const;

        // *******************************************
        // Methods to modify the path
        // *******************************************

        // remove the last component from the path leaving
        //  the path terminated with a slash.  If this is a
        //  partial (relative) path, and there is no slash
        //  remaining (the trimmed path would be empty), return
        //  an error.
        PathErr Trim(void);

        // remove a trailing component separator
        //  if the last character is not a slash, do nothing
        //  return an error if removing the slash would leave
        //  an empty path.
        PathErr TrimSlash(void);

        // remove the last component, including the beginning
        //  slash.  Return an error if removing the slash would
        //  leave an empty path.
        PathErr TrimComponent(void);

        // append a string to the end of the path.
        //  This routine doesn't check whether the path
        //  ends in a slash.  Returns an error if the
        //  resulting path would be invalid.
        PathErr Append( LPCTSTR );

        // append a component separator to the end of the path
        //  Does nothing if the path already ends in a slash.
        //  returns an error if the resulting path would be
        //  invalid 
        PathErr AppendSlash(void);

        // append a component separator to the end of the path
        //  followed by the string.  Will never produce a "//"
        //  error.  Returns an error if the resulting path
        //  would be invalid.
        PathErr AppendComponent( LPCTSTR );

        // add a new extension regardless of any existing extension
        //  Will never produce a ".." error.  Returns an error if
        //  the resulting path would be invalid, or if the path
        //  is not a file.
        PathErr AddExtensionAlways( LPCTSTR );

        // add a new extension if there is no existing extension
        // or if the existing extension doesn't match the argument.
        // Note that the argument can be a semi-colon delimited
        // list of extensions.  If the existing extension doesn't
        // match anything in the list, the first extension is used.
        //  Will never produce a ".." error.  Returns an error if
        //  the resulting path would be invalid, or if the path
        //  is not a file.
        PathErr AddExtensionIfNoMatch( LPCTSTR );

        // add a new extension or replace any existing extension.
        //  Will never produce a ".." error.  Returns an error if
        //  the resulting path would be invalid, or if the path
        //  is not a file.
        PathErr ReplaceExtensionAlways( LPCTSTR );

        // add a new extension if there is no existing extension
        // or replace the existing extension if it n doesn't match 
        // the argument.  Note that the argument can be a 
        // semi-colon delimited list of extensions.  If the existing 
        // extension doesn't match anything in the list, the first 
        // extension is used.
        //  Will never produce a ".." error.  Returns an error if
        //  the resulting path would be invalid, or if the path
        //  is not a file.
        PathErr ReplaceExtensionIfNoMatch( LPCTSTR );

        // if there is an extension, remove it
        // removes the '.' too.
        void RemoveExtensionAlways(void);
        
        // if there is an extension, and it matches the argument,
        // remove it.  Note that the argument can be a 
        // semi-colon delimited list of extensions.  
        // removes the '.' too.
        void RemoveExtensionIfMatch( LPCTSTR );

        // modify the case of the basename (name.ext).
        //  mostly used for compatibility mode stuff
        void BaseToLower( void );
        void BaseToUpper( void );

        // strip leading/trailing spaces off of the file name
        void RemoveSpaces( void );

        // *******************************************
        // Methods to get the name in various formats
        // *******************************************

        // return a display name for this path in the argument.
        // Abbreviation rules are applied to reduce the length
        // of the display name if the supplied maxlen is > 0;
        void GetDisplayName( CString& strResult, int maxchars ) const;

        // return the pathname as a string
        LPCTSTR GetPathString(void) const;

        // returns the full path starting with the local volume
        //  name.  Relative paths are fully resolved.
        BOOL GetFullPath( CString& ) const;
        BOOL GetFullPath( LPTSTR) const;
        BOOL GetFullPath( LPTSTR, size_t strBuffLen ) const;

        // Returns the UNC path if 'this' represents a remote drive. Otherwise,
        // returns NULL.
        void GetFullUNCPath(CString&) const;

        // *******************************************
        // Methods to get information about the path
        // *******************************************

        // return TRUE if the path_type is file or dir
        //  (otherwise trim/append is not supported).
        BOOL IsPath(void) const;

        // return TRUE if the path_type is NO_PATH
        BOOL IsEmpty(void) const;

        // return the path type of this pathname
        //  (file, dir, device special, empty)
        path_type GetPathType(void) const;

        // return the volume descriptor of this pathname
        const CAdUiVolumeDescriptor* GetVolumeDescriptor(void) const;

        // return TRUE if the two paths refer to the same object
        BOOL PathMatch( const CAdUiPathname* ) const;
        BOOL PathMatch( LPCTSTR ) const;

        // checks whether this path points to an existing
        //  file/directory.  Returns FALSE if the path is
        //  empty.
        BOOL Exists(void);

        // check whether the extension (if any) matches one of
        //  extension in extlist.  extlist is a list of extensions
        //  separated by semicolons.
        BOOL VerifyExtension( LPCTSTR extlist ) const;

        // return TRUE if path string passed to the object had
        // a prefix.
        BOOL HadPrefix(void) const;

        // return TRUE if the path string passed to the object
        // was an absolute path.
        BOOL WasAbsolute(void) const;

        // return TRUE if the path string passed to the object
        // contained a leading separator (e.g., "\file.txt").
        BOOL WasRoot(void) const;

        // *******************************************
        // Methods that actually affect the file
        // *******************************************

        // takes a path and tries to open it.  Return TRUE if
        //  the open succeeded, FALSE otherwise.  Note that
        //  these routines set the current directory to the
        //  appropriate place before opening, and reset it
        //  afterward.
        BOOL Open(FILE** fdp, const ACHAR *openmode);
        BOOL Open(CFile& fp, UINT openflags);

        BOOL OpenReadOnly(HANDLE &rFileHandle);
        BOOL OpenWriteOnly(HANDLE &rFileHandle);

        // Tries to rename the file pointed to by this path
        //  Return TRUE if the operation succeeds, FALSE otherwise.
        //  Note that this routine sets the current directory to
        //  the appropriate place before opening, and resets it
        //  afterward.
        BOOL Rename(const ACHAR *newname);

        // Tries to remove the file pointed to by this path
        //  Return TRUE if the operation succeeds, FALSE otherwise.
        //  Note that this routine sets the current directory to
        //  the appropriate place before opening, and resets it
        //  afterward.
        BOOL Remove(void);

protected:

// data elements

        //the type of the pathname
        path_type                       m_this_type;

        // pointer to the volume descriptor for this path
        const CAdUiVolumeDescriptor*        m_pvolume;

        // the actual path and filename buffer
        //  as part of the general design philosopy, this string
        //      should never be accessable from outside the class or
        //  its descendants.
        CString*                        m_pathbuffer;

        // the relative path buffer
        //  for relative paths, this buffer contains the base path.
        //  the base path is always an absolute path.
        CString*                        m_relpath;

        // ****
        path_category                   m_path_cat;

        // the component separator character (slash) for the OS
        ACHAR                           m_separator;

        // TRUE if the original path string parsed via PathRelative
        // had a prefix in it.
        BOOL                            m_had_prefix;

// methods

        // find or create (as required), the volume descriptor
        //  for the specified local name (drive letter, etc.)
        const CAdUiVolumeDescriptor* FindVolumeDescriptor(const CString& vol_name) const;

        // create a new volume descriptor
        const CAdUiVolumeDescriptor* NewVolDescriptor( const CString& vol_name) const;

        // get the file system type of a volume
        FS_TYPE GetFileSystem(CString& vol_name) const;

        // return TRUE if the path is a device name (OS dependent)
       inline BOOL IsDeviceName(const CString& str) const; 

        // remove quotes from a string
        static void Unquote( CString& );

        // get the native OS Separator
        ACHAR GetSeparator(void) const;

        // the guts of the assignment operator
virtual void AssignCopy( const CAdUiPathname& );

        // Returns the "last character" of a CString (CString).  That is,
        // for a single byte character set, it will return the last
        // byte; for a unicode character set, it will return the last
        // unicode character (16 bit); for a double byte character
        // set it will return the lead byte of the last character.
        // This function is needed to make the filename class work
        // correctly with double byte character sets.
        static ACHAR GetLastCharacter( const CString& );
        
private:
        // private helper routine that gets the first extension out of
        // a semicolon delimited list;
        void GetFirstExtInList( LPCTSTR, CString&) const;

        void lstrncpy_x( LPTSTR dest, LPCTSTR src, int nchars) const;
        void StripSpaces(CString& work);
        void GetAttributes(const CString* path,
                const CString* relpath,
                path_type* this_type);
};


// inline definitions

inline CAdUiPathname::CAdUiPathname(const CAdUiPathname& pathSrc)
{
        m_pathbuffer = NULL;
        m_relpath = NULL;

        AssignCopy( pathSrc );
}

inline path_type CAdUiPathname::GetPathType(void) const
{
        return m_this_type;
}

inline BOOL CAdUiPathname::IsPath(void) const
{
        return ((m_this_type == FILE_PATH)
                || (m_this_type == DIR_PATH)
                || (m_this_type == NEW_PATH) 
                || (m_this_type == WC_PATH) );
        
}        

inline BOOL CAdUiPathname::IsEmpty(void) const
{
        return (m_this_type == NO_PATH);
}        

inline const CAdUiVolumeDescriptor* CAdUiPathname::GetVolumeDescriptor(void) const
{
        return m_pvolume;
}

inline BOOL CAdUiPathname::HadPrefix(void) const
{
        return m_had_prefix;
}

inline const CAdUiPathname& CAdUiPathname::operator=(const CAdUiPathname& pathSrc)
{
        AssignCopy( pathSrc);

        return *this;
}

inline const CAdUiPathname& CAdUiPathname::operator=(const CAdUiPathname* pathSrc)
{
        AssignCopy( *pathSrc);

        return *this;
}

inline BOOL CAdUiPathname::WasAbsolute(void) const
{
    return ( (m_path_cat == DRIVE_TYPE) ||
            (m_path_cat == UNC_TYPE) );
}
    

inline BOOL CAdUiPathname::WasRoot(void) const
{
    return (m_path_cat == ROOT_TYPE);
}

#pragma pack (pop)

