構造体での利用

これまで int に対して & と * を扱ってきましたが、& は変数の型を問わないため、構造体にも同じように使えます。ここでは、構造体のアドレス取得、フィールドアクセスの省略記法、メソッドの値レシーバ・ポインタレシーバ、そしてそれらの相互呼び出しまでを順に見ていきます。

1. アドレス取得

構造体の変数に対しても & でアドレスを取れます。書き方は以下のとおりです。得られるポインタの型は *型名 になります。

p := &構造体変数    // 構造体のアドレスを取得。p の型は *型名

次のコードは、User 型の変数 u からポインタ p を作り、その型と中身を確認する例です。

package main

import "fmt"

type User struct {
    Name string
    Age  int
}

func main() {
    u := User{Name: "Taro", Age: 30}
    p := &u

    fmt.Printf("%T\n", p)   // ポインタの型
    fmt.Printf("%p\n", p)   // アドレス
}

以下のような実行結果が表示されます(アドレスは実行環境によって変わります)。

*main.User
0xc0000100a0

p の型は *main.User(User を指すポインタ)で、p の中身は u のアドレスです。int で扱った p := &x と同じ形で、構造体でもそのままポインタが得られていることが確認できます。

コードを解説します。

p := &u

&u で構造体変数 u のアドレスを取り出し、p に代入しています。int で扱った p := &x と同じ書き方で、構造体に対しても & を付けるだけでアドレスが得られます。

fmt.Printf("%T\n", p)

%T は「渡した値の型」を表示する書式指定子です。p は User のポインタなので *main.User と出力されます。main. はパッケージ名で、パッケージが変われば *パッケージ名.型名 の形になります。

fmt.Printf("%p\n", p)

%p は「ポインタのアドレスを16進数で表示する」書式指定子です。アドレスの具体的な値はプログラムの実行環境や実行のたびに変わります。なお、構造体ポインタを fmt.Println(p) のようにそのまま出力すると、アドレスではなく &{Taro 30} のように参照先の中身が &{...} 形式で表示されるため、アドレスを見たいときは %p を明示的に指定します。

2. フィールドアクセスの省略記法

構造体のポインタからフィールドにアクセスするときは、本来 (*p).フィールド名 と書きますが、Go では . を書くだけで自動的にデリファレンスされ、p.フィールド名 の形で直接アクセスできます。書き方は以下のとおりです。

p.フィールド名     // (*p).フィールド名 と同じ意味で、フィールドの読み書きができる

次のコードは、User のポインタ p から Name フィールドを読み書きする例です。

package main

import "fmt"

type User struct {
    Name string
    Age  int
}

func main() {
    u := User{Name: "Taro", Age: 30}
    p := &u

    fmt.Println(p.Name)
    p.Name = "Jiro"
    fmt.Println(u.Name)
}

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

Taro
Jiro

p.Name で Taro が読み取れ、p.Name = "Jiro" で書き換えたところ、元の u の Name も Jiro に変わりました。

コードを解説します。

fmt.Println(p.Name)

p は *User 型ですが、p.Name と書けば Go が自動的に (*p).Name として扱ってくれます。毎回 * を書かなくて済むため、構造体ポインタは実務でも扱いやすくなっています。

p.Name = "Jiro"
fmt.Println(u.Name)

p が指しているのは u そのものなので、p.Name を書き換えると u.Name も同じ値になります。ポインタを渡した先で構造体の中身を更新できるのは、この仕組みによるものです。

この省略記法の利点は主に2つあります。1つは記述量が減ることで、(*p).Name の代わりに p.Name と書けるだけでなく、ネストしたフィールド(例: p.Address.City)にも . を続けるだけで到達できます。もう1つは、値(u.Name)とポインタ(p.Name)で書き方が同じになる点で、値を扱うコードをあとからポインタに書き換えても、フィールドアクセスの記述はそのままで済みます。

