Go Optimizations 101, Go Details & Tips 101 and Go Generics 101 are all updated for Go 1.24 now. The most cost-effective way to get them is through this book bundle in the Leanpub book store.

TapirMD - a powerful, next-generation markup language that simplifies content creation (much more powerful than markdown). You can experience it online here.

The Status Quo of Go Custom Generics

The previous chapters explain the basic knowledge about Go custom generics. This chapter will list some missing features in the current design and implementation of Go custom generics.

Embedding type parameters is not allowed now

Due to design and implementation complexities, currently (Go 1.25), type parameters are disallowed to be embedded in either interface types or struct types.

For example, the following type declaration is illegal.

type Derived[Base any] struct {
	Base // error
	
	x bool
}

Please view this issue for reasons.

The method set of a constraint is not calculated completely for some cases

The Go specification states:

The method set of an interface type is the intersection of the method sets of each type in the interface's type set.

However, currently (Go toolchain 1.25), only the methods explicitly specified in interface types are calculated into method sets. For example, in the following code, the method set of the constraint should contain both Foo and Bar, and the code should compile okay, but it doesn't (as of Go toolchain 1.25).

package main

type S struct{}

func (S) Bar() {}

type C interface {
	S
	Foo()
}

func foobar[T C](v T) {
	v.Foo() // okay
	v.Bar() // v.Bar undefined
}

func main() {}

This restriction is planned to be removed in future Go toolchain versions.

No ways to specific a field set for a constraint

We know that an interface type may specify a method set. But up to now (Go 1.25), it could not specify a (struct) field set.

There is a proposal for this: https://github.com/golang/go/issues/51259.

The restriction might be lifted from future Go versions.

Fields of values of type parameters are not accessible

Currently (Go 1.25), even if all types in the type set of a constraint are structs and they share some common fields, the common fields still can't be used.

For example, the generic functions in the following example all fail to compile.

package main

type S1 struct {
	X int
}

type S2 struct {
	X int `json:X`
}

type S3 struct {
	X int
	Z bool
}

type S4 struct {
	S1
}

func F12[T S1 | S2](v T) {
	_ = v.X // error: v.x undefined
}

func F13[T S1 | S3](v T) {
	_ = v.X // error: v.x undefined
}

func F14[T S1 | S4](v T) {
	_ = v.X // error: v.x undefined
}

func main() {}

A temporary (quite verbose) workaround is to specify/declare some getter and setter methods for the involved constraints and concrete types.

For a special case, the following code also doesn't compile.

type S struct{x, y, z int}

func mod[T S](v T) {
	_ = v.x // error: v.x undefined
}

The restriction (described in the current section) was added just before Go 1.18 is released. It might be removed since a future Go version.

Type switches on values of type parameters are not supported now

It has been mentioned that a type parameter is an interface type from semantic view. On the other hand, a type parameter has wave-particle duality. For some situations, it acts as the types in its type set.

Up to now (Go 1.25), values of type parameters may not be asserted. The following two functions both fail to compile.

func tab[T any](x T) {
	if n, ok := x.(int); ok { // error
		_ = n
	}
}

func kol[T any]() {
	var x T
	switch x.(type) { // error
	case int:
	case []bool:
	default:
	}
}

The following modified versions of the above two functions compile okay:

func tab2[T any](x T) {
	if n, ok := any(x).(int); ok { // error
		_ = n
	}
}

func kol2[T any]() {
	var x T
	switch any(x).(type) { // error
	case int:
	case []bool:
	default:
	}
}

There is a proposal to use type switches directly on type parameters, like:

func kol3[T any]() {
	switch T {
	case int:
	case []bool:
	default:
	}
}

Please subscribe this issue to follow the progress of this problem.

Generic methods are not supported

Currently (Go 1.25), for design and implementation difficulties, generic methods (not methods of generic types) are not supported.

For example, the following code are illegal.

import "sync"

type Lock struct {
	mu sync.Mutex
}

func (l *Lock) Inc[T ~uint32 | ~uint64](x *T) {
	l.Lock()
	defer l.Unlock()
	*x++
}

How many concrete methods do the Lock type have? Infinite! Because there are infinite uint32 and uint64 types. This brings much difficulties to make the reflect standard package keep backwards compatibility.

There is an issue for this.

There are no ways to construct a constraint which allows assignments involving types of unspecific underlying types

And there are not such predeclared constraints like the following supposed assignableTo and assignableFrom constraints.

// This function doesn't compile.
func yex[Tx assignableTo[Ty], Ty assignableFrom[Tx]](x Tx, y Ty) {
	y = x
}

There are no ways to construct a constraint which allows conversion involving types of unspecific underlying types

And there are not such predeclared constraints like the following supposed convertibleTo and convertibleFrom constraints.

// This function doesn't compile.
func x2y[Tx convertibleTo[Ty], Ty convertibleFrom[Tx],
		// The second value argument is
		// for type inference purpose.
		](xs []Tx, _ Ty) []Ty {
	if xs == nil {
		return nil
	}
	ys := make([]Ty, len(xs))
	for i := range xs {
		ys[i] = Ty(xs[i])
	}
	return ys
}

var bs = []byte{61, 62, 63, 64, 65, 66}
var ss = x2y(bs, "")
var is = x2y(bs, 0)
var fs = x2y(bs, .0)

Currently, there is an ungraceful workaround implementation:

func x2y[Tx any, Ty any](xs []Tx, f func(Tx) Ty) []Ty {
	if xs == nil {
		return nil
	}
	ys := make([]Ty, len(xs))
	for i := range xs {
		ys[i] = f(xs[i])
	}
	return ys
}

var bs = []byte{61, 62, 63, 64, 65, 66}
var ss = x2y(bs, func(x byte) string {
	return string(x)
})
var is = x2y(bs, func(x byte) int {
	return int(x)
})
var fs = x2y(bs, func(x byte) float64 {
	return float64(x)
})

The workaround needs a callback function, which makes the code verbose and much less efficient, though I do admit it has more usage scenarios.


(more articles ↡)

The Go 101 project is hosted on Github. Welcome to improve Go 101 articles by submitting corrections for all kinds of mistakes, such as typos, grammar errors, wording inaccuracies, description flaws, code bugs and broken links.

If you would like to learn some Go details and facts every serveral days, please follow Go 101's official Twitter account @zigo_101.

The digital versions of this book are available at the following places:
Tapir, the author of Go 101, has been on writing the Go 101 series books and maintaining the go101.org website since 2016 July. New contents will be continually added to the book and the website from time to time. Tapir is also an indie game developer. You can also support Go 101 by playing Tapir's games (made for both Android and iPhone/iPad):
Individual donations via PayPal are also welcome.

Articles in this book: