ExpertiDict

Go · Essencial · Português · Técnico

retorno múltiplo

/ʁe.ˈtoʁ.nu ˈmuw.ʧi.plu/substantivo

Capacidade de uma função devolver mais de um valor. É a base do tratamento de erros em Go: o resultado vem junto com um error.

Onde usar

Em 'data, err := os.ReadFile(p)', quase toda função que pode falhar retorna (valor, error). O chamador decide logo em seguida o que fazer com o erro.

Em código

func div(a, b int) (int, error) {
  if b == 0 {
    return 0, errors.New("div por zero")
  }
  return a / b, nil
}
q, err := div(6, 3)
fmt.Println(q, err)

Exemplos

Em Go o retorno múltiplo substitui as exceções na maioria dos casos.

Essa função devolve o valor e o erro, é o retorno múltiplo de sempre.

Cuidado

Não é uma tupla: não dá para guardar os retornos numa única variável, é preciso receber cada um separadamente.

Sinônimos

múltiplos valores de retorno

Veja também

Todos os termos de Go