mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-23 17:41:41 +00:00
Merge pull request #316 from aesptux/master
[c/en][go/es-es] Update C doc to fix a long line. / [go/es] translation
This commit is contained in:
Adam Bard
commit
b3b4afedae
@ -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)
|
||||
|
||||
301
es-es/go-es.html.markdown
Normal file
301
es-es/go-es.html.markdown
Normal file
@ -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!
|
||||
|
||||
Loading…
Reference in New Issue
Block a user