From Jason Turner

[fs.path.generic.obs]

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmpovxyzhgj/{from.md → to.md} +44 -0
tmp/tmpovxyzhgj/{from.md → to.md} RENAMED
@@ -0,0 +1,44 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ##### `path` generic format observers <a id="fs.path.generic.obs">[[fs.path.generic.obs]]</a>
2
+
3
+ Generic format observer functions return strings formatted according to
4
+ the generic pathname format ([[fs.path.generic]]). A single slash
5
+ (`'/'`) character is used as the *directory-separator*.
6
+
7
+ [*Example 1*:
8
+
9
+ On an operating system that uses backslash as its *preferred-separator*,
10
+
11
+ ``` cpp
12
+ path("foo\\bar").generic_string()
13
+ ```
14
+
15
+ returns `"foo/bar"`.
16
+
17
+ — *end example*]
18
+
19
+ ``` cpp
20
+ template <class EcharT, class traits = char_traits<EcharT>,
21
+ class Allocator = allocator<EcharT>>
22
+ basic_string<EcharT, traits, Allocator>
23
+ generic_string(const Allocator& a = Allocator()) const;
24
+ ```
25
+
26
+ *Returns:* The pathname in the generic format.
27
+
28
+ *Remarks:* All memory allocation, including for the return value, shall
29
+ be performed by `a`. Conversion, if any, is specified by
30
+ [[fs.path.cvt]].
31
+
32
+ ``` cpp
33
+ std::string generic_string() const;
34
+ std::wstring generic_wstring() const;
35
+ std::string generic_u8string() const;
36
+ std::u16string generic_u16string() const;
37
+ std::u32string generic_u32string() const;
38
+ ```
39
+
40
+ *Returns:* The pathname in the generic format.
41
+
42
+ *Remarks:* Conversion, if any, is specified by  [[fs.path.cvt]]. The
43
+ encoding of the string returned by `generic_u8string()` is always UTF-8.
44
+