Go Academy · Leçon

Implémenter des lecteurs personnalisés

Créer vos propres flux

Implémenter des lecteurs personnalisés est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 4 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.

Créez vos propres flux

Vous pouvez créer des sources de données personnalisées en implémentant l’interface io.Reader, qui ne comporte qu’une seule méthode. Votre type fonctionne alors avec toutes les fonctions auxiliaires de io.

La méthode à implémenter

Implémentez Read(p []byte) (n int, err error) sur votre type. Remplissez p, renvoyez le nombre d’octets lus et renvoyez io.EOF lorsque la lecture est terminée.

Un lecteur constant

Voici un lecteur qui émet indéfiniment le même octet, avec une limite définie par LimitReader.

package main

import (
	"fmt"
	"io"
)

type constReader struct{ ch byte }

func (c constReader) Read(p []byte) (int, error) {
	for i := range p {
		p[i] = c.ch
	}
	return len(p), nil
}

func main() {
	r := io.LimitReader(constReader{ch: 'A'}, 5)
	data, _ := io.ReadAll(r)
	fmt.Println(string(data))
}

Signaler EOF

Renvoyez io.EOF une fois votre source épuisée. Vous pouvez le renvoyer seul ou avec les derniers octets.

package main

import (
	"fmt"
	"io"
)

type oneShot struct{ done bool }

func (o *oneShot) Read(p []byte) (int, error) {
	if o.done {
		return 0, io.EOF
	}
	o.done = true
	n := copy(p, []byte("once"))
	return n, nil
}

func main() {
	data, _ := io.ReadAll(&oneShot{})
	fmt.Println(string(data))
}

Lire depuis une tranche

Un lecteur personnalisé peut suivre une position dans les données sous-jacentes et renvoyer un bloc à chaque appel.

package main

import (
	"fmt"
	"io"
)

type sliceReader struct {
	data []byte
	pos  int
}

func (s *sliceReader) Read(p []byte) (int, error) {
	if s.pos >= len(s.data) {
		return 0, io.EOF
	}
	n := copy(p, s.data[s.pos:])
	s.pos += n
	return n, nil
}

func main() {
	r := &sliceReader{data: []byte("custom")}
	out, _ := io.ReadAll(r)
	fmt.Println(string(out))
}

Un lecteur transformateur

Enveloppez un autre lecteur et transformez les octets à la volée — ici, chaque octet est converti en majuscule au fur et à mesure de sa lecture.

package main

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

type upper struct{ r io.Reader }

func (u upper) Read(p []byte) (int, error) {
	n, err := u.r.Read(p)
	for i := 0; i < n; i++ {
		if p[i] >= 'a' && p[i] <= 'z' {
			p[i] -= 32
		}
	}
	return n, err
}

func main() {
	out, _ := io.ReadAll(upper{r: bytes.NewReader([]byte("hello"))})
	fmt.Println(string(out))
}

Respectez la longueur du tampon

N’écrivez jamais plus de len(p) octets. Utilisez copy(p, src), qui est limité par la plus petite tranche, puis renvoyez le nombre d’octets copiés.

Récepteurs par valeur ou par pointeur

Si votre lecteur suit une position ou un état, utilisez un récepteur pointeur afin que les modifications persistent d’un appel à l’autre. Les lecteurs sans état peuvent utiliser un récepteur par valeur.

Composer avec les fonctions auxiliaires de io

Comme votre type satisfait io.Reader, il s’intègre gratuitement à io.Copy, bufio.NewReader, io.LimitReader, et bien d’autres.

package main

import (
	"io"
	"os"
)

type dots struct{ left int }

func (d *dots) Read(p []byte) (int, error) {
	if d.left == 0 {
		return 0, io.EOF
	}
	p[0] = '.'
	d.left--
	return 1, nil
}

func main() {
	io.Copy(os.Stdout, &dots{left: 4})
	os.Stdout.WriteString("\n")
}

Pièges courants

Oublier de renvoyer io.EOF (lecture infinie)
Écrire au-delà de len(p)
Utiliser un récepteur par valeur pour des lecteurs qui possèdent un état

Pourquoi créer des lecteurs personnalisés

Ils vous permettent d’adapter n’importe quelle source — générateurs, décodeurs, limiteurs de débit ou flux chiffrés — à l’écosystème universel d’E/S de Go.

Vérification rapide

Vérifiez vos connaissances sur les lecteurs personnalisés.

Récapitulatif

Vous avez appris à créer vos propres flux.

Implémentez Read(p []byte) (int, error)
Utilisez copy et respectez len(p)
Renvoyez io.EOF lorsque la lecture est terminée
Utilisez un récepteur pointeur pour les lecteurs qui possèdent un état
Composez avec toutes les fonctions auxiliaires de io sans travail supplémentaire

Questions Fréquemment Posées

La leçon « Implémenter des lecteurs personnalisés » est-elle gratuite ?

Oui — le texte complet de « Implémenter des lecteurs personnalisés » 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 « Implémenter des lecteurs personnalisés » ?

Créer vos propres flux 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 4 sur 4.

Combien de temps prend la leçon « Implémenter des lecteurs personnalisés » ?

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