導入: なぜint64型を意識する必要があるのか
Go言語で開発をしていると、単なる「int」ではなく「int64」を指定すべき場面によく遭遇します。特に外部APIとの通信やデータベース操作を行う際、型が合わないためにコンパイルエラーに悩まされた経験はないでしょうか。int64型を適切に使いこなすことは、データの整合性を守り、予期せぬオーバーフローを防ぐために非常に重要です。
基礎知識: int64とは何か
int64は、その名の通り「64ビットの符号付き整数」です。コンピュータのメモリ上で8バイト（64ビット）を消費します。
Go言語の通常のint型は、実行環境のアーキテクチャ（32bitまたは64bit）によってサイズが変動しますが、int64はプラットフォームに依存せず、常に64ビットのサイズを保証します。このため、外部システムやファイルフォーマットなど、データのサイズを厳密に定義する必要がある場合に重宝されます。
実装/解決策: int型との互換性に注意する
Go言語は型に対して非常に厳格な言語です。たとえ中身が同じ数値であっても、int型とint64型は「別の型」として扱われます。そのため、これらを混ぜて計算や代入を行うには、明示的な型変換（キャスト）が必要です。
サンプルプログラム
こちらのコードは、int型とint64型を相互に変換する基本的な手法を示したものです。
package main
import "fmt"
func main() {
// 通常のint型変数
var normalInt int = 100
// int64型への変換
// 型変換を行わないとコンパイルエラーになる
var largeInt int64 = int64(normalInt)
// 演算を行う例
var constant int64 = 500
result := largeInt + constant
fmt.Printf("結果: %d (型: %T)\n", result, result)
// int64からintへの変換
// 数値が大きすぎる場合にintに変換すると、値が欠損する可能性があるため注意が必要
smallInt := int(largeInt)
fmt.Printf("変換されたint: %d\n", smallInt)
}
応用・注意点: 現場で陥りやすい罠
現場で最も注意すべきは、型変換時のオーバーフローです。int64からintへ変換する際、変換先のint型が32bit環境であると、int64が保持していた巨大な数値を収めきれず、値が壊れてしまうことがあります。
また、データベースのID（主キー）などは、将来的なレコード数の増加を見越して最初からint64で定義するのが業界標準です。APIのレスポンス構造体を定義する際も、JSONデコード時に「型が一致しない」というエラーを防ぐため、最初からint64でフィールドを定義しておくことをお勧めします。
型変換を多用しすぎるとコードの可読性が落ちるため、基本的にはシステム全体で一貫した型（特にDBや外部連携と接する部分）を使う設計を心がけましょう。
コメント