mirror of
https://github.com/google/comprehensive-rust.git
synced 2025-04-27 01:27:37 +02:00
zh-TW: translate error-handling (#973)
* zh-TW: translate error-handling Part of #684. * Update zh-TW.po Fix msgfmt lint error. * Apply suggestions from code review Co-authored-by: Jonathan Hao <phao@google.com> * zh-TW: remove untranslated `msgstr` entries * zh-TW: copy code samples as-is The code can (but doesn’t have to be) translated. --------- Co-authored-by: Henri Fontana <henrif75@users.noreply.github.com> Co-authored-by: Jonathan Hao <phao@google.com>
This commit is contained in:
Martin Geisler
GitHub
parent
34acff339d
commit
707933c617
259
po/zh-TW.po
259
po/zh-TW.po
@ -9666,25 +9666,27 @@ msgstr ""
|
||||
|
||||
#: src/error-handling.md:1
|
||||
msgid "# Error Handling"
|
||||
msgstr ""
|
||||
msgstr "# 錯誤處理"
|
||||
|
||||
#: src/error-handling.md:3
|
||||
msgid "Error handling in Rust is done using explicit control flow:"
|
||||
msgstr ""
|
||||
msgstr "在 Rust 中，是透過明確的控制流程完成錯誤處理作業："
|
||||
|
||||
#: src/error-handling.md:5
|
||||
msgid ""
|
||||
"* Functions that can have errors list this in their return type,\n"
|
||||
"* There are no exceptions."
|
||||
msgstr ""
|
||||
"* 可能含有錯誤的函式會在回傳型別中列出相關資訊。\n"
|
||||
"* 沒有任何例外。"
|
||||
|
||||
#: src/error-handling/panics.md:1
|
||||
msgid "# Panics"
|
||||
msgstr ""
|
||||
msgstr "# 恐慌"
|
||||
|
||||
#: src/error-handling/panics.md:3
|
||||
msgid "Rust will trigger a panic if a fatal error happens at runtime:"
|
||||
msgstr ""
|
||||
msgstr "如果執行階段發生重大錯誤，Rust 就會觸發恐慌："
|
||||
|
||||
#: src/error-handling/panics.md:5
|
||||
msgid ""
|
||||
@ -9695,6 +9697,12 @@ msgid ""
|
||||
"}\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,editable,should_panic\n"
|
||||
"fn main() {\n"
|
||||
" let v = vec![10, 20, 30];\n"
|
||||
" println!(\"v[100]: {}\", v[100]);\n"
|
||||
"}\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/panics.md:12
|
||||
msgid ""
|
||||
@ -9702,16 +9710,19 @@ msgid ""
|
||||
" * Panics are symptoms of bugs in the program.\n"
|
||||
"* Use non-panicking APIs (such as `Vec::get`) if crashing is not acceptable."
|
||||
msgstr ""
|
||||
"* 恐慌代表發生無法復原的非預期錯誤。\n"
|
||||
"* 恐慌可以反映程式中的錯誤。\n"
|
||||
"* 如果無法接受程式崩潰，請使用不會觸發恐慌的 API，例如 `Vec::get`。"
|
||||
|
||||
#: src/error-handling/panic-unwind.md:1
|
||||
msgid "# Catching the Stack Unwinding"
|
||||
msgstr ""
|
||||
msgstr "# 擷取解開堆疊的動作"
|
||||
|
||||
#: src/error-handling/panic-unwind.md:3
|
||||
msgid ""
|
||||
"By default, a panic will cause the stack to unwind. The unwinding can be "
|
||||
"caught:"
|
||||
msgstr ""
|
||||
msgstr "根據預設，恐慌會造成解開堆疊。您可以擷取這類動作："
|
||||
|
||||
#: src/error-handling/panic-unwind.md:5
|
||||
msgid ""
|
||||
@ -9729,17 +9740,33 @@ msgid ""
|
||||
"assert!(result.is_err());\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,editable\n"
|
||||
"use std::panic;\n"
|
||||
"\n"
|
||||
"let result = panic::catch_unwind(|| {\n"
|
||||
" println!(\"hello!\");\n"
|
||||
"});\n"
|
||||
"assert!(result.is_ok());\n"
|
||||
"\n"
|
||||
"let result = panic::catch_unwind(|| {\n"
|
||||
" panic!(\"oh no!\");\n"
|
||||
"});\n"
|
||||
"assert!(result.is_err());\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/panic-unwind.md:19
|
||||
#: src/error-handling/panic-unwind.md:21
|
||||
msgid ""
|
||||
"* This can be useful in servers which should keep running even if a single\n"
|
||||
" request crashes.\n"
|
||||
"* This does not work if `panic = 'abort'` is set in your `Cargo.toml`."
|
||||
msgstr ""
|
||||
"* 如果伺服器需要持續運作 (即使有單一要求崩潰也不例外)，這種做法就能派上用"
|
||||
"場。\n"
|
||||
"* 如果您在 `Cargo.toml` 中設定 `panic = 'abort'`，就無法採取此做法。"
|
||||
|
||||
#: src/error-handling/result.md:1
|
||||
msgid "# Structured Error Handling with `Result`"
|
||||
msgstr ""
|
||||
msgstr "# 使用 `Result` 進行結構化錯誤處理"
|
||||
|
||||
#: src/error-handling/result.md:3
|
||||
msgid ""
|
||||
@ -9747,6 +9774,8 @@ msgid ""
|
||||
"are\n"
|
||||
"expected as part of normal operation:"
|
||||
msgstr ""
|
||||
"我們先前介紹了 `Result` 列舉。當正常運作過程中預期發生錯誤時，普遍都會使用這"
|
||||
"個列舉："
|
||||
|
||||
#: src/error-handling/result.md:6
|
||||
msgid ""
|
||||
@ -9769,6 +9798,24 @@ msgid ""
|
||||
"}\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,editable\n"
|
||||
"use std::fs::File;\n"
|
||||
"use std::io::Read;\n"
|
||||
"\n"
|
||||
"fn main() {\n"
|
||||
" let file = File::open(\"diary.txt\");\n"
|
||||
" match file {\n"
|
||||
" Ok(mut file) => {\n"
|
||||
" let mut contents = String::new();\n"
|
||||
" file.read_to_string(&mut contents);\n"
|
||||
" println!(\"Dear diary: {contents}\");\n"
|
||||
" },\n"
|
||||
" Err(err) => {\n"
|
||||
" println!(\"The diary could not be opened: {err}\");\n"
|
||||
" }\n"
|
||||
" }\n"
|
||||
"}\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/result.md:27
|
||||
msgid ""
|
||||
@ -9782,19 +9829,18 @@ msgid ""
|
||||
"it is worth mentioning. \n"
|
||||
" It contains a lot of convenience methods and functions that help "
|
||||
"functional-style programming. \n"
|
||||
" "
|
||||
msgstr ""
|
||||
|
||||
#: src/error-handling/try-operator.md:1
|
||||
msgid "# Propagating Errors with `?`"
|
||||
msgstr ""
|
||||
msgstr "# 使用 `?` 傳播錯誤"
|
||||
|
||||
#: src/error-handling/try-operator.md:3
|
||||
msgid ""
|
||||
"The try-operator `?` is used to return errors to the caller. It lets you "
|
||||
"turn\n"
|
||||
"the common"
|
||||
msgstr ""
|
||||
msgstr "try 運算子 `?` 用於將錯誤傳回呼叫端，讓您將下列常見的程式碼："
|
||||
|
||||
#: src/error-handling/try-operator.md:6
|
||||
msgid ""
|
||||
@ -9805,10 +9851,16 @@ msgid ""
|
||||
"}\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,ignore\n"
|
||||
"match some_expression {\n"
|
||||
" Ok(value) => value,\n"
|
||||
" Err(err) => return Err(err),\n"
|
||||
"}\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/try-operator.md:13
|
||||
msgid "into the much simpler"
|
||||
msgstr ""
|
||||
msgstr "轉換成以下較簡潔的程式碼："
|
||||
|
||||
#: src/error-handling/try-operator.md:15
|
||||
msgid ""
|
||||
@ -9816,10 +9868,13 @@ msgid ""
|
||||
"some_expression?\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,ignore\n"
|
||||
"some_expression?\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/try-operator.md:19
|
||||
msgid "We can use this to simplify our error handing code:"
|
||||
msgstr ""
|
||||
msgstr "我們可以使用這個運算子，簡化錯誤處理程式碼："
|
||||
|
||||
#: src/error-handling/try-operator.md:21
|
||||
msgid ""
|
||||
@ -9848,6 +9903,30 @@ msgid ""
|
||||
"}\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,editable\n"
|
||||
"use std::fs;\n"
|
||||
"use std::io::{self, Read};\n"
|
||||
"\n"
|
||||
"fn read_username(path: &str) -> Result<String, io::Error> {\n"
|
||||
" let username_file_result = fs::File::open(path);\n"
|
||||
" let mut username_file = match username_file_result {\n"
|
||||
" Ok(file) => file,\n"
|
||||
" Err(err) => return Err(err),\n"
|
||||
" };\n"
|
||||
"\n"
|
||||
" let mut username = String::new();\n"
|
||||
" match username_file.read_to_string(&mut username) {\n"
|
||||
" Ok(_) => Ok(username),\n"
|
||||
" Err(err) => Err(err),\n"
|
||||
" }\n"
|
||||
"}\n"
|
||||
"\n"
|
||||
"fn main() {\n"
|
||||
" //fs::write(\"config.dat\", \"alice\").unwrap();\n"
|
||||
" let username = read_username(\"config.dat\");\n"
|
||||
" println!(\"username or error: {username:?}\");\n"
|
||||
"}\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/try-operator.md:50
|
||||
#: src/error-handling/converting-error-types-example.md:52
|
||||
@ -9860,13 +9939,13 @@ msgstr ""
|
||||
#: src/error-handling/converting-error-types.md:1
|
||||
#: src/error-handling/converting-error-types-example.md:1
|
||||
msgid "# Converting Error Types"
|
||||
msgstr ""
|
||||
msgstr "# 轉換錯誤類型"
|
||||
|
||||
#: src/error-handling/converting-error-types.md:3
|
||||
msgid ""
|
||||
"The effective expansion of `?` is a little more complicated than previously "
|
||||
"indicated:"
|
||||
msgstr ""
|
||||
msgstr "比起先前提到的下列程式碼，`?` 的有效擴展稍微更複雜一點："
|
||||
|
||||
#: src/error-handling/converting-error-types.md:5
|
||||
msgid ""
|
||||
@ -9874,10 +9953,13 @@ msgid ""
|
||||
"expression?\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,ignore\n"
|
||||
"expression?\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/converting-error-types.md:9
|
||||
msgid "works the same as"
|
||||
msgstr ""
|
||||
msgstr "運作方式與以下程式碼相同："
|
||||
|
||||
#: src/error-handling/converting-error-types.md:11
|
||||
msgid ""
|
||||
@ -9888,6 +9970,12 @@ msgid ""
|
||||
"}\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,ignore\n"
|
||||
"match expression {\n"
|
||||
" Ok(value) => value,\n"
|
||||
" Err(err) => return Err(From::from(err)),\n"
|
||||
"}\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/converting-error-types.md:18
|
||||
msgid ""
|
||||
@ -9895,6 +9983,7 @@ msgid ""
|
||||
"the\n"
|
||||
"type returned by the function:"
|
||||
msgstr ""
|
||||
"這裡的 `From::from` 呼叫意味著，我們嘗試將錯誤型別轉換成函式回傳的型別："
|
||||
|
||||
#: src/error-handling/converting-error-types-example.md:3
|
||||
msgid ""
|
||||
@ -9944,6 +10033,50 @@ msgid ""
|
||||
"}\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,editable\n"
|
||||
"use std::error::Error;\n"
|
||||
"use std::fmt::{self, Display, Formatter};\n"
|
||||
"use std::fs::{self, File};\n"
|
||||
"use std::io::{self, Read};\n"
|
||||
"\n"
|
||||
"#[derive(Debug)]\n"
|
||||
"enum ReadUsernameError {\n"
|
||||
" IoError(io::Error),\n"
|
||||
" EmptyUsername(String),\n"
|
||||
"}\n"
|
||||
"\n"
|
||||
"impl Error for ReadUsernameError {}\n"
|
||||
"\n"
|
||||
"impl Display for ReadUsernameError {\n"
|
||||
" fn fmt(&self, f: &mut Formatter) -> fmt::Result {\n"
|
||||
" match self {\n"
|
||||
" Self::IoError(e) => write!(f, \"IO error: {e}\"),\n"
|
||||
" Self::EmptyUsername(filename) => write!(f, \"Found no username in {filename}\"),\n"
|
||||
" }\n"
|
||||
" }\n"
|
||||
"}\n"
|
||||
"\n"
|
||||
"impl From<io::Error> for ReadUsernameError {\n"
|
||||
" fn from(err: io::Error) -> ReadUsernameError {\n"
|
||||
" ReadUsernameError::IoError(err)\n"
|
||||
" }\n"
|
||||
"}\n"
|
||||
"\n"
|
||||
"fn read_username(path: &str) -> Result<String, ReadUsernameError> {\n"
|
||||
" let mut username = String::with_capacity(100);\n"
|
||||
" File::open(path)?.read_to_string(&mut username)?;\n"
|
||||
" if username.is_empty() {\n"
|
||||
" return Err(ReadUsernameError::EmptyUsername(String::from(path)));\n"
|
||||
" }\n"
|
||||
" Ok(username)\n"
|
||||
"}\n"
|
||||
"\n"
|
||||
"fn main() {\n"
|
||||
" //fs::write(\"config.dat\", \"\").unwrap();\n"
|
||||
" let username = read_username(\"config.dat\");\n"
|
||||
" println!(\"username or error: {username:?}\");\n"
|
||||
"}\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/converting-error-types-example.md:55
|
||||
msgid ""
|
||||
@ -9958,7 +10091,7 @@ msgstr ""
|
||||
|
||||
#: src/error-handling/deriving-error-enums.md:1
|
||||
msgid "# Deriving Error Enums"
|
||||
msgstr ""
|
||||
msgstr "# 推導錯誤列舉"
|
||||
|
||||
#: src/error-handling/deriving-error-enums.md:3
|
||||
msgid ""
|
||||
@ -9966,6 +10099,8 @@ msgid ""
|
||||
"an\n"
|
||||
"error enum like we did on the previous page:"
|
||||
msgstr ""
|
||||
"[thiserror](https://docs.rs/thiserror/) crate 很常用來建立錯誤列舉，我們在上"
|
||||
"一頁就曾這麼做："
|
||||
|
||||
#: src/error-handling/deriving-error-enums.md:6
|
||||
msgid ""
|
||||
@ -10000,6 +10135,36 @@ msgid ""
|
||||
"}\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,editable,compile_fail\n"
|
||||
"use std::{fs, io};\n"
|
||||
"use std::io::Read;\n"
|
||||
"use thiserror::Error;\n"
|
||||
"\n"
|
||||
"#[derive(Debug, Error)]\n"
|
||||
"enum ReadUsernameError {\n"
|
||||
" #[error(\"Could not read: {0}\")]\n"
|
||||
" IoError(#[from] io::Error),\n"
|
||||
" #[error(\"Found no username in {0}\")]\n"
|
||||
" EmptyUsername(String),\n"
|
||||
"}\n"
|
||||
"\n"
|
||||
"fn read_username(path: &str) -> Result<String, ReadUsernameError> {\n"
|
||||
" let mut username = String::with_capacity(100);\n"
|
||||
" fs::File::open(path)?.read_to_string(&mut username)?;\n"
|
||||
" if username.is_empty() {\n"
|
||||
" return Err(ReadUsernameError::EmptyUsername(String::from(path)));\n"
|
||||
" }\n"
|
||||
" Ok(username)\n"
|
||||
"}\n"
|
||||
"\n"
|
||||
"fn main() {\n"
|
||||
" //fs::write(\"config.dat\", \"\").unwrap();\n"
|
||||
" match read_username(\"config.dat\") {\n"
|
||||
" Ok(username) => println!(\"Username: {username}\"),\n"
|
||||
" Err(err) => println!(\"Error: {err}\"),\n"
|
||||
" }\n"
|
||||
"}\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/deriving-error-enums.md:39
|
||||
msgid ""
|
||||
@ -10016,7 +10181,7 @@ msgstr ""
|
||||
|
||||
#: src/error-handling/dynamic-errors.md:1
|
||||
msgid "# Dynamic Error Types"
|
||||
msgstr ""
|
||||
msgstr "# 動態錯誤型別"
|
||||
|
||||
#: src/error-handling/dynamic-errors.md:3
|
||||
msgid ""
|
||||
@ -10024,6 +10189,8 @@ msgid ""
|
||||
"our own enum covering\n"
|
||||
"all the different possibilities. `std::error::Error` makes this easy."
|
||||
msgstr ""
|
||||
"我們有時會想允許傳回任何型別的錯誤，而不是自行編寫涵蓋所有不同可能性的列舉。"
|
||||
"`std::error::Error` 可讓這項工作更輕鬆。"
|
||||
|
||||
#: src/error-handling/dynamic-errors.md:6
|
||||
msgid ""
|
||||
@ -10055,6 +10222,33 @@ msgid ""
|
||||
"}\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,editable,compile_fail\n"
|
||||
"use std::fs::{self, File};\n"
|
||||
"use std::io::Read;\n"
|
||||
"use thiserror::Error;\n"
|
||||
"use std::error::Error;\n"
|
||||
"\n"
|
||||
"#[derive(Clone, Debug, Eq, Error, PartialEq)]\n"
|
||||
"#[error(\"Found no username in {0}\")]\n"
|
||||
"struct EmptyUsernameError(String);\n"
|
||||
"\n"
|
||||
"fn read_username(path: &str) -> Result<String, Box<dyn Error>> {\n"
|
||||
" let mut username = String::with_capacity(100);\n"
|
||||
" File::open(path)?.read_to_string(&mut username)?;\n"
|
||||
" if username.is_empty() {\n"
|
||||
" return Err(EmptyUsernameError(String::from(path)).into());\n"
|
||||
" }\n"
|
||||
" Ok(username)\n"
|
||||
"}\n"
|
||||
"\n"
|
||||
"fn main() {\n"
|
||||
" //fs::write(\"config.dat\", \"\").unwrap();\n"
|
||||
" match read_username(\"config.dat\") {\n"
|
||||
" Ok(username) => println!(\"Username: {username}\"),\n"
|
||||
" Err(err) => println!(\"Error: {err}\"),\n"
|
||||
" }\n"
|
||||
"}\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/dynamic-errors.md:36
|
||||
msgid ""
|
||||
@ -10069,7 +10263,7 @@ msgstr ""
|
||||
|
||||
#: src/error-handling/error-contexts.md:1
|
||||
msgid "# Adding Context to Errors"
|
||||
msgstr ""
|
||||
msgstr "# 為錯誤添加背景資訊"
|
||||
|
||||
#: src/error-handling/error-contexts.md:3
|
||||
msgid ""
|
||||
@ -10077,6 +10271,8 @@ msgid ""
|
||||
"contextual information to your errors and allows you to have fewer\n"
|
||||
"custom error types:"
|
||||
msgstr ""
|
||||
"透過廣泛使用的 [anyhow](https://docs.rs/anyhow/) crate，您可以為錯誤添加背景"
|
||||
"資訊，並減少自訂錯誤型別的數量："
|
||||
|
||||
#: src/error-handling/error-contexts.md:7
|
||||
msgid ""
|
||||
@ -10106,6 +10302,31 @@ msgid ""
|
||||
"}\n"
|
||||
"```"
|
||||
msgstr ""
|
||||
"```rust,editable,compile_fail\n"
|
||||
"use std::{fs, io};\n"
|
||||
"use std::io::Read;\n"
|
||||
"use anyhow::{Context, Result, bail};\n"
|
||||
"\n"
|
||||
"fn read_username(path: &str) -> Result<String> {\n"
|
||||
" let mut username = String::with_capacity(100);\n"
|
||||
" fs::File::open(path)\n"
|
||||
" .with_context(|| format!(\"Failed to open {path}\"))?\n"
|
||||
" .read_to_string(&mut username)\n"
|
||||
" .context(\"Failed to read\")?;\n"
|
||||
" if username.is_empty() {\n"
|
||||
" bail!(\"Found no username in {path}\");\n"
|
||||
" }\n"
|
||||
" Ok(username)\n"
|
||||
"}\n"
|
||||
"\n"
|
||||
"fn main() {\n"
|
||||
" //fs::write(\"config.dat\", \"\").unwrap();\n"
|
||||
" match read_username(\"config.dat\") {\n"
|
||||
" Ok(username) => println!(\"Username: {username}\"),\n"
|
||||
" Err(err) => println!(\"Error: {err:?}\"),\n"
|
||||
" }\n"
|
||||
"}\n"
|
||||
"```"
|
||||
|
||||
#: src/error-handling/error-contexts.md:35
|
||||
msgid ""
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user