radiant: replace StringBuffer with std::string
[xonotic/netradiant.git] / 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