Go言語のintとuint：型の違いと使い分けの実践的な判断基準

Go言語において、数値データの取り扱いはプログラムの正確性とパフォーマンスに直結する重要な要素です。

特に整数型である int と uint の使い分けは、初学者から経験豊富なエンジニアまで、常に慎重な判断が求められるトピックとなります。

本記事では、Go言語の標準的な設計指針に基づき、これら2つの型の違いと実践的な選択基準について詳細に解説します。

適切な型を選択することで、バグの混入を防ぎ、メンテナンス性の高いコードを記述することが可能になります。

int型とuint型の根本的な違い

Go言語における int と uint の最大の違いは、負の値を保持できるかどうかという点にあります。

int は「signed integer」の略であり、正の数、負の数、およびゼロを表現することができます。

一方で uint は「unsigned integer」の略であり、0以上の正の整数のみを扱うための型です。

プラットフォーム依存のサイズ

int と uint は、実行されるコンピュータのアーキテクチャによってそのビット幅が変化するという特徴を持っています。

現代の主要な開発環境である64ビットシステムでは、これらは通常64ビット幅として扱われます。

しかし、32ビットシステムで実行される場合には、自動的に32ビット幅として処理されることになります。

この性質により、特定のビット数を固定したい場合には int64 や uint32 といった明示的な型を使用する必要があります。

表現できる数値の範囲

同じビット幅であっても、符号の有無によって表現できる数値の最大値と最小値が異なります。

int は符号ビットのために1ビットを使用するため、正の方向への最大値は uint の約半分になります。

具体的な範囲の違いを以下の表にまとめました。

原則としてint型を優先すべき理由

Go言語の公式な設計ガイドラインや標準ライブラリの多くでは、数値計算には原則として int 型を使用することが推奨されています。

たとえ対象となる数値が負になることが論理的にあり得ない場合でも、int を選択するのが一般的です。

配列やスライスのインデックスとの整合性

Go言語の組み込み関数である len() は、スライスの要素数を int 型で返します。

また、スライスの要素にアクセスするためのインデックスも int 型を期待しています。

もし独自の変数を uint で定義してしまうと、スライスの操作を行うたびに型変換が必要になり、コードの可読性が低下します。

package main

import "fmt"

func main() {
    items := []string{"apple", "banana", "cherry"}
    
    // len()の結果はint型
    count := len(items)
    
    for i := 0; i < count; i++ {
        fmt.Println(items[i])
    }
}

apple
banana
cherry

算術計算におけるアンダーフローの回避

uint 型を使用する際に最も警戒すべき点は、「0を下回る計算」が行われた時の挙動です。

uint 型で 0 - 1 を計算すると、エラーにはならず、その型が保持できる最大値にラップアラウンド（巡回）してしまいます。

これにより、意図しない巨大な数値が発生し、システム全体の論理崩壊を招くリスクがあります。

package main

import "fmt"

func main() {
    var a uint = 0
    var b uint = 1
    
    // 0 - 1 の結果が非常に大きな数になる
    result := a - b
    fmt.Println(result)
}

18446744073709551615

uint型を積極的に採用すべきケース

int 型が推奨される一方で、uint 型を使用することが「正しい設計」となる場面も存在します。

それらは主に、数値としての大きさよりも「ビットの並び」や「メモリ上の表現」が重要視される場合です。

ビット演算とマスキング

フラグ管理やバイナリデータの解析など、ビット単位の操作を行う場合には uint が適しています。

符号付き整数で右シフト演算を行うと、最上位ビット（符号ビット）の挙動が複雑になることがあります。

ビット演算を多用する低レイヤーの処理では、符号の影響を受けない uint を使用するのが安全です。

メモリレイアウトと外部APIとの互換性

ハードウェアのレジスタ操作や、ネットワークプロトコルのパケット構造を定義する場合、サイズが厳密に決まっている符号なし整数が必要になります。

例えば、IPv4アドレスの各オクテットは 0 から 255 の範囲であるため、uint8 で表現するのが自然です。

また、暗号化アルゴリズムの実装など、数学的に正の整数のみを扱うことが定義されているアルゴリズムでも uint が多用されます。

実務での使い分け判断基準

どちらの型を使うべきか迷った際は、以下の判断基準を参考にしてください。

1. 汎用的なカウントやインデックス

個数、回数、ループのカウンタなどは、すべて int を使用してください。

2. 負の数が発生する可能性が少しでもある計算

差分計算（A – B）が含まれるロジックでは、必ず int を選択してください。

3. ビットフラグやバイナリ操作

特定のビットを立てたり消したりする処理には、uint を使用してください。

4. 非常に大きな正の数値が必要な場合

int64 の最大値（約9京）を超えるが、uint64 の範囲内には収まるという極めて特殊なケースでは uint64 を検討します。

ただし、そのような巨大な数値を扱う場合は、math/big パッケージの利用も視野に入れるべきです。

型変換（キャスト）の注意点

Go言語は静的型付け言語であり、int と uint の間であっても暗黙的な型変換は行われません。

異なる型を混ぜて計算する場合は、必ず明示的なキャストが必要となります。

package main

func main() {
    var x int = 10
    var y uint = 20
    
    // _ = x + y はコンパイルエラーになる
    _ = x + int(y) // 明示的なキャストが必要
}

キャストを行う際は、変換後の型で元の数値を表現できるかどうかを常に確認しなければなりません。

特に大きな uint の値を int にキャストすると、数値が負に反転してしまう危険性があります。

まとめ

Go言語における int と uint の使い分けは、単純な「正負の有無」以上の意味を持っています。

多くのケースでは、標準的な挙動を保証し、予期せぬラップアラウンドを避けるために int 型を使用するのが最善の選択です。

一方で、ビット操作やメモリ効率が重要視される特殊な領域では、uint がその真価を発揮します。

各型の特性を深く理解し、プロジェクトの要件に合わせて適切に使い分けることが、堅牢なシステム開発への第一歩となります。

迷ったときは int を選び、必要に応じて math パッケージによる範囲チェックを導入することを検討してください。