// Written by Curtis L. Olson, started April 1999.
//
-// Copyright (C) 1999 Curtis L. Olson - curt@flightgear.org
+// Copyright (C) 1999 Curtis L. Olson - http://www.flightgear.org/~curt
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Library General Public
#define _SG_PATH_HXX
-#ifdef HAVE_CONFIG_H
-# include <config.h>
-#endif
-
#include <simgear/compiler.h>
-
#include STL_STRING
-SG_USING_STD(string);
-
+#include <simgear/math/sg_types.hxx>
-#ifdef macintosh
-# define SG_PATH_SEP ':'
-# define SG_BAD_PATH_SEP '/'
-#else
-# define SG_PATH_SEP '/'
-# define SG_BAD_PATH_SEP ':'
-#endif
+SG_USING_STD(string);
/**
* Construct a path based on the starting path provided.
* @param p initial path
*/
- SGPath( const string p );
+ SGPath( const string& p );
/** Destructor */
~SGPath();
* Set path to a new value
* @param p new path
*/
- void set( const string p );
+ void set( const string& p );
+ SGPath& operator= ( const char* p ) { this->set(p); return *this; }
/**
* 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 string& p );
+
+ /**
+ * 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 );
/**
* Concatenate a string to the end of the path without inserting a
* path separator.
* @param p addtional path suffix
*/
- void concat( const string p );
+ void concat( const string& p );
+ /**
+ * Get the file part of the path (everything after the last path sep)
+ * @return file string
+ */
+ string file() const;
+
/**
* Get the directory part of the path.
* @return directory string
*/
- string dir();
+ string dir() const;
+ /**
+ * Get the base part of the path (everything but the extension.)
+ * @return the base string
+ */
+ string base() const;
+
+ /**
+ * Get the extention part of the path (everything after the final ".")
+ * @return the extention string
+ */
+ string extension() const;
+
/** Get the path string
* @return path string
*/
- inline string str() const { return path; }
+ string str() const { return path; }
/** Get the path string
* @return path in "C" string (ptr to char array) form.
*/
- inline const char *c_str() { return path.c_str(); }
+ const char* c_str() { return path.c_str(); }
+
+ /**
+ * Determine if file exists by attempting to fopen it.
+ * @return true if file exists, otherwise returns false.
+ */
+ bool exists() const;
+
+private:
+
+ void fix();
+
};
+/**
+ * Split a directory search path into a vector of individual paths
+ */
+string_list sgPathSplit( const string &search_path );
+
+
#endif // _SG_PATH_HXX