型

[C#] ushort型(符号なしshort)の使い方をわかりやすく解説

2025-04-15更新日: 2025-04-15

ushort型は、C#における符号なし16ビット整数型で、0から65,535までの範囲の整数を扱います。

符号がないため、負の値は扱えません。

メモリ効率を重視し、負の数が不要な場合に使用されます。

宣言はushortキーワードを使い、例えばushort num = 500;のように記述します。

範囲外の値を代入しようとするとコンパイルエラーが発生します。

目次から探す

ushort型とは

C#におけるushort型は、符号なし16ビット整数を表すデータ型です。

これは、0から65,535までの範囲の整数を扱うことができるため、特に小さな数値を扱う際にメモリの効率を高めることができます。

ushort型は、通常のint型やshort型と比較して、より少ないメモリを消費するため、パフォーマンスの向上が期待できます。

ushort型は、数値の範囲が限られているため、特定の用途において非常に便利です。

例えば、ゲーム開発やネットワークプログラミングにおいて、ポート番号やIDなどの小さな数値を扱う際に使用されることが多いです。

また、ushort型は、他の数値型との演算も可能ですが、演算結果が範囲外になる場合には注意が必要です。

ushort型の使い方

ushort型の宣言と初期化

ushort型の変数を宣言するには、ushortキーワードを使用します。

初期化も同時に行うことができます。

以下はその例です。

using System;
class Program
{
    static void Main()
    {
        // ushort型の変数を宣言し、初期化
        ushort myNumber = 5000; 
        Console.WriteLine(myNumber); // 5000
    }
}

ushort型の代入と演算

ushort型の変数には、他のushort型の値を代入することができます。

また、基本的な演算(加算、減算、乗算、除算)も可能です。

以下の例では、加算と減算を行っています。

using System;
class Program
{
    static void Main()
    {
        ushort a = 30000;
        ushort b = 20000;
        
        // 加算
        ushort sum = (ushort)(a + b); // キャストが必要
        Console.WriteLine(sum); // 46500
        
        // 減算
        ushort difference = (ushort)(a - b); // キャストが必要
        Console.WriteLine(difference); // 10000
    }
}

46500
10000

ushort型のキャスト

ushort型の値を他の数値型にキャストすることができます。

特に、int型やshort型に変換する際には、明示的なキャストが必要です。

以下の例を参照してください。

using System;
class Program
{
    static void Main()
    {
        ushort myUShort = 60000;
        
        // ushort型からint型へのキャスト
        int myInt = myUShort; // 明示的なキャストは不要
        Console.WriteLine(myInt); // 60000
        
        // ushort型からbyte型へのキャスト
        byte myByte = (byte)myUShort; // 明示的なキャストが必要
        Console.WriteLine(myByte); // 224 (オーバーフロー)
    }
}

60000
224

ushort型の配列の使い方

ushort型の配列を使用することで、複数のushort型の値を一度に管理することができます。

以下の例では、ushort型の配列を宣言し、初期化しています。

using System;
class Program
{
    static void Main()
    {
        // ushort型の配列を宣言し、初期化
        ushort[] myArray = new ushort[] { 1, 2, 3, 4, 5 };
        
        // 配列の要素を出力
        foreach (ushort number in myArray)
        {
            Console.WriteLine(number); // 1, 2, 3, 4, 5
        }
    }
}

ushort型の使用例

ushort型を使ったループ処理

ushort型は、ループ処理においても便利に使用できます。

特に、カウンタが小さな数値の範囲に収まる場合に適しています。

以下の例では、ushort型の変数を使ってループを実行しています。

using System;
class Program
{
    static void Main()
    {
        // ushort型のカウンタを使用したループ
        for (ushort i = 0; i < 10; i++)
        {
            Console.WriteLine(i); // 0から9まで出力
        }
    }
}

ushort型を使ったビット演算

ushort型はビット演算にも使用できます。

特に、フラグ管理やマスク処理に便利です。

以下の例では、ビットAND演算とビットOR演算を行っています。

using System;
class Program
{
    static void Main()
    {
        ushort a = 0b_0000_1111; // 15
        ushort b = 0b_1010_1010; // 170
        
        // ビットAND演算
        ushort andResult = (ushort)(a & b);
        Console.WriteLine(andResult); // 10
        
        // ビットOR演算
        ushort orResult = (ushort)(a | b);
        Console.WriteLine(orResult); // 175
    }
}

10
175

ushort型を使ったデータのバイト操作

ushort型は、バイナリデータの操作にも適しています。

以下の例では、ushort型の値をバイト配列に変換し、再度ushort型に戻す操作を行っています。

using System;
class Program
{
    static void Main()
    {
        ushort originalValue = 30000;
        
        // ushort型をバイト配列に変換
        byte[] byteArray = BitConverter.GetBytes(originalValue);
        
        // バイト配列からushort型に戻す
        ushort convertedValue = BitConverter.ToUInt16(byteArray, 0);
        
        Console.WriteLine(convertedValue); // 30000
    }
}

ushort型を使った数値の範囲チェック

ushort型の特性を活かして、数値の範囲チェックを行うことができます。

以下の例では、入力値がushort型の範囲内かどうかを確認しています。

using System;
class Program
{
    static void Main()
    {
        ushort maxValue = ushort.MaxValue; // 65535
        ushort inputValue = 70000; // 範囲外の値
        
        // 範囲チェック
        if (inputValue > maxValue)
        {
            Console.WriteLine("入力値はushort型の範囲を超えています。");
        }
        else
        {
            Console.WriteLine("入力値は有効です。");
        }
    }
}

入力値はushort型の範囲を超えています。

ushort型の注意点

範囲外の値を代入した場合のエラー

ushort型は0から65,535までの範囲の整数を扱います。

この範囲外の値を代入しようとすると、コンパイルエラーが発生します。

以下の例では、範囲外の値を代入しようとした場合のエラーを示しています。

using System;
class Program
{
    static void Main()
    {
        // 範囲外の値を代入しようとするとエラー
        ushort myValue = 70000; // コンパイルエラー
        Console.WriteLine(myValue);
    }
}

エラー: 'myValue' に代入する値が 'ushort' 型の範囲を超えています。

他の型との演算時の注意点

ushort型は他の数値型と演算することができますが、演算結果がushort型の範囲を超える場合、注意が必要です。

特に、ushort型とint型を混在させると、結果がint型として扱われるため、キャストが必要です。

以下の例を参照してください。

using System;
class Program
{
    static void Main()
    {
        ushort a = 60000;
        ushort b = 10000;
        
        // 演算結果はint型になる
        int result = a + b; // キャストが必要
        Console.WriteLine(result); // 70000
    }
}

オーバーフローとアンダーフローの対策

ushort型の演算では、オーバーフローやアンダーフローが発生する可能性があります。

例えば、最大値を超える加算や、最小値を下回る減算を行うと、意図しない結果になることがあります。

これを防ぐためには、演算前に値をチェックすることが重要です。

using System;
class Program
{
    static void Main()
    {
        ushort a = ushort.MaxValue; // 65535
        ushort b = 1;
        
        // オーバーフローのチェック
        if (a + b < a) // オーバーフローが発生する場合
        {
            Console.WriteLine("オーバーフローが発生しました。");
        }
        else
        {
            ushort result = (ushort)(a + b);
            Console.WriteLine(result);
        }
    }
}

オーバーフローが発生しました。

checked/uncheckedキーワードの使用

C#では、checkedおよびuncheckedキーワードを使用して、オーバーフローの動作を制御できます。

checkedブロック内では、オーバーフローが発生すると例外がスローされ、uncheckedブロック内ではオーバーフローが無視されます。

以下の例を参照してください。

using System;
class Program
{
    static void Main()
    {
        ushort a = ushort.MaxValue; // 65535
        ushort b = 1;
        
        // checkedブロックでオーバーフローを検出
        try
        {
            ushort result = checked((ushort)(a + b)); // 例外がスローされる
            Console.WriteLine(result);
        }
        catch (OverflowException)
        {
            Console.WriteLine("オーバーフローが発生しました。");
        }
        
        // uncheckedブロックでオーバーフローを無視
        ushort uncheckedResult = unchecked((ushort)(a + b)); // オーバーフローが無視される
        Console.WriteLine(uncheckedResult); // 0
    }
}

オーバーフローが発生しました。
0

ushort型の応用例

ushort型を使ったバイナリデータの処理

ushort型は、バイナリデータの処理において非常に便利です。

特に、ファイルやネットワークから受信したデータを扱う際に、ushort型を使用することで、メモリの効率を高めることができます。

以下の例では、ushort型を使ってバイナリデータを読み込む方法を示しています。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        // バイナリファイルからushort型のデータを読み込む
        using (BinaryReader reader = new BinaryReader(File.Open("data.bin", FileMode.Open)))
        {
            ushort value = reader.ReadUInt16(); // ushort型のデータを読み込む
            Console.WriteLine(value); // 読み込んだ値を出力
        }
    }
}

