|Filesystem Home Releases Reference Tutorial FAQ Portability V3 Intro V3 Design Deprecated|
Version 3 is a major revision of the Boost Filesystem library. Important changes include:
pathhandles all aspects of internationalization, replacing the previous template and its
wpathinstantiations. Character types
char32_tare supported. This is a major simplification of the path abstraction, particularly for functions that take path arguments.
class pathmembers include:
absolute(). This replaces the operations function
complete(), which is now deprecated. Semantics are now provided for a Windows corner case where the
baseargument was not an absolute path. Previously this resulted in an exception being thrown.
create_symlink()now supported on both POSIX and Windows.
read_symlink()function added. Supported on both POSIX and Windows. Used to read the contents of a symlink itself.
resize_file()function added. Supported on both POSIX and Windows. Used to shrink or grow a regular file.
unique_path()function added. Supported on both POSIX and Windows. Used to generate a secure temporary pathname.
error_codeis now uniform throughout the operations functions.
See the Deprecated Features page for transition aids that allow much existing code to compile without change using Version 3.
To ease the transition, Versions 2 and 3 will both be included in the next several Boost releases. Version 2 will be the default version for one release cycle, and then Version 3 will become the default version.
basic_pathand its specializations are replaced by a single
class path. Thus any code, such as overloaded functions, that depends on
wpathbeing two distinct types will fail to compile and must be restructured. Restructuring may be as simple as removing one of the overloads, but also might require more complex redesign.
pathobjects rather than
string or wstringobjects:
Not all uses will fail; if the function is being called in a context that
path, all is well. If the result is being used in a
context requiring a
.wstring() respectively must be
appended to the function call.
std::wstring) are no longer supported.
© Copyright Beman Dawes, 2009
Distributed under the Boost Software License, Version 1.0. See www.boost.org/LICENSE_1_0.txt
Revised 20 March 2012