メソッド

メソッド は、特定の型に紐づけられた関数です。関数名の前にレシーバと呼ばれる特別な引数を書くことで、「この関数は User 型のメソッド」といった具合に、その型のメソッドとして定義できます。データとそれに対する処理を、構造体とメソッドの組み合わせでひとまとまりで表現できるようになります。

📝 レシーバとは
メソッド定義の func と関数名の間に書く、(変数名 型) の形の特別な引数を レシーバ と呼びます。「この関数は〜型のメソッド」であることを宣言する役割を持ち、メソッドの中ではレシーバ変数を通してその型のフィールドにアクセスできます。

1. メソッドの定義

メソッドは通常の関数と似ていますが、func と関数名の間にレシーバを書く点が違います。書き方は以下のとおりです。

func (レシーバ変数 型) メソッド名(引数) 戻り値の型 {
    // 処理(レシーバ変数を通して型のフィールドにアクセスできる)
}

レシーバに書いた型のメソッドとして扱われ、インスタンス.メソッド名() の形で呼び出せます。

実際に試してみましょう。次のコードは、これまで扱ってきた User 型に、Age に応じて「未成年」「成人」を返す Category メソッドを紐づける例です。

package main

import "fmt"

type User struct {
    Name string
    Age  int
}

func (u User) Category() string {
    if u.Age < 18 {
        return "未成年"
    }
    return "成人"
}

func main() {
    u := User{Name: "Taro", Age: 30}
    fmt.Println(u.Category())
}

以下のような実行結果が表示されます。

成人

u.Category() の呼び出しで、u.Age が 30 なので 成人 が返されて出力されました。

コードを解説します。

func (u User) Category() string {
    if u.Age < 18 {
        return "未成年"
    }
    return "成人"
}

func の直後の (u User) がレシーバです。「この関数は User 型のメソッドである」ことを宣言しており、関数内では u.Age や u.Name のようにレシーバのフィールドにアクセスできます。

u := User{Name: "Taro", Age: 30}
fmt.Println(u.Category())

User のインスタンス u を作り、u.Category() とドット記法でメソッドを呼び出しています。

なお、メソッドのレシーバには、値で受け取るものと ポインタ で受け取るものの2種類があります。フィールドを書き換えるメソッドではポインタレシーバを使いますが、詳しくは次章のGoポインタで扱います。

2. コンストラクタ関数

構造体のインスタンスを作るときに、事前準備や検証などの初期化ロジックをまとめておきたい場合は、New〜 という名前の関数を用意するのがGoの慣用パターンです。書き方は以下のとおりです。

func New型名(引数) 型名 {
    return 型名{フィールド名: 値, ...}
}

実際に試してみましょう。次のコードは、User のインスタンスを作って返す NewUser を定義する例です。

package main

import "fmt"

type User struct {
    Name string
    Age  int
}

func NewUser(name string, age int) User {
    return User{Name: name, Age: age}
}

func main() {
    u := NewUser("Taro", 30)
    fmt.Println(u)
}

以下のような実行結果が表示されます。

{Taro 30}

NewUser から返された User のインスタンスが u に入り、そのまま表示されました。

コードを解説します。

func NewUser(name string, age int) User {
    return User{Name: name, Age: age}
}

戻り値の型を User としています。New〜 という命名は「〜を作って返す」意図が名前から伝わるGoの慣用パターンです。実際には、戻り値を *User(User のポインタ)にすることも多いですが、ポインタは次章のGoポインタで扱います。