29 Input/output library [input.output]

29.11 File systems [filesystems]

29.11.13 Filesystem operation functions [fs.op.funcs]

29.11.13.9 Create directory symlink [fs.op.create.dir.symlk]

void create_directory_symlink(const path& to, const path& new_symlink);
void create_directory_symlink(const path& to, const path& new_symlink,
                              error_code& ec) noexcept;

Effects: Establishes the postcondition, as if by POSIX symlink().

Postconditions: new_symlink resolves to a symbolic link file that contains an unspecified representation of to.

Throws: As specified in [fs.err.report].

[Note 1:

Some operating systems require symlink creation to identify that the link is to a directory.

Thus, create_symlink() (instead of create_directory_symlink()) cannot be used reliably to create directory symlinks.

— end note]

[Note 2:

Some operating systems do not support symbolic links at all or support them only for regular files.

Some file systems (such as the FAT file system) do not support symbolic links regardless of the operating system.

— end note]