入出力

Go言語におけるStructの表示方法を解説

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

今回はGo言語でstructを表示する方法を紹介します。

開発環境が整っていれば、簡単なコード例を交えながら実践的な方法を試せます。

シンプルに出力できる手法について、分かりやすく説明します。

目次から探す

Structの基本知識
- Structの定義方法
- Structの初期化と割り当て
標準の出力方法
- fmtパッケージによる基本出力
カスタム表示方法の実装
- Stringメソッドの定義による出力カスタマイズ
出力結果の動作確認
- 実例コードによる動作チェック
- 出力時の注意点と改善ポイント
まとめ

Structの基本知識

Go言語におけるstructは、複数の異なる型のデータを1つにまとめるための基本的なデータ構造です。

データのグループ化や、オブジェクト指向的な振る舞いを実現する際に役立ちます。

Structの定義方法

structの定義は、typeキーワードを用いて行います。

定義時には、構造体名とそのフィールド(メンバ変数)の名前、型を指定します。

以下は、Personという構造体を定義する例です。

package main
import "fmt"
// Person構造体は名前と年齢を保持する
type Person struct {
	Name string // 名前を保持するフィールド
	Age  int    // 年齢を保持するフィールド
}
func main() {
	// Person型の変数pを初期化
	p := Person{
		Name: "太郎",
		Age:  30,
	}
	fmt.Println(p) // {太郎 30}が出力される
}

{太郎 30}

Structの初期化と割り当て

構造体の初期化は、リテラル表記とnewキーワードを利用して行う方法があります。

リテラル表記では、フィールド名を指定して値を設定することができ、コードの可読性が向上します。

newを使うと、構造体へのポインタが返されるため、後からフィールドへアクセスして値を設定することが可能です。

以下の例では、Book構造体をリテラル表記およびnewを使って初期化する方法を示します。

package main
import "fmt"
// Book構造体は書籍のタイトルとページ数を保持する
type Book struct {
	Title string // 書籍のタイトル
	Pages int    // ページ数
}
func main() {
	// 構造体リテラルで初期化
	book1 := Book{
		Title: "Go入門",
		Pages: 200,
	}
	// newを使って初期化し、その後フィールドに値を割り当て
	book2 := new(Book)
	book2.Title = "Goプログラミング"
	book2.Pages = 300
	// book2はポインタなので、*book2で中身を表示
	fmt.Println(book1, *book2)
}

{Go入門 200} {Goプログラミング 300}

標準の出力方法

Goでは、fmtパッケージを使用して様々な形式でデータを出力することができます。

特に構造体の場合、出力方法を変えることでデバッグやログの作成に役立ちます。

fmtパッケージによる基本出力

fmtパッケージには、標準出力用の関数がいくつか用意されています。

代表的なものは以下です。

fmt.Println：引数をスペース区切りで表示し、改行を付加して出力します。
fmt.Printf：フォーマット文字列に従って出力します。書式指定によって、より詳細な表現が可能です。

fmt.Printlnとfmt.Printfの使い分け

fmt.Printlnは、すぐに値を表示したい場合に便利です。

値の区切りや改行が自動的に行われるため、手軽に出力を確認できます。

一方、fmt.Printfはフォーマット指定子を利用できるため、出力の詳細な制御が求められるときに適しています。

例えば、出力形式を揃えたい場合などに利用されます。

%vと%#vの違い

fmt.Printfで使用する書式指定子にはいくつか種類があり、%vと%#vは構造体の出力方法でよく比較されます。

%vは構造体の各フィールドの値をシンプルに出力します。
%#vは構造体のフィールド名と値、さらには型情報なども含めた詳細な情報を出力します。

以下のサンプルコードで違いを確認することができます。

package main
import "fmt"
// Employee構造体は従業員の情報を保持する
type Employee struct {
	Name string // 名前
	ID   int    // 従業員番号
}
func main() {
	emp := Employee{
		Name: "花子",
		ID:   101,
	}
	// fmt.Printlnを利用した出力
	fmt.Println(emp)            // デフォルトの出力
	// fmt.Printfで%vを利用した出力
	fmt.Printf("%v\n", emp)      // 単純な出力
	// fmt.Printfで%#vを利用した詳細な出力
	fmt.Printf("%#v\n", emp)
}

