OLD | NEW |
---|---|
1 // Copyright (c) 2008 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2008 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 // FilePath is a container for pathnames stored in a platform's native string | 5 // FilePath is a container for pathnames stored in a platform's native string |
6 // type, providing containers for manipulation in according with the | 6 // type, providing containers for manipulation in according with the |
7 // platform's conventions for pathnames. It supports the following path | 7 // platform's conventions for pathnames. It supports the following path |
8 // types: | 8 // types: |
9 // | 9 // |
10 // POSIX Windows | 10 // POSIX Windows |
(...skipping 52 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
63 // | } | 63 // | } |
64 | 64 |
65 #ifndef BASE_FILE_PATH_H_ | 65 #ifndef BASE_FILE_PATH_H_ |
66 #define BASE_FILE_PATH_H_ | 66 #define BASE_FILE_PATH_H_ |
67 | 67 |
68 #include <string> | 68 #include <string> |
69 | 69 |
70 #include "base/basictypes.h" | 70 #include "base/basictypes.h" |
71 #include "base/compiler_specific.h" | 71 #include "base/compiler_specific.h" |
72 #include "base/hash_tables.h" | 72 #include "base/hash_tables.h" |
73 #include "base/string_piece.h" // For implicit conversions. | |
Mark Mentovai
2009/05/29 13:04:55
I don't think comments like this for #includes are
| |
73 | 74 |
74 // Windows-style drive letter support and pathname separator characters can be | 75 // Windows-style drive letter support and pathname separator characters can be |
75 // enabled and disabled independently, to aid testing. These #defines are | 76 // enabled and disabled independently, to aid testing. These #defines are |
76 // here so that the same setting can be used in both the implementation and | 77 // here so that the same setting can be used in both the implementation and |
77 // in the unit test. | 78 // in the unit test. |
78 #if defined(OS_WIN) | 79 #if defined(OS_WIN) |
79 #define FILE_PATH_USES_DRIVE_LETTERS | 80 #define FILE_PATH_USES_DRIVE_LETTERS |
80 #define FILE_PATH_USES_WIN_SEPARATORS | 81 #define FILE_PATH_USES_WIN_SEPARATORS |
81 #endif // OS_WIN | 82 #endif // OS_WIN |
82 | 83 |
(...skipping 109 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
192 // it is an error to pass an absolute path. | 193 // it is an error to pass an absolute path. |
193 FilePath Append(const StringType& component) const WARN_UNUSED_RESULT; | 194 FilePath Append(const StringType& component) const WARN_UNUSED_RESULT; |
194 FilePath Append(const FilePath& component) const WARN_UNUSED_RESULT; | 195 FilePath Append(const FilePath& component) const WARN_UNUSED_RESULT; |
195 | 196 |
196 // Although Windows StringType is std::wstring, since the encoding it uses for | 197 // Although Windows StringType is std::wstring, since the encoding it uses for |
197 // paths is well defined, it can handle ASCII path components as well. | 198 // paths is well defined, it can handle ASCII path components as well. |
198 // Mac uses UTF8, and since ASCII is a subset of that, it works there as well. | 199 // Mac uses UTF8, and since ASCII is a subset of that, it works there as well. |
199 // On Linux, although it can use any 8-bit encoding for paths, we assume that | 200 // On Linux, although it can use any 8-bit encoding for paths, we assume that |
200 // ASCII is a valid subset, regardless of the encoding, since many operating | 201 // ASCII is a valid subset, regardless of the encoding, since many operating |
201 // system paths will always be ASCII. | 202 // system paths will always be ASCII. |
202 FilePath AppendASCII(const std::string& component) const WARN_UNUSED_RESULT; | 203 FilePath AppendASCII(const StringPiece& component) const WARN_UNUSED_RESULT; |
203 | 204 |
204 // Returns true if this FilePath contains an absolute path. On Windows, an | 205 // Returns true if this FilePath contains an absolute path. On Windows, an |
205 // absolute path begins with either a drive letter specification followed by | 206 // absolute path begins with either a drive letter specification followed by |
206 // a separator character, or with two separator characters. On POSIX | 207 // a separator character, or with two separator characters. On POSIX |
207 // platforms, an absolute path begins with a separator character. | 208 // platforms, an absolute path begins with a separator character. |
208 bool IsAbsolute() const; | 209 bool IsAbsolute() const; |
209 | 210 |
210 // Returns a copy of this FilePath that does not end with a trailing | 211 // Returns a copy of this FilePath that does not end with a trailing |
211 // separator. | 212 // separator. |
212 FilePath StripTrailingSeparators() const; | 213 FilePath StripTrailingSeparators() const; |
(...skipping 46 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
259 namespace stdext { | 260 namespace stdext { |
260 | 261 |
261 inline size_t hash_value(const FilePath& f) { | 262 inline size_t hash_value(const FilePath& f) { |
262 return hash_value(f.value()); | 263 return hash_value(f.value()); |
263 } | 264 } |
264 | 265 |
265 } // namespace stdext | 266 } // namespace stdext |
266 #endif // COMPILER | 267 #endif // COMPILER |
267 | 268 |
268 #endif // BASE_FILE_PATH_H_ | 269 #endif // BASE_FILE_PATH_H_ |
OLD | NEW |