C#のUInt16.MinValueフィールドとは？コード例でわかりやすく解説

C#におけるUInt16.MinValueフィールドは、16ビット符号なし整数（ushort型）が取り得る最小値を表す定数です。ushort型は0〜65,535の範囲の値を扱うため、MinValueは常に「0」となります。

このフィールドは、値がushort型の有効範囲内に収まっているかどうかを判定する際などに活用できます。

構文

UInt16.MinValueフィールドの構文は以下のとおりです。

public const ushort MinValue = 0;

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

まずは、UInt16.MinValueフィールドの基本的な実装例を見てみましょう。

using System;
public class Demo {
   public static void Main(){
      ushort val1 = 23;
      ushort val2 = 0;
      Console.WriteLine("Value1 = "+val1);
      Console.WriteLine("Value2 = "+val2);
      Console.WriteLine("HashCode for value1 = "+val1.GetHashCode());
      Console.WriteLine("HashCode for value2 = "+val2.GetHashCode());
      Console.WriteLine("Are they equal? = "+(val1.Equals(val2)));
      TypeCode type1 = val1.GetTypeCode();
      TypeCode type2 = val2.GetTypeCode();
      Console.WriteLine("TypeCode for val1 = "+type1);
      Console.WriteLine("TypeCode for val2 = "+type2);
      Console.WriteLine("Minimum Value = "+ UInt16.MinValue);
   }
}

出力結果

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

Value1 = 23
Value2 = 0
HashCode for value1 = 23
HashCode for value2 = 0
Are they equal? = False
TypeCode for val1 = UInt16
TypeCode for val2 = UInt16
Minimum Value = 0

このように、UInt16.MinValueを出力すると「0」が表示され、これがushort型の下限値であることが確認できます。

使用例2：範囲チェックへの応用

続いて、UInt16.MinValueとUInt16.MaxValueを組み合わせて、値がushort型の範囲内かどうかを判定する実践的な例を紹介します。

using System;
public class Demo {
   public static void Main(){
      ulong[]val = {8998, 899898778, 878787878};
      ushort res;
      foreach(ulong a in val){
         if(a >= UInt16.MinValue && a <= UInt16.MaxValue){
            res = Convert.ToUInt16(a);
            Console.WriteLine("Converted: "+res);
         } else {
            Console.WriteLine("Not Possible");
         }
      }
   }
}

出力結果

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

Converted: 8998
Not Possible
Not Possible

最初の値「8998」はushort型の範囲（0〜65,535）内にあるため変換に成功しましたが、残りの2つの値は範囲を超えているため、「Not Possible」と表示されます。

まとめ

UInt16.MinValueフィールドは、ushort型の最小値である「0」を表す定数です。単純な値の確認だけでなく、Convert.ToUInt16などによる型変換前の範囲チェックにも役立つため、安全な数値処理を実装する際にぜひ活用してください。