6

String.Formatメソッドの書式指定には方法がたくさんあり、いつもmsdnなどのサイトを確認しています。
下記の"{0}"が書式指定にあたりますが、

String.Format("{0}", message);

理解するための覚え方、チートシートなどを教えてください。

2 件の回答 2

10

.NETのString.Format()とC言語のprintf()と対比して説明します。

  • String.Format()の書式
    • {index[,alignment][:formatString]}
  • printf()の書式
    • %[flags][width][.precision]type

alignmentformatStringflagswidthprecisionはそれぞれ省略可能です。

String.Format()のformatStringとprintf()のtypeのうち dxXeEfFは同じ挙動をします。
String.Format()のalignmentとprintf()のwidthは同じ意味合いを持ちます。
数値に限定すればString.Format()のformatStringには数値を後続させることができ、printf()のprecisionと同じです。
そのため

Console.Write("{0,10:d5}\n", 1234);
printf("%10.5d\n", 1234);

は同じ結果を得られます。


String.Format()は引数にIFormatProviderを受け取るオーバーロードが用意されています。受け取らないオーバーロードの場合は現在のスレッドのカルチャを使用します。いずれにしても指定されたカルチャに応じた出力が得られます。
例えば

Thread.CurrentThread.CurrentCulture = new CultureInfo("ja-JP");
Console.WriteLine("{0:N}", 1234.5678);
Thread.CurrentThread.CurrentCulture = new CultureInfo("de-DE");
Console.WriteLine("{0:N}", 1234.5678);

は、小数点や桁区切りが影響を受け

1,234.57
1.234,57

となります。


以上は数値に限定して説明しましたが、その他に列挙型(enum)、DateTime型、TimeSpan型(.NET 4以降)にも対応しています。
またformatStringはアルファベット1文字で表現される標準の書式の他に複数文字で表現するカスタム書式も用意されています。もちろんこれらもカルチャに応じた結果が得られます。
例えばDateTime型のカスタム書式を用いて

Console.WriteLine("{0:yyyy/MM/dd}", DateTime.Now);

といったこともできます。(得られる文字列に使われる日付区切り記号は/とは限りません。)詳細はMSDNドキュメントを参照してください。

3

自己解答します。
string.Format の書式指定は、複合書式指定と呼ばれています。
MSDNでの解説がありますが、網羅的に書かれているため簡単に理解するためには向いていないと思うので、簡単にまとめます。

{インデックス[,アライメント][:フォーマット]}
という形式になっています。([]内は省略可能です)
要点と覚え方としては、以下のものが挙げられます。

  • インデックスは0始まり=通常の配列と同じ
  • カンマ,は桁数を表す=桁区切りの記号と同じ(1,000など)
  • コロン:はフォーマット=内容を表す記号と同じ(X:fooなど)
  • 型によってフォーマットの書き方が変わる

フォーマットに指定するのは、数値型や日付型などで変わりますが、よく使われる数値型のみ覚えておけばいいと思います。

  • D 単純な数値(1000など)
  • N 桁区切り付きの数値(1,000など)
  • X 16進(FF00など)
  • F 小数点数(3.14など)

チートシートは英語のものがたくさん見つかりましたが、日本語のものは見つけられませんでした。

よくまとめられていたサイトを挙げます。
http://blog.stevex.net/string-formatting-in-csharp/

3
  • 1
    質問はFAQ的でよいものですが、求められている回答が(機能を網羅的でなく)**自分の使う機能範囲に限定する**というのであれば、それはSOが避けるべきとしている主観的な回答を求めていることになりませんか?
    – sayuri
    Commented 2015年8月27日 21:11
  • なるほど。私が困った(そして解決した)のは、MSDNを見ずに自分の頭のなかだけでString.Formatを使う方法です。覚え方のほうです。網羅的であるならMSDNやチートシートを見ればいいかなと思いました。質問のタイトルが悪いですね。どう変更するべきでしょうか?
    – seo
    Commented 2015年8月28日 0:12
  • さらに考えた結果、今から質問のタイトルを変えるよりは、ベストアンサーは網羅的な解答を選んだほうがよい気がしましたのでベストアンサーを変更します
    – seo
    Commented 2015年8月29日 1:43

この質問に回答するには、ログインする必要があります。

求めていた回答ではありませんか? のタグが付いた他の質問を参照する。