+
Headings and synopsis for recently added functionality is show with a green background.
+Headings and synopsis for recently added functionality are shown with a +green background.
@@ -146,7 +147,8 @@ last_write_timepermissions
read_symlink
- relative
+ + relative
remove
remove_all
rename
@@ -158,7 +160,8 @@ system_complete
temp_directory_path
unique_path
- weakly_canonical
+ + weakly_canonical
File streams
Path decomposition table
Warning: Long paths on Windows and the @@ -386,7 +389,7 @@ native pathname format.
native pathname format [fs.def.native]
The operating system dependent pathname format accepted by the host operating system.
-normal form path [fs.def.normal]
+normal form path [fs.def.normal]
A path with no redundant current directory (dot) or parent directory (dot-dot) elements. The normal form for an empty path is an empty path. The normal form for a path ending in a directory-separator that is not the root directory @@ -998,6 +1001,8 @@ of a path. The path does not necessarily exist in external storage, and the pathname is not necessarily valid for the current operating system or for a particular file system.
+namespace boost
{
namespace filesystem
@@ -1008,6 +1013,8 @@ system or for a particular file system.
typedef see below value_type;
typedef std::basic_string<value_type> string_type;
typedef std::codecvt<wchar_t, char, std::mbstate_t> codecvt_type;
+ constexpr value_type dot;
+ constexpr value_type separator;
constexpr value_type preferred_separator;
// constructors and destructor
@@ -1117,6 +1124,8 @@ system or for a particular file system.
// query
bool empty() const;
+ bool filename_is_dot() const;
+ bool filename_is_dot_dot() const;
bool has_root_name() const;
bool has_root_directory() const;
bool has_root_path() const;
@@ -1150,6 +1159,8 @@ system or for a particular file system.
} // namespace filesystem
} // namespace boost
+value_type is a typedef for the
character type used by the operating system to represent pathnames.
path equality. —end example]
Returns: pathname.c_str().
string_type::size_type size() const noexcept;+
string_type::size_type size() const noexcept;
Returns:
@@ -1704,11 +1715,10 @@ for (; !p.extension().empty(); p = p.stem())pathname.size().
—end example]
[Note: The dot is included in the return value so that it is - possible to distinguish between no extension and an empty extension. - See - - http://permalink.gmane.org/gmane.comp.lib.boost.devel/199744 for more - extensive rationale. —end note]
+ possible to distinguish between no extension and an empty extension. + See + http://permalink.gmane.org/gmane.comp.lib.boost.devel/199744 for more + extensive rationale. —end note] path query [path.query]
@@ -1718,6 +1728,34 @@ for (; !p.extension().empty(); p = p.stem())
Returns: m_pathname.empty().
bool filename_is_dot() const;+ +
++ +Returns:
+filename() == path(".")[Example:
++ ++std::cout << path(".").filename_is_dot(); // outputs 1 +std::cout << path("/.").filename_is_dot(); // outputs 1 +std::cout << path("foo/.").filename_is_dot(); // outputs 1 +std::cout << path("foo/").filename_is_dot(); // outputs 1 +std::cout << path("/").filename_is_dot(); // outputs 0 +std::cout << path("/foo").filename_is_dot(); // outputs 0 +std::cout << path("/foo.").filename_is_dot(); // outputs 0 +std::cout << path("..").filename_is_dot(); // outputs 0+ +See the last bullet item in the forward traversal order + list for why
+path("foo/").filename()is a dot filename.—end example]
+
bool filename_is_dot_dot() const;+ +
++Returns:
+filename() == path("..")
bool has_root_path() const;
@@ -1897,7 +1935,11 @@ const string_type external_directory_string() const { return native(); }-[Note: A
pathawarelexicographical_comparealgorithm is provided for historical reasons. —end note]
path lexically_normal(const path& p);+
path lexically_normal(const path& p);+ +
-Overview: Returns
pwith redundant current @@ -1917,7 +1959,11 @@ const string_type external_directory_string() const { return native(); } —end example]
path lexically_relative(const path& p, const path& base);+
path lexically_relative(const path& p, const path& base);+ +
Overview: Returns
pmade relative to@@ -4221,7 +4267,7 @@ multiple string types. His idea became the basis for the version 3 path design.< www.boost.org/LICENSE_1_0.txtRevised -25 October 2015
+01 December 2015