`fmt` מתקדם

החבילה fmt היא השער לכל I/O טקסטואליים ב-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 הפורמט Print לא עוקב אחר הפורמט של Print.

פעלים עיקריים

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)