29 Input/output library [input.output]

Several functions are defined to accept detected-format arguments, which are character sequences.

A detected-format argument represents a path using either a pathname in the generic format ([fs.path.generic]) or a pathname in the native format ([fs.class.path]).

Such an argument is taken to be in the generic format if and only if it matches the generic format and is not acceptable to the operating system as a native path.

Pathnames are converted as needed between the generic and native formats in an operating-system-dependent manner.

Let G(n) and N(g) in a mathematical sense be the implementation's functions that convert native-to-generic and generic-to-native formats respectively.

If g=G(n) for some n, then G(N(g))=g; if n=N(g) for some g, then N(G(n))=n.

If the native format requires paths for regular files to be formatted differently from paths for directories, the path shall be treated as a directory path if its last element is a directory-separator, otherwise it shall be treated as a path to a regular file.

When a path is constructed from or is assigned a single representation separate from any path, the other representation is selected by the appropriate conversion function (G or N).

When the (new) value p of one representation of a path is derived from the representation of that or another path, a value q is chosen for the other representation.

The value q converts to p (by G or N as appropriate) if any such value does so; q is otherwise unspecified.

The native encoding of an ordinary character string is the operating system dependent current encoding for pathnames ([fs.class.path]).

The native encoding for wide character strings is the implementation-defined execution wide-character set encoding ([lex.charset]).

For member function arguments that take character sequences representing paths and for member functions returning strings, value type and encoding conversion is performed if the value type of the argument or return value differs from path​::​value_­type.

For the argument or return value, the method of conversion and the encoding to be converted to is determined by its value type:

• (2.1)
  char: The encoding is the native ordinary encoding.

  The method of conversion, if any, is operating system dependent.

  [Note 1:

  For POSIX-based operating systems path​::​value_­type is char so no conversion from char value type arguments or to char value type return values is performed.

  For Windows-based operating systems, the native ordinary encoding is determined by calling a Windows API function.

  — end note]

  [Note 2:

  This results in behavior identical to other C and C++ standard library functions that perform file operations using ordinary character strings to identify paths.

  Changing this behavior would be surprising and error prone.

  — end note]
• (2.2)
  wchar_­t: The encoding is the native wide encoding.

  The method of conversion is unspecified.

  [Note 3:

  For Windows-based operating systems path​::​value_­type is wchar_­t so no conversion from wchar_­t value type arguments or to wchar_­t value type return values is performed.

  — end note]
• (2.3)
  char8_­t: The encoding is UTF-8.

  The method of conversion is unspecified.
• (2.4)
  char16_­t: The encoding is UTF-16.

  The method of conversion is unspecified.
• (2.5)
  char32_­t: The encoding is UTF-32.

  The method of conversion is unspecified.

If the encoding being converted to has no representation for source characters, the resulting converted characters, if any, are unspecified.

Implementations should not modify member function arguments if already of type path​::​value_­type.