121 lines
3.8 KiB
C++
121 lines
3.8 KiB
C++
/******************************************************************************/
|
|
/* FILESYSTEM ABSTRACTION *****************************************************/
|
|
/******************************************************************************/
|
|
|
|
#ifndef _H_EBCL_FILESYSTEM
|
|
#define _H_EBCL_FILESYSTEM
|
|
|
|
#include <ebcl/Strings.hh>
|
|
#include <ebcl/Utilities.hh>
|
|
namespace ebcl {
|
|
|
|
|
|
/*= FILESYSTEM PATH ==========================================================*/
|
|
|
|
class T_FSPath
|
|
{
|
|
public:
|
|
using T_Components = T_AutoArray< T_String , 16 >;
|
|
|
|
private:
|
|
|
|
// Root will be '/' on Unix, or a drive letter on Windows. Relative
|
|
// paths will have a blank root.
|
|
T_String root_;
|
|
T_Components components_;
|
|
bool valid_;
|
|
|
|
public:
|
|
//----------------------------------------------------------------------
|
|
// Helpers
|
|
|
|
static bool IsValidComponent( T_String const& string ) noexcept;
|
|
static bool IsValidRoot( T_String const& string ) noexcept;
|
|
|
|
//----------------------------------------------------------------------
|
|
// Basic constructors and assignment operators
|
|
|
|
T_FSPath( ) noexcept;
|
|
|
|
T_FSPath( T_FSPath const& other ) noexcept;
|
|
T_FSPath& operator =( T_FSPath const& other ) noexcept;
|
|
|
|
T_FSPath( T_FSPath&& other ) noexcept;
|
|
T_FSPath& operator =( T_FSPath&& other ) noexcept;
|
|
|
|
T_FSPath& swap( T_FSPath& other ) noexcept;
|
|
|
|
// Construct from a string
|
|
T_FSPath( T_String const& path ) noexcept;
|
|
|
|
//----------------------------------------------------------------------
|
|
|
|
bool isValid( ) const noexcept;
|
|
|
|
T_String const& root( ) const noexcept;
|
|
T_Components const& components( ) const noexcept;
|
|
// FIXME: provide iterators for the components
|
|
|
|
bool isRelative( ) const noexcept;
|
|
bool isAbsolute( ) const noexcept;
|
|
|
|
//----------------------------------------------------------------------
|
|
|
|
// Convert the path into a string
|
|
T_String toString( ) const noexcept;
|
|
// Compute a hash value for the path
|
|
uint32_t computeHash( ) const noexcept;
|
|
// Append to a string builder
|
|
void appendTo( T_StringBuilder& sb ) const noexcept;
|
|
|
|
// Equality operators. On Windows the comparison will be
|
|
// case-insensitive.
|
|
bool operator ==( T_FSPath const& other ) const noexcept;
|
|
bool operator !=( T_FSPath const& other ) const noexcept;
|
|
|
|
//----------------------------------------------------------------------
|
|
|
|
// Returns the parent's path
|
|
T_FSPath parent( ) const noexcept;
|
|
|
|
// Returns the child's path
|
|
T_FSPath child( T_String const& name ) const noexcept;
|
|
|
|
// Appends the specified (relative) path to the current path and return
|
|
// the result. If the path is absolute, the result will be invalid.
|
|
T_FSPath operator +( T_FSPath const& other ) const noexcept;
|
|
|
|
// Checks if the current path and the specified path have the same
|
|
// parent and are different.
|
|
bool inDirectoryOf( T_FSPath const& other ) const noexcept;
|
|
|
|
// Checks if the current path is the direct parent of the specified path
|
|
bool isParentOf( T_FSPath const& other ) const noexcept;
|
|
// Checks if the current path is the direct child of the specified path
|
|
bool isChildOf( T_FSPath const& other ) const noexcept;
|
|
|
|
// Checks if the current path is a parent of the specified path
|
|
bool isAbove( T_FSPath const& other ) const noexcept;
|
|
// Checks if the current path is a child of the specified path
|
|
bool isUnder( T_FSPath const& other ) const noexcept;
|
|
|
|
//----------------------------------------------------------------------
|
|
|
|
// Checks whether the specified path is canonical
|
|
bool isCanonical( ) const noexcept;
|
|
// Return a canonical path from the current path
|
|
T_FSPath canonical( ) const noexcept;
|
|
};
|
|
M_DECLARE_SWAP( T_FSPath );
|
|
M_DECLARE_HASH( T_FSPath );
|
|
M_LSHIFT_OP( T_StringBuilder , T_FSPath );
|
|
|
|
|
|
/*= T_FSPath =================================================================*/
|
|
// FIXME: inline stuff should be moved
|
|
|
|
|
|
|
|
|
|
} // namespace ebcl
|
|
#endif // _H_EBCL_FILESYSTEM
|