Go言語の構造体にメソッドを定義する方法をやさしく解説

1. 構造体とは？

1. 構造体とは？

Go言語の構造体（struct）とは、複数の情報をひとまとめにして扱える自分専用のデータ型です。「名前」「年齢」「職業」など、関連するデータを1セットにできるので、バラバラの変数で管理するより圧倒的に分かりやすく整理できます。

イメージとしては、ノートに項目ごとに情報を書き込むようなものです。例えば、人の情報をひとまとめにしたい場合、次のように定義します。

type Person struct {
    Name string
    Age  int
}

Personという構造体には、名前を入れるName、年齢を入れるAgeの2つの項目（フィールド）が含まれています。これを使えば、1人分の情報をひとつの変数で表現でき、複数人のデータ管理もスムーズになります。

例えば次のように値を入れれば、1人の情報をまとめて扱えます。

p1 := Person{Name: "太郎", Age: 20}

このように構造体を使うと、プログラムの見通しが良くなり、ミスも減らせます。特に初心者でも理解しやすく、現場でも頻繁に使われるとても重要な仕組みです。

2. メソッドとは？関数との違いを知ろう

2. メソッドとは？関数との違いを知ろう

メソッドとは、特定の構造体に対して定義する関数のことです。関数との違いは、「どの構造体に結びつけるか」を明示する点にあります。

関数は単体で動作しますが、メソッドは特定の構造体とセットで動作します。

3. メソッドの定義方法

3. メソッドの定義方法

メソッドを定義するときは、funcキーワードのあとにレシーバ（receiver）という構文を使って、どの構造体に属するかを指定します。

func (p Person) Greet() {
    fmt.Println("こんにちは、私の名前は", p.Name, "です。")
}

この(p Person)が「レシーバ」です。Greetというメソッドは、Person型の変数に対して使うことができます。

4. メソッドを使ってみよう！

4. メソッドを使ってみよう！

構造体を作成してメソッドを呼び出すには、以下のように書きます。

package main

import "fmt"

type Person struct {
    Name string
    Age  int
}

// Person型にGreetというメソッドを定義
func (p Person) Greet() {
    fmt.Println("こんにちは、私の名前は", p.Name, "です。")
}

func main() {
    p1 := Person{Name: "太郎", Age: 20}
    p1.Greet() // メソッド呼び出し
}

実行結果：

こんにちは、私の名前は 太郎 です。

5. 値レシーバとポインタレシーバの違い

5. 値レシーバとポインタレシーバの違い

メソッドを定義する際、レシーバを値渡しにするか、ポインタ渡しにするかを選べます。

値レシーバは、構造体のコピーが渡されるので、元のデータは変更されません。一方、ポインタレシーバでは、元のデータを直接変更できます。

func (p *Person) Birthday() {
    p.Age += 1
}

このように*Personと書くことで、ポインタ（元のデータ）に対して操作できます。

6. ポインタレシーバの実例

6. ポインタレシーバの実例

package main

import "fmt"

type Person struct {
    Name string
    Age  int
}

func (p *Person) Birthday() {
    p.Age += 1
}

func main() {
    p1 := Person{Name: "花子", Age: 25}
    p1.Birthday()
    fmt.Println(p1.Name, "は", p1.Age, "歳になりました。")
}

実行結果：

花子 は 26 歳になりました。

ポイント：ポインタレシーバを使うと、構造体の内容を書き換えることができます。年齢のように「増やしたい」「変更したい」データにはポインタレシーバが便利です。

7. レシーバ名は自由に決めていいの？

7. レシーバ名は自由に決めていいの？

レシーバの変数名は自由に決められますが、一般的には構造体名の頭文字の小文字を使うことが多いです。例えば、Personならpという名前にするのが慣例です。

ただし、意味がわかりやすければ他の名前でも問題ありません。

8. メソッドを使うとコードが読みやすくなる理由

8. メソッドを使うとコードが読みやすくなる理由

構造体にメソッドを定義することで、「この動作はこのデータに関係している」とはっきり分かるようになります。

例えば、Greetという動作がPersonにあることで、「この人があいさつするんだな」と一目でわかります。プログラムが大きくなっても、整理されたコードになります。

まとめ

まとめ

Go言語で構造体にメソッドを定義するという考え方は、一見むずかしいように感じますが、実際のプログラムで手を動かしてみると「データ」と「動作」がセットになることで理解が深まります。とくに、名前や年齢のような情報を持った構造体に挨拶の動作を追加する例は、はじめて学ぶ人にもイメージしやすく、実践的です。構造体はフィールドをまとめる箱のような役割を持ち、メソッドはその箱から取り出したデータに振る舞いを与えるという仕組みです。この「データ」と「動き」がつながっていることこそが、大規模なプログラムで役立つポイントになります。

さらに、値レシーバとポインタレシーバの違いは、Go言語ならではの特徴といえます。値レシーバでは元の値が変わらないため、安全に読み取りができ、ポインタレシーバでは直接書き換えができるため「年齢を増やす」「ポイントを加算する」など、更新を伴う処理で大活躍します。実際に動かして比べてみると、コードの見た目はほとんど同じなのに、挙動が大きく変わる点はとても興味深いところです。

また、レシーバ名の付け方も自由に決められますが、慣習として構造体名の頭文字を小文字にすることで読みやすさが保たれます。チームで開発する場合は、このような小さな決まりが積み重なることで読みやすいプログラムへとつながります。メソッドが増えても、型ごとに動きがまとまっていれば、あとからコードを読む人にも親切です。構造体とメソッドが組み合わさることで、Go言語のプログラムは「意味のあるかたまり」になり、自然に整理されたコードへ近づいていきます。

以下は、学んだ内容をまとめた最終サンプルです。構造体とメソッドを組み合わせ、挨拶と誕生日の処理をまとめて書くと、どのデータにどんな操作ができるのかが読み手に伝わりやすくなります。

サンプルプログラムまとめ

package main

import "fmt"

type Person struct {
    Name string
    Age  int
}

// あいさつするメソッド（値レシーバ）
func (p Person) Greet() {
    fmt.Println("こんにちは、私の名前は", p.Name, "です。")
}

// 年齢をひとつ増やすメソッド（ポインタレシーバ）
func (p *Person) Birthday() {
    p.Age += 1
}

func main() {
    p := Person{Name: "太郎", Age: 20}

    // あいさつ
    p.Greet()

    // 年齢を増やす
    p.Birthday()
    fmt.Println(p.Name, "は", p.Age, "歳になりました。")
}

このサンプルのように、「自分というデータが自分であいさつをする」「年齢をひとつ増やす」といった動作が、構造体の中に自然におさまります。もし値レシーバとポインタレシーバの違いがあいまいなままであれば、実際に値が変わるかどうかを画面に出力して確かめてみると理解が深まります。人の情報を表す構造体は、住所やメールアドレス、会員ランクなどを追加していけば、より豊かな例に発展させることができます。こうしてメソッドを活用していけば、Go言語のプログラムは「人間が読んで理解しやすいもの」へと育っていくのです。

先生と生徒の振り返り会話