From Jason Turner

[fs.class.directory.entry]

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmp65g0_040/{from.md → to.md} +19 -3
tmp/tmp65g0_040/{from.md → to.md} RENAMED
@@ -1,7 +1,9 @@
1
  ### Class `directory_entry` <a id="fs.class.directory.entry">[[fs.class.directory.entry]]</a>
2
 
 
 
3
  ``` cpp
4
  namespace std::filesystem {
5
  class directory_entry {
6
  public:
7
  // [fs.dir.entry.cons], constructors and destructor
@@ -57,10 +59,15 @@ namespace std::filesystem {
57
  file_status symlink_status(error_code& ec) const noexcept;
58
 
59
  bool operator==(const directory_entry& rhs) const noexcept;
60
  strong_ordering operator<=>(const directory_entry& rhs) const noexcept;
61
 
 
 
 
 
 
62
  private:
63
  filesystem::path pathobject; // exposition only
64
  friend class directory_iterator; // exposition only
65
  };
66
  }
@@ -163,13 +170,12 @@ unspecified.
163
 
164
  *Throws:* As specified in  [[fs.err.report]].
165
 
166
  [*Note 1*: Implementations of `directory_iterator`
167
  [[fs.class.directory.iterator]] are prohibited from directly or
168
- indirectly calling the `refresh` function since it must access the
169
- external file system, and the objective of caching is to avoid
170
- unnecessary file system accesses. — *end note*]
171
 
172
  #### Observers <a id="fs.dir.entry.obs">[[fs.dir.entry.obs]]</a>
173
 
174
  Unqualified function names in the *Returns:* elements of the
175
  `directory_entry` observers described below refer to members of the
@@ -334,5 +340,15 @@ bool operator==(const directory_entry& rhs) const noexcept;
334
  strong_ordering operator<=>(const directory_entry& rhs) const noexcept;
335
  ```
336
 
337
  *Returns:* `pathobject <=> rhs.pathobject`.
338
 
 
 
 
 
 
 
 
 
 
 
 
1
  ### Class `directory_entry` <a id="fs.class.directory.entry">[[fs.class.directory.entry]]</a>
2
 
3
+ #### General <a id="fs.class.directory.entry.general">[[fs.class.directory.entry.general]]</a>
4
+
5
  ``` cpp
6
  namespace std::filesystem {
7
  class directory_entry {
8
  public:
9
  // [fs.dir.entry.cons], constructors and destructor
 
59
  file_status symlink_status(error_code& ec) const noexcept;
60
 
61
  bool operator==(const directory_entry& rhs) const noexcept;
62
  strong_ordering operator<=>(const directory_entry& rhs) const noexcept;
63
 
64
+ // [fs.dir.entry.io], inserter
65
+ template<class charT, class traits>
66
+ friend basic_ostream<charT, traits>&
67
+ operator<<(basic_ostream<charT, traits>& os, const directory_entry& d);
68
+
69
  private:
70
  filesystem::path pathobject; // exposition only
71
  friend class directory_iterator; // exposition only
72
  };
73
  }
 
170
 
171
  *Throws:* As specified in  [[fs.err.report]].
172
 
173
  [*Note 1*: Implementations of `directory_iterator`
174
  [[fs.class.directory.iterator]] are prohibited from directly or
175
+ indirectly calling the `refresh` function as described in
176
+ [[fs.class.directory.iterator.general]]. *end note*]
 
177
 
178
  #### Observers <a id="fs.dir.entry.obs">[[fs.dir.entry.obs]]</a>
179
 
180
  Unqualified function names in the *Returns:* elements of the
181
  `directory_entry` observers described below refer to members of the
 
340
  strong_ordering operator<=>(const directory_entry& rhs) const noexcept;
341
  ```
342
 
343
  *Returns:* `pathobject <=> rhs.pathobject`.
344
 
345
+ #### Inserter <a id="fs.dir.entry.io">[[fs.dir.entry.io]]</a>
346
+
347
+ ``` cpp
348
+ template<class charT, class traits>
349
+ friend basic_ostream<charT, traits>&
350
+ operator<<(basic_ostream<charT, traits>& os, const directory_entry& d);
351
+ ```
352
+
353
+ *Effects:* Equivalent to: `return os << d.path();`
354
+