From Jason Turner

[fs.dir.entry.mods]

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmp3dnoxu79/{from.md → to.md} +42 -0
tmp/tmp3dnoxu79/{from.md → to.md} RENAMED
@@ -0,0 +1,42 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ #### `directory_entry` modifiers <a id="fs.dir.entry.mods">[[fs.dir.entry.mods]]</a>
2
+
3
+ ``` cpp
4
+ void assign(const path& p);
5
+ void assign(const path& p, error_code& ec);
6
+ ```
7
+
8
+ *Effects:* Equivalent to `pathobject = p`, then `refresh()` or
9
+ `refresh(ec)`, respectively. If an error occurs, the values of any
10
+ cached attributes are unspecified.
11
+
12
+ *Throws:* As specified in  [[fs.err.report]].
13
+
14
+ ``` cpp
15
+ void replace_filename(const path& p);
16
+ void replace_filename(const path& p, error_code& ec);
17
+ ```
18
+
19
+ *Effects:* Equivalent to `pathobject.replace_filename(p)`, then
20
+ `refresh()` or `refresh(ec)`, respectively. If an error occurs, the
21
+ values of any cached attributes are unspecified.
22
+
23
+ *Throws:* As specified in  [[fs.err.report]].
24
+
25
+ ``` cpp
26
+ void refresh();
27
+ void refresh(error_code& ec) noexcept;
28
+ ```
29
+
30
+ *Effects:* Stores the current values of any cached attributes of the
31
+ file `p` resolves to. If an error occurs, an error is
32
+ reported ([[fs.err.report]]) and the values of any cached attributes
33
+ are unspecified.
34
+
35
+ *Throws:* As specified in  [[fs.err.report]].
36
+
37
+ [*Note 1*: Implementations of
38
+ `directory_iterator` ([[fs.class.directory_iterator]]) are prohibited
39
+ from directly or indirectly calling the `refresh` function since it must
40
+ access the external file system, and the objective of caching is to
41
+ avoid unnecessary file system accesses. — *end note*]
42
+