mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-27 03:08:52 +00:00
327 lines
12 KiB
Markdown
327 lines
12 KiB
Markdown
---
|
|
language: Go
|
|
lang: es-es
|
|
filename: learngo-es.go
|
|
contributors:
|
|
- ["Sonia Keys", "https://github.com/soniakeys"]
|
|
translators:
|
|
- ["Adrian Espinosa", "http://www.adrianespinosa.com"]
|
|
- ["Jesse Johnson", "https://github.com/holocronweaver"]
|
|
---
|
|
|
|
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
|
|
en día, y tiene características que ayudan con la programación a gran
|
|
escala.
|
|
|
|
Go viene con una librería estándar muy buena y una comunidad entusiasta.
|
|
|
|
```go
|
|
// Comentario de una sola línea
|
|
/* Comentario
|
|
multi línea */
|
|
|
|
// La cláusula package aparece al comienzo de cada archivo fuente.
|
|
// Main es un nombre especial que declara un ejecutable en vez de una librería.
|
|
package main
|
|
|
|
// La declaración Import declara los paquetes de librerías
|
|
// referenciados en este archivo.
|
|
import (
|
|
"fmt" // Un paquete en la librería estándar de Go.
|
|
"net/http" // Sí, un servidor web!
|
|
"strconv" // Conversiones de cadenas.
|
|
m "math" // Librería matemáticas con alias local m.
|
|
)
|
|
|
|
// 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("Hello world!")
|
|
|
|
// Llama a otra función de este paquete.
|
|
beyondHello()
|
|
}
|
|
|
|
// Las funciones llevan parámetros entre paréntesis.
|
|
// Si no hay parámetros, los paréntesis siguen siendo obligatorios.
|
|
func beyondHello() {
|
|
var x int // Declaración de una variable.
|
|
// Las variables se deben declarar antes de utilizarlas.
|
|
x = 3 // Asignación de variables.
|
|
// Declaración "corta" con := para inferir el tipo, declarar y asignar.
|
|
y := 4
|
|
sum, prod := learnMultiple(x, y) // Función devuelve dos valores.
|
|
fmt.Println("sum:", sum, "prod:", prod) // Simple salida.
|
|
learnTypes() // < y minutes, learn more!
|
|
}
|
|
|
|
// Las funciones pueden tener parámetros y (múltiples!) valores de retorno.
|
|
func learnMultiple(x, y int) (sum, prod int) {
|
|
return x + y, x * y // Devolver dos valores.
|
|
}
|
|
|
|
// Algunos tipos incorporados y literales.
|
|
func learnTypes() {
|
|
// La declaración corta suele darte lo que quieres.
|
|
s := "Learn Go!" // tipo cadena
|
|
|
|
s2 := ` Un tipo cadena "puro" puede incluir
|
|
saltos de línea.` // mismo tipo cadena
|
|
|
|
// Literal no ASCII. Los fuentes de Go son UTF-8.
|
|
g := 'Σ' // Tipo rune, un alias de int32, alberga un punto 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 inicializadores.
|
|
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 de uint8.
|
|
|
|
// Los Arrays tienen un tamaño fijo a la hora de compilar.
|
|
var a4 [4]int // Un array de 4 ints, inicializados a 0.
|
|
a3 := [...]int{3, 1, 5} // Un array de 3 ints, inicializados como se indica.
|
|
|
|
// Los Slices tienen tamaño dinámico. Los arrays y slices tienen sus ventajas
|
|
// y desventajas pero los casos de uso para los slices son más comunes.
|
|
s3 := []int{4, 5, 9} // Comparar con a3. No hay puntos suspensivos.
|
|
s4 := make([]int, 4) // Asigna slices de 4 ints, inicializados a 0.
|
|
var d2 [][]float64 // Solo declaración, sin asignación.
|
|
bs := []byte("a slice") // Sintaxis de conversión de tipo.
|
|
|
|
p, q := learnMemory() // Declara p, q para ser un tipo puntero a int.
|
|
fmt.Println(*p, *q) // * sigue un puntero. Esto imprime dos ints.
|
|
|
|
// Los Maps son arrays asociativos dinámicos, como los hash o
|
|
// diccionarios de otros lenguajes.
|
|
m := map[string]int{"three": 3, "four": 4}
|
|
m["one"] = 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)
|
|
|
|
learnFlowControl() // Vuelta al flujo.
|
|
}
|
|
|
|
// Go posee recolector de basura. Tiene puntero pero no aritmética de
|
|
// punteros. Puedes cometer un errores con un puntero nil, pero no
|
|
// incrementando un puntero.
|
|
func learnMemory() (p, q *int) {
|
|
// q y p tienen un tipo puntero a int.
|
|
p = new(int) // Función incorporada que asigna memoria.
|
|
// La asignación de int se inicializa a 0, p ya no es nil.
|
|
s := make([]int, 20) // Asigna 20 ints a un solo bloque de memoria.
|
|
s[3] = 7 // Asignar uno de ellos.
|
|
r := -2 // Declarar otra variable local.
|
|
return &s[3], &r // & toma la dirección de un objeto.
|
|
}
|
|
|
|
func expensiveComputation() float64 {
|
|
return m.Exp(10)
|
|
}
|
|
|
|
func learnFlowControl() {
|
|
// La declaración If requiere llaves, pero no paréntesis.
|
|
if true {
|
|
fmt.Println("told ya")
|
|
}
|
|
// El formato está estandarizado por el comando "go fmt."
|
|
if false {
|
|
// Pout.
|
|
} else {
|
|
// Gloat.
|
|
}
|
|
// Utiliza switch preferiblemente 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 y if son locales de su ámbito local.
|
|
for x := 0; x < 3; x++ { // ++ es una sentencia.
|
|
fmt.Println("iteration", x)
|
|
}
|
|
// x == 42 aqui.
|
|
|
|
// For es la única sentencia de bucle en Go, pero tiene formas alternativas.
|
|
for { // Bucle infinito.
|
|
break // Solo bromeaba!
|
|
continue // No llega.
|
|
}
|
|
// Como en for, := en una sentencia if significa declarar y asignar primero,
|
|
// luego comprobar y > x.
|
|
if y := expensiveComputation(); y > x {
|
|
x = y
|
|
}
|
|
// Los literales de funciones son "closures".
|
|
xBig := func() bool {
|
|
return x > 100 // Referencia a x declarada encima de la sentencia switch.
|
|
}
|
|
fmt.Println("xBig:", xBig()) // verdadero (la última vez asignamos 1e6 a x).
|
|
x /= m.Exp(9) // Esto lo hace x == e.
|
|
fmt.Println("xBig:", xBig()) // Ahora es falso.
|
|
|
|
// Cuando lo necesites, te encantará.
|
|
goto love
|
|
love:
|
|
|
|
learnInterfaces() // Buen material dentro de poco!
|
|
}
|
|
|
|
// Define Stringer como un tipo interfaz con un método, String.
|
|
type Stringer interface {
|
|
String() string
|
|
}
|
|
|
|
// Define pair como un struct con dos campos int, x e y.
|
|
type pair struct {
|
|
x, y int
|
|
}
|
|
|
|
// Define un método del tipo pair. Pair ahora implementa Stringer.
|
|
func (p pair) String() string { // p se llama "recibidor"
|
|
// Sprintf es otra función pública del paquete fmt.
|
|
// La sintaxis con punto referencia campos de p.
|
|
return fmt.Sprintf("(%d, %d)", p.x, p.y)
|
|
}
|
|
|
|
func learnInterfaces() {
|
|
// La sintaxis de llaves es un "literal struct". Evalúa a un struct
|
|
// inicializado. La sintaxis := declara e inicializa p a este struct.
|
|
p := pair{3, 4}
|
|
fmt.Println(p.String()) // Llamar al método String de p, de tipo pair.
|
|
var i Stringer // Declarar i como interfaz tipo Stringer.
|
|
i = p // Válido porque pair implementa Stringer.
|
|
// Llamar 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
|
|
// preguntar a un objeto por una versió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.
|
|
|
|
learnVariadicParams("great", "learning", "here!")
|
|
}
|
|
|
|
// Las funciones pueden tener número variable de argumentos.
|
|
func learnVariadicParams(myStrings ...interface{}) {
|
|
// Iterar cada valor de la variadic.
|
|
for _, param := range myStrings {
|
|
fmt.Println("param:", param)
|
|
}
|
|
|
|
// Pasar valor variadic como parámetro variadic.
|
|
fmt.Println("params:", fmt.Sprintln(myStrings...))
|
|
|
|
learnErrorHandling()
|
|
}
|
|
|
|
func learnErrorHandling() {
|
|
// ", ok" forma utilizada para saber si algo funcionó o no.
|
|
m := map[int]string{3: "three", 4: "four"}
|
|
if x, ok := m[1]; !ok { // ok será falso porque 1 no está en el map.
|
|
fmt.Println("no one there")
|
|
} else {
|
|
fmt.Print(x) // x sería el valor, si estuviera en el map.
|
|
}
|
|
// Un valor de error comunica más información sobre el problema aparte de "ok".
|
|
if _, err := strconv.Atoi("non-int"); err != nil { // _ descarta el valor
|
|
// Imprime "strconv.ParseInt: parsing "non-int": invalid syntax".
|
|
fmt.Println(err)
|
|
}
|
|
// Revisarmeos las interfaces más tarde. Mientras tanto,
|
|
learnConcurrency()
|
|
}
|
|
|
|
// c es un canal, un objeto de comunicación de concurrencia segura.
|
|
func inc(i int, c chan int) {
|
|
c <- i + 1 // <- es el operador "enviar" cuando un canal aparece a la izquierda.
|
|
}
|
|
|
|
// Utilizaremos inc para incrementar algunos números concurrentemente.
|
|
func learnConcurrency() {
|
|
// Misma función make utilizada antes para crear un slice. Make asigna e
|
|
// inicializa slices, maps, y channels.
|
|
c := make(chan int)
|
|
// Iniciar tres goroutines 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 channel.
|
|
go inc(0, c) // go es una sentencia que inicia una nueva goroutine.
|
|
go inc(10, c)
|
|
go inc(-805, c)
|
|
// Leer los tres resultados del channel e imprimirlos.
|
|
// No se puede saber en que orden llegarán los resultados!
|
|
fmt.Println(<-c, <-c, <-c) // Channel a la derecha, <- es el operador "recibir".
|
|
|
|
cs := make(chan string) // Otro channel, este gestiona cadenas.
|
|
ccs := make(chan chan string) // Un channel de cadenas de channels.
|
|
go func() { c <- 84 }() // Iniciar una nueva goroutine solo para
|
|
// enviar un valor.
|
|
go func() { cs <- "wordy" }() // Otra vez, para cs en esta ocasión.
|
|
// Select tiene una sintáxis parecida a la sentencia switch pero
|
|
// cada caso involucra una operacion de channels. Selecciona un caso
|
|
// de forma aleatoria de los casos que están listos para comunicarse.
|
|
select {
|
|
case i := <-c: // El valor recibido puede ser asignado a una variable,
|
|
fmt.Printf("it's a %T", i)
|
|
case <-cs: // o el valor puede ser descartado.
|
|
fmt.Println("it's a string")
|
|
case <-ccs: // Channel vacío, no está listo para la comunicación.
|
|
fmt.Println("didn't happen.")
|
|
}
|
|
|
|
// En este punto un valor fue devuelvto de c o cs. Uno de las dos
|
|
// goroutines que se iniciaron se ha completado, la otrá permancerá
|
|
// bloqueada.
|
|
|
|
learnWebProgramming() // Go lo hace. Tu también quieres hacerlo.
|
|
}
|
|
|
|
// Una simple función del paquete http inicia un servidor web.
|
|
func learnWebProgramming() {
|
|
// El primer parámetro de la direccinón TCP a la que escuchar.
|
|
// El segundo parámetro es una interfaz, concretamente http.Handler.
|
|
err := http.ListenAndServe(":8080", pair{})
|
|
fmt.Println(err) // no ignorar errores
|
|
}
|
|
|
|
// Haz pair un http.Handler implementando su único método, ServeHTTP.
|
|
func (p pair) ServeHTTP(w http.ResponseWriter, r *http.Request) {
|
|
// Servir datos con un método de http.ResponseWriter.
|
|
w.Write([]byte("You learned Go in Y minutes!"))
|
|
}
|
|
```
|
|
|
|
## Para leer más
|
|
|
|
La raíz de todas las cosas de Go es la [web oficial de Go](http://golang.org/).
|
|
Ahí puedes seguir el tutorial, jugar interactivamente y leer mucho.
|
|
|
|
La propia definición del lenguaje también está altamente
|
|
recomendada. Es fácil de leer e increíblemente corta (como otras
|
|
definiciones de lenguajes hoy en día)
|
|
|
|
En la lista de lectura de estudiantes de Go está el código fuente de
|
|
la librería estándar. Muy bien documentada, demuestra lo mejor de Go
|
|
leíble, comprendible, estilo Go y formas Go. Pincha en el nombre de
|
|
una función en la documentación y te aparecerá el código fuente!
|
|
|