As the library evolves over time, names sometimes
change or old features are removed to make way for new features. To ease transition, Boost.Filesystem deprecates
the old names and features, but by default continues to provide many of them.
@@ -69,7 +69,7 @@ can be suppressed by defining BOOST_FILESYSTEM_ALLOW_DEPRECATED mac
Construction, assignment and appending from container types.
Use string types or iterators as the source for path construction, assignment and appending.
BOOST_FILESYSTEM_ALLOW_DEPRECATED mac
current_path() early in the application startup.
BOOST_FILESYSTEM_ALLOW_DEPRECATED mac
Some library features were removed in one of the past releases. The table below lists some of +those features along with suggested replacements.
+ +| + Component or location | +
+ Removed name |
+
+ Possible replacement |
+
class path |
+ branch_path() |
+ parent_path() |
+
class path |
+ directory_string() |
+ string |
+
class path |
+ external_directory_string() |
+ native() |
+
class path |
+ external_file_string() |
+ native() |
+
class path |
+ file_string() |
+ string() |
+
class path |
+ has_branch_path() |
+ has_parent_path() |
+
class path |
+ has_leaf() |
+ has_filename() |
+
class path |
+ is_complete() |
+ is_absolute() |
+
class path |
+ leaf() |
+ filename() |
+
+ class path |
+
+ native_directory_string() |
+
+ string() |
+
+ class path |
+
+ native_file_string() |
+
+ string() |
+
+ class path |
+
+ normalize() |
+
+ Replace p.normalize() with p = p.lexically_normal(). |
+
+ class path |
+
+
|
+
+
|
+
+ path.hpp |
+
+ typedef basic_path<std::wstring, wpath_traits> wpath |
+
+ class path |
+
+ operations.hpp |
+
+
|
+
+
|
+
+ operations.hpp |
+
+ is_regular(file_status f) |
+
+
+ |
+
+ operations.hpp |
+
+ symbolic_link_exists(const path& ph) |
+
+ Replace symbolic_link_exists(p) with is_symlink(symlink_status(p)). |
+
+ operations.hpp |
+
+ copy_directory(const path& from, const path& to) |
+
+ create_directory(const path& to, const path& from). Note the reversed order of arguments. |
+
+ class directory_entry |
+
+ filename() |
+
+ Replace de.filename() with de.path().filename(). |
+
+ class directory_entry |
+
+ leaf() |
+
+ Replace de.leaf() with de.path().filename(). |
+
+ class directory_entry |
+
+ string() |
+
+ Replace de.string() with de.path().string(). |
+
class recursive_directory_iterator |
+ level() |
+ depth() |
+
class recursive_directory_iterator |
+ no_push_pending() |
+ !recursion_pending() |
+
class recursive_directory_iterator |
+ no_push() |
+ disable_recursion_pending() |
+
directory.hpp |
+ enum class symlink_option |
+ Use corresponding values of enum class directory_options instead. |
+
+ directory.hpp |
+
+ wrecursive_directory_iterator typedef |
+
+ class recursive_directory_iterator. |
+
+ operations.hpp |
+
+ The header provides filesystem_error, file_status, directory_entry, directory_iterator, recursive_directory_iterator and associated enums and functions. |
+
+ Explicitly include headers exception.hpp, file_status.hpp and/or directory.hpp to introduce the required components. |
+
+ path_traits.hpp |
+
+ The header contained implementation details of class path. |
+ + Remove the include. | +
+ convenience.hpp |
+ + The header contained helper functions that were deprecated and then removed. | ++ Remove the include. |
weakly_canonical now produces an absolute path if the input path is relative and contains no elements that exist in the filesystem. (#300)copy_options::ignore_attribute_errors option for copy_file and copy operations. The new option allows to ignore possible errors while copying file attributes. (#179)copy_file backends based on sendfile and copy_file_range system calls will attempt to preallocate storage for the target file. This may reduce filesystem fragmentation and provide early error indication if there is not enough free space. Not all filesystems support this feature; file copying proceeds if storage preallocation is not supported.path and recursive_directory_iterator member functions, is_regular, copy_directory, symbolic_link_exists, complete, copy_option, symlink_option, as well as boost/filesystem/convenience.hpp and boost/filesystem/path_traits.hpp headers were removed.path and recursive_directory_iterator member functions, is_regular, copy_directory, symbolic_link_exists, complete, copy_option, symlink_option, as well as boost/filesystem/convenience.hpp and boost/filesystem/path_traits.hpp headers were removed. Possible replacements for the removed components are mentioned in Deprecated names and features section.path construction, assignment and appending from container types (e.g. std::vector<char>) is now disabled by default. Users can still enable this functionality by defining BOOST_FILESYSTEM_DEPRECATED. This functionality remains deprecated and will be completely removed in a future release.