Skip to content

Commit 054568b

Browse files
author
cpprefjp-autoupdate
committed
update automatically
1 parent 13bfd81 commit 054568b

File tree

6 files changed

+504
-139
lines changed

6 files changed

+504
-139
lines changed

‎reference/filesystem/path.html

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -188,8 +188,8 @@
188188

189189
<p class="text-right"><small>
190190
最終更新日時(UTC):
191-
<span itemprop="datePublished" content="2024-06-11T13:45:38">
192-
2024年06月11日 13時45分38秒
191+
<span itemprop="datePublished" content="2025-03-03T04:59:58">
192+
2025年03月03日 04時59分58秒
193193
</span>
194194
<br/>
195195
<span itemprop="author" itemscope itemtype="http://schema.org/Person">
@@ -789,6 +789,23 @@ <h3>生成関数</h3>
789789
</tr>
790790
</tbody>
791791
</table>
792+
<h2>文字列フォーマットサポート</h2>
793+
<table border="1" bordercolor="#888" style="border-collapse:collapse">
794+
<thead>
795+
<tr>
796+
<th>名前</th>
797+
<th>説明</th>
798+
<th>対応バージョン</th>
799+
</tr>
800+
</thead>
801+
<tbody>
802+
<tr>
803+
<td><code><a href="path/formatter.html">formatter</a></code></td>
804+
<td><code><a href="../format/formatter.html">std::formatter</a></code>クラスの特殊化</td>
805+
<td>C++26</td>
806+
</tr>
807+
</tbody>
808+
</table>
792809
<h2>例</h2>
793810
<h3>POSIXベースシステムの例</h3>
794811
<p><div class="yata" id="14348e5d7ceb054567553a88818adf1b31dc1d46"><div class="codehilite"><pre><span></span><code><span class="cp">#include</span> <span class="cpf"><a href="../iostream.html">&lt;iostream&gt;</a></span><span class="cp"></span>

‎reference/filesystem/path/formatter.html

