アライメントの詳細を記載

Author: tetsurom

reference/format/format.md

@@ -126,8 +126,7 @@ string s3 = format("{} {1}",  "a", "b"); // コンパイルエラー
 
 イテレータ範囲`[first, last)`を[`to_chars`](/reference/charconv/to_chars.md)の結果を格納するのに十分な範囲、`value`をフォーマットする値、`charT`を`char`または`wchar_t`とする。
 
-* 以下の表の通りに[`to_chars`](/reference/charconv/to_chars.md)を呼び出したあと、その結果を出力へコピーするかのような振る舞いをする。ただし、実際に[`to_chars`](/reference/charconv/to_chars.md)を呼び出すかどうかは規定されていない。
-* 実際には、出力へコピーする際にパディングなども行われる。
+* ロケールを考慮しない場合、数値を文字列化する部分は以下の表の通りに[`to_chars`](/reference/charconv/to_chars.md)を呼び出した結果と等しくなる。
 
 | type   | 意味                       | 効果                                                                      | 対応バージョン |
 |:-------|:---------------------------|:--------------------------------------------------------------------------|----------------|
@@ -164,6 +163,51 @@ string s3 = format("{} {1}",  "a", "b"); // コンパイルエラー
 
 ポインタは`void*`のみサポートする。それ以外のポインタは、`void*`にキャストしなければ出力できない。
 
+#### アライメントの詳細
+
+指定した幅が必要な幅より小さい場合や、幅を省略している場合はアライメントは無効となる。
+
+アライメントにおいて、一部の文字は大きな幅を持っているとみなされる。
+
+UTF-8・UTF-16・UTF-32の文字のシーケンスの場合、その幅はUnicode標準 UAX #29 で定める拡張書記素クラスタの幅の合計となる。
+
+以下の文字は2文字分の幅を持つ。
+
+- UAX #44 の規定に従って、`East_Asian_Width` が `W` (Wide)または `F` (Fullwidth)であるコードポイント
+- `U+4DC0` - `U+4DFF` (Yijing Hexagram Symbols)
+- `U+1F300` - `U+1F5FF` (Miscellaneous Symbols and Pictographs)
+- `U+1F900` - `U+1F9FF` (Supplemental Symbols and Pictographs)
+
+それ以外のコードポイントの幅は1である。
+
+UTF-8・UTF-16・UTF-32以外の文字のシーケンスの幅は未規定。
+
+アライメントに使用する文字は、常に幅1として扱われる。
+
+```cpp
+std::format("{:*>6}", "あ"); // "****あ"
+std::format("{:あ>6}", 'x'); // "あああああx"
+```
+
+##### 0埋めとの関係
+
+アライメント方向が指定されていると、0埋めは無効となる。
+
+```cpp
+// 0埋めは符号を考慮する
+std::format("{:05}", 42);    // "00042"
+std::format("{:+05}", 42);   // "+0042"
+std::format("{: 05}", 42);   // " 0042"
+
+// アライメントは符号を考慮しない
+std::format("{:0>5}", 42);   // "00042"
+std::format("{:0>+5}", 42);  // "00+42"
+std::format("{:0> 5}", 42);  // "00 42"
+
+// 0埋めも指定しているが、アライメント方向が指定されているのでアライメントが優先される
+std::format("{:0>05}", -42);  // "00-42"
+```
+
 #### <a id="range-format-options" href="#range-format-options">Range・シーケンスコンテナの書式 (C++23)</a>
 
 Range・シーケンスコンテナに対して使用できる標準のオプション書式は次の通り(`[]`は省略可の意味)。