libs/fs_path.h

   1 /*
   2    Copyright (C) 2001-2006, William Joseph.
   3    All Rights Reserved.
   4
   5    This file is part of GtkRadiant.
   6
   7    GtkRadiant is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 2 of the License, or
  10    (at your option) any later version.
  11
  12    GtkRadiant is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with GtkRadiant; if not, write to the Free Software
  19    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  20  */
  21
  22 #if !defined( INCLUDED_FS_PATH_H )
  23 #define INCLUDED_FS_PATH_H
  24
  25 /// \brief A unix-style path string which can be modified at runtime.
  26 ///
  27 /// - Maintains a path ending in a path-separator.
  28 /// - Provides a limited STL-style interface to push and pop file or directory names at the end of the path.
  29 class UnixPath
  30 {
  31 std::string m_string;
  32
  33 void ensure_separator(){
  34         if ( !empty() && m_string.back() != '/' ) {
  35                 m_string.push_back( '/' );
  36         }
  37 }
  38
  39 public:
  40 /// \brief Constructs with the directory \p root.
  41 UnixPath( const char* root )
  42         : m_string( root ){
  43         ensure_separator();
  44 }
  45
  46 bool empty() const {
  47         return m_string.empty();
  48 }
  49
  50 const char* c_str() const {
  51         return m_string.c_str();
  52 }
  53
  54 /// \brief Appends the directory \p name.
  55 void push( const char* name ){
  56         m_string += name;
  57         ensure_separator();
  58 }
  59 /// \brief Appends the filename \p name.
  60 void push_filename( const char* name ){
  61         m_string += name;
  62 }
  63 /// \brief Removes the last directory or filename appended.
  64 void pop(){
  65         if ( m_string.back() == '/' ) {
  66                 m_string.pop_back();
  67         }
  68         while ( !empty() && m_string.back() != '/' )
  69         {
  70                 m_string.pop_back();
  71         }
  72 }
  73 };
  74
  75 #endif