update automatically

Author: cpprefjp-autoupdate

reference/charconv/to_chars.html

@@ -188,12 +188,12 @@
 
     <p class="text-right"><small>
       最終更新日時(UTC):
-      <span itemprop="datePublished" content="2024-06-11T13:45:38">
-        2024年06月11日 13時45分38秒
+      <span itemprop="datePublished" content="2024-06-30T10:51:45">
+        2024年06月30日 10時51分45秒
       </span>
       <br/>
       <span itemprop="author" itemscope itemtype="http://schema.org/Person">
-        <span itemprop="name">Akira Takahashi</span>
+        <span itemprop="name">Tetsuro Matsumura</span>
       </span>
       が更新
     </small></p>
@@ -356,7 +356,14 @@ <h2>効果</h2>
 <code>chars_format::general</code>が指定された場合は(2)(3)(4)(5)と同等。</p>
 </li>
 <li>
-<p>(10)(11)(12)(13) : <code>fmt</code>と<code>precision</code>によって指定されたフォーマット指定子と精度を用いて、Cロケールで<code>printf</code>によって行われたかのように浮動小数点数を文字列へ変換する。</p>
+<p>(10)(11)(12)(13) : <code>fmt</code>と<code>precision</code>によって指定されたフォーマット指定子と精度を用いて、Cロケールで<code>printf</code>によって行われたかのように浮動小数点数を文字列へ変換する。<br />
+    精度は、<code>chars_format::fixed</code>では小数点以下の正確な桁数、<code>chars_format::scientific</code>と<code>chars_format::hex</code>では最小の桁数を表す。<br />
+<code>chars_format::general</code>が指定された場合は次のようになる。</p>
+<ul>
+<li>指数表記したときの指数を<code>X</code>、<code>precision</code>と1の大きいほうを<code>P</code>とする。</li>
+<li><code>P &gt; X ≥ −4</code> のとき、精度 <code>P - 1 - X</code> で固定小数形式を使用する。</li>
+<li>それ以外の場合は、精度 <code>P - 1</code> で指数形式を使用する。</li>
+</ul>
 </li>
 </ul>
 <p>出力文字列が最も短くなるようにとは、小数点の前に少なくとも1桁あり、対応する<code><a href="from_chars.html">from_chars</a></code>関数によって値を正確に復元できるような最小の文字数、になることである。<br />
@@ -620,6 +627,7 @@ <h2>参照</h2>
 <li>C++23で<a class="cpprefjp-defined-word" data-desc="&lt;stdfloat&gt;で定義される内部表現の規定された浮動小数点数型" href="../stdfloat.html">拡張浮動小数点数型</a>に対応した</li>
 </ul>
 </li>
+<li><a href="https://ja.cppreference.com/w/c/io/fprintf" target="_blank">C言語リファレンス - fprintf</a></li>
 </ul></div>
 
       </div>

reference/format/format.html

@@ -188,12 +188,12 @@
 
     <p class="text-right"><small>
       最終更新日時(UTC):
-      <span itemprop="datePublished" content="2024-06-11T13:45:38">
-        2024年06月11日 13時45分38秒
+      <span itemprop="datePublished" content="2024-06-30T10:51:45">
+        2024年06月30日 10時51分45秒
       </span>
       <br/>
       <span itemprop="author" itemscope itemtype="http://schema.org/Person">
-        <span itemprop="name">Akira Takahashi</span>
+        <span itemprop="name">Tetsuro Matsumura</span>
       </span>
       が更新
     </small></p>
@@ -259,7 +259,7 @@ <h3>書式文字列</h3>
 </p>
 <h3><a href="#std-format-options" id="std-format-options">標準のオプション書式</a></h3>
 <p>組み込みの型に対して使える標準のオプション書式は次の通り(<code>[]</code>は省略可の意味)。
-基本的に<code>printf</code>の書式を踏襲しているが、あくまでもオプションであり、省略しても<code>&lt;iostream&gt;</code>と同じようにデフォルトの書式が使われる。</p>
+基本的に<code>printf</code>の書式を踏襲しているが、オプションをすべて省略しても(<code>{}</code>だけでも)デフォルトの書式が使われる。</p>
 <p><pre><code>[[fill] align] [sign] ['#'] ['0'] [width] ['.' precision] ['L'] [type]
 </code></pre></p>
 <ul>
