panic: strings: illegal use of non-zero Builder copied by value
Ai copiat un strings.Builder care avea deja conținut (l-ai transmis prin valoare unei funcții sau l-ai atribuit altei variabile) și apoi ai scris în copie. Transmite-l prin pointer (*strings.Builder) sau ca io.Writer.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
strings.Builder construiește eficient un text, ținând intern un buffer. Ca să nu existe două variabile care scriu în același buffer, Builder-ul își memorează adresa la prima scriere. Dacă îl copiezi după ce are conținut (b2 := b, sau func f(b strings.Builder) apelată cu un Builder folosit) și scrii în copie, verificarea internă vede altă adresă și oprește programul: panic: strings: illegal use of non-zero Builder copied by value.
În stiva de apeluri vezi strings.(*Builder).copyCheck și, mai jos, funcția ta care a scris în copie.
Un Builder gol poate fi copiat fără probleme; panica apare doar pentru unul deja folosit. go vet semnalează multe dintre aceste copieri (analiza copylocks nu, dar gopls avertizează la transmiterea prin valoare a tipurilor cu noCopy).
De ce apare: cauzele frecvente
1Builder transmis prin valoare
func adaugaLinie(b strings.Builder, text string) {
b.WriteString(text + "\n")
}
var b strings.Builder
b.WriteString("Raport\n")
adaugaLinie(b, "linia 1")func adaugaLinie(b *strings.Builder, text string) {
b.WriteString(text + "\n")
}
var b strings.Builder
b.WriteString("Raport\n")
adaugaLinie(&b, "linia 1")Prin pointer, funcția scrie în același Builder, iar textul adăugat se vede și la apelant.
2Struct cu Builder copiat
type Raport struct {
b strings.Builder
}
func (r Raport) Adauga(s string) {
r.b.WriteString(s)
}type Raport struct {
b strings.Builder
}
func (r *Raport) Adauga(s string) {
r.b.WriteString(s)
}Un receiver pe valoare copiază tot struct-ul, inclusiv Builder-ul; folosește receiver pe pointer.
3Funcție care scrie în orice destinație
func scrie(b strings.Builder) { b.WriteString("x") }func scrie(w io.Writer) { fmt.Fprint(w, "x") }
scrie(&b)*strings.Builder implementează io.Writer; funcția merge apoi și cu fișiere, buffere sau os.Stdout.
Repară eroarea, direct în pagină
Programul pregătește antetul unui bon într-un strings.Builder și apoi copiază Builder-ul ca să adauge produsele clientului, dar programul se oprește cu panic: strings: illegal use of non-zero Builder copied by value. Repară construirea bonului ca programul să afișeze:
BON
Cafea 12
Corn 6package main
import (
"fmt"
"strings"
)
func main() {
var antet strings.Builder
antet.WriteString("BON\n")
bon := antet
bon.WriteString("Cafea 12\n")
bon.WriteString("Corn 6\n")
fmt.Print(bon.String())
}BON Cafea 12 Corn 6
Indiciu
Nu copia Builder-ul: păstrează antetul ca string și scrie-l într-un Builder nou.
Reparația
package main
import (
"fmt"
"strings"
)
func main() {
antet := "BON\n"
var bon strings.Builder
bon.WriteString(antet)
bon.WriteString("Cafea 12\n")
bon.WriteString("Corn 6\n")
fmt.Print(bon.String())
}De ce merge
bon := antet copia un Builder care avea deja conținut, iar prima scriere în copie a declanșat verificarea internă: două Builder-e ar fi împărțit același buffer. Antetul păstrat ca string se poate refolosi oricât, iar fiecare bon primește propriul Builder, în care scrii antetul și apoi produsele. Când un Builder trebuie folosit din altă funcție, transmite-l ca *strings.Builder.
Alte forme ale mesajului
panic: strings: illegal use of non-zero Builder copied by value [recovered]
Cum o eviți pe viitor
Tratează strings.Builder (la fel ca sync.Mutex, bytes.Buffer folosit și sync.WaitGroup) ca pe o valoare care nu se copiază: transmite-o prin pointer, iar struct-urile care o conțin folosesc metode pe pointer. Pentru funcții care produc text, întoarce un string sau primește un io.Writer.
Întrebări frecvente
De ce bytes.Buffer nu panichează la fel?
bytes.Buffer nu are această verificare: copia împarte același tablou de octeți cu originalul și poate produce date amestecate fără nicio eroare. E chiar mai periculos; tot prin pointer se transmite.
Pot reseta un Builder și refolosi?
Da, cu b.Reset(), care îl aduce la starea goală; după asta poate fi chiar copiat în siguranță.
Erori înrudite
Patrat does not implement Forma (method Arie has pointer receiver) Metoda interfeței e definită pe pointer (func (p *Patrat) Arie()), dar tu folosești o valoare Patrat{}. Doar *Patrat implementează interfața. Pune adresa: &Patrat{...}, sau schimbă receptorul metodei în valoare dacă metoda nu modifică struct-ul. cannot call pointer method Depune on Cont Metoda are receptor pointer (func (c *Cont) ...), dar o apelezi pe o valoare care nu are adresă: un element de map sau rezultatul unei funcții. Pune valoarea într-o variabilă, sau ține în map pointeri (map[string]*Cont). panic: runtime error: invalid memory address or nil pointer dereference Ai folosit un pointer care este nil: ai citit un câmp sau ai apelat o metodă printr-un pointer care nu indică spre nicio valoare. Inițializează pointerul (p := &Produs{} sau un constructor) și verifică if p != nil înainte de folosire, mai ales după funcții care pot întoarce nil. Î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.
