JavaのString.formatを読む

JavaのString.formatはどうやって書式文字列をパースしているのか調べる

OpenJDKのソースがGitHubから見られるようなので、見てみる

https://github.com/openjdk/jdk

現在（2023/10/30）のmasterでは、String.formatの実装箇所はここ
https://github.com/openjdk/jdk/blob/4679e9aa00c098cff715fb4deeb4d736e1063571/src/java.base/share/classes/java/lang/String.java#L4406-L4408

実装の本体はjava.util.Formatterにあるようなので、そちらを見ていく

まずはコンストラクタ
https://github.com/openjdk/jdk/blob/4679e9aa00c098cff715fb4deeb4d736e1063571/src/java.base/share/classes/java/util/Formatter.java#L2105-L2107

StringBuilderはAppendableを実装しているようなので、実際に呼び出されているコンストラクタはこちら
https://github.com/openjdk/jdk/blob/4679e9aa00c098cff715fb4deeb4d736e1063571/src/java.base/share/classes/java/util/Formatter.java#L2081-L2085

次に、Formatter#formatが呼び出されている

https://github.com/openjdk/jdk/blob/4679e9aa00c098cff715fb4deeb4d736e1063571/src/java.base/share/classes/java/util/Formatter.java#L2727-L2729

ここで呼び出されているオーバーライドが本体っぽいので、この中を見ていく
https://github.com/openjdk/jdk/blob/4679e9aa00c098cff715fb4deeb4d736e1063571/src/java.base/share/classes/java/util/Formatter.java#L2766

https://github.com/openjdk/jdk/blob/4679e9aa00c098cff715fb4deeb4d736e1063571/src/java.base/share/classes/java/util/Formatter.java#L2767-L2775

ensureOpenはAppendableがnullなら例外を投げる検査用のメソッド

parseはフォーマット文字列をパースして引数をフォーマットするようなオブジェクトを返してくれていそうだ
以降の処理ではこのオブジェクト1つごとに引数を対応づけて、最終的な文字列を作り出していると思われる

さきにparseの中を見てみる

https://github.com/openjdk/jdk/blob/4679e9aa00c098cff715fb4deeb4d736e1063571/src/java.base/share/classes/java/util/Formatter.java#L2816-L2821

フォーマット文字列を1文字づつ見ていってFormatStringオブジェクトをListに追加していく処理のようだ

https://github.com/openjdk/jdk/blob/4679e9aa00c098cff715fb4deeb4d736e1063571/src/java.base/share/classes/java/util/Formatter.java#L2822-L2828

フォーマット文字列から'%'を探して、見つからなければ、ここが引数を取らない末尾の部分
文字列全体をFixedStringとしているようなので、FixedStringはフォーマットの引数を取らないFormatStringのインスタンス

https://github.com/openjdk/jdk/blob/4679e9aa00c098cff715fb4deeb4d736e1063571/src/java.base/share/classes/java/util/Formatter.java#L2829-L2833

今見ている文字列が'%'でなければ、'%'が見つかった前までの部分はフォーマットの引数を取らない文字列
以降は'%'の次の文字から見ていく

https://github.com/openjdk/jdk/blob/4679e9aa00c098cff715fb4deeb4d736e1063571/src/java.base/share/classes/java/util/Formatter.java#L2834-L2837

末尾が'%'だと、書式指定子が取れないので、UnknownFormatConversionExceptionを投げている