3. 値レシーバとポインタレシーバ

前章の Go構造体 でメソッドを扱ったときに、レシーバは (u User) のように書きました。実はこのレシーバも、値で受け取るか、ポインタで受け取るかの2種類があります。書き方は以下のとおりです。ポインタレシーバは型名の前に * を付けます。

// 値レシーバ
func (レシーバ変数 型) メソッド名() { ... }

// ポインタレシーバ
func (レシーバ変数 *型) メソッド名() { ... }

次のコードは、同じ Counter 型に対して、値レシーバの IncByValue とポインタレシーバの IncByPointer を用意し、動きの違いを比較する例です。

package main

import "fmt"

type Counter struct {
    Count int
}

// 値レシーバ: メソッド内での変更は呼び出し元に伝わらない
func (c Counter) IncByValue() {
    c.Count++
}

// ポインタレシーバ: メソッド内での変更が呼び出し元に伝わる
func (c *Counter) IncByPointer() {
    c.Count++
}

func main() {
    c := Counter{Count: 0}

    c.IncByValue()
    fmt.Println(c.Count)

    c.IncByPointer()
    fmt.Println(c.Count)
}

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

0
1

IncByValue を呼んだあとの c.Count は 0 のまま(コピーを書き換えただけ)、IncByPointer を呼んだあとは 1 に増えました(本体を書き換えた)。

コードを解説します。

func (c Counter) IncByValue() {
    c.Count++
}

レシーバを (c Counter) と型そのもので受けています。この場合、c は呼び出し元の値のコピーなので、c.Count++ してもコピーの値が変わるだけで、元の Counter には影響しません。

func (c *Counter) IncByPointer() {
    c.Count++
}

レシーバを (c *Counter) とポインタ型で受けています。*Counter は「Counter のポインタ」を意味し、呼び出し元の値そのものを指します。c.Count++ はここでも「フィールドアクセスの省略記法」((*c).Count++)が働いており、本体のフィールドを書き換えるため、呼び出し元の Counter に変更が反映されます。

使い分けの目安として、フィールドを変更するメソッドや、フィールドが多い大きな構造体(呼び出しのたびに値全体をコピーしたくない場面)では、ポインタレシーバを使います。それ以外は値レシーバでも構いませんが、同じ型のメソッド間ではどちらかに統一するのが原則です。

4. レシーバの相互呼び出し

値レシーバとポインタレシーバのメソッドは、呼び出し側でわざわざ * や & を書かなくても、Go が自動で対応してくれる場面が多くあります。次のコードは、Counter の値レシーバ・ポインタレシーバ両方のメソッドを、値からもポインタからも呼び出す例です。

package main

import "fmt"

type Counter struct {
    Count int
}

func (c Counter) Value() int { return c.Count }   // 値レシーバ
func (c *Counter) Inc()      { c.Count++ }         // ポインタレシーバ

func main() {
    c := Counter{Count: 0}
    p := &c

    c.Inc()                  // 値から ポインタレシーバのメソッドを呼ぶ
    fmt.Println(p.Value())   // ポインタから 値レシーバのメソッドを呼ぶ
}

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

1

c.Inc()(値からポインタレシーバ)と p.Value()(ポインタから値レシーバ)の両方がそのまま書けて、それぞれ意図通りに動きました。

コードを解説します。

c.Inc()

Inc はポインタレシーバのメソッドですが、変数 c からは c.Inc() の形で呼び出せます。Go が自動的に (&c).Inc() に置き換えてくれるためです。

fmt.Println(p.Value())

Value は値レシーバのメソッドですが、ポインタ p からは p.Value() の形で呼び出せます。こちらも自動的に (*p).Value() に置き換えてくれます。

ただし、マップの要素や式の結果のような一時的な値 からは、Go はアドレスを取れないため、ポインタレシーバのメソッドを直接呼び出せません。その場合は、いったんローカル変数に受けてから呼び出す必要があります。