50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
[fs.op.create.symlink]
|
||
|
||
# 31 Input/output library [[input.output]](./#input.output)
|
||
|
||
## 31.12 File systems [[filesystems]](filesystems#fs.op.create.symlink)
|
||
|
||
### 31.12.13 Filesystem operation functions [[fs.op.funcs]](fs.op.funcs#fs.op.create.symlink)
|
||
|
||
#### 31.12.13.11 Create symlink [fs.op.create.symlink]
|
||
|
||
[ð](#lib:create_symlink)
|
||
|
||
`void filesystem::create_symlink(const path& to, const path& new_symlink);
|
||
void filesystem::create_symlink(const path& to, const path& new_symlink,
|
||
error_code& ec) noexcept;
|
||
`
|
||
|
||
[1](#1)
|
||
|
||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iostreams.tex#L17712)
|
||
|
||
*Effects*: Establishes the postcondition, as if by POSIX [symlink](http://pubs.opengroup.org/onlinepubs/9699919799/functions/symlink.html)[.](#1.sentence-1)
|
||
|
||
[2](#2)
|
||
|
||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iostreams.tex#L17716)
|
||
|
||
*Postconditions*: new_symlink resolves to a symbolic link file that
|
||
contains an unspecified representation of to[.](#2.sentence-1)
|
||
|
||
[3](#3)
|
||
|
||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iostreams.tex#L17721)
|
||
|
||
*Throws*: As specified in [[fs.err.report]](fs.err.report "31.12.5 Error reporting")[.](#3.sentence-1)
|
||
|
||
[4](#4)
|
||
|
||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iostreams.tex#L17725)
|
||
|
||
[*Note [1](#note-1)*:
|
||
|
||
Some operating systems do not support symbolic links at all or support
|
||
them only for regular files[.](#4.sentence-1)
|
||
|
||
Some file systems (such as the FAT file system) do not
|
||
support symbolic links regardless of the operating system[.](#4.sentence-2)
|
||
|
||
â *end note*]
|