Розширений `fmt`

Пакет fmt є шлюзом до всього текстового вводу-виводу в Go. Добре знати це означає писати читабельні журнали, інформаційні помилки та форматувати значення ідіоматично, не звертаючись до зовнішніх бібліотек.

Чотири родини

fmt розкриває функції чотирьох сімейств, що відрізняються префіксом:

• Print* → пише до os.Stdout (Print, Println, Printf).
• Fprint* → пише до будь-якого io.Writer (Fprintln(os.Stderr, ...), Fprintf(file, ...)).
• Sprint* → повертає рядок без друку (Sprintf, Sprintln).
• Errorf → створює відформатований error.

fmt.Println("hello")                       // stdout
fmt.Fprintln(os.Stderr, "boom")            // stderr
s := fmt.Sprintf("[%d]", 42)               // "[42]"
err := fmt.Errorf("parse %q: %w", in, base) // wrapped error

Різниця між Print та Println полягає лише в пробілі між аргументами та кінцевим символом нового рядка: Println завжди додає \n, Print ні, Printf відповідає формату.

Основні дієслова

type Point struct{ X, Y int }
p := Point{1, 2}
fmt.Printf("%v\n", p)   // {1 2}
fmt.Printf("%+v\n", p)  // {X:1 Y:2}
fmt.Printf("%#v\n", p)  // main.Point{X:1, Y:2}
fmt.Printf("%T\n", p)   // main.Point

Ширина, точність, прапори

Числові та рядкові дієслова приймають ширину і точність:

• %6d → мінімальна ширина 6, заповнення зліва пробілами.
• %-6d → ширина 6, відступ справа (прапорець -).
• %06d → ширина 6, доповнення 0 (прапорець 0).
• %.2f → точність 2 цифри після коми.
• %8.2f → ширина 8, точність 2.

fmt.Printf("|%6d|\n", 42)    // |    42|
fmt.Printf("|%-6d|\n", 42)   // |42    |
fmt.Printf("|%06d|\n", 42)   // |000042|
fmt.Printf("|%8.2f|\n", 3.14)// |    3.14|

Для вирівняних таблиць фіксована ширина + %-...s для текстових стовпців є найпростішим шаблоном перед переходом до text/tabwriter.

%w та упаковка помилок

%w є особливим: він працює тільки всередині fmt.Errorf і зберігає початкову помилку в ланцюжку, щоб errors.Is і errors.As могли пройти його.

if _, err := os.Open(path); err != nil {
    return fmt.Errorf("read config %q: %w", path, err)
}

Використання %v замість %w друкує повідомлення про помилку, але розриває ланцюжок: немає розгортання, немає errors.Is. Правило: якщо ви хочете, щоб абонент міг розрізнити тип або ідентичність помилки, використовуйте %w (лише один на Errorf).

вправи

err := fmt.Errorf("read %q: ???", path, base)