#include <sys/types.h>
#include <simgear/compiler.h>
-#include STL_STRING
+#include <string>
+#include <ctime>
#include <simgear/math/sg_types.hxx>
-SG_USING_STD(string);
-
#ifdef _MSC_VER
typedef int mode_t;
#endif
class SGPath {
-private:
-
- string path;
-
public:
+ struct Permissions
+ {
+ bool read : 1;
+ bool write : 1;
+ };
+ typedef Permissions (*PermissionChecker)(const SGPath&);
+
/** Default constructor */
- SGPath();
+ explicit SGPath(PermissionChecker validator = NULL);
+
+ /** Copy contructor */
+ SGPath(const SGPath& p);
+
+ SGPath& operator=(const SGPath& p);
/**
* Construct a path based on the starting path provided.
* @param p initial path
*/
- SGPath( const string& p );
+ SGPath( const std::string& p, PermissionChecker validator = NULL );
+
+ /**
+ * Construct a path based on the starting path provided and a relative subpath
+ * @param p initial path
+ * @param r relative subpath
+ */
+ SGPath( const SGPath& p,
+ const std::string& r,
+ PermissionChecker validator = NULL );
/** Destructor */
~SGPath();
* Set path to a new value
* @param p new path
*/
- void set( const string& p );
+ void set( const std::string& p );
SGPath& operator= ( const char* p ) { this->set(p); return *this; }
+ bool operator==(const SGPath& other) const;
+ bool operator!=(const SGPath& other) const;
+
+ void setPermissionChecker(PermissionChecker validator);
+ PermissionChecker getPermissionChecker() const;
+
+ /**
+ * Set if file information (exists, type, mod-time) is cached or
+ * retrieved each time it is queried. Caching is enabled by default
+ */
+ void set_cached(bool cached);
+
/**
* Append another piece to the existing path. Inserts a path
* separator between the existing component and the new component.
* @param p additional path component */
- void append( const string& p );
+ void append( const std::string& p );
+
+ /**
+ * Get a copy of this path with another piece appended.
+ *
+ * @param p additional path component
+ */
+ SGPath operator/( const std::string& p ) const;
/**
* Append a new piece to the existing path. Inserts a search path
* separator to the existing path and the new patch component.
* @param p additional path component */
- void add( const string& p );
+ void add( const std::string& p );
/**
* Concatenate a string to the end of the path without inserting a
* path separator.
* @param p additional path suffix
*/
- void concat( const string& p );
+ void concat( const std::string& p );
+
+ /**
+ * Returns a string with the absolute pathname that names the same file, whose
+ * resolution does not involve '.', '..', or symbolic links.
+ */
+ std::string realpath() const;
/**
* Get the file part of the path (everything after the last path sep)
* @return file string
*/
- string file() const;
+ std::string file() const;
/**
* Get the directory part of the path.
* @return directory string
*/
- string dir() const;
+ std::string dir() const;
/**
- * Get the base part of the path (everything but the extension.)
+ * Get the base part of the path (everything but the final extension.)
* @return the base string
*/
- string base() const;
+ std::string base() const;
+
+ /**
+ * Get the base part of the filename (everything before the first '.')
+ * @return the base filename
+ */
+ std::string file_base() const;
/**
* Get the extension part of the path (everything after the final ".")
* @return the extension string
*/
- string extension() const;
-
+ std::string extension() const;
+
+ /**
+ * Get the extension part of the path (everything after the final ".")
+ * converted to lowercase
+ * @return the extension string
+ */
+ std::string lower_extension() const;
+
+ /**
+ * Get the complete extension part of the path (everything after the first ".")
+ * this might look like 'tar.gz' or 'txt.Z', or might be identical to 'extension' above
+ * the extension is converted to lowercase.
+ * @return the extension string
+ */
+ std::string complete_lower_extension() const;
+
/**
* Get the path string
* @return path string
*/
- string str() const { return path; }
+ std::string str() const { return path; }
/**
* Get the path string
* @return path in "C" string (ptr to char array) form.
*/
- const char* c_str() { return path.c_str(); }
+ const char* c_str() const { return path.c_str(); }
+
+ /**
+ * Get the path string in OS native form
+ */
+ std::string str_native() const;
/**
* Determine if file exists by attempting to fopen it.
*/
int create_dir(mode_t mode);
+ /**
+ * Check if reading file is allowed. Readabilty does not imply the existance
+ * of the file.
+ *
+ * @note By default all files will be marked as readable. No check is made
+ * if the operating system allows the given file to be read. Derived
+ * classes may actually implement custom read/write rights.
+ */
+ bool canRead() const;
+ bool canWrite() const;
+
+ bool isFile() const;
+ bool isDir() const;
+
+ /**
+ * Opposite sense to isAbsolute
+ */
+ bool isRelative() const { return !isAbsolute(); }
+
+ /**
+ * Is this an absolute path?
+ * I.e starts with a directory seperator, or a single character + colon
+ */
+ bool isAbsolute() const;
+
+ /**
+ * check for default constructed path
+ */
+ bool isNull() const;
+
+ /**
+ * delete the file, if possible
+ */
+ bool remove();
+
+ /**
+ * modification time of the file
+ */
+ time_t modTime() const;
+
+ /**
+ * rename the file / directory we point at, to a new name
+ * this may fail if the new location is on a different volume / share,
+ * or if the destination already exists, or is not writeable
+ */
+ bool rename(const SGPath& newName);
+
+ enum StandardLocation
+ {
+ HOME,
+ DESKTOP,
+ DOWNLOADS,
+ DOCUMENTS,
+ PICTURES
+ };
+
+ static SGPath standardLocation( StandardLocation type,
+ const SGPath& def = SGPath() );
+
+ /**
+ * Get a path stored in the environment variable with the given \a name.
+ *
+ * @param name Name of the environment variable
+ * @param def Default path to return if the environment variable does not
+ * exist or is empty.
+ */
+ static SGPath fromEnv(const char* name, const SGPath& def = SGPath());
+
+ /**
+ * Get path to user's home directory
+ */
+ static SGPath home(const SGPath& def = SGPath());
+
+ /**
+ * Get path to the user's desktop directory
+ */
+ static SGPath desktop(const SGPath& def = SGPath());
+
+ /**
+ * Get path to the user's documents directory
+ */
+ static SGPath documents(const SGPath& def = SGPath());
+
private:
void fix();
+ void validate() const;
+ void checkAccess() const;
+
+ std::string path;
+ PermissionChecker _permission_checker;
+
+ mutable bool _cached : 1;
+ mutable bool _rwCached : 1;
+ bool _cacheEnabled : 1; ///< cacheing can be disbled if required
+ mutable bool _canRead : 1;
+ mutable bool _canWrite : 1;
+ mutable bool _exists : 1;
+ mutable bool _isDir : 1;
+ mutable bool _isFile : 1;
+ mutable time_t _modTime;
};
+/// Output to an ostream
+template<typename char_type, typename traits_type>
+inline
+std::basic_ostream<char_type, traits_type>&
+operator<<(std::basic_ostream<char_type, traits_type>& s, const SGPath& p)
+{ return s << "Path \"" << p.str() << "\""; }
+
/**
* Split a directory string into a list of it's parent directories.
*/
-string_list sgPathBranchSplit( const string &path );
+string_list sgPathBranchSplit( const std::string &path );
/**
* Split a directory search path into a vector of individual paths
*/
-string_list sgPathSplit( const string &search_path );
+string_list sgPathSplit( const std::string &search_path );
#endif // _SG_PATH_HXX