Lección 4 de 36 · De PHP a Go✦ WebMCP implementado
Funciones: varios retornos y variádicas
9 min de lectura4 retos
Las funciones de Go se parecen mucho a las de PHP con tipos, con dos superpoderes: pueden devolver varios valores a la vez y así avisan de los errores sin excepciones. En esta lección escribes funciones, devuelves resultado y error, recibes cualquier número de argumentos y pasas funciones como si fueran datos.
¿De dónde vienen los nombres?
func = function (función)
La palabra para declarar una función. En PHP es function; Go la acorta.
nil = Del latín nihil (nada)
El «no hay nada» de Go: lo usa, por ejemplo, un error cuando no hubo error. Es el null de PHP.
err = error
No es una palabra del lenguaje, solo el nombre que todo el mundo da a la variable del error. Úsalo tú también.
En 4 ideas
1/4
Los tipos van detrás del nombre: func Etiqueta(titulo string, hecha bool) string. En PHP van delante: function etiqueta(string $titulo, bool $hecha): string.
Una función puede devolver varios valores: return titulo, nil. En PHP devolverías un array [$titulo, null] o lanzarías una excepción.
El último valor suele ser un error: nil si todo fue bien. Quien llama lo comprueba con if err != nil, en vez del try/catch de PHP.
...int recibe cualquier número de argumentos y lista... los reparte al llamar, igual que ...$minutos en PHP.
1 · Declarar una función
Una función es una receta: le das ingredientes (los parámetros), hace su trabajo y te devuelve un plato (el resultado). En Go los tipos se escriben siempre, y van detrás del nombre.
package main
import"fmt"// Etiqueta pinta una tarea como «[x] Comprar pan».funcEtiqueta(titulo string, hecha bool) string {
marca := " "if hecha {
marca = "x"
}
return"[" + marca + "] " + titulo
}
// Si varios parámetros seguidos son del mismo tipo,// el tipo se escribe una sola vez.funcProgreso(hechas, total int) string {
return fmt.Sprintf("%d/%d", hechas, total)
}
funcmain() {
fmt.Println(Etiqueta("Comprar pan", true))
fmt.Println(Progreso(3, 4))
}
El tipo del resultado va después de los paréntesis, sin los dos puntos de PHP: ) string {.
Sin resultado, no se escribe nada: func main() {. Es el : void de PHP.
Si prometes un resultado, tienes que devolverlo en todos los caminos. Si un camino se queda sin return, el compilador dice missing return.
Go no tiene el operador ?:. Se escribe con un if, como en Etiqueta.
¿Por qué? · En PHP no existe
¿Por qué no hay valores por defecto ni argumentos con nombre? En PHP los uso a diario
En PHP puedes escribir function crear(string $titulo, int $prioridad = 1) y llamarla como crear(titulo: "pan"). Go no tiene ni lo uno ni lo otro, ni dos funciones con el mismo nombre y distintos parámetros.
La idea es que al leer una llamada sepas exactamente qué pasa, sin ir a mirar la declaración. Crear("pan", 1) dice todo lo que recibe. Cuando una función necesita muchas opciones, en Go se le pasa un struct con campos (lo verás en el módulo 04), que hace el mismo papel que los argumentos con nombre y se lee igual de claro.
2 · Devolver varios valores
En PHP una función devuelve una cosa. Si quieres dos, las metes en un array y las sacas con [$a, $b] = …. En Go puedes devolver varias directamente, como quien te da el cambio y el tique a la vez:
Gomain.go
package main
import"fmt"// Reparte divide los minutos entre las tareas:// devuelve los minutos de cada una y los que sobran.funcReparte(minutos, tareas int) (int, int) {
return minutos / tareas, minutos % tareas
}
funcmain() {
// En PHP: [$cada, $sobran] = reparte(100, 3);
cada, sobran := Reparte(100, 3)
fmt.Println("Cada tarea:", cada, "minutos. Sobran:", sobran)
// Si un valor no te interesa, va a la papelera _
_, resto := Reparte(50, 4)
fmt.Println("Sobran:", resto)
}
El uso estrella de esto es avisar de errores. La función devuelve el resultado y, al final, un valor de tipo error. Si todo fue bien, el error es nil (nada). Si algo falló, el error dice qué.
package main
import (
"errors""fmt""strings"
)
// ValidaTitulo limpia el título y avisa si queda vacío.funcValidaTitulo(titulo string) (string, error) {
titulo = strings.TrimSpace(titulo)
if titulo == "" {
// En PHP: throw new InvalidArgumentException(...)return"", errors.New("el título está vacío")
}
// nil: no hubo errorreturn titulo, nil
}
funcmain() {
for _, entrada := range []string{" Comprar pan ", " "} {
titulo, err := ValidaTitulo(entrada)
if err != nil {
fmt.Println("Error:", err)
continue
}
fmt.Println(titulo)
}
}
¿Por qué? · En PHP no existe
¿Por qué devolver el error en vez de lanzar una excepción? En PHP existe try/catch
Una excepción en PHP es un salto invisible: sale de la función y vuela hasta el catch que la atrape, que puede estar muy lejos… o no existir. Mirando validaTitulo($x) no sabes si puede fallar; tienes que leer su código o confiar en el PHPDoc.
En Go el error está en la firma: (string, error) te dice a gritos «esto puede fallar». Y como el resultado viene con el error al lado, lo normal es tratarlo justo ahí, con if err != nil. Es más código, pero el camino del fallo se ve tan claro como el camino bueno.
Lo verás a fondo en el módulo 06, donde se crean errores propios como ErrTareaNoEncontrada.
3 · Resultados con nombre
Puedes ponerles nombre a los resultados. Nacen como variables con su valor cero y un return a secas devuelve lo que valgan en ese momento:
Gomain.go
// Reparte, ahora con los resultados con nombre:// cada y sobran nacen valiendo 0.funcReparte(minutos, tareas int) (cada, sobran int) {
cada = minutos / tareas
sobran = minutos % tareas
// return a secas: devuelve cada y sobranreturn
}
4 · Funciones variádicas: cualquier número de argumentos
Una función variádica acepta tantos argumentos como quieras, como una bolsa de la compra donde caben dos cosas o veinte. Se escribe ... delante del tipo del último parámetro. Dentro, los argumentos llegan juntos en una lista (un slice, que verás a fondo en el módulo 02) y se recorren con for … range (lo verás en la próxima lección).
PHP 8.5total.php
<?phpdeclare(strict_types=1);
functiontotalMinutos(int ...$minutos): int
{
returnarray_sum($minutos);
}
echototalMinutos() . PHP_EOL;
echototalMinutos(10, 20, 30) . PHP_EOL;
// Repartir un array como argumentos$hoy = [15, 45];
echototalMinutos(...$hoy) . PHP_EOL;
Gomain.go
package main
import"fmt"// TotalMinutos suma las duraciones que le pases.funcTotalMinutos(minutos ...int) int {
total := 0// _ es la posición, que aquí no hace faltafor _, m := range minutos {
total += m
}
return total
}
funcmain() {
fmt.Println(TotalMinutos())
fmt.Println(TotalMinutos(10, 20, 30))
// Repartir una lista como argumentos: los ... van DETRÁS// En PHP: totalMinutos(...$hoy)
hoy := []int{15, 45}
fmt.Println(TotalMinutos(hoy...))
}
Ya conoces una función variádica: fmt.Println recibe cuantos valores le pases. Por eso fmt.Println("Tarea", titulo, prioridad) funciona con tres argumentos y con diez.
5 · Funciones como valores
En Go una función es un valor más: puedes guardarla en una variable o pasársela a otra función. Es como darle a alguien una receta en vez de un plato: él decide cuándo cocinarla. En PHP 8.1+ lo haces con el first-class callablestrtoupper(...).
Gomain.go
package main
import (
"fmt""strings"
)
// AplicaATitulo recibe una función y la usa sobre el título.// func(string) string es el TIPO: «función que recibe un string y devuelve un string».funcAplicaATitulo(titulo string, f func(string) string) string {
returnf(titulo)
}
funcmain() {
// En PHP: $mayusculas = strtoupper(...);
mayusculas := strings.ToUpper
fmt.Println(mayusculas("comprar pan"))
fmt.Println(AplicaATitulo(" repasar go ", strings.TrimSpace))
fmt.Println(AplicaATitulo("llamar al banco", strings.ToUpper))
}
El tipo de una función se escribe con sus parámetros y su resultado: func(string) string. Las funciones anónimas que «recuerdan» variables (los closures, el function () use ($x) de PHP) tienen su propia lección en el módulo 06.
Hora de practicar
Retos · 0/4 resueltos
Reto 1 de 4 · ✓ Resuelto
Marca de hecha
Completa Etiqueta(titulo string, hecha bool) string para que devuelva [x] <titulo> si la tarea está hecha y [ ] <titulo> (con un espacio entre los corchetes) si no lo está. Por ejemplo, Etiqueta("Comprar pan", true) devuelve [x] Comprar pan. En PHP sería "[" . ($hecha ? "x" : " ") . "] {$titulo}".
Al pulsar Comprobar, unos tests ocultos prueban tu código con el compilador oficial de Go.
Gomain.go · editable
Pista. Go no tiene ?:. Crea marca := " " y cámbiala a "x" dentro de un if hecha { … }.
Reto 2 de 4 · ✓ Resuelto
Pendientes y porcentaje
Completa Resumen(hechas, total int) (int, int), que devuelve dos valores: cuántas tareas quedan pendientes y el porcentaje hecho como entero (redondeando hacia abajo). Resumen(3, 4) devuelve 1, 75. Si total es 0, devuelve 0, 0. En PHP devolverías [$pendientes, $porcentaje].
Al pulsar Comprobar, unos tests ocultos prueban tu código con el compilador oficial de Go.
Gomain.go · editable
Pista. Con enteros, el orden importa: hechas * 100 / total multiplica primero (300) y divide después (75). hechas / total * 100 daría 0.
Reto 3 de 4 · ✓ Resuelto
Valida el título
Completa ValidaTitulo(titulo string) (string, error): quita los espacios de los extremos y devuelve el título limpio con nil; si queda vacío, devuelve "" y un error (el texto que quieras, con errors.New). Por ejemplo, ValidaTitulo(" pan ") devuelve "pan", nil. En PHP harías throw new InvalidArgumentException(…).
Al pulsar Comprobar, unos tests ocultos prueban tu código con el compilador oficial de Go.
Gomain.go · editable
Pista. Importa strings y errors. strings.TrimSpace es el trim() de PHP y errors.New("…") crea el error.
Reto 4 de 4 · ✓ Resuelto
Suma de duraciones
Completa la función variádica TotalMinutos(minutos ...int) int, que suma todas las duraciones que reciba: TotalMinutos(10, 20, 30) devuelve 60 y TotalMinutos() devuelve 0. Es el array_sum() de PHP con int ...$minutos.
Al pulsar Comprobar, unos tests ocultos prueban tu código con el compilador oficial de Go.
Gomain.go · editable
Pista. Recorre la lista con for _, m := range minutos { … } y ve sumando con total += m.
Resumen
Lo que te llevas de esta lección
func Nombre(param tipo) resultado con el tipo detrás (en PHP, function nombre(tipo $param): resultado).
Varios resultados con return a, b y se recogen con a, b := … (en PHP, devolver un array y [$a, $b] = …).
El error va el último y vale nil si todo fue bien: if err != nil (en PHP, throw y try/catch).
...int recibe muchos argumentos y lista... los reparte (en PHP, int ...$x y ...$lista).
Una función es un valor: se guarda y se pasa (en PHP, strtoupper(...) y el tipo callable).
Para recordarlo: «El plato y la nota»
PPlato titulo
NNota err
Una función de Go te entrega el plato (el resultado) y, al lado, una nota (el error). Si la nota está en blanco (nil), te lo comes; si trae algo escrito, lees la nota antes de tocar el plato.