Como funções e múltiplos valores de retorno funcionam em Go?

Question

Accepted Answer

Funções Go são declaradas com `func`, e uma característica distintiva é **múltiplos valores de retorno** — uma função pode retornar vários valores de uma vez. Isso é usado extensivamente, especialmente para o idiom `(result, error)` que define o tratamento de erros do Go.

## Função básica

```go
func add(a int, b int) int {     // params with types, then the return type
    return a + b
}

func greet(name string) string {
    return "Hello, " + name
}
// shorthand for same-typed params: func add(a, b int) int
```

## Múltiplos valores de retorno — a característica definidora

```go
func divide(a, b int) (int, error) {     // returns BOTH a result AND an error
    if b == 0 {
        return 0, errors.New("division by zero")
    }
    return a / b, nil    // nil error = success
}

// callers handle both — the ubiquitous Go error pattern
result, err := divide(10, 2)
if err != nil {
    log.Fatal(err)       // handle the error
}
fmt.Println(result)
```

Retornar `(value, error)` é O idiom para tratamento de erros em Go — em vez de exceções, funções retornam erros como valores que os chamadores verificam explicitamente. Isso torna o tratamento de erros visível e impossível de ignorar silenciosamente.

## O padrão comma-ok

```go
// many built-ins return (value, ok) — a boolean for "did it work?"
value, ok := myMap["key"]   // ok = false if the key is missing
if ok { ... }

v, ok := someInterface.(string)   // type assertion with ok
```

## Valores de retorno nomeados

```go
func split(sum int) (x, y int) {   // named returns
    x = sum * 4 / 9
    y = sum - x
    return   // "naked return" — returns the named values
}
```

## Funções variádicas

```go
func sum(nums ...int) int {     // accepts any number of ints
    total := 0
    for _, n := range nums {
        total += n
    }
    return total
}
sum(1, 2, 3)          // 6
sum(nums...)          // spread a slice into args
```

## Funções são cidadãs de primeira classe

```go
var op func(int, int) int = add   // assign functions to variables
func apply(fn func(int) int, x int) int { return fn(x) }  // pass as arguments
```

## Por que isso importa

Funções Go são centrais, e **múltiplos valores de retorno** são uma das características definidoras da linguagem — elas habilitam o idiom `(result, error)` que *é* a abordagem de Go para tratamento de erros (verificação explícita de erro como valor em vez de exceções).

Este padrão, usado em praticamente todos os programas Go, torna o tratamento de erros visível e deliberado.

O idiom comma-ok relacionado (`value, ok :=`) aparece em toda parte (acesso a mapa, asserções de tipo, recebimentos de canal).

Compreender múltiplos retornos, o padrão de erro, retornos nomeados, funções variádicas e funções cidadãs de primeira classe é essencial para ler e escrever Go idiomático — e a filosofia error-as-value é uma das diferenças conceituais mais importantes entre Go e linguagens baseadas em exceções.