...
Eroare Go · fmt, CSV, XML și template-uri

template: eticheta:1: function "upper" not defined

Pe scurt

Șablonul (text/template sau html/template) apelează o funcție pe care nu ai înregistrat-o. Adaugă-o cu .Funcs(template.FuncMap{"upper": strings.ToUpper}) înainte de Parse; ordinea contează.

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

Ce înseamnă

Șabloanele din Go cunosc doar câteva funcții predefinite (len, index, printf, eq, and, or, not și altele). Orice altă funcție, cum ar fi upper, lei sau formatData, trebuie înregistrată cu Funcs înainte de Parse, pentru că verificarea numelor se face la parsare. Altfel Parse întoarce template: eticheta:1: function "upper" not defined: numele șablonului, linia și funcția lipsă.

Dacă folosești template.Must(...), eroarea devine panică la pornirea programului (panic: template: ...). Asta e chiar util: greșeala apare imediat, nu la prima cerere.

Cauze tipice: ai uitat Funcs, l-ai apelat după Parse, ai scris numele altfel (Upper față de upper), sau folosești ParseFiles pe un șablon nou creat fără funcții.

De ce apare: cauzele frecvente

1Funcție neînregistrată

Greșit
GO
t := template.Must(template.New("eticheta").
	Parse(`{{upper .Nume}}`))
Corect
GO
t := template.Must(template.New("eticheta").
	Funcs(template.FuncMap{"upper": strings.ToUpper}).
	Parse(`{{upper .Nume}}`))

Funcția e cunoscută în momentul în care Parse verifică șablonul.

2Funcs apelat după Parse

Greșit
GO
t, err := template.New("t").Parse(`{{lei .Pret}}`)
t.Funcs(template.FuncMap{"lei": formatLei})
Corect
GO
t, err := template.New("t").
	Funcs(template.FuncMap{"lei": formatLei}).
	Parse(`{{lei .Pret}}`)

La Parse funcția nu exista încă; înregistrarea ulterioară nu repară eroarea.

Repară tu

Repară eroarea, direct în pagină

Programul generează eticheta unui produs dintr-un șablon care afișează numele cu litere mari, prin funcția upper. Funcția nu e înregistrată, iar template.Must oprește programul cu function "upper" not defined. Înregistreaz-o înainte de Parse, ca programul să afișeze:

MOUSE - 49 lei
Codul care dă eroarea
GO
package main

import (
	"os"
	"text/template"
)

type Produs struct {
	Nume string
	Pret int
}

func main() {
	t := template.Must(template.New("eticheta").
		Parse("{{upper .Nume}} - {{.Pret}} lei\n"))
	t.Execute(os.Stdout, Produs{Nume: "mouse", Pret: 49})
}
După reparație, programul afișează
MOUSE - 49 lei
Indiciu

Adaugă .Funcs(template.FuncMap{"upper": strings.ToUpper}) între New și Parse.

Alte forme ale mesajului

  • panic: template: eticheta:1: function "upper" not defined
  • template: t:1: unexpected EOF
  • template: t:1: unexpected "}" in operand

Cum o eviți pe viitor

Creează șabloanele o singură dată, la pornire, cu template.Must și cu toate funcțiile într-un FuncMap comun. Pentru pagini HTML folosește html/template (face escaping automat), cu același API. Scrie un test care parsează toate șabloanele, ca o funcție lipsă să fie prinsă în CI.

Întrebări frecvente

Ce funcții există deja în șabloane?

Printre altele: and, or, not, eq, ne, lt, gt, len, index, slice, print, printf, println, html, js, urlquery, call.

Pot apela o metodă a datelor în loc de o funcție?

Da: {{.NumeMare}} apelează metoda NumeMare() dacă tipul datelor are una exportată, fără nicio înregistrare.

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.