Generic Method について

先日行われた『実用 Go言語 第2版』の読書会で

Goのジェネリクスの残念な点が、メソッドで新たな型変数が追加できないという点です。

という記述に対して,実は Go 1.27 から Generic Method がサポートされたんだよん,という雑談に発展した。 この記事では,遅ればせながら,復習がてら Go 1.27 で導入された Generic Method について解説する。

Go 1.27 より前の Generics

せっかくなので『実用 Go言語 第2版』のサンプルコードを例に書いていこう。

たとえば,数値型 T の値の平均値を取る Average[T]() 関数を定義するとこんな感じになる。

package main

func Average[T int | float64](values ...T) T {
    var total T
    for _, v := range values {
        total += v
    }
    if len(values) == 0 {
        return 0
    }
    return total / T(len(values))
}

えーっと。 コードに対するツッコミはなしで1。 私が書いたわけじゃないし(笑)

別の実装として,型に対しても型パラメータを指定できる。

type Average[T int | float64] struct {
    total T
    count int
}

func (a *Average[T]) Add(v T) {
    a.total += v
    a.count += 1
}

func (a *Average[T]) Result() T {
    return a.total / T(a.count)
}

Average[T] 型では Add(T) メソッドで値を加えていって Result() メソッドで結果を取り出す構成になっている(コードに対するツッコミはなしでw)。 ここで Add() メソッドの引数には T 型とは異なる数値型を指定し,内部でキャストして加算したいところであるが,1.27 より前では Average[T] 型の型パラメータは T の制約に縛られているため,メソッドでそれ以外の型パラメータを追加することはできない。 どうしてもキャストして加算したいのであれば,専用の Generic 関数を用意する。

func Add[T int | float64, RV int | float64](a *Average[T], v RV) {
    a.Add(T(v))
}

ただ,この方法だと Generic 型に関連する Generic 関数が山ほど生えてくる可能性があり,特にコンテナ操作に関してはパッケージの構成が煩雑になると思われる。 記述自体も煩雑になりがちだし。

こういった理由で,メソッドに独自の型パラメータを追加できるようにして欲しいという要望が多かったようだ。

Go 1.27 の Generic Method

そこで Generic Method の登場である。 前節の Average[T] 型を Generic Method を含む形に書き換えてみよう。

package main

import (
	"fmt"
	"math"
)

type Average[T int | float64] struct {
	total T
	count int
}

func (a *Average[T]) Add[U int | float64](v U) *Average[T] {
	a.total += T(v)
	a.count += 1
	return a
}

func (a *Average[T]) Result() T {
	if a.count == 0 {
		// When T is int, the result of converting NaN to an integer is implementation-specific.
		return T(math.NaN())
	}
	return a.total / T(a.count)
}

func main() {
	fmt.Println("Average:", (&Average[float64]{}).Add(1).Add(2.0).Add(4).Result())
	// Average: 2.3333333333333335
}

オリジナルから少し細工をしてAdd[U]() メソッドを連結して記述できるよう返り値を自身のポインタにしている。 main() 関数では Average[float64] 型のインスタンスを生成し 1, 2.0, 4 と値を追加して平均値を取り出している。

Generic Method の制約

Generic Method は interface のメソッドとして宣言できない。 たとえば

type MyInterface interface { // interface type with generic method (not allowed)
	DoSomething[T any]()
}

と書いても “interface method must have no type parameters” というコンパイルエラーになる。

それじゃあ,というので interface 型のメソッド定義から型パラメータを外した上で

type MyInterface interface { // interface type with non-generic method
	DoSomething()
}

type MyStruct struct{} // concrete type implementing MyInterface

func (m *MyStruct) DoSomething[T any]() { /* ... */ }

func New() MyInterface {
	return &MyStruct{} // compile error due to signature mismatch
}

と書いても,interface 型と concrete 型の間でシグニチャが合わないため,以下のエラーになる。

