summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
-rw-r--r--c.html.markdown3
-rw-r--r--es-es/go-es.html.markdown301
2 files changed, 303 insertions, 1 deletions
diff --git a/c.html.markdown b/c.html.markdown
index 12f862bc..c67f8b21 100644
--- a/c.html.markdown
+++ b/c.html.markdown
@@ -81,7 +81,8 @@ int main() {
// is not evaluated (except VLAs (see below)).
// The value it yields in this case is a compile-time constant.
int a = 1;
- // size_t is an unsiged integer type of at least 2 bytes used to represent the size of an object.
+ // size_t is an unsiged integer type of at least 2 bytes used to represent
+ // the size of an object.
size_t size = sizeof(a++); // a++ is not evaluated
printf("sizeof(a++) = %zu where a = %d\n", size, a);
// prints "sizeof(a++) = 4 where a = 1" (on a 32-bit architecture)
diff --git a/es-es/go-es.html.markdown b/es-es/go-es.html.markdown
new file mode 100644
index 00000000..6f65a6ad
--- /dev/null
+++ b/es-es/go-es.html.markdown
@@ -0,0 +1,301 @@
+---
+name: Go
+category: language
+language: Go
+filename: learngo.go
+contributors:
+ - ["Sonia Keys", "https://github.com/soniakeys"]
+translators:
+ - ["Adrian Espinosa", "http://www.adrianespinosa.com"]
+lang: es-es
+
+
+---
+
+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
+)
+
+// 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 uint32, 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() int {
+ return 1e6
+}
+
+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 := 1
+ switch x {
+ case 0:
+ case 1:
+ // los cases no se mezclan, no requieren de "break"
+ case 2:
+ // no llega
+ }
+ // Como if, for no utiliza paréntesis tampoco.
+ for x := 0; x < 3; x++ { // ++ es una sentencia
+ fmt.Println("iteration", x)
+ }
+ // x == 1 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 /= 1e5 // esto lo hace == 10
+ 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.
+
+ 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.
+ cc := 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 <-cc: // 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!
+