Go Em Exemplos: Errors

Em Go, é considerado idiomático comunicar erros via retornos separados e explícitos. Isto contrasta com exceções usadas em outras linguagens como Java e Ruby com um único resultado sobrecarregado; ou com valores de erros por vezes usado em C. O approach de Go torna muito mais fácil a verificação de que funções estão retornando erros e tratá-los usando os mesmos mecanismos empregados pela linguagem em outras tarefas não relacionadas a erros.

package main
import (
    "errors"
    "fmt"
)

Por convenção, erros são os últimos valores retornados e implementam a interface nativa erro.

func f1(arg int) (int, error) {
    if arg == 42 {

errors.New constrói um valor error básico com a mensagem de erro determinada.

        return -1, errors.New("can't work with 42")
    }

Um valor nil como último retorno de uma determinada função indica que não há nenhum erro.

    return arg + 3, nil
}

É possível usar tipos de erro customizados implementado o método Error(). Aqui está uma variante do exemplo acima que usa um tipo erro customizado para representar explicitamente um erro de argumento.

type argError struct {
    arg  int
    prob string
}
func (e *argError) Error() string {
    return fmt.Sprintf("%d - %s", e.arg, e.prob)
}
func f2(arg int) (int, error) {
    if arg == 42 {

Neste caso, pode-se utilizar a sintaxe &argError para construir uma nova struct, passando valores para os campos arg e prob.

        return -1, &argError{arg, "can't work with it"}
    }
    return arg + 3, nil
}
func main() {

Os dois loops abaixo, testam cada uma das funções que retornam erros. Note que a utilização de uma verificação de erro em linha, junto ao if é algo comum em Go.

    for _, i := range []int{7, 42} {
        if r, e := f1(i); e != nil {
            fmt.Println("f1 failed:", e)
        } else {
            fmt.Println("f1 worked:", r)
        }
    }
    for _, i := range []int{7, 42} {
        if r, e := f2(i); e != nil {
            fmt.Println("f2 failed:", e)
        } else {
            fmt.Println("f2 worked:", r)
        }
    }

É possível utilizar programaticamente os dados em um erro customizado. Será preciso capturar o erro como uma instância do tipo de erro customizado via asserção de tipo.

    _, e := f2(42)
    if ae, ok := e.(*argError); ok {
        fmt.Println(ae.arg)
        fmt.Println(ae.prob)
    }
}
$ go run errors.go
f1 worked: 10
f1 failed: can't work with 42
f2 worked: 10
f2 failed: 42 - can't work with it
42
can't work with it

Veja este post no Blog de Go para mais sobre tratamento de erros.

Próximo exemplo: Goroutines.