Go Academy · Lezione

L'interfaccia Reader

Il cuore dell'I/O di Go

L'interfaccia Reader è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Go Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Go Academy include 4 lezioni in totale.

Il cuore dell'I/O in Go

io.Reader è un'unica interfaccia che unifica tutti gli input in Go: file, connessioni di rete, stringhe, flussi compressi e altro.

Il codice che accetta un io.Reader funziona con qualsiasi sorgente.

La definizione dell'interfaccia

Il contratto è minimo:

Read(p []byte) (n int, err error)

Riempie p con un massimo di len(p) byte, restituisce quanti ne ha letti (n) e un errore.

Leggere da una stringa

strings.NewReader trasforma una stringa in un io.Reader.

package main

import (
	"fmt"
	"strings"
)

func main() {
	r := strings.NewReader("Hello")
	buf := make([]byte, 5)
	n, _ := r.Read(buf)
	fmt.Printf("read %d bytes: %s\n", n, buf[:n])
}

La regola n prima dell'errore

Una Read può restituire n > 0 byte e un errore nella stessa chiamata. Elabori sempre prima gli n byte, quindi controlli l'errore.

Leggere in un ciclo

La maggior parte dei reader richiede un ciclo, perché una singola Read può restituire meno byte di quelli richiesti.

package main

import (
	"fmt"
	"io"
	"strings"
)

func main() {
	r := strings.NewReader("abcdef")
	buf := make([]byte, 2)
	for {
		n, err := r.Read(buf)
		if n > 0 {
			fmt.Printf("%s ", buf[:n])
		}
		if err == io.EOF {
			break
		}
	}
	fmt.Println()
}

io.ReadAll

Quando i dati sono pochi e di dimensioni limitate, io.ReadAll legge tutto per Lei in una slice di byte.

package main

import (
	"fmt"
	"io"
	"strings"
)

func main() {
	r := strings.NewReader("read it all")
	data, _ := io.ReadAll(r)
	fmt.Println(string(data))
}

Reader da byte

bytes.NewReader avvolge una slice di byte ed è utile quando i dati sono già in memoria.

package main

import (
	"bytes"
	"fmt"
	"io"
)

func main() {
	r := bytes.NewReader([]byte{72, 105})
	data, _ := io.ReadAll(r)
	fmt.Println(string(data))
}

Funzioni che accettano reader

Scriva funzioni che accettano io.Reader, non tipi concreti. La stessa funzione potrà quindi leggere da un file, un socket o una stringa di test.

package main

import (
	"fmt"
	"io"
	"strings"
)

func countBytes(r io.Reader) int {
	data, _ := io.ReadAll(r)
	return len(data)
}

func main() {
	fmt.Println(countBytes(strings.NewReader("hello")))
}

io.EOF non è un errore

Consideri io.EOF un segnale normale che indica la fine del flusso, non un errore. Solo gli altri errori indicano problemi reali.

LimitReader

io.LimitReader(r, n) avvolge un reader e interrompe la lettura dopo n byte: è utile per limitare la quantità di dati letti.

package main

import (
	"fmt"
	"io"
	"strings"
)

func main() {
	r := io.LimitReader(strings.NewReader("abcdefgh"), 3)
	data, _ := io.ReadAll(r)
	fmt.Println(string(data))
}

Perché una sola interfaccia è vantaggiosa

Disaccoppia il codice dalle sorgenti dei dati
Rende banali i test con stringhe e byte
È componibile con wrapper come LimitReader, gzip ed altro

Verifica rapida

Verifichi la sua conoscenza di io.Reader.

Riepilogo

Ha imparato a usare l'interfaccia di base per gli input.

Read(p []byte) (int, error) è l'intero contratto
Ripeta il ciclo fino a io.EOF ed elabori prima gli n byte
io.ReadAll, strings/bytes.NewReader, LimitReader
Accetti io.Reader nelle sue API

Domande Frequenti

La lezione «L'interfaccia Reader» è gratuita?

Sì — il testo completo di «L'interfaccia Reader» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Go Academy, passa a CoddyKit PRO. Il corso Go Academy include 4 lezioni in totale.

Cosa imparerò in «L'interfaccia Reader»?

Il cuore dell'I/O di Go Eserciti Go Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Go Academy?

Non è richiesta alcuna esperienza precedente. Go Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.

Quanto tempo richiede la lezione «L'interfaccia Reader»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Go Academy?

Sì. Ogni lezione Go Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Go Academy