`fmt` nâng cao

Gói fmt là cổng vào tất cả I/O văn bản trong Go. Biết rõ về nó có nghĩa là viết nhật ký có thể đọc được, các lỗi thông tin và định dạng các giá trị một cách thành ngữ mà không cần dùng đến các thư viện bên ngoài.

Bốn gia đình

fmt hiển thị các hàm trong bốn họ, được phân biệt bằng tiền tố:

• Print* → viết vào os.Stdout (Print, Println, Printf).
• Fprint* → ghi vào io.Writer bất kỳ (Fprintln(os.Stderr, ...), Fprintf(file, ...)).
• Sprint* → trả về chuỗi không in (Sprintf, Sprintln).
• Errorf → tạo một error được định dạng.

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

Sự khác biệt giữa Print và Println chỉ là khoảng cách giữa các đối số và dòng mới ở cuối: Println luôn thêm \n, Print không, Printf tuân theo định dạng.

Động từ chính

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

Chiều rộng, độ chính xác, cờ

Động từ dạng số và chuỗi chấp nhận độ rộng và độ chính xác:

• %6d → chiều rộng tối thiểu 6, phần đệm bên trái có khoảng trắng.
• %-6d → chiều rộng 6, phần đệm bên phải (cờ -).
• %06d → chiều rộng 6, đệm bằng 0 (cờ 0).
• %.2f → độ chính xác 2 chữ số thập phân.
• %8.2f → chiều rộng 8, độ chính xác 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|

Đối với các bảng đã căn chỉnh, chiều rộng cố định + %-...s cho cột văn bản là mẫu đơn giản nhất trước khi chuyển sang text/tabwriter.

%w và gói lỗi

%w rất đặc biệt: nó chỉ hoạt động bên trong fmt.Errorf và giữ nguyên lỗi ban đầu trong chuỗi, để errors.Is và errors.As có thể thực hiện được.

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

Sử dụng %v thay vì %w in thông báo lỗi nhưng làm đứt chuỗi: không mở gói, không errors.Is. Quy tắc: nếu bạn muốn người gọi có thể phân biệt loại hoặc nhận dạng lỗi, hãy sử dụng %w (chỉ một lỗi cho mỗi Errorf).

Bài tập

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