Lines changed: 335 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,335 @@
1+
<!doctype html>
2+
<html class="cpprefjp" lang="ja" itemscope="" itemtype="http://schema.org/WebPage">
3+
<head>
4+
5+
6+
<!-- Google tag (gtag.js) -->
7+
<script async src="https://www.googletagmanager.com/gtag/js?id=G-NXNBNVBTJS"></script>
8+
<script>
9+
window.dataLayer = window.dataLayer || [];
10+
function gtag(){dataLayer.push(arguments);}
11+
gtag('js', new Date());
12+
13+
gtag('config', 'G-NXNBNVBTJS');
14+
</script>
15+
16+
17+
<meta charset="UTF-8">
18+
19+
<title>formatter - cpprefjp C++日本語リファレンス</title>
20+
21+
<meta name="viewport" content="width=device-width,initial-scale=1">
22+
<meta name="keywords" content="
23+
C++,標準ライブラリ,リファレンス,ドキュメント,STL,std,filesystem,std,class,cpp26
24+
">
25+
<meta name="title" content="formatter - cpprefjp C++日本語リファレンス" />
26+
<meta itemprop="name" content="formatter - cpprefjp C++日本語リファレンス" />
27+
<meta property="og:title" content="formatter - cpprefjp C++日本語リファレンス" />
28+
<meta property="og:url" content="https://cpprefjp.github.io/reference/filesystem/path/formatter.html" />
29+
<meta property="og:site_name" content="cpprefjp - C++日本語リファレンス" />
30+
<meta property="og:type" content="article" />
31+
<meta property="og:description" content="`filesystem::path`クラスに対する[`std::formatter`](/reference/format/formatter.md)クラステンプレートの特殊化。" />
32+
<meta name="twitter:card" content="summary" />
33+
<meta name="twitter:title" content="formatter - cpprefjp C++日本語リファレンス" />
34+
<meta name="twitter:url" content="https://cpprefjp.github.io/reference/filesystem/path/formatter.html" />
35+
<meta name="twitter:description" content="`filesystem::path`クラスに対する[`std::formatter`](/reference/format/formatter.md)クラステンプレートの特殊化。" />
36+
37+
38+
<link rel="alternate" type="application/atom+xml" title="Atom" href="https://cpprefjp.github.io/rss.xml" />
39+
40+
41+
<link rel="apple-touch-icon" sizes="180x180" href="../../../static/favicons/apple-touch-icon.png?cachebust=e90195fc23550f46643fc23da380e6bbea96d909">
42+
<link rel="icon" type="image/png" sizes="32x32" href="../../../static/favicons/favicon-32x32.png?cachebust=e90195fc23550f46643fc23da380e6bbea96d909">
43+
<link rel="icon" type="image/png" sizes="16x16" href="../../../static/favicons/favicon-16x16.png?cachebust=e90195fc23550f46643fc23da380e6bbea96d909">
44+
<link rel="manifest" href="../../../manifest.json?cachebust=e90195fc23550f46643fc23da380e6bbea96d909">
45+
<meta name="theme-color" content="#f5f8fc">
46+
47+
<link rel="stylesheet" href="../../../static/pygments/default.css?cachebust=e90195fc23550f46643fc23da380e6bbea96d909">
48+
<!-- <link rel="stylesheet" href="../../../static/css/root.css"> -->
49+
50+
51+
52+
53+
54+
<link href="../../../static/kunai/css/kunai-stage-0.css?cachebust=e90195fc23550f46643fc23da380e6bbea96d909" rel="stylesheet">
55+
<link href="../../../static/kunai/css/kunai-stage-1.css?cachebust=e90195fc23550f46643fc23da380e6bbea96d909" rel="stylesheet">
56+
<link href="../../../static/kunai/css/kunai-stage-2.css?cachebust=e90195fc23550f46643fc23da380e6bbea96d909" rel="stylesheet">
57+
<link href="../../../static/kunai/css/kunai-stage-3.css?cachebust=e90195fc23550f46643fc23da380e6bbea96d909" rel="stylesheet">
58+
59+
<script type="text/javascript" src="../../../static/kunai/js/kunai-vendor.js?cachebust=e90195fc23550f46643fc23da380e6bbea96d909"></script>
60+
<script type="text/javascript" src="../../../static/kunai/js/kunai.js?cachebust=e90195fc23550f46643fc23da380e6bbea96d909"></script>
61+
62+
<script type="text/javascript">
63+
document.addEventListener('DOMContentLoaded', function() {
64+
var kn = new Kunai;
65+
kn.cpprefjp();
66+
});
67+
</script>
68+
69+
</head>
70+
<body>
71+
<header data-kunai-mdinfo="{&#34;meta&#34;: {&#34;header&#34;: [&#34;filesystem&#34;], &#34;namespace&#34;: [&#34;std&#34;], &#34;id-type&#34;: [&#34;class&#34;], &#34;cpp&#34;: [&#34;cpp26&#34;]}, &#34;sources&#34;: [{&#34;id&#34;: &#34;2dc8a9e64142e58320fd6f8a88de06217f7f2e5f&#34;, &#34;source&#34;: &#34;#include &lt;print&gt;\n#include &lt;filesystem&gt;\n\nnamespace fs = std::filesystem;\n\nint main() {\n fs::path a = \&#34;/a/b/c.txt\&#34;;\n fs::path b = \&#34;multi\\nline\&#34;;\n fs::path c = \&#34;a\\\\b\\\\c.txt\&#34;;\n\n // \u30c7\u30d5\u30a9\u30eb\u30c8\u30d5\u30a9\u30fc\u30de\u30c3\u30c8\u306f\u3001operator&lt;&lt;\u3068\u3061\u304c\u3063\u3066\n // \u5f15\u7528\u7b26\u3067\u56f2\u307e\u305a\u306b\u51fa\u529b\u3059\u308b\n std::println(\&#34;1 : {}\&#34;, a);\n\n // \u30c7\u30d0\u30c3\u30b0\u51fa\u529b\u3002\n // \u5f15\u7528\u7b26\u3067\u56f2\u307f\u3001\u30a8\u30b9\u30b1\u30fc\u30d7\u30b7\u30fc\u30b1\u30f3\u30b9\u3092\u30a8\u30b9\u30b1\u30fc\u30d7\u3057\u3066\u51fa\u529b\u3059\u308b\n std::println(\&#34;2 : {:?}\&#34;, a);\n std::println(\&#34;3 : {:?}\&#34;, b);\n\n // \u74b0\u5883\u975e\u4f9d\u5b58\u306e\u30d1\u30b9\u30d5\u30a9\u30fc\u30de\u30c3\u30c8\n std::println(\&#34;4 : {:g}\&#34;, c);\n std::println(\&#34;5 : {}\&#34;, c);\n}\n&#34;}], &#34;page_id&#34;: [&#34;reference&#34;, &#34;filesystem&#34;, &#34;path&#34;, &#34;formatter&#34;]}">
72+
<nav class="navbar navbar-default" role="navigation">
73+
<div class="container-fluid">
74+
<div class="navbar-header">
75+
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar-collapse">
76+
<span class="sr-only">Toggle navigation</span>
77+
<span class="icon-bar"></span>
78+
<span class="icon-bar"></span>
79+
<span class="icon-bar"></span>
80+
</button>
81+
<a class="navbar-brand" href="../../../index.html">
82+
<div class="title-wrapper clearfix">
83+
<div class="title">cpprefjp - C++日本語リファレンス</div>
84+
</div>
85+
</a>
86+
</div>
87+
88+
<div class="collapse navbar-collapse" id="navbar-collapse">
89+
<ul class="nav navbar-nav navbar-right">
90+
<li>
91+
<div class="google-search">
92+
93+
94+
<script>
95+
(function() {
96+
var cx = '013316413321391058734:ji_u66hl7hq';
97+
var gcse = document.createElement('script');
98+
gcse.type = 'text/javascript';
99+
gcse.async = true;
100+
gcse.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') +
101+
'//www.google.com/cse/cse.js?cx=' + cx;
102+
var s = document.getElementsByTagName('script')[0];
103+
s.parentNode.insertBefore(gcse, s);
104+
})();
105+
</script>
106+
<div class="gcse-search"></div>
107+
108+
109+
</div>
110+
</li>
111+
<li>
112+
<a href="https://github.com/cpprefjp/site">GitHub Project</a>
113+
</li>
114+
</ul>
115+
</div>
116+
</div>
117+
</nav>
118+
</header>
119+
120+
<main id="main" role="main">
121+
<div class="container-fluid">
122+
<div class="row">
123+
<div class="col-sm-9 col-sm-push-3" itemscope itemtype="http://schema.org/Article">
124+
<div class="row">
125+
<div class="col-sm-12 google-search-result">
126+
<gcse:searchresults></gcse:searchresults>
127+
</div>
128+
</div>
129+
<div class="row">
130+
<div class="col-sm-12 content-header">
131+
132+
<ol class="breadcrumb">
133+
134+
<li itemscope itemtype="http://www.schema.org/SiteNavigationElement">
135+
<span>
136+
137+
<a href="../../../index.html" itemprop="url">
138+
139+
<i class="fa fa-fw fa-home"></i>
140+
141+
</a>
142+
143+
</span>
144+
</li>
145+
146+
<li itemscope itemtype="http://www.schema.org/SiteNavigationElement">
147+
<span>
148+
149+
<a href="../../../reference.html" itemprop="url">
150+
151+
<span itemprop="name">リファレンス</span>
152+
153+
</a>
154+
155+
</span>
156+
</li>
157+
158+
<li itemscope itemtype="http://www.schema.org/SiteNavigationElement">
159+
<span>
160+
161+
<a href="../../../reference/filesystem.html" itemprop="url">
162+
163+
<span itemprop="name">filesystem</span>
164+
165+
</a>
166+
167+
</span>
168+
</li>
169+
170+
<li itemscope itemtype="http://www.schema.org/SiteNavigationElement">
171+
<span>
172+
173+
<a href="../../../reference/filesystem/path.html" itemprop="url">
174+
175+
<span itemprop="name">path</span>
176+
177+
</a>
178+
179+
</span>
180+
</li>
181+
182+
<li class="active" itemscope itemtype="http://www.schema.org/SiteNavigationElement">
183+
<span>
184+
185+
186+
<span itemprop="name">formatter</span>
187+
188+
189+
</span>
190+
</li>
191+
192+
</ol>
193+
<div class="crsearch"></div>
194+
195+
</div>
196+
</div>
197+
<div class="row">
198+
<div class="col-sm-12 edit-button">
199+
200+
201+
<p class="text-right"><small>
202+
最終更新日時(UTC):
203+
<span itemprop="datePublished" content="2025-03-03T04:59:58">
204+
2025年03月03日 04時59分58秒
205+
</span>
206+
<br/>
207+
<span itemprop="author" itemscope itemtype="http://schema.org/Person">
208+
<span itemprop="name">Akira Takahashi</span>
209+
</span>
210+
が更新
211+
</small></p>
212+
213+
214+
<p class="text-right">
215+
<a class="history" target="_blank" href="https://github.com/cpprefjp/site/commits/master/reference/filesystem/path/formatter.md">
216+
<span class="fa fa-fw fa-clock-o fa-flip-horizontal"></span>履歴
217+
</a>
218+
<a class="edit" target="_blank" href="https://github.com/cpprefjp/site/edit/master/reference/filesystem/path/formatter.md">
219+
<span class="fa fa-fw fa-pencil"></span>編集
220+
</a>
221+
</p>
222+
</div>
223+
</div>
224+
<div class="row">
225+
<div class="col-sm-12 content-body">
226+
227+
<div class="identifier-type">class</div><div class="header">&lt;filesystem&gt;</div><h1 itemprop="name"><span class="namespace" title="namespace std">std::</span><span class="token">formatter</span><span class="cpp cpp26" title="C++26で追加">(C++26)</span></h1>
228+
<div itemprop="articleBody"><p><div class="codehilite"><pre><span></span><code><span class="k">namespace</span> <span class="n">std</span> <span class="p">{</span>
229+
<span class="k">template</span> <span class="o">&lt;</span><span class="k">class</span> <span class="nc">charT</span><span class="o">&gt;</span>
230+
<span class="k">struct</span> <span class="n">formatter</span><span class="o">&lt;</span><span class="n">filesystem</span><span class="o">::</span><span class="n">path</span><span class="p">,</span> <span class="n">charT</span><span class="o">&gt;</span><span class="p">;</span>
231+
<span class="p">}</span>
232+
</code></pre></div>
233+
</p>
234+
<h2>概要</h2>
235+
<p><code>filesystem::path</code>クラスに対する<code><a href="../../format/formatter.html">std::formatter</a></code>クラステンプレートの特殊化。</p>
236+
<p>書式としては、以下を使用できる：</p>
237+
<p><pre><code>[[fill] align] [width] [?] [g]
238+
</code></pre></p>
239+
<ul>
240+
<li><code>fill</code> : アライメントに使う文字 (デフォルト: スペース)</li>
241+
<li><code>align</code> : アライメント(デフォルトは型による)<ul>
242+
<li><code>&gt;</code> : 右寄せ</li>
243+
<li><code>&lt;</code> : 左寄せ</li>
244+
<li><code>^</code> : 中央寄せ</li>
245+
</ul>
246+
</li>
247+
<li><code>width</code> : 幅 (アライメントもしくは0埋めの幅)<ul>
248+
<li>置換フィールドを使って変数で指定できる</li>
249+
</ul>
250+
</li>
251+
<li><code>?</code> : デバッグ出力<ul>
252+
<li>文字・文字列を引用符で囲み、エスケープシーケンスをエスケープして出力</li>
253+
</ul>
254+
</li>
255+
<li><code>g</code> : 環境非依存のパスフォーマット (<code><a href="generic_string.html">generic_string()</a></code>) を使用する<ul>
256+
<li>これが指定されない場合は、プラットフォームごとのパスフォーマット (<code><a href="native.html">native()</a></code>) を使用する</li>
257+
</ul>
258+
</li>
259+
</ul>
260+
<h2>例</h2>
261+
<p><div class="yata" id="2dc8a9e64142e58320fd6f8a88de06217f7f2e5f"><div class="codehilite"><pre><span></span><code><span class="cp">#include</span> <span class="cpf"><a href="../../print.html">&lt;print&gt;</a></span><span class="cp"></span>
262+
<span class="cp">#include</span> <span class="cpf"><a href="../../filesystem.html">&lt;filesystem&gt;</a></span><span class="cp"></span>
263+
264+
<span class="k">namespace</span> <span class="n">fs</span> <span class="o">=</span> <span class="n">std</span><span class="o">::</span><span class="n">filesystem</span><span class="p">;</span>
265+
266+
<span class="kt">int</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span>
267+
<span class="n"><a href="../path.html">fs::path</a></span> <span class="n">a</span> <span class="o">=</span> <span class="s">"/a/b/c.txt"</span><span class="p">;</span>
268+
<span class="n"><a href="../path.html">fs::path</a></span> <span class="n">b</span> <span class="o">=</span> <span class="s">"multi</span><span class="se">\n</span><span class="s">line"</span><span class="p">;</span>
269+
<span class="n"><a href="../path.html">fs::path</a></span> <span class="n">c</span> <span class="o">=</span> <span class="s">"a</span><span class="se">\\</span><span class="s">b</span><span class="se">\\</span><span class="s">c.txt"</span><span class="p">;</span>
270+
271+
<span class="c1">// デフォルトフォーマットは、operator&lt;&lt;とちがって</span>
272+
<span class="c1">// 引用符で囲まずに出力する</span>
273+
<span class="n"><a href="../../print/println.html">std::println</a></span><span class="p">(</span><span class="s">"1 : {}"</span><span class="p">,</span> <span class="n">a</span><span class="p">);</span>
274+
275+
<span class="c1">// デバッグ出力。</span>
276+
<span class="c1">// 引用符で囲み、エスケープシーケンスをエスケープして出力する</span>
277+
<span class="n"><a href="../../print/println.html">std::println</a></span><span class="p">(</span><span class="s">"2 : {:?}"</span><span class="p">,</span> <span class="n">a</span><span class="p">);</span>
278+
<span class="n"><a href="../../print/println.html">std::println</a></span><span class="p">(</span><span class="s">"3 : {:?}"</span><span class="p">,</span> <span class="n">b</span><span class="p">);</span>
279+
280+
<span class="c1">// 環境非依存のパスフォーマット</span>
281+
<span class="n"><a href="../../print/println.html">std::println</a></span><span class="p">(</span><span class="s">"4 : {:g}"</span><span class="p">,</span> <span class="n">c</span><span class="p">);</span>
282+
<span class="n"><a href="../../print/println.html">std::println</a></span><span class="p">(</span><span class="s">"5 : {}"</span><span class="p">,</span> <span class="n">c</span><span class="p">);</span>
283+
<span class="p">}</span>
284+
</code></pre></div>
285+
</div></p>
286+
<h3>出力例</h3>
287+
<p><pre><code>1. /a/b/c.txt
288+
2. "/a/b/c.txt"
289+
3. "multi\nline"
290+
4. a/b/c.txt
291+
5. a\b\c.txt
292+
</code></pre></p>
293+
<h2>バージョン</h2>
294+
<h3>言語</h3>
295+
<ul>
296+
<li>C++26</li>
297+
</ul>
298+
<h3>処理系</h3>
299+
<ul>
300+
<li><a href="../../../implementation.html#clang">Clang</a>: 20.0 <span aria-label="未実装" role="img" title="未実装">❌</span></li>
301+
<li><a href="../../../implementation.html#gcc">GCC</a>: 14 <span aria-label="未実装" role="img" title="未実装">❌</span></li>
302+
<li><a href="../../../implementation.html#visual_cpp">Visual C++</a>: 2022 Update 10 <span aria-label="未実装" role="img" title="未実装">❌</span></li>
303+
</ul>
304+
<h2>関連項目</h2>
305+
<ul>
306+
<li><code><a href="../../format/format.html">std::format()</a></code> (フォーマットの詳細)</li>
307+
</ul>
308+
<h2>参照</h2>
309+
<ul>
310+
<li><a href="https://open-std.org/jtc1/sc22/wg21/docs/papers/2024/p2845r8.html" target="_blank">P2845R8 Formatting of <code>std::filesystem::path</code></a></li>
311+
</ul></div>
312+
313+
</div>
314+
</div>
315+
</div>
316+
317+
318+
<div id="sidebar" class="col-sm-3 col-sm-pull-9">
319+
</div>
320+
321+
322+
</div>
323+
</div>
324+
</main>
325+
<footer class="footer navbar navbar-default">
326+
<div class="container-fluid">
327+
<p><small>
328+
本サイトの情報は、
329+
<a href="https://creativecommons.org/licenses/by/3.0/deed.ja" rel="nofollow">クリエイティブ・コモンズ 表示 3.0 非移植 ライセンス(CC BY)</a>
330+
の下に提供されています。
331+
</small></p>
332+
</div>
333+
</footer>
334+
</body>
335+
</html>

0 commit comments

Comments
 (0)