| /* |
| * libjingle |
| * Copyright 2004--2005, Google Inc. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions are met: |
| * |
| * 1. Redistributions of source code must retain the above copyright notice, |
| * this list of conditions and the following disclaimer. |
| * 2. Redistributions in binary form must reproduce the above copyright notice, |
| * this list of conditions and the following disclaimer in the documentation |
| * and/or other materials provided with the distribution. |
| * 3. The name of the author may not be used to endorse or promote products |
| * derived from this software without specific prior written permission. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED |
| * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF |
| * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO |
| * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
| * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; |
| * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, |
| * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR |
| * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF |
| * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| */ |
| |
| #ifndef TALK_BASE_PATHUTILS_H__ |
| #define TALK_BASE_PATHUTILS_H__ |
| |
| #include <string> |
| |
| namespace talk_base { |
| |
| /////////////////////////////////////////////////////////////////////////////// |
| // Pathname - parsing of pathnames into components, and vice versa. |
| // |
| // To establish consistent terminology, a filename never contains a folder |
| // component. A folder never contains a filename. A pathname may include |
| // a folder and/or filename component. Here are some examples: |
| // |
| // pathname() /home/john/example.txt |
| // folder() /home/john/ |
| // filename() example.txt |
| // parent_folder() /home/ |
| // folder_name() john/ |
| // basename() example |
| // extension() .txt |
| // |
| // Basename may begin, end, and/or include periods, but no folder delimiters. |
| // If extension exists, it consists of a period followed by zero or more |
| // non-period/non-delimiter characters, and basename is non-empty. |
| /////////////////////////////////////////////////////////////////////////////// |
| |
| class Pathname { |
| public: |
| // Folder delimiters are slash and backslash |
| static bool IsFolderDelimiter(char ch); |
| |
| Pathname(); |
| Pathname(const std::string& pathname); |
| |
| // Set's the default folder delimiter for this Pathname |
| char folder_delimiter() const { return folder_delimiter_; } |
| void SetFolderDelimiter(char delimiter); |
| |
| // Normalize changes all folder delimiters to folder_delimiter() |
| void Normalize(); |
| |
| // Reset to the empty pathname |
| void clear(); |
| |
| std::string url() const; |
| |
| std::string pathname() const; |
| void SetPathname(const std::string& pathname); |
| |
| // Append pathname to the current folder (if any). Any existing filename |
| // will be discarded. |
| void AppendPathname(const Pathname& pathname); |
| |
| std::string folder() const; |
| std::string folder_name() const; |
| std::string parent_folder() const; |
| // SetFolder and AppendFolder will append a folder delimiter, if needed. |
| void SetFolder(const std::string& folder); |
| void AppendFolder(const std::string& folder); |
| |
| std::string basename() const; |
| void SetBasename(const std::string& basename); |
| |
| std::string extension() const; |
| // SetExtension will prefix a period, if needed. |
| void SetExtension(const std::string& extension); |
| |
| std::string filename() const; |
| void SetFilename(const std::string& filename); |
| |
| private: |
| |
| std::string folder_, basename_, extension_; |
| char folder_delimiter_; |
| }; |
| |
| |
| /////////////////////////////////////////////////////////////////////////////// |
| |
| } // namespace talk_base |
| |
| #endif // TALK_BASE_PATHUTILS_H__ |