Go Academy · Leçon

L’interface Reader

Le cœur des E/S de Go

L’interface Reader est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.

Le cœur des entrées-sorties de Go

io.Reader est une interface qui unifie toutes les entrées dans Go : fichiers, connexions réseau, chaînes, flux compressés, et bien plus encore.

Le code qui accepte un io.Reader fonctionne avec n'importe quelle source.

La définition de l'interface

Le contrat est minimal :

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

Il remplit p avec au plus len(p) octets, puis renvoie leur nombre (n) et une erreur.

Lire depuis une chaîne

strings.NewReader transforme une chaîne en 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 règle n puis erreur

Un Read peut renvoyer n > 0 octets et une erreur lors du même appel. Traitez toujours les n octets en premier, puis vérifiez l'erreur.

Lire dans une boucle

La plupart des lecteurs nécessitent une boucle, car un seul Read peut renvoyer moins d'octets que demandé.

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

Lorsque les données sont peu volumineuses et de taille limitée, io.ReadAll lit tout dans une tranche d'octets pour vous.

package main

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

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

Lecteurs à partir de Bytes

bytes.NewReader enveloppe une tranche d'octets, ce qui est utile lorsque vous avez déjà les données en mémoire.

package main

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

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

Fonctions qui acceptent des lecteurs

Écrivez des fonctions qui prennent un io.Reader, plutôt que des types concrets. La même fonction peut alors lire depuis un fichier, un socket ou une chaîne de 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 n'est pas une erreur

Considérez io.EOF comme un signal normal indiquant que le flux est terminé, et non comme un échec. Seules les autres erreurs indiquent de véritables problèmes.

LimitReader

io.LimitReader(r, n) enveloppe un lecteur pour s'arrêter après n octets ; c'est pratique pour limiter la quantité de données lue.

package main

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

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

Pourquoi une seule interface est préférable

Dissocie le code des sources de données
Rend les tests avec des chaînes ou des octets très simples
Se compose avec des enveloppes comme LimitReader, gzip, etc.

Vérification rapide

Vérifiez vos connaissances sur io.Reader.

Récapitulatif

Vous avez appris l'interface fondamentale des entrées.

Read(p []byte) (int, error) constitue l'ensemble du contrat
Bouclez jusqu'à io.EOF ; traitez d'abord les n octets
io.ReadAll, strings/bytes.NewReader, LimitReader
Acceptez io.Reader dans vos API

Questions Fréquemment Posées

La leçon « L’interface Reader » est-elle gratuite ?

Oui — le texte complet de « L’interface Reader » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « L’interface Reader » ?

Le cœur des E/S de Go Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Go Academy ?

Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « L’interface Reader » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?

Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Go Academy