00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024
00025
00026
00027 #ifndef CEYLAN_DIRECTORY_H_
00028 #define CEYLAN_DIRECTORY_H_
00029
00030
00031 #include "CeylanFileSystemCommon.h"
00032 #include "CeylanStringUtils.h"
00033
00034
00035 #include <list>
00036 #include <string>
00037
00038
00039
00040
00041 namespace Ceylan
00042 {
00043
00044
00045
00046 namespace System
00047 {
00048
00049
00050
00051
00052
00053
00054
00055
00056 class FileSystemManager ;
00057
00058
00059
00066 class CEYLAN_DLL DirectoryDelegatingException: public DirectoryException
00067 {
00068
00069 public:
00070
00071 explicit DirectoryDelegatingException(
00072 const std::string & reason ) ;
00073
00074 } ;
00075
00076
00077
00078
00079
00091 class CEYLAN_DLL Directory: public TextDisplayable
00092 {
00093
00094
00095 public:
00096
00097
00098
00099
00100
00101
00102
00103
00104
00105
00106
00107
00108
00109
00110
00111
00112
00113
00114
00115
00116
00117
00118
00119
00120
00121
00122
00123
00124
00125
00126
00144 static bool Exists( const std::string & directoryPath ) ;
00145
00146
00147
00165 static void Remove( const std::string & directoryPath,
00166 bool recursive = false ) ;
00167
00168
00169
00186 static void Move( const std::string & sourceDirectoryname,
00187 const std::string & targetDirectoryname ) ;
00188
00189
00190
00205 static void Copy( const std::string & sourceDirectoryname,
00206 const std::string & targetDirectoryname ) ;
00207
00208
00209
00222 static time_t GetLastChangeTime(
00223 const std::string & directoryPath ) ;
00224
00225
00226
00242 static bool IsAValidDirectoryPath(
00243 const std::string & directoryString ) ;
00244
00245
00246
00260 static void RemoveLeadingSeparator( std::string & path ) ;
00261
00262
00263
00276 static bool IsAbsolutePath( const std::string & path ) ;
00277
00278
00279
00290 static std::string GetCurrentWorkingDirectoryPath() ;
00291
00292
00293
00307 static void ChangeWorkingDirectory(
00308 const std::string & newWorkingDirectory ) ;
00309
00310
00311
00331 static std::list<std::string> SplitPath(
00332 const std::string & path ) ;
00333
00334
00335
00354 static std::string JoinPath(
00355 const std::list<std::string> & pathElements ) ;
00356
00357
00358
00379 static std::string JoinPath( const std::string & firstPath,
00380 const std::string & secondPath ) ;
00381
00382
00383
00411 static void StripFilename( const std::string & path,
00412 std::string * base, std::string * file = 0 ) ;
00413
00414
00415
00428 static Ceylan::Latin1Char GetSeparator() ;
00429
00430
00431
00446 static std::string GetSeparatorAsString() ;
00447
00448
00449
00450
00451
00452
00453
00454
00472 static Directory & Create(
00473 const std::string & newDirectoryName ) ;
00474
00475
00476
00496 static Directory & Open(
00497 const std::string & directoryName = "" ) ;
00498
00499
00500
00510 virtual ~Directory() throw() ;
00511
00512
00513
00514
00515
00516
00517
00518
00519
00520
00521
00522
00535 virtual bool hasDirectory(
00536 const std::string & subdirectoryName ) const = 0 ;
00537
00538
00539
00550 virtual bool hasFile( const std::string & fileName ) const = 0 ;
00551
00552
00553
00564 virtual bool hasEntry( const std::string & entryName ) const
00565 = 0 ;
00566
00567
00568
00582 virtual void getSubdirectories(
00583 std::list<std::string> & subDirectories ) const = 0 ;
00584
00585
00586
00597 virtual void getFiles( std::list<std::string> & files )
00598 const = 0 ;
00599
00600
00601
00623 virtual void getEntries( std::list<std::string> & entries )
00624 const = 0 ;
00625
00626
00627
00650 virtual void getSortedEntries(
00651 std::list<std::string> & subDirectories,
00652 std::list<std::string> & files,
00653 std::list<std::string> & otherEntries ) const = 0 ;
00654
00655
00656
00657
00658
00659
00660
00674 virtual void goDown( const std::string & subdirectoryName ) ;
00675
00676
00677
00688 virtual bool isValid() const ;
00689
00690
00691
00698 virtual const std::string & getPath() const ;
00699
00700
00701
00710 virtual void removeLeadingSeparator() ;
00711
00712
00713
00725 virtual const std::string toString(
00726 Ceylan::VerbosityLevels level = Ceylan::high ) const ;
00727
00728
00729
00730
00731
00732 protected:
00733
00734
00735
00740 explicit Directory( const std::string & directoryName ) ;
00741
00742
00743
00751 virtual FileSystemManager & getCorrespondingFileSystemManager()
00752 const = 0 ;
00753
00754
00755
00762 std::string _path ;
00763
00764
00765
00775 static FileSystemManager & GetCorrespondingFileSystemManager() ;
00776
00777
00778
00779
00780 private:
00781
00782
00783
00791 Directory( const Directory & source ) ;
00792
00793
00801 Directory & operator = ( const Directory & source ) ;
00802
00803
00804 } ;
00805
00806
00807 }
00808
00809 }
00810
00811
00812
00813 #endif // CEYLAN_DIRECTORY_H_
00814