summaryrefslogtreecommitdiffhomepage
path: root/es-es/go-es.html.markdown
blob: c41d693d22d98fe518212d2968fdd2db54330d6c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
---
name: Go
category: language
language: Go
lang: es-es
filename: learngo-es.go
contributors:
    - ["Sonia Keys", "https://github.com/soniakeys"]
    - ["Christopher Bess", "https://github.com/cbess"]
    - ["Jesse Johnson", "https://github.com/holocronweaver"]
    - ["Quint Guvernator", "https://github.com/qguv"]
    - ["Jose Donizetti", "https://github.com/josedonizetti"]
    - ["Alexej Friesen", "https://github.com/heyalexej"]
translators:
    - ["Adrian Espinosa", "http://www.adrianespinosa.com"]
    - ["Jesse Johnson", "https://github.com/holocronweaver"]
    - ["Nacho Pacheco -- Feb/2015", "https://github.com/gitnacho"]
---

Go fue creado por la necesidad de hacer el trabajo rápidamente. No es la
última tendencia en informática, pero es la forma nueva y más rápida de
resolver problemas reales.

Tiene conceptos familiares de lenguajes imperativos con tipado estático.
Es rápido compilando y rápido al ejecutar, añade una concurrencia fácil de
entender para las CPUs de varios núcleos de hoy día, y tiene
características que ayudan con la programación a gran escala.

Go viene con una biblioteca estándar muy buena y una entusiasta comunidad.

```go
// Comentario de una sola línea
/* Comentario
   multilínea */

// La cláusula `package` aparece al comienzo de cada fichero fuente.
// `main` es un nombre especial que declara un ejecutable en vez de una
// biblioteca.
package main

// La instrucción `import` declara los paquetes de bibliotecas referidos
// en este fichero.
import (
	"fmt"      // Un paquete en la biblioteca estándar de Go.
	"io/ioutil" // Implementa algunas útiles funciones de E/S.
	m "math"   // Biblioteca de matemáticas con alias local m.
	"net/http" // Sí, ¡un servidor web!
	"strconv"  // Conversiones de cadenas.
)

// Definición de una función. `main` es especial. Es el punto de entrada
// para el ejecutable. Te guste o no, Go utiliza llaves.
func main() {
	// Println imprime una línea a stdout.
	// Cualificalo con el nombre del paquete, fmt.
	fmt.Println("¡Hola mundo!")

	// Llama a otra función de este paquete.
	másAlláDelHola()
}

// Las funciones llevan parámetros entre paréntesis.
// Si no hay parámetros, los paréntesis siguen siendo obligatorios.
func másAlláDelHola() {
	var x int // Declaración de una variable.
 	          // Las variables se deben declarar antes de utilizarlas.
	x = 3     // Asignación de variable.
	// Declaración "corta" con := para inferir el tipo, declarar y asignar.
	y := 4
	suma, producto := aprendeMúltiple(x, y) // La función devuelve dos
											// valores.
	fmt.Println("suma:", suma, "producto:", producto) // Simple salida.
	aprendeTipos()                        // < y minutos, ¡aprende más!
}

// Las funciones pueden tener parámetros y (¡múltiples!) valores de
// retorno.
func aprendeMúltiple(x, y int) (suma, producto int) {
    return x + y, x * y // Devuelve dos valores.
}

// Algunos tipos incorporados y literales.
func aprendeTipos() {
	// La declaración corta suele darte lo que quieres.
	s := "¡Aprende Go!" // tipo cadena.
	s2 := `Un tipo cadena "puro" puede incluir
