Chapter 6: Errors

Introduksyon

Ayaw kagahâ, bai. Ang pag-handle ug error sa Go kay diretso ra — dili parehas sa ubang languages nga mag-throw-throw ug exception nga murag nagdulaag hot potato. Sa Go, ang error kay value lang. Normal ra. Anhi nga chapter, atong tan-awon ang error types, how to make 'em, panic, recover, ug unsay dapat buhaton para di ka mag-crash ug binuang.

Unsa ang Errors?

Ang error kay — sa simple terms — kung may unexpected nga nahitabo. Invalid input, network failure, missing files, imong ex nagparamdam. Sa Go, ang errors kay values ra gyud, parehas sa integers, strings, ug sa uban. Nag-implementar lang sila sa error interface.

Syntax Errors

Ang syntax errors kay nadakpan daan sa compile time — murag wala ka naka-agi ug assignment kay sayop spelling. Dili jud mag-compile ang code. Pananglitan: nakalimot kag brace, typo sa keywords:

// Dili mag-compile:
func main() {
    fmt.Println("Hello"  // wala ang closing parenthesis
}

Runtime Errors

Runtime errors kay mahitabo samtang nagdagan na ang program — dili parehas sa imong lovelife na wala jud nagsugod. Division by zero, nil pointer dereference, out-of-bounds access. Usually mag-cause ni ug panic. Ug ang panic sa Go kay parehas sa imong reaction kung makakita kag username na "admin" sa production.

Exercise 6.01: Runtime Errors

Goal: I-trigger ang integer overflow ug tan-awa ang resulta.

package main

import "fmt"

func main() {
    var x uint8 = 255
    x += 1
    fmt.Println("wrapped:", x)  // 0
}

Semantic Errors

Semantic errors (a.k.a. logic errors) — ang king sa tanang sakit sa ulo. Nag-compile, nag-run, mukalit lang ug "bai, sayop man ni." Way error message, way crash. Kani pinakalisod kay murag tubag sa imang crush — nag-exist pero wa ka kibaw kung unsa:

func average(a, b int) int {
    return a + b / 2  // sayop: division mas una
}

Exercise 6.02: Logic Error sa Walking Distance

Goal: Pangitaa ug ayoha ang bug sa walking distance calculator.

// Buggy:
func walkingDistance(steps int, stride float64) float64 {
    return steps * stride * 100  // sayop
}

// Fixed:
func walkingDistance(steps int, stride float64) float64 {
    return steps * stride / 1000
}

Error Handling sa Ubang Languages

Dili parehas sa Java nga naay checked exceptions o Python nga try/except — sa Go, i-return lang ang error as value. Klaro kaayo. Wala nang "hala naay exception" nga kalit2. Check lang ug if err != nil. Simple. Di nang magtago2 ang error.

Error Interface Type

Ang error interface kay built-in sa Go — wala nang i-install2:

type error interface {
    Error() string
}

Basta ang imong type naay Error() string method, aw, error na siya. Automatic. Walay pila:

f, err := os.Open("file.txt")
if err != nil { log.Fatal(err) }

Paghimog Error Values

Paghimo ug error values kay sayon ra. Gamit ug errors.New or fmt.Errorf — parehas rag nag-order sa Jollibee, naay daghan choices:

import "errors"
var ErrNotFound = errors.New("wala nakit-i")

err := fmt.Errorf("user %d not found", id)

// Wrapping (Go 1.13+)
return fmt.Errorf("processing order: %w", err)

Exercise 6.03: Weekly Pay Calculator

Goal: Sulat ug function na magbalik ug error kung negative or >80 hours.

package main

import (
    "errors"
    "fmt"
)

func weeklyPay(hours, rate float64) (float64, error) {
    if hours < 0 { return 0, errors.New("negative hours") }
    if hours > 80 { return 0, errors.New("over 80 hours") }
    return hours * rate, nil
}

func main() {
    pay, err := weeklyPay(40, 25)
    if err != nil { fmt.Println("Error:", err)
    } else { fmt.Printf("Pay: $%.2f\n", pay) }
}

Panic

Ang panic kay Go version sa "na-short circuit ang utok." Mohunong ang execution, mag-unwind sa stack, mag-run sa deferred functions. Murag nangatulog ka sa imong code:

func main() {
    panic("may na sayop jud")
}

Pero seryoso, gamita lang panic kung grabe jud — unexpected conditions na walay lain mahimo. Sa library code, ayaw pag-panic. Mag-return ug error. Dili ta hilig ug drama.

Exercise 6.04: Panic on Errors

Goal: Gamit ug panic kung wala'y configuration value.

package main

import "fmt"

func loadConfig(key string) string {
    config := map[string]string{"host": "localhost"}
    val, ok := config[key]
    if !ok { panic("missing config: " + key) }
    return val
}

func main() {
    fmt.Println(loadConfig("host"))
    fmt.Println(loadConfig("port"))  // panics
}

Recover

Ang recover kay para makuha nimo ang control balik sa panicking goroutine. Parehas rag nag "time out" ka sa inyong argument tas nibalik ka para mangayo ug sorry. Pero sa deferred function lang ni pwede — walay laing paagi:

func safeDivide(a, b int) (result int) {
    defer func() {
        if r := recover(); r != nil {
            fmt.Println("nakuha:", r)
            result = 0
        }
    }()
    return a / b
}

func main() {
    fmt.Println(safeDivide(10, 0))  // 0, dili mag-crash
    fmt.Println("nag-continue pa...")
}

Exercise 6.05: Recover from Panic

Goal: I-access ang slice by index ug i-recover kung out-of-bounds.

package main

import "fmt"

func safeGet(s []int, index int) (val int) {
    defer func() {
        if r := recover(); r != nil {
            fmt.Println("nakuha:", r)
            val = -1
        }
    }()
    return s[index]
}

func main() {
    nums := []int{10, 20, 30}
    fmt.Println(safeGet(nums, 1))  // 20
    fmt.Println(safeGet(nums, 5))  // -1
}

Guidelines sa Errors ug Panic

Activity 6.01: Custom Error para sa Banking

package main

import "fmt"

type InsufficientFundsError struct {
    Balance, Withdrawal float64
}

func (e InsufficientFundsError) Error() string {
    return fmt.Sprintf("dili maka-withdraw ng $%.2f — $%.2f ra ang balance",
        e.Withdrawal, e.Balance)
}

func withdraw(balance, amount float64) (float64, error) {
    if amount > balance { return 0, InsufficientFundsError{balance, amount} }
    return balance - amount, nil
}

func main() {
    _, err := withdraw(100, 150)
    if err != nil { fmt.Println(err) }
}

Activity 6.02: Direct Deposit Validation

package main

import (
    "errors"
    "fmt"
    "unicode"
)

func validateDeposit(account, routing string) error {
    if len(account) != 10 { return errors.New("10 digits dapat ang account") }
    if len(routing) != 9 { return errors.New("9 digits dapat ang routing") }
    for _, c := range account + routing {
        if !unicode.IsDigit(c) { return errors.New("digits lang dapat") }
    }
    return nil
}

func main() {
    err := validateDeposit("1234567890", "123456789")
    if err != nil { fmt.Println(err) } else { fmt.Println("valid") }
}

Activity 6.03: Panic sa Invalid Data

package main

import "fmt"

func register(name string, age int) {
    if age < 0 { panic("impossible age: " + fmt.Sprint(age)) }
    fmt.Println("Registered", name)
}

func main() {
    register("Alice", 30)
    register("Bob", -5)  // panics
}

Activity 6.04: Prevent Panic Crash

package main

import (
    "errors"
    "fmt"
)

func register(name string, age int) (err error) {
    defer func() {
        if r := recover(); r != nil {
            err = fmt.Errorf("na-panic: %v", r)
        }
    }()
    if name == "" { return errors.New("name required") }
    if age < 0 { panic("impossible age") }
    fmt.Println("Registered", name)
    return nil
}

func main() {
    fmt.Println(register("Alice", 30))
    fmt.Println(register("Bob", -5))
    fmt.Println("Nag-continue ang app...")
}

Summary