{花子 101}
{花子 101}
main.Employee{Name:"花子", ID:101}

カスタム表示方法の実装

structの出力方法は、標準の出力方法だけでは不十分な場合があります。

より分かりやすく表示するために、Stringメソッドを定義してカスタム出力を実現することができます。

Stringメソッドの定義による出力カスタマイズ

構造体に対してString() stringメソッドを実装すると、fmt系の出力関数はそのメソッドを呼び出して表示内容を決定します。

これにより、出力形式を自由にデザインすることが可能です。

独自フォーマットの設定方法

Stringメソッド内で、fmt.Sprintfを利用してフォーマット済みの文字列を返すことで、希望する出力形式に整形することができます。

たとえば、フィールド名や単位などを文字列に含めることが可能です。

コード例での解説

以下は、Product構造体に対して独自のStringメソッドを実装するサンプルコードです。

コード中には、分かりやすいコメントを付けて出力カスタマイズの流れを説明しています。

package main
import "fmt"
// Product構造体は製品の情報を管理する
type Product struct {
	Name  string // 製品名
	Price int    // 価格(円)
}
// Stringメソッドで出力フォーマットをカスタマイズする
func (p Product) String() string {
	// 製品名と価格を整形して返す
	return fmt.Sprintf("製品名: %s, 価格: %d円", p.Name, p.Price)
}
func main() {
	// Product構造体の初期化
	product := Product{
		Name:  "ノートPC",
		Price: 120000,
	}
	// カスタム出力が適用される
	fmt.Println(product)
}

製品名: ノートPC, 価格: 120000円

出力結果の動作確認

実際に作成したコードが意図通りに出力されるかを動作確認することは重要です。

ここでは、複数の出力方法を組み合わせた例を示し、各出力結果を比較しながら確認します。

実例コードによる動作チェック

以下のサンプルコードは、Car構造体に対してStringメソッドを実装した例です。

各種出力方法によって、どのように結果が変わるかを確認できます。

package main
import "fmt"
// Car構造体は車の情報を管理する
type Car struct {
	Model string // 車種
	Year  int    // 製造年
}
// Stringメソッドでカスタム出力を設定する
func (c Car) String() string {
	// モデルと製造年を整形して返す
	return fmt.Sprintf("モデル: %s, 製造年: %d", c.Model, c.Year)
}
func main() {
	// Car構造体の初期化
	car := Car{
		Model: "Honda Civic",
		Year:  2020,
	}
	// カスタム出力を確認
	fmt.Println(car)         // Stringメソッドが呼ばれてカスタム出力になる
	fmt.Printf("%v\n", car)   // %vでもカスタム出力が利用される
	fmt.Printf("%#v\n", car)  // %#vでフィールド情報も含めた詳細出力になる
}

モデル: Honda Civic, 製造年: 2020
モデル: Honda Civic, 製造年: 2020
main.Car{Model:"Honda Civic", Year:2020}

出力時の注意点と改善ポイント

出力結果の確認を行う際は、以下の点に注意してください。

出力形式が期待通りになっているか、特にStringメソッドを実装した場合は、標準の出力関数が正しく呼ばれているか確認する必要があります。
%vと%#vの違いを理解し、デバッグ時にどちらを利用するか判断してください。
実際に動作させながら、不要な空白や改行、フォーマットの乱れがないかチェックするとともに、出力内容がユーザーにとって分かりやすいかも確認してください。

これらの注意点を留意することで、効率的に出力結果を調整し、プログラムの品質向上につなげることができます。

まとめ

この記事では、Go言語における構造体の定義、初期化、標準出力やカスタム出力の実装方法、さらに出力結果の動作確認までを詳しく解説しました。

全体として、各手法の違いと使い分けが明確になり、実際に動作するサンプルコードを通して具体的な利用方法が理解できる内容になっています。

是非、今回の知識を活用して、プログラムの出力改善やデバッグ効率の向上に挑戦してください。