...
Eroare Go · Panici la rulare

panic: strings: illegal use of non-zero Builder copied by value

Pe scurt

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

Greșit
GO
func adaugaLinie(b strings.Builder, text string) {
	b.WriteString(text + "\n")
}

var b strings.Builder
b.WriteString("Raport\n")
adaugaLinie(b, "linia 1")
Corect
GO
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

Greșit
GO
type Raport struct {
	b strings.Builder
}

func (r Raport) Adauga(s string) {
	r.b.WriteString(s)
}
Corect
GO
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

Greșit
GO
func scrie(b strings.Builder) { b.WriteString("x") }
Corect
GO
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ă tu

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 6
Codul care dă eroarea
GO
package 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())
}
După reparație, programul afișează
BON
Cafea 12
Corn 6
Indiciu

Nu copia Builder-ul: păstrează antetul ca string și scrie-l într-un Builder nou.

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

← 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.