(ファイルに保存されたushort型の値)

ushort型を使ったネットワーク通信のポート番号管理

ネットワーク通信において、ポート番号はushort型で表現されることが一般的です。

ポート番号は0から65,535までの範囲であるため、ushort型が適しています。

以下の例では、ポート番号をushort型で管理しています。

using System;
using System.Net;
using System.Net.Sockets;
class Program
{
    static void Main()
    {
        ushort portNumber = 8080; // 使用するポート番号
        
        // TCPクライアントを作成
        TcpClient client = new TcpClient("localhost", portNumber);
        Console.WriteLine($"ポート {portNumber} に接続しました。");
        
        // 接続を閉じる
        client.Close();
    }
}

ポート 8080 に接続しました。

ushort型を使ったゲーム開発でのID管理

ゲーム開発において、オブジェクトやエンティティのIDを管理する際にushort型を使用することができます。

これにより、メモリの使用量を抑えつつ、多くのオブジェクトを管理することが可能です。

以下の例では、ushort型を使ってエンティティのIDを管理しています。

using System;
class Program
{
    static void Main()
    {
        // エンティティのIDを管理する
        ushort entityId = 1; // 最初のエンティティID
        
        // エンティティの生成
        Console.WriteLine($"エンティティ {entityId} が生成されました。");
        
        // IDをインクリメント
        entityId++;
        Console.WriteLine($"次のエンティティ {entityId} が生成されました。");
    }
}

エンティティ 1 が生成されました。
次のエンティティ 2 が生成されました。

ushort型を使ったメモリ効率の最適化

ushort型を使用することで、メモリの効率を最適化することができます。

特に、大量の数値データを扱う場合、ushort型を選択することで、メモリの使用量を削減できます。

以下の例では、ushort型の配列を使用して、メモリ効率を向上させています。

using System;
class Program
{
    static void Main()
    {
        // ushort型の配列を作成
        ushort[] numbers = new ushort[1000]; // 1000個のushort型の配列
        
        // 配列に値を代入
        for (ushort i = 0; i < numbers.Length; i++)
        {
            numbers[i] = i; // 0から999までの値を代入
        }
        
        // 配列の最初の5つの値を出力
        for (int i = 0; i < 5; i++)
        {
            Console.WriteLine(numbers[i]); // 0, 1, 2, 3, 4
        }
    }
}