Как работают функции и множественные возвращаемые значения в Go?

Question

Accepted Answer

Функции Go объявляются с помощью `func`, а отличительной особенностью является **множественные возвращаемые значения** — функция может возвращать несколько значений одновременно. Это широко используется, особенно для идиомы `(result, error)`, которая определяет обработку ошибок в Go.

## Базовая функция

```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
```

## Множественные возвращаемые значения — отличительная особенность

```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)
```

Возврат `(value, error)` — это ИДИОМА для обработки ошибок в Go — вместо исключений функции возвращают ошибки как значения, которые вызывающие явно проверяют. Это делает обработку ошибок видимой и невозможной для беззвучного игнорирования.

## Паттерн 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
```

## Именованные возвращаемые значения

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

## Вариативные функции

```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
```

## Функции являются объектами первого класса

```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
```

## Почему это важно

Функции Go являются центральными, а **множественные возвращаемые значения** — одной из определяющих особенностей языка — они обеспечивают идиому `(result, error)`, которая *является* подходом Go к обработке ошибок (явная проверка ошибок как значений вместо исключений).

Этот паттерн, используемый практически в каждой программе Go, делает обработку ошибок видимой и преднамеренной.

Связанная идиома comma-ok (`value, ok :=`) встречается повсеместно (доступ к карте, утверждения типов, получение из канала).

Понимание множественных возвращаемых значений, паттерна ошибок, именованных возвращаемых значений, вариативных функций и объектов первого класса необходимо для чтения и написания идиоматичного Go — и философия error-as-value является одним из самых важных концептуальных различий между Go и языками, основанными на исключениях.