OLD | NEW |
1 /* | 1 /* |
2 * Copyright 2004 The WebRTC Project Authors. All rights reserved. | 2 * Copyright 2004 The WebRTC Project Authors. All rights reserved. |
3 * | 3 * |
4 * Use of this source code is governed by a BSD-style license | 4 * Use of this source code is governed by a BSD-style license |
5 * that can be found in the LICENSE file in the root of the source | 5 * that can be found in the LICENSE file in the root of the source |
6 * tree. An additional intellectual property rights grant can be found | 6 * tree. An additional intellectual property rights grant can be found |
7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
9 */ | 9 */ |
10 | 10 |
11 #ifndef WEBRTC_BASE_PATHUTILS_H__ | 11 #ifndef WEBRTC_BASE_PATHUTILS_H_ |
12 #define WEBRTC_BASE_PATHUTILS_H__ | 12 #define WEBRTC_BASE_PATHUTILS_H_ |
13 | 13 |
14 #include <string> | |
15 | 14 |
16 #include "webrtc/base/checks.h" | 15 // This header is deprecated and is just left here temporarily during |
| 16 // refactoring. See https://bugs.webrtc.org/7634 for more details. |
| 17 #include "webrtc/rtc_base/pathutils.h" |
17 | 18 |
18 namespace rtc { | 19 #endif // WEBRTC_BASE_PATHUTILS_H_ |
19 | |
20 /////////////////////////////////////////////////////////////////////////////// | |
21 // Pathname - parsing of pathnames into components, and vice versa. | |
22 // | |
23 // To establish consistent terminology, a filename never contains a folder | |
24 // component. A folder never contains a filename. A pathname may include | |
25 // a folder and/or filename component. Here are some examples: | |
26 // | |
27 // pathname() /home/john/example.txt | |
28 // folder() /home/john/ | |
29 // filename() example.txt | |
30 // parent_folder() /home/ | |
31 // folder_name() john/ | |
32 // basename() example | |
33 // extension() .txt | |
34 // | |
35 // Basename may begin, end, and/or include periods, but no folder delimiters. | |
36 // If extension exists, it consists of a period followed by zero or more | |
37 // non-period/non-delimiter characters, and basename is non-empty. | |
38 /////////////////////////////////////////////////////////////////////////////// | |
39 | |
40 class Pathname { | |
41 public: | |
42 // Folder delimiters are slash and backslash | |
43 static bool IsFolderDelimiter(char ch); | |
44 static char DefaultFolderDelimiter(); | |
45 | |
46 Pathname(); | |
47 Pathname(const Pathname&); | |
48 Pathname(Pathname&&); | |
49 Pathname(const std::string& pathname); | |
50 Pathname(const std::string& folder, const std::string& filename); | |
51 | |
52 Pathname& operator=(const Pathname&); | |
53 Pathname& operator=(Pathname&&); | |
54 | |
55 // Normalize changes all folder delimiters to folder_delimiter() | |
56 void Normalize(); | |
57 | |
58 // Reset to the empty pathname | |
59 void clear(); | |
60 | |
61 // Returns true if the pathname is empty. Note: this->pathname().empty() | |
62 // is always false. | |
63 bool empty() const; | |
64 | |
65 // Returns the folder and filename components. If the pathname is empty, | |
66 // returns a string representing the current directory (as a relative path, | |
67 // i.e., "."). | |
68 std::string pathname() const; | |
69 void SetPathname(const std::string& pathname); | |
70 void SetPathname(const std::string& folder, const std::string& filename); | |
71 | |
72 std::string folder() const; | |
73 std::string parent_folder() const; | |
74 // SetFolder and AppendFolder will append a folder delimiter, if needed. | |
75 void SetFolder(const std::string& folder); | |
76 void AppendFolder(const std::string& folder); | |
77 | |
78 bool SetBasename(const std::string& basename); | |
79 | |
80 // SetExtension will prefix a period, if needed. | |
81 bool SetExtension(const std::string& extension); | |
82 | |
83 std::string filename() const; | |
84 bool SetFilename(const std::string& filename); | |
85 | |
86 private: | |
87 std::string folder_, basename_, extension_; | |
88 char folder_delimiter_; | |
89 }; | |
90 | |
91 } // namespace rtc | |
92 | |
93 #endif // WEBRTC_BASE_PATHUTILS_H__ | |
OLD | NEW |