C#のUInt32.ToString()メソッドとは？サンプルコード付きでわかりやすく解説

UInt32.ToString()メソッドとは

C#のUInt32.ToString()メソッドは、現在のUInt32インスタンスが保持している数値を、それと等価な文字列表現に変換するためのメソッドです。数値をコンソールに表示したり、他の文字列と連結して出力したりする場面でよく利用されます。

構文

UInt32.ToString()メソッドの構文は以下のとおりです。

public override string ToString();

引数を受け取らず、現在の数値を表す文字列を返すシンプルなメソッドです。

使用例1：基本的な使い方

まずは、基本的な使用例を見てみましょう。

using System;
public class Demo {
   public static void Main(){
      uint val1 = 100;
      uint val2 = 80;
      Console.WriteLine("Value1 (String representation) = "+val1.ToString());
      Console.WriteLine("Value2 (String representation) = "+val2.ToString());
      bool res = val1.Equals(val2);
      Console.WriteLine("Return value (comparison) = "+res);
      if (res)
         Console.WriteLine("val1 = val2");
      else
         Console.WriteLine("val1 != val2");
   }
}

実行結果

上記のコードを実行すると、次のような出力が得られます。

Value1 (String representation) = 100
Value2 (String representation) = 80
Return value (comparison) = False
val1 != val2

この例では、ToString()メソッドによって数値100と80がそれぞれ文字列「100」「80」に変換され、コンソールに出力されていることがわかります。また、Equals()メソッドによる比較の結果も合わせて表示しています。

使用例2：0と最大値の場合

続いて、UInt32型の最小値である0と、最大値であるUInt32.MaxValueを用いた例です。

using System;
public class Demo {
   public static void Main(){
      uint val1 = 0;
      uint val2 = UInt32.MaxValue;
      Console.WriteLine("Value1 (String representation) = "+val1.ToString());
      Console.WriteLine("Value2 (String representation) = "+val2.ToString());
      bool res = val1.Equals(val2);
      Console.WriteLine("Return value (comparison) = "+res);
      if (res)
         Console.WriteLine("val1 = val2");
      else
         Console.WriteLine("val1 != val2");
   }
}

実行結果

このコードを実行すると、以下の出力が得られます。

Value1 (String representation) = 0
Value2 (String representation) = 4294967295
Return value (comparison) = False
val1 != val2

UInt32.MaxValueは符号なし32ビット整数で表現できる最大値「4294967295」（2³² − 1）です。このように境界値に対しても、ToString()メソッドは正しく文字列へ変換できることが確認できます。

まとめ

UInt32.ToString()メソッドを使えば、uint型の数値を簡単に文字列へ変換できます。書式指定が必要ない場合に最も手軽な変換方法であり、デバッグ時の出力やログ生成などでも頻繁に活用される基本メソッドです。書式を指定したい場合は、ToString(string format)などのオーバーロードも用意されているので、用途に応じて使い分けるとよいでしょう。