saltos de línea.` // mismo tipo cadena

	// Literal no ASCII. Los ficheros fuente de Go son UTF-8.
	g := 'Σ' // Tipo rune, un alias de int32, alberga un carácter unicode.
	f := 3.14195 // float64, el estándar IEEE-754 de coma flotante 64-bit.
	c := 3 + 4i  // complex128, representado internamente por dos float64.
	// Sintaxis Var con iniciadores.
	var u uint = 7 // Sin signo, pero la implementación depende del tamaño
	               // como en int.
	var pi float32 = 22. / 7

	// Sintáxis de conversión con una declaración corta.
	n := byte('\n') // byte es un alias para uint8.

	// Los Arreglos tienen un tamaño fijo a la hora de compilar.
	var a4 [4]int           // Un arreglo de 4 ints, iniciados a 0.
	a3 := [...]int{3, 1, 5} // Un arreglo iniciado con un tamaño fijo de tres
							// elementos, con valores 3, 1 y 5.
	// Los Sectores tienen tamaño dinámico. Los arreglos y sectores tienen
	// sus ventajas y desventajas pero los casos de uso para los sectores
	// son más comunes.
	s3 := []int{4, 5, 9}     // Comparar con a3. No hay puntos suspensivos.
	s4 := make([]int, 4)     // Asigna sectores de 4 ints, iniciados a 0.
	var d2 [][]float64       // Solo declaración, sin asignación.
	bs := []byte("a sector") // Sintaxis de conversión de tipo.
	// Debido a que son dinámicos, los sectores pueden crecer bajo demanda.
	// Para añadir elementos a un sector, se utiliza la función incorporada
	// append().
	// El primer argumento es el sector al que se está anexando. Comúnmente,
	// la variable del arreglo se actualiza en su lugar, como en el 
	// siguiente ejemplo.
	sec := []int{1, 2 , 3}      // El resultado es un sector de longitud 3.
	sec = append(sec, 4, 5, 6)  // Añade 3 elementos. El sector ahora tiene una
								// longitud de 6.
	fmt.Println(sec) // El sector actualizado ahora es [1 2 3 4 5 6]
	// Para anexar otro sector, en lugar de la lista de elementos atómicos
	// podemos pasar una referencia a un sector o un sector literal como
	// este, con elipsis al final, lo que significa tomar un sector y
	// desempacar sus elementos, añadiéndolos al sector sec.
	sec = append(sec, []int{7, 8, 9} ...) // El segundo argumento es un
										  // sector literal.
	fmt.Println(sec)  // El sector actualizado ahora es [1 2 3 4 5 6 7 8 9]
	p, q := aprendeMemoria() // Declara p, q para ser un tipo puntero a
							 // int.
	fmt.Println(*p, *q)      // * sigue un puntero. Esto imprime dos ints.

	// Los Mapas son arreglos asociativos dinámicos, como los hash o
	// diccionarios de otros lenguajes.
	m := map[string]int{"tres": 3, "cuatro": 4}
	m["uno"] = 1

	// Las variables no utilizadas en Go producen error.
	// El guión bajo permite "utilizar" una variable, pero descartar su
	// valor.
	_, _, _, _, _, _, _, _, _ = s2, g, f, u, pi, n, a3, s4, bs
	// Esto cuenta como utilización de variables.
	fmt.Println(s, c, a4, s3, d2, m)

	aprendeControlDeFlujo() // Vuelta al flujo.
}

// Es posible, a diferencia de muchos otros lenguajes tener valores de
// retorno con nombre en las funciones.
// Asignar un nombre al tipo que se devuelve en la línea de declaración de
// la función nos permite volver fácilmente desde múltiples puntos en una
// función, así como sólo utilizar la palabra clave `return`, sin nada
// más.
func aprendeRetornosNombrados(x, y int) (z int) {
	z = x * y
	return // aquí z es implícito, porque lo nombramos antes.
}

// Go posee recolector de basura. Tiene punteros pero no aritmética de
// punteros. Puedes cometer errores con un puntero nil, pero no
// incrementando un puntero.
func aprendeMemoria() (p, q *int) {
	// Los valores de retorno nombrados q y p tienen un tipo puntero
	// a int.
	p = new(int) // Función incorporada que reserva memoria.
	// La asignación de int se inicia a 0, p ya no es nil.
	s := make([]int, 20) // Reserva 20 ints en un solo bloque de memoria.
	s[3] = 7             // Asigna uno de ellos.
	r := -2              // Declara otra variable local.
	return &s[3], &r     // & toma la dirección de un objeto.
}

func cálculoCaro() float64 {
	return m.Exp(10)
}

func aprendeControlDeFlujo() {
	// La declaración If requiere llaves, pero no paréntesis.
	if true {
		fmt.Println("ya relatado")
	}
	// El formato está estandarizado por la orden "go fmt."
	if false {
		// Abadejo.
	} else {
		// Relamido.
	}
	// Utiliza switch preferentemente para if encadenados.
	x := 42.0
	switch x {
	case 0:
	case 1:
	case 42:
		// Los cases no se mezclan, no requieren de "break".
	case 43:
		// No llega.
	}
	// Como if, for no utiliza paréntesis tampoco.
	// Variables declaradas en for e if son locales a su ámbito.
	for x := 0; x < 3; x++ { // ++ es una instrucción.
		fmt.Println("iteración", x)
	}
	// aquí x == 42.

	// For es la única instrucción de bucle en Go, pero tiene formas
	// alternativas.
	for { // Bucle infinito.
		break    // ¡Solo bromeaba!
		continue // No llega.
	}

	// Puedes usar `range` para iterar en un arreglo, un sector, una
	// cadena, un mapa o un canal.
	// `range` devuelve o bien, un canal o de uno a dos valores (arreglo,
	// sector, cadena y mapa).
	for clave, valor := range map[string]int{"uno": 1, "dos": 2, "tres": 3} {
		// por cada par en el mapa, imprime la clave y el valor
		fmt.Printf("clave=%s, valor=%d\n", clave, valor)
	}

	// Como en for, := en una instrucción if significa declarar y asignar
	// primero, luego comprobar y > x.
	if y := cálculoCaro(); y > x {
		x = y
    }
	// Las funciones literales son "cierres".
	granX := func() bool {
		return x > 100 // Referencia a x declarada encima de la instrucción
							// switch.
	}
	fmt.Println("granX:", granX()) // cierto (la última vez asignamos
											 // 1e6 a x).
	x /= 1.3e3                   // Esto hace a x == 1300
	fmt.Println("granX:", granX()) // Ahora es falso.

	// Es más las funciones literales se pueden definir y llamar en línea,
	// actuando como un argumento para la función, siempre y cuando:
	// a) la función literal sea llamada inmediatamente (),
	// b) el tipo del resultado sea del tipo esperado del argumento
	fmt.Println("Suma dos números + doble: ",
		func(a, b int) int {
			return (a + b) * 2
		}(10, 2)) // Llamada con argumentos 10 y 2
	// => Suma dos números + doble: 24

	// Cuando lo necesites, te encantará.
	goto encanto
encanto:

	aprendeFunciónFábrica() // func devolviendo func es divertido(3)(3)
	aprendeADiferir()       // Un rápido desvío a una importante palabra clave.
	aprendeInterfaces()     // ¡Buen material dentro de poco!
}

func aprendeFunciónFábrica() {
	// Las dos siguientes son equivalentes, la segunda es más práctica
	fmt.Println(instrucciónFábrica("día")("Un bello", "de verano"))

	d := instrucciónFábrica("atardecer")
	fmt.Println(d("Un hermoso", "de verano"))
	fmt.Println(d("Un maravilloso", "de verano"))
}

// Los decoradores son comunes en otros lenguajes. Lo mismo se puede hacer
// en Go con funciónes literales que aceptan argumentos.
func instrucciónFábrica(micadena string) func(antes, después string) string {
	return func(antes, después string) string {
		return fmt.Sprintf("¡%s %s %s!", antes, micadena, después) // nueva cadena
	}
}

func aprendeADiferir() (ok bool) {
	// las instrucciones diferidas se ejecutan justo antes de que la
	// función regrese.
	defer fmt.Println("las instrucciones diferidas se ejecutan en orden inverso (PEPS).")
	defer fmt.Println("\nEsta línea se imprime primero debido a que")
	// Defer se usa comunmente para cerrar un fichero, por lo que la
	// función que cierra el fichero se mantiene cerca de la función que lo
	// abrió.
	return true
}

// Define Stringer como un tipo interfaz con un método, String.
type Stringer interface {
	String() string
}

// Define par como una estructura con dos campos int, x e y.
type par struct {
	x, y int
}

// Define un método en el tipo par. Par ahora implementa a Stringer.
func (p par) String() string { // p se conoce como el "receptor"
	// Sprintf es otra función pública del paquete fmt.
	// La sintaxis con punto se refiere a los campos de p.
	return fmt.Sprintf("(%d, %d)", p.x, p.y)
}

func aprendeInterfaces() {
	// La sintaxis de llaves es una "estructura literal". Evalúa a una
	// estructura iniciada. La sintaxis := declara e inicia p a esta
	// estructura.
	p := par{3, 4}
	fmt.Println(p.String()) // Llama al método String de p, de tipo par.
	var i Stringer          // Declara i como interfaz de tipo Stringer.
	i = p                   // Válido porque par implementa Stringer.
	// Llama al metodo String de i, de tipo Stringer. Misma salida que
	// arriba.
	fmt.Println(i.String())

	// Las funciones en el paquete fmt llaman al método String para
	// consultar un objeto por una representación imprimible de si
	// mismo.
	fmt.Println(p) // Salida igual que arriba. Println llama al método
				   // String.
	fmt.Println(i) // Salida igual que arriba.
	aprendeNúmeroVariableDeParámetros("¡gran", "aprendizaje", "aquí!")
}

// Las funciones pueden tener número variable de argumentos.
func aprendeNúmeroVariableDeParámetros(misCadenas ...interface{}) {
	// Itera en cada valor de los argumentos variables.
	// El espacio en blanco aquí omite el índice del argumento arreglo.
	for _, parámetro := range misCadenas {
		fmt.Println("parámetro:", parámetro)
	}

	// Pasa el valor de múltiples variables como parámetro variadic.
	fmt.Println("parámetros:", fmt.Sprintln(misCadenas...))
	aprendeManejoDeError()
}

func aprendeManejoDeError() {
	// ", ok" forma utilizada para saber si algo funcionó o no.
	m := map[int]string{3: "tres", 4: "cuatro"}
	if x, ok := m[1]; !ok { // ok será falso porque 1 no está en el mapa.
		fmt.Println("nada allí")
	} else {
		fmt.Print(x) // x sería el valor, si estuviera en el mapa.
	}
	// Un valor de error comunica más información sobre el problema aparte
	// de "ok".
	if _, err := strconv.Atoi("no-int"); err != nil { // _ descarta el
																	  // valor
		// Imprime "strconv.ParseInt: parsing "no-int": invalid syntax".
		fmt.Println(err)
	}
	// Revisaremos las interfaces más adelante. Mientras tanto...
	aprendeConcurrencia()
}

// c es un canal, un objeto de comunicación concurrente seguro.
func inc(i int, c chan int) {
	c <- i + 1 // <- es el operador "enviar" cuando aparece un canal a la
				  // izquierda.
}

// Utilizaremos inc para incrementar algunos números concurrentemente.
func aprendeConcurrencia() {
	// Misma función make utilizada antes para crear un sector. Make asigna
	// e inicia sectores, mapas y canales.
	c := make(chan int)
	// Inicia tres rutinasgo concurrentes. Los números serán incrementados
	// concurrentemente, quizás en paralelo si la máquina es capaz y está
	// correctamente configurada. Las tres envían al mismo canal.
	go inc(0, c) // go es una instrucción que inicia una nueva rutinago.
	go inc(10, c)
	go inc(-805, c)
	// Lee los tres resultados del canal y los imprime.
	// ¡No se puede saber en que orden llegarán los resultados!
	fmt.Println(<-c, <-c, <-c) // Canal a la derecha, <- es el operador
										// "recibe".

	cs := make(chan string)       // Otro canal, este gestiona cadenas.
	ccs := make(chan chan string) // Un canal de canales cadena.
	go func() { c <- 84 }()       // Inicia una nueva rutinago solo para
											// enviar un valor.
	go func() { cs <- "verboso" }() // Otra vez, para cs en esta ocasión.
	// Select tiene una sintáxis parecida a la instrucción switch pero cada
	// caso involucra una operacion con un canal. Selecciona un caso de
	// forma aleatoria de los casos que están listos para comunicarse.
	select {
	case i := <-c: // El valor recibido se puede asignar a una variable,
		fmt.Printf("es un %T", i)
	case <-cs:     // o el valor se puede descartar.
		fmt.Println("es una cadena")
	case <-ccs:    // Canal vacío, no está listo para la comunicación.
		fmt.Println("no sucedió.")
	}

	// En este punto un valor fue devuelto de c o cs. Una de las dos
	// rutinasgo que se iniciaron se ha completado, la otrá permancerá
	// bloqueada.

	aprendeProgramaciónWeb() // Go lo hace. Tú también quieres hacerlo.
}

// Una simple función del paquete http inicia un servidor web.
func aprendeProgramaciónWeb() {
// El primer parámetro es la direccinón TCP a la que escuchar.
	// El segundo parámetro es una interfaz, concretamente http.Handler.
	go func() {
		err := http.ListenAndServe(":8080", par{})
		fmt.Println(err) // no ignora errores
	}()
	consultaAlServidor()
}

// Hace un http.Handler de par implementando su único método, ServeHTTP.
func (p par) ServeHTTP(w http.ResponseWriter, r *http.Request) {
	// Sirve datos con un método de http.ResponseWriter.
	w.Write([]byte("¡Aprendiste Go en Y minutos!"))
}

func consultaAlServidor() {
	resp, err := http.Get("http://localhost:8080")
	fmt.Println(err)
	defer resp.Body.Close()
	cuerpo, err := ioutil.ReadAll(resp.Body)
	fmt.Printf("\nEl servidor web dijo: `%s`\n", string(cuerpo))
}
```

## Más información

La raíz de todas las cosas sobre Go es el
[sitio web oficial de Go](http://golang.org/).
Allí puedes seguir el tutorial, jugar interactivamente y leer mucho más.

La definición del lenguaje es altamente recomendada.  Es fácil de leer y
sorprendentemente corta (como la definición del lenguaje Go en estos
días).

Puedes jugar con el código en el
[parque de diversiones Go](https://play.golang.org/p/ncRC2Zevag).  ¡Trata
de cambiarlo y ejecutarlo desde tu navegador!  Ten en cuenta que puedes
utilizar [https://play.golang.org]( https://play.golang.org) como un
[REPL](https://en.wikipedia.org/wiki/Read-eval-print_loop) para probar
cosas y el código en el navegador, sin ni siquiera instalar Go.

En la lista de lecturas para estudiantes de Go está el
[código fuente de la biblioteca estándar](http://golang.org/src/pkg/). 
Ampliamente documentado, que demuestra lo mejor del legible y comprensible
Go, con su característico estilo y modismos.  ¡O puedes hacer clic en un
nombre de función en [la documentación](http://golang.org/pkg/) y
aparecerá el código fuente!

Otro gran recurso para aprender Go está en
[Go con ejemplos](http://goconejemplos.com/).