From Jason Turner

[fs.op.weakly.canonical]

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmprjw_op9h/{from.md → to.md} +26 -0
tmp/tmprjw_op9h/{from.md → to.md} RENAMED
@@ -0,0 +1,26 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ #### Weakly canonical <a id="fs.op.weakly.canonical">[[fs.op.weakly.canonical]]</a>
2
+
3
+ ``` cpp
4
+ path weakly_canonical(const path& p);
5
+ path weakly_canonical(const path& p, error_code& ec);
6
+ ```
7
+
8
+ *Returns:* `p` with symlinks resolved and the result
9
+ normalized [[fs.path.generic]].
10
+
11
+ *Effects:* Using `status(p)` or `status(p, ec)`, respectively, to
12
+ determine existence, return a path composed by `operator/=` from the
13
+ result of calling `canonical()` with a path argument composed of the
14
+ leading elements of `p` that exist, if any, followed by the elements of
15
+ `p` that do not exist, if any. For the first form, `canonical()` is
16
+ called without an `error_code` argument. For the second form,
17
+ `canonical()` is called with `ec` as an `error_code` argument, and
18
+ `path()` is returned at the first error occurrence, if any.
19
+
20
+ *Ensures:* The returned path is in normal form [[fs.path.generic]].
21
+
22
+ *Remarks:* Implementations should avoid unnecessary normalization such
23
+ as when `canonical` has already been called on the entirety of `p`.
24
+
25
+ *Throws:* As specified in  [[fs.err.report]].
26
+