fix: improved readability and translations in chapter 6 #52
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
diff --git a/src/ch05-02-example-structs.md b/src/ch05-02-example-structs.md
index 8782c9cf..775fac9b 100644
--- a/src/ch05-02-example-structs.md
+++ b/src/ch05-02-example-structs.md
@@ -35,7 +35,7 @@ El problema con este código es evidente en la firma de `area`:
{{#rustdoc_include ../listings/ch05-using-structs-to-structure-related-data/listing-05-08/src/main.rs:here}}
```
-La función `area` está supuesta para calcular el área de un rectángulo, pero
O+La función `area` está sup
la función que escribimos tiene dos parámetros, y no está claro en ningún
lugar de nuestro programa que los parámetros están relacionados. Sería más
legible y más manejable agrupar el ancho y el alto juntos. Ya hemos discutido
@@ -72,8 +72,7 @@ más fácil introducir errores.
### Refactorizando con Structs: Añadiendo Más Significado
Hemos usado structs para agregar significado al etiquetar los datos. Podemos
-transformar la tupla que estamos usando en un struct con un nombre para el
-todo y nombres para las partes, como se muestra en la lista 5-10.
+transformar la tupla que estamos usando en un struct con un nombre para la estructura y nombres para los campos, como se muestra en la lista 5-10.
<span class="filename">Filename: src/main.rs</span>
@@ -226,11 +225,10 @@ siguiente llamada. Aquí está el output de este ejemplo:
{{#include ../listings/ch05-using-structs-to-structure-related-data/no-listing-05-dbg-macro/output.txt}}
```
-Podemos ver que la primera parte de la salida proviene de *src/main.rs* línea
-10 donde estamos depurando la expresión `30 * scale`, y su valor resultante es
-`60` (la formateo `Debug` implementado para enteros es imprimir solo su valor).
-La llamada `dbg!` en la línea 14 de *src/main.rs* produce el valor de `&rect1`,
-que es la estructura `Rectangle`. Esta salida usa el formateo `Debug` de la
+Podemos ver que el primer bit de salida proviene de la linea 10 de *src/main.rs* donde estamos depurando la expresión `30 * scale`, y su valor resultante es
+`60` (el formato de `Debug` implementado para enteros es imprimir sólo su valor).
+La llamada a `dbg!` en la línea 14 de *src/main.rs* produce el valor de `&rect1`,
+que es la estructura de `Rectangle`. Esta salida usa el formato `Debug` de la
estructura `Rectangle`. La macro `dbg!` puede ser realmente útil cuando está
tratando de averiguar qué está haciendo su código.
diff --git a/src/ch05-03-method-syntax.md b/src/ch05-03-method-syntax.md
index 58dec6f8..55e5814f 100644
--- a/src/ch05-03-method-syntax.md
+++ b/src/ch05-03-method-syntax.md
@@ -29,7 +29,7 @@ como se muestra en el Listado 5-13.
Para definir la función dentro del contexto de `Rectangle`, iniciamos un bloque
`impl` (implementación). Todo lo que esté dentro de este bloque `impl` estará
asociado al tipo `Rectangle`. Luego movemos la función `area` dentro de las
-llaves del `impl` y cambiamos el primer (y en este caso, único) parámetro para
+llaves del bloque `impl` y cambiamos el primer (y en este caso, único) parámetro para
ser `self` en la firma y en todas partes dentro del cuerpo. En `main`, donde
llamamos a la función `area` y pasamos `rect1` como argumento, podemos en vez
de eso usar la *sintaxis de método* para llamar al método `area` en nuestra
@@ -42,10 +42,10 @@ En la firma para `area`, usamos `&self` en vez de `rectangle: &Rectangle`. El
`impl`. Los métodos deben tener un parámetro llamado `self` de tipo `Self` para
su primer parámetro, por lo que Rust nos permite abreviar esto con solo el
nombre `self` en el primer parámetro. Ten en cuenta que aún necesitamos usar el
-`&` antes de la abreviatura `self` para indicar que este método presta la
+`&` antes de la abreviatura `self` para indicar que este método toma prestada la
instancia `Self`, al igual que hicimos en `rectangle: &Rectangle`. Los métodos
-pueden tomar la propiedad de `self`, prestar `self` inmutablemente, como lo
-hemos hecho aquí, o prestar `self` mutably, al igual que pueden hacerlo con
+pueden tomar la propiedad de `self`, tomarlo prestado de forma inmutable, como
+hemos hecho aquí, o tomarlo prestado de forma mutable, al igual que pueden hacerlo con
cualquier otro parámetro.
Elegimos `&self` aquí por la misma razón que usamos `&Rectangle` en la versión
@@ -223,8 +223,8 @@ este caso es `Rectangle`.
Para llamar a esa función asociada, usamos la sintaxis `::` con el nombre de
la estructura; `let sq = Rectangle::square(3);` es un ejemplo. Esta función
-está en el espacio de nombres de la estructura: la sintaxis `::` se usa tanto
-para las funciones asociadas como para los espacios de nombres creados por los
+está dentro del namespace de la estructura. La sintaxis `::` se usa tanto
+para las funciones asociadas como para los namespaces creados por los
módulos. Discutiremos los módulos en el [Capítulo 7][modules]<!-- ignore -->.
### Bloques `impl` múltiples
…ucts.md
index 8782c9cf..775fac9b 100644
--- a/src/ch05-02-example-structs.md
+++ b/src/ch05-02-example-structs.md
@@ -35,7 +35,7 @@ El problema con este código es evidente en la firma de `area`:
{{#rustdoc_include ../listings/ch05-using-structs-to-structure-related-data/listing-05-08/src/main.rs:here}}
```
-La función `area` está supuesta para calcular el área de un rectángulo, pero
O+La función `area` está sup
la función que escribimos tiene dos parámetros, y no está claro en ningún
lugar de nuestro programa que los parámetros están relacionados. Sería más
legible y más manejable agrupar el ancho y el alto juntos. Ya hemos discutido
@@ -72,8 +72,7 @@ más fácil introducir errores.
### Refactorizando con Structs: Añadiendo Más Significado
Hemos usado structs para agregar significado al etiquetar los datos. Podemos
-transformar la tupla que estamos usando en un struct con un nombre para el
-todo y nombres para las partes, como se muestra en la lista 5-10.
+transformar la tupla que estamos usando en un struct con un nombre para la estructura y nombres para los campos, como se muestra en la lista 5-10.
<span class="filename">Filename: src/main.rs</span>
@@ -226,11 +225,10 @@ siguiente llamada. Aquí está el output de este ejemplo:
{{#include ../listings/ch05-using-structs-to-structure-related-data/no-listing-05-dbg-macro/output.txt}}
```
-Podemos ver que la primera parte de la salida proviene de *src/main.rs* línea
-10 donde estamos depurando la expresión `30 * scale`, y su valor resultante es
-`60` (la formateo `Debug` implementado para enteros es imprimir solo su valor).
-La llamada `dbg!` en la línea 14 de *src/main.rs* produce el valor de `&rect1`,
-que es la estructura `Rectangle`. Esta salida usa el formateo `Debug` de la
+Podemos ver que el primer bit de salida proviene de la linea 10 de *src/main.rs* donde estamos depurando la expresión `30 * scale`, y su valor resultante es
+`60` (el formato de `Debug` implementado para enteros es imprimir sólo su valor).
+La llamada a `dbg!` en la línea 14 de *src/main.rs* produce el valor de `&rect1`,
+que es la estructura de `Rectangle`. Esta salida usa el formato `Debug` de la
estructura `Rectangle`. La macro `dbg!` puede ser realmente útil cuando está
tratando de averiguar qué está haciendo su código.
diff --git a/src/ch05-03-method-syntax.md b/src/ch05-03-method-syntax.md
index 58dec6f8..55e5814f 100644
--- a/src/ch05-03-method-syntax.md
+++ b/src/ch05-03-method-syntax.md
@@ -29,7 +29,7 @@ como se muestra en el Listado 5-13.
Para definir la función dentro del contexto de `Rectangle`, iniciamos un bloque
`impl` (implementación). Todo lo que esté dentro de este bloque `impl` estará
asociado al tipo `Rectangle`. Luego movemos la función `area` dentro de las
-llaves del `impl` y cambiamos el primer (y en este caso, único) parámetro para
+llaves del bloque `impl` y cambiamos el primer (y en este caso, único) parámetro para
ser `self` en la firma y en todas partes dentro del cuerpo. En `main`, donde
llamamos a la función `area` y pasamos `rect1` como argumento, podemos en vez
de eso usar la *sintaxis de método* para llamar al método `area` en nuestra
@@ -42,10 +42,10 @@ En la firma para `area`, usamos `&self` en vez de `rectangle: &Rectangle`. El
`impl`. Los métodos deben tener un parámetro llamado `self` de tipo `Self` para
su primer parámetro, por lo que Rust nos permite abreviar esto con solo el
nombre `self` en el primer parámetro. Ten en cuenta que aún necesitamos usar el
-`&` antes de la abreviatura `self` para indicar que este método presta la
+`&` antes de la abreviatura `self` para indicar que este método toma prestada la
instancia `Self`, al igual que hicimos en `rectangle: &Rectangle`. Los métodos
-pueden tomar la propiedad de `self`, prestar `self` inmutablemente, como lo
-hemos hecho aquí, o prestar `self` mutably, al igual que pueden hacerlo con
+pueden tomar la propiedad de `self`, tomarlo prestado de forma inmutable, como
+hemos hecho aquí, o tomarlo prestado de forma mutable, al igual que pueden hacerlo con
cualquier otro parámetro.
Elegimos `&self` aquí por la misma razón que usamos `&Rectangle` en la versión
@@ -223,8 +223,8 @@ este caso es `Rectangle`.
Para llamar a esa función asociada, usamos la sintaxis `::` con el nombre de
la estructura; `let sq = Rectangle::square(3);` es un ejemplo. Esta función
-está en el espacio de nombres de la estructura: la sintaxis `::` se usa tanto
-para las funciones asociadas como para los espacios de nombres creados por los
+está dentro del namespace de la estructura. La sintaxis `::` se usa tanto
+para las funciones asociadas como para los namespaces creados por los
módulos. Discutiremos los módulos en el [Capítulo 7][modules]<!-- ignore -->.
### Bloques `impl` múltiples
…ucts.md
index 8782c9cf..775fac9b 100644
--- a/src/ch05-02-example-structs.md
+++ b/src/ch05-02-example-structs.md
@@ -35,7 +35,7 @@ El problema con este código es evidente en la firma de `area`:
{{#rustdoc_include ../listings/ch05-using-structs-to-structure-related-data/listing-05-08/src/main.rs:here}}
```
-La función `area` está supuesta para calcular el área de un rectángulo, pero
O+La función `area` está sup
la función que escribimos tiene dos parámetros, y no está claro en ningún
lugar de nuestro programa que los parámetros están relacionados. Sería más
legible y más manejable agrupar el ancho y el alto juntos. Ya hemos discutido
@@ -72,8 +72,7 @@ más fácil introducir errores.
### Refactorizando con Structs: Añadiendo Más Significado
Hemos usado structs para agregar significado al etiquetar los datos. Podemos
-transformar la tupla que estamos usando en un struct con un nombre para el
-todo y nombres para las partes, como se muestra en la lista 5-10.
+transformar la tupla que estamos usando en un struct con un nombre para la estructura y nombres para los campos, como se muestra en la lista 5-10.
<span class="filename">Filename: src/main.rs</span>
@@ -226,11 +225,10 @@ siguiente llamada. Aquí está el output de este ejemplo:
{{#include ../listings/ch05-using-structs-to-structure-related-data/no-listing-05-dbg-macro/output.txt}}
```
-Podemos ver que la primera parte de la salida proviene de *src/main.rs* línea
-10 donde estamos depurando la expresión `30 * scale`, y su valor resultante es
-`60` (la formateo `Debug` implementado para enteros es imprimir solo su valor).
-La llamada `dbg!` en la línea 14 de *src/main.rs* produce el valor de `&rect1`,
-que es la estructura `Rectangle`. Esta salida usa el formateo `Debug` de la
+Podemos ver que el primer bit de salida proviene de la linea 10 de *src/main.rs* donde estamos depurando la expresión `30 * scale`, y su valor resultante es
+`60` (el formato de `Debug` implementado para enteros es imprimir sólo su valor).
+La llamada a `dbg!` en la línea 14 de *src/main.rs* produce el valor de `&rect1`,
+que es la estructura de `Rectangle`. Esta salida usa el formato `Debug` de la
estructura `Rectangle`. La macro `dbg!` puede ser realmente útil cuando está
tratando de averiguar qué está haciendo su código.
diff --git a/src/ch05-03-method-syntax.md b/src/ch05-03-method-syntax.md
index 58dec6f8..55e5814f 100644
--- a/src/ch05-03-method-syntax.md
+++ b/src/ch05-03-method-syntax.md
@@ -29,7 +29,7 @@ como se muestra en el Listado 5-13.
Para definir la función dentro del contexto de `Rectangle`, iniciamos un bloque
`impl` (implementación). Todo lo que esté dentro de este bloque `impl` estará
asociado al tipo `Rectangle`. Luego movemos la función `area` dentro de las
-llaves del `impl` y cambiamos el primer (y en este caso, único) parámetro para
+llaves del bloque `impl` y cambiamos el primer (y en este caso, único) parámetro para
ser `self` en la firma y en todas partes dentro del cuerpo. En `main`, donde
llamamos a la función `area` y pasamos `rect1` como argumento, podemos en vez
de eso usar la *sintaxis de método* para llamar al método `area` en nuestra
@@ -42,10 +42,10 @@ En la firma para `area`, usamos `&self` en vez de `rectangle: &Rectangle`. El
`impl`. Los métodos deben tener un parámetro llamado `self` de tipo `Self` para
su primer parámetro, por lo que Rust nos permite abreviar esto con solo el
nombre `self` en el primer parámetro. Ten en cuenta que aún necesitamos usar el
-`&` antes de la abreviatura `self` para indicar que este método presta la
+`&` antes de la abreviatura `self` para indicar que este método toma prestada la
instancia `Self`, al igual que hicimos en `rectangle: &Rectangle`. Los métodos
-pueden tomar la propiedad de `self`, prestar `self` inmutablemente, como lo
-hemos hecho aquí, o prestar `self` mutably, al igual que pueden hacerlo con
+pueden tomar la propiedad de `self`, tomarlo prestado de forma inmutable, como
+hemos hecho aquí, o tomarlo prestado de forma mutable, al igual que pueden hacerlo con
cualquier otro parámetro.
Elegimos `&self` aquí por la misma razón que usamos `&Rectangle` en la versión
@@ -223,8 +223,8 @@ este caso es `Rectangle`.
Para llamar a esa función asociada, usamos la sintaxis `::` con el nombre de
la estructura; `let sq = Rectangle::square(3);` es un ejemplo. Esta función
-está en el espacio de nombres de la estructura: la sintaxis `::` se usa tanto
-para las funciones asociadas como para los espacios de nombres creados por los
+está dentro del namespace de la estructura. La sintaxis `::` se usa tanto
+para las funciones asociadas como para los namespaces creados por los
módulos. Discutiremos los módulos en el [Capítulo 7][modules]<!-- ignore -->.
### Bloques `impl` múltiples
…ucts.md
index 8782c9cf..775fac9b 100644
--- a/src/ch05-02-example-structs.md
+++ b/src/ch05-02-example-structs.md
@@ -35,7 +35,7 @@ El problema con este código es evidente en la firma de `area`:
{{#rustdoc_include ../listings/ch05-using-structs-to-structure-related-data/listing-05-08/src/main.rs:here}}
```
-La función `area` está supuesta para calcular el área de un rectángulo, pero
O+La función `area` está sup
la función que escribimos tiene dos parámetros, y no está claro en ningún
lugar de nuestro programa que los parámetros están relacionados. Sería más
legible y más manejable agrupar el ancho y el alto juntos. Ya hemos discutido
@@ -72,8 +72,7 @@ más fácil introducir errores.
### Refactorizando con Structs: Añadiendo Más Significado
Hemos usado structs para agregar significado al etiquetar los datos. Podemos
-transformar la tupla que estamos usando en un struct con un nombre para el
-todo y nombres para las partes, como se muestra en la lista 5-10.
+transformar la tupla que estamos usando en un struct con un nombre para la estructura y nombres para los campos, como se muestra en la lista 5-10.
<span class="filename">Filename: src/main.rs</span>
@@ -226,11 +225,10 @@ siguiente llamada. Aquí está el output de este ejemplo:
{{#include ../listings/ch05-using-structs-to-structure-related-data/no-listing-05-dbg-macro/output.txt}}
```
-Podemos ver que la primera parte de la salida proviene de *src/main.rs* línea
-10 donde estamos depurando la expresión `30 * scale`, y su valor resultante es
-`60` (la formateo `Debug` implementado para enteros es imprimir solo su valor).
-La llamada `dbg!` en la línea 14 de *src/main.rs* produce el valor de `&rect1`,
-que es la estructura `Rectangle`. Esta salida usa el formateo `Debug` de la
+Podemos ver que el primer bit de salida proviene de la linea 10 de *src/main.rs* donde estamos depurando la expresión `30 * scale`, y su valor resultante es
+`60` (el formato de `Debug` implementado para enteros es imprimir sólo su valor).
+La llamada a `dbg!` en la línea 14 de *src/main.rs* produce el valor de `&rect1`,
+que es la estructura de `Rectangle`. Esta salida usa el formato `Debug` de la
estructura `Rectangle`. La macro `dbg!` puede ser realmente útil cuando está
tratando de averiguar qué está haciendo su código.
diff --git a/src/ch05-03-method-syntax.md b/src/ch05-03-method-syntax.md
index 58dec6f8..55e5814f 100644
--- a/src/ch05-03-method-syntax.md
+++ b/src/ch05-03-method-syntax.md
@@ -29,7 +29,7 @@ como se muestra en el Listado 5-13.
Para definir la función dentro del contexto de `Rectangle`, iniciamos un bloque
`impl` (implementación). Todo lo que esté dentro de este bloque `impl` estará
asociado al tipo `Rectangle`. Luego movemos la función `area` dentro de las
-llaves del `impl` y cambiamos el primer (y en este caso, único) parámetro para
+llaves del bloque `impl` y cambiamos el primer (y en este caso, único) parámetro para
ser `self` en la firma y en todas partes dentro del cuerpo. En `main`, donde
llamamos a la función `area` y pasamos `rect1` como argumento, podemos en vez
de eso usar la *sintaxis de método* para llamar al método `area` en nuestra
@@ -42,10 +42,10 @@ En la firma para `area`, usamos `&self` en vez de `rectangle: &Rectangle`. El
`impl`. Los métodos deben tener un parámetro llamado `self` de tipo `Self` para
su primer parámetro, por lo que Rust nos permite abreviar esto con solo el
nombre `self` en el primer parámetro. Ten en cuenta que aún necesitamos usar el
-`&` antes de la abreviatura `self` para indicar que este método presta la
+`&` antes de la abreviatura `self` para indicar que este método toma prestada la
instancia `Self`, al igual que hicimos en `rectangle: &Rectangle`. Los métodos
-pueden tomar la propiedad de `self`, prestar `self` inmutablemente, como lo
-hemos hecho aquí, o prestar `self` mutably, al igual que pueden hacerlo con
+pueden tomar la propiedad de `self`, tomarlo prestado de forma inmutable, como
+hemos hecho aquí, o tomarlo prestado de forma mutable, al igual que pueden hacerlo con
cualquier otro parámetro.
Elegimos `&self` aquí por la misma razón que usamos `&Rectangle` en la versión
@@ -223,8 +223,8 @@ este caso es `Rectangle`.
Para llamar a esa función asociada, usamos la sintaxis `::` con el nombre de
la estructura; `let sq = Rectangle::square(3);` es un ejemplo. Esta función
-está en el espacio de nombres de la estructura: la sintaxis `::` se usa tanto
-para las funciones asociadas como para los espacios de nombres creados por los
+está dentro del namespace de la estructura. La sintaxis `::` se usa tanto
+para las funciones asociadas como para los namespaces creados por los
módulos. Discutiremos los módulos en el [Capítulo 7][modules]<!-- ignore -->.
### Bloques `impl` múltiples
SergioRibera
approved these changes
Feb 17, 2024
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
fix: improved readability and translations in chapter 6