cannot use &MyStruct{} (value of type *MyStruct) as MyInterface value in return statement: *MyStruct does not implement MyInterface (wrong type for method DoSomething)
		have DoSomething[T any]()
		want DoSomething()

interface 型のメソッドとして Generic Method を許すと,インターフェース値を介した呼び出しで実行され得る具象メソッドを一般には特定できず,必要な型引数の組み合わせをコンパイラがあらかじめ展開するのが難しい。

But in more complex programs, the relation between an interface value method call and its possible targets is significantly less obvious. This relation typically spans across packages, making it difficult or impossible to deduce in the general case.

というわけで interface 型のメソッドでは Generic Method を使えなくしているようだ。

Generic Method を使った実装

Go 1.27 の math/rand/v2 パッケージでは,Generic Method を使った乱数生成が可能になっている。

package main

import (
	"fmt"
	"math/rand/v2"
)

func main() {
	rng := rand.New(rand.NewPCG(1, 2))
	for i := range 5 {
		fmt.Println(i+1, rng.N[int64](100)) // generate a random int64 number less than 100
	}
}

またサードパーティでは,以下のパッケージが Generic Method を使った実装を提供しているようだ。

参考にしていただきたい。

ブックマーク

参考図書

thumbs
実用 Go言語 第2版
文法はシンプルで学びやすいという特徴を持つGo言語。システム開発の現場でも使われる機会が増えていますが、複雑な要件を実現するにはプログラミング言語が提供するシンプルな構成要素(文法やライブラリ)を、さまざまに組み合わせます。 本書は「よりGoらしく書くには」「実用的なアプリケーションを書くには」といった観点からGoを使うポイントを紹介します。 構造体やインタフェース、またJSON、CSVファイル、Excel、固定長ファイルの扱い方、ログやテスト、環境構築など、また初版の発行後、Goに追加されたジェネリクスについても紹介。現場に即した幅広いトピックについて、「Goらしいプログラムの書き方」を、その背景と共に教えてくれる先輩のような書籍です。
 
Release 2025-12-01
評価     

Powered by linkcard

thumbs
プログラミング言語Go - 丸善出版 理工・医学・人文社会科学の専門書出版社
明解で効率的なプログラムを描くための書。 柴田 芳樹 訳
 
Release 2016-06-15
評価     

[Comment] 著者のひとりは,あの “K&R” の K のほうである。この本は Go 言語の教科書と言ってもいいだろう。と思ったら絶版状態らしい(2025-01 現在)。復刊を望む!

Powered by linkcard

photo
Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ
Teiva Harsanyi (著), 柴田 芳樹 (著)
インプレス 2023-08-18 (Release 2023-08-18)
Kindle版
B0CFL1DK8Q (ASIN)
評価     

[Comment] 版元で PDF 版を購入可能。事実上の Effective Go とも言える充実の内容。オリジナルは敢えてタイトルに “tips” という単語を入れるのを避けたのに邦題が「100 Tips」とかなっていて,原作者がお怒りとの噂(あくまで噂)

reviewed by Spiegel on 2023-08-18 (powered by PA-APIv5)

photo
Go言語で学ぶ並行プログラミング 他言語にも適用できる原則とベストプラクティス impress top gearシリーズ
James Cutajar (著), 柴田 芳樹 (著)
インプレス 2024-12-04 (Release 2024-12-04)
Kindle版
B0DNYMMBBQ (ASIN)
評価     

[Comment] 読書会のために購入。インプレス社の本は Kindle 版より版元で PDF 版を買うのがオススメ。「並行処理」について原理的な解説から丁寧に書かれている。 Go で解説されているが Go 以外の言語でも応用できる。

reviewed by Spiegel on 2025-01-25 (powered by PA-APIv5)


  1. 読書会では「if 文は最初に持ってくるべきでは?」とか「要素数が 0 のときにゼロ値を返すのは間違ってるのでは?」とか散々にツッコまれていた(笑) ↩︎