Jak działają funkcje i wielokrotne wartości zwracane w Go?

Question

Accepted Answer

Funkcje Go są deklarowane za pomocą `func`, a charakterystyczną cechą jest **wielokrotne wartości zwracane** — funkcja może zwrócić kilka wartości jednocześnie. Jest to powszechnie używane, zwłaszcza dla idiomatu `(result, error)`, który definiuje obsługę błędów w Go.

## Podstawowa funkcja

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

## Wielokrotne wartości zwracane — definiująca cecha

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

Zwracanie `(value, error)` jest IDIOTEMEM obsługi błędów w Go — zamiast wyjątków funkcje zwracają błędy jako wartości, które wywołujący jawnie sprawdzają. Dzięki temu obsługa błędów jest widoczna i niemożliwa do cichego zignorowania.

## Wzór 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
```

## Nazwane wartości zwracane

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

## Funkcje variadyczne

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

## Funkcje są obiektami pierwszej klasy

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

## Dlaczego to ważne

Funkcje Go są centralne, a **wielokrotne wartości zwracane** są jedną z cech definiujących język — umożliwiają idiom `(result, error)`, który *jest* podejściem Go do obsługi błędów (jawne sprawdzanie błędów jako wartości zamiast wyjątków).

Ten wzór, używany praktycznie w każdym programie Go, czyni obsługę błędów widoczną i celową.

Pokrewny idiom comma-ok (`value, ok :=`) pojawia się wszędzie (dostęp do mapy, asercje typów, odbiera kanału).

Zrozumienie wielokrotnych wartości zwracanych, wzoru błędu, nazwanych wartości zwracanych, funkcji variadycznych i obiektów pierwszej klasy jest niezbędne do czytania i pisania idiomatycznego Go — a filozofia error-as-value jest jedną z najważniejszych różnic koncepcyjnych między Go a językami opartymi na wyjątkach.