atf-c%2B%2B/detail/fs.hpp

57 // The "path" class.
61 //! \brief A class to represent a path to a file.
63 //! The path class represents the route to a file or directory in the
68 //! It is important to note that the file pointed to by a path need not
71 class path {
73     //! \brief Internal representation of a path.
78     //! \brief Constructs a new path from a user-provided string.
81     //! code or by the user and constructs a new path object.  The string
87     explicit path(const std::string&);
92     path(const path&);
97     path(const atf_fs_path_t *);
100     //! \brief Destructor for the path class.
102     ~path(void);
105     //! \brief Returns a pointer to a C-style string representing this path.
115     //! \brief Returns a string representing this path.
121     //! \brief Returns the branch path of this path.
123     //! Calculates and returns the branch path of this path.  In other
126     path branch_path(void) const;
129     //! \brief Returns the leaf name of this path.
131     //! Calculates and returns the leaf name of this path.  In other words,
137     //! \brief Checks whether this path is absolute or not.
139     //! Returns a boolean indicating if this is an absolute path or not;
145     //! \brief Checks whether this path points to the root directory or not.
147     //! Returns a boolean indicating if this is path points to the root
155     //! \brief Converts the path to be absolute.
157     //! \pre The path was not absolute.
159     path to_absolute(void) const;
164     path& operator=(const path&);
169     bool operator==(const path&) const;
174     bool operator!=(const path&) const;
177     //! \brief Concatenates a path with a string.
179     //! Constructs a new path object that is the concatenation of the
180     //! left-hand path with the right-hand string.  The string is normalized
181     //! before the concatenation, and a path delimiter is introduced between
184     path operator/(const std::string&) const;
187     //! \brief Concatenates a path with another path.
189     //! Constructs a new path object that is the concatenation of the
190     //! left-hand path with the right-hand one. A path delimiter is
193     path operator/(const path&) const;
196     //! \brief Checks if a path has to be sorted before another one
199     bool operator<(const path&) const;
237     explicit file_info(const path&);
341     //! Constructs a new directory object representing the given path.
345     directory(const path&);
361 //! \brief Checks if the given path exists.
363 bool exists(const path&);
368 //! Given a program name (without slashes) looks for it in the path and
369 //! returns its full path name if found, otherwise an empty path.
374 //! \brief Checks if the given path exists, is accessible and is executable.
376 bool is_executable(const path&);
381 void remove(const path&);
386 void rmdir(const path&);