Go Academy · Leçon

L’interface Stringer

Personnaliser l’affichage des types

L’interface Stringer est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 3 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.

Affichage par défaut d'une structure

Par défaut, l'affichage d'une structure avec %v montre ses champs bruts. Cela convient au débogage, mais n'est pas toujours très lisible.

package main

import "fmt"

type Color struct{ R, G, B int }

func main() {
    c := Color{255, 0, 0}
    fmt.Println(c)
}

L'interface Stringer

L'interface fmt.Stringer possède une méthode :

String() string

Tout type qui la définit contrôle la manière dont il apparaît lors de l'affichage.

package main

import "fmt"

type Greeting struct{ Name string }

func (g Greeting) String() string {
    return "Hello, " + g.Name
}

func main() {
    fmt.Println(Greeting{"Ada"})
}

Utilisé automatiquement

Lorsqu'un type possède une méthode String(), Println, Printf avec %v ou %s, ainsi que les fonctions apparentées, l'appellent automatiquement.

package main

import "fmt"

type Greeting struct{ Name string }

func (g Greeting) String() string {
    return "Hi " + g.Name
}

func main() {
    g := Greeting{"Bob"}
    fmt.Printf("%s and %v\n", g, g)
}

Formatage dans String()

Construisez le résultat avec fmt.Sprintf pour produire une représentation claire et personnalisée.

package main

import "fmt"

type Color struct{ R, G, B int }

func (c Color) String() string {
    return fmt.Sprintf("rgb(%d, %d, %d)", c.R, c.G, c.B)
}

func main() {
    fmt.Println(Color{255, 128, 0})
}

Stringer sur des types nommés

Stringer ne sert pas uniquement aux structures. Tout type nommé, même fondé sur int, peut l'implémenter. C'est le modèle classique des énumérations.

package main

import "fmt"

type Day int

func (d Day) String() string {
    names := []string{"Mon", "Tue", "Wed"}
    return names[d]
}

func main() {
    fmt.Println(Day(1))
}

Des énumérations bien affichées

Combinez iota avec Stringer afin que les constantes s'affichent sous forme de noms lisibles plutôt que de nombres.

package main

import "fmt"

type State int

const (
    Idle State = iota
    Running
    Done
)

func (s State) String() string {
    return []string{"Idle", "Running", "Done"}[s]
}

func main() {
    fmt.Println(Running)
}

Récepteur par valeur ou par pointeur

Si String() utilise un récepteur par valeur, les valeurs comme les pointeurs s'affichent correctement. Avec un récepteur par pointeur, seuls les pointeurs le déclenchent.

package main

import "fmt"

type Tag struct{ Name string }

func (t Tag) String() string { return "#" + t.Name }

func main() {
    t := Tag{"go"}
    fmt.Println(t)
    fmt.Println(&t)
}

Éviter la récursion infinie

N'appelez jamais fmt.Sprintf("%v", t) sur le même type à l'intérieur de son propre String(). Cela rappelle String() indéfiniment. Formatez directement les champs.

package main

import "fmt"

type Money struct{ Cents int }

func (m Money) String() string {
    return fmt.Sprintf("$%.2f", float64(m.Cents)/100)
}

func main() {
    fmt.Println(Money{1050})
}

Stringer dans les tranches

Lorsque vous affichez une tranche de valeurs Stringer, chaque élément est formaté avec sa méthode String().

package main

import "fmt"

type Tag struct{ Name string }

func (t Tag) String() string { return "#" + t.Name }

func main() {
    tags := []Tag{{"go"}, {"web"}}
    fmt.Println(tags)
}

L'utiliser comme interface

Vous pouvez stocker n'importe quelle valeur Stringer dans une variable fmt.Stringer et appeler String() au travers de l'interface.

package main

import "fmt"

type City struct{ Name string }

func (c City) String() string { return "City of " + c.Name }

func main() {
    var s fmt.Stringer = City{"Oslo"}
    fmt.Println(s.String())
}

Pourquoi est-ce important ?

Implémenter Stringer donne à vos types un affichage clair partout où ils sont affichés ou journalisés, sans code de formatage supplémentaire à chaque endroit d'appel.

package main

import "fmt"

type Temp float64

func (t Temp) String() string {
    return fmt.Sprintf("%.1f°C", float64(t))
}

func main() {
    fmt.Println(Temp(21.5))
}

Vérification rapide

Quelle méthode un type doit-il définir pour satisfaire fmt.Stringer ?

Récapitulatif : l'interface Stringer

Vous avez appris à personnaliser l'affichage :

Implémentez String() string pour satisfaire fmt.Stringer.
fmt l'appelle automatiquement pour %v et %s.
C'est très utile pour les énumérations ; évitez d'utiliser %v de manière récursive sur le même type.

package main

import "fmt"

type Level int

func (l Level) String() string {
    return []string{"low", "mid", "high"}[l]
}

func main() {
    fmt.Println(Level(2))
}

Questions Fréquemment Posées

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

Oui — le texte complet de « L’interface Stringer » 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 Stringer » ?

Personnaliser l’affichage des types 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 3 sur 4.

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

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