入出力

Go言語のprintf関数で16進数を出力する方法を解説

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

この記事では、Go言語でのprintf関数を使った16進数の出力方法を紹介します。

%xや%Xなどの書式指定子を例に、具体的なコードとともに簡単に解説します。

開発環境が整っている方に向け、手軽に実践できる内容となっています。

目次から探す

Go言語のprintf関数における16進数出力の基本
- 16進数書式指定子の種類
- 整数型の出力例
バイト列およびその他型の16進数出力
- バイト列の出力方法
- その他の型への対応
実践例による出力結果の検証
- コード例の実装手順
まとめ

Go言語のprintf関数における16進数出力の基本

Go言語では、fmt.Printf関数を活用して、様々な形式でデータを出力することができます。

その中でも、16進数形式での出力は、シンプルな数値表現やメモリのデバッグなどで役立ちます。

以下では、基本的な書式指定子と、整数型データを16進数として出力する例を紹介します。

16進数書式指定子の種類

Go言語のfmt.Printf関数では、16進数出力に対して主に次の書式指定子が用いられます。

%x：小文字表記の出力

%xを指定すると、16進数がアルファベット小文字(a～f)で出力されます。

これは、一般的な用途で多く使われる形式です。

例として、10進数の数値を小文字形式の16進数に変換する場合は、次のように記述します。

%X：大文字表記の出力

%Xを指定すると、16進数がアルファベット大文字(A～F)で出力されます。

データの見た目にこだわる場合や、特定のフォーマットが必要な場合に利用されます。

整数型の出力例

整数型のデータを16進数として出力する際の例を、実際のコードと共に解説します。

サンプルコードの解説

下記のサンプルコードは、整数numの値を16進数として小文字と大文字の両方で表示する例です。

変数名やコメントは英語と日本語を併用しており、コード全体が実行可能な形になっています。

package main
import (
	"fmt"
)
func main() {
	num := 255 // 数値を定義(10進数)
	// 小文字表記の16進数出力
	fmt.Printf("小文字形式: %x\n", num)
	// 大文字表記の16進数出力
	fmt.Printf("大文字形式: %X\n", num)
}

上記コード内では、%xと%Xの2種類の指定子を用いて数値を表示しています。

シンプルな数値変換の例として参考にしてください。

出力結果の確認

上記のサンプルコードを実行した場合、次のような出力が得られます。

小文字形式: ff
大文字形式: FF

この出力から、%xが小文字で、%Xが大文字で出力される仕組みが確認できます。

バイト列およびその他型の16進数出力

数値だけでなく、バイト列やその他のデータ型も16進数で扱うことができます。

ここでは、バイト列の出力方法と、その他の型への対応方法について解説します。

バイト列の出力方法

文字列は内部的にはバイトの集合として扱われるため、[]byteに変換して各バイト個別に16進数で出力することができます。

フォーマット変換の手法

以下のサンプルコードは、文字列からバイト列を生成し、各バイトを小文字の16進数で出力する例です。

コード内のコメントに従って、実際の出力がどのようになるか確認してください。

package main
import (
	"fmt"
)
func main() {
	byteSlice := []byte("GoLang") // "GoLang"という文字列をバイト列に変換
	// 各バイトを小文字の16進数で出力
	for _, b := range byteSlice {
		fmt.Printf("%x ", b)
	}
	fmt.Println() // 改行を追加
}

この手法では、forループを用いて各バイトを個別に変換し、連続した16進数表現として出力しています。

その他の型への対応

整数型以外の型でも、16進数表示が必要な場合があります。

ここでは、固定長出力と負の値の処理方法について説明します。

固定長出力の設定

固定長出力は、16進数が一定の桁数で表示されるように整形する場合に便利です。

書式指定子の中で桁数を指定することで、出力形式を統一できます。

package main
import (
	"fmt"
)
func main() {
	num := 15 // 出力する整数
	// %04xは最低4桁の16進数を出力する書式指定子
	fmt.Printf("固定長出力: %04x\n", num)
}

上記のコードでは、整数15が「000f」のように4桁で出力されます。

負の値の処理

負の値を16進数で表現する場合、まず符号付き整数を符号なし整数に型変換する必要があります。

以下の例では、-15を表現するためにuint型に変換して出力しています。

package main
import (
	"fmt"
)
func main() {
	num := -15 // 負の値
	// 負の値を直接%Xで出力すると意図しない結果になるため、uint型に変換
	fmt.Printf("負の値の出力: %X\n", uint(num))
	// ※注意：環境により、型変換の挙動に注意が必要
}

このように、負の値の場合は型変換を意識して出力する必要があります。

実践例による出力結果の検証

これまで学んだ内容を統合し、実践環境でコード例を実装・検証する手順について解説します。

実際にコードを動かして、各結果が期待通りに出力されるか確認してください。

コード例の実装手順

以下のコード例は、整数型、バイト列、固定長出力の3つのケースを含む統合サンプルです。

コード中のコメントも確認しながら、各出力がどの部分に対応しているか理解することが大切です。

package main
import (
	"fmt"
)
func main() {
	// 整数の16進数出力
	number := 1234
	// %xを利用した整数の小文字形式出力
	fmt.Printf("整数の16進数(%x): %x\n", number, number)
	// バイト列の16進数出力
	byteSlice := []byte("Test")
	fmt.Print("バイト列の16進数出力: ")
	for _, bt := range byteSlice {
		fmt.Printf("%x ", bt)
	}
	fmt.Println()
	// 固定長出力例
	// %04X：4桁の大文字形式で出力
	fmt.Printf("固定長の出力例(%04X): %04X\n", number, number)
}

実行環境での出力確認

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

整数の16進数(%x): 4d2
バイト列の16進数出力: 54 65 73 74
固定長の出力例(%04X): 04D2

この結果により、それぞれの出力形式が正しく機能していることが確認できるでしょう。

デバッグ時の留意点

デバッグ時には、以下の点に注意してください。

書式指定子が意図した形式(小文字 or 大文字、固定長など)で出力されるか確認する。
負の値を扱う場合は、型変換が原因で誤った出力にならないよう注意する。
バイト列の場合、文字列とバイト値の対応関係を把握しておくと、出力内容の検証が容易になる。

以上、Go言語でのprintf関数を用いた16進数出力の基本的な利用法について解説しました。

まとめ

本記事では、Go言語のprintf関数を用いた16進数出力の基本から、バイト列やその他型の出力方法、固定長や負の値への対応、実践例による検証までを詳しく解説しました。

全体を通して、各書式指定子の特徴と実用的なサンプルコードの使い方が整理され、理解を助ける内容が網羅されています。

ぜひ、実際にコードを書いて動作確認し、さらなる知識の習得に役立ててください。