Интерфейс fmt.Stringer

Часть раздела Объектно-ориентированное программирование путешествия по GO на Coddy — урок 75 из 107.

Интерфейс fmt.Stringer управляет тем, как ваши типы отображаются при выводе на печать. Это один из наиболее часто реализуемых интерфейсов в Go, определенный в пакете fmt:

type Stringer interface {
    String() string
}

Когда вы передаете значение в fmt.Println, fmt.Printf с %v или аналогичные функции, Go проверяет, реализует ли тип Stringer. Если да, Go вызывает метод String() для получения текстового представления.

type Temperature struct {
    Celsius float64
}

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

func main() {
    temp := Temperature{Celsius: 23.5}
    fmt.Println(temp)  // 23.5°C
}

Без метода String() вывод будет отображать формат структуры по умолчанию: {23.5}. Реализуя Stringer, вы точно контролируете то, как ваш тип представляет себя.

Это особенно полезно для типов, в которых необработанные значения полей не передают смысл четко. Тип Duration может отображаться как "2h 30m" вместо показа необработанных наносекунд, или тип User может показывать отформатированное имя вместо всех его полей.

Задание

Легко

Давайте создадим систему учета времени, которая отображает длительность в удобном для человека формате! Вы реализуете интерфейс fmt.Stringer, чтобы управлять тем, как ваши пользовательские типы выглядят при выводе на печать.

Вы организуете свой код в двух файлах:

duration.go: Определите типы, связанные со временем, с пользовательскими строковыми представлениями.
Создайте структуру Duration, которая хранит общее количество минут в виде целого числа. Реализуйте метод String() так, чтобы при печати он отображался в читаемом формате, например 2h 30m для 150 минут или 0h 45m для 45 минут. Часы и минуты должны отображаться всегда.

Создайте структуру Task с полями Name (string) и Time (Duration). Реализуйте String() для Task, чтобы отображать данные в формате [Name]: [duration], где длительность использует свой собственный метод String.
main.go: Создавайте и отображайте задачи с их длительностью.
Считайте количество задач, затем для каждой задачи считайте её название и длительность в минутах. Создайте экземпляры Task и напечатайте каждый из них напрямую с помощью fmt.Println — интерфейс Stringer автоматически позаботится о форматировании.

После вывода всех задач вычислите и напечатайте общее время всех задач в формате:
```
Total: [duration]
```

Будут предоставлены следующие входные данные:

Строка 1: Количество задач
Следующие строки: Название задачи и минуты (две строки на задачу)

Например, для входных данных:

3
Code Review
90
Meeting
45
Documentation
120

Ваш вывод должен быть таким:

Code Review: 1h 30m
Meeting: 0h 45m
Documentation: 2h 0m
Total: 4h 15m

И для входных данных:

2
Design
180
Testing
65

Ваш вывод должен быть таким:

Design: 3h 0m
Testing: 1h 5m
Total: 4h 5m

Благодаря реализации Stringer ваши типы легко интегрируются с функциями печати Go. Вместо того чтобы видеть необработанные поля структуры, такие как {90}, вы получаете осмысленный вывод, понятный пользователям.

Шпаргалка

Интерфейс fmt.Stringer управляет тем, как типы отображаются при выводе на печать:

type Stringer interface {
    String() string
}

Когда вы передаете значение в fmt.Println или fmt.Printf с использованием %v, Go проверяет, реализует ли тип интерфейс Stringer. Если да, Go вызывает метод String() для получения текстового представления.

Пример реализации:

type Temperature struct {
    Celsius float64
}

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

func main() {
    temp := Temperature{Celsius: 23.5}
    fmt.Println(temp)  // 23.5°C
}

Без метода String() при печати будет отображаться формат структуры по умолчанию: {23.5}. Реализуя Stringer, вы точно контролируете, как ваш тип представляет себя, делая вывод более осмысленным и удобным для пользователя.

Попробуйте сами

package main

import (
	"bufio"
	"fmt"
	"os"
	"strconv"
	"strings"
)

func main() {
	reader := bufio.NewReader(os.Stdin)

	// Прочитать количество задач
	line, _ := reader.ReadString('\n')
	numTasks, _ := strconv.Atoi(strings.TrimSpace(line))

	// TODO: Создать слайс для хранения задач
	// TODO: Отслеживать общее количество минут

	for i := 0; i < numTasks; i++ {
		// Прочитать название задачи
		name, _ := reader.ReadString('\n')
		name = strings.TrimSpace(name)

		// Прочитать длительность задачи в минутах
		minutesLine, _ := reader.ReadString('\n')
		minutes, _ := strconv.Atoi(strings.TrimSpace(minutesLine))

		// TODO: Создать Task с именем и Duration
		// TODO: Вывести задачу (fmt.Println будет использовать интерфейс Stringer)
		// TODO: Добавить минуты к общему количеству
		_ = name
		_ = minutes
	}

	// TODO: Вывести общую длительность в формате "Total: Xh Ym"
}