Merge pull request #116 from mg-chao/20220102_functions

[rust-exercise] 翻译 functions 部分

exercise/exercises/functions/README.md

@@ -1,7 +1,9 @@
-# Functions
+# 函数（Functions）
 
-Here, you'll learn how to write functions and how Rust's compiler can trace things way back.
+在本练习，你将学习如何编写一个函数，以及 Rust 编译器怎样可以对事物进行追溯（trace things way back）。
 
-## Further information
+译：依据练习的内容，追溯的意思可能是类型推导之类的事。
+
+## 更多信息
 
 - [How Functions Work](https://doc.rust-lang.org/book/ch03-03-how-functions-work.html)

exercise/exercises/functions/functions1.rs

@@ -1,8 +1,9 @@
 // functions1.rs
-// Make me compile! Execute `rustlings hint functions1` for hints :)
+// 让我能够编译！执行 `rustex hint functions1` 获取提示 :)
 
 // I AM NOT DONE
 
+/// 翻译: [mg-chao](https://github.com/mg-chao)
 fn main() {
     call_me();
 }

exercise/exercises/functions/functions2.rs

@@ -1,14 +1,15 @@
 // functions2.rs
-// Make me compile! Execute `rustlings hint functions2` for hints :)
+// 让我能够编译！执行 `rustex hint functions2` 获取提示 :)
 
 // I AM NOT DONE
 
+/// 翻译: [mg-chao](https://github.com/mg-chao)
 fn main() {
     call_me(3);
 }
 
 fn call_me(num:) {
     for i in 0..num {
-        println!("Ring! Call number {}", i + 1);
+        println!("Ring! Call number {}", i + 1);// 译："叮！呼叫号码 {}"
     }
 }

exercise/exercises/functions/functions3.rs

@@ -1,8 +1,9 @@
 // functions3.rs
-// Make me compile! Execute `rustlings hint functions3` for hints :)
+// 让我能够编译！执行 `rustex hint functions3` 获取提示 :)
 
 // I AM NOT DONE
 
+/// 翻译: [mg-chao](https://github.com/mg-chao)
 fn main() {
     call_me();
 }

exercise/exercises/functions/functions4.rs

@@ -1,14 +1,15 @@
 // functions4.rs
-// Make me compile! Execute `rustlings hint functions4` for hints :)
+// 让我能够编译！执行 `rustex hint functions4` 获取提示 :)
 
-// This store is having a sale where if the price is an even number, you get
+// 商店正在进行促销，如果价格是偶数，可以优惠 10 Rustbucks，如果是奇数，则优惠 3 Rustbucks。
-// 10 Rustbucks off, but if it's an odd number, it's 3 Rustbucks off.
+// 译：Rustbucks 可能想表达 Rust元 的意思，好比 美元 。
 
 // I AM NOT DONE
 
+/// 翻译: [mg-chao](https://github.com/mg-chao)
 fn main() {
     let original_price = 51;
-    println!("Your sale price is {}", sale_price(original_price));
+    println!("Your sale price is {}", sale_price(original_price));// 译："你需支付 {}"
 }
 
 fn sale_price(price: i32) -> {

exercise/exercises/functions/functions5.rs

@@ -1,11 +1,12 @@
 // functions5.rs
-// Make me compile! Execute `rustlings hint functions5` for hints :)
+// 让我能够编译！执行 `rustex hint functions5` 获取提示 :)
 
 // I AM NOT DONE
 
+/// 翻译: [mg-chao](https://github.com/mg-chao)
 fn main() {
     let answer = square(3);
-    println!("The answer is {}", answer);
+    println!("The answer is {}", answer);// 译："答案是 {}"
 }
 
 fn square(num: i32) -> i32 {

exercise/info.toml

@@ -73,48 +73,44 @@ name = "functions1"
 path = "exercises/functions/functions1.rs"
 mode = "compile"
 hint = """
-This main function is calling a function that it expects to exist, but the
+主函数中正试图调用一个名为 `call_me` 的函数，可这个函数并不存在。
-function doesn't exist. It expects this function to have the name `call_me`.
+它希望这个函数不接受任何参数，同时也不返回值。
-It expects this function to not take any arguments and not return a value.
+听起来很像 `main` 函数，不是吗？"""
-Sounds a lot like `main`, doesn't it?"""
 
 [[exercises]]
 name = "functions2"
 path = "exercises/functions/functions2.rs"
 mode = "compile"
 hint = """
-Rust requires that all parts of a function's signature have type annotations,
+ Rust 要求函数签名（signature）有类型标注，但是 `call_me` 函数缺少 `num` 的类型标注。"""
-but `call_me` is missing the type annotation of `num`."""
 
 [[exercises]]
 name = "functions3"
 path = "exercises/functions/functions3.rs"
 mode = "compile"
 hint = """
-This time, the function *declaration* is okay, but there's something wrong
+此时, 函数 *声明（declaration）* 是没问题的，但函数调用出了问题"""
-with the place where we're calling the function."""
 
 [[exercises]]
 name = "functions4"
 path = "exercises/functions/functions4.rs"
 mode = "compile"
 hint = """
-The error message points to line 14 and says it expects a type after the
+错误信息指向第 15 行，说希望在`->`之后有一个类型。
-`->`. This is where the function's return type should be-- take a look at
+那个地方标注了函数的返回类型——看看 `is_even` 函数的示例吧"""
-the `is_even` function for an example!"""
 
 [[exercises]]
 name = "functions5"
 path = "exercises/functions/functions5.rs"
 mode = "compile"
 hint = """
-This is a really common error that can be fixed by removing one character.
+这是一个非常常见的错误，可以通过删除一个字符来解决。
-It happens because Rust distinguishes between expressions and statements: expressions return
+发生的原因是 Rust 区分了表达式和语句：表达式根据其运算数（operand）返回一个值, 
-a value based on its operand, and statements simply return a () type which behaves just like `void` in C/C++ language.
+而语句仅返回一个 `()` 类型，其行为好比 C/C++ 中的 `void` 。
-We want to return a value of `i32` type from the `square` function, but it is returning a `()` type...
+我们希望 `square` 函数返回一个 `i32` 类型的值，但现在它返回的是 `()` 类型...
-They are not the same. There are two solutions:
+它们显然是不一样的。对此有两种解决方案。
-1. Add a `return` ahead of `num * num;`
+1. 在 `num * num;` 前面加上 `return` 关键字
-2. remove `;`, make it to be `num * num`"""
+2. 移除 `;`，让它变成 `num * num`"""
 
 # IF