...
Eroare Go · Structs, metode, interfețe și generice

cannot define new methods on non-local type int

Pe scurt

Poți adăuga metode doar tipurilor declarate în pachetul tău. Pentru int, string, time.Duration sau tipuri din alte pachete, declară un tip nou pe baza lor (type Lei float64) și pune metodele pe el, sau scrie o funcție obișnuită.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În Go, metodele unui tip se pot declara doar în pachetul în care e declarat tipul. Tipurile predefinite (int, string, float64) și cele din biblioteca standard sau din alte module (time.Duration, http.Request) nu sunt ale tale, așa că func (n int) Dublu() int dă cannot define new methods on non-local type int.

Regula împiedică două pachete să adauge metode cu același nume aceluiași tip și păstrează clar unde se găsește API-ul unui tip.

Soluția idiomatică este un tip definit: type Lei float64 creează un tip nou, al tău, cu aceeași reprezentare ca float64. Pe el poți pune metode (func (l Lei) String() string), iar conversia între ele e explicită: Lei(49.9), float64(suma). Pentru tipuri din alte pachete poți folosi și embedding într-un struct propriu.

De ce apare: cauzele frecvente

1Metodă pe un tip predefinit

Greșit
GO
func (n int) EPar() bool {
	return n%2 == 0
}
Corect
GO
type Numar int

func (n Numar) EPar() bool {
	return n%2 == 0
}

Tipul Numar e declarat în pachetul tău, deci poate avea metode.

2Metodă pe un tip din biblioteca standard

Greșit
GO
func (d time.Duration) Minute() int {
	return int(d.Minutes())
}
Corect
GO
func minute(d time.Duration) int {
	return int(d.Minutes())
}

Când ai nevoie doar de un calcul, o funcție obișnuită e cea mai simplă soluție.

3Extinderea unui struct din alt pachet

Greșit
GO
func (b *strings.Builder) ScrieLinie(s string) { ... }
Corect
GO
type Text struct {
	strings.Builder
}

func (t *Text) ScrieLinie(s string) {
	t.WriteString(s + "\n")
}

Prin embedding, Text păstrează metodele lui Builder și primește în plus metodele tale.

Repară tu

Repară eroarea, direct în pagină

Programul vrea să afișeze sume de bani cu o metodă Format, dar o declară direct pe float64 și compilarea se oprește cu cannot define new methods on non-local type float64. Declară un tip propriu Lei ca programul să afișeze Total: 149.70 lei.

Codul care dă eroarea
GO
package main

import "fmt"

func (s float64) Format() string {
	return fmt.Sprintf("%.2f lei", s)
}

func main() {
	var total float64 = 49.90 * 3
	fmt.Println("Total:", total.Format())
}
După reparație, programul afișează
Total: 149.70 lei
Indiciu

Declară type Lei float64 și pune metoda pe Lei.

Alte forme ale mesajului

  • cannot define new methods on non-local type time.Duration
  • cannot define new methods on non-local type string

Cum o eviți pe viitor

Când vrei comportament legat de o valoare simplă (bani, temperatură, cod de produs), declară de la început un tip propriu: type Lei float64, type CodProdus string. Câștigi și metode, și verificări de tip (nu mai poți aduna din greșeală lei cu kilograme). Pentru ajutoare punctuale, funcțiile obișnuite sunt la fel de idiomatice în Go ca metodele.

Întrebări frecvente

Un tip definit păstrează metodele tipului de bază?

Nu. type Text strings.Builder pierde metodele lui Builder. Dacă vrei să le păstrezi, folosește embedding într-un struct (type Text struct { strings.Builder }).

Pot pune metode pe un alias (type Lei = float64)?

Nu, un alias este exact același tip ca float64, deci tot non-local. Ai nevoie de tip definit, fără =.

Erori înrudite

← Toate erorile Go

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Go de la zero, cu exerciții la fiecare lecție

Curs Go: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.