@@ -430,6 +430,8 @@ <h4>浮動小数点数型の場合</h4>
 </table>
 <p>デフォルトは <code>g</code>。</p>
 <p>大文字のオプションを指定すると数値中のアルファベットが大文字になる。</p>
+<p>「値に応じて」の詳細や、精度の意味については<code><a href="../charconv/to_chars.html">to_chars</a></code>を参照。</p>
+<p>代替表現を指定すると、小数点以下が何もなくても小数点記号を出力する。<code>g</code>/<code>G</code>の場合は、代替表現を指定しないかぎり末尾の0およびそれによって不要になる小数点を出力しない。</p>
 <h4>ポインタの場合</h4>
 <table border="1" bordercolor="#888" style="border-collapse:collapse">
 <thead>
@@ -475,7 +477,6 @@ <h4>アライメントの詳細</h4>
 <span class="n">std</span><span class="o">::</span><span class="n">format</span><span class="p">(</span><span class="s">"{:あ&gt;6}"</span><span class="p">,</span> <span class="sc">'x'</span><span class="p">);</span> <span class="c1">// "あああああx"</span>
 </code></pre></div>
 </p>
-<h5>0埋めとの関係</h5>
 <p>アライメント方向が指定されていると、0埋めは無効となる。</p>
 <p><div class="codehilite"><pre><span></span><code><span class="c1">// 0埋めは符号を考慮する</span>
 <span class="n">std</span><span class="o">::</span><span class="n">format</span><span class="p">(</span><span class="s">"{:05}"</span><span class="p">,</span> <span class="mi">42</span><span class="p">);</span>    <span class="c1">// "00042"</span>
@@ -492,6 +493,10 @@ <h5>0埋めとの関係</h5>
 </code></pre></div>
 </p>
 <h4><a href="#range-format-options" id="range-format-options">Range・シーケンスコンテナの書式 (C++23)</a></h4>
+<p>Range・シーケンスコンテナのフォーマットでは、要素の間に区切り文字を挿入して、全体を囲み文字で囲んで出力する。各要素は再帰的にフォーマットされる。</p>
+<p><div class="codehilite"><pre><span></span><code><span class="n">std</span><span class="o">::</span><span class="n">format</span><span class="p">(</span><span class="s">"{}"</span><span class="p">,</span> <span class="n"><a href="../vector/vector.html">std::vector</a></span><span class="o">&lt;</span><span class="kt">int</span><span class="o">&gt;</span><span class="p">{</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">3</span><span class="p">});</span> <span class="c1">// "[1, 2, 3]"</span>
+</code></pre></div>
+</p>
 <p>Range・シーケンスコンテナに対して使用できる標準のオプション書式は次の通り(<code>[]</code>は省略可の意味)。</p>
 <p><pre><code>[[fill] align] [width] [n] [<a href="../ranges/range.html">range</a>-type] [: <a href="../ranges/range.html">range</a>-underlying-spec]
 </code></pre></p>
@@ -539,6 +544,12 @@ <h4><a href="#range-format-options" id="range-format-options">Range・シーケ
 <td>要素型が文字型であること。エスケープした文字列として書式化する</td>
 <td>C++23</td>
 </tr>
+<tr>
+<td>(なし)</td>
+<td>デフォルト</td>
+<td>囲み文字を<code>[ ]</code>、区切り文字を<code>,</code>として書式化する</td>
+<td>C++23</td>
+</tr>
 </tbody>
 </table>
 <ul>
@@ -551,13 +562,18 @@ <h4><a href="#range-format-options" id="range-format-options">Range・シーケ
 </li>
 <li>コンテナアダプタである<code><a href="../queue/queue.html">std::queue</a></code>、<code><a href="../queue/priority_queue.html">std::priority_queue</a></code>、<code><a href="../stack/stack.html">std::stack</a></code>も使用できる</li>
 <li><code><a href="../string/basic_string.html">std::basic_string</a></code>と<code><a href="../string_view/basic_string_view.html">std::basic_string_view</a></code>はRangeでもあるが、特殊化の優先順位によって標準のフォーマッターが選択されるため、Rangeとしてフォーマットすることはできない</li>
+<li>デフォルト書式に対応する<code>type</code>がないため、明示的に指定することはできない</li>
 </ul>
 <h4><a href="#assoc-format-options" id="assoc-format-options">連想コンテナの書式 (C++23)</a></h4>
 <p>Range・シーケンスコンテナと同じだが、デフォルトで囲み文字を<code>{ }</code>とする。</p>
 <ul>
 <li>メンバ型<code>key_type</code>を持つ場合、連想コンテナとみなされる</li>
 <li>さらに、メンバ型<code>mapped_type</code>を持ち、要素が<code><a href="../utility/pair.html">std::pair</a></code>またはサイズ2の<code><a href="../tuple/tuple.html">std::tuple</a></code>の場合、<code>map</code>互換のコンテナとみなされる。このとき、要素にも<code>m</code>書式を用いる</li>
 </ul>
+<p><div class="codehilite"><pre><span></span><code><span class="n"><a href="../map/map.html">std::map</a></span><span class="o">&lt;</span><span class="kt">int</span><span class="p">,</span> <span class="n"><a href="../string/basic_string.html">std::string</a></span><span class="o">&gt;</span> <span class="n">m</span> <span class="p">{{</span><span class="mi">1</span><span class="p">,</span> <span class="s">"aaa"</span><span class="p">},</span> <span class="p">{</span><span class="mi">2</span><span class="p">,</span> <span class="s">"bbb"</span><span class="p">}};</span>
+<span class="n">std</span><span class="o">::</span><span class="n">format</span><span class="p">(</span><span class="s">"{}"</span><span class="p">,</span> <span class="n">m</span><span class="p">);</span> <span class="c1">// {1: "aaa", 2: "bbb"}</span>
+</code></pre></div>
+</p>
 <h4><a id="tuple-format-options" name="#tuple-format-options">pair、tupleの書式 (C++23)</a></h4>
 <p><code><a href="../utility/pair.html">std::pair</a></code>と<code><a href="../tuple/tuple.html">std::tuple</a></code>に対して使用できる標準のオプション書式は次の通り(<code>[]</code>は省略可の意味)。</p>
 <p><pre><code>[[fill] align] [width] [tuple-type]
@@ -610,6 +626,7 @@ <h4><a id="tuple-format-options" name="#tuple-format-options">pair、tupleの書
 <ul>
 <li>要素型ごとに個別に書式を指定することはできない</li>
 <li>デバッグ出力可能な要素型の場合、デバッグ出力は常に有効</li>
+<li>デフォルト書式に対応する<code>type</code>がないため、明示的に指定することはできない</li>
 </ul>
 <h3>書式例</h3>
 <p><div class="codehilite"><pre><span></span><code><span class="kt">char</span> <span class="n">c</span> <span class="o">=</span> <span class="mi">120</span><span class="p">;</span>
@@ -671,12 +688,11 @@ <h2>備考</h2>
 <ul>
 <li>マルチバイト文字列、ワイド文字列の区別は、可変長引数部分で受け取れる文字列の型にも適用される。<ul>
 <li>例えば、フォーマット文字列がマルチバイトの場合、引数にワイド文字列を渡すことは標準ではできない。</li>
-<li><a class="cpprefjp-defined-word" data-desc="プログラム定義。ユーザー（プログラマ）によって定義されること（標準ライブラリで定義されるものを除く）">ユーザー定義</a>フォーマッターで拡張することは可能。</li>
+<li><a class="cpprefjp-defined-word" data-desc="プログラム定義。ユーザー（プログラマ）によって定義されること（標準ライブラリで定義されるものを除く）">ユーザー定義</a>フォーマッターで拡張することは可能。ただし、<a class="cpprefjp-defined-word" data-desc="プログラム定義。ユーザー（プログラマ）によって定義されること（標準ライブラリで定義されるものを除く）">ユーザー定義</a>の名前に依存しない特殊化は<code>std</code>名前空間に追加できない。</li>
 </ul>
 </li>
-<li><code><a href="../charconv/to_chars.html">to_chars</a></code>はワイド文字列に対応していない。<ul>
-<li>ワイド文字列版のときはマルチバイト文字列から変換すると考えられる。</li>
-<li>あるいは、<code>to_wchars</code>のようなものを作り、それを使うことも考えられる。</li>
+<li><code>format</code>の結果は一部<code><a href="../charconv/to_chars.html">to_chars</a></code>によって定義されているが、<code><a href="../charconv/to_chars.html">to_chars</a></code>自体はワイド文字列に対応していない。<ul>
+<li>もし何らかの手段でマルチバイト文字列に変換すれば、<code><a href="../charconv/to_chars.html">to_chars</a></code>に一致する、と解釈できる。</li>
 </ul>
 </li>
 </ul>