Return a normalised filesystem::path from an AFIO path.

Description

On POSIX this passes through its input unchanged.

On Windows AFIO exclusively uses NT kernel paths which are not necessarily trivially convertible to Win32 paths. As an example, the Win32 path C:\\Foo might be \\??\\C:\\Foo or even \\Device\\HarddiskVolume1\\Foo. This function will convert any NT kernel path into something which can be fed to normal Win32 APIs - a drive letter if available, else a GUID volume path, and with an extended path prefix if the path is sufficiently long. It also scans the path for characters illegal under Win32 or paths which begin with a space or end with a period, and will extended path prefix such paths as well.

Synopsis

filesystem::path normalise_path(path p, path_normalise type = path_normalise::dos)

Parameters

Header

#include <boost/afio/v2/afio.hpp>