diff --git a/po/fa.po b/po/fa.po index af6be5d9d18..406545c33ff 100644 --- a/po/fa.po +++ b/po/fa.po @@ -2,7 +2,7 @@ msgid "" msgstr "" "Project-Id-Version: Comprehensive Rust 🦀\n" "POT-Creation-Date: 2024-07-24T09:42:45+03:30\n" -"PO-Revision-Date: 2024-08-07 22:37+0330\n" +"PO-Revision-Date: 2024-09-08 20:39+0330\n" "Last-Translator: alix1383 \n" "Language-Team: Persian\n" "Language: fa\n" @@ -442,7 +442,7 @@ msgstr "تمرین: ROT13" #: src/SUMMARY.md msgid "Day 3: Morning" -msgstr "روز سوم: صبح" +msgstr "روز ۳: صبح" #: src/SUMMARY.md src/running-the-course/course-structure.md:53 #: src/welcome-day-3.md src/memory-management.md @@ -451,7 +451,7 @@ msgstr "مدیریت حافظه" #: src/SUMMARY.md src/memory-management.md src/memory-management/review.md:1 msgid "Review of Program Memory" -msgstr "" +msgstr "بررسی حافظه برنامه" #: src/SUMMARY.md src/memory-management.md #: src/memory-management/approaches.md:1 @@ -468,7 +468,7 @@ msgstr "مفاهیم جابه‌جایی" #: src/SUMMARY.md msgid "`Clone`" -msgstr "" +msgstr "`Clone`" #: src/SUMMARY.md src/memory-management.md #: src/memory-management/copy-types.md:1 @@ -477,7 +477,7 @@ msgstr "کپی کردن تایپ‌ها" #: src/SUMMARY.md msgid "`Drop`" -msgstr "" +msgstr "`Drop`" #: src/SUMMARY.md src/memory-management.md src/memory-management/exercise.md:1 msgid "Exercise: Builder Type" @@ -491,33 +491,32 @@ msgstr "اشاره‌گرهای هوشمند" #: src/SUMMARY.md src/smart-pointers/box.md:1 #: src/android/interoperability/cpp/type-mapping.md:9 msgid "`Box`" -msgstr "" +msgstr "`C، C++ ، " -"پاسکال، ..." +msgstr "کنترل کامل از طریق مدیریت دستی حافظه: C++، C، پاسکال، ..." #: src/memory-management/approaches.md:6 msgid "Programmer decides when to allocate or free heap memory." -msgstr "" +msgstr "برنامه‌نویس تصمیم می‌گیرد که چه زمانی حافظه heap را تخصیص یا آزاد کند." #: src/memory-management/approaches.md:7 msgid "" "Programmer must determine whether a pointer still points to valid memory." msgstr "" +"برنامه‌نویس باید تعیین کند که آیا یک اشاره‌گر هنوز به حافظه معتبر اشاره می‌کند " +"یا نه." #: src/memory-management/approaches.md:8 msgid "Studies show, programmers make mistakes." -msgstr "" +msgstr "مطالعات نشان می‌دهد که برنامه‌نویسان اشتباهاتی مرتکب می‌شوند." #: src/memory-management/approaches.md:9 msgid "" "Full safety via automatic memory management at runtime: Java, Python, Go, " "Haskell, ..." msgstr "" -"ایمنی کامل از طریق مدیریت حافظه خودکار در زمان اجرا: جاوا، پایتون، Go، " -"Haskell، ..." +"ایمنی کامل از طریق مدیریت خودکار حافظه در زمان اجرا: جاوا، پایتون، گو، " +"هسکل، ..." #: src/memory-management/approaches.md:11 msgid "" "A runtime system ensures that memory is not freed until it can no longer be " "referenced." msgstr "" +"یک سیستم زمان اجرا اطمینان می‌یابد که حافظه تا زمانی که دیگر نتواند به آن " +"ارجاع داده شود، آزاد نمی‌شود." #: src/memory-management/approaches.md:13 msgid "" "Typically implemented with reference counting, garbage collection, or RAII." msgstr "" +"معمولاً با استفاده از شمارش ارجاع، جمع‌آوری زباله، یا RAII پیاده‌سازی می‌شود." #: src/memory-management/approaches.md:15 msgid "Rust offers a new mix:" -msgstr "زبان Rust یک ترکیبی از هر را ارائه میدهد:" +msgstr "Rust یک ترکیب جدید ارائه می‌دهد:" #: src/memory-management/approaches.md:17 msgid "" "Full control _and_ safety via compile time enforcement of correct memory " "management." -msgstr "مدیریت کامل و ایمنی حافظه با مدیریت درست حافظه در زمان کامپایل." +msgstr "کنترل کامل و ایمنی از طریق اجرای صحیح مدیریت حافظه در زمان کامپایل." #: src/memory-management/approaches.md:20 msgid "It does this with an explicit ownership concept." -msgstr "این کار رو با کمک مفهوم مالکیت صریح انجام میدهد." +msgstr "این کار را با استفاده از مفهوم مالکیت صریح انجام می‌دهد." #: src/memory-management/approaches.md:25 msgid "" "This slide is intended to help students coming from other languages to put " "Rust in context." msgstr "" +"این اسلاید به منظور کمک به دانش‌آموزانی است که از زبان‌های دیگر می‌آیند تا Rust " +"را در زمینه مناسب قرار دهند." #: src/memory-management/approaches.md:28 msgid "" @@ -7946,6 +7957,10 @@ msgid "" "forgetting to call `free`, calling it multiple times for the same pointer, " "or dereferencing a pointer after the memory it points to has been freed." msgstr "" +"C باید حافظه heap را به‌طور دستی با استفاده از `malloc` و `free` مدیریت کند. " +"خطاهای رایج شامل فراموش کردن فراخوانی `free`، فراخوانی آن چندین بار برای یک " +"اشاره‌گر، یا dereference کردن یک اشاره‌گر پس از آزاد شدن حافظه‌ای است که به آن " +"اشاره می‌کند." #: src/memory-management/approaches.md:32 msgid "" @@ -7954,6 +7969,11 @@ msgid "" "is freed when a function returns. It is still quite easy to mis-use these " "tools and create similar bugs to C." msgstr "" +"++C ابزارهایی مانند اشاره‌گرهای هوشمند (`unique_ptr`, `shared_ptr`) دارد که " +"از تضمین‌های زبانی درباره فراخوانی ویرایشگرها (destructor) برای اطمینان از " +"آزاد شدن حافظه هنگام بازگشت از تابع استفاده می‌کنند. با این حال، هنوز هم " +"بسیار آسان است که از این ابزارها به اشتباه استفاده کرده و باگ‌هایی مشابه به C " +"ایجاد کرد." #: src/memory-management/approaches.md:37 msgid "" @@ -7962,6 +7982,11 @@ msgid "" "be dereferenced, eliminating use-after-free and other classes of bugs. But, " "GC has a runtime cost and is difficult to tune properly." msgstr "" +"جاوا، گو و پایتون به جمع‌آوری‌کننده زباله (garbage collector) برای شناسایی " +"حافظه‌ای که دیگر در دسترس نیست و دور ریختن آن متکی هستند. این امر تضمین می‌کند " +"که هر اشاره‌گری می‌تواند dereference شود و از بروز خطاهای استفاده پس از " +"آزادسازی (use-after-free) و سایر دسته‌های باگ جلوگیری می‌کند. اما، GC هزینه‌ای " +"در زمان اجرا دارد و تنظیم مناسب آن دشوار است." #: src/memory-management/approaches.md:42 msgid "" @@ -7972,28 +7997,36 @@ msgid "" "are even third-party crates available to support runtime garbage collection " "(not covered in this class)." msgstr "" +"مدل مالکیت و قرض‌گیری Rust (ownership and borrowing) می‌تواند در بسیاری از " +"موارد عملکرد C را با عملیات‌های تخصیص و آزادسازی دقیقاً در مکان‌های مورد نیاز " +"-- با هزینه صفر -- به دست آورد. همچنین ابزارهایی مشابه به اشاره‌گرهای هوشمند +" +"+C را فراهم می‌کند. در صورت نیاز، گزینه‌های دیگری مانند شمارش ارجاع نیز در " +"دسترس هستند و حتی crates شخص ثالثی برای پشتیبانی از جمع‌آوری زباله در زمان " +"اجرا موجود است (که در این کلاس پوشش داده نمی‌شود)." #: src/memory-management/ownership.md:3 msgid "" "All variable bindings have a _scope_ where they are valid and it is an error " "to use a variable outside its scope:" msgstr "" -"همه انتساب متغیر دارای یک *اسکوپ* هستند که در آن معتبر هستند و استفاده از یک " -"متغیر خارج از اسکوپ آن خطا است:" +"تمام پیوندهای متغیر دارای یک **دامنه** هستند که در آن معتبر هستند و استفاده " +"از متغیر خارج از دامنه‌اش یک خطاست:" #: src/memory-management/ownership.md:20 -#, fuzzy msgid "" "We say that the variable _owns_ the value. Every Rust value has precisely " "one owner at all times." -msgstr "ما می‌گوییم که متغیر *مالکیت* یک مقدار است." +msgstr "" +"می‌گوییم که متغیر _مالک_ مقدار است. هر مقدار در Rust در هر لحظه دقیقاً یک مالک " +"دارد." #: src/memory-management/ownership.md:23 -#, fuzzy msgid "" "At the end of the scope, the variable is _dropped_ and the data is freed. A " "destructor can run here to free up resources." -msgstr "در پایان اسکوپ، متغیر حذف می‌شود و داده‌ها آزاد می‌شوند." +msgstr "" +"در پایان دامنه، متغیر **حذف** می‌شود و داده‌ها آزاد می‌شوند. یک ویرایشگر " +"(destructor) می‌تواند در اینجا اجرا شود تا منابع را آزاد کند." #: src/memory-management/ownership.md:29 msgid "" @@ -8001,19 +8034,21 @@ msgid "" "garbage collector starts with a set of \"roots\" to find all reachable " "memory. Rust's \"single owner\" principle is a similar idea." msgstr "" +"دانش‌آموزانی که با پیاده‌سازی‌های جمع‌آوری زباله آشنا هستند، خواهند دانست که یک " +"جمع‌آوری‌کننده زباله با مجموعه‌ای از \"ریشه‌ها\" برای یافتن تمام حافظه‌های قابل " +"دسترسی شروع می‌کند. اصول \"مالکیت تک‌گانه\" Rust ایده مشابهی است." #: src/memory-management/move.md:3 msgid "An assignment will transfer _ownership_ between variables:" msgstr "انتساب, *مالکیت* را بین متغیرها منتقل می‌کند:" #: src/memory-management/move.md:7 -#, fuzzy msgid "\"Hello!\"" -msgstr "سلام دنیا" +msgstr "\"سلام!\"" #: src/memory-management/move.md:10 msgid "// println!(\"s1: {s1}\");\n" -msgstr "" +msgstr "// println!(\"s1: {s1}\");\n" #: src/memory-management/move.md:14 msgid "The assignment of `s1` to `s2` transfers ownership." @@ -8071,17 +8106,16 @@ msgstr "" #: src/memory-management/move.md:63 src/memory-management/clone.md:8 msgid "\"Hello {name}\"" -msgstr "" +msgstr "\"سلام {name}\"" #: src/memory-management/move.md:67 src/memory-management/clone.md:12 #: src/android/interoperability/java.md:57 -#, fuzzy msgid "\"Alice\"" -msgstr "برش‌ها" +msgstr "\"الیس\"" #: src/memory-management/move.md:69 msgid "// say_hello(name);\n" -msgstr "" +msgstr "// say_hello(name);\n" #: src/memory-management/move.md:76 msgid "" @@ -8115,7 +8149,7 @@ msgstr "در Rust، کلون‌ها واضح بیان می‌شوند (با اس #: src/memory-management/move.md:87 msgid "In the `say_hello` example:" -msgstr "" +msgstr "در مثال `say_hello`:" #: src/memory-management/move.md:89 msgid "" @@ -8169,11 +8203,11 @@ msgstr "C++ مدرن این مشکل را به شیوه م #: src/memory-management/move.md:107 msgid "\"Cpp\"" -msgstr "" +msgstr "\"Cpp\"" #: src/memory-management/move.md:108 msgid "// Duplicate the data in s1.\n" -msgstr "" +msgstr "// Duplicate the data in s1.\n" #: src/memory-management/move.md:111 msgid "" @@ -8235,30 +8269,40 @@ msgid "" "Sometimes you _want_ to make a copy of a value. The `Clone` trait " "accomplishes this." msgstr "" +"گاهی اوقات شما _می‌خواهید_ یک نسخه از مقدار بسازید. ویژگی `Clone` این کار را " +"انجام می‌دهد." #: src/memory-management/clone.md:21 msgid "" "The idea of `Clone` is to make it easy to spot where heap allocations are " "occurring. Look for `.clone()` and a few others like `vec!` or `Box::new`." msgstr "" +"ایده‌ی `Clone` این است که شناسایی مکان‌های تخصیص حافظه heap آسان‌تر شود. به " +"دنبال `()clone.` و چند مورد دیگر مانند `!vec` یا `Box::new` بگردید." #: src/memory-management/clone.md:24 msgid "" "It's common to \"clone your way out\" of problems with the borrow checker, " "and return later to try to optimize those clones away." msgstr "" +"معمولاً برای حل مشکلات مربوط به بررسی‌کننده قرض‌گیری (borrow checker) از کپی " +"کردن استفاده می‌شود و سپس در آینده تلاش می‌شود تا آن کپی‌ها بهینه‌سازی شوند." #: src/memory-management/clone.md:27 msgid "" "`clone` generally performs a deep copy of the value, meaning that if you e." "g. clone an array, all of the elements of the array are cloned as well." msgstr "" +"`clone` معمولاً یک کپی عمیق از مقدار را انجام می‌دهد، به این معنی که اگر به " +"عنوان مثال یک آرایه را کپی کنید، تمام عناصر آن آرایه نیز کپی خواهند شد." #: src/memory-management/clone.md:30 msgid "" "The behavior for `clone` is user-defined, so it can perform custom cloning " "logic if needed." msgstr "" +"رفتار `clone` توسط کاربر تعریف می‌شود، بنابراین می‌تواند در صورت نیاز، منطق " +"کپی‌برداری سفارشی را اجرا کند." #: src/memory-management/copy-types.md:3 msgid "" @@ -8330,13 +8374,12 @@ msgstr "" "یک نوع `Copy` نیست." #: src/memory-management/copy-types.md:53 -#, fuzzy msgid "" "Remove `Copy` from the `derive` attribute. The compiler error is now in the " "`println!` for `p1`." msgstr "" -"ویژگی `Copy` را از ویژگی‌های `derive` حذف کنید. خطای کامپایلر اکنون در `println!` برای `p1` است." +"ویژگی `Copy` را از صفت `derive` حذف کنید. اکنون خطای کامپایلر در `!println` " +"برای `p1` قرار دارد." #: src/memory-management/copy-types.md:55 msgid "Show that it works if you clone `p1` instead." @@ -8349,69 +8392,82 @@ msgid "" "valid to make a copy of a shared reference, creating a copy of a mutable " "reference would violate Rust's borrowing rules." msgstr "" +"ارجاعات مشترک (`shared references`) دارای ویژگی `Copy`/`Clone` هستند، اما " +"ارجاعات قابل تغییر (`mutable references`) این‌طور نیستند. این به این دلیل است " +"که Rust نیاز دارد که ارجاعات قابل تغییر منحصر به فرد باشند، بنابراین در حالی " +"که کپی کردن یک ارجاع مشترک معتبر است، ایجاد یک کپی از یک ارجاع قابل تغییر " +"قوانین قرض‌گیری Rust را نقض می‌کند." #: src/memory-management/drop.md:1 msgid "The `Drop` Trait" -msgstr "" +msgstr "ویژگی `Drop`" #: src/memory-management/drop.md:3 msgid "" "Values which implement [`Drop`](https://doc.rust-lang.org/std/ops/trait.Drop." "html) can specify code to run when they go out of scope:" msgstr "" +"مقادیر که ویژگی [`Drop`](https://doc.rust-lang.org/std/ops/trait.Drop.html) " +"را پیاده‌سازی می‌کنند می‌توانند کدی را مشخص کنند که هنگام خروج از دامنه اجرا " +"شود:" #: src/memory-management/drop.md:13 msgid "\"Dropping {}\"" -msgstr "" +msgstr "\"Dropping {}\"" #: src/memory-management/drop.md:18 #: src/concurrency/sync-exercises/link-checker.md:85 #: src/concurrency/sync-exercises/solutions.md:121 msgid "\"a\"" -msgstr "" +msgstr "\"a\"" #: src/memory-management/drop.md:20 src/android/testing/googletest.md:12 msgid "\"b\"" -msgstr "" +msgstr "\"a\"" #: src/memory-management/drop.md:22 msgid "\"c\"" -msgstr "" +msgstr "\"a\"" #: src/memory-management/drop.md:23 msgid "\"d\"" -msgstr "" +msgstr "\"a\"" #: src/memory-management/drop.md:24 msgid "\"Exiting block B\"" -msgstr "" +msgstr "\"Exiting block B\"" #: src/memory-management/drop.md:26 msgid "\"Exiting block A\"" -msgstr "" +msgstr "\"Exiting block A\"" #: src/memory-management/drop.md:29 msgid "\"Exiting main\"" -msgstr "" +msgstr "\"Exiting main\"" #: src/memory-management/drop.md:36 msgid "Note that `std::mem::drop` is not the same as `std::ops::Drop::drop`." msgstr "" +"توجه داشته باشید که `std::mem::drop` با `std::ops::Drop::drop` یکسان نیست." #: src/memory-management/drop.md:37 msgid "Values are automatically dropped when they go out of scope." -msgstr "" +msgstr "مقادیر به طور خودکار زمانی که از دامنه خارج می‌شوند، حذف می‌شوند." #: src/memory-management/drop.md:38 msgid "" "When a value is dropped, if it implements `std::ops::Drop` then its `Drop::" "drop` implementation will be called." msgstr "" +"زمانی که یک مقدار حذف می‌شود، اگر آن مقدار ویژگی `std::ops::Drop` را " +"پیاده‌سازی کرده باشد، پیاده‌سازی `Drop::drop` آن فراخوانی خواهد شد." #: src/memory-management/drop.md:40 msgid "" "All its fields will then be dropped too, whether or not it implements `Drop`." msgstr "" +"تمام فیلدهای آن نیز سپس حذف خواهند شد، چه آن مقدار ویژگی `Drop` را پیاده‌سازی " +"کرده باشد یا نه." #: src/memory-management/drop.md:41 msgid "" @@ -8420,26 +8476,35 @@ msgid "" "scope it gets dropped. This makes it a convenient way to explicitly drop " "values earlier than they would otherwise go out of scope." msgstr "" +"`std::mem::drop` یک تابع خالی است که هر مقداری را می‌پذیرد. اهمیت آن در این " +"است که مالکیت مقدار را به عهده می‌گیرد، بنابراین در پایان دامنه‌اش حذف می‌شود. " +"این ویژگی آن را به روشی مناسب برای حذف صریح مقادیر پیش از آنچه که معمولاً از " +"دامنه خارج می‌شوند، تبدیل می‌کند." #: src/memory-management/drop.md:45 msgid "" "This can be useful for objects that do some work on `drop`: releasing locks, " "closing files, etc." msgstr "" +"این می‌تواند برای اشیائی که در هنگام `drop` کاری انجام می‌دهند مفید باشد: آزاد " +"کردن قفل‌ها، بستن فایل‌ها و غیره." #: src/memory-management/drop.md:50 msgid "Why doesn't `Drop::drop` take `self`?" -msgstr "" +msgstr "چرا `Drop::drop` `self` را نمی‌گیرد؟" #: src/memory-management/drop.md:51 msgid "" "Short-answer: If it did, `std::mem::drop` would be called at the end of the " "block, resulting in another call to `Drop::drop`, and a stack overflow!" msgstr "" +"پاسخ کوتاه: اگر این‌طور بود، `std::mem::drop` در پایان بلوک فراخوانی می‌شد که " +"منجر به فراخوانی مجدد `Drop::drop` و ایجاد خطای سرریز (stack overflow) stack " +"می‌شد!" #: src/memory-management/drop.md:53 msgid "Try replacing `drop(a)` with `a.drop()`." -msgstr "" +msgstr "سعی کنید `drop(a)` را با `()a.drop` جایگزین کنید." #: src/memory-management/exercise.md:3 msgid "" @@ -8447,10 +8512,13 @@ msgid "" "data. We will use the \"builder pattern\" to support building a new value " "piece-by-piece, using convenience functions." msgstr "" +"در این مثال، ما یک نوع داده پیچیده را پیاده‌سازی خواهیم کرد که مالک تمام " +"داده‌های خود است. ما از \"الگوی سازنده\" برای پشتیبانی از ساخت یک مقدار جدید " +"به صورت قطعه‌قطعه، با استفاده از توابع کمکی، استفاده خواهیم کرد." #: src/memory-management/exercise.md:7 msgid "Fill in the missing pieces." -msgstr "" +msgstr "جا‌های خالی را پر کنید." #: src/memory-management/exercise.md:22 src/memory-management/solution.md:16 msgid "/// A representation of a software package.\n" @@ -8549,7 +8617,7 @@ msgstr "" #: src/smart-pointers.md msgid "Box" -msgstr "" +msgstr "Box" #: src/smart-pointers.md msgid "Rc" @@ -8560,6 +8628,8 @@ msgid "" "[`Box`](https://doc.rust-lang.org/std/boxed/struct.Box.html) is an owned " "pointer to data on the heap:" msgstr "" +"[`Box`](https://doc.rust-lang.org/std/boxed/struct.Box.html) یک اشاره‌گر مالک " +"به داده‌های روی heap است:" #: src/smart-pointers/box.md:9 msgid "\"five: {}\"" @@ -8571,11 +8641,16 @@ msgid "" "methods from `T` directly on a `Box`](https://doc.rust-lang.org/std/ops/" "trait.Deref.html#more-on-deref-coercion)." msgstr "" +"``." msgstr "" +"پیش‌تر دیدیم که چگونه می‌توان ازویژگی اشیاء (trait objects) با ارجاعات استفاده " +"کرد، مثلاً `dyn Pet&`. با این حال، می‌توانیم از اشیاء ویژگی با اشاره‌گرهای " +"هوشمند مانند `Box` نیز استفاده کنیم تا یک شیء ویژگی مالک (owned trait " +"object) ایجاد کنیم: `` in the example above." msgstr "" +"تایپ‌هایی که ویژگی معین را پیاده‌سازی می‌کنند ممکن است اندازه‌های مختلفی داشته " +"باشند. این موضوع باعث می‌شود که داشتن مواردی مانند ` and fill in the missing " "method:" msgstr "" -"کد زیر را در کپی کرده و " -"توابع را پیاده‌سازی کنید:" +"کد زیر را به کپی کنید و متد‌های ناقص را تکمیل " +"کنید:" #: src/borrowing/exercise.md:45 msgid "" @@ -9167,6 +9385,8 @@ msgid "" "A reference has a _lifetime_, which must not \"outlive\" the value it refers " "to. This is verified by the borrow checker." msgstr "" +"یک مرجع دارای _طول عمر_ است که نباید از ارزش مورد اشاره بیشتر باشد. این " +"موضوع توسط بررسی‌کننده قرض‌ها تایید می‌شود." #: src/lifetimes/lifetime-annotations.md:6 msgid "" @@ -9175,6 +9395,10 @@ msgid "" "`'` and `'a` is a typical default name. Read `&'a Point` as \"a borrowed " "`Point` which is valid for at least the lifetime `a`\"." msgstr "" +"طول عمر می‌تواند ضمنی باشد - این همان چیزی است که تا کنون مشاهده کرده‌ایم. طول " +"عمرها می‌توانند صریح نیز باشند: `&'a Point`، `&'document str`. طول عمرها با " +"`'` شروع می‌شوند و `'a` نام پیش‌فرض معمولی است. `&'a Point` را به عنوان \"یک " +"`Point` قرضی که برای حداقل طول عمر `a` معتبر است\" بخوانید." #: src/lifetimes/lifetime-annotations.md:11 msgid "" @@ -9182,12 +9406,17 @@ msgid "" "yourself. Explicit lifetime annotations create constraints where there is " "ambiguity; the compiler verifies that there is a valid solution." msgstr "" +"طول عمرها همیشه توسط کامپایلر استنتاج می‌شوند: شما نمی‌توانید به طور دستی طول " +"عمر را اختصاص دهید. انتساب‌های صریح طول عمر محدودیت‌هایی ایجاد می‌کنند که در " +"صورت وجود ابهام است؛ کامپایلر تأیید می‌کند که یک راه‌حل معتبر وجود دارد." #: src/lifetimes/lifetime-annotations.md:15 msgid "" "Lifetimes become more complicated when considering passing values to and " "returning values from functions." msgstr "" +"طول عمرها وقتی که به عبور مقادیر به توابع و بازگشت مقادیر از توابع می‌پردازیم " +"پیچیده‌تر می‌شوند." #: src/lifetimes/lifetime-annotations.md:36 msgid "// What is the lifetime of p3?\n" @@ -9205,21 +9434,29 @@ msgid "" "requires explicit annotations of lifetimes on function arguments and return " "values." msgstr "" +"در این مثال، کامپایلر نمی‌داند که طول عمر `p3` را چگونه استنباط کند. نگاه " +"کردن به بدنه تابع نشان می‌دهد که تنها به‌طور ایمن می‌تواند فرض کند که طول عمر " +"`p3` کوتاه‌تر از `p1` و `p2` است. اما مانند تایپ‌ها، راست نیاز به توضیحات صریح " +"طول عمرها در آرگومان‌های تابع و مقادیر بازگشتی دارد." #: src/lifetimes/lifetime-annotations.md:50 msgid "Add `'a` appropriately to `left_most`:" -msgstr "" +msgstr "به تابع `left_most` به صورت مناسب `'a` را اضافه کنید:" #: src/lifetimes/lifetime-annotations.md:56 msgid "" "This says, \"given p1 and p2 which both outlive `'a`, the return value lives " "for at least `'a`." msgstr "" +"این به این معناست که \"با توجه به اینکه `p1` و `p2` هر دو از `'a` بیشتر عمر " +"می‌کنند، مقدار بازگشتی برای مدت `'a` معتبر خواهد بود.\"" #: src/lifetimes/lifetime-annotations.md:59 msgid "" "In common cases, lifetimes can be elided, as described on the next slide." msgstr "" +"در موارد معمول، عمر متغیرها می‌تواند نادیده گرفته شود، همانطور که در اسلاید " +"بعدی توضیح داده شده است." #: src/lifetimes/lifetime-elision.md:1 msgid "Lifetimes in Function Calls" @@ -9232,36 +9469,50 @@ msgid "" "rules](https://doc.rust-lang.org/nomicon/lifetime-elision.html). This is not " "inference -- it is just a syntactic shorthand." msgstr "" +"عمرهای مربوط به آرگومان‌های تابع و مقادیر بازگشتی باید به طور کامل مشخص شوند، " +"اما Rust اجازه می‌دهد عمرها در بیشتر موارد با [چند قانون ساده](https://doc." +"rust-lang.org/nomicon/lifetime-elision.html) نادیده گرفته شوند. این مسئله " +"استنتاج نیست -- بلکه تنها یک اصطلاح نوشتاری کوتاه است." #: src/lifetimes/lifetime-elision.md:8 msgid "Each argument which does not have a lifetime annotation is given one." msgstr "" +"هر آرگومان که فاقد یک lifetime annotation است، یک عمر به آن اختصاص داده " +"می‌شود." #: src/lifetimes/lifetime-elision.md:9 msgid "" "If there is only one argument lifetime, it is given to all un-annotated " "return values." msgstr "" +"اگر تنها یک عمر برای آرگومان وجود داشته باشد، به تمام مقادیر بازگشتی که " +"حاشیه‌نویسی نشده‌اند، اختصاص داده می‌شود." #: src/lifetimes/lifetime-elision.md:11 msgid "" "If there are multiple argument lifetimes, but the first one is for `self`, " "that lifetime is given to all un-annotated return values." msgstr "" +"اگر چندین عمر آرگومان وجود داشته باشد و اولین آن برای `self` باشد، آن عمر به " +"تمام مقادیر بازگشتی که حاشیه‌نویسی نشده‌اند، اختصاص داده می‌شود." #: src/lifetimes/lifetime-elision.md:53 msgid "In this example, `cab_distance` is trivially elided." -msgstr "" +msgstr "در این مثال، `cab_distance` به طور خودکار حذف می‌شود." #: src/lifetimes/lifetime-elision.md:55 msgid "" "The `nearest` function provides another example of a function with multiple " "references in its arguments that requires explicit annotation." msgstr "" +"تابع `nearest` مثال دیگری از تابعی است که با ارجاعات متعدد در آرگومان‌هایش " +"نیاز به حاشیه‌نویسی صریح دارد." #: src/lifetimes/lifetime-elision.md:58 msgid "Try adjusting the signature to \"lie\" about the lifetimes returned:" msgstr "" +"امضا را طوری تنظیم کنید که \"دروغ\" بگوید درباره طول عمر مقادیری که برگشت " +"داده می‌شوند:" #: src/lifetimes/lifetime-elision.md:64 msgid "" @@ -9269,6 +9520,10 @@ msgid "" "validity by the compiler. Note that this is not the case for raw pointers " "(unsafe), and this is a common source of errors with unsafe Rust." msgstr "" +"این کد کامپایل نخواهد شد، که نشان‌دهنده این است که برچسب‌های طول عمر توسط " +"کامپایلر برای اعتبارسنجی بررسی می‌شوند. توجه داشته باشید که این وضعیت برای " +"اشاره‌گرهای خام (ناامن) صدق نمی‌کند و این یکی از منابع رایج خطاها در Rust " +"ناامن است." #: src/lifetimes/lifetime-elision.md:68 msgid "" @@ -9278,6 +9533,12 @@ msgid "" "help resolve ambiguity. Often, especially when prototyping, it's easier to " "just work with owned data by cloning values where necessary." msgstr "" +"دانش‌آموزان ممکن است بپرسند که چه زمانی باید از طول عمرها استفاده کرد. در " +"Rust، _همیشه_ برای قرض‌ها طول عمر وجود دارد. بیشتر مواقع، حذف و استنباط تایپ " +"به این معنی است که نیازی به نوشتن این طول عمرها نیست. در موارد پیچیده‌تر، " +"برچسب‌های طول عمر می‌توانند به حل ابهام کمک کنند. اغلب، به‌ویژه در هنگام " +"پروتوتایپ‌سازی، راحت‌تر است که با داده‌های مالکیت‌شده کار کنید و مقادیر را در " +"صورت لزوم کلون کنید." #: src/lifetimes/struct-lifetimes.md:1 msgid "Lifetimes in Data Structures" @@ -9287,6 +9548,7 @@ msgstr "طول عمر در ساختمان داده" msgid "" "If a data type stores borrowed data, it must be annotated with a lifetime:" msgstr "" +"اگر یک تایپ داده داده‌های قرضی را ذخیره کند، باید با یک طول عمر مشخص شود:" #: src/lifetimes/struct-lifetimes.md:10 msgid "\"Bye {text}!\"" @@ -9314,12 +9576,17 @@ msgid "" "underlying the contained `&str` lives at least as long as any instance of " "`Highlight` that uses that data." msgstr "" +"در مثال بالا، حاشیه‌نویسی بر روی `Highlight` تضمین می‌کند که داده‌های زیرین " +"`str&` به مدت حداقل برابر با هر نمونه از `Highlight` که از آن داده استفاده " +"می‌کند، زنده بماند." #: src/lifetimes/struct-lifetimes.md:29 msgid "" "If `text` is consumed before the end of the lifetime of `fox` (or `dog`), " "the borrow checker throws an error." msgstr "" +"اگر `text` قبل از پایان عمر `fox` (یا `dog`) مصرف شود، بررسی‌کننده‌ی قرض " +"(borrow checker) خطا می‌دهد." #: src/lifetimes/struct-lifetimes.md:31 msgid "" @@ -9327,10 +9594,13 @@ msgid "" "can be useful for creating lightweight views, but it generally makes them " "somewhat harder to use." msgstr "" +"تایپ‌های دارای داده‌های قرضی (borrowed data) کاربران را مجبور می‌کنند تا " +"داده‌های اصلی را نگه دارند. این می‌تواند برای ایجاد نمایه‌های سبک مفید باشد، " +"اما معمولاً استفاده از آنها را تا حدی دشوارتر می‌کند." #: src/lifetimes/struct-lifetimes.md:34 msgid "When possible, make data structures own their data directly." -msgstr "" +msgstr "در صورت امکان، داده‌های ساختارها را به طور مستقیم مالکیت کنید." #: src/lifetimes/struct-lifetimes.md:35 msgid "" @@ -9339,6 +9609,10 @@ msgid "" "relationships between the references themselves, in addition to the lifetime " "of the struct itself. Those are very advanced use cases." msgstr "" +"برخی از ساختارهای داده که شامل چندین ارجاع هستند، ممکن است نیاز به چندین " +"نشانه‌گذاری عمر داشته باشند. این امر می‌تواند ضروری باشد اگر بخواهید روابط " +"عمری بین ارجاعات مختلف را به علاوه عمر ساختار خود توصیف کنید. این موارد " +"بسیار پیشرفته هستند." #: src/lifetimes/exercise.md:3 msgid "" @@ -9347,6 +9621,10 @@ msgid "" "simpler than it seems! This illustrates a common parsing pattern, passing " "slices of data. The underlying data itself is never copied." msgstr "" +"در این تمرین، شما یک تجزیه‌کننده برای [رمزگذاری باینری پروتوباف](https://" +"protobuf.dev/programming-guides/encoding/) خواهید ساخت. نگران نباشید، این " +"کار ساده‌تر از آن است که به نظر می‌رسد! این الگو نشان‌دهنده یک الگوی رایج در " +"تجزیه داده‌ها است که شامل عبور برش‌های داده است. داده‌های اصلی هرگز کپی نمی‌شوند." #: src/lifetimes/exercise.md:8 msgid "" @@ -9355,10 +9633,14 @@ msgid "" "file. In this exercise, we'll encode that information into `match` " "statements in functions that get called for each field." msgstr "" +"تجزیه کامل یک پیام پروتوباف نیاز به دانستن تایپ‌های این فیلدها دارد که بر " +"اساس شماره‌های فیلد ایندکس شده‌اند. این اطلاعات معمولاً در یک فایل `proto` " +"ارائه می‌شود. در این تمرین، ما این اطلاعات را به صورت عبارات `match` در " +"توابعی که برای هر فیلد فراخوانی می‌شوند، کدگذاری خواهیم کرد." #: src/lifetimes/exercise.md:13 msgid "We'll use the following proto:" -msgstr "" +msgstr "ما از پروتوباف زیر استفاده خواهیم کرد:" #: src/lifetimes/exercise.md:28 msgid "" @@ -9367,6 +9649,10 @@ msgid "" "number (e.g., `2` for the `id` field of a `Person` message) and a wire type " "defining how the payload should be determined from the byte stream." msgstr "" +"یک پیام پروتوباف به عنوان مجموعه‌ای از فیلدها، یکی پس از دیگری، کدگذاری " +"می‌شود. هر فیلد به صورت یک \"تگ\" به همراه مقدار آن پیاده‌سازی شده است. تگ " +"شامل شماره فیلد (مانند `2` برای فیلد `id` در پیام `Person`) و wire type است " +"که نحوه تعیین بار را از جریان بایت مشخص می‌کند." #: src/lifetimes/exercise.md:33 msgid "" @@ -9375,12 +9661,18 @@ msgid "" "code also defines callbacks to handle `Person` and `PhoneNumber` fields, and " "to parse a message into a series of calls to those callbacks." msgstr "" +"اعداد، از جمله تگ، با استفاده از کدگذاری با طول متغیر به نام VARINT نمایندگی " +"می‌شوند. خوشبختانه، تابع `parse_varint` برای شما تعریف شده است. کد داده شده " +"همچنین بازخوانی‌هایی برای مدیریت فیلدهای `Person` و `PhoneNumber` و تجزیه یک " +"پیام به مجموعه‌ای از فراخوانی‌ها به آن بازخوانی‌ها را تعریف می‌کند." #: src/lifetimes/exercise.md:38 msgid "" "What remains for you is to implement the `parse_field` function and the " "`ProtoMessage` trait for `Person` and `PhoneNumber`." msgstr "" +"برای شما باقی‌مانده است که تابع `parse_field` و ویژگی `ProtoMessage` را برای " +"`Person` و `PhoneNumber` پیاده‌سازی کنید." #: src/lifetimes/exercise.md:44 src/lifetimes/solution.md:4 msgid "/// A wire type as seen on the wire.\n" @@ -9507,6 +9799,12 @@ msgid "" "enum, but for simplicity in this exercise we panic if any errors are " "encountered. On day 4 we'll cover error handling in Rust in more detail." msgstr "" +"در این تمرین موارد مختلفی وجود دارد که ممکن است تجزیه protobuf با شکست مواجه " +"شود، مثلاً اگر بخواهید یک `i32` را هنگامی که کمتر از ۴ بایت در بافر داده " +"باقی‌مانده است، تجزیه کنید. در کد Rust معمولاً این را با استفاده از `Result` " +"مدیریت می‌کنیم، اما برای سادگی در این تمرین، اگر با هرگونه خطا مواجه شویم، به " +"جای آن که با `Result` برخورد کنیم، برنامه را متوقف خواهیم کرد. در روز چهارم، " +"به بررسی دقیق‌تر مدیریت خطا در Rust خواهیم پرداخت." #: src/lifetimes/solution.md:119 msgid "\"len not a valid `usize`\"" diff --git a/po/ja.po b/po/ja.po index 1b2f73499be..1a79e6383da 100644 --- a/po/ja.po +++ b/po/ja.po @@ -1,7 +1,7 @@ msgid "" msgstr "" "Project-Id-Version: Comprehensive Rust 🦀\n" -"POT-Creation-Date: 2024-01-30T13:24:49+01:00\n" +"POT-Creation-Date: 2024-09-07T21:33:23+09:00\n" "PO-Revision-Date: 2023-06-06 13:18+0900\n" "Last-Translator: Kenta Aratani \n" "Language-Team: Japanese \n" @@ -52,51 +52,52 @@ msgstr "ローカル環境での実行" msgid "Day 1: Morning" msgstr "Day 1： AM" -#: src/SUMMARY.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-1.md src/welcome-day-2.md src/welcome-day-3.md +#: src/welcome-day-4.md src/concurrency/welcome-async.md msgid "Welcome" msgstr "ようこそ" -#: src/SUMMARY.md src/hello-world.md src/hello-world/hello-world.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-1.md src/hello-world.md src/types-and-values.md +#: src/types-and-values/hello-world.md msgid "Hello, World" msgstr "Hello, World" -#: src/SUMMARY.md src/hello-world/what-is-rust.md +#: src/SUMMARY.md src/hello-world.md src/hello-world/what-is-rust.md msgid "What is Rust?" msgstr "Rustとは？" -#: src/SUMMARY.md src/hello-world/benefits.md +#: src/SUMMARY.md src/hello-world.md src/hello-world/benefits.md msgid "Benefits of Rust" msgstr "Rustのメリット" -#: src/SUMMARY.md src/hello-world/playground.md +#: src/SUMMARY.md src/hello-world.md src/hello-world/playground.md msgid "Playground" msgstr "プレイグラウンド" -#: src/SUMMARY.md src/types-and-values.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-1.md src/types-and-values.md msgid "Types and Values" msgstr "型と値" -#: src/SUMMARY.md src/types-and-values/variables.md +#: src/SUMMARY.md src/types-and-values.md src/types-and-values/variables.md msgid "Variables" msgstr "変数" -#: src/SUMMARY.md src/types-and-values/values.md +#: src/SUMMARY.md src/types-and-values.md src/types-and-values/values.md msgid "Values" msgstr "値" -#: src/SUMMARY.md src/types-and-values/arithmetic.md +#: src/SUMMARY.md src/types-and-values.md src/types-and-values/arithmetic.md msgid "Arithmetic" msgstr "算術" -#: src/SUMMARY.md src/types-and-values/strings.md -msgid "Strings" -msgstr "文字列" - -#: src/SUMMARY.md src/types-and-values/inference.md +#: src/SUMMARY.md src/types-and-values.md src/types-and-values/inference.md msgid "Type Inference" msgstr "型推論" -#: src/SUMMARY.md src/types-and-values/exercise.md +#: src/SUMMARY.md src/types-and-values.md src/types-and-values/exercise.md msgid "Exercise: Fibonacci" msgstr "演習: フィボナッチ" @@ -107,41 +108,62 @@ msgstr "演習: フィボナッチ" #: src/generics/solution.md src/std-types/solution.md #: src/std-traits/solution.md src/memory-management/solution.md #: src/smart-pointers/solution.md src/borrowing/solution.md -#: src/slices-and-lifetimes/solution.md src/iterators/solution.md -#: src/modules/solution.md src/testing/solution.md -#: src/error-handling/solution.md src/unsafe-rust/solution.md +#: src/lifetimes/solution.md src/iterators/solution.md src/modules/solution.md +#: src/testing/solution.md src/error-handling/solution.md +#: src/unsafe-rust/solution.md msgid "Solution" msgstr "解答" -#: src/SUMMARY.md src/control-flow-basics.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-1.md src/control-flow-basics.md msgid "Control Flow Basics" msgstr "制御フローの基本" -#: src/SUMMARY.md src/control-flow-basics/conditionals.md -msgid "Conditionals" -msgstr "条件文" +#: src/SUMMARY.md +#, fuzzy +msgid "`if` Expressions" +msgstr "`if` 式" -#: src/SUMMARY.md src/control-flow-basics/loops.md +#: src/SUMMARY.md src/control-flow-basics.md src/control-flow-basics/loops.md msgid "Loops" msgstr "ループ" +#: src/SUMMARY.md src/control-flow-basics/loops/for.md +msgid "`for`" +msgstr "`for`" + +#: src/SUMMARY.md src/control-flow-basics/loops/loop.md +msgid "`loop`" +msgstr "`loop`" + #: src/SUMMARY.md src/control-flow-basics/break-continue.md msgid "`break` and `continue`" msgstr "`break` と `continue`" -#: src/SUMMARY.md src/control-flow-basics/blocks-and-scopes.md +#: src/SUMMARY.md src/control-flow-basics/break-continue/labels.md +msgid "Labels" +msgstr "" + +#: src/SUMMARY.md src/control-flow-basics.md +#: src/control-flow-basics/blocks-and-scopes.md msgid "Blocks and Scopes" msgstr "ブロックとスコープ" -#: src/SUMMARY.md src/control-flow-basics/functions.md +#: src/SUMMARY.md src/control-flow-basics/blocks-and-scopes/scopes.md +msgid "Scopes and Shadowing" +msgstr "スコープとシャドーイング" + +#: src/SUMMARY.md src/control-flow-basics.md +#: src/control-flow-basics/functions.md msgid "Functions" msgstr "関数" -#: src/SUMMARY.md src/control-flow-basics/macros.md +#: src/SUMMARY.md src/control-flow-basics.md src/control-flow-basics/macros.md msgid "Macros" msgstr "マクロ" -#: src/SUMMARY.md src/control-flow-basics/exercise.md +#: src/SUMMARY.md src/control-flow-basics.md +#: src/control-flow-basics/exercise.md msgid "Exercise: Collatz Sequence" msgstr "演習: コラッツ数列" @@ -149,72 +171,94 @@ msgstr "演習: コラッツ数列" msgid "Day 1: Afternoon" msgstr "Day 1： PM" -#: src/SUMMARY.md src/tuples-and-arrays.md -#: src/tuples-and-arrays/tuples-and-arrays.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-1-afternoon.md src/tuples-and-arrays.md msgid "Tuples and Arrays" msgstr "タプルと配列" -#: src/SUMMARY.md src/tuples-and-arrays/iteration.md +#: src/SUMMARY.md src/tuples-and-arrays.md src/tuples-and-arrays/arrays.md +msgid "Arrays" +msgstr "配列" + +#: src/SUMMARY.md src/tuples-and-arrays.md src/tuples-and-arrays/tuples.md +msgid "Tuples" +msgstr "タプル" + +#: src/SUMMARY.md src/tuples-and-arrays.md src/tuples-and-arrays/iteration.md msgid "Array Iteration" msgstr "配列のイテレート" -#: src/SUMMARY.md src/tuples-and-arrays/match.md src/pattern-matching.md -msgid "Pattern Matching" -msgstr "パターンマッチング" - -#: src/SUMMARY.md src/tuples-and-arrays/destructuring.md -#: src/pattern-matching/destructuring.md +#: src/SUMMARY.md src/tuples-and-arrays.md +#: src/tuples-and-arrays/destructuring.md #, fuzzy -msgid "Destructuring" +msgid "Patterns and Destructuring" msgstr "列挙型編" -#: src/SUMMARY.md src/tuples-and-arrays/exercise.md +#: src/SUMMARY.md src/tuples-and-arrays.md src/tuples-and-arrays/exercise.md msgid "Exercise: Nested Arrays" msgstr "演習: ネストされた配列" -#: src/SUMMARY.md src/references.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-1-afternoon.md src/references.md msgid "References" msgstr "参照" -#: src/SUMMARY.md src/references/shared.md +#: src/SUMMARY.md src/references.md src/references/shared.md msgid "Shared References" msgstr "共有参照" -#: src/SUMMARY.md src/references/exclusive.md +#: src/SUMMARY.md src/references.md src/references/exclusive.md msgid "Exclusive References" msgstr "排他参照" -#: src/SUMMARY.md src/references/exercise.md +#: src/SUMMARY.md +#, fuzzy +msgid "Slices: `&[T]`" +msgstr "スライス型" + +#: src/SUMMARY.md src/references.md src/references/strings.md +msgid "Strings" +msgstr "文字列" + +#: src/SUMMARY.md src/references.md src/references/exercise.md msgid "Exercise: Geometry" msgstr "演習: ジオメトリ" -#: src/SUMMARY.md src/user-defined-types.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-1-afternoon.md src/user-defined-types.md msgid "User-Defined Types" msgstr "ユーザー定義型" -#: src/SUMMARY.md src/user-defined-types/named-structs.md +#: src/SUMMARY.md src/user-defined-types.md +#: src/user-defined-types/named-structs.md #, fuzzy msgid "Named Structs" msgstr "構造体（structs）" -#: src/SUMMARY.md src/user-defined-types/tuple-structs.md +#: src/SUMMARY.md src/user-defined-types.md +#: src/user-defined-types/tuple-structs.md msgid "Tuple Structs" msgstr "タプル構造体" -#: src/SUMMARY.md src/user-defined-types/enums.md -#: src/pattern-matching/destructuring.md +#: src/SUMMARY.md src/user-defined-types.md src/user-defined-types/enums.md +#: src/pattern-matching/destructuring-enums.md msgid "Enums" msgstr "列挙型（enums）" -#: src/SUMMARY.md src/user-defined-types/static-and-const.md -msgid "Static and Const" -msgstr "" +#: src/SUMMARY.md +#, fuzzy +msgid "Const" +msgstr "定数" + +#: src/SUMMARY.md src/user-defined-types.md +msgid "Static" +msgstr "静的" -#: src/SUMMARY.md src/user-defined-types/aliases.md +#: src/SUMMARY.md src/user-defined-types.md src/user-defined-types/aliases.md msgid "Type Aliases" msgstr "型エイリアス" -#: src/SUMMARY.md src/user-defined-types/exercise.md +#: src/SUMMARY.md src/user-defined-types.md src/user-defined-types/exercise.md msgid "Exercise: Elevator Events" msgstr "演習: エレベーターでのイベント" @@ -222,54 +266,95 @@ msgstr "演習: エレベーターでのイベント" msgid "Day 2: Morning" msgstr "Day 2： AM" -#: src/SUMMARY.md src/pattern-matching/let-control-flow.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-2.md src/pattern-matching.md +msgid "Pattern Matching" +msgstr "パターンマッチング" + +#: src/SUMMARY.md src/pattern-matching.md src/pattern-matching/match.md +msgid "Matching Values" +msgstr "" + +#: src/SUMMARY.md src/pattern-matching.md +msgid "Destructuring Structs" +msgstr "構造体編" + +#: src/SUMMARY.md src/pattern-matching.md +#, fuzzy +msgid "Destructuring Enums" +msgstr "列挙型編" + +#: src/SUMMARY.md src/pattern-matching.md +#: src/pattern-matching/let-control-flow.md #, fuzzy msgid "Let Control Flow" msgstr "制御フロー" -#: src/SUMMARY.md src/pattern-matching/exercise.md +#: src/SUMMARY.md src/pattern-matching.md src/pattern-matching/exercise.md msgid "Exercise: Expression Evaluation" msgstr "演習: 式の評価" -#: src/SUMMARY.md src/methods-and-traits.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-2.md src/methods-and-traits.md msgid "Methods and Traits" msgstr "" -#: src/SUMMARY.md src/methods-and-traits/methods.md +#: src/SUMMARY.md src/methods-and-traits.md src/methods-and-traits/methods.md msgid "Methods" msgstr "メソッド" -#: src/SUMMARY.md src/methods-and-traits/traits.md +#: src/SUMMARY.md src/methods-and-traits.md src/methods-and-traits/traits.md msgid "Traits" msgstr "トレイト（trait）" -#: src/SUMMARY.md src/methods-and-traits/deriving.md +#: src/SUMMARY.md src/methods-and-traits/traits/implementing.md +#, fuzzy +msgid "Implementing Traits" +msgstr "Unsafeなトレイトの実装" + +#: src/SUMMARY.md src/methods-and-traits/traits/supertraits.md +#, fuzzy +msgid "Supertraits" +msgstr "他のトレイト" + +#: src/SUMMARY.md src/methods-and-traits/traits/associated-types.md +#, fuzzy +msgid "Associated Types" +msgstr "共有の型" + +#: src/SUMMARY.md src/methods-and-traits.md src/methods-and-traits/deriving.md #, fuzzy msgid "Deriving" msgstr "トレイトの導出" -#: src/SUMMARY.md src/methods-and-traits/trait-objects.md -msgid "Trait Objects" -msgstr "トレイトオブジェクト" - -#: src/SUMMARY.md src/methods-and-traits/exercise.md +#: src/SUMMARY.md src/methods-and-traits.md msgid "Exercise: Generic Logger" msgstr "演習: ジェネリックなロガー" -#: src/SUMMARY.md src/generics.md +#: src/SUMMARY.md +msgid "Day 2: Afternoon" +msgstr "Day 2： PM" + +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-2-afternoon.md src/generics.md msgid "Generics" msgstr "ジェネリクス（generics）" -#: src/SUMMARY.md src/generics/generic-functions.md +#: src/SUMMARY.md src/generics.md src/generics/generic-functions.md #, fuzzy msgid "Generic Functions" msgstr "Extern関数" -#: src/SUMMARY.md src/generics/generic-data.md +#: src/SUMMARY.md src/generics.md src/generics/generic-data.md msgid "Generic Data Types" msgstr "ジェネリックデータ型" -#: src/SUMMARY.md src/generics/trait-bounds.md +#: src/SUMMARY.md src/generics/generic-traits.md +#, fuzzy +msgid "Generic Traits" +msgstr "ジェネリクス（generics）" + +#: src/SUMMARY.md src/generics.md src/generics/trait-bounds.md msgid "Trait Bounds" msgstr "トレイト制約" @@ -277,24 +362,26 @@ msgstr "トレイト制約" msgid "`impl Trait`" msgstr "`impl Trait`" +#: src/SUMMARY.md src/generics/dyn-trait.md +#, fuzzy +msgid "`dyn Trait`" +msgstr "`impl Trait`" + #: src/SUMMARY.md src/generics/exercise.md msgid "Exercise: Generic `min`" msgstr "演習: ジェネリックな `min`" -#: src/SUMMARY.md -msgid "Day 2: Afternoon" -msgstr "Day 2： PM" - -#: src/SUMMARY.md src/std-types.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-2-afternoon.md src/std-types.md #, fuzzy msgid "Standard Library Types" msgstr "標準ライブラリ" -#: src/SUMMARY.md src/std-types/std.md +#: src/SUMMARY.md src/std-types.md src/std-types/std.md msgid "Standard Library" msgstr "標準ライブラリ" -#: src/SUMMARY.md src/std-types/docs.md +#: src/SUMMARY.md src/std-types.md src/std-types/docs.md msgid "Documentation" msgstr "ドキュメント" @@ -302,11 +389,12 @@ msgstr "ドキュメント" msgid "`Option`" msgstr "`Option`" -#: src/SUMMARY.md +#: src/SUMMARY.md src/error-handling/result.md msgid "`Result`" msgstr "`Result`" -#: src/SUMMARY.md src/android/interoperability/cpp/type-mapping.md +#: src/SUMMARY.md src/android/aidl/types/primitives.md +#: src/android/interoperability/cpp/type-mapping.md msgid "`String`" msgstr "`String`" @@ -318,20 +406,22 @@ msgstr "`Vec`" msgid "`HashMap`" msgstr "`HashMap`" -#: src/SUMMARY.md src/std-types/exercise.md +#: src/SUMMARY.md src/std-types.md src/std-types/exercise.md msgid "Exercise: Counter" msgstr "演習: カウンター" -#: src/SUMMARY.md src/std-traits.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-2-afternoon.md src/std-traits.md #, fuzzy msgid "Standard Library Traits" msgstr "標準ライブラリ" -#: src/SUMMARY.md src/std-traits/comparisons.md src/async.md +#: src/SUMMARY.md src/std-traits.md src/std-traits/comparisons.md +#: src/concurrency/welcome-async.md msgid "Comparisons" msgstr "他の言語との比較" -#: src/SUMMARY.md src/std-traits/operators.md +#: src/SUMMARY.md src/std-traits.md src/std-traits/operators.md #, fuzzy msgid "Operators" msgstr "イテレータ" @@ -340,7 +430,7 @@ msgstr "イテレータ" msgid "`From` and `Into`" msgstr "`From` と `Into`" -#: src/SUMMARY.md src/std-traits/casting.md +#: src/SUMMARY.md src/std-traits.md src/std-traits/casting.md #, fuzzy msgid "Casting" msgstr "テスト" @@ -353,11 +443,11 @@ msgstr "`Read` と `Write`" msgid "`Default`, struct update syntax" msgstr "`Default`、構造体更新記法" -#: src/SUMMARY.md src/std-traits/closures.md +#: src/SUMMARY.md src/std-traits.md src/std-traits/closures.md msgid "Closures" msgstr "クロージャ" -#: src/SUMMARY.md src/std-traits/exercise.md +#: src/SUMMARY.md src/std-traits.md src/std-traits/exercise.md msgid "Exercise: ROT13" msgstr "演習: ROT13暗号" @@ -365,24 +455,25 @@ msgstr "演習: ROT13暗号" msgid "Day 3: Morning" msgstr "Day 3： AM" -#: src/SUMMARY.md src/memory-management.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-3.md src/memory-management.md msgid "Memory Management" msgstr "メモリ管理" -#: src/SUMMARY.md src/memory-management/review.md +#: src/SUMMARY.md src/memory-management.md src/memory-management/review.md msgid "Review of Program Memory" msgstr "プログラム メモリの見直し" -#: src/SUMMARY.md src/memory-management/approaches.md +#: src/SUMMARY.md src/memory-management.md src/memory-management/approaches.md #, fuzzy msgid "Approaches to Memory Management" msgstr "Rustのメモリ管理" -#: src/SUMMARY.md src/memory-management/ownership.md +#: src/SUMMARY.md src/memory-management.md src/memory-management/ownership.md msgid "Ownership" msgstr "所有権" -#: src/SUMMARY.md src/memory-management/move.md +#: src/SUMMARY.md src/memory-management.md src/memory-management/move.md msgid "Move Semantics" msgstr "ムーブセマンティクス" @@ -390,7 +481,7 @@ msgstr "ムーブセマンティクス" msgid "`Clone`" msgstr "`Clone`" -#: src/SUMMARY.md src/memory-management/copy-types.md +#: src/SUMMARY.md src/memory-management.md src/memory-management/copy-types.md msgid "Copy Types" msgstr "Copy 型" @@ -398,11 +489,12 @@ msgstr "Copy 型" msgid "`Drop`" msgstr "`Drop`" -#: src/SUMMARY.md src/memory-management/exercise.md +#: src/SUMMARY.md src/memory-management.md src/memory-management/exercise.md msgid "Exercise: Builder Type" msgstr "演習: ビルダー型" -#: src/SUMMARY.md src/smart-pointers.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-3.md src/smart-pointers.md msgid "Smart Pointers" msgstr "スマートポインタ" @@ -415,7 +507,12 @@ msgstr "`Box`" msgid "`Rc`" msgstr "`Rc`" -#: src/SUMMARY.md src/smart-pointers/exercise.md +#: src/SUMMARY.md src/smart-pointers.md src/smart-pointers/trait-objects.md +#, fuzzy +msgid "Owned Trait Objects" +msgstr "トレイトオブジェクト" + +#: src/SUMMARY.md src/smart-pointers.md src/smart-pointers/exercise.md msgid "Exercise: Binary Tree" msgstr "演習: バイナリツリー" @@ -423,57 +520,54 @@ msgstr "演習: バイナリツリー" msgid "Day 3: Afternoon" msgstr "Day 3： PM" -#: src/SUMMARY.md src/borrowing.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-3-afternoon.md src/borrowing.md msgid "Borrowing" msgstr "借用" -#: src/SUMMARY.md src/borrowing/shared.md +#: src/SUMMARY.md src/borrowing.md src/borrowing/shared.md #, fuzzy msgid "Borrowing a Value" msgstr "借用" -#: src/SUMMARY.md src/borrowing/borrowck.md +#: src/SUMMARY.md src/borrowing.md src/borrowing/borrowck.md #, fuzzy msgid "Borrow Checking" msgstr "借用" -#: src/SUMMARY.md src/borrowing/interior-mutability.md +#: src/SUMMARY.md src/borrowing.md src/borrowing/examples.md +msgid "Borrow Errors" +msgstr "" + +#: src/SUMMARY.md src/borrowing.md src/borrowing/interior-mutability.md msgid "Interior Mutability" msgstr "内部可変性" -#: src/SUMMARY.md src/borrowing/exercise.md +#: src/SUMMARY.md src/borrowing.md src/borrowing/exercise.md msgid "Exercise: Health Statistics" msgstr "演習: 健康に関する統計" -#: src/SUMMARY.md src/slices-and-lifetimes.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-3-afternoon.md src/lifetimes.md #, fuzzy -msgid "Slices and Lifetimes" +msgid "Lifetimes" msgstr "ライフタイム" -#: src/SUMMARY.md -#, fuzzy -msgid "Slices: `&[T]`" -msgstr "スライス型" - -#: src/SUMMARY.md src/slices-and-lifetimes/str.md -msgid "String References" -msgstr "Stringの参照" - -#: src/SUMMARY.md src/slices-and-lifetimes/lifetime-annotations.md +#: src/SUMMARY.md src/lifetimes.md src/lifetimes/lifetime-annotations.md msgid "Lifetime Annotations" msgstr "関数とライフタイム" -#: src/SUMMARY.md +#: src/SUMMARY.md src/lifetimes.md #, fuzzy msgid "Lifetime Elision" msgstr "ライフタイム" -#: src/SUMMARY.md +#: src/SUMMARY.md src/lifetimes.md #, fuzzy msgid "Struct Lifetimes" msgstr "ライフタイム" -#: src/SUMMARY.md src/slices-and-lifetimes/exercise.md +#: src/SUMMARY.md src/lifetimes.md src/lifetimes/exercise.md msgid "Exercise: Protobuf Parsing" msgstr "演習: Protobufの解析" @@ -481,7 +575,8 @@ msgstr "演習: Protobufの解析" msgid "Day 4: Morning" msgstr "Day 4： AM" -#: src/SUMMARY.md src/iterators.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-4.md src/iterators.md msgid "Iterators" msgstr "イテレータ" @@ -497,20 +592,21 @@ msgstr "`IntoIterator`" msgid "`FromIterator`" msgstr "`FromIterator`" -#: src/SUMMARY.md src/iterators/exercise.md +#: src/SUMMARY.md src/iterators.md src/iterators/exercise.md msgid "Exercise: Iterator Method Chaining" msgstr "演習: イテレータのメソッドチェーン" -#: src/SUMMARY.md src/modules.md src/modules/modules.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-4.md src/modules.md src/modules/modules.md #, fuzzy msgid "Modules" msgstr "モジュール タイプ" -#: src/SUMMARY.md src/modules/filesystem.md +#: src/SUMMARY.md src/modules.md src/modules/filesystem.md msgid "Filesystem Hierarchy" msgstr "ファイルシステム階層" -#: src/SUMMARY.md src/modules/visibility.md +#: src/SUMMARY.md src/modules.md src/modules/visibility.md msgid "Visibility" msgstr "可視性" @@ -518,41 +614,30 @@ msgstr "可視性" msgid "`use`, `super`, `self`" msgstr "`use`、`super`、`self`" -#: src/SUMMARY.md src/modules/exercise.md +#: src/SUMMARY.md src/modules.md src/modules/exercise.md #, fuzzy msgid "Exercise: Modules for a GUI Library" msgstr "[演習: GUI ライブラリのモジュール](./modules/exercise.md)（15 分）" -#: src/SUMMARY.md src/testing.md src/chromium/testing.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-4.md src/testing.md src/chromium/testing.md msgid "Testing" msgstr "テスト" -#: src/SUMMARY.md +#: src/SUMMARY.md src/testing.md msgid "Test Modules" msgstr "テストモジュール" -#: src/SUMMARY.md src/testing/other.md +#: src/SUMMARY.md src/testing.md src/testing/other.md #, fuzzy msgid "Other Types of Tests" msgstr "他のプロジェクト" -#: src/SUMMARY.md src/testing/useful-crates.md -msgid "Useful Crates" -msgstr "便利クレート" - -#: src/SUMMARY.md src/testing/googletest.md -msgid "GoogleTest" -msgstr "GoogleTest" - -#: src/SUMMARY.md src/testing/mocking.md -msgid "Mocking" -msgstr "モック" - -#: src/SUMMARY.md src/testing/lints.md +#: src/SUMMARY.md src/testing.md src/testing/lints.md msgid "Compiler Lints and Clippy" msgstr "コンパイラの Lints と Clippy" -#: src/SUMMARY.md src/testing/exercise.md +#: src/SUMMARY.md src/testing.md src/testing/exercise.md #, fuzzy msgid "Exercise: Luhn Algorithm" msgstr "Luhnアルゴリズム" @@ -561,20 +646,21 @@ msgstr "Luhnアルゴリズム" msgid "Day 4: Afternoon" msgstr "Day 4： PM" -#: src/SUMMARY.md src/error-handling.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-4-afternoon.md src/error-handling.md msgid "Error Handling" msgstr "エラー処理" -#: src/SUMMARY.md src/error-handling/panics.md +#: src/SUMMARY.md src/error-handling.md src/error-handling/panics.md msgid "Panics" msgstr "パニック（panic）" -#: src/SUMMARY.md src/error-handling/try.md +#: src/SUMMARY.md src/error-handling.md src/error-handling/try.md #, fuzzy msgid "Try Operator" msgstr "Iterator" -#: src/SUMMARY.md src/error-handling/try-conversions.md +#: src/SUMMARY.md src/error-handling.md src/error-handling/try-conversions.md #, fuzzy msgid "Try Conversions" msgstr "暗黙的な型変換" @@ -591,36 +677,37 @@ msgstr "`thiserror` と `anyhow`" msgid "Exercise: Rewriting with `Result`" msgstr "演習: `Result` を使用した書き換え" -#: src/SUMMARY.md src/unsafe-rust.md src/unsafe-rust/unsafe.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-4-afternoon.md src/unsafe-rust.md src/unsafe-rust/unsafe.md msgid "Unsafe Rust" msgstr "Unsafe Rust" -#: src/SUMMARY.md +#: src/SUMMARY.md src/unsafe-rust.md #, fuzzy msgid "Unsafe" msgstr "Unsafe Rust" -#: src/SUMMARY.md src/unsafe-rust/dereferencing.md +#: src/SUMMARY.md src/unsafe-rust.md src/unsafe-rust/dereferencing.md msgid "Dereferencing Raw Pointers" msgstr "生ポインタの参照外し" -#: src/SUMMARY.md src/unsafe-rust/mutable-static.md +#: src/SUMMARY.md src/unsafe-rust.md src/unsafe-rust/mutable-static.md msgid "Mutable Static Variables" msgstr "可変なstatic変数" -#: src/SUMMARY.md src/unsafe-rust/unions.md +#: src/SUMMARY.md src/unsafe-rust.md src/unsafe-rust/unions.md msgid "Unions" msgstr "共用体" -#: src/SUMMARY.md src/unsafe-rust/unsafe-functions.md +#: src/SUMMARY.md src/unsafe-rust.md src/unsafe-rust/unsafe-functions.md msgid "Unsafe Functions" msgstr "Unsafe関数の呼び出し" -#: src/SUMMARY.md +#: src/SUMMARY.md src/unsafe-rust.md msgid "Unsafe Traits" msgstr "Unsafeなトレイトの実装" -#: src/SUMMARY.md +#: src/SUMMARY.md src/unsafe-rust.md msgid "Exercise: FFI Wrapper" msgstr "演習: FFIラッパー" @@ -648,19 +735,29 @@ msgstr "ライブラリ" msgid "AIDL" msgstr "AIDL（Androidインターフェイス定義言語）" +#: src/SUMMARY.md src/android/aidl/birthday-service.md +#, fuzzy +msgid "Birthday Service Tutorial" +msgstr "/** 誕生日サービスのインターフェース。*/" + #: src/SUMMARY.md msgid "Interface" msgstr "インターフェイス" #: src/SUMMARY.md -msgid "Implementation" -msgstr "実装" +msgid "Service API" +msgstr "" + +#: src/SUMMARY.md +#, fuzzy +msgid "Service" +msgstr "サーバ" #: src/SUMMARY.md msgid "Server" msgstr "サーバ" -#: src/SUMMARY.md src/android/aidl/deploy.md +#: src/SUMMARY.md src/android/aidl/example-service/deploy.md msgid "Deploy" msgstr "デプロイ" @@ -668,10 +765,51 @@ msgstr "デプロイ" msgid "Client" msgstr "クライアント" -#: src/SUMMARY.md src/android/aidl/changing.md +#: src/SUMMARY.md src/android/aidl/example-service/changing-definition.md msgid "Changing API" msgstr "APIの変更" +#: src/SUMMARY.md +#, fuzzy +msgid "Updating Implementations" +msgstr "実装" + +#: src/SUMMARY.md +#, fuzzy +msgid "AIDL Types" +msgstr "型" + +#: src/SUMMARY.md src/android/aidl/types/primitives.md +msgid "Primitive Types" +msgstr "" + +#: src/SUMMARY.md src/android/aidl/types/arrays.md +#, fuzzy +msgid "Array Types" +msgstr "配列" + +#: src/SUMMARY.md src/android/aidl/types/objects.md +#, fuzzy +msgid "Sending Objects" +msgstr "トレイトオブジェクト" + +#: src/SUMMARY.md src/android/aidl/types/parcelables.md +#, fuzzy +msgid "Parcelables" +msgstr "変数" + +#: src/SUMMARY.md src/android/aidl/types/file-descriptor.md +msgid "Sending Files" +msgstr "" + +#: src/SUMMARY.md src/android/testing/googletest.md +msgid "GoogleTest" +msgstr "GoogleTest" + +#: src/SUMMARY.md src/android/testing/mocking.md +msgid "Mocking" +msgstr "モック" + #: src/SUMMARY.md src/android/logging.md src/bare-metal/aps/logging.md msgid "Logging" msgstr "ログ出力" @@ -751,9 +889,11 @@ msgstr "Android 向けのビルド: Rust" msgid "With Java" msgstr "Java" -#: src/SUMMARY.md src/exercises/android/morning.md -#: src/exercises/bare-metal/morning.md src/exercises/bare-metal/afternoon.md -#: src/exercises/concurrency/morning.md src/exercises/concurrency/afternoon.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/exercises/android/morning.md src/exercises/bare-metal/morning.md +#: src/exercises/bare-metal/afternoon.md src/concurrency/welcome.md +#: src/concurrency/sync-exercises.md src/concurrency/welcome-async.md +#: src/concurrency/async-exercises.md msgid "Exercises" msgstr "練習問題" @@ -956,7 +1096,10 @@ msgstr "他のプロジェクト" msgid "Compass" msgstr "コンパス" -#: src/SUMMARY.md +#: src/SUMMARY.md src/concurrency/sync-exercises.md +#: src/concurrency/sync-exercises/solutions.md +#: src/concurrency/async-exercises.md +#: src/concurrency/async-exercises/solutions.md msgid "Solutions" msgstr "解答" @@ -1008,10 +1151,14 @@ msgstr "ドライバ" msgid "Using It" msgstr "使用例" -#: src/SUMMARY.md src/bare-metal/aps/exceptions.md +#: src/SUMMARY.md src/error-handling/result.md src/bare-metal/aps/exceptions.md msgid "Exceptions" msgstr "例外" +#: src/SUMMARY.md +msgid "Useful Crates" +msgstr "便利クレート" + #: src/SUMMARY.md src/bare-metal/useful-crates/zerocopy.md msgid "`zerocopy`" msgstr "`zerocopy`" @@ -1044,23 +1191,38 @@ msgstr "RTC（リアルタイムクロック）ドライバ" msgid "Concurrency: Morning" msgstr "並行性： AM" -#: src/SUMMARY.md src/concurrency/threads.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/concurrency/welcome.md src/concurrency/threads.md msgid "Threads" msgstr "スレッド" -#: src/SUMMARY.md src/concurrency/scoped-threads.md +#: src/SUMMARY.md src/concurrency/threads.md src/concurrency/threads/plain.md +#, fuzzy +msgid "Plain Threads" +msgstr "スレッド" + +#: src/SUMMARY.md src/concurrency/threads.md src/concurrency/threads/scoped.md msgid "Scoped Threads" msgstr "スコープ付きスレッド" -#: src/SUMMARY.md src/concurrency/channels.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/concurrency/welcome.md src/concurrency/channels.md msgid "Channels" msgstr "チャネル" -#: src/SUMMARY.md src/concurrency/channels/unbounded.md +#: src/SUMMARY.md src/concurrency/channels.md +#: src/concurrency/channels/senders-receivers.md +#, fuzzy +msgid "Senders and Receivers" +msgstr "メソッドレシーバ" + +#: src/SUMMARY.md src/concurrency/channels.md +#: src/concurrency/channels/unbounded.md msgid "Unbounded Channels" msgstr "Unboundedチャネル" -#: src/SUMMARY.md src/concurrency/channels/bounded.md +#: src/SUMMARY.md src/concurrency/channels.md +#: src/concurrency/channels/bounded.md msgid "Bounded Channels" msgstr "Boundedチャネル" @@ -1068,6 +1230,12 @@ msgstr "Boundedチャネル" msgid "`Send` and `Sync`" msgstr "`Send`と`Sync`" +#: src/SUMMARY.md src/concurrency/send-sync.md +#: src/concurrency/send-sync/marker-traits.md +#, fuzzy +msgid "Marker Traits" +msgstr "他のトレイト" + #: src/SUMMARY.md src/concurrency/send-sync/send.md msgid "`Send`" msgstr "`Send`" @@ -1076,34 +1244,39 @@ msgstr "`Send`" msgid "`Sync`" msgstr "`Sync`" -#: src/SUMMARY.md src/concurrency/send-sync/examples.md +#: src/SUMMARY.md src/concurrency/send-sync.md +#: src/concurrency/send-sync/examples.md msgid "Examples" msgstr "例" -#: src/SUMMARY.md src/concurrency/shared_state.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/concurrency/welcome.md src/concurrency/shared-state.md msgid "Shared State" msgstr "状態共有" -#: src/SUMMARY.md src/concurrency/shared_state/arc.md +#: src/SUMMARY.md src/concurrency/shared-state/arc.md msgid "`Arc`" msgstr "`Arc`" -#: src/SUMMARY.md src/concurrency/shared_state/mutex.md +#: src/SUMMARY.md src/concurrency/shared-state/mutex.md msgid "`Mutex`" msgstr "`Mutex`" #: src/SUMMARY.md src/memory-management/review.md -#: src/error-handling/try-conversions.md -#: src/concurrency/shared_state/example.md +#: src/error-handling/try-conversions.md src/concurrency/shared-state.md +#: src/concurrency/shared-state/example.md msgid "Example" msgstr "例" -#: src/SUMMARY.md src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/solutions-morning.md +#: src/SUMMARY.md src/concurrency/sync-exercises.md +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/sync-exercises/solutions.md +#: src/concurrency/async-exercises.md msgid "Dining Philosophers" msgstr "食事する哲学者" -#: src/SUMMARY.md src/exercises/concurrency/link-checker.md +#: src/SUMMARY.md src/concurrency/sync-exercises.md +#: src/concurrency/sync-exercises/link-checker.md msgid "Multi-threaded Link Checker" msgstr "マルチスレッド・リンクチェッカー" @@ -1111,70 +1284,81 @@ msgstr "マルチスレッド・リンクチェッカー" msgid "Concurrency: Afternoon" msgstr "並行性： PM" -#: src/SUMMARY.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/concurrency/welcome-async.md src/concurrency/async.md msgid "Async Basics" msgstr "Asyncの基礎" -#: src/SUMMARY.md src/async/async-await.md +#: src/SUMMARY.md src/concurrency/async/async-await.md msgid "`async`/`await`" msgstr "`async`/`await`" -#: src/SUMMARY.md src/async/futures.md +#: src/SUMMARY.md src/concurrency/async.md src/concurrency/async/futures.md msgid "Futures" msgstr "Future" -#: src/SUMMARY.md src/async/runtimes.md +#: src/SUMMARY.md src/concurrency/async.md src/concurrency/async/runtimes.md msgid "Runtimes" msgstr "ランタイム" -#: src/SUMMARY.md src/async/runtimes/tokio.md +#: src/SUMMARY.md src/concurrency/async/runtimes/tokio.md msgid "Tokio" msgstr "Tokio" -#: src/SUMMARY.md src/exercises/concurrency/link-checker.md src/async/tasks.md -#: src/exercises/concurrency/chat-app.md +#: src/SUMMARY.md src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/async.md src/concurrency/async/tasks.md +#: src/concurrency/async-exercises/chat-app.md msgid "Tasks" msgstr "タスク" -#: src/SUMMARY.md src/async/channels.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/concurrency/welcome-async.md src/concurrency/async-control-flow.md +#, fuzzy +msgid "Channels and Control Flow" +msgstr "制御フロー" + +#: src/SUMMARY.md src/concurrency/async-control-flow.md +#: src/concurrency/async-control-flow/channels.md msgid "Async Channels" msgstr "Asyncチャネル" -#: src/SUMMARY.md -msgid "Control Flow" -msgstr "制御フロー" - -#: src/SUMMARY.md src/async/control-flow/join.md +#: src/SUMMARY.md src/concurrency/async-control-flow.md +#: src/concurrency/async-control-flow/join.md msgid "Join" msgstr "Join" -#: src/SUMMARY.md src/async/control-flow/select.md +#: src/SUMMARY.md src/concurrency/async-control-flow.md +#: src/concurrency/async-control-flow/select.md msgid "Select" msgstr "Select" -#: src/SUMMARY.md +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/concurrency/welcome-async.md src/concurrency/async-pitfalls.md msgid "Pitfalls" msgstr "落とし穴" -#: src/SUMMARY.md +#: src/SUMMARY.md src/concurrency/async-pitfalls.md msgid "Blocking the Executor" msgstr "エグゼキュータのブロッキング" -#: src/SUMMARY.md src/async/pitfalls/pin.md +#: src/SUMMARY.md src/concurrency/async-pitfalls/pin.md msgid "`Pin`" msgstr "`Pin`" -#: src/SUMMARY.md src/async/pitfalls/async-traits.md +#: src/SUMMARY.md src/concurrency/async-pitfalls.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "Async Traits" msgstr "Asyncトレイト" -#: src/SUMMARY.md src/async/pitfalls/cancellation.md +#: src/SUMMARY.md src/concurrency/async-pitfalls.md +#: src/concurrency/async-pitfalls/cancellation.md #, fuzzy msgid "Cancellation" msgstr "インストール" -#: src/SUMMARY.md src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md +#: src/SUMMARY.md src/concurrency/async-exercises.md +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md msgid "Broadcast Chat Application" msgstr "ブロードキャスト・チャットアプリ" @@ -1186,6 +1370,7 @@ msgstr "最後に" msgid "Thanks!" msgstr "ありがとうございました！" +#. Please keep { #glossary } untranslated. #: src/SUMMARY.md src/glossary.md msgid "Glossary" msgstr "用語集" @@ -1238,6 +1423,17 @@ msgstr "" "コースの最新バージョンは にあ" "ります。他の場所でお読みの場合は、そちらで最新情報をご確認ください。" +#: src/index.md +msgid "" +"The course is available in other languages. Select your preferred language " +"in the top right corner of the page or check the [Translations](running-the-" +"course/translations.md) page for a list of all available translations." +msgstr "" + +#: src/index.md +msgid "The course is also available [as a PDF](comprehensive-rust.pdf)." +msgstr "" + #: src/index.md msgid "" "The goal of the course is to teach you Rust. We assume you don't know " @@ -1305,10 +1501,10 @@ msgstr "" #: src/index.md #, fuzzy msgid "" -"[Concurrency](concurrency.md): a whole-day class on concurrency in Rust. We " -"cover both classical concurrency (preemptively scheduling using threads and " -"mutexes) and async/await concurrency (cooperative multitasking using " -"futures)." +"[Concurrency](concurrency/welcome.md): a whole-day class on concurrency in " +"Rust. We cover both classical concurrency (preemptively scheduling using " +"threads and mutexes) and async/await concurrency (cooperative multitasking " +"using futures)." msgstr "" "[Concurrency](concurrency.md)： Rustの並行性についての1日講座。並行性（スレッ" "ドとミューテックスを用いたプリエンプティブなスケジューリング）と、async/await" @@ -1505,133 +1701,140 @@ msgid "Course schedule:" msgstr "コースのスケジュール:" #: src/running-the-course/course-structure.md -msgid "Day 1 Morning (3 hours, including breaks)" -msgstr "1 日目の午前（休憩を含めて 3 時間）" +#, fuzzy +msgid "Day 1 Morning (2 hours and 5 minutes, including breaks)" +msgstr "3 日目の午前（休憩を含めて 2 時間 15 分）" -#: src/running-the-course/course-structure.md -msgid "[Welcome](../welcome-day-1.md) (5 minutes)" -msgstr "[ようこそ](../welcome-day-1.md)（5 分）" +#: src/running-the-course/course-structure.md src/welcome-day-1.md +#: src/welcome-day-1-afternoon.md src/welcome-day-2.md +#: src/welcome-day-2-afternoon.md src/welcome-day-3.md +#: src/welcome-day-3-afternoon.md src/welcome-day-4.md +#: src/welcome-day-4-afternoon.md src/concurrency/welcome.md +#: src/concurrency/welcome-async.md +msgid "Segment" +msgstr "" -#: src/running-the-course/course-structure.md -msgid "[Hello, World](../hello-world.md) (20 minutes)" -msgstr "[Hello, World](../hello-world.md)（20 分）" +#: src/running-the-course/course-structure.md src/welcome-day-1.md +#: src/hello-world.md src/types-and-values.md src/control-flow-basics.md +#: src/welcome-day-1-afternoon.md src/tuples-and-arrays.md src/references.md +#: src/user-defined-types.md src/welcome-day-2.md src/pattern-matching.md +#: src/methods-and-traits.md src/welcome-day-2-afternoon.md src/generics.md +#: src/std-types.md src/std-traits.md src/welcome-day-3.md +#: src/memory-management.md src/smart-pointers.md +#: src/welcome-day-3-afternoon.md src/borrowing.md src/lifetimes.md +#: src/welcome-day-4.md src/iterators.md src/modules.md src/testing.md +#: src/welcome-day-4-afternoon.md src/error-handling.md src/unsafe-rust.md +#: src/concurrency/welcome.md src/concurrency/threads.md +#: src/concurrency/channels.md src/concurrency/send-sync.md +#: src/concurrency/shared-state.md src/concurrency/sync-exercises.md +#: src/concurrency/welcome-async.md src/concurrency/async.md +#: src/concurrency/async-control-flow.md src/concurrency/async-pitfalls.md +#: src/concurrency/async-exercises.md +#, fuzzy +msgid "Duration" +msgstr "`Duration`" -#: src/running-the-course/course-structure.md -msgid "[Types and Values](../types-and-values.md) (1 hour and 5 minutes)" -msgstr "[型と値](../types-and-values.md)（1 時間 5 分）" +#: src/running-the-course/course-structure.md src/welcome-day-1.md +#: src/types-and-values.md src/control-flow-basics.md src/tuples-and-arrays.md +#: src/user-defined-types.md src/generics.md src/std-types.md src/std-traits.md +#: src/memory-management.md src/smart-pointers.md src/lifetimes.md +#: src/iterators.md src/modules.md src/testing.md src/error-handling.md +#: src/unsafe-rust.md src/concurrency/shared-state.md +#: src/concurrency/async-control-flow.md src/concurrency/async-pitfalls.md +msgid "5 minutes" +msgstr "" -#: src/running-the-course/course-structure.md -msgid "[Control Flow Basics](../control-flow-basics.md) (1 hour)" -msgstr "[制御フローの基本](../control-flow-basics.md)（1 時間）" +#: src/running-the-course/course-structure.md src/welcome-day-1.md +#: src/types-and-values.md src/control-flow-basics.md src/tuples-and-arrays.md +#: src/references.md src/user-defined-types.md src/methods-and-traits.md +#: src/modules.md src/concurrency/welcome.md src/concurrency/threads.md +#: src/concurrency/shared-state.md +msgid "15 minutes" +msgstr "" + +#: src/running-the-course/course-structure.md src/welcome-day-1.md +#: src/welcome-day-4.md +msgid "40 minutes" +msgstr "" #: src/running-the-course/course-structure.md -msgid "Day 1 Afternoon (2 hours and 55 minutes, including breaks)" +#, fuzzy +msgid "Day 1 Afternoon (2 hours and 35 minutes, including breaks)" msgstr "1 日目の午後（休憩を含めて 2 時間 55 分）" -#: src/running-the-course/course-structure.md -msgid "[Tuples and Arrays](../tuples-and-arrays.md) (1 hour)" -msgstr "[タプルと配列](../tuples-and-arrays.md)（1 時間）" +#: src/running-the-course/course-structure.md src/welcome-day-1-afternoon.md +msgid "35 minutes" +msgstr "" -#: src/running-the-course/course-structure.md -msgid "[References](../references.md) (50 minutes)" -msgstr "[参照](../references.md)（50 分）" +#: src/running-the-course/course-structure.md src/welcome-day-1-afternoon.md +#: src/welcome-day-3.md src/welcome-day-3-afternoon.md +#: src/concurrency/welcome-async.md +msgid "55 minutes" +msgstr "" -#: src/running-the-course/course-structure.md -msgid "[User-Defined Types](../user-defined-types.md) (50 minutes)" -msgstr "[ユーザー定義型](../user-defined-types.md)（50 分）" +#: src/running-the-course/course-structure.md src/welcome-day-1-afternoon.md +#: src/welcome-day-2.md src/welcome-day-3-afternoon.md +msgid "50 minutes" +msgstr "" #: src/running-the-course/course-structure.md -msgid "Day 2 Morning (3 hours and 5 minutes, including breaks)" -msgstr "2 日目の午前（休憩を含めて 3 時間 5 分）" - -#: src/running-the-course/course-structure.md -msgid "[Welcome](../welcome-day-2.md) (3 minutes)" -msgstr "[ようこそ](../welcome-day-2.md)（3 分）" - -#: src/running-the-course/course-structure.md -msgid "[Pattern Matching](../pattern-matching.md) (50 minutes)" -msgstr "[パターン マッチング](../pattern-matching.md)（50 分）" +#, fuzzy +msgid "Day 2 Morning (2 hours and 10 minutes, including breaks)" +msgstr "3 日目の午前（休憩を含めて 2 時間 15 分）" -#: src/running-the-course/course-structure.md -msgid "[Methods and Traits](../methods-and-traits.md) (55 minutes)" -msgstr "[メソッドとトレイト](../methods-and-train.md)（55 分）" +#: src/running-the-course/course-structure.md src/hello-world.md +#: src/types-and-values.md src/control-flow-basics.md src/tuples-and-arrays.md +#: src/welcome-day-2.md src/methods-and-traits.md src/std-types.md +#: src/welcome-day-3.md src/borrowing.md src/welcome-day-4.md src/modules.md +#: src/testing.md src/error-handling.md +msgid "3 minutes" +msgstr "" -#: src/running-the-course/course-structure.md -msgid "[Generics](../generics.md) (45 minutes)" -msgstr "[ジェネリクス](../generics.md)（45 分）" +#: src/running-the-course/course-structure.md src/welcome-day-2.md +#: src/welcome-day-2-afternoon.md src/welcome-day-3.md +#: src/welcome-day-4-afternoon.md +msgid "1 hour" +msgstr "" #: src/running-the-course/course-structure.md -msgid "Day 2 Afternoon (3 hours, including breaks)" -msgstr "2 日目の午後（休憩を含めて 3 時間）" +#, fuzzy +msgid "Day 2 Afternoon (3 hours and 15 minutes, including breaks)" +msgstr "1 日目の午後（休憩を含めて 2 時間 55 分）" -#: src/running-the-course/course-structure.md -msgid "[Standard Library Types](../std-types.md) (1 hour and 10 minutes)" -msgstr "[標準ライブラリ型](../std-types.md)（1 時間 10 分）" +#: src/running-the-course/course-structure.md src/welcome-day-2-afternoon.md +#: src/welcome-day-4.md +msgid "45 minutes" +msgstr "" -#: src/running-the-course/course-structure.md -msgid "[Standard Library Traits](../std-traits.md) (1 hour and 40 minutes)" -msgstr "[標準ライブラリ トレイト](../std-train.md)（1 時間 40 分）" +#: src/running-the-course/course-structure.md src/welcome-day-2-afternoon.md +#: src/concurrency/welcome.md src/concurrency/welcome-async.md +msgid "1 hour and 10 minutes" +msgstr "" #: src/running-the-course/course-structure.md -msgid "Day 3 Morning (2 hours and 15 minutes, including breaks)" +#, fuzzy +msgid "Day 3 Morning (2 hours and 20 minutes, including breaks)" msgstr "3 日目の午前（休憩を含めて 2 時間 15 分）" #: src/running-the-course/course-structure.md -msgid "[Welcome](../welcome-day-3.md) (3 minutes)" -msgstr "[ようこそ](../welcome-day-3.md)（3 分）" - -#: src/running-the-course/course-structure.md -msgid "[Memory Management](../memory-management.md) (1 hour and 10 minutes)" -msgstr "[メモリ管理](../memory-management.md)（1 時間 10 分）" - -#: src/running-the-course/course-structure.md -msgid "[Smart Pointers](../smart-pointers.md) (45 minutes)" -msgstr "[スマート ポインタ](../smart-pointers.md)（45 分）" - -#: src/running-the-course/course-structure.md -msgid "Day 3 Afternoon (2 hours and 20 minutes, including breaks)" -msgstr "3 日目の午後（休憩を含めて 2 時間 20 分）" - -#: src/running-the-course/course-structure.md -msgid "[Borrowing](../borrowing.md) (1 hour)" -msgstr "[借用](../borrowing.md)（1 時間）" - -#: src/running-the-course/course-structure.md -msgid "" -"[Slices and Lifetimes](../slices-and-lifetimes.md) (1 hour and 10 minutes)" -msgstr "[スライスとライフタイム](../slices-and-lifetimes.md)（1 時間 10 分）" +#, fuzzy +msgid "Day 3 Afternoon (1 hour and 55 minutes, including breaks)" +msgstr "1 日目の午後（休憩を含めて 2 時間 55 分）" #: src/running-the-course/course-structure.md -msgid "Day 4 Morning (3 hours and 5 minutes, including breaks)" +#, fuzzy +msgid "Day 4 Morning (2 hours and 40 minutes, including breaks)" msgstr "4 日目の午前（休憩を含めて 3 時間 5 分）" #: src/running-the-course/course-structure.md -msgid "[Welcome](../welcome-day-4.md) (3 minutes)" -msgstr "[ようこそ](../welcome-day-4.md)（3 分）" - -#: src/running-the-course/course-structure.md -msgid "[Iterators](../iterators.md) (45 minutes)" -msgstr "[イテレータ](../iterators.md)（45 分）" - -#: src/running-the-course/course-structure.md -msgid "[Modules](../modules.md) (40 minutes)" -msgstr "[モジュール](../modules.md)（40 分）" - -#: src/running-the-course/course-structure.md -msgid "[Testing](../testing.md) (1 hour and 5 minutes)" -msgstr "[テスト](../testing.md)（1 時間 5 分）" - -#: src/running-the-course/course-structure.md -msgid "Day 4 Afternoon (2 hours, including breaks)" -msgstr "4 日目の午後（休憩を含めて 2 時間）" - -#: src/running-the-course/course-structure.md -msgid "[Error Handling](../error-handling.md) (45 minutes)" -msgstr "[エラー処理](../error-handling.md)（45 分）" +#, fuzzy +msgid "Day 4 Afternoon (2 hours and 15 minutes, including breaks)" +msgstr "1 日目の午後（休憩を含めて 2 時間 55 分）" -#: src/running-the-course/course-structure.md -msgid "[Unsafe Rust](../unsafe-rust.md) (1 hour and 5 minutes)" -msgstr "[Unsafe Rust](../unsafe-rust.md)（1 時間 5 分）" +#: src/running-the-course/course-structure.md src/welcome-day-4-afternoon.md +#, fuzzy +msgid "1 hour and 5 minutes" +msgstr "[テスト](./testing.md)（1 時間 5 分）" #: src/running-the-course/course-structure.md msgid "Deep Dives" @@ -1748,8 +1951,8 @@ msgstr "Rustでの並行性" #: src/running-the-course/course-structure.md #, fuzzy msgid "" -"The [Concurrency in Rust](../concurrency.md) deep dive is a full day class " -"on classical as well as `async`/`await` concurrency." +"The [Concurrency in Rust](../concurrency/welcome.md) deep dive is a full day " +"class on classical as well as `async`/`await` concurrency." msgstr "" "[並行性編](../concurrency.md) は、並行性とasync/awaitを使用した並行性について" "の1日講座です。" @@ -1763,6 +1966,36 @@ msgstr "" "新規クレートの作成と、依存関係（dependencies）のダウンロードが必要です。その" "後、例を`src/main.rs`にコピペして実行する事ができます：" +#: src/running-the-course/course-structure.md +#, fuzzy +msgid "Morning (3 hours and 20 minutes, including breaks)" +msgstr "2 日目の午前（休憩を含めて 3 時間 5 分）" + +#: src/running-the-course/course-structure.md src/pattern-matching.md +#: src/std-traits.md src/smart-pointers.md src/lifetimes.md src/iterators.md +#: src/testing.md src/error-handling.md src/unsafe-rust.md +#: src/concurrency/welcome.md src/concurrency/sync-exercises.md +#: src/concurrency/welcome-async.md src/concurrency/async-exercises.md +msgid "30 minutes" +msgstr "" + +#: src/running-the-course/course-structure.md src/methods-and-traits.md +#: src/std-types.md src/memory-management.md src/borrowing.md +#: src/concurrency/welcome.md src/concurrency/sync-exercises.md +#: src/concurrency/welcome-async.md src/concurrency/async-pitfalls.md +#: src/concurrency/async-exercises.md +msgid "20 minutes" +msgstr "" + +#: src/running-the-course/course-structure.md src/concurrency/welcome.md +msgid "Send and Sync" +msgstr "SendとSync" + +#: src/running-the-course/course-structure.md +#, fuzzy +msgid "Afternoon (3 hours and 20 minutes, including breaks)" +msgstr "3 日目の午後（休憩を含めて 2 時間 20 分）" + #: src/running-the-course/course-structure.md msgid "Format" msgstr "フォーマット" @@ -1780,35 +2013,23 @@ msgid "There are several useful keyboard shortcuts in mdBook:" msgstr "mdBookには、便利なショートカットキーがいくつか存在します：" #: src/running-the-course/keyboard-shortcuts.md -msgid "Arrow-Left" -msgstr "Arrow-Left" - -#: src/running-the-course/keyboard-shortcuts.md -msgid ": Navigate to the previous page." +#, fuzzy +msgid "Arrow-Left: Navigate to the previous page." msgstr "： 前のページに移動" #: src/running-the-course/keyboard-shortcuts.md -msgid "Arrow-Right" -msgstr "Arrow-Right" - -#: src/running-the-course/keyboard-shortcuts.md -msgid ": Navigate to the next page." +#, fuzzy +msgid "Arrow-Right: Navigate to the next page." msgstr "： 次のページに移動。" -#: src/running-the-course/keyboard-shortcuts.md src/cargo/code-samples.md -msgid "Ctrl + Enter" -msgstr "Ctrl + Enter" - #: src/running-the-course/keyboard-shortcuts.md -msgid ": Execute the code sample that has focus." +#, fuzzy +msgid "Ctrl + Enter: Execute the code sample that has focus." msgstr "： フォーカスを持つコードサンプルを実行" #: src/running-the-course/keyboard-shortcuts.md -msgid "s" -msgstr "s" - -#: src/running-the-course/keyboard-shortcuts.md -msgid ": Activate the search bar." +#, fuzzy +msgid "s: Activate the search bar." msgstr "： 検索バーを起動" #: src/running-the-course/translations.md @@ -1830,13 +2051,13 @@ msgstr "" "[@henrif75](https://github.com/henrif75)" #: src/running-the-course/translations.md +#, fuzzy msgid "" "[Chinese (Simplified)](https://google.github.io/comprehensive-rust/zh-CN/) " "by [@suetfei](https://github.com/suetfei), [@wnghl](https://github.com/" "wnghl), [@anlunx](https://github.com/anlunx), [@kongy](https://github.com/" "kongy), [@noahdragon](https://github.com/noahdragon), [@superwhd](https://" -"github.com/superwhd), [@SketchK](https://github.com/SketchK), and [@nodmp]" -"(https://github.com/nodmp)." +"github.com/superwhd), @SketchK, and [@nodmp](https://github.com/nodmp)." msgstr "" "[中国語（簡体字）](https://google.github.io/comprehensive-rust/zh-CN/): " "[@suetfei](https://github.com/suetfei)、[@wnghl](https://github.com/wnghl)、" @@ -1860,10 +2081,23 @@ msgstr "" "johnathan79717)" #: src/running-the-course/translations.md +#, fuzzy +msgid "" +"[Japanese](https://google.github.io/comprehensive-rust/ja/) by [@CoinEZ-JPN]" +"(https://github.com/CoinEZ), [@momotaro1105](https://github.com/" +"momotaro1105), [@HidenoriKobayashi](https://github.com/HidenoriKobayashi) " +"and [@kantasv](https://github.com/kantasv)." +msgstr "" +"[日本語](https://google.github.io/comprehensive-rust/ja/): [@CoinEZ-JPN]" +"(https://github.com/CoinEZ)、[@momotaro1105](https://github.com/momotaro1105)" + +#: src/running-the-course/translations.md +#, fuzzy msgid "" "[Korean](https://google.github.io/comprehensive-rust/ko/) by [@keispace]" -"(https://github.com/keispace), [@jiyongp](https://github.com/jiyongp), and " -"[@jooyunghan](https://github.com/jooyunghan)." +"(https://github.com/keispace), [@jiyongp](https://github.com/jiyongp), " +"[@jooyunghan](https://github.com/jooyunghan), and [@namhyung](https://github." +"com/namhyung)." msgstr "" "[韓国語](https://google.github.io/comprehensive-rust/ko/): [@keispace]" "(https://github.com/keispace)、[@jiyongp](https://github.com/jiyongp)、" @@ -1877,6 +2111,17 @@ msgstr "" "[スペイン語](https://google.github.io/comprehensive-rust/es/): [@deavid]" "(https://github.com/deavid)" +#: src/running-the-course/translations.md +#, fuzzy +msgid "" +"[Ukrainian](https://google.github.io/comprehensive-rust/uk/) by [@git-user-" +"cpp](https://github.com/git-user-cpp), [@yaremam](https://github.com/" +"yaremam) and [@reta](https://github.com/reta)." +msgstr "" +"[韓国語](https://google.github.io/comprehensive-rust/ko/): [@keispace]" +"(https://github.com/keispace)、[@jiyongp](https://github.com/jiyongp)、" +"[@jooyunghan](https://github.com/jooyunghan)" + #: src/running-the-course/translations.md msgid "" "Use the language picker in the top-right corner to switch between languages." @@ -1893,6 +2138,15 @@ msgid "" "recently updated translations:" msgstr "進行中の翻訳が多数あります。最新の翻訳へのリンクを以下に示します。" +#: src/running-the-course/translations.md +#, fuzzy +msgid "" +"[Arabic](https://google.github.io/comprehensive-rust/ar/) by [@younies]" +"(https://github.com/younies)" +msgstr "" +"[スペイン語](https://google.github.io/comprehensive-rust/es/): [@deavid]" +"(https://github.com/deavid)" + #: src/running-the-course/translations.md msgid "" "[Bengali](https://google.github.io/comprehensive-rust/bn/) by [@raselmandol]" @@ -1902,9 +2156,26 @@ msgstr "" "(https://github.com/raselmandol)" #: src/running-the-course/translations.md +#, fuzzy +msgid "" +"[Farsi](https://google.github.io/comprehensive-rust/fa/) by [@Alix1383]" +"(https://github.com/alix1383), [@DannyRavi](https://github.com/DannyRavi), " +"[@hamidrezakp](https://github.com/hamidrezakp), [@javad-jafari](https://" +"github.com/javad-jafari) and [@moaminsharifi](https://github.com/" +"moaminsharifi)." +msgstr "" +"[中国語（繁体字）](https://google.github.io/comprehensive-rust/zh-TW/): " +"[@hueich](https://github.com/hueich)、[@victorhsieh](https://github.com/" +"victorhsieh)、[@mingyc](https://github.com/mingyc)、[@kuanhungchen](https://" +"github.com/kuanhungchen)、[@johnathan79717](https://github.com/" +"johnathan79717)" + +#: src/running-the-course/translations.md +#, fuzzy msgid "" "[French](https://google.github.io/comprehensive-rust/fr/) by [@KookaS]" -"(https://github.com/KookaS) and [@vcaen](https://github.com/vcaen)." +"(https://github.com/KookaS), [@vcaen](https://github.com/vcaen) and " +"[@AdrienBaudemont](https://github.com/AdrienBaudemont)." msgstr "" "[フランス語](https://google.github.io/comprehensive-rust/fr/): [@KookaS]" "(https://github.com/KookaS)、[@vcaen](https://github.com/vcaen)" @@ -1918,13 +2189,22 @@ msgstr "" "(https://github.com/Throvn)、[@ronaldfw](https://github.com/ronaldfw)" #: src/running-the-course/translations.md +#, fuzzy msgid "" -"[Japanese](https://google.github.io/comprehensive-rust/ja/) by [@CoinEZ-JPN]" -"(https://github.com/CoinEZ) and [@momotaro1105](https://github.com/" -"momotaro1105)." +"[Italian](https://google.github.io/comprehensive-rust/it/) by " +"[@henrythebuilder](https://github.com/henrythebuilder) and [@detro](https://" +"github.com/detro)." +msgstr "" +"[ドイツ語](https://google.github.io/comprehensive-rust/de/): [@Throvn]" +"(https://github.com/Throvn)、[@ronaldfw](https://github.com/ronaldfw)" + +#: src/running-the-course/translations.md +msgid "" +"The full list of translations with their current status is also available " +"either [as of their last update](https://google.github.io/comprehensive-rust/" +"translation-report.html) or [synced to the latest version of the course]" +"(https://google.github.io/comprehensive-rust/synced-translation-report.html)." msgstr "" -"[日本語](https://google.github.io/comprehensive-rust/ja/): [@CoinEZ-JPN]" -"(https://github.com/CoinEZ)、[@momotaro1105](https://github.com/momotaro1105)" #: src/running-the-course/translations.md msgid "" @@ -2001,6 +2281,13 @@ msgstr "" "コード、[Rust formatter](https://github.com/rust-lang/rustfmt)をインストール" "します" +#: src/cargo.md +msgid "" +"On macOS, you can use [Homebrew](https://brew.sh/) to install Rust, but this " +"may provide an outdated version. Therefore, it is recommended to install " +"Rust from the official site." +msgstr "" + #: src/cargo/rust-ecosystem.md msgid "The Rust Ecosystem" msgstr "Rust エコシステム" @@ -2045,11 +2332,10 @@ msgstr "" "ンロードする事も可能です。また、複数のRustのバージョンがインストールされてい" "る場合、`rustup`で切り替えが行えます。" -#: src/cargo/rust-ecosystem.md src/hello-world/hello-world.md -#: src/tuples-and-arrays/tuples-and-arrays.md src/references/exclusive.md -#: src/pattern-matching/destructuring.md src/memory-management/move.md -#: src/error-handling/try.md src/android/setup.md src/concurrency/threads.md -#: src/async/async-await.md +#: src/cargo/rust-ecosystem.md src/types-and-values/hello-world.md +#: src/references/exclusive.md src/memory-management/move.md +#: src/error-handling/try.md src/android/setup.md +#: src/concurrency/async/async-await.md msgid "Key points:" msgstr "要点：" @@ -2204,13 +2490,11 @@ msgstr "講座のコードブロックはインタラクティブです：" msgid "\"Edit me!\"" msgstr "\"Edit me!\"" -#: src/cargo/code-samples.md -msgid "You can use " -msgstr "ボックス内にフォーカスがある状態で" - #: src/cargo/code-samples.md #, fuzzy -msgid " to execute the code when focus is in the text box." +msgid "" +"You can use Ctrl + Enter to execute the code when focus is in the " +"text box." msgstr "を押すと、コードが実行されます。" #: src/cargo/code-samples.md @@ -2370,36 +2654,17 @@ msgid "Pattern matching: destructuring enums, structs, and arrays." msgstr "パターン マッチング: 列挙型、構造体、配列の分解。" #: src/welcome-day-1.md src/welcome-day-2.md src/welcome-day-3.md -#: src/welcome-day-4.md +#: src/welcome-day-4.md src/concurrency/welcome.md +#: src/concurrency/welcome-async.md msgid "Schedule" msgstr "スケジュール" -#: src/welcome-day-1.md src/welcome-day-1-afternoon.md src/welcome-day-2.md -#: src/welcome-day-2-afternoon.md src/welcome-day-3.md -#: src/welcome-day-3-afternoon.md src/welcome-day-4.md -#: src/welcome-day-4-afternoon.md -msgid "In this session:" -msgstr "このセッションの内容:" - -#: src/welcome-day-1.md -msgid "[Welcome](./welcome-day-1.md) (5 minutes)" -msgstr "[ようこそ](./welcome-day-1.md)（5 分）" - -#: src/welcome-day-1.md -msgid "[Hello, World](./hello-world.md) (20 minutes)" -msgstr "[Hello, World](./hello-world.md)（20 分）" - #: src/welcome-day-1.md -msgid "[Types and Values](./types-and-values.md) (1 hour and 5 minutes)" -msgstr "[型と値](./types-and-values.md)（1 時間 5 分）" - -#: src/welcome-day-1.md -msgid "[Control Flow Basics](./control-flow-basics.md) (1 hour)" -msgstr "[制御フローの基本](./control-flow-basics.md)（1 時間）" - -#: src/welcome-day-1.md src/welcome-day-2-afternoon.md -msgid "Including 10 minute breaks, this session should take about 3 hours" -msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 3 時間です。" +#, fuzzy +msgid "" +"Including 10 minute breaks, this session should take about 2 hours and 5 " +"minutes. It contains:" +msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 2 時間 55 分です。" #: src/welcome-day-1.md msgid "Please remind the students that:" @@ -2471,35 +2736,40 @@ msgstr "" "時間配分は、あくまでコースを予定どおりに進めるための目安ですので、必要に応じ" "て柔軟に調整してください。" +#: src/hello-world.md src/concurrency/send-sync.md +#, fuzzy +msgid "This segment should take about 15 minutes. It contains:" +msgstr "このセグメントの所要時間は約 55 分です" + #: src/hello-world.md src/types-and-values.md src/control-flow-basics.md #: src/tuples-and-arrays.md src/references.md src/user-defined-types.md #: src/pattern-matching.md src/methods-and-traits.md src/generics.md #: src/std-types.md src/std-traits.md src/memory-management.md -#: src/smart-pointers.md src/borrowing.md src/slices-and-lifetimes.md -#: src/iterators.md src/modules.md src/testing.md src/error-handling.md -#: src/unsafe-rust.md -msgid "In this segment:" -msgstr "このセグメントの内容:" - -#: src/hello-world.md -msgid "[What is Rust?](./hello-world/what-is-rust.md) (10 minutes)" -msgstr "[Rust とは](./hello-world/what-is-rust.md)（10 分）" - -#: src/hello-world.md -msgid "[Hello, World](./hello-world/hello-world.md) (5 minutes)" -msgstr "[Hello, World](./hello-world/hello-world.md)（5 分）" - -#: src/hello-world.md -msgid "[Benefits of Rust](./hello-world/benefits.md) (3 minutes)" -msgstr "[Rust のメリット](./hello-world/benefits.md)（3 分）" +#: src/smart-pointers.md src/borrowing.md src/lifetimes.md src/iterators.md +#: src/modules.md src/testing.md src/error-handling.md src/unsafe-rust.md +#: src/concurrency/threads.md src/concurrency/channels.md +#: src/concurrency/send-sync.md src/concurrency/shared-state.md +#: src/concurrency/sync-exercises.md src/concurrency/async.md +#: src/concurrency/async-control-flow.md src/concurrency/async-pitfalls.md +#: src/concurrency/async-exercises.md +msgid "Slide" +msgstr "" -#: src/hello-world.md -msgid "[Playground](./hello-world/playground.md) (2 minutes)" -msgstr "[プレイグラウンド](./hello-world/playground.md)（2 分）" +#: src/hello-world.md src/references.md src/user-defined-types.md +#: src/pattern-matching.md src/methods-and-traits.md src/generics.md +#: src/std-types.md src/std-traits.md src/memory-management.md +#: src/smart-pointers.md src/borrowing.md src/lifetimes.md src/modules.md +#: src/unsafe-rust.md src/concurrency/channels.md src/concurrency/send-sync.md +#: src/concurrency/shared-state.md src/concurrency/async.md +#: src/concurrency/async-control-flow.md src/concurrency/async-pitfalls.md +msgid "10 minutes" +msgstr "" -#: src/hello-world.md -msgid "This segment should take about 20 minutes" -msgstr "このセグメントの所要時間は約 20 分です" +#: src/hello-world.md src/control-flow-basics.md src/user-defined-types.md +#: src/memory-management.md src/concurrency/channels.md +#: src/concurrency/send-sync.md +msgid "2 minutes" +msgstr "" #: src/hello-world/what-is-rust.md msgid "" @@ -2583,100 +2853,6 @@ msgstr "ランタイムやガベージコレクションがない。" msgid "Focuses on reliability and safety without sacrificing performance." msgstr "パフォーマンスを犠牲にせず、信頼性と安全性に焦点を当てている。" -#: src/hello-world/hello-world.md -msgid "" -"Let us jump into the simplest possible Rust program, a classic Hello World " -"program:" -msgstr "" -"さっそく一番シンプルなプログラムである定番のHello Worldからみてみましょう：" - -#: src/hello-world/hello-world.md -msgid "\"Hello 🌍!\"" -msgstr "\"Hello 🌍!\"" - -#: src/hello-world/hello-world.md -msgid "What you see:" -msgstr "プログラムの中身：" - -#: src/hello-world/hello-world.md -msgid "Functions are introduced with `fn`." -msgstr "関数は`fn`で導入されます。" - -#: src/hello-world/hello-world.md -msgid "Blocks are delimited by curly braces like in C and C++." -msgstr "CやC++と同様に、ブロックは波括弧で囲みます。" - -#: src/hello-world/hello-world.md -msgid "The `main` function is the entry point of the program." -msgstr "`main`関数はプログラムのエントリーポイントになります。" - -#: src/hello-world/hello-world.md -msgid "Rust has hygienic macros, `println!` is an example of this." -msgstr "Rustには衛生的なマクロがあり、`println!`はその一例です。" - -#: src/hello-world/hello-world.md -msgid "Rust strings are UTF-8 encoded and can contain any Unicode character." -msgstr "" -"Rustの文字列はUTF-8でエンコードされ、どんなUnicode文字でも含む事ができます。" - -#: src/hello-world/hello-world.md -#, fuzzy -msgid "" -"This slide tries to make the students comfortable with Rust code. They will " -"see a ton of it over the next four days so we start small with something " -"familiar." -msgstr "" -"このスライドの目的は、Rustのコードに慣れてもらう事です。この4日間で大量のRust" -"コードを見る事になるので、馴染みのあるものから始めてみましょう。" - -#: src/hello-world/hello-world.md -#, fuzzy -msgid "" -"Rust is very much like other languages in the C/C++/Java tradition. It is " -"imperative and it doesn't try to reinvent things unless absolutely necessary." -msgstr "" -"Rustは、C/C++/Java系統の言語によく似ています。Rustは、命令型（関数型ではな" -"く）であり、必須でない限り機能の再発明はしません。" - -#: src/hello-world/hello-world.md -#, fuzzy -msgid "Rust is modern with full support for things like Unicode." -msgstr "RustはUnicodeなどにも完全に対応している現代的な言語です。" - -#: src/hello-world/hello-world.md -#, fuzzy -msgid "" -"Rust uses macros for situations where you want to have a variable number of " -"arguments (no function [overloading](../control-flow-basics/functions.md))." -msgstr "" -"Rustで可変長引数を用いたい場合は、マクロを使用します(関数[オーバーロード]" -"(basic-syntax/functions-interlude.md)はありません)。" - -#: src/hello-world/hello-world.md -#, fuzzy -msgid "" -"Macros being 'hygienic' means they don't accidentally capture identifiers " -"from the scope they are used in. Rust macros are actually only [partially " -"hygienic](https://veykril.github.io/tlborm/decl-macros/minutiae/hygiene." -"html)." -msgstr "" -"マクロが「衛生的 (hygienic)」であるとは、そのマクロが呼び出されるスコープにあ" -"る識別子と、そのマクロ内部の識別子が衝突しないことが保証されていることを言い" -"ます。Rustのマクロは、実際には[部分的にしか衛生的](https://veykril.github.io/" -"tlborm/decl-macros/minutiae/hygiene.html)ではありません。" - -#: src/hello-world/hello-world.md -msgid "" -"Rust is multi-paradigm. For example, it has powerful [object-oriented " -"programming features](https://doc.rust-lang.org/book/ch17-00-oop.html), and, " -"while it is not a functional language, it includes a range of [functional " -"concepts](https://doc.rust-lang.org/book/ch13-00-functional-features.html)." -msgstr "" -"Rust はマルチパラダイムです。たとえば、強力な [オブジェクト指向プログラミング" -"機能](https://doc.rust-lang.org/book/ch17-00-oop.html) を備えている一方、非関" -"数型言語であるにもかかわらず、さまざまな [関数的概念](https://doc.rust-lang." -"org/book/ch13-00-functional-features.html) を内包しています。" - #: src/hello-world/benefits.md msgid "Some unique selling points of Rust:" msgstr "Rustのユニークなセールスポイントをいくつか紹介します：" @@ -2803,11 +2979,12 @@ msgstr "" "係管理などの構造要素を含む現代的な言語です。" #: src/hello-world/benefits.md +#, fuzzy msgid "" "Experience with Java, Go, Python, JavaScript...: You get the same memory " "safety as in those languages, plus a similar high-level language feeling. In " "addition you get fast and predictable performance like C and C++ (no garbage " -"collector) as well as access to low-level hardware (should you need it)" +"collector) as well as access to low-level hardware (should you need it)." msgstr "" "Java、Go、Python、JavaScriptなどの経験がある場合： これらの言語と同様のメモリ" "安全性と、高水準言語に近い感覚を得ることができます。また、CやC++のように高速" @@ -2865,33 +3042,104 @@ msgstr "" "ましょう。これは、Rust の最適化や生成されたアセンブリについて詳しく知りたい受" "講者に特に役立ちます。" -#: src/types-and-values.md -msgid "[Variables](./types-and-values/variables.md) (5 minutes)" -msgstr "[変数](./types-and-values/variables.md)（5 分）" +#: src/types-and-values.md src/control-flow-basics.md src/modules.md +#, fuzzy +msgid "This segment should take about 40 minutes. It contains:" +msgstr "このセグメントの所要時間は約 40 分です" -#: src/types-and-values.md -msgid "[Values](./types-and-values/values.md) (10 minutes)" -msgstr "[値](./types-and-values/values.md)（10 分）" +#: src/types-and-values/hello-world.md +msgid "" +"Let us jump into the simplest possible Rust program, a classic Hello World " +"program:" +msgstr "" +"さっそく一番シンプルなプログラムである定番のHello Worldからみてみましょう：" -#: src/types-and-values.md -msgid "[Arithmetic](./types-and-values/arithmetic.md) (5 minutes)" -msgstr "[算術](./types-and-values/arithmetic.md)（5 分）" +#: src/types-and-values/hello-world.md +msgid "\"Hello 🌍!\"" +msgstr "\"Hello 🌍!\"" -#: src/types-and-values.md -msgid "[Strings](./types-and-values/strings.md) (10 minutes)" -msgstr "[文字列](./types-and-values/strings.md)（10 分）" +#: src/types-and-values/hello-world.md +msgid "What you see:" +msgstr "プログラムの中身：" -#: src/types-and-values.md -msgid "[Type Inference](./types-and-values/inference.md) (5 minutes)" -msgstr "[型推論](./types-and-values/inference.md)（5 分）" +#: src/types-and-values/hello-world.md +msgid "Functions are introduced with `fn`." +msgstr "関数は`fn`で導入されます。" -#: src/types-and-values.md -msgid "[Exercise: Fibonacci](./types-and-values/exercise.md) (30 minutes)" -msgstr "[演習: フィボナッチ](./types-and-values/exercise.md)（30 分）" +#: src/types-and-values/hello-world.md +msgid "Blocks are delimited by curly braces like in C and C++." +msgstr "CやC++と同様に、ブロックは波括弧で囲みます。" -#: src/types-and-values.md src/testing.md src/unsafe-rust.md -msgid "This segment should take about 1 hour and 5 minutes" -msgstr "このセグメントの所要時間は約 1 時間 5 分です" +#: src/types-and-values/hello-world.md +msgid "The `main` function is the entry point of the program." +msgstr "`main`関数はプログラムのエントリーポイントになります。" + +#: src/types-and-values/hello-world.md +msgid "Rust has hygienic macros, `println!` is an example of this." +msgstr "Rustには衛生的なマクロがあり、`println!`はその一例です。" + +#: src/types-and-values/hello-world.md +msgid "Rust strings are UTF-8 encoded and can contain any Unicode character." +msgstr "" +"Rustの文字列はUTF-8でエンコードされ、どんなUnicode文字でも含む事ができます。" + +#: src/types-and-values/hello-world.md +#, fuzzy +msgid "" +"This slide tries to make the students comfortable with Rust code. They will " +"see a ton of it over the next four days so we start small with something " +"familiar." +msgstr "" +"このスライドの目的は、Rustのコードに慣れてもらう事です。この4日間で大量のRust" +"コードを見る事になるので、馴染みのあるものから始めてみましょう。" + +#: src/types-and-values/hello-world.md +#, fuzzy +msgid "" +"Rust is very much like other languages in the C/C++/Java tradition. It is " +"imperative and it doesn't try to reinvent things unless absolutely necessary." +msgstr "" +"Rustは、C/C++/Java系統の言語によく似ています。Rustは、命令型（関数型ではな" +"く）であり、必須でない限り機能の再発明はしません。" + +#: src/types-and-values/hello-world.md +#, fuzzy +msgid "Rust is modern with full support for things like Unicode." +msgstr "RustはUnicodeなどにも完全に対応している現代的な言語です。" + +#: src/types-and-values/hello-world.md +#, fuzzy +msgid "" +"Rust uses macros for situations where you want to have a variable number of " +"arguments (no function [overloading](../control-flow-basics/functions.md))." +msgstr "" +"Rustで可変長引数を用いたい場合は、マクロを使用します(関数[オーバーロード]" +"(basic-syntax/functions-interlude.md)はありません)。" + +#: src/types-and-values/hello-world.md +#, fuzzy +msgid "" +"Macros being 'hygienic' means they don't accidentally capture identifiers " +"from the scope they are used in. Rust macros are actually only [partially " +"hygienic](https://veykril.github.io/tlborm/decl-macros/minutiae/hygiene." +"html)." +msgstr "" +"マクロが「衛生的 (hygienic)」であるとは、そのマクロが呼び出されるスコープにあ" +"る識別子と、そのマクロ内部の識別子が衝突しないことが保証されていることを言い" +"ます。Rustのマクロは、実際には[部分的にしか衛生的](https://veykril.github.io/" +"tlborm/decl-macros/minutiae/hygiene.html)ではありません。" + +#: src/types-and-values/hello-world.md +msgid "" +"Rust is multi-paradigm. For example, it has powerful [object-oriented " +"programming features](https://doc.rust-lang.org/book/ch17-00-oop.html), and, " +"while it is not a functional language, it includes a range of [functional " +"concepts](https://doc.rust-lang.org/book/ch13-00-functional-features.html)." +msgstr "" +"Rust はマルチパラダイムです。たとえば、強力な [オブジェクト指向プログラミング" +"機能](https://doc.rust-lang.org/book/ch17-00-oop.html) を備えている一方、非関" +"数型言語であるにもかかわらず、さまざまな [関数的概念](https://doc.rust-lang." +"org/book/ch13-00-functional-features.html) を内包しています。" #: src/types-and-values/variables.md msgid "" @@ -2901,8 +3149,7 @@ msgstr "" "Rust は静的型付けによって型安全性を提供します。変数のバインディングは `let` " "を使用して行います。" -#: src/types-and-values/variables.md src/control-flow-basics/loops.md -#: src/control-flow-basics/break-continue.md +#: src/types-and-values/variables.md src/control-flow-basics/loops/for.md #: src/control-flow-basics/blocks-and-scopes.md msgid "\"x: {x}\"" msgstr "\"x: {x}\"" @@ -2938,12 +3185,11 @@ msgid "" "each type." msgstr "基本的な組み込み型と、各型のリテラル値の構文を以下に示します。" -#: src/types-and-values/values.md src/tuples-and-arrays/tuples-and-arrays.md -#: src/unsafe-rust/exercise.md +#: src/types-and-values/values.md src/unsafe-rust/exercise.md msgid "Types" msgstr "型" -#: src/types-and-values/values.md src/tuples-and-arrays/tuples-and-arrays.md +#: src/types-and-values/values.md msgid "Literals" msgstr "リテラル" @@ -2987,7 +3233,7 @@ msgstr "`3.14`、`-10.0e20`、`2_f32`" msgid "Unicode scalar values" msgstr "Unicode スカラー値" -#: src/types-and-values/values.md +#: src/types-and-values/values.md src/android/aidl/types/primitives.md msgid "`char`" msgstr "`char`" @@ -2999,7 +3245,7 @@ msgstr "`'a'`、`'α'`、`'∞'`" msgid "Booleans" msgstr "ブール値" -#: src/types-and-values/values.md +#: src/types-and-values/values.md src/android/aidl/types/primitives.md msgid "`bool`" msgstr "`bool`" @@ -3060,10 +3306,11 @@ msgid "Arithmetic is very similar to other languages, with similar precedence." msgstr "算術は他の言語とよく似ており、優先順位も類似しています。" #: src/types-and-values/arithmetic.md +#, fuzzy msgid "" "What about integer overflow? In C and C++ overflow of _signed_ integers is " -"actually undefined, and might do different things on different platforms or " -"compilers. In Rust, it's defined." +"actually undefined, and might do unknown things at runtime. In Rust, it's " +"defined." msgstr "" "整数オーバーフローはどうでしょうか。C と C++ では、 _符号付き_ 整数のオーバー" "フローは実際には未定義であり、プラットフォームやコンパイラによって動作が異な" @@ -3091,96 +3338,6 @@ msgstr "" "実際には、コンパイラは定数式のオーバーフローを検出します。この例で別の関数が" "必要になるのはそのためです。" -#: src/types-and-values/strings.md -msgid "" -"Rust has two types to represent strings, both of which will be covered in " -"more depth later. Both _always_ store UTF-8 encoded strings." -msgstr "" -"Rust には文字列を表す 2 つの型があります。どちらも後ほど詳しく説明します。両" -"方とも、 _常に_ UTF-8 でエンコードされた文字列を格納します。" - -#: src/types-and-values/strings.md -msgid "`String` - a modifiable, owned string." -msgstr "`String` - 変更可能で、所有権をもつ文字列。" - -#: src/types-and-values/strings.md -msgid "`&str` - a read-only string. String literals have this type." -msgstr "`&str` - 読み取り専用の文字列。文字列リテラルはこの型です。" - -#: src/types-and-values/strings.md -msgid "\"Greetings\"" -msgstr "\"Greetings\"" - -#: src/types-and-values/strings.md -msgid "\"🪐\"" -msgstr "\"🪐\"" - -#: src/types-and-values/strings.md -msgid "\", \"" -msgstr "\", \"" - -#: src/types-and-values/strings.md -msgid "\"final sentence: {}\"" -msgstr "\"final sentence: {}\"" - -#: src/types-and-values/strings.md src/async/control-flow/join.md -msgid "\"{:?}\"" -msgstr "\"{:?}\"" - -#: src/types-and-values/strings.md -msgid "//println!(\"{:?}\", &sentence[12..13]);\n" -msgstr "//println!(\"{:?}\", &sentence[12..13]);\n" - -#: src/types-and-values/strings.md -msgid "" -"This slide introduces strings. Everything here will be covered in more depth " -"later, but this is enough for subsequent slides and exercises to use strings." -msgstr "" -"このスライドでは文字列を紹介します。ここで取り上げた内容については後ほど詳し" -"く説明しますが、以降のスライドや演習で文字列を使用するにはこれで十分です。" - -#: src/types-and-values/strings.md -msgid "Invalid UTF-8 in a string is UB, and this not allowed in safe Rust." -msgstr "文字列内の無効な UTF-8 は UB であり、Safe Rust では許可されません。" - -#: src/types-and-values/strings.md -msgid "" -"`String` is a user-defined type with a constructor (`::new()`) and methods " -"like `s.push_str(..)`." -msgstr "" -"`String` は、コンストラクタ（`::new()` と `s.push_str(..)` などのメソッド）を" -"持つユーザー定義型です。" - -#: src/types-and-values/strings.md -msgid "" -"The `&` in `&str` indicates that this is a reference. We will cover " -"references later, so for now just think of `&str` as a unit meaning \"a read-" -"only string\"." -msgstr "" -"`&str` 内の `&` は、これが参照であることを示します。参照については後ほど説明" -"しますので、ここでは `&str` を、「読み取り専用の文字列」を意味する単位と考え" -"てください。" - -#: src/types-and-values/strings.md -msgid "" -"The commented-out line is indexing into the string by byte position. " -"`12..13` does not end on a character boundary, so the program panics. Adjust " -"it to a range that does, based on the error message." -msgstr "" -"コメントアウトされた行は、バイト位置で文字列をインデックス化しています。" -"`12..13` は文字境界で終わっていないため、プログラムはパニックします。エラー " -"メッセージに基づいて、適切な範囲に調整してください。" - -#: src/types-and-values/strings.md -msgid "" -"Raw strings allow you to create a `&str` value with escapes disabled: " -"`r\"\\n\" == \"\\\\n\"`. You can embed double-quotes by using an equal " -"amount of `#` on either side of the quotes:" -msgstr "" -"未加工の文字列を使用すると、エスケープを無効にして `&str` 値を作成できます" -"（`r\"\\n\" == \"\\\\n\"`）。二重引用符を埋め込むには、引用符の両側に同量の " -"`#` を使用します。" - #: src/types-and-values/inference.md msgid "Rust will look at how the variable is _used_ to determine the type:" msgstr "" @@ -3223,10 +3380,11 @@ msgid "// ERROR: no implementation for `{float} == {integer}`\n" msgstr "// エラー: `{float} == {integer}` の実装がありません\n" #: src/types-and-values/exercise.md +#, fuzzy msgid "" -"The first and second Fibonacci numbers are both `1`. For n>2, the n'th " -"Fibonacci number is calculated recursively as the sum of the n-1'th and " -"n-2'th Fibonacci numbers." +"The Fibonacci sequence begins with `[0,1]`. For n>1, the n'th Fibonacci " +"number is calculated recursively as the sum of the n-1'th and n-2'th " +"Fibonacci numbers." msgstr "" "1 つ目と 2 つ目のフィボナッチ数はどちらも `1` です。n>2 の場合、n 番目のフィ" "ボナッチ数は、n-1 番目のフィボナッチ数と n-2 番目のフィボナッチ数の合計として" @@ -3253,74 +3411,30 @@ msgid "// The recursive case.\n" msgstr "// 再帰的なケース。\n" #: src/types-and-values/exercise.md src/types-and-values/solution.md -msgid "\"fib(n) = {}\"" +#, fuzzy +msgid "\"fib({n}) = {}\"" msgstr "\"fib(n) = {}\"" #: src/control-flow-basics.md -msgid "[Conditionals](./control-flow-basics/conditionals.md) (5 minutes)" -msgstr "[条件文](./control-flow-basics/conditionals.md)（5 分）" - -#: src/control-flow-basics.md -msgid "[Loops](./control-flow-basics/loops.md) (5 minutes)" -msgstr "[ループ](./control-flow-basics/loops.md)（5 分）" - -#: src/control-flow-basics.md -msgid "" -"[break and continue](./control-flow-basics/break-continue.md) (5 minutes)" -msgstr "[break と continue](./control-flow-basics/break-continue.md)（5 分）" +#, fuzzy +msgid "if Expressions" +msgstr "if式" -#: src/control-flow-basics.md -msgid "" -"[Blocks and Scopes](./control-flow-basics/blocks-and-scopes.md) (10 minutes)" +#: src/control-flow-basics.md src/pattern-matching.md src/concurrency/async.md +#: src/concurrency/async-control-flow.md +msgid "4 minutes" msgstr "" -"[ブロックとスコープ](./control-flow-basics/blocks-and-scopes.md)（10 分）" #: src/control-flow-basics.md -msgid "[Functions](./control-flow-basics/functions.md) (3 minutes)" -msgstr "[関数](./control-flow-basics/functions.md)（3 分）" - -#: src/control-flow-basics.md -msgid "[Macros](./control-flow-basics/macros.md) (2 minutes)" -msgstr "[マクロ](./control-flow-basics/macros.md)（2 分）" - -#: src/control-flow-basics.md -msgid "" -"[Exercise: Collatz Sequence](./control-flow-basics/exercise.md) (30 minutes)" -msgstr "[演習: コラッツ数列](./control-flow-basics/exercise.md)（30 分）" - -#: src/control-flow-basics.md src/tuples-and-arrays.md src/borrowing.md -msgid "This segment should take about 1 hour" -msgstr "このセグメントの所要時間は約 1 時間です" - -#: src/control-flow-basics/conditionals.md -msgid "Much of the Rust syntax will be familiar to you from C, C++ or Java:" -msgstr "Rust の構文の多くは、C、C++、Java で見覚えがあるでしょう。" - -#: src/control-flow-basics/conditionals.md #, fuzzy -msgid "Blocks are delimited by curly braces." -msgstr "CやC++と同様に、ブロックは波括弧で囲みます。" - -#: src/control-flow-basics/conditionals.md -msgid "" -"Line comments are started with `//`, block comments are delimited by `/* ... " -"*/`." -msgstr "" -"行コメントは `//` で始まり、ブロック コメントは `/* ... */` で区切られます。" - -#: src/control-flow-basics/conditionals.md -msgid "Keywords like `if` and `while` work the same." -msgstr "`if` や `while` などのキーワードの動作は同じです。" - -#: src/control-flow-basics/conditionals.md -msgid "Variable assignment is done with `=`, comparison is done with `==`." -msgstr "変数の代入は `=` で行われ、比較は `==` で行われます。" +msgid "break and continue" +msgstr "`break` と `continue`" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md msgid "`if` expressions" msgstr "`if` 式" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md msgid "" "You use [`if` expressions](https://doc.rust-lang.org/reference/expressions/" "if-expr.html#if-expressions) exactly like `if` statements in other languages:" @@ -3328,19 +3442,19 @@ msgstr "" "Rust の [`if` 式](https://doc.rust-lang.org/reference/expressions/if-expr." "html#if-expressions) は、他の言語における `if` 文と全く同じように使えます。" -#: src/control-flow-basics/conditionals.md -msgid "\"small\"" -msgstr "\"small\"" +#: src/control-flow-basics/if.md +msgid "\"zero!\"" +msgstr "" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md msgid "\"biggish\"" msgstr "\"biggish\"" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md msgid "\"huge\"" msgstr "\"huge\"" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md msgid "" "In addition, you can use `if` as an expression. The last expression of each " "block becomes the value of the `if` expression:" @@ -3348,15 +3462,19 @@ msgstr "" "さらに、`if` を式としても用いることができます。それぞれのブロックにある最後の" "式が、`if` 式の値となります。" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md +msgid "\"small\"" +msgstr "\"small\"" + +#: src/control-flow-basics/if.md msgid "\"large\"" msgstr "\"large\"" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md msgid "\"number size: {}\"" msgstr "\"number size: {}\"" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md #, fuzzy msgid "" "Because `if` is an expression and must have a particular type, both of its " @@ -3367,11 +3485,13 @@ msgstr "" "`if` 式の分岐ブロックは同一の型を持つ必要があります。2 つ目の例において、" "`x / 2` のあとに `;` を付け加えると何が起こるでしょうか。" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md +#, fuzzy msgid "" -"When `if` is used in an expression, the expression must have a `;` to " -"separate it from the next statement. Remove the `;` before `println!` to see " -"the compiler error." +"An `if` expression should be used in the same way as the other expressions. " +"For example, when it is used in a `let` statement, the statement must be " +"terminated with a `;` as well. Remove the `;` before `println!` to see the " +"compiler error." msgstr "" "式で `if` を使用する場合、次のステートメントと区切るために、式に `;` を含める" "必要があります。`println!` の前にある `;` を削除すると、コンパイラ エラーが表" @@ -3400,23 +3520,36 @@ msgstr "" msgid "\"Final x: {x}\"" msgstr "\"Final x: {x}\"" -#: src/control-flow-basics/loops.md -msgid "`for`" -msgstr "`for`" - -#: src/control-flow-basics/loops.md +#: src/control-flow-basics/loops/for.md +#, fuzzy msgid "" "The [`for` loop](https://doc.rust-lang.org/std/keyword.for.html) iterates " -"over ranges of values:" +"over ranges of values or the items in a collection:" msgstr "" "[`for` ループ](https://doc.rust-lang.org/std/keyword.for.html) は、値の範囲を" "反復処理します。" -#: src/control-flow-basics/loops.md -msgid "`loop`" -msgstr "`loop`" +#: src/control-flow-basics/loops/for.md +msgid "\"elem: {elem}\"" +msgstr "" -#: src/control-flow-basics/loops.md +#: src/control-flow-basics/loops/for.md +msgid "" +"Under the hood `for` loops use a concept called \"iterators\" to handle " +"iterating over different kinds of ranges/collections. Iterators will be " +"discussed in more detail later." +msgstr "" + +#: src/control-flow-basics/loops/for.md +#, fuzzy +msgid "" +"Note that the first `for` loop only iterates to `4`. Show the `1..=5` syntax " +"for an inclusive range." +msgstr "" +"なお、この `for` ループは `4` までしか反復処理しません。5 を範囲に含める場合" +"の構文は `1..=5` であることを示します。" + +#: src/control-flow-basics/loops/loop.md msgid "" "The [`loop` statement](https://doc.rust-lang.org/std/keyword.loop.html) just " "loops forever, until a `break`." @@ -3424,49 +3557,53 @@ msgstr "" "[`loop` ステートメント](https://doc.rust-lang.org/std/keyword.loop.html) は、" "`break` まで永久にループするだけです。" -#: src/control-flow-basics/loops.md +#: src/control-flow-basics/loops/loop.md msgid "\"{i}\"" msgstr "\"{i}\"" -#: src/control-flow-basics/loops.md -msgid "" -"We will discuss iteration later; for now, just stick to range expressions." -msgstr "" -"反復処理については後で説明しますので、ここでは範囲式だけに注目してください。" - -#: src/control-flow-basics/loops.md +#: src/control-flow-basics/break-continue.md msgid "" -"Note that the `for` loop only iterates to `4`. Show the `1..=5` syntax for " -"an inclusive range." +"If you want to immediately start the next iteration use [`continue`](https://" +"doc.rust-lang.org/reference/expressions/loop-expr.html#continue-expressions)." msgstr "" -"なお、この `for` ループは `4` までしか反復処理しません。5 を範囲に含める場合" -"の構文は `1..=5` であることを示します。" +"次のイテレーションをすぐさま開始したい場合は [`continue`](https://doc.rust-" +"lang.org/reference/expressions/loop-expr.html#continue-expressions) を使用し" +"てください。" #: src/control-flow-basics/break-continue.md #, fuzzy msgid "" "If you want to exit any kind of loop early, use [`break`](https://doc.rust-" -"lang.org/reference/expressions/loop-expr.html#break-expressions). For " +"lang.org/reference/expressions/loop-expr.html#break-expressions). With " "`loop`, this can take an optional expression that becomes the value of the " "`loop` expression." msgstr "" "ループから早く抜け出したい場合は [`break`](https://doc.rust-lang.org/" "reference/expressions/loop-expr.html#break-expressions) を使用してください。" +#: src/control-flow-basics/break-continue.md src/std-traits/exercise.md +#: src/std-traits/solution.md src/smart-pointers/trait-objects.md +#: src/borrowing/interior-mutability.md src/modules/exercise.md +#: src/modules/solution.md src/android/build-rules/library.md +#: src/android/interoperability/cpp/rust-bridge.md +#: src/concurrency/async-pitfalls/cancellation.md +msgid "\"{}\"" +msgstr "\"{}\"" + #: src/control-flow-basics/break-continue.md +#, fuzzy msgid "" -"If you want to immediately start the next iteration use [`continue`](https://" -"doc.rust-lang.org/reference/expressions/loop-expr.html#continue-expressions)." +"Note that `loop` is the only looping construct which can return a non-" +"trivial value. This is because it's guaranteed to only return at a `break` " +"statement (unlike `while` and `for` loops, which can also return when the " +"condition fails)." msgstr "" -"次のイテレーションをすぐさま開始したい場合は [`continue`](https://doc.rust-" -"lang.org/reference/expressions/loop-expr.html#continue-expressions) を使用し" -"てください。" - -#: src/control-flow-basics/break-continue.md -msgid "\"{result}\"" -msgstr "\"{result}\"" +"注意が必要なのは、`loop` が唯一、非自明な値を返すことができるループ構造である" +"という点です。これは、`loop` が少なくとも一度は必ず実行されることが保証されて" +"いるからです（これに対して、while や for ループは必ずしも実行されるわけではあ" +"りません）。" -#: src/control-flow-basics/break-continue.md +#: src/control-flow-basics/break-continue/labels.md msgid "" "Both `continue` and `break` can optionally take a label argument which is " "used to break out of nested loops:" @@ -3474,27 +3611,9 @@ msgstr "" "`continue` と `break` はオプションでラベル引数を取ることができます。ラベルは" "ネストしたループから抜け出すために使われます。" -#: src/control-flow-basics/break-continue.md -msgid "\"x: {x}, i: {i}\"" -msgstr "\"x: {x}, i: {i}\"" - -#: src/control-flow-basics/break-continue.md -msgid "" -"In this case we break the outer loop after 3 iterations of the inner loop." -msgstr "" -"上の例では、内側のループを 3 回イテレーションしたのちに外側のループを抜けるこ" -"とになります。" - -#: src/control-flow-basics/break-continue.md -msgid "" -"Note that `loop` is the only looping construct which returns a non-trivial " -"value. This is because it's guaranteed to be entered at least once (unlike " -"`while` and `for` loops)." +#: src/control-flow-basics/break-continue/labels.md +msgid "\"elements searched: {elements_searched}\"" msgstr "" -"注意が必要なのは、`loop` が唯一、非自明な値を返すことができるループ構造である" -"という点です。これは、`loop` が少なくとも一度は必ず実行されることが保証されて" -"いるからです（これに対して、while や for ループは必ずしも実行されるわけではあ" -"りません）。" #: src/control-flow-basics/blocks-and-scopes.md msgid "Blocks" @@ -3523,51 +3642,47 @@ msgstr "" "最後の式が `;` で終了した場合、ブロック全体の値と型は `()` になります。" #: src/control-flow-basics/blocks-and-scopes.md -msgid "Scopes and Shadowing" -msgstr "スコープとシャドーイング" +msgid "" +"You can show how the value of the block changes by changing the last line in " +"the block. For instance, adding/removing a semicolon or using a `return`." +msgstr "" +"ブロック内にある最後の行を変更することによって、ブロック全体の値が変わること" +"が分かります。例えば、行末のセミコロンを追加/削除したり、`return` を使用した" +"りすることで、ブロックの値は変化します。" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "A variable's scope is limited to the enclosing block." msgstr "変数のスコープは、囲まれたブロック内に限定されます。" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "" "You can shadow variables, both those from outer scopes and variables from " "the same scope:" msgstr "" "外側のスコープの変数と、同じスコープの変数の両方をシャドーイングできます。" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "\"before: {a}\"" msgstr "\"before: {a}\"" -#: src/control-flow-basics/blocks-and-scopes.md src/std-traits/from-and-into.md -#: src/slices-and-lifetimes/solution.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md src/generics/exercise.md +#: src/generics/solution.md src/std-traits/from-and-into.md msgid "\"hello\"" msgstr "\"hello\"" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "\"inner scope: {a}\"" msgstr "\"inner scope: {a}\"" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "\"shadowed in inner scope: {a}\"" msgstr "\"shadowed in inner scope: {a}\"" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "\"after: {a}\"" msgstr "\"after: {a}\"" -#: src/control-flow-basics/blocks-and-scopes.md -msgid "" -"You can show how the value of the block changes by changing the last line in " -"the block. For instance, adding/removing a semicolon or using a `return`." -msgstr "" -"ブロック内にある最後の行を変更することによって、ブロック全体の値が変わること" -"が分かります。例えば、行末のセミコロンを追加/削除したり、`return` を使用した" -"りすることで、ブロックの値は変化します。" - -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "" "Show that a variable's scope is limited by adding a `b` in the inner block " "in the last example, and then trying to access it outside that block." @@ -3575,21 +3690,22 @@ msgstr "" "最後の例の内側のブロックに `b` を追加し、そのブロックの外側でアクセスを試みる" "ことで、変数のスコープが制限されていることを示します。" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md +#, fuzzy msgid "" "Shadowing is different from mutation, because after shadowing both " -"variable's memory locations exist at the same time. Both are available under " +"variables' memory locations exist at the same time. Both are available under " "the same name, depending where you use it in the code." msgstr "" "シャドーイング後は両方の変数のメモリ位置が同時に存在するため、シャドーイング" "はミューテーションとは異なります。どちらも、コードで使用する場所に応じて同じ" "名前で使用できます。" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "A shadowing variable can have a different type." msgstr "シャドーイング変数の型はさまざまです。" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "" "Shadowing looks obscure at first, but is convenient for holding on to values " "after `.unwrap()`." @@ -3618,9 +3734,10 @@ msgstr "" "ファクタリングします）。" #: src/control-flow-basics/functions.md +#, fuzzy msgid "" "Some functions have no return value, and return the 'unit type', `()`. The " -"compiler will infer this if the `-> ()` return type is omitted." +"compiler will infer this if the return type is omitted." msgstr "" "戻り値がなく、'unit type'、`()` を返す関数もあります。`-> ()` の戻り値の型が" "省略されている場合、コンパイラはこれを推測します。" @@ -3714,160 +3831,65 @@ msgstr "" "使用について説明します。" #: src/control-flow-basics/exercise.md +#, fuzzy msgid "" "The [Collatz Sequence](https://en.wikipedia.org/wiki/Collatz_conjecture) is " -"defined as follows, for an arbitrary n" +"defined as follows, for an arbitrary n1 greater than zero:" msgstr "" "[コラッツ数列](https://en.wikipedia.org/wiki/Collatz_conjecture) は、ゼロより" "大きい任意の n" #: src/control-flow-basics/exercise.md -msgid "1" -msgstr "1" - -#: src/control-flow-basics/exercise.md -msgid " greater than zero:" -msgstr " に対して、次のように定義されます。" - -#: src/control-flow-basics/exercise.md -msgid "If _n" -msgstr "_n" - -#: src/control-flow-basics/exercise.md -msgid "i" -msgstr "i" - -#: src/control-flow-basics/exercise.md -msgid "_ is 1, then the sequence terminates at _n" +#, fuzzy +msgid "" +"If _ni_ is 1, then the sequence terminates at _ni_." msgstr "_ が 1 の場合、数列は _n" #: src/control-flow-basics/exercise.md -msgid "_." -msgstr "_で終了します。" - -#: src/control-flow-basics/exercise.md -msgid "_ is even, then _n" -msgstr "_ が偶数の場合、_n" +msgid "If _ni_ is even, then _ni+1 = ni / 2_." +msgstr "" #: src/control-flow-basics/exercise.md -msgid "i+1" -msgstr "i+1" +msgid "" +"If _ni_ is odd, then _ni+1 = 3 * ni + 1_." +msgstr "" #: src/control-flow-basics/exercise.md -msgid " = n" -msgstr " = n" +#, fuzzy +msgid "For example, beginning with _n1_ = 3:" +msgstr "たとえば、_n" #: src/control-flow-basics/exercise.md -msgid " / 2_." -msgstr " / 2_ になります。" +msgid "3 is odd, so _n2_ = 3 * 3 + 1 = 10;" +msgstr "" #: src/control-flow-basics/exercise.md -msgid "_ is odd, then _n" -msgstr "_ が奇数の場合、_n" +msgid "10 is even, so _n3_ = 10 / 2 = 5;" +msgstr "" #: src/control-flow-basics/exercise.md -msgid " = 3 * n" -msgstr " = 3 * n" +msgid "5 is odd, so _n4_ = 3 * 5 + 1 = 16;" +msgstr "" #: src/control-flow-basics/exercise.md -msgid " + 1_." -msgstr " + 1_ になります。" +msgid "16 is even, so _n5_ = 16 / 2 = 8;" +msgstr "" #: src/control-flow-basics/exercise.md -msgid "For example, beginning with _n" -msgstr "たとえば、_n" +msgid "8 is even, so _n6_ = 8 / 2 = 4;" +msgstr "" #: src/control-flow-basics/exercise.md -msgid "_ = 3:" -msgstr "_ = 3 で始まる場合は以下のようになります。" +msgid "4 is even, so _n7_ = 4 / 2 = 2;" +msgstr "" #: src/control-flow-basics/exercise.md -msgid "3 is odd, so _n" -msgstr "3 は奇数なので、_n" +msgid "2 is even, so _n8_ = 1; and" +msgstr "" #: src/control-flow-basics/exercise.md -msgid "2" -msgstr "2" - -#: src/control-flow-basics/exercise.md -msgid "_ = 3 * 3 + 1 = 10;" -msgstr "_ = 3 * 3 + 1 = 10 になります。" - -#: src/control-flow-basics/exercise.md -msgid "10 is even, so _n" -msgstr "10 は偶数なので、_n" - -#: src/control-flow-basics/exercise.md src/bare-metal/aps/better-uart.md -msgid "3" -msgstr "3" - -#: src/control-flow-basics/exercise.md -msgid "_ = 10 / 2 = 5;" -msgstr "_ = 10 / 2 = 5 になります。" - -#: src/control-flow-basics/exercise.md -msgid "5 is odd, so _n" -msgstr "5 は奇数なので、_n" - -#: src/control-flow-basics/exercise.md src/bare-metal/aps/better-uart.md -msgid "4" -msgstr "4" - -#: src/control-flow-basics/exercise.md -msgid "_ = 3 * 5 + 1 = 16;" -msgstr "_ = 3 * 5 + 1 = 16 になります。" - -#: src/control-flow-basics/exercise.md -msgid "16 is even, so _n" -msgstr "16 は偶数なので、_n" - -#: src/control-flow-basics/exercise.md -msgid "5" -msgstr "5" - -#: src/control-flow-basics/exercise.md -msgid "_ = 16 / 2 = 8;" -msgstr "_ = 16 / 2 = 8 になります。" - -#: src/control-flow-basics/exercise.md -msgid "8 is even, so _n" -msgstr "8 は偶数なので、_n" - -#: src/control-flow-basics/exercise.md src/bare-metal/aps/better-uart.md -msgid "6" -msgstr "6" - -#: src/control-flow-basics/exercise.md -msgid "_ = 8 / 2 = 4;" -msgstr "_ = 8 / 2 = 4 になります。" - -#: src/control-flow-basics/exercise.md -msgid "4 is even, so _n" -msgstr "4 は偶数なので、_n" - -#: src/control-flow-basics/exercise.md -msgid "7" -msgstr "7" - -#: src/control-flow-basics/exercise.md -msgid "_ = 4 / 2 = 2;" -msgstr "_ = 4 / 2 = 2 になります。" - -#: src/control-flow-basics/exercise.md -msgid "2 is even, so _n" -msgstr "2 は偶数なので、_n" - -#: src/control-flow-basics/exercise.md src/bare-metal/aps/better-uart.md -msgid "8" -msgstr "8" - -#: src/control-flow-basics/exercise.md -msgid "_ = 1; and" -msgstr "_ = 1 になります。" - -#: src/control-flow-basics/exercise.md -msgid "the sequence terminates." -msgstr "数列は終了します。" +msgid "the sequence terminates." +msgstr "数列は終了します。" #: src/control-flow-basics/exercise.md msgid "" @@ -3880,7 +3902,7 @@ msgstr "" msgid "/// Determine the length of the collatz sequence beginning at `n`.\n" msgstr "/// `n` から始まるコラッツ数列の長さを決定。\n" -#: src/control-flow-basics/solution.md src/concurrency/scoped-threads.md +#: src/control-flow-basics/solution.md src/concurrency/threads/scoped.md msgid "\"Length: {}\"" msgstr "\"Length: {}\"" @@ -3890,93 +3912,18 @@ msgid "Welcome Back" msgstr "おかえり" #: src/welcome-day-1-afternoon.md -msgid "[Tuples and Arrays](./tuples-and-arrays.md) (1 hour)" -msgstr "[タプルと配列](./tuples-and-arrays.md)（1 時間）" - -#: src/welcome-day-1-afternoon.md -msgid "[References](./references.md) (50 minutes)" -msgstr "[参照](./references.md)（50 分）" - -#: src/welcome-day-1-afternoon.md -msgid "[User-Defined Types](./user-defined-types.md) (50 minutes)" -msgstr "[ユーザー定義型](./user-defined-types.md)（50 分）" - -#: src/welcome-day-1-afternoon.md +#, fuzzy msgid "" -"Including 10 minute breaks, this session should take about 2 hours and 55 " -"minutes" +"Including 10 minute breaks, this session should take about 2 hours and 35 " +"minutes. It contains:" msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 2 時間 55 分です。" #: src/tuples-and-arrays.md -msgid "" -"[Tuples and Arrays](./tuples-and-arrays/tuples-and-arrays.md) (10 minutes)" -msgstr "[タプルと配列](./tuples-and-arrays/tuples-and-arrays.md)（10 分）" - -#: src/tuples-and-arrays.md -msgid "[Array Iteration](./tuples-and-arrays/iteration.md) (3 minutes)" -msgstr "[配列の反復処理](./tuples-and-arrays/iteration.md)（3 分）" - -#: src/tuples-and-arrays.md -msgid "[Pattern Matching](./tuples-and-arrays/match.md) (10 minutes)" -msgstr "[パターン マッチング](./tuples-and-arrays/match.md)（10 分）" - -#: src/tuples-and-arrays.md -msgid "[Destructuring](./tuples-and-arrays/destructuring.md) (5 minutes)" -msgstr "[分解](./tuples-and-arrays/destructuring.md)（5 分）" - -#: src/tuples-and-arrays.md -msgid "[Exercise: Nested Arrays](./tuples-and-arrays/exercise.md) (30 minutes)" -msgstr "[演習: ネストされた配列](./tuples-and-arrays/exercise.md)（30 分）" - -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "" -"Tuples and arrays are the first \"compound\" types we have seen. All " -"elements of an array have the same type, while tuples can accommodate " -"different types. Both types have a size fixed at compile time." -msgstr "" -"タプルと配列は、このコースで初めて扱う「複合」型です。配列のすべての要素の型" -"は同じですが、タプルは異なる型に対応できます。どちらの型もコンパイル時にサイ" -"ズが固定されます。" - -#: src/tuples-and-arrays/tuples-and-arrays.md -#: src/tuples-and-arrays/destructuring.md -msgid "Arrays" -msgstr "配列" - -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "`[T; N]`" -msgstr "`[T; N]`" - -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "`[20, 30, 40]`, `[0; 3]`" -msgstr "`[20, 30, 40]`、`[0; 3]`" - -#: src/tuples-and-arrays/tuples-and-arrays.md -#: src/tuples-and-arrays/destructuring.md -msgid "Tuples" -msgstr "タプル" - -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "`()`, `(T,)`, `(T1, T2)`, ..." -msgstr "`()`、`(T,)`、`(T1, T2)`、..." - -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "`()`, `('x',)`, `('x', 1.2)`, ..." -msgstr "`()`、`('x',)`、`('x', 1.2)`、..." - -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "Array assignment and access:" -msgstr "配列の代入とアクセス:" - -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "Tuple assignment and access:" -msgstr "タプルの代入とアクセス:" - -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "Arrays:" -msgstr "配列:" +#, fuzzy +msgid "This segment should take about 35 minutes. It contains:" +msgstr "このセグメントの所要時間は約 55 分です" -#: src/tuples-and-arrays/tuples-and-arrays.md +#: src/tuples-and-arrays/arrays.md msgid "" "A value of the array type `[T; N]` holds `N` (a compile-time constant) " "elements of the same type `T`. Note that the length of the array is _part of " @@ -3989,7 +3936,7 @@ msgstr "" "は 2 つの異なる型とみなされます。スライス（サイズが実行時に決定される）につい" "ては後で説明します。" -#: src/tuples-and-arrays/tuples-and-arrays.md +#: src/tuples-and-arrays/arrays.md msgid "" "Try accessing an out-of-bounds array element. Array accesses are checked at " "runtime. Rust can usually optimize these checks away, and they can be " @@ -3999,11 +3946,11 @@ msgstr "" "れます。Rust では通常、これらのチェックを最適化により除去できます（Unsafe " "Rust を使用することで回避できます）。" -#: src/tuples-and-arrays/tuples-and-arrays.md +#: src/tuples-and-arrays/arrays.md msgid "We can use literals to assign values to arrays." msgstr "リテラルを使用して配列に値を代入することができます。" -#: src/tuples-and-arrays/tuples-and-arrays.md +#: src/tuples-and-arrays/arrays.md msgid "" "The `println!` macro asks for the debug implementation with the `?` format " "parameter: `{}` gives the default output, `{:?}` gives the debug output. " @@ -4016,7 +3963,7 @@ msgstr "" "文字列などの型はデフォルトの出力を実装しますが、配列はデバッグ出力のみを実装" "します。そのため、ここではデバッグ出力を使用する必要があります。" -#: src/tuples-and-arrays/tuples-and-arrays.md +#: src/tuples-and-arrays/arrays.md msgid "" "Adding `#`, eg `{a:#?}`, invokes a \"pretty printing\" format, which can be " "easier to read." @@ -4024,19 +3971,15 @@ msgstr "" "`#` を追加すると（例: `{a:#?}`）、読みやすい「プリティ プリント」形式が呼び出" "されます。" -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "Tuples:" -msgstr "タプル:" - -#: src/tuples-and-arrays/tuples-and-arrays.md +#: src/tuples-and-arrays/tuples.md msgid "Like arrays, tuples have a fixed length." msgstr "配列と同様に、タプルの長さは固定されています。" -#: src/tuples-and-arrays/tuples-and-arrays.md +#: src/tuples-and-arrays/tuples.md msgid "Tuples group together values of different types into a compound type." msgstr "タプルは、異なる型の値を複合型にグループ化します。" -#: src/tuples-and-arrays/tuples-and-arrays.md +#: src/tuples-and-arrays/tuples.md msgid "" "Fields of a tuple can be accessed by the period and the index of the value, " "e.g. `t.0`, `t.1`." @@ -4044,24 +3987,11 @@ msgstr "" "タプルのフィールドには、ピリオドと値のインデックス（例: `t.0`、`t.1`）でアク" "セスできます。" -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "" -"The empty tuple `()` is also known as the \"unit type\". It is both a type, " -"and the only valid value of that type --- that is to say both the type and " -"its value are expressed as `()`. It is used to indicate, for example, that a " -"function or expression has no return value, as we'll see in a future slide." -msgstr "" -"空のタプル `()` は、「ユニット型」とも呼ばれます。これは型であるとともに、そ" -"の型で唯一の有効な値です。つまり、型とその値の両方が `()` として表現されま" -"す。以降のスライドで説明するように、これは関数や式に戻り値がないことを示す場" -"合などに使用されます。" - -#: src/tuples-and-arrays/tuples-and-arrays.md +#: src/tuples-and-arrays/tuples.md msgid "" -"You can think of it as `void` that can be familiar to you from other " -"programming languages." +"The empty tuple `()` is referred to as the \"unit type\" and signifies " +"absence of a return value, akin to `void` in other languages." msgstr "" -"これは、他のプログラミング言語で馴染みのある `void` と考えることができます。" #: src/tuples-and-arrays/iteration.md msgid "The `for` statement supports iterating over arrays (but not tuples)." @@ -4078,9 +4008,10 @@ msgstr "" "ん。" #: src/tuples-and-arrays/iteration.md +#, fuzzy msgid "" "The `assert_ne!` macro is new here. There are also `assert_eq!` and `assert!" -"` macros. These are always checked while, debug-only variants like " +"` macros. These are always checked, while debug-only variants like " "`debug_assert!` compile to nothing in release builds." msgstr "" "ここでは `assert_ne!` マクロが新たに加わっていますが、他にも `assert_eq! マク" @@ -4088,226 +4019,48 @@ msgstr "" "`debug_assert!` などのデバッグ専用の派生ツールは、リリースビルドでは何もコン" "パイルされません。" -#: src/tuples-and-arrays/match.md -msgid "" -"The `match` keyword lets you match a value against one or more _patterns_. " -"The comparisons are done from top to bottom and the first match wins." -msgstr "" -"`match` キーワードを使用すると、1 つ以上のパターンに対して値を照合できます。" -"上から順に照合が行われ、最初に一致したパターンのみが実行されます。" - -#: src/tuples-and-arrays/match.md -msgid "The patterns can be simple values, similarly to `switch` in C and C++:" -msgstr "C や C++ の `switch` と同様に、パターンには単純な値を指定できます。" - -#: src/tuples-and-arrays/match.md -msgid "'x'" -msgstr "'x'" - -#: src/tuples-and-arrays/match.md -msgid "'q'" -msgstr "'q'" - -#: src/tuples-and-arrays/match.md -msgid "\"Quitting\"" -msgstr "\"Quitting\"" - -#: src/tuples-and-arrays/match.md src/std-traits/solution.md -#: src/error-handling/exercise.md src/error-handling/solution.md -msgid "'a'" -msgstr "'a'" - -#: src/tuples-and-arrays/match.md -msgid "'s'" -msgstr "'s'" - -#: src/tuples-and-arrays/match.md -msgid "'w'" -msgstr "'w'" - -#: src/tuples-and-arrays/match.md -msgid "'d'" -msgstr "'d'" - -#: src/tuples-and-arrays/match.md -msgid "\"Moving around\"" -msgstr "\"Moving around\"" - -#: src/tuples-and-arrays/match.md src/error-handling/exercise.md -#: src/error-handling/solution.md -msgid "'0'" -msgstr "'0'" - -#: src/tuples-and-arrays/match.md src/error-handling/exercise.md -#: src/error-handling/solution.md -msgid "'9'" -msgstr "'9'" - -#: src/tuples-and-arrays/match.md -msgid "\"Number input\"" -msgstr "\"Number input\"" - -#: src/tuples-and-arrays/match.md -msgid "\"Lowercase: {key}\"" -msgstr "\"Lowercase: {key}\"" - -#: src/tuples-and-arrays/match.md -msgid "\"Something else\"" -msgstr "\"Something else\"" - -#: src/tuples-and-arrays/match.md -msgid "" -"The `_` pattern is a wildcard pattern which matches any value. The " -"expressions _must_ be irrefutable, meaning that it covers every possibility, " -"so `_` is often used as the final catch-all case." -msgstr "" -"`_` パターンは、任意の値に一致するワイルドカード パターンです。式は論駁不可能" -"でなければなりません。つまり、あらゆる可能性をカバーする必要があるため、最後" -"のキャッチオール ケースとして `_` がよく使用されます。" - -#: src/tuples-and-arrays/match.md +#: src/tuples-and-arrays/destructuring.md msgid "" -"Match can be used as an expression. Just like `if`, each match arm must have " -"the same type. The type is the last expression of the block, if any. In the " -"example above, the type is `()`." +"When working with tuples and other structured values it's common to want to " +"extract the inner values into local variables. This can be done manually by " +"directly accessing the inner values:" msgstr "" -"一致を式として使用できます。`if` と同様に、各マッチアームは同じ型にする必要が" -"あります。型は、ブロックの最後の式です（存在する場合）。上記の例では、型は " -"`()` です。" -#: src/tuples-and-arrays/match.md -msgid "" -"A variable in the pattern (`key` in this example) will create a binding that " -"can be used within the match arm." +#: src/tuples-and-arrays/destructuring.md +msgid "\"left: {left}, right: {right}\"" msgstr "" -"パターンの変数（この例では `key`）により、マッチアーム内で使用できるバイン" -"ディングが作成されます。" -#: src/tuples-and-arrays/match.md -msgid "A match guard causes the arm to match only if the condition is true." -msgstr "マッチガードにより、条件が true の場合にのみアームが一致します。" - -#: src/tuples-and-arrays/match.md src/user-defined-types/named-structs.md -#: src/user-defined-types/enums.md src/methods-and-traits/methods.md -msgid "Key Points:" -msgstr "キーポイント: " - -#: src/tuples-and-arrays/match.md -msgid "" -"You might point out how some specific characters are being used when in a " -"pattern" -msgstr "特定の文字がパターンでどのように使用されるかを説明します。" - -#: src/tuples-and-arrays/match.md -msgid "`|` as an `or`" -msgstr "`|` を `or` として指定する" - -#: src/tuples-and-arrays/match.md -msgid "`..` can expand as much as it needs to be" -msgstr "`..` は必要に応じて展開できる" - -#: src/tuples-and-arrays/match.md -msgid "`1..=5` represents an inclusive range" -msgstr "`1..=5` は 5 を含む範囲を表す" - -#: src/tuples-and-arrays/match.md -msgid "`_` is a wild card" -msgstr "`_` はワイルドカードを表す" - -#: src/tuples-and-arrays/match.md +#: src/tuples-and-arrays/destructuring.md msgid "" -"Match guards as a separate syntax feature are important and necessary when " -"we wish to concisely express more complex ideas than patterns alone would " -"allow." +"However, Rust also supports using pattern matching to destructure a larger " +"value into its constituent parts:" msgstr "" -"パターンのみでは表現できない複雑な概念を簡潔に表現したい場合、独立した構文機" -"能であるマッチガードは重要かつ必要です。" -#: src/tuples-and-arrays/match.md +#: src/tuples-and-arrays/destructuring.md msgid "" -"They are not the same as separate `if` expression inside of the match arm. " -"An `if` expression inside of the branch block (after `=>`) happens after the " -"match arm is selected. Failing the `if` condition inside of that block won't " -"result in other arms of the original `match` expression being considered." +"The patterns used here are \"irrefutable\", meaning that the compiler can " +"statically verify that the value on the right of `=` has the same structure " +"as the pattern." msgstr "" -"マッチガードは、マッチアーム内の個別の `if` 式とは異なります。分岐ブロック内" -"（`=>` の後）の `if` 式は、マッチアームが選択された後に実行されます。そのブ" -"ロック内で `if` 条件が満たされなかった場合、元の `match` 式の他のアームは考慮" -"されません。" -#: src/tuples-and-arrays/match.md +#: src/tuples-and-arrays/destructuring.md msgid "" -"The condition defined in the guard applies to every expression in a pattern " -"with an `|`." +"A variable name is an irrefutable pattern that always matches any value, " +"hence why we can also use `let` to declare a single variable." msgstr "" -"ガードで定義された条件は、`|` が付いたパターン内のすべての式に適用されます。" #: src/tuples-and-arrays/destructuring.md msgid "" -"Destructuring is a way of extracting data from a data structure by writing a " -"pattern that is matched up to the data structure, binding variables to " -"subcomponents of the data structure." +"Rust also supports using patterns in conditionals, allowing for equality " +"comparison and destructuring to happen at the same time. This form of " +"pattern matching will be discussed in more detail later." msgstr "" -"分解とは、データ構造に一致するパターンを記述し、変数をデータ構造のサブコン" -"ポーネントにバインドすることで、データ構造からデータを抽出する方法です。" - -#: src/tuples-and-arrays/destructuring.md -msgid "You can destructure tuples and arrays by matching on their elements:" -msgstr "タプルと配列は、要素を照合することで分解できます。" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"on Y axis\"" -msgstr "\"on Y axis\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"on X axis\"" -msgstr "\"on X axis\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"left of Y axis\"" -msgstr "\"left of Y axis\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"below X axis\"" -msgstr "\"below X axis\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"first quadrant\"" -msgstr "\"first quadrant\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"Tell me about {triple:?}\"" -msgstr "\"Tell me about {triple:?}\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"First is 0, y = {y}, and z = {z}\"" -msgstr "\"First is 0, y = {y}, and z = {z}\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"First is 1 and the rest were ignored\"" -msgstr "\"First is 1 and the rest were ignored\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"All elements were ignored\"" -msgstr "\"All elements were ignored\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "Create a new array pattern using `_` to represent an element." -msgstr "`_` を使用して要素を表す新しい配列パターンを作成します。" - -#: src/tuples-and-arrays/destructuring.md -msgid "Add more values to the array." -msgstr "配列に値を追加します。" #: src/tuples-and-arrays/destructuring.md msgid "" -"Point out that how `..` will expand to account for different number of " -"elements." -msgstr "要素数が異なる場合に `..` がどのように展開されるかを説明します。" - -#: src/tuples-and-arrays/destructuring.md -msgid "Show matching against the tail with patterns `[.., b]` and `[a@..,b]`" -msgstr "パターン `[.., b]` と `[a@..,b]` で末尾を照合します。" +"Edit the examples above to show the compiler error when the pattern doesn't " +"match the value being matched on." +msgstr "" #: src/tuples-and-arrays/exercise.md msgid "Arrays can contain other arrays:" @@ -4327,13 +4080,10 @@ msgstr "" "記述します。" #: src/tuples-and-arrays/exercise.md -msgid "Hard-code both functions to operate on 3 × 3 matrices." -msgstr "3 × 3 の行列で動作するように、両方の関数をハードコードします。" - -#: src/tuples-and-arrays/exercise.md +#, fuzzy msgid "" "Copy the code below to and implement the " -"functions:" +"function. This function only operates on 3x3 matrices." msgstr "" "以下のコードを にコピーして、関数を実装します。" @@ -4342,6 +4092,10 @@ msgstr "" msgid "// TODO: remove this when you're done with your implementation.\n" msgstr "// TODO: 実装が完了したら、これを削除します。\n" +#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md +msgid "//\n" +msgstr "//\n" + #: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md msgid "// <-- the comment makes rustfmt add a newline\n" msgstr "// <-- このコメントにより rustfmt で改行を追加\n" @@ -4354,31 +4108,23 @@ msgstr "\"matrix: {:#?}\"" msgid "\"transposed: {:#?}\"" msgstr "\"transposed: {:#?}\"" -#: src/tuples-and-arrays/solution.md -msgid "//\n" -msgstr "//\n" - -#: src/references.md -msgid "[Shared References](./references/shared.md) (10 minutes)" -msgstr "[共有参照](./references/shared.md)（10 分）" - -#: src/references.md -msgid "[Exclusive References](./references/exclusive.md) (10 minutes)" -msgstr "[排他参照](./references/except.md)（10 分）" +#: src/references.md src/smart-pointers.md src/borrowing.md +#: src/concurrency/async-pitfalls.md +#, fuzzy +msgid "This segment should take about 55 minutes. It contains:" +msgstr "このセグメントの所要時間は約 55 分です" #: src/references.md -msgid "[Exercise: Geometry](./references/exercise.md) (30 minutes)" -msgstr "[演習: ジオメトリ](./references/exercise.md)（30 分）" - -#: src/references.md src/user-defined-types.md src/pattern-matching.md -msgid "This segment should take about 50 minutes" -msgstr "このセグメントの所要時間は約 50 分です" +#, fuzzy +msgid "Slices: &\\[T\\]" +msgstr "スライス型" #: src/references/shared.md +#, fuzzy msgid "" -"A reference provides a way to access another value without taking " -"responsibility for the value, and is also called \"borrowing\". Shared " -"references are read-only, and the referenced data cannot change." +"A reference provides a way to access another value without taking ownership " +"of the value, and is also called \"borrowing\". Shared references are read-" +"only, and the referenced data cannot change." msgstr "" "参照を使用すると、値について責任を負うことなく別の値にアクセスできます。参照" "は「借用」とも呼ばれます。共有参照は読み取り専用であり、参照先のデータは変更" @@ -4429,10 +4175,11 @@ msgid "" msgstr "Rust は参照を自動的に作成しないため、常に `&` を付ける必要があります。" #: src/references/shared.md +#, fuzzy msgid "" "Rust will auto-dereference in some cases, in particular when invoking " -"methods (try `r.count_ones()`). There is no need for an `->` operator like " -"in C++." +"methods (try `r.is_ascii()`). There is no need for an `->` operator like in " +"C++." msgstr "" "Rust は、特にメソッドを呼び出すとき、自動的に逆参照する場合があります（`r." "count_ones()` を試してください）。C++ のような `->` 演算子は必要ありません。" @@ -4503,11 +4250,199 @@ msgstr "" "前者は異なる値にバインドできる共有参照を表すのに対し、後者は可変の値への排他" "参照を表します。" -#: src/references/exercise.md -msgid "" -"We will create a few utility functions for 3-dimensional geometry, " -"representing a point as `[f64;3]`. It is up to you to determine the function " -"signatures." +#: src/references/slices.md +msgid "Slices" +msgstr "Slices" + +#: src/references/slices.md +msgid "A slice gives you a view into a larger collection:" +msgstr "スライスは、より大きなコレクションに対するビューを提供します。" + +#: src/references/slices.md +msgid "Slices borrow data from the sliced type." +msgstr "スライスは、スライスされた型からデータを借用します。" + +#: src/references/slices.md +msgid "Question: What happens if you modify `a[3]` right before printing `s`?" +msgstr "質問: `s` を出力する直前に `a[3]` を変更するとどうなるでしょうか？" + +#: src/references/slices.md +msgid "" +"We create a slice by borrowing `a` and specifying the starting and ending " +"indexes in brackets." +msgstr "" +"スライスを作成するには、`a` を借用し、開始インデックスと終了インデックスを角" +"かっこで囲んで指定します。" + +#: src/references/slices.md +msgid "" +"If the slice starts at index 0, Rust’s range syntax allows us to drop the " +"starting index, meaning that `&a[0..a.len()]` and `&a[..a.len()]` are " +"identical." +msgstr "" +"スライスがインデックス 0 から始まる場合、Rust の範囲構文により開始インデック" +"スを省略できます。つまり、`&a[0..a.len()]` と `&a[..a.len()]` は同じです。" + +#: src/references/slices.md +msgid "" +"The same is true for the last index, so `&a[2..a.len()]` and `&a[2..]` are " +"identical." +msgstr "" +"最後のインデックスについても同じことが言えるので、`&a[2..a.len()]` と " +"`&a[2..]` は同じです。" + +#: src/references/slices.md +msgid "" +"To easily create a slice of the full array, we can therefore use `&a[..]`." +msgstr "" +"配列全体のスライスを簡単に作成するには、`&a[..]` と書くことが出来ます。" + +#: src/references/slices.md +msgid "" +"`s` is a reference to a slice of `i32`s. Notice that the type of `s` " +"(`&[i32]`) no longer mentions the array length. This allows us to perform " +"computation on slices of different sizes." +msgstr "" +"`s` は i32 のスライスへの参照です。`s` の型（`&[i32]`）に配列の長さが含まれな" +"くなったことに注目してください。これにより、さまざまなサイズのスライスに対し" +"て計算を実行できます。" + +#: src/references/slices.md +msgid "" +"Slices always borrow from another object. In this example, `a` has to remain " +"'alive' (in scope) for at least as long as our slice." +msgstr "" +"スライスは常に別のオブジェクトから借用します。この例では、`a` は少なくともス" +"ライスが存在する間は「存続」 している（スコープ内にある)必要があります。" + +#: src/references/slices.md +msgid "" +"The question about modifying `a[3]` can spark an interesting discussion, but " +"the answer is that for memory safety reasons you cannot do it through `a` at " +"this point in the execution, but you can read the data from both `a` and `s` " +"safely. It works before you created the slice, and again after the " +"`println`, when the slice is no longer used." +msgstr "" +"`a[3]` の変更に関する質問は興味深い議論のきっかけになるかもしれませんが、メモ" +"リ安全性上の理由から、この時点では `a` を使用して変更することはできない、とい" +"う回答になります。ただし、`a` と `s` の両方のデータを安全に読み取ることはでき" +"ます。これは、スライスを作成する前と、`println` の後でスライスが使用されなく" +"なったあとであれば、変更することが出来ます。" + +#: src/references/strings.md +msgid "We can now understand the two string types in Rust:" +msgstr "" + +#: src/references/strings.md +msgid "`&str` is a slice of UTF-8 encoded bytes, similar to `&[u8]`." +msgstr "" + +#: src/references/strings.md +msgid "" +"`String` is an owned buffer of UTF-8 encoded bytes, similar to `Vec`." +msgstr "" + +#: src/references/strings.md src/std-traits/read-and-write.md +msgid "\"World\"" +msgstr "\"World\"" + +#: src/references/strings.md +msgid "\"s1: {s1}\"" +msgstr "\"s1: {s1}\"" + +#: src/references/strings.md +msgid "\"Hello \"" +msgstr "\"Hello \"" + +#: src/references/strings.md src/memory-management/move.md +msgid "\"s2: {s2}\"" +msgstr "\"s2: {s2}\"" + +#: src/references/strings.md +msgid "\"s3: {s3}\"" +msgstr "\"s3: {s3}\"" + +#: src/references/strings.md +#, fuzzy +msgid "" +"`&str` introduces a string slice, which is an immutable reference to UTF-8 " +"encoded string data stored in a block of memory. String literals " +"(`\"Hello\"`), are stored in the program’s binary." +msgstr "" +"`&str` は文字列スライスを導入します。これは、メモリブロックに保存されている " +"UTF-8 でエンコードされた文字列データへの不変の参照です。文字列リテラル" +"（`”Hello”`）は、プログラムのバイナリに格納されます。" + +#: src/references/strings.md +#, fuzzy +msgid "" +"Rust's `String` type is a wrapper around a vector of bytes. As with a " +"`Vec`, it is owned." +msgstr "" +"Rust の `String` 型は、バイトのベクターのラッパーです。`Vec` と同様、所有" +"されます。" + +#: src/references/strings.md +msgid "" +"As with many other types `String::from()` creates a string from a string " +"literal; `String::new()` creates a new empty string, to which string data " +"can be added using the `push()` and `push_str()` methods." +msgstr "" +"他の多くの型と同様に、`String::from()` は文字列リテラルから文字列を作成しま" +"す。`String::new()` は新しい空の文字列を作成します。`push()` メソッドと " +"`push_str()` メソッドを使用して、そこに文字列データを追加できます。" + +#: src/references/strings.md +msgid "" +"The `format!()` macro is a convenient way to generate an owned string from " +"dynamic values. It accepts the same format specification as `println!()`." +msgstr "" +"`format!()` マクロを使用すると、動的な値から所有文字列を簡単に生成できます。" +"これは println!() と同じ形式指定を受け入れます。" + +#: src/references/strings.md +msgid "" +"You can borrow `&str` slices from `String` via `&` and optionally range " +"selection. If you select a byte range that is not aligned to character " +"boundaries, the expression will panic. The `chars` iterator iterates over " +"characters and is preferred over trying to get character boundaries right." +msgstr "" +"`&` を使用して `String` から `&str` スライスを借用し、必要に応じて範囲を選択" +"できます。文字境界に揃えられていないバイト範囲を選択すると、その式でパニック" +"を起こします。`chars` イテレータは文字単位で処理するため、正しい文字境界を取" +"得しようとすることよりも、このイテレータを使用するほうが望ましいです。" + +#: src/references/strings.md +msgid "" +"For C++ programmers: think of `&str` as `std::string_view` from C++, but the " +"one that always points to a valid string in memory. Rust `String` is a rough " +"equivalent of `std::string` from C++ (main difference: it can only contain " +"UTF-8 encoded bytes and will never use a small-string optimization)." +msgstr "" +"C++ プログラマー向けの説明：`&str` は常にメモリ上の有効な文字列を指しているよ" +"うなC++ の std::string_view と考えられます。Rust の `String` は、C++ の " +"`std::string` とおおむね同等です（主な違いは、UTF-8 でエンコードされたバイト" +"のみを含めることができ、短い文字列に対する最適化が行われないことです）。" + +#: src/references/strings.md +msgid "Byte strings literals allow you to create a `&[u8]` value directly:" +msgstr "バイト文字列リテラルを使用すると、`&[u8]` 値を直接作成できます。" + +#: src/references/strings.md +msgid "" +"Raw strings allow you to create a `&str` value with escapes disabled: " +"`r\"\\n\" == \"\\\\n\"`. You can embed double-quotes by using an equal " +"amount of `#` on either side of the quotes:" +msgstr "" +"未加工の文字列を使用すると、エスケープを無効にして `&str` 値を作成できます" +"（`r\"\\n\" == \"\\\\n\"`）。二重引用符を埋め込むには、引用符の両側に同量の " +"`#` を使用します。" + +#: src/references/exercise.md +msgid "" +"We will create a few utility functions for 3-dimensional geometry, " +"representing a point as `[f64;3]`. It is up to you to determine the function " +"signatures." msgstr "" "ここでは、点を `[f64;3]` として表現する 3 次元ジオメトリのユーティリティ関数" "をいくつか作成します。関数シグネチャは任意で指定してください。" @@ -4559,32 +4494,10 @@ msgid "" "direction.\n" msgstr "/// 向きを変えずにベクターの大きさを 1.0 に変更します。\n" -#: src/user-defined-types.md -msgid "[Named Structs](./user-defined-types/named-structs.md) (10 minutes)" -msgstr "[名前付き構造体](./user-defined-types/named-structs.md)（10 分）" - -#: src/user-defined-types.md -msgid "[Tuple Structs](./user-defined-types/tuple-structs.md) (10 minutes)" -msgstr "[タプル構造体](./user-defined-types/tuple-structs.md)（10 分）" - -#: src/user-defined-types.md -msgid "[Enums](./user-defined-types/enums.md) (5 minutes)" -msgstr "[列挙型](./user-defined-types/enums.md)（5 分）" - -#: src/user-defined-types.md -msgid "" -"[Static and Const](./user-defined-types/static-and-const.md) (5 minutes)" -msgstr "[static と const](./user-defined-types/static-and-const.md)（5 分）" - -#: src/user-defined-types.md -msgid "[Type Aliases](./user-defined-types/aliases.md) (2 minutes)" -msgstr "[型エイリアス](./user-defined-types/aliases.md)（2 分）" - -#: src/user-defined-types.md -msgid "" -"[Exercise: Elevator Events](./user-defined-types/exercise.md) (15 minutes)" -msgstr "" -"[演習: エレベーター イベント](./user-defined-types/exercise.md)（15 分）" +#: src/user-defined-types.md src/methods-and-traits.md src/lifetimes.md +#, fuzzy +msgid "This segment should take about 50 minutes. It contains:" +msgstr "このセグメントの所要時間は約 50 分です" #: src/user-defined-types/named-structs.md msgid "Like C and C++, Rust has support for custom structs:" @@ -4607,6 +4520,11 @@ msgstr "\"Avery\"" msgid "\"Jackie\"" msgstr "\"Jackie\"" +#: src/user-defined-types/named-structs.md src/user-defined-types/enums.md +#: src/pattern-matching/match.md src/methods-and-traits/methods.md +msgid "Key Points:" +msgstr "キーポイント: " + #: src/user-defined-types/named-structs.md msgid "Structs work like in C or C++." msgstr "構造体は、C や C++ においてと同じように機能します。" @@ -4681,7 +4599,7 @@ msgstr "\"Ask a rocket scientist at NASA\"" #: src/user-defined-types/tuple-structs.md #: src/android/interoperability/cpp/cpp-bridge.md #: src/bare-metal/microcontrollers/type-state.md -#: src/async/pitfalls/cancellation.md +#: src/concurrency/async-pitfalls/cancellation.md msgid "// ...\n" msgstr "// ...\n" @@ -4836,9 +4754,10 @@ msgstr "" "`repr` がない場合、10001 は 2 バイトに収まるため、判別式の型には 2 バイトが使" "用されます。" -#: src/user-defined-types/enums.md src/user-defined-types/static-and-const.md +#: src/user-defined-types/enums.md src/user-defined-types/static.md #: src/memory-management/review.md src/memory-management/move.md -#: src/smart-pointers/box.md src/borrowing/shared.md +#: src/memory-management/copy-types.md src/smart-pointers/box.md +#: src/borrowing/shared.md src/error-handling/result.md msgid "More to Explore" msgstr "その他" @@ -4870,28 +4789,20 @@ msgstr "" "す。コンパイラはこの表現に関して保証しないので、これはまったく安全ではないこ" "とに注意してください。" -#: src/user-defined-types/static-and-const.md -msgid "" -"Static and constant variables are two different ways to create globally-" -"scoped values that cannot be moved or reallocated during the execution of " -"the program." -msgstr "" -"静的変数と定数変数は、プログラムの実行中に移動または再割り当てできないグロー" -"バル スコープの値を作成するための、2 つの異なる方法です。" - -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/const.md msgid "`const`" msgstr "`const`" -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/const.md +#, fuzzy msgid "" -"Constant variables are evaluated at compile time and their values are " -"inlined wherever they are used:" +"Constants are evaluated at compile time and their values are inlined " +"wherever they are used:" msgstr "" "定数変数はコンパイル時に評価され、使用場所にかかわらずその値がインライン化さ" "れます。" -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/const.md msgid "" "According to the [Rust RFC Book](https://rust-lang.github.io/rfcs/0246-const-" "vs-static.html) these are inlined upon use." @@ -4899,7 +4810,7 @@ msgstr "" "[Rust RFC Book](https://rust-lang.github.io/rfcs/0246-const-vs-static.html) " "によると、定数変数は使用時にインライン化されます。" -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/const.md msgid "" "Only functions marked `const` can be called at compile time to generate " "`const` values. `const` functions can however be called at runtime." @@ -4907,25 +4818,38 @@ msgstr "" "コンパイル時に `const` 値を生成するために呼び出せるのは、`const` とマークされ" "た関数のみです。ただし、`const` 関数は実行時に呼び出すことができます。" -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/const.md +#, fuzzy +msgid "Mention that `const` behaves semantically similar to C++'s `constexpr`" +msgstr "`const` は C++ の `constexpr` と意味的によく似ていることを説明します。" + +#: src/user-defined-types/const.md +msgid "" +"It isn't super common that one would need a runtime evaluated constant, but " +"it is helpful and safer than using a static." +msgstr "" +"実行時に評価される定数が必要になることはあまりありませんが、静的変数を使用す" +"るよりも便利で安全です。" + +#: src/user-defined-types/static.md msgid "`static`" msgstr "`static`" -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/static.md msgid "" "Static variables will live during the whole execution of the program, and " "therefore will not move:" msgstr "静的変数はプログラムの実行全体を通じて存続するため、移動しません。" -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/static.md msgid "\"Welcome to RustOS 3.14\"" msgstr "\"Welcome to RustOS 3.14\"" -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/static.md msgid "\"{BANNER}\"" msgstr "\"{BANNER}\"" -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/static.md msgid "" "As noted in the [Rust RFC Book](https://rust-lang.github.io/rfcs/0246-const-" "vs-static.html), these are not inlined upon use and have an actual " @@ -4940,19 +4864,14 @@ msgstr "" "変数はプログラムの実行全体を通じて存続します。グローバル スコープの値にオブ" "ジェクト ID が必要ない場合は、一般的に `const` が使用されます。" -#: src/user-defined-types/static-and-const.md -msgid "Mention that `const` behaves semantically similar to C++'s `constexpr`." -msgstr "`const` は C++ の `constexpr` と意味的によく似ていることを説明します。" - -#: src/user-defined-types/static-and-const.md -msgid "" -"`static`, on the other hand, is much more similar to a `const` or mutable " -"global variable in C++." +#: src/user-defined-types/static.md +#, fuzzy +msgid "`static` is similar to mutable global variables in C++." msgstr "" "一方、`static` は、C++ の `const` または可変グローバル変数にかなり似ていま" "す。" -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/static.md msgid "" "`static` provides object identity: an address in memory and state as " "required by types with interior mutability such as `Mutex`." @@ -4960,75 +4879,7 @@ msgstr "" "`static` はオブジェクト ID（メモリ内のアドレス）と、内部可変性を持つ型に必要" "な状態（`Mutex` など）を提供します。" -#: src/user-defined-types/static-and-const.md -msgid "" -"It isn't super common that one would need a runtime evaluated constant, but " -"it is helpful and safer than using a static." -msgstr "" -"実行時に評価される定数が必要になることはあまりありませんが、静的変数を使用す" -"るよりも便利で安全です。" - -#: src/user-defined-types/static-and-const.md -msgid "Properties table:" -msgstr "プロパティの表:" - -#: src/user-defined-types/static-and-const.md -#: src/chromium/adding-third-party-crates.md -msgid "Property" -msgstr "プロパティ" - -#: src/user-defined-types/static-and-const.md -msgid "Static" -msgstr "静的" - -#: src/user-defined-types/static-and-const.md -msgid "Constant" -msgstr "定数" - -#: src/user-defined-types/static-and-const.md -msgid "Has an address in memory" -msgstr "メモリ内にアドレスがある" - -#: src/user-defined-types/static-and-const.md -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Yes" -msgstr "はい" - -#: src/user-defined-types/static-and-const.md -msgid "No (inlined)" -msgstr "いいえ（インライン化）" - -#: src/user-defined-types/static-and-const.md -#, fuzzy -msgid "Lives for the entire duration of the program" -msgstr "`main`関数はプログラムのエントリーポイントになります。" - -#: src/user-defined-types/static-and-const.md -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "No" -msgstr "いいえ" - -#: src/user-defined-types/static-and-const.md -msgid "Can be mutable" -msgstr "変更可能" - -#: src/user-defined-types/static-and-const.md -msgid "Yes (unsafe)" -msgstr "はい（安全でない）" - -#: src/user-defined-types/static-and-const.md -msgid "Evaluated at compile time" -msgstr "コンパイル時に評価" - -#: src/user-defined-types/static-and-const.md -msgid "Yes (initialised at compile time)" -msgstr "はい（コンパイル時に初期化）" - -#: src/user-defined-types/static-and-const.md -msgid "Inlined wherever it is used" -msgstr "使用場所にかかわらずインライン化" - -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/static.md msgid "" "Because `static` variables are accessible from any thread, they must be " "`Sync`. Interior mutability is possible through a [`Mutex`](https://doc.rust-" @@ -5038,7 +4889,7 @@ msgstr "" "ります。内部の可変性は、[`Mutex`](https://doc.rust-lang.org/std/sync/struct." "Mutex.html) やアトミックなどの方法で実現できます。" -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/static.md msgid "Thread-local data can be created with the macro `std::thread_local`." msgstr "" "マクロ `std::thread_local` を使用して、スレッド ローカルのデータを作成できま" @@ -5206,66 +5057,218 @@ msgid "" "Standard library types and traits: a tour of Rust's rich standard library." msgstr "標準ライブラリの型とトレイト: Rust の豊富な標準ライブラリの紹介。" -#: src/welcome-day-2.md -msgid "[Welcome](./welcome-day-2.md) (3 minutes)" -msgstr "[ようこそ](./welcome-day-2.md)（3 分）" - -#: src/welcome-day-2.md -msgid "[Pattern Matching](./pattern-matching.md) (50 minutes)" -msgstr "[パターン マッチング](./pattern-matching.md)（50 分）" - #: src/welcome-day-2.md #, fuzzy -msgid "[Methods and Traits](./methods-and-traits.md) (55 minutes)" -msgstr "[メソッドとトレイト](./methods-and-train.md)（45 分）" - -#: src/welcome-day-2.md -msgid "[Generics](./generics.md) (45 minutes)" -msgstr "[ジェネリクス](./generics.md)（45 分）" - -#: src/welcome-day-2.md src/welcome-day-4.md msgid "" -"Including 10 minute breaks, this session should take about 3 hours and 5 " -"minutes" -msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 3 時間 5 分です。" - -#: src/pattern-matching.md -msgid "[Destructuring](./pattern-matching/destructuring.md) (10 minutes)" -msgstr "[デストラクト](./pattern-matching/destructuring.md)（10 分）" +"Including 10 minute breaks, this session should take about 2 hours and 10 " +"minutes. It contains:" +msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 2 時間 15 分です。" -#: src/pattern-matching.md -msgid "[Let Control Flow](./pattern-matching/let-control-flow.md) (10 minutes)" -msgstr "" -"[let による制御フロー](./pattern-matching/let-control-flow.md)（10 分）" +#: src/pattern-matching.md src/std-types.md src/memory-management.md +#: src/error-handling.md +#, fuzzy +msgid "This segment should take about 1 hour. It contains:" +msgstr "このセグメントの所要時間は約 1 時間です" -#: src/pattern-matching.md +#: src/pattern-matching/match.md msgid "" -"[Exercise: Expression Evaluation](./pattern-matching/exercise.md) (30 " -"minutes)" -msgstr "[演習: 式の評価](./pattern-matching/exercise.md)（30 分）" - -#: src/pattern-matching/destructuring.md -msgid "Like tuples, structs and enums can also be destructured by matching:" +"The `match` keyword lets you match a value against one or more _patterns_. " +"The comparisons are done from top to bottom and the first match wins." msgstr "" -"タプルと同様に、構造体と列挙型もパターンマッチによりデストラクトできます。" +"`match` キーワードを使用すると、1 つ以上のパターンに対して値を照合できます。" +"上から順に照合が行われ、最初に一致したパターンのみが実行されます。" -#: src/pattern-matching/destructuring.md -msgid "Structs" -msgstr "構造体（structs）" +#: src/pattern-matching/match.md +msgid "The patterns can be simple values, similarly to `switch` in C and C++:" +msgstr "C や C++ の `switch` と同様に、パターンには単純な値を指定できます。" -#: src/pattern-matching/destructuring.md -msgid "\"x.0 = 1, b = {b}, y = {y}\"" -msgstr "\"x.0 = 1, b = {b}, y = {y}\"" +#: src/pattern-matching/match.md +msgid "'x'" +msgstr "'x'" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/match.md +msgid "'q'" +msgstr "'q'" + +#: src/pattern-matching/match.md +msgid "\"Quitting\"" +msgstr "\"Quitting\"" + +#: src/pattern-matching/match.md src/generics/exercise.md +#: src/generics/solution.md src/std-traits/solution.md +#: src/error-handling/exercise.md src/error-handling/solution.md +msgid "'a'" +msgstr "'a'" + +#: src/pattern-matching/match.md +msgid "'s'" +msgstr "'s'" + +#: src/pattern-matching/match.md +msgid "'w'" +msgstr "'w'" + +#: src/pattern-matching/match.md +msgid "'d'" +msgstr "'d'" + +#: src/pattern-matching/match.md +msgid "\"Moving around\"" +msgstr "\"Moving around\"" + +#: src/pattern-matching/match.md src/error-handling/exercise.md +#: src/error-handling/solution.md +msgid "'0'" +msgstr "'0'" + +#: src/pattern-matching/match.md src/error-handling/exercise.md +#: src/error-handling/solution.md +msgid "'9'" +msgstr "'9'" + +#: src/pattern-matching/match.md +msgid "\"Number input\"" +msgstr "\"Number input\"" + +#: src/pattern-matching/match.md +msgid "\"Lowercase: {key}\"" +msgstr "\"Lowercase: {key}\"" + +#: src/pattern-matching/match.md +msgid "\"Something else\"" +msgstr "\"Something else\"" + +#: src/pattern-matching/match.md +#, fuzzy +msgid "" +"The `_` pattern is a wildcard pattern which matches any value. The " +"expressions _must_ be exhaustive, meaning that it covers every possibility, " +"so `_` is often used as the final catch-all case." +msgstr "" +"`_` パターンは、任意の値に一致するワイルドカード パターンです。式は論駁不可能" +"でなければなりません。つまり、あらゆる可能性をカバーする必要があるため、最後" +"のキャッチオール ケースとして `_` がよく使用されます。" + +#: src/pattern-matching/match.md +msgid "" +"Match can be used as an expression. Just like `if`, each match arm must have " +"the same type. The type is the last expression of the block, if any. In the " +"example above, the type is `()`." +msgstr "" +"一致を式として使用できます。`if` と同様に、各マッチアームは同じ型にする必要が" +"あります。型は、ブロックの最後の式です（存在する場合）。上記の例では、型は " +"`()` です。" + +#: src/pattern-matching/match.md +msgid "" +"A variable in the pattern (`key` in this example) will create a binding that " +"can be used within the match arm." +msgstr "" +"パターンの変数（この例では `key`）により、マッチアーム内で使用できるバイン" +"ディングが作成されます。" + +#: src/pattern-matching/match.md +msgid "A match guard causes the arm to match only if the condition is true." +msgstr "マッチガードにより、条件が true の場合にのみアームが一致します。" + +#: src/pattern-matching/match.md +msgid "" +"You might point out how some specific characters are being used when in a " +"pattern" +msgstr "特定の文字がパターンでどのように使用されるかを説明します。" + +#: src/pattern-matching/match.md +msgid "`|` as an `or`" +msgstr "`|` を `or` として指定する" + +#: src/pattern-matching/match.md +msgid "`..` can expand as much as it needs to be" +msgstr "`..` は必要に応じて展開できる" + +#: src/pattern-matching/match.md +msgid "`1..=5` represents an inclusive range" +msgstr "`1..=5` は 5 を含む範囲を表す" + +#: src/pattern-matching/match.md +msgid "`_` is a wild card" +msgstr "`_` はワイルドカードを表す" + +#: src/pattern-matching/match.md +msgid "" +"Match guards as a separate syntax feature are important and necessary when " +"we wish to concisely express more complex ideas than patterns alone would " +"allow." +msgstr "" +"パターンのみでは表現できない複雑な概念を簡潔に表現したい場合、独立した構文機" +"能であるマッチガードは重要かつ必要です。" + +#: src/pattern-matching/match.md +msgid "" +"They are not the same as separate `if` expression inside of the match arm. " +"An `if` expression inside of the branch block (after `=>`) happens after the " +"match arm is selected. Failing the `if` condition inside of that block won't " +"result in other arms of the original `match` expression being considered." +msgstr "" +"マッチガードは、マッチアーム内の個別の `if` 式とは異なります。分岐ブロック内" +"（`=>` の後）の `if` 式は、マッチアームが選択された後に実行されます。そのブ" +"ロック内で `if` 条件が満たされなかった場合、元の `match` 式の他のアームは考慮" +"されません。" + +#: src/pattern-matching/match.md +msgid "" +"The condition defined in the guard applies to every expression in a pattern " +"with an `|`." +msgstr "" +"ガードで定義された条件は、`|` が付いたパターン内のすべての式に適用されます。" + +#: src/pattern-matching/destructuring-structs.md +msgid "Structs" +msgstr "構造体（structs）" + +#: src/pattern-matching/destructuring-structs.md +#, fuzzy +msgid "Like tuples, Struct can also be destructured by matching:" +msgstr "" +"タプルと同様に、構造体と列挙型もパターンマッチによりデストラクトできます。" + +#: src/pattern-matching/destructuring-structs.md +msgid "\"x.0 = 1, b = {b}, y = {y}\"" +msgstr "\"x.0 = 1, b = {b}, y = {y}\"" + +#: src/pattern-matching/destructuring-structs.md msgid "\"y = 2, x = {i:?}\"" msgstr "\"y = 2, x = {i:?}\"" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-structs.md msgid "\"y = {y}, other fields were ignored\"" msgstr "\"y = {y}, other fields were ignored\"" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-structs.md +msgid "Change the literal values in `foo` to match with the other patterns." +msgstr "`foo` のリテラル値を他のパターンと一致するように変更します。" + +#: src/pattern-matching/destructuring-structs.md +msgid "Add a new field to `Foo` and make changes to the pattern as needed." +msgstr "" +"`Foo` に新しいフィールドを追加し、必要に応じてパターンに変更を加えます。" + +#: src/pattern-matching/destructuring-structs.md +msgid "" +"The distinction between a capture and a constant expression can be hard to " +"spot. Try changing the `2` in the second arm to a variable, and see that it " +"subtly doesn't work. Change it to a `const` and see it working again." +msgstr "" +"キャプチャと定数式を区別しづらい場合があります。2 つ目のアームの `2` を変数に" +"変更してみて、うまく機能しないことを確認します。これを `const` に変更して、再" +"び動作することを確認します。" + +#: src/pattern-matching/destructuring-enums.md +#, fuzzy +msgid "Like tuples, enums can also be destructured by matching:" +msgstr "" +"タプルと同様に、構造体と列挙型もパターンマッチによりデストラクトできます。" + +#: src/pattern-matching/destructuring-enums.md msgid "" "Patterns can also be used to bind variables to parts of your values. This is " "how you inspect the structure of your types. Let us start with a simple " @@ -5274,19 +5277,19 @@ msgstr "" "パターンは、変数を値の一部にバインドするためにも使用できます。以下のようにし" "て、型の構造を調べることができます。単純な `enum` から始めましょう。" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "\"cannot divide {n} into two equal parts\"" msgstr "\"cannot divide {n} into two equal parts\"" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "\"{n} divided in two is {half}\"" msgstr "\"{n} divided in two is {half}\"" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "\"sorry, an error happened: {msg}\"" msgstr "\"sorry, an error happened: {msg}\"" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "" "Here we have used the arms to _destructure_ the `Result` value. In the first " "arm, `half` is bound to the value inside the `Ok` variant. In the second " @@ -5296,33 +5299,14 @@ msgstr "" "行っています。最初のアームでは、`half` は `Ok` バリアント内の値にバインドされ" "ます。2 つ目のアームでは `msg` がエラー メッセージにバインドされます。" -#: src/pattern-matching/destructuring.md -msgid "Change the literal values in `foo` to match with the other patterns." -msgstr "`foo` のリテラル値を他のパターンと一致するように変更します。" - -#: src/pattern-matching/destructuring.md -msgid "Add a new field to `Foo` and make changes to the pattern as needed." -msgstr "" -"`Foo` に新しいフィールドを追加し、必要に応じてパターンに変更を加えます。" - -#: src/pattern-matching/destructuring.md -msgid "" -"The distinction between a capture and a constant expression can be hard to " -"spot. Try changing the `2` in the second arm to a variable, and see that it " -"subtly doesn't work. Change it to a `const` and see it working again." -msgstr "" -"キャプチャと定数式を区別しづらい場合があります。2 つ目のアームの `2` を変数に" -"変更してみて、うまく機能しないことを確認します。これを `const` に変更して、再" -"び動作することを確認します。" - -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "" "The `if`/`else` expression is returning an enum that is later unpacked with " "a `match`." msgstr "" "`if`/`else` 式は、後で `match` でアンパックされる列挙型を返しています。" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "" "You can try adding a third variant to the enum definition and displaying the " "errors when running the code. Point out the places where your code is now " @@ -5332,14 +5316,14 @@ msgstr "" "にエラーを表示してみましょう。コードが網羅されていない箇所を示し、コンパイラ" "がどのようにヒントを提供しようとしているかを説明します。" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "" "The values in the enum variants can only be accessed after being pattern " "matched." msgstr "" "列挙型バリアントの値には、パターンが一致した場合にのみアクセスできます。" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "" "Demonstrate what happens when the search is inexhaustive. Note the advantage " "the Rust compiler provides by confirming when all cases are handled." @@ -5347,7 +5331,7 @@ msgstr "" "検索が網羅的でない場合にどうなるかを示します。すべてのケースが処理されるタイ" "ミングを確認することで、Rust コンパイラの利点を強調します。" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "" "Save the result of `divide_in_two` in the `result` variable and `match` it " "in a loop. That won't compile because `msg` is consumed when matched. To fix " @@ -5376,12 +5360,12 @@ msgid "`if let` expressions" msgstr "`if let` 式" #: src/pattern-matching/let-control-flow.md -msgid "`while let` expressions" -msgstr "`while let` 式" +msgid "`let else` expressions" +msgstr "`let else` 式" #: src/pattern-matching/let-control-flow.md -msgid "`match` expressions" -msgstr "`match` 式" +msgid "`while let` expressions" +msgstr "`while let` 式" #: src/pattern-matching/let-control-flow.md msgid "" @@ -5397,10 +5381,6 @@ msgstr "" msgid "\"slept for {:?}\"" msgstr "\"slept for {:?}\"" -#: src/pattern-matching/let-control-flow.md -msgid "`let else` expressions" -msgstr "`let else` 式" - #: src/pattern-matching/let-control-flow.md msgid "" "For the common case of matching a pattern and returning from the function, " @@ -5414,24 +5394,24 @@ msgstr "" "ど、ブロックから抜けるもの以外のすべて）。" #: src/pattern-matching/let-control-flow.md -msgid "\"got None\"" -msgstr "\"got None\"" +msgid "\"not a hex digit\"" +msgstr "\"not a hex digit\"" #: src/pattern-matching/let-control-flow.md msgid "\"got empty string\"" msgstr "\"got empty string\"" #: src/pattern-matching/let-control-flow.md -msgid "\"not a hex digit\"" -msgstr "\"not a hex digit\"" +msgid "\"got None\"" +msgstr "\"got None\"" #: src/pattern-matching/let-control-flow.md src/pattern-matching/solution.md msgid "\"result: {:?}\"" msgstr "\"result: {:?}\"" #: src/pattern-matching/let-control-flow.md src/generics/trait-bounds.md -#: src/smart-pointers/solution.md src/testing/googletest.md -#: src/testing/solution.md +#: src/smart-pointers/solution.md src/testing/solution.md +#: src/android/testing.md src/android/testing/googletest.md msgid "\"foo\"" msgstr "\"foo\"" @@ -5595,31 +5575,6 @@ msgstr "\"division by zero\"" msgid "\"expr: {:?}\"" msgstr "\"expr: {:?}\"" -#: src/methods-and-traits.md -msgid "[Methods](./methods-and-traits/methods.md) (10 minutes)" -msgstr "[メソッド](./methods-and-train/methods.md)（10 分）" - -#: src/methods-and-traits.md -msgid "[Traits](./methods-and-traits/traits.md) (10 minutes)" -msgstr "[トレイト](./methods-and-features/train.md)（10 分）" - -#: src/methods-and-traits.md -msgid "[Deriving](./methods-and-traits/deriving.md) (5 minutes)" -msgstr "[導出](./methods-and-train/deriving.md)（5 分）" - -#: src/methods-and-traits.md -msgid "[Trait Objects](./methods-and-traits/trait-objects.md) (10 minutes)" -msgstr "[トレイトオブジェクト](./methods-and-features/train.md)（10 分）" - -#: src/methods-and-traits.md -msgid "" -"[Exercise: Generic Logger](./methods-and-traits/exercise.md) (20 minutes)" -msgstr "[演習: ジェネリックなロガー](./methods-and-train/exercise.md)（20 分）" - -#: src/methods-and-traits.md -msgid "This segment should take about 55 minutes" -msgstr "このセグメントの所要時間は約 55 分です" - #: src/methods-and-traits/methods.md msgid "" "Rust allows you to associate functions with your new types. You do this with " @@ -5789,20 +5744,14 @@ msgstr "" "インターフェースに似ています：" #: src/methods-and-traits/traits.md -msgid "\"Oh you're a cutie! What's your name? {}\"" -msgstr "\"Oh you're a cutie! What's your name? {}\"" - -#: src/methods-and-traits/traits.md src/methods-and-traits/trait-objects.md -msgid "\"Woof, my name is {}!\"" -msgstr "\"Woof, my name is {}!\"" - -#: src/methods-and-traits/traits.md src/methods-and-traits/trait-objects.md -msgid "\"Miau!\"" -msgstr "\"Miau!\"" +#, fuzzy +msgid "/// Return a sentence from this pet.\n" +msgstr "// このモジュールから型を再エクスポートします。\n" -#: src/methods-and-traits/traits.md src/methods-and-traits/trait-objects.md -msgid "\"Fido\"" -msgstr "\"Fido\"" +#: src/methods-and-traits/traits.md +#, fuzzy +msgid "/// Print a string to the terminal greeting this pet.\n" +msgstr "/// 挨拶を標準出力に出力します。\n" #: src/methods-and-traits/traits.md msgid "" @@ -5813,20 +5762,96 @@ msgstr "" "す。" #: src/methods-and-traits/traits.md -msgid "Traits are implemented in an `impl for { .. }` block." +msgid "" +"In the \"Generics\" segment, next, we will see how to build functionality " +"that is generic over all types implementing a trait." +msgstr "" + +#: src/methods-and-traits/traits/implementing.md +msgid "\"Oh you're a cutie! What's your name? {}\"" +msgstr "\"Oh you're a cutie! What's your name? {}\"" + +#: src/methods-and-traits/traits/implementing.md src/generics/dyn-trait.md +#: src/smart-pointers/trait-objects.md +msgid "\"Woof, my name is {}!\"" +msgstr "\"Woof, my name is {}!\"" + +#: src/methods-and-traits/traits/implementing.md src/generics/dyn-trait.md +#: src/smart-pointers/trait-objects.md +msgid "\"Fido\"" +msgstr "\"Fido\"" + +#: src/methods-and-traits/traits/implementing.md +#, fuzzy +msgid "" +"To implement `Trait` for `Type`, you use an `impl Trait for Type { .. }` " +"block." msgstr "トレイトは `impl for { .. }` ブロックに実装されます。" -#: src/methods-and-traits/traits.md +#: src/methods-and-traits/traits/implementing.md +msgid "" +"Unlike Go interfaces, just having matching methods is not enough: a `Cat` " +"type with a `talk()` method would not automatically satisfy `Pet` unless it " +"is in an `impl Pet` block." +msgstr "" + +#: src/methods-and-traits/traits/implementing.md #, fuzzy msgid "" -"Traits may specify pre-implemented (provided) methods and methods that users " -"are required to implement themselves. Provided methods can rely on required " -"methods. In this case, `greet` is provided, and relies on `talk`." +"Traits may provide default implementations of some methods. Default " +"implementations can rely on all the methods of the trait. In this case, " +"`greet` is provided, and relies on `talk`." msgstr "" "トレイトは予め実装された（デフォルトの）メソッドと、ユーザが自身で実装する必" "要のあるメソッドを指定することができます。デフォルトの実装のあるメソッドは、" "その定義を実装必須のメソットに依存することができます。" +#: src/methods-and-traits/traits/supertraits.md +msgid "" +"A trait can require that types implementing it also implement other traits, " +"called _supertraits_. Here, any type implementing `Pet` must implement " +"`Animal`." +msgstr "" + +#: src/methods-and-traits/traits/supertraits.md +msgid "\"Rex\"" +msgstr "\"Rex\"" + +#: src/methods-and-traits/traits/supertraits.md +#, fuzzy +msgid "\"{} has {} legs\"" +msgstr "\"{} is {} years old\"" + +#: src/methods-and-traits/traits/supertraits.md +msgid "" +"This is sometimes called \"trait inheritance\" but students should not " +"expect this to behave like OO inheritance. It just specifies an additional " +"requirement on implementations of a trait." +msgstr "" + +#: src/methods-and-traits/traits/associated-types.md +msgid "" +"Associated types are placeholder types which are supplied by the trait " +"implementation." +msgstr "" + +#: src/methods-and-traits/traits/associated-types.md +#: src/concurrency/async-control-flow/join.md +msgid "\"{:?}\"" +msgstr "\"{:?}\"" + +#: src/methods-and-traits/traits/associated-types.md +msgid "" +"Associated types are sometimes also called \"output types\". The key " +"observation is that the implementer, not the caller, chooses this type." +msgstr "" + +#: src/methods-and-traits/traits/associated-types.md +msgid "" +"Many standard library traits have associated types, including arithmetic " +"operators and `Iterator`." +msgstr "" + #: src/methods-and-traits/deriving.md msgid "" "Supported traits can be automatically implemented for your custom types, as " @@ -5865,216 +5890,23 @@ msgstr "" "出マクロが用意されています。たとえば、`serde` は `#[derive(Serialize)]` を使" "用して、構造体のシリアル化のサポートを導出できます。" -#: src/methods-and-traits/trait-objects.md +#: src/methods-and-traits/exercise.md +#, fuzzy +msgid "Exercise: Logger Trait" +msgstr "演習: ジェネリックなロガー" + +#: src/methods-and-traits/exercise.md msgid "" -"Trait objects allow for values of different types, for instance in a " -"collection:" +"Let's design a simple logging utility, using a trait `Logger` with a `log` " +"method. Code which might log its progress can then take an `&impl Logger`. " +"In testing, this might put messages in the test logfile, while in a " +"production build it would send messages to a log server." msgstr "" -"トレイトオブジェクトは異なる型の値をひとつのコレクションにまとめることを可能" -"にします：" - -#: src/methods-and-traits/trait-objects.md -msgid "\"Hello, who are you? {}\"" -msgstr "\"Hello, who are you? {}\"" - -#: src/methods-and-traits/trait-objects.md -msgid "Memory layout after allocating `pets`:" -msgstr "`pets`を割り当てた後のメモリレイアウト：" - -#: src/methods-and-traits/trait-objects.md -msgid "" -"```bob\n" -" Stack Heap\n" -".- - - - - - - - - - - - - -. .- - - - - - - - - - - - - - - - - - - - - " -"- -.\n" -": : : :\n" -": pets : : +----+----+----+----" -"+ :\n" -": +-----------+-------+ : : +-----+-----+ .->| F | i | d | o " -"| :\n" -": | ptr | o---+---+-----+-->| o o | o o | | +----+----+----+----" -"+ :\n" -": | len | 2 | : : +-|-|-+-|-|-+ " -"`---------. :\n" -": | capacity | 2 | : : | | | | data " -"| :\n" -": +-----------+-------+ : : | | | | +-------+--|-------" -"+ :\n" -": : : | | | '-->| name | o, 4, 4 " -"| :\n" -": : : | | | | age | 5 " -"| :\n" -"`- - - - - - - - - - - - - -' : | | | +-------+----------" -"+ :\n" -" : | | " -"| :\n" -" : | | | " -"vtable :\n" -" : | | | +----------------------" -"+ :\n" -" : | | '---->| \"::talk\" " -"| :\n" -" : | | +----------------------" -"+ :\n" -" : | " -"| :\n" -" : | | " -"data :\n" -" : | | +-------+-------" -"+ :\n" -" : | '-->| lives | 9 " -"| :\n" -" : | +-------+-------" -"+ :\n" -" : " -"| :\n" -" : | " -"vtable :\n" -" : | +----------------------" -"+ :\n" -" : '---->| \"::talk\" " -"| :\n" -" : +----------------------" -"+ :\n" -" : :\n" -" '- - - - - - - - - - - - - - - - - - - - - " -"- -'\n" -"```" -msgstr "" -"```bob\n" -" スタック ヒープ\n" -".- - - - - - - - - - - - - -. .- - - - - - - - - - - - - - - - - - - - - " -"- -.\n" -": : : :\n" -": pets : : +----+----+----+----" -"+ :\n" -": +-----------+-------+ : : +-----+-----+ .->| F | i | d | o " -"| :\n" -": | ptr | o---+---+-----+-->| o o | o o | | +----+----+----+----" -"+ :\n" -": | len | 2 | : : +-|-|-+-|-|-+ " -"`---------. :\n" -": | capacity | 2 | : : | | | | data " -"| :\n" -": +-----------+-------+ : : | | | | +-------+--|-------" -"+ :\n" -": : : | | | '-->| name | o, 4, 4 " -"| :\n" -": : : | | | | age | 5 " -"| :\n" -"`- - - - - - - - - - - - - -' : | | | +-------+----------" -"+ :\n" -" : | | " -"| :\n" -" : | | | " -"vtable :\n" -" : | | | +----------------------" -"+ :\n" -" : | | '---->| \"::talk\" " -"| :\n" -" : | | +----------------------" -"+ :\n" -" : | " -"| :\n" -" : | | " -"data :\n" -" : | | +-------+-------" -"+ :\n" -" : | '-->| lives | 9 " -"| :\n" -" : | +-------+-------" -"+ :\n" -" : " -"| :\n" -" : | " -"vtable :\n" -" : | +----------------------" -"+ :\n" -" : '---->| \"::talk\" " -"| :\n" -" : +----------------------" -"+ :\n" -" : :\n" -" '- - - - - - - - - - - - - - - - - - - - - " -"- -'\n" -"```" - -#: src/methods-and-traits/trait-objects.md -msgid "" -"Types that implement a given trait may be of different sizes. This makes it " -"impossible to have things like `Vec` in the example above." -msgstr "" -"同じトレイトを実装する型であってもそのサイズは異なることがあります。そのた" -"め、上の例でVecと書くことはできません。" - -#: src/methods-and-traits/trait-objects.md -msgid "" -"`dyn Pet` is a way to tell the compiler about a dynamically sized type that " -"implements `Pet`." -msgstr "" -"`dyn Pet` はコンパイラに、この型が`Pet`トレイトを実装する動的なサイズの型であ" -"ることを伝えます。" - -#: src/methods-and-traits/trait-objects.md -msgid "" -"In the example, `pets` is allocated on the stack and the vector data is on " -"the heap. The two vector elements are _fat pointers_:" -msgstr "" -"上の例では `pets` はスタックに確保され、ベクターのデータはヒープ上にありま" -"す。二つのベクターの要素は _ファットポインタ_ です：" - -#: src/methods-and-traits/trait-objects.md -msgid "" -"A fat pointer is a double-width pointer. It has two components: a pointer to " -"the actual object and a pointer to the [virtual method table](https://en." -"wikipedia.org/wiki/Virtual_method_table) (vtable) for the `Pet` " -"implementation of that particular object." -msgstr "" -"ファットポインタはdouble-widthポインタです。これは二つの要素からなります：実" -"際のオブジェクトへのポインタと、そのオブジェクトの`Pet`の実装のための[仮想関" -"数テーブル](https://ja.wikipedia.org/wiki/" -"%E4%BB%AE%E6%83%B3%E9%96%A2%E6%95%B0%E3%83%86%E3%83%BC%E3%83%96%E3%83%AB) " -"(vtable)です。" - -#: src/methods-and-traits/trait-objects.md -msgid "" -"The data for the `Dog` named Fido is the `name` and `age` fields. The `Cat` " -"has a `lives` field." -msgstr "" -"\"Fido\"と名付けられた`Dog`のデータは`name` と `age` のフィールドに対応しま" -"す。（訳注: \"Fido\"とはよくある犬の愛称で、日本語でいう「ポチ」のような名前" -"です。）例の`Cat`には`lives` フィールドがあります。（訳注: ここで`Cat`が" -"`lives`というフィールドを持ち、9で初期化しているのは\"A cat has nine lives\" " -"—猫は９つの命を持つ—ということわざに由来します。）" - -#: src/methods-and-traits/trait-objects.md -msgid "Compare these outputs in the above example:" -msgstr "上の例において、下のコードによる出力結果を比べてみましょう：" - -#: src/methods-and-traits/trait-objects.md src/std-traits/closures.md -msgid "\"{} {}\"" -msgstr "\"{} {}\"" - -#: src/methods-and-traits/trait-objects.md src/std-traits/exercise.md -#: src/std-traits/solution.md src/modules/exercise.md src/modules/solution.md -#: src/android/build-rules/library.md -#: src/android/interoperability/cpp/rust-bridge.md -#: src/async/pitfalls/cancellation.md -msgid "\"{}\"" -msgstr "\"{}\"" - -#: src/methods-and-traits/exercise.md -msgid "" -"Let's design a simple logging utility, using a trait `Logger` with a `log` " -"method. Code which might log its progress can then take an `&impl Logger`. " -"In testing, this might put messages in the test logfile, while in a " -"production build it would send messages to a log server." -msgstr "" -"トレイト `Logger` と `log` メソッドを使用して、シンプルなロギングユーティリ" -"ティを設計してみましょう。進行状況をログに記録するコードは、その後に `&impl " -"Logger` を受け取ることができます。この場合、テストではテストログファイルに" -"メッセージが書き込まれますが、本番環境ビルドではログサーバーにメッセージが送" -"信されます。" +"トレイト `Logger` と `log` メソッドを使用して、シンプルなロギングユーティリ" +"ティを設計してみましょう。進行状況をログに記録するコードは、その後に `&impl " +"Logger` を受け取ることができます。この場合、テストではテストログファイルに" +"メッセージが書き込まれますが、本番環境ビルドではログサーバーにメッセージが送" +"信されます。" #: src/methods-and-traits/exercise.md msgid "" @@ -6120,29 +5952,31 @@ msgstr "// TODO: `VerbosityFilter` を定義して実装します。\n" msgid "/// Only log messages up to the given verbosity level.\n" msgstr "/// 指定された詳細度レベルまでのメッセージのみをログに記録。\n" -#: src/generics.md -msgid "[Generic Functions](./generics/generic-functions.md) (5 minutes)" -msgstr "[ジェネリック関数](./generics/generic-functions.md)（5 分）" +#: src/welcome-day-2-afternoon.md +#, fuzzy +msgid "" +"Including 10 minute breaks, this session should take about 3 hours and 15 " +"minutes. It contains:" +msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 3 時間 5 分です。" -#: src/generics.md -msgid "[Generic Data Types](./generics/generic-data.md) (15 minutes)" -msgstr "[ジェネリック データ型](./generics/generic-data.md)（15 分）" +#: src/generics.md src/iterators.md src/testing.md +#, fuzzy +msgid "This segment should take about 45 minutes. It contains:" +msgstr "このセグメントの所要時間は約 45 分です" #: src/generics.md -msgid "[Trait Bounds](./generics/trait-bounds.md) (10 minutes)" -msgstr "[トレイト境界](./generics/trait-bounds.md)（10 分）" +msgid "impl Trait" +msgstr "impl Trait" #: src/generics.md -msgid "[impl Trait](./generics/impl-trait.md) (5 minutes)" -msgstr "[impl トレイト](./generics/impl-trait.md)（5 分）" +#, fuzzy +msgid "dyn Trait" +msgstr "Asyncトレイト" #: src/generics.md -msgid "[Exercise: Generic min](./generics/exercise.md) (10 minutes)" -msgstr "[演習: ジェネリックな min](./generics/exercise.md)（10 分）" - -#: src/generics.md src/smart-pointers.md src/iterators.md src/error-handling.md -msgid "This segment should take about 45 minutes" -msgstr "このセグメントの所要時間は約 45 分です" +#, fuzzy +msgid "Exercise: Generic min" +msgstr "演習: ジェネリックな `min`" #: src/generics/generic-functions.md #, fuzzy @@ -6209,10 +6043,6 @@ msgid "You can use generics to abstract over the concrete field type:" msgstr "" "ジェネリクスを使って、具体的なフィールドの型を抽象化することができます：" -#: src/generics/generic-data.md -msgid "// fn set_x(&mut self, x: T)\n" -msgstr "// fn set_x(&mut self, x: T)\n" - #: src/generics/generic-data.md msgid "\"{integer:?} and {float:?}\"" msgstr "\"{integer:?} and {float:?}\"" @@ -6266,6 +6096,54 @@ msgstr "" "変数（`T` と `U` など）を使用して、異なる型の要素を持つポイントを許可するよう" "にコードを更新します。" +#: src/generics/generic-traits.md +msgid "" +"Traits can also be generic, just like types and functions. A trait's " +"parameters get concrete types when it is used." +msgstr "" + +#: src/generics/generic-traits.md +msgid "\"Converted from integer: {from}\"" +msgstr "" + +#: src/generics/generic-traits.md +msgid "\"Converted from bool: {from}\"" +msgstr "" + +#: src/generics/generic-traits.md +msgid "\"{from_int:?}, {from_bool:?}\"" +msgstr "" + +#: src/generics/generic-traits.md +msgid "" +"The `From` trait will be covered later in the course, but its [definition in " +"the `std` docs](https://doc.rust-lang.org/std/convert/trait.From.html) is " +"simple." +msgstr "" + +#: src/generics/generic-traits.md +msgid "" +"Implementations of the trait do not need to cover all possible type " +"parameters. Here, `Foo::from(\"hello\")` would not compile because there is " +"no `From<&str>` implementation for `Foo`." +msgstr "" + +#: src/generics/generic-traits.md +msgid "" +"Generic traits take types as \"input\", while associated types are a kind of " +"\"output\" type. A trait can have multiple implementations for different " +"input types." +msgstr "" + +#: src/generics/generic-traits.md +msgid "" +"In fact, Rust requires that at most one implementation of a trait match for " +"any type T. Unlike some other languages, Rust has no heuristic for choosing " +"the \"most specific\" match. There is work on adding this support, called " +"[specialization](https://rust-lang.github.io/rfcs/1210-impl-specialization." +"html)." +msgstr "" + #: src/generics/trait-bounds.md msgid "" "When working with generics, you often want to require the types to implement " @@ -6279,7 +6157,8 @@ msgstr "" "issues/172)。）" #: src/generics/trait-bounds.md -msgid "You can do this with `T: Trait` or `impl Trait`:" +#, fuzzy +msgid "You can do this with `T: Trait`:" msgstr "そうしたことは`T: Trait` や `impl Trait`を用いて行えます：" #: src/generics/trait-bounds.md @@ -6408,73 +6287,141 @@ msgstr "" "`debuggable` の型は何でしょうか。`let debuggable: () = ..` を試して、エラー " "メッセージの内容を確認してください。" -#: src/generics/exercise.md +#: src/generics/dyn-trait.md msgid "" -"In this short exercise, you will implement a generic `min` function that " -"determines the minimum of two values, using a `LessThan` trait." +"In addition to using traits for static dispatch via generics, Rust also " +"supports using them for type-erased, dynamic dispatch via trait objects:" msgstr "" -"この短い演習では、`LessThan` トレイトを使用して、2 つの値の最小値を決定する" -"ジェネリックな `min` 関数を実装します。" -#: src/generics/exercise.md src/generics/solution.md -msgid "/// Return true if self is less than other.\n" -msgstr "/// 自身がその他より小さい場合は true を返します。\n" +#: src/generics/dyn-trait.md src/smart-pointers/trait-objects.md +msgid "\"Miau!\"" +msgstr "\"Miau!\"" -#: src/generics/exercise.md -msgid "// TODO: implement the `min` function used in `main`.\n" -msgstr "// TODO: `main` で使用する `min` 関数を実装します。\n" +#: src/generics/dyn-trait.md +msgid "// Uses generics and static dispatch.\n" +msgstr "" -#: src/generics/exercise.md src/generics/solution.md -msgid "\"Shapiro\"" -msgstr "\"Shapiro\"" +#: src/generics/dyn-trait.md src/smart-pointers/trait-objects.md +msgid "\"Hello, who are you? {}\"" +msgstr "\"Hello, who are you? {}\"" -#: src/generics/exercise.md src/generics/solution.md -msgid "\"Baumann\"" -msgstr "\"Baumann\"" +#: src/generics/dyn-trait.md +msgid "// Uses type-erasure and dynamic dispatch.\n" +msgstr "" -#: src/welcome-day-2-afternoon.md -msgid "[Standard Library Types](./std-types.md) (1 hour and 10 minutes)" -msgstr "[標準ライブラリ型](./std-types.md)（1 時間 10 分）" +#: src/generics/dyn-trait.md +msgid "" +"Generics, including `impl Trait`, use monomorphization to create a " +"specialized instance of the function for each different type that the " +"generic is instantiated with. This means that calling a trait method from " +"within a generic function still uses static dispatch, as the compiler has " +"full type information and can resolve which type's trait implementation to " +"use." +msgstr "" -#: src/welcome-day-2-afternoon.md -msgid "[Standard Library Traits](./std-traits.md) (1 hour and 40 minutes)" -msgstr "[標準ライブラリ トレイト](./std-train.md)（1 時間 40 分）" +#: src/generics/dyn-trait.md +msgid "" +"When using `dyn Trait`, it instead uses dynamic dispatch through a [virtual " +"method table](https://en.wikipedia.org/wiki/Virtual_method_table) (vtable). " +"This means that there's a single version of `fn dynamic` that is used " +"regardless of what type of `Pet` is passed in." +msgstr "" -#: src/std-types.md -msgid "[Standard Library](./std-types/std.md) (3 minutes)" -msgstr "[標準ライブラリ](./std-types/std.md)（3 分）" +#: src/generics/dyn-trait.md +msgid "" +"When using `dyn Trait`, the trait object needs to be behind some kind of " +"indirection. In this case it's a reference, though smart pointer types like " +"`Box` can also be used (this will be demonstrated on day 3)." +msgstr "" -#: src/std-types.md -msgid "[Documentation](./std-types/docs.md) (5 minutes)" -msgstr "[ドキュメント](./std-types/docs.md)（5 分）" +#: src/generics/dyn-trait.md +msgid "" +"At runtime, a `&dyn Pet` is represented as a \"fat pointer\", i.e. a pair of " +"two pointers: One pointer points to the concrete object that implements " +"`Pet`, and the other points to the vtable for the trait implementation for " +"that type. When calling the `talk` method on `&dyn Pet` the compiler looks " +"up the function pointer for `talk` in the vtable and then invokes the " +"function, passing the pointer to the `Dog` or `Cat` into that function. The " +"compiler doesn't need to know the concrete type of the `Pet` in order to do " +"this." +msgstr "" -#: src/std-types.md -msgid "[Option](./std-types/option.md) (10 minutes)" -msgstr "[Option](./std-types/option.md)（10 分）" +#: src/generics/dyn-trait.md +msgid "" +"A `dyn Trait` is considered to be \"type-erased\", because we no longer have " +"compile-time knowledge of what the concrete type is." +msgstr "" -#: src/std-types.md -msgid "[Result](./std-types/result.md) (10 minutes)" -msgstr "[Result](./std-types/result.md)（10 分）" +#: src/generics/exercise.md +#, fuzzy +msgid "" +"In this short exercise, you will implement a generic `min` function that " +"determines the minimum of two values, using the [`Ord`](https://doc.rust-" +"lang.org/stable/std/cmp/trait.Ord.html) trait." +msgstr "" +"この短い演習では、`LessThan` トレイトを使用して、2 つの値の最小値を決定する" +"ジェネリックな `min` 関数を実装します。" -#: src/std-types.md -msgid "[String](./std-types/string.md) (10 minutes)" -msgstr "[String](./std-types/string.md)（10 分）" +#: src/generics/exercise.md +msgid "// TODO: implement the `min` function used in `main`.\n" +msgstr "// TODO: `main` で使用する `min` 関数を実装します。\n" -#: src/std-types.md -msgid "[Vec](./std-types/vec.md) (10 minutes)" -msgstr "[Vec](./std-types/vec.md)（10 分）" +#: src/generics/exercise.md src/generics/solution.md +#: src/error-handling/exercise.md src/error-handling/solution.md +msgid "'z'" +msgstr "'z'" -#: src/std-types.md -msgid "[HashMap](./std-types/hashmap.md) (10 minutes)" -msgstr "[HashMap](./std-types/hashmap.md)（10 分）" +#: src/generics/exercise.md src/generics/solution.md +#, fuzzy +msgid "'7'" +msgstr "'x'" + +#: src/generics/exercise.md src/generics/solution.md +#, fuzzy +msgid "'1'" +msgstr "'x'" + +#: src/generics/exercise.md src/generics/solution.md +msgid "\"goodbye\"" +msgstr "" + +#: src/generics/exercise.md src/generics/solution.md +msgid "\"bat\"" +msgstr "" + +#: src/generics/exercise.md src/generics/solution.md +msgid "\"armadillo\"" +msgstr "" + +#: src/generics/exercise.md +#, fuzzy +msgid "" +"Show students the [`Ord`](https://doc.rust-lang.org/stable/std/cmp/trait.Ord." +"html) trait and [`Ordering`](https://doc.rust-lang.org/stable/std/cmp/enum." +"Ordering.html) enum." +msgstr "" +"[`OsStr`](https://doc.rust-lang.org/std/ffi/struct.OsStr.html) と " +"[`OsString`](https://doc.rust-lang.org/std/ffi/struct.OsString.html)" + +#: src/std-types.md src/std-types/option.md +msgid "Option" +msgstr "Option" + +#: src/std-types.md src/std-types/result.md src/error-handling.md +msgid "Result" +msgstr "Result" + +#: src/std-types.md src/std-types/string.md +msgid "String" +msgstr "文字列（String）" #: src/std-types.md -msgid "[Exercise: Counter](./std-types/exercise.md) (10 minutes)" -msgstr "[演習: カウンタ](./std-types/exercise.md)（10 分）" +msgid "Vec" +msgstr "ベクタ（Vec）" -#: src/std-types.md src/memory-management.md src/slices-and-lifetimes.md -msgid "This segment should take about 1 hour and 10 minutes" -msgstr "このセグメントの所要時間は約 1 時間 10 分です" +#: src/std-types.md +msgid "HashMap" +msgstr "ハッシュマップ（HashMap）" #: src/std-types.md msgid "" @@ -6607,10 +6554,6 @@ msgstr "" " で `rand` クレート用に生成されたドキュメントを受講者に" "示します。" -#: src/std-types/option.md -msgid "Option" -msgstr "Option" - #: src/std-types/option.md msgid "" "We have already seen some use of `Option`. It stores either a value of " @@ -6680,34 +6623,30 @@ msgstr "" "ということです。" #: src/std-types/result.md -msgid "Result" -msgstr "Result" - -#: src/std-types/result.md +#, fuzzy msgid "" "`Result` is similar to `Option`, but indicates the success or failure of an " -"operation, each with a different type. This is similar to the `Res` defined " -"in the expression exercise, but generic: `Result` where `T` is used in " -"the `Ok` variant and `E` appears in the `Err` variant." +"operation, each with a different enum variant. It is generic: `Result` " +"where `T` is used in the `Ok` variant and `E` appears in the `Err` variant." msgstr "" "`Result` は `Option` に似ていますが、オペレーションの成功または失敗を、それぞ" "れ異なる型で示します。これは式の演習で定義されていた `Res` に似ているものの、" "汎用的で、`Result` の形式を取ります（`T` は `Ok` バリアントで使用され、" "`E` は `Err` バリアントで使用されます）。" -#: src/std-types/result.md +#: src/std-types/result.md src/error-handling/result.md msgid "\"diary.txt\"" msgstr "\"diary.txt\"" -#: src/std-types/result.md +#: src/std-types/result.md src/error-handling/result.md msgid "\"Dear diary: {contents} ({bytes} bytes)\"" msgstr "\"Dear diary: {contents} ({bytes} bytes)\"" -#: src/std-types/result.md +#: src/std-types/result.md src/error-handling/result.md msgid "\"Could not read file content\"" msgstr "\"Could not read file content\"" -#: src/std-types/result.md +#: src/std-types/result.md src/error-handling/result.md msgid "\"The diary could not be opened: {err}\"" msgstr "\"The diary could not be opened: {err}\"" @@ -6734,26 +6673,24 @@ msgstr "" "つ便利なメソッドや関数が多数含まれています。" #: src/std-types/result.md +#, fuzzy msgid "" "`Result` is the standard type to implement error handling as we will see on " -"Day 3." +"Day 4." msgstr "`Result` は、3 日目で説明するエラー処理を実装する標準型です。" #: src/std-types/string.md -msgid "String" -msgstr "文字列（String）" - -#: src/std-types/string.md +#, fuzzy msgid "" -"[`String`](https://doc.rust-lang.org/std/string/struct.String.html) is the " -"standard heap-allocated growable UTF-8 string buffer:" +"[`String`](https://doc.rust-lang.org/std/string/struct.String.html) is a " +"growable UTF-8 encoded string:" msgstr "" "[`String`](https://doc.rust-lang.org/std/string/struct.String.html) は、標準" "的なヒープ割り当ての拡張可能な UTF-8 文字列バッファです。" #: src/std-types/string.md src/std-traits/read-and-write.md #: src/memory-management/review.md src/testing/unit-tests.md -#: src/concurrency/scoped-threads.md +#: src/concurrency/threads/scoped.md msgid "\"Hello\"" msgstr "\"Hello\"" @@ -6881,6 +6818,15 @@ msgstr "" "部分文字列には `s3[0..4]` を使用します。このスライスは、文字境界にある場合と" "ない場合があります。" +#: src/std-types/string.md +msgid "" +"Many types can be converted to a string with the [`to_string`](https://doc." +"rust-lang.org/std/string/trait.ToString.html#tymethod.to_string) method. " +"This trait is automatically implemented for all types that implement " +"`Display`, so anything that can be formatted can also be converted to a " +"string." +msgstr "" + #: src/std-types/vec.md msgid "" "[`Vec`](https://doc.rust-lang.org/std/vec/struct.Vec.html) is the standard " @@ -7160,41 +7106,25 @@ msgstr "\"orange\"" msgid "\"got {} apples\"" msgstr "\"got {} apples\"" -#: src/std-traits.md -msgid "[Comparisons](./std-traits/comparisons.md) (10 minutes)" -msgstr "[比較](./std-lets/comparisons.md)（10 分）" - -#: src/std-traits.md -msgid "[Operators](./std-traits/operators.md) (10 minutes)" -msgstr "[演算子](./std-train/operators.md)（10 分）" - -#: src/std-traits.md -msgid "[From and Into](./std-traits/from-and-into.md) (10 minutes)" -msgstr "[From と Into](./std-lets/from-and-into.md)（10 分）" - -#: src/std-traits.md -msgid "[Casting](./std-traits/casting.md) (5 minutes)" -msgstr "[キャスト](./std-train/casting.md)（5 分）" - -#: src/std-traits.md -msgid "[Read and Write](./std-traits/read-and-write.md) (10 minutes)" -msgstr "[読み取りと書き込み](./std-train/read-and-write.md)（10 分）" - -#: src/std-traits.md -msgid "[Default, struct update syntax](./std-traits/default.md) (5 minutes)" -msgstr "[Default、構造体更新記法](./std-lets/default.md)（5 分）" +#: src/std-traits.md src/concurrency/sync-exercises.md +#: src/concurrency/async-exercises.md +#, fuzzy +msgid "This segment should take about 1 hour and 10 minutes. It contains:" +msgstr "このセグメントの所要時間は約 1 時間 10 分です" #: src/std-traits.md -msgid "[Closures](./std-traits/closures.md) (20 minutes)" -msgstr "[クロージャ](./std-lets/closures.md)（20 分）" +msgid "From and Into" +msgstr "FromとInto" #: src/std-traits.md -msgid "[Exercise: ROT13](./std-traits/exercise.md) (30 minutes)" -msgstr "[演習: ROT13](./std-train/exercise.md)（30 分）" +#, fuzzy +msgid "Read and Write" +msgstr "`Read` と `Write`" #: src/std-traits.md -msgid "This segment should take about 1 hour and 40 minutes" -msgstr "このセグメントの所要時間は約 1 時間 40 分です" +#, fuzzy +msgid "Default, struct update syntax" +msgstr "`Default`、構造体更新記法" #: src/std-traits.md msgid "" @@ -7325,11 +7255,21 @@ msgstr "" "2 種類の型に対して `Add` を実装できます。たとえば、`impl Add<(i32, i32)> for " "Point` は `Point` にタプルを追加します。" +#: src/std-traits/operators.md +msgid "" +"The `Not` trait (`!` operator) is notable because it does not \"boolify\" " +"like the same operator in C-family languages; instead, for integer types it " +"negates each bit of the number, which arithmetically is equivalent to " +"subtracting it from -1: `!5 == -6`." +msgstr "" + #: src/std-traits/from-and-into.md +#, fuzzy msgid "" "Types implement [`From`](https://doc.rust-lang.org/std/convert/trait.From." "html) and [`Into`](https://doc.rust-lang.org/std/convert/trait.Into.html) to " -"facilitate type conversions:" +"facilitate type conversions. Unlike `as`, these traits correspond to " +"lossless, infallible conversions." msgstr "" "型は、型変換を容易にする [`From`](https://doc.rust-lang.org/std/convert/" "trait.From.html) と [`Into`](https://doc.rust-lang.org/std/convert/trait." @@ -7482,10 +7422,6 @@ msgstr "" msgid "\"\\n\"" msgstr "\"\\n\"" -#: src/std-traits/read-and-write.md src/slices-and-lifetimes/str.md -msgid "\"World\"" -msgstr "\"World\"" - #: src/std-traits/read-and-write.md msgid "\"Logged: {:?}\"" msgstr "\"Logged: {:?}\"" @@ -7518,8 +7454,8 @@ msgstr "\"Y is set!\"" msgid "\"{almost_default_struct:#?}\"" msgstr "\"{almost_default_struct:#?}\"" -#: src/std-traits/default.md src/slices-and-lifetimes/exercise.md -#: src/slices-and-lifetimes/solution.md +#: src/std-traits/default.md src/lifetimes/exercise.md +#: src/lifetimes/solution.md msgid "\"{:#?}\"" msgstr "\"{:#?}\"" @@ -7668,13 +7604,18 @@ msgstr "" "デフォルトでは、可能であれば、クロージャは参照によってキャプチャします。" "`move` キーワードを使用すると、クロージャは値によってキャプチャします。" +#: src/std-traits/closures.md src/smart-pointers/trait-objects.md +msgid "\"{} {}\"" +msgstr "\"{} {}\"" + #: src/std-traits/closures.md msgid "\"Hi\"" msgstr "\"Hi\"" #: src/std-traits/closures.md -msgid "\"there\"" -msgstr "\"there\"" +#, fuzzy +msgid "\"Greg\"" +msgstr "\"Greetings\"" #: src/std-traits/exercise.md msgid "" @@ -7733,56 +7674,20 @@ msgid "Smart pointers: standard library pointer types." msgstr "スマートポインタ: 標準ライブラリのポインタ型。" #: src/welcome-day-3.md -msgid "[Welcome](./welcome-day-3.md) (3 minutes)" -msgstr "[ようこそ](./welcome-day-3.md)（3 分）" - -#: src/welcome-day-3.md -msgid "[Memory Management](./memory-management.md) (1 hour and 10 minutes)" -msgstr "[メモリ管理](./memory-management.md)（1 時間 10 分）" - -#: src/welcome-day-3.md -msgid "[Smart Pointers](./smart-pointers.md) (45 minutes)" -msgstr "[スマート ポインタ](./smart-pointers.md)（45 分）" - -#: src/welcome-day-3.md -msgid "" -"Including 10 minute breaks, this session should take about 2 hours and 15 " -"minutes" -msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 2 時間 15 分です。" - -#: src/memory-management.md -msgid "[Review of Program Memory](./memory-management/review.md) (5 minutes)" -msgstr "[プログラム メモリの復習](./memory-management/review.md)（5 分）" - -#: src/memory-management.md +#, fuzzy msgid "" -"[Approaches to Memory Management](./memory-management/approaches.md) (10 " -"minutes)" -msgstr "[メモリ管理の方法](./memory-management/approaches.md)（10 分）" - -#: src/memory-management.md -msgid "[Ownership](./memory-management/ownership.md) (5 minutes)" -msgstr "[所有権](./memory-management/ownership.md)（5 分）" - -#: src/memory-management.md -msgid "[Move Semantics](./memory-management/move.md) (10 minutes)" -msgstr "[ムーブ セマンティクス](./memory-management/move.md)（10 分）" - -#: src/memory-management.md -msgid "[Clone](./memory-management/clone.md) (2 minutes)" -msgstr "[Clone](./memory-management/clone.md)（2 分）" - -#: src/memory-management.md -msgid "[Copy Types](./memory-management/copy-types.md) (5 minutes)" -msgstr "[Copy 型](./memory-management/copy-types.md)（5 分）" +"Including 10 minute breaks, this session should take about 2 hours and 20 " +"minutes. It contains:" +msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 2 時間 20 分です。" -#: src/memory-management.md -msgid "[Drop](./memory-management/drop.md) (10 minutes)" -msgstr "[Drop](./memory-management/drop.md)（10 分）" +#: src/memory-management.md src/memory-management/clone.md +msgid "Clone" +msgstr "複製" #: src/memory-management.md -msgid "[Exercise: Builder Type](./memory-management/exercise.md) (20 minutes)" -msgstr "[演習: ビルダー型](./memory-management/exercise.md)（20 分）" +#, fuzzy +msgid "Drop" +msgstr "`Drop`" #: src/memory-management/review.md msgid "Programs allocate memory in two ways:" @@ -7880,8 +7785,8 @@ msgstr "" " // 発生する可能性があります。\n" #: src/memory-management/review.md -msgid "\"ptr = {ptr:#x}, len = {len}, capacity = {capacity}\"" -msgstr "\"ptr = {ptr:#x}, len = {len}, capacity = {capacity}\"" +msgid "\"capacity = {capacity}, ptr = {ptr:#x}, len = {len}\"" +msgstr "" #: src/memory-management/approaches.md msgid "Traditionally, languages have fallen into two broad categories:" @@ -7922,8 +7827,8 @@ msgstr "" "ランタイム システムにより、メモリは参照できなくなるまで解放されません。" #: src/memory-management/approaches.md -msgid "" -"Typically implemented with reference counting, garbage collection, or RAII." +#, fuzzy +msgid "Typically implemented with reference counting or garbage collection." msgstr "" "通常、参照カウント、ガベージ コレクション、または RAII を使用して実装されま" "す。" @@ -8039,14 +7944,10 @@ msgstr "" msgid "An assignment will transfer _ownership_ between variables:" msgstr "代入すると、変数間で _所有権_ が移動します。" -#: src/memory-management/move.md +#: src/memory-management/move.md src/concurrency/async-control-flow/select.md msgid "\"Hello!\"" msgstr "\"Hello!\"" -#: src/memory-management/move.md src/slices-and-lifetimes/str.md -msgid "\"s2: {s2}\"" -msgstr "\"s2: {s2}\"" - #: src/memory-management/move.md msgid "// println!(\"s1: {s1}\");\n" msgstr "// println!(\"s1: {s1}\");\n" @@ -8073,23 +7974,24 @@ msgid "After move to `s2`:" msgstr "`s2` に移動した後:" #: src/memory-management/move.md +#, fuzzy msgid "" "```bob\n" " Stack Heap\n" -".- - - - - - - - - - - - - -. .- - - - - - - - - - - - - -.\n" -": : : :\n" -": s1 \"(inaccessible)\" : : :\n" -": +-----------+-------+ : : +----+----+----+----+ :\n" -": | ptr | o---+---+--+--+-->| R | u | s | t | :\n" -": | len | 4 | : | : +----+----+----+----+ :\n" -": | capacity | 4 | : | : :\n" -": +-----------+-------+ : | : :\n" -": : | `- - - - - - - - - - - - - -'\n" +".- - - - - - - - - - - - - -. .- - - - - - - - - - - - - - - - - - -.\n" +": : : :\n" +": s1 \"(inaccessible)\" : : :\n" +": +-----------+-------+ : : +----+----+----+----+----+----+ :\n" +": | ptr | o---+---+--+--+-->| H | e | l | l | o | ! | :\n" +": | len | 6 | : | : +----+----+----+----+----+----+ :\n" +": | capacity | 6 | : | : :\n" +": +-----------+-------+ : | : :\n" +": : | `- - - - - - - - - - - - - - - - - - -'\n" ": s2 : |\n" ": +-----------+-------+ : |\n" ": | ptr | o---+---+--'\n" -": | len | 4 | :\n" -": | capacity | 4 | :\n" +": | len | 6 | :\n" +": | capacity | 6 | :\n" ": +-----------+-------+ :\n" ": :\n" "`- - - - - - - - - - - - - -'\n" @@ -8124,11 +8026,12 @@ msgstr "" "次の例のように、関数に値を渡すと、その値は関数パラメータに代入されます。これ" "により、所有権が移動します。" -#: src/memory-management/move.md +#: src/memory-management/move.md src/memory-management/clone.md msgid "\"Hello {name}\"" msgstr "\"Hello {name}\"" -#: src/memory-management/move.md src/android/interoperability/java.md +#: src/memory-management/move.md src/memory-management/clone.md +#: src/android/interoperability/java.md msgid "\"Alice\"" msgstr "\"Alice\"" @@ -8276,10 +8179,6 @@ msgstr "" "Rust とは異なり、C++ の `=` は、コピーまたは移動される型によって決定される任" "意のコードを実行できます。" -#: src/memory-management/clone.md -msgid "Clone" -msgstr "複製" - #: src/memory-management/clone.md msgid "" "Sometimes you _want_ to make a copy of a value. The `Clone` trait " @@ -8287,10 +8186,10 @@ msgid "" msgstr "値のコピーを作成したい場合は、`Clone` トレイトを使用できます。" #: src/memory-management/clone.md +#, fuzzy msgid "" "The idea of `Clone` is to make it easy to spot where heap allocations are " -"occurring. Look for `.clone()` and a few others like `Vec::new` or `Box::" -"new`." +"occurring. Look for `.clone()` and a few others like `vec!` or `Box::new`." msgstr "" "`Clone` はヒープ割当が起きる場所を見つけやすくすることを目的としたものです。" "`.clone()` のほか、`Vec::new` や `Box::new` などを探してください。" @@ -8303,6 +8202,18 @@ msgstr "" "借用チェッカーが通らない場合に「とりあえずクローンを作成して切り抜けておい" "て」、あとからクローンのないコードへの最適化を試みるのもよくあることです。" +#: src/memory-management/clone.md +msgid "" +"`clone` generally performs a deep copy of the value, meaning that if you e." +"g. clone an array, all of the elements of the array are cloned as well." +msgstr "" + +#: src/memory-management/clone.md +msgid "" +"The behavior for `clone` is user-defined, so it can perform custom cloning " +"logic if needed." +msgstr "" + #: src/memory-management/copy-types.md msgid "" "While move semantics are the default, certain types are copied by default:" @@ -8383,7 +8294,15 @@ msgstr "" msgid "Show that it works if you clone `p1` instead." msgstr "代わりに `p1` のクローンを作成すれば解決できることを示します。" -#: src/memory-management/drop.mdmd +#: src/memory-management/copy-types.md +msgid "" +"Shared references are `Copy`/`Clone`, mutable references are not. This is " +"because rust requires that mutable references be exclusive, so while it's " +"valid to make a copy of a shared reference, creating a copy of a mutable " +"reference would violate Rust's borrowing rules." +msgstr "" + +#: src/memory-management/drop.md msgid "The `Drop` Trait" msgstr "`Drop` トレイト" @@ -8399,12 +8318,12 @@ msgstr "" msgid "\"Dropping {}\"" msgstr "\"Dropping {}\"" -#: src/memory-management/drop.md src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md +#: src/memory-management/drop.md src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md msgid "\"a\"" msgstr "\"a\"" -#: src/memory-management/drop.md src/testing/googletest.md +#: src/memory-management/drop.md src/android/testing/googletest.md msgid "\"b\"" msgstr "\"b\"" @@ -8600,20 +8519,13 @@ msgid "\"0.1\"" msgstr "\"0.1\"" #: src/smart-pointers.md -msgid "[Box" -msgstr "[Box" - -#: src/smart-pointers.md -msgid "](./smart-pointers/box.md) (10 minutes)" -msgstr "](./smart-pointers/box.md)（10 分）" - -#: src/smart-pointers.md -msgid "[Rc](./smart-pointers/rc.md) (5 minutes)" -msgstr "[Rc](./smart-pointers/rc.md)（5 分）" +#, fuzzy +msgid "Box" +msgstr "`Box`" #: src/smart-pointers.md -msgid "[Exercise: Binary Tree](./smart-pointers/exercise.md) (30 minutes)" -msgstr "[演習: バイナリツリー](./smart-pointers/exercise.md)（30 分）" +msgid "Rc" +msgstr "Rc" #: src/smart-pointers/box.md msgid "" @@ -8638,8 +8550,10 @@ msgstr "" "html#more-on-deref-coercion)ことができます。" #: src/smart-pointers/box.md +#, fuzzy msgid "" -"Recursive data types or data types with dynamic sizes need to use a `Box`:" +"Recursive data types or data types with dynamic sizes cannot be stored " +"inline without a pointer indirection, which can be worked around using `Box`:" msgstr "" "再帰データ型、またはサイズが動的なデータ型では、`Box` を使用する必要がありま" "す。" @@ -8745,10 +8659,12 @@ msgstr "" "にヒープ内の List の次の要素を指すだけだけだからです。" #: src/smart-pointers/box.md +#, fuzzy msgid "" -"Remove the `Box` in the List definition and show the compiler error. " -"\"Recursive with indirection\" is a hint you might want to use a Box or " -"reference of some kind, instead of storing a value directly." +"Remove the `Box` in the List definition and show the compiler error. We get " +"the message \"recursive without indirection\", because for data recursion, " +"we have to use indirection, a `Box` or reference of some kind, instead of " +"storing the value directly." msgstr "" "List 定義の `Box` を削除して、コンパイラ エラーを表示します。\"Recursive " "with indirection\" は、値を直接保持するのではなく、Boxや何らかの参照を使用し" @@ -8760,39 +8676,40 @@ msgstr "Niche最適化" #: src/smart-pointers/box.md msgid "" -"A `Box` cannot be empty, so the pointer is always valid and non-`null`. This " -"allows the compiler to optimize the memory layout:" +"Though `Box` looks like `std::unique_ptr` in C++, it cannot be empty/null. " +"This makes `Box` one of the types that allow the compiler to optimize " +"storage of some enums." msgstr "" -"`Box` を空にすることはできないため、ポインタは常に有効かつ非 `null` になりま" -"す。これにより、コンパイラがメモリ レイアウトを最適化できます。" #: src/smart-pointers/box.md msgid "" -"```bob\n" -" Stack Heap\n" -".- - - - - - - - - - - - - - . .- - - - - - - - - - - - - -.\n" -": : : :\n" -": list : : :\n" -": +---------+----+----+ : : +---------+----+----+ :\n" -": | Element | 1 | o--+----+-----+--->| Element | 2 | // | :\n" -": +---------+----+----+ : : +---------+----+----+ :\n" -": : : :\n" -": : : :\n" -"'- - - - - - - - - - - - - - ' '- - - - - - - - - - - - - -'\n" -"```" +"For example, `Option>` has the same size, as just `Box`, because " +"compiler uses NULL-value to discriminate variants instead of using explicit " +"tag ([\"Null Pointer Optimization\"](https://doc.rust-lang.org/std/option/" +"#representation)):" +msgstr "" + +#: src/smart-pointers/box.md +msgid "\"Just box\"" msgstr "" -"```bob\n" -" Stack Heap\n" -".- - - - - - - - - - - - - - . .- - - - - - - - - - - - - -.\n" -": : : :\n" -": list : : :\n" -": +---------+----+----+ : : +---------+----+----+ :\n" -": | Element | 1 | o--+----+-----+--->| Element | 2 | // | :\n" -": +---------+----+----+ : : +---------+----+----+ :\n" -": : : :\n" -": : : :\n" -"'- - - - - - - - - - - - - - ' '- - - - - - - - - - - - - -'\n" -"```" + +#: src/smart-pointers/box.md +#, fuzzy +msgid "\"Optional box\"" +msgstr "Option" + +#: src/smart-pointers/box.md +msgid "\"Size of just_box: {}\"" +msgstr "" + +#: src/smart-pointers/box.md +msgid "\"Size of optional_box: {}\"" +msgstr "" + +#: src/smart-pointers/box.md +#, fuzzy +msgid "\"Size of none: {}\"" +msgstr "\"before: {a}\"" #: src/smart-pointers/rc.md msgid "" @@ -8813,8 +8730,9 @@ msgid "\"b: {b}\"" msgstr "\"b: {b}\"" #: src/smart-pointers/rc.md +#, fuzzy msgid "" -"See [`Arc`](../concurrency/shared_state/arc.md) and [`Mutex`](https://doc." +"See [`Arc`](../concurrency/shared-state/arc.md) and [`Mutex`](https://doc." "rust-lang.org/std/sync/struct.Mutex.html) if you are in a multi-threaded " "context." msgstr "" @@ -8872,88 +8790,246 @@ msgstr "" "れるサイクルを作成するための弱参照カウント _(weakly reference-counted)_ オブ" "ジェクトを提供します。" -#: src/smart-pointers/exercise.md +#: src/smart-pointers/trait-objects.md msgid "" -"A binary tree is a tree-type data structure where every node has two " -"children (left and right). We will create a tree where each node stores a " -"value. For a given node N, all nodes in a N's left subtree contain smaller " -"values, and all nodes in N's right subtree will contain larger values." +"We previously saw how trait objects can be used with references, e.g `&dyn " +"Pet`. However, we can also use trait objects with smart pointers like `Box` " +"to create an owned trait object: `Box`." msgstr "" -"バイナリツリーは、すべてのノードに 2 つの子（左と右）があるツリー型のデータ構" -"造です。ここでは、各ノードが値を格納するツリーを作成します。ある特定のノード " -"N について、N の左側のサブツリー内のすべてのノードにはより小さい値が含まれ、" -"N の右側のサブツリー内のすべてのノードにはより大きい値が含まれます。" - -#: src/smart-pointers/exercise.md -msgid "Implement the following types, so that the given tests pass." -msgstr "次の型を実装して、指定されたテストが通るようにします。" - -#: src/smart-pointers/exercise.md -msgid "" -"Extra Credit: implement an iterator over a binary tree that returns the " -"values in order." -msgstr "追加の実習: バイナリツリーに値を順番に返すイテレータを実装します。" - -#: src/smart-pointers/exercise.md src/smart-pointers/solution.md -msgid "/// A node in the binary tree.\n" -msgstr "/// バイナリツリーのノード。\n" -#: src/smart-pointers/exercise.md src/smart-pointers/solution.md -msgid "/// A possibly-empty subtree.\n" -msgstr "/// 空の可能性のあるサブツリー。\n" +#: src/smart-pointers/trait-objects.md +msgid "Memory layout after allocating `pets`:" +msgstr "`pets`を割り当てた後のメモリレイアウト：" -#: src/smart-pointers/exercise.md src/smart-pointers/solution.md +#: src/smart-pointers/trait-objects.md +#, fuzzy msgid "" -"/// A container storing a set of values, using a binary tree.\n" -"///\n" -"/// If the same value is added multiple times, it is only stored once.\n" -msgstr "" -"/// バイナリツリーを使用して一連の値を格納するコンテナ。\n" -"///\n" -"/// 同じ値が複数回追加された場合、その値は 1 回だけ格納される。\n" - -#: src/smart-pointers/exercise.md -msgid "// Implement `new`, `insert`, `len`, and `has`.\n" -msgstr "// `new`、`insert`、`len`、`has` を実装します。\n" - -#: src/smart-pointers/exercise.md src/smart-pointers/solution.md -msgid "// not a unique item\n" -msgstr "// 固有のアイテムではない\n" - -#: src/smart-pointers/solution.md src/testing/googletest.md -msgid "\"bar\"" -msgstr "\"bar\"" - -#: src/welcome-day-3-afternoon.md -msgid "[Borrowing](./borrowing.md) (1 hour)" -msgstr "[借用](./borrowing.md)（1 時間）" +"```bob\n" +" Stack Heap\n" +".- - - - - - - - - - - - - -. .- - - - - - - - - - - - - - - - - - - - - " +"- -.\n" +": : : :\n" +": \"pets: Vec\" : : \"data: Cat\" +----+----+----" +"+----+ :\n" +": +-----------+-------+ : : +-------+-------+ | F | i | d | " +"o | :\n" +": | ptr | o---+---+--. : | lives | 9 | +----+----+----" +"+----+ :\n" +": | len | 2 | : | : +-------+-------+ " +"^ :\n" +": | capacity | 2 | : | : ^ " +"| :\n" +": +-----------+-------+ : | : | " +"'-------. :\n" +": : | : | data:" +"\"Dog\"| :\n" +": : | : | +-------+--|-------" +"+ :\n" +"`- - - - - - - - - - - - - -' | : +---|-+-----+ | name | o, 4, 4 " +"| :\n" +" `--+-->| o o | o o-|----->| age | 5 " +"| :\n" +" : +-|---+-|---+ +-------+----------" +"+ :\n" +" : | " +"| :\n" +" `- - -| - - |- - - - - - - - - - - - - - - " +"- -'\n" +" | |\n" +" | | " +"\"Program text\"\n" +" .- - -| - - |- - - - - - - - - - - - - - - " +"- -.\n" +" : | | " +"vtable :\n" +" : | | +----------------------" +"+ :\n" +" : | `----->| \"::" +"talk\" | :\n" +" : | +----------------------" +"+ :\n" +" : | " +"vtable :\n" +" : | +----------------------" +"+ :\n" +" : '----------->| \"::" +"talk\" | :\n" +" : +----------------------" +"+ :\n" +" : :\n" +" '- - - - - - - - - - - - - - - - - - - - - " +"- -'\n" +"```" +msgstr "" +"```bob\n" +" スタック ヒープ\n" +".- - - - - - - - - - - - - -. .- - - - - - - - - - - - - - - - - - - - - " +"- -.\n" +": : : :\n" +": pets : : +----+----+----+----" +"+ :\n" +": +-----------+-------+ : : +-----+-----+ .->| F | i | d | o " +"| :\n" +": | ptr | o---+---+-----+-->| o o | o o | | +----+----+----+----" +"+ :\n" +": | len | 2 | : : +-|-|-+-|-|-+ " +"`---------. :\n" +": | capacity | 2 | : : | | | | data " +"| :\n" +": +-----------+-------+ : : | | | | +-------+--|-------" +"+ :\n" +": : : | | | '-->| name | o, 4, 4 " +"| :\n" +": : : | | | | age | 5 " +"| :\n" +"`- - - - - - - - - - - - - -' : | | | +-------+----------" +"+ :\n" +" : | | " +"| :\n" +" : | | | " +"vtable :\n" +" : | | | +----------------------" +"+ :\n" +" : | | '---->| \"::talk\" " +"| :\n" +" : | | +----------------------" +"+ :\n" +" : | " +"| :\n" +" : | | " +"data :\n" +" : | | +-------+-------" +"+ :\n" +" : | '-->| lives | 9 " +"| :\n" +" : | +-------+-------" +"+ :\n" +" : " +"| :\n" +" : | " +"vtable :\n" +" : | +----------------------" +"+ :\n" +" : '---->| \"::talk\" " +"| :\n" +" : +----------------------" +"+ :\n" +" : :\n" +" '- - - - - - - - - - - - - - - - - - - - - " +"- -'\n" +"```" -#: src/welcome-day-3-afternoon.md +#: src/smart-pointers/trait-objects.md +msgid "" +"Types that implement a given trait may be of different sizes. This makes it " +"impossible to have things like `Vec` in the example above." +msgstr "" +"同じトレイトを実装する型であってもそのサイズは異なることがあります。そのた" +"め、上の例でVecと書くことはできません。" + +#: src/smart-pointers/trait-objects.md msgid "" -"[Slices and Lifetimes](./slices-and-lifetimes.md) (1 hour and 10 minutes)" -msgstr "[スライスとライフタイム](./slices-and-lifetimes.md)（1 時間 10 分）" +"`dyn Pet` is a way to tell the compiler about a dynamically sized type that " +"implements `Pet`." +msgstr "" +"`dyn Pet` はコンパイラに、この型が`Pet`トレイトを実装する動的なサイズの型であ" +"ることを伝えます。" -#: src/welcome-day-3-afternoon.md +#: src/smart-pointers/trait-objects.md msgid "" -"Including 10 minute breaks, this session should take about 2 hours and 20 " -"minutes" -msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 2 時間 20 分です。" +"In the example, `pets` is allocated on the stack and the vector data is on " +"the heap. The two vector elements are _fat pointers_:" +msgstr "" +"上の例では `pets` はスタックに確保され、ベクターのデータはヒープ上にありま" +"す。二つのベクターの要素は _ファットポインタ_ です：" + +#: src/smart-pointers/trait-objects.md +msgid "" +"A fat pointer is a double-width pointer. It has two components: a pointer to " +"the actual object and a pointer to the [virtual method table](https://en." +"wikipedia.org/wiki/Virtual_method_table) (vtable) for the `Pet` " +"implementation of that particular object." +msgstr "" +"ファットポインタはdouble-widthポインタです。これは二つの要素からなります：実" +"際のオブジェクトへのポインタと、そのオブジェクトの`Pet`の実装のための[仮想関" +"数テーブル](https://ja.wikipedia.org/wiki/" +"%E4%BB%AE%E6%83%B3%E9%96%A2%E6%95%B0%E3%83%86%E3%83%BC%E3%83%96%E3%83%AB) " +"(vtable)です。" + +#: src/smart-pointers/trait-objects.md +msgid "" +"The data for the `Dog` named Fido is the `name` and `age` fields. The `Cat` " +"has a `lives` field." +msgstr "" +"\"Fido\"と名付けられた`Dog`のデータは`name` と `age` のフィールドに対応しま" +"す。（訳注: \"Fido\"とはよくある犬の愛称で、日本語でいう「ポチ」のような名前" +"です。）例の`Cat`には`lives` フィールドがあります。（訳注: ここで`Cat`が" +"`lives`というフィールドを持ち、9で初期化しているのは\"A cat has nine lives\" " +"—猫は９つの命を持つ—ということわざに由来します。）" + +#: src/smart-pointers/trait-objects.md +msgid "Compare these outputs in the above example:" +msgstr "上の例において、下のコードによる出力結果を比べてみましょう：" + +#: src/smart-pointers/exercise.md +msgid "" +"A binary tree is a tree-type data structure where every node has two " +"children (left and right). We will create a tree where each node stores a " +"value. For a given node N, all nodes in a N's left subtree contain smaller " +"values, and all nodes in N's right subtree will contain larger values." +msgstr "" +"バイナリツリーは、すべてのノードに 2 つの子（左と右）があるツリー型のデータ構" +"造です。ここでは、各ノードが値を格納するツリーを作成します。ある特定のノード " +"N について、N の左側のサブツリー内のすべてのノードにはより小さい値が含まれ、" +"N の右側のサブツリー内のすべてのノードにはより大きい値が含まれます。" + +#: src/smart-pointers/exercise.md +msgid "Implement the following types, so that the given tests pass." +msgstr "次の型を実装して、指定されたテストが通るようにします。" + +#: src/smart-pointers/exercise.md +msgid "" +"Extra Credit: implement an iterator over a binary tree that returns the " +"values in order." +msgstr "追加の実習: バイナリツリーに値を順番に返すイテレータを実装します。" + +#: src/smart-pointers/exercise.md src/smart-pointers/solution.md +msgid "/// A node in the binary tree.\n" +msgstr "/// バイナリツリーのノード。\n" + +#: src/smart-pointers/exercise.md src/smart-pointers/solution.md +msgid "/// A possibly-empty subtree.\n" +msgstr "/// 空の可能性のあるサブツリー。\n" + +#: src/smart-pointers/exercise.md src/smart-pointers/solution.md +msgid "" +"/// A container storing a set of values, using a binary tree.\n" +"///\n" +"/// If the same value is added multiple times, it is only stored once.\n" +msgstr "" +"/// バイナリツリーを使用して一連の値を格納するコンテナ。\n" +"///\n" +"/// 同じ値が複数回追加された場合、その値は 1 回だけ格納される。\n" -#: src/borrowing.md -msgid "[Borrowing a Value](./borrowing/shared.md) (10 minutes)" -msgstr "[値の借用](./borrowing/shared.md)（10 分）" +#: src/smart-pointers/exercise.md +#, fuzzy +msgid "// Implement `new`, `insert`, `len`, and `has` for `Subtree`.\n" +msgstr "// `new`、`insert`、`len`、`has` を実装します。\n" -#: src/borrowing.md -msgid "[Borrow Checking](./borrowing/borrowck.md) (10 minutes)" -msgstr "[借用チェック](./borrowing/borrowck.md)（10 分）" +#: src/smart-pointers/exercise.md src/smart-pointers/solution.md +msgid "// not a unique item\n" +msgstr "// 固有のアイテムではない\n" -#: src/borrowing.md -msgid "[Interior Mutability](./borrowing/interior-mutability.md) (10 minutes)" -msgstr "[内部可変性](./borrowing/interior-mutability.md)（10 分）" +#: src/smart-pointers/solution.md src/android/testing/googletest.md +msgid "\"bar\"" +msgstr "\"bar\"" -#: src/borrowing.md -msgid "[Exercise: Health Statistics](./borrowing/exercise.md) (30 minutes)" -msgstr "[演習: 健康に関する統計情報](./borrowing/exercise.md)（30 分）" +#: src/welcome-day-3-afternoon.md +#, fuzzy +msgid "" +"Including 10 minute breaks, this session should take about 1 hour and 55 " +"minutes. It contains:" +msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 2 時間 55 分です。" #: src/borrowing/shared.md msgid "" @@ -8980,14 +9056,17 @@ msgstr "" "関数の引数と戻り値も含めています。" #: src/borrowing/shared.md -msgid "Notes on stack returns:" +#, fuzzy +msgid "Notes on stack returns and inlining:" msgstr "スタックの戻り値に関する注意事項:" #: src/borrowing/shared.md +#, fuzzy msgid "" "Demonstrate that the return from `add` is cheap because the compiler can " -"eliminate the copy operation. Change the above code to print stack addresses " -"and run it on the [Playground](https://play.rust-lang.org/?" +"eliminate the copy operation, by inlining the call to add into main. Change " +"the above code to print stack addresses and run it on the [Playground]" +"(https://play.rust-lang.org/?" "version=stable&mode=release&edition=2021&gist=0cb13be1c05d7e3446686ad9947c4671) " "or look at the assembly in [Godbolt](https://rust.godbolt.org/). In the " "\"DEBUG\" optimization level, the addresses should change, while they stay " @@ -9002,20 +9081,18 @@ msgstr "" "場合はアドレスが変更されません。" #: src/borrowing/shared.md -msgid "The Rust compiler can do return value optimization (RVO)." -msgstr "Rust コンパイラは戻り値の最適化（RVO）を行うことができます。" +msgid "" +"The Rust compiler can do automatic inlining, that can be disabled on a " +"function level with `#[inline(never)]`." +msgstr "" #: src/borrowing/shared.md msgid "" -"In C++, copy elision has to be defined in the language specification because " -"constructors can have side effects. In Rust, this is not an issue at all. If " -"RVO did not happen, Rust will always perform a simple and efficient `memcpy` " -"copy." +"Once disabled, the printed address will change on all optimization levels. " +"Looking at Godbolt or Playground, one can see that in this case, the return " +"of the value depends on the ABI, e.g. on amd64 the two i32 that is making up " +"the point will be returned in 2 registers (eax and edx)." msgstr "" -"C++ では、コンストラクタが副作用をもたらす可能性があるため、言語仕様でコピー" -"省略を定義する必要があります。Rust では、これはまったく問題になりません。RVO " -"が行われなかった場合でも、Rust は常にシンプルで効率的な `memcpy` コピーを実行" -"します。" #: src/borrowing/borrowck.md msgid "" @@ -9091,6 +9168,28 @@ msgstr "" "よっては借用チェッカーがコードを正しく理解できず、「借用チェッカーとの戦い」" "に発展することが多くあります。" +#: src/borrowing/examples.md +msgid "" +"As a concrete example of how these borrowing rules prevent memory errors, " +"consider the case of modifying a collection while there are references to " +"its elements:" +msgstr "" + +#: src/borrowing/examples.md +msgid "\"{elem}\"" +msgstr "" + +#: src/borrowing/examples.md +msgid "Similarly, consider the case of iterator invalidation:" +msgstr "" + +#: src/borrowing/examples.md +msgid "" +"In both of these cases, modifying the collection by pushing new elements " +"into it can potentially invalidate existing references to the collection's " +"elements if the collection has to reallocate." +msgstr "" + #: src/borrowing/interior-mutability.md msgid "" "In some situations, it's necessary to modify data behind a shared (read-" @@ -9111,30 +9210,59 @@ msgstr "" "す。標準ライブラリには、これを安全に行うための方法がいくつか用意されており、" "通常はランタイム チェックを実行することで安全性を確保します。" +#: src/borrowing/interior-mutability.md +msgid "`Cell`" +msgstr "`Cell`" + +#: src/borrowing/interior-mutability.md +#, fuzzy +msgid "" +"`Cell` wraps a value and allows getting or setting the value using only a " +"shared reference to the `Cell`. However, it does not allow any references to " +"the inner value. Since there are no references, borrowing rules cannot be " +"broken." +msgstr "" +"`Cell` は、値をラップし、`Cell` の共有参照を通してでもその値を取得または設定" +"可能にしています。ただし、その内包する値への参照は許していません。" + +#: src/borrowing/interior-mutability.md +msgid "// Note that `cell` is NOT declared as mutable.\n" +msgstr "" + #: src/borrowing/interior-mutability.md msgid "`RefCell`" msgstr "`RefCell`" #: src/borrowing/interior-mutability.md -msgid "\"graph: {root:#?}\"" -msgstr "\"graph: {root:#?}\"" +msgid "" +"`RefCell` allows accessing and mutating a wrapped value by providing " +"alternative types `Ref` and `RefMut` that emulate `&T`/`&mut T` without " +"actually being Rust references." +msgstr "" #: src/borrowing/interior-mutability.md -msgid "\"graph sum: {}\"" -msgstr "\"graph sum: {}\"" +msgid "" +"These types perform dynamic checks using a counter in the `RefCell` to " +"prevent existence of a `RefMut` alongside another `Ref`/`RefMut`." +msgstr "" #: src/borrowing/interior-mutability.md -msgid "`Cell`" -msgstr "`Cell`" +msgid "" +"By implementing `Deref` (and `DerefMut` for `RefMut`), these types allow " +"calling methods on the inner value without allowing references to escape." +msgstr "" #: src/borrowing/interior-mutability.md msgid "" -"`Cell` wraps a value and allows getting or setting the value, even with a " -"shared reference to the `Cell`. However, it does not allow any references to " -"the value. Since there are no references, borrowing rules cannot be broken." +"// This triggers an error at runtime.\n" +" // let other = cell.borrow();\n" +" // println!(\"{}\", *other);\n" msgstr "" -"`Cell` は、値をラップし、`Cell` の共有参照を通してでもその値を取得または設定" -"可能にしています。ただし、その内包する値への参照は許していません。" + +#: src/borrowing/interior-mutability.md +#, fuzzy +msgid "\"{cell:?}\"" +msgstr "\"{:?}\"" #: src/borrowing/interior-mutability.md msgid "" @@ -9159,13 +9287,10 @@ msgstr "" #: src/borrowing/interior-mutability.md msgid "" -"`Rc` only allows shared (read-only) access to its contents, since its " -"purpose is to allow (and count) many references. But we want to modify the " -"value, so we need interior mutability." +"The extra block in the `RefCell` example is to end the borrow created by the " +"call to `borrow_mut` before we print the cell. Trying to print a borrowed " +"`RefCell` just shows the message `\"{borrowed}\"`." msgstr "" -"`Rc` は多くの参照を許可（およびカウント）することを目的としているため、コンテ" -"ンツへの共有（読み取り専用）アクセスのみを許可します。しかし、ここでは値を変" -"更したいので、内部可変性が必要です。" #: src/borrowing/interior-mutability.md msgid "" @@ -9179,22 +9304,10 @@ msgstr "" #: src/borrowing/interior-mutability.md msgid "" -"Demonstrate that reference loops can be created by adding `root` to `subtree." -"children`." -msgstr "" -"`subtree.children` に `root` を追加して参照ループを作成できることを示します。" - -#: src/borrowing/interior-mutability.md -msgid "" -"To demonstrate a runtime panic, add a `fn inc(&mut self)` that increments " -"`self.value` and calls the same method on its children. This will panic in " -"the presence of the reference loop, with `thread 'main' panicked at 'already " -"borrowed: BorrowMutError'`." +"Both `RefCell` and `Cell` are `!Sync`, which means `&RefCell` and `&Cell` " +"can't be passed between threads. This prevents two threads trying to access " +"the cell at once." msgstr "" -"実行時のパニックを示すため、`self.value` をインクリメントしてその子に対して同" -"じメソッドを呼び出す `fn inc(&mut self)` を追加します。これは、参照ループがあ" -"るとパニックとなり、`thread 'main' panicked at 'already borrowed: " -"BorrowMutError'` というエラーが出力されます。" #: src/borrowing/exercise.md msgid "" @@ -9230,7 +9343,8 @@ msgstr "" "doctor\"" #: src/borrowing/exercise.md src/borrowing/solution.md -#: src/android/build-rules/library.md src/android/aidl/client.md +#: src/android/build-rules/library.md +#: src/android/aidl/example-service/client.md msgid "\"Bob\"" msgstr "\"Bob\"" @@ -9238,263 +9352,54 @@ msgstr "\"Bob\"" msgid "\"I'm {} and my age is {}\"" msgstr "\"I'm {} and my age is {}\"" -#: src/slices-and-lifetimes.md -msgid "[Slices: &\\[T\\]](./slices-and-lifetimes/slices.md) (10 minutes)" -msgstr "[Slices: &\\[T\\]](./slices-and-lifetimes/slices.md)（10 分）" - -#: src/slices-and-lifetimes.md -msgid "[String References](./slices-and-lifetimes/str.md) (10 minutes)" -msgstr "[文字列参照](./slices-and-lifetimes/str.md)（10 分）" - -#: src/slices-and-lifetimes.md +#: src/lifetimes/lifetime-annotations.md msgid "" -"[Lifetime Annotations](./slices-and-lifetimes/lifetime-annotations.md) (10 " -"minutes)" +"A reference has a _lifetime_, which must not \"outlive\" the value it refers " +"to. This is verified by the borrow checker." msgstr "" -"[ライフタイム アノテーション](./slices-and-lifetimes/lifetime-annotations.md)" -"（10 分）" +"参照にはライフタイムがあり、これは参照する値よりも「長く存続」してはなりませ" +"ん。これは借用チェッカーによって検証されます。" -#: src/slices-and-lifetimes.md +#: src/lifetimes/lifetime-annotations.md msgid "" -"[Lifetime Elision](./slices-and-lifetimes/lifetime-elision.md) (5 minutes)" +"The lifetime can be implicit - this is what we have seen so far. Lifetimes " +"can also be explicit: `&'a Point`, `&'document str`. Lifetimes start with " +"`'` and `'a` is a typical default name. Read `&'a Point` as \"a borrowed " +"`Point` which is valid for at least the lifetime `a`\"." msgstr "" -"[ライフタイムの省略](./slices-and-lifetimes/lifetime-elision.md)（5 分）" +"これまで見てきたとおり、ライフタイムは暗黙に扱えますが、`&'a Point`、" +"`&'document str` のように明示的に指定することもできます。ライフタイムは `'` " +"で始まり、`'a` が一般的なデフォルト名です。`&'a Point` は、「少なくともライフ" +"タイム `a` の間は有効な、借用した `Point`」とと解釈します。" -#: src/slices-and-lifetimes.md +#: src/lifetimes/lifetime-annotations.md msgid "" -"[Struct Lifetimes](./slices-and-lifetimes/struct-lifetimes.md) (5 minutes)" +"Lifetimes are always inferred by the compiler: you cannot assign a lifetime " +"yourself. Explicit lifetime annotations create constraints where there is " +"ambiguity; the compiler verifies that there is a valid solution." msgstr "" -"[構造体のライフタイム](./slices-and-lifetimes/struct-lifetimes.md)（5 分）" +"ライフタイムは常にコンパイラによって推測されます。自分でライフタイムを割り当" +"てることはできません。明示的なライフタイム アノテーションを使用すると、あいま" +"いなところに制約を課すことができます。それに対し、コンパイラはその制約を満た" +"すライフタイムを設定できることを検証します。" -#: src/slices-and-lifetimes.md +#: src/lifetimes/lifetime-annotations.md msgid "" -"[Exercise: Protobuf Parsing](./slices-and-lifetimes/exercise.md) (30 minutes)" -msgstr "[演習: Protobuf の解析](./slices-and-lifetimes/exercise.md)（30 分）" +"Lifetimes become more complicated when considering passing values to and " +"returning values from functions." +msgstr "" +"関数に値を渡し、関数から値を返すことを考慮する場合、ライフタイムはより複雑に" +"なります。" -#: src/slices-and-lifetimes/slices.md -msgid "Slices" -msgstr "Slices" +#: src/lifetimes/lifetime-annotations.md +msgid "// What is the lifetime of p3?\n" +msgstr "// p3 のライフタイムは？\n" -#: src/slices-and-lifetimes/slices.md -msgid "A slice gives you a view into a larger collection:" -msgstr "スライスは、より大きなコレクションに対するビューを提供します。" - -#: src/slices-and-lifetimes/slices.md -msgid "Slices borrow data from the sliced type." -msgstr "スライスは、スライスされた型からデータを借用します。" - -#: src/slices-and-lifetimes/slices.md -msgid "Question: What happens if you modify `a[3]` right before printing `s`?" -msgstr "質問: `s` を出力する直前に `a[3]` を変更するとどうなるでしょうか？" - -#: src/slices-and-lifetimes/slices.md -msgid "" -"We create a slice by borrowing `a` and specifying the starting and ending " -"indexes in brackets." -msgstr "" -"スライスを作成するには、`a` を借用し、開始インデックスと終了インデックスを角" -"かっこで囲んで指定します。" - -#: src/slices-and-lifetimes/slices.md -msgid "" -"If the slice starts at index 0, Rust’s range syntax allows us to drop the " -"starting index, meaning that `&a[0..a.len()]` and `&a[..a.len()]` are " -"identical." -msgstr "" -"スライスがインデックス 0 から始まる場合、Rust の範囲構文により開始インデック" -"スを省略できます。つまり、`&a[0..a.len()]` と `&a[..a.len()]` は同じです。" - -#: src/slices-and-lifetimes/slices.md -msgid "" -"The same is true for the last index, so `&a[2..a.len()]` and `&a[2..]` are " -"identical." -msgstr "" -"最後のインデックスについても同じことが言えるので、`&a[2..a.len()]` と " -"`&a[2..]` は同じです。" - -#: src/slices-and-lifetimes/slices.md -msgid "" -"To easily create a slice of the full array, we can therefore use `&a[..]`." -msgstr "" -"配列全体のスライスを簡単に作成するには、`&a[..]` と書くことが出来ます。" - -#: src/slices-and-lifetimes/slices.md -msgid "" -"`s` is a reference to a slice of `i32`s. Notice that the type of `s` " -"(`&[i32]`) no longer mentions the array length. This allows us to perform " -"computation on slices of different sizes." -msgstr "" -"`s` は i32 のスライスへの参照です。`s` の型（`&[i32]`）に配列の長さが含まれな" -"くなったことに注目してください。これにより、さまざまなサイズのスライスに対し" -"て計算を実行できます。" - -#: src/slices-and-lifetimes/slices.md -msgid "" -"Slices always borrow from another object. In this example, `a` has to remain " -"'alive' (in scope) for at least as long as our slice." -msgstr "" -"スライスは常に別のオブジェクトから借用します。この例では、`a` は少なくともス" -"ライスが存在する間は「存続」 している（スコープ内にある)必要があります。" - -#: src/slices-and-lifetimes/slices.md -msgid "" -"The question about modifying `a[3]` can spark an interesting discussion, but " -"the answer is that for memory safety reasons you cannot do it through `a` at " -"this point in the execution, but you can read the data from both `a` and `s` " -"safely. It works before you created the slice, and again after the " -"`println`, when the slice is no longer used." -msgstr "" -"`a[3]` の変更に関する質問は興味深い議論のきっかけになるかもしれませんが、メモ" -"リ安全性上の理由から、この時点では `a` を使用して変更することはできない、とい" -"う回答になります。ただし、`a` と `s` の両方のデータを安全に読み取ることはでき" -"ます。これは、スライスを作成する前と、`println` の後でスライスが使用されなく" -"なったあとであれば、変更することが出来ます。" - -#: src/slices-and-lifetimes/str.md -msgid "" -"We can now understand the two string types in Rust: `&str` is almost like " -"`&[char]`, but with its data stored in a variable-length encoding (UTF-8)." -msgstr "" -"これで、Rust の 2 つの文字列型を理解できるようになりました。`&str` は " -"`&[char]` とほぼ同じですが、そのデータは可変長エンコード（UTF-8）で保存されま" -"す。" - -#: src/slices-and-lifetimes/str.md -msgid "\"s1: {s1}\"" -msgstr "\"s1: {s1}\"" - -#: src/slices-and-lifetimes/str.md -msgid "\"Hello \"" -msgstr "\"Hello \"" - -#: src/slices-and-lifetimes/str.md -msgid "\"s3: {s3}\"" -msgstr "\"s3: {s3}\"" - -#: src/slices-and-lifetimes/str.md -msgid "Rust terminology:" -msgstr "Rust の用語:" - -#: src/slices-and-lifetimes/str.md -msgid "`&str` an immutable reference to a string slice." -msgstr "`&str`: 文字列スライスへの不変の参照。" - -#: src/slices-and-lifetimes/str.md -msgid "`String` a mutable string buffer." -msgstr "`String`: 可変の文字列バッファ。" - -#: src/slices-and-lifetimes/str.md -msgid "" -"`&str` introduces a string slice, which is an immutable reference to UTF-8 " -"encoded string data stored in a block of memory. String literals " -"(`”Hello”`), are stored in the program’s binary." -msgstr "" -"`&str` は文字列スライスを導入します。これは、メモリブロックに保存されている " -"UTF-8 でエンコードされた文字列データへの不変の参照です。文字列リテラル" -"（`”Hello”`）は、プログラムのバイナリに格納されます。" - -#: src/slices-and-lifetimes/str.md -msgid "" -"Rust’s `String` type is a wrapper around a vector of bytes. As with a " -"`Vec`, it is owned." -msgstr "" -"Rust の `String` 型は、バイトのベクターのラッパーです。`Vec` と同様、所有" -"されます。" - -#: src/slices-and-lifetimes/str.md -msgid "" -"As with many other types `String::from()` creates a string from a string " -"literal; `String::new()` creates a new empty string, to which string data " -"can be added using the `push()` and `push_str()` methods." -msgstr "" -"他の多くの型と同様に、`String::from()` は文字列リテラルから文字列を作成しま" -"す。`String::new()` は新しい空の文字列を作成します。`push()` メソッドと " -"`push_str()` メソッドを使用して、そこに文字列データを追加できます。" - -#: src/slices-and-lifetimes/str.md -msgid "" -"The `format!()` macro is a convenient way to generate an owned string from " -"dynamic values. It accepts the same format specification as `println!()`." -msgstr "" -"`format!()` マクロを使用すると、動的な値から所有文字列を簡単に生成できます。" -"これは println!() と同じ形式指定を受け入れます。" - -#: src/slices-and-lifetimes/str.md -msgid "" -"You can borrow `&str` slices from `String` via `&` and optionally range " -"selection. If you select a byte range that is not aligned to character " -"boundaries, the expression will panic. The `chars` iterator iterates over " -"characters and is preferred over trying to get character boundaries right." -msgstr "" -"`&` を使用して `String` から `&str` スライスを借用し、必要に応じて範囲を選択" -"できます。文字境界に揃えられていないバイト範囲を選択すると、その式でパニック" -"を起こします。`chars` イテレータは文字単位で処理するため、正しい文字境界を取" -"得しようとすることよりも、このイテレータを使用するほうが望ましいです。" - -#: src/slices-and-lifetimes/str.md -msgid "" -"For C++ programmers: think of `&str` as `std::string_view` from C++, but the " -"one that always points to a valid string in memory. Rust `String` is a rough " -"equivalent of `std::string` from C++ (main difference: it can only contain " -"UTF-8 encoded bytes and will never use a small-string optimization)." -msgstr "" -"C++ プログラマー向けの説明：`&str` は常にメモリ上の有効な文字列を指しているよ" -"うなC++ の std::string_view と考えられます。Rust の `String` は、C++ の " -"`std::string` とおおむね同等です（主な違いは、UTF-8 でエンコードされたバイト" -"のみを含めることができ、短い文字列に対する最適化が行われないことです）。" - -#: src/slices-and-lifetimes/str.md -msgid "Byte strings literals allow you to create a `&[u8]` value directly:" -msgstr "バイト文字列リテラルを使用すると、`&[u8]` 値を直接作成できます。" - -#: src/slices-and-lifetimes/lifetime-annotations.md -msgid "" -"A reference has a _lifetime_, which must not \"outlive\" the value it refers " -"to. This is verified by the borrow checker." -msgstr "" -"参照にはライフタイムがあり、これは参照する値よりも「長く存続」してはなりませ" -"ん。これは借用チェッカーによって検証されます。" - -#: src/slices-and-lifetimes/lifetime-annotations.md -msgid "" -"The lifetime can be implicit - this is what we have seen so far. Lifetimes " -"can also be explicit: `&'a Point`, `&'document str`. Lifetimes start with " -"`'` and `'a` is a typical default name. Read `&'a Point` as \"a borrowed " -"`Point` which is valid for at least the lifetime `a`\"." -msgstr "" -"これまで見てきたとおり、ライフタイムは暗黙に扱えますが、`&'a Point`、" -"`&'document str` のように明示的に指定することもできます。ライフタイムは `'` " -"で始まり、`'a` が一般的なデフォルト名です。`&'a Point` は、「少なくともライフ" -"タイム `a` の間は有効な、借用した `Point`」とと解釈します。" - -#: src/slices-and-lifetimes/lifetime-annotations.md -msgid "" -"Lifetimes are always inferred by the compiler: you cannot assign a lifetime " -"yourself. Explicit lifetime annotations create constraints where there is " -"ambiguity; the compiler verifies that there is a valid solution." -msgstr "" -"ライフタイムは常にコンパイラによって推測されます。自分でライフタイムを割り当" -"てることはできません。明示的なライフタイム アノテーションを使用すると、あいま" -"いなところに制約を課すことができます。それに対し、コンパイラはその制約を満た" -"すライフタイムを設定できることを検証します。" - -#: src/slices-and-lifetimes/lifetime-annotations.md -msgid "" -"Lifetimes become more complicated when considering passing values to and " -"returning values from functions." -msgstr "" -"関数に値を渡し、関数から値を返すことを考慮する場合、ライフタイムはより複雑に" -"なります。" - -#: src/slices-and-lifetimes/lifetime-annotations.md -msgid "// What is the lifetime of p3?\n" -msgstr "// p3 のライフタイムは？\n" - -#: src/slices-and-lifetimes/lifetime-annotations.md +#: src/lifetimes/lifetime-annotations.md msgid "\"p3: {p3:?}\"" msgstr "\"p3: {p3:?}\"" -#: src/slices-and-lifetimes/lifetime-annotations.md +#: src/lifetimes/lifetime-annotations.md msgid "" "In this example, the compiler does not know what lifetime to infer for `p3`. " "Looking inside the function body shows that it can only safely assume that " @@ -9507,11 +9412,11 @@ msgstr "" "定できることがわかります。ただし、型と同様に、Rust では関数の引数や戻り値にラ" "イフタイムの明示的なアノテーションが必要です。" -#: src/slices-and-lifetimes/lifetime-annotations.md +#: src/lifetimes/lifetime-annotations.md msgid "Add `'a` appropriately to `left_most`:" msgstr "`left_most` に `'a` を適切に追加します。" -#: src/slices-and-lifetimes/lifetime-annotations.md +#: src/lifetimes/lifetime-annotations.md msgid "" "This says, \"given p1 and p2 which both outlive `'a`, the return value lives " "for at least `'a`." @@ -9519,17 +9424,17 @@ msgstr "" "これは、「p1 と p2 の両方が `'a` より長く存続すると、戻り値は少なくとも `'a` " "の間存続する」という意味になります。" -#: src/slices-and-lifetimes/lifetime-annotations.md +#: src/lifetimes/lifetime-annotations.md msgid "" "In common cases, lifetimes can be elided, as described on the next slide." msgstr "" "一般的なケースでは、次のスライドで説明するようにライフタイムを省略できます。" -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "Lifetimes in Function Calls" msgstr "関数とライフタイム" -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "" "Lifetimes for function arguments and return values must be fully specified, " "but Rust allows lifetimes to be elided in most cases with [a few simple " @@ -9541,13 +9446,13 @@ msgstr "" "lifetime-elision.html)により、ライフタイムを省略できます。これは推論ではな" "く、構文の省略形にすぎません。" -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "Each argument which does not have a lifetime annotation is given one." msgstr "" "ライフタイム アノテーションが付いていない各引数には、1 つのライフタイムが与え" "られます。" -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "" "If there is only one argument lifetime, it is given to all un-annotated " "return values." @@ -9555,7 +9460,7 @@ msgstr "" "引数のライフタイムが 1 つしかない場合、アノテーションのない戻り値すべてにその" "ライフタイムが与えられます。" -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "" "If there are multiple argument lifetimes, but the first one is for `self`, " "that lifetime is given to all un-annotated return values." @@ -9563,12 +9468,12 @@ msgstr "" "引数のライフタイムが複数あり、最初のライフタイムが `self` である場合、アノ" "テーションのない戻り値すべてにそのライフタイムが与えられます。" -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "In this example, `cab_distance` is trivially elided." msgstr "" "この例では、`cab_distance` に関するライフタイムの記述は省略されています。" -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "" "The `nearest` function provides another example of a function with multiple " "references in its arguments that requires explicit annotation." @@ -9576,13 +9481,13 @@ msgstr "" "`nearest` 関数は、明示的なアノテーションを必要とする複数の参照を引数に含む関" "数のもう一つの例です。" -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "Try adjusting the signature to \"lie\" about the lifetimes returned:" msgstr "" "返されるライフタイムについて嘘のアノテーションを付けるようにシグネチャを調整" "してみましょう。" -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "" "This won't compile, demonstrating that the annotations are checked for " "validity by the compiler. Note that this is not the case for raw pointers " @@ -9593,7 +9498,7 @@ msgstr "" "生のポインタ（安全ではない）には当てはまりません。アンセーフRustを使用する場" "合に、これはよくあるエラーの原因となっています。" -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "" "Students may ask when to use lifetimes. Rust borrows _always_ have " "lifetimes. Most of the time, elision and type inference mean these don't " @@ -9608,38 +9513,38 @@ msgstr "" "特にプロトタイピングでは、必要に応じて値をクローニングして所有データを処理す" "る方が簡単です。" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "Lifetimes in Data Structures" msgstr "データ構造とライフタイム" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "" "If a data type stores borrowed data, it must be annotated with a lifetime:" msgstr "" "データ型が借用データを内部に保持する場合、ライフタイムアノテーションを付ける" "必要があります。" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "\"Bye {text}!\"" msgstr "\"Bye {text}!\"" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "\"The quick brown fox jumps over the lazy dog.\"" msgstr "\"The quick brown fox jumps over the lazy dog.\"" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "// erase(text);\n" msgstr "// 消去（テキスト）;\n" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "\"{fox:?}\"" msgstr "\"{fox:?}\"" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "\"{dog:?}\"" msgstr "\"{dog:?}\"" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "" "In the above example, the annotation on `Highlight` enforces that the data " "underlying the contained `&str` lives at least as long as any instance of " @@ -9649,7 +9554,7 @@ msgstr "" "データは、少なくともそのデータを使用する `Highlight` のインスタンスが存在する" "限り存続しなければならなくなります。" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "" "If `text` is consumed before the end of the lifetime of `fox` (or `dog`), " "the borrow checker throws an error." @@ -9657,7 +9562,7 @@ msgstr "" "`fox`（または `dog`）のライフタイムが終了する前に `text` が使用されると、借用" "チェッカーはエラーをスローします。" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "" "Types with borrowed data force users to hold on to the original data. This " "can be useful for creating lightweight views, but it generally makes them " @@ -9667,11 +9572,11 @@ msgstr "" "ます。これは軽量のビューを作成する場合に便利ですが、一般的には使いにくくなり" "ます。" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "When possible, make data structures own their data directly." msgstr "可能であれば、データ構造がデータを直接所有できるようにします。" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "" "Some structs with multiple references inside can have more than one lifetime " "annotation. This can be necessary if there is a need to describe lifetime " @@ -9683,7 +9588,7 @@ msgstr "" "照同士のライフタイムの関係を記述する必要がある場合です。これは非常に高度な" "ユースケースです。" -#: src/slices-and-lifetimes/exercise.md +#: src/lifetimes/exercise.md msgid "" "In this exercise, you will build a parser for the [protobuf binary encoding]" "(https://protobuf.dev/programming-guides/encoding/). Don't worry, it's " @@ -9695,7 +9600,7 @@ msgstr "" "で、心配はいりません。これは、データのスライスを渡す一般的な解析パターンを示" "しています。基になるデータ自体がコピーされることはありません。" -#: src/slices-and-lifetimes/exercise.md +#: src/lifetimes/exercise.md msgid "" "Fully parsing a protobuf message requires knowing the types of the fields, " "indexed by their field numbers. That is typically provided in a `proto` " @@ -9707,11 +9612,11 @@ msgstr "" "ます。この演習では、フィールドごとに呼び出される関数の `match` ステートメント" "に、その情報をエンコードします。" -#: src/slices-and-lifetimes/exercise.md +#: src/lifetimes/exercise.md msgid "We'll use the following proto:" msgstr "次の proto を使用します。" -#: src/slices-and-lifetimes/exercise.md +#: src/lifetimes/exercise.md msgid "" "A proto message is encoded as a series of fields, one after the next. Each " "is implemented as a \"tag\" followed by the value. The tag contains a field " @@ -9723,7 +9628,7 @@ msgstr "" "メッセージの `id` フィールドには `2`）と、バイト ストリームからペイロードがど" "のように決定されるかを定義するワイヤータイプが含まれます。" -#: src/slices-and-lifetimes/exercise.md +#: src/lifetimes/exercise.md msgid "" "Integers, including the tag, are represented with a variable-length encoding " "called VARINT. Luckily, `parse_varint` is defined for you below. The given " @@ -9736,7 +9641,7 @@ msgstr "" "これらのコールバックに対する一連の呼び出しに変換するコールバックも定義してい" "ます。" -#: src/slices-and-lifetimes/exercise.md +#: src/lifetimes/exercise.md msgid "" "What remains for you is to implement the `parse_field` function and the " "`ProtoMessage` trait for `Person` and `PhoneNumber`." @@ -9744,41 +9649,21 @@ msgstr "" "残る作業は、`parse_field` 関数と、`Person` および `PhoneNumber` の " "`ProtoMessage` トレイトを実装するだけです。" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Invalid varint\"" -msgstr "\"Invalid varint\"" - -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Invalid wire-type\"" -msgstr "\"Invalid wire-type\"" - -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Unexpected EOF\"" -msgstr "\"Unexpected EOF\"" - -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Invalid length\"" -msgstr "\"Invalid length\"" - -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Unexpected wire-type)\"" -msgstr "\"Unexpected wire-type)\"" - -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Invalid string (not UTF-8)\"" -msgstr "\"Invalid string (not UTF-8)\"" - -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// A wire type as seen on the wire.\n" msgstr "/// ワイヤー上で見えるワイヤータイプ。\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// The Varint WireType indicates the value is a single VARINT.\n" msgstr "/// Varint WireType は、値が単一の VARINT であることを示します。\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md +#, fuzzy msgid "" -"//I64, -- not needed for this exercise\n" +"/// The I64 WireType indicates that the value is precisely 8 bytes in\n" +" /// little-endian order containing a 64-bit signed integer or double " +"type.\n" +" //I64, -- not needed for this exercise\n" " /// The Len WireType indicates that the value is a length represented as " "a\n" " /// VARINT followed by exactly that number of bytes.\n" @@ -9788,37 +9673,76 @@ msgstr "" "が\n" " /// 続くものであることを示します。\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md +#, fuzzy msgid "" -"/// The I32 WireType indicates that the value is precisely 4 bytes in\n" -" /// little-endian order containing a 32-bit signed integer.\n" +"// The I32 WireType indicates that the value is precisely 4 bytes in\n" +" // little-endian order containing a 32-bit signed integer or float " +"type.\n" +" //I32, -- not needed for this exercise\n" msgstr "" "/// I32 WireType は、値が 32 ビット符号付き整数を含むリトル エンディアン" "で、\n" " /// 正確に 4 バイトであることを示します。\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// A field's value, typed based on the wire type.\n" msgstr "/// ワイヤータイプに基づいて型指定されたフィールドの値。\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "//I64(i64), -- not needed for this exercise\n" msgstr "//I64（i64）、 -- この演習では不要\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md +#, fuzzy +msgid "//I32(i32), -- not needed for this exercise\n" +msgstr "//I64（i64）、 -- この演習では不要\n" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// A field, containing the field number and its value.\n" msgstr "/// フィールド番号とその値を含むフィールド。\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "//1 => WireType::I64, -- not needed for this exercise\n" msgstr "//1 => WireType::I64、 -- この演習では不要\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md +#, fuzzy +msgid "//5 => WireType::I32, -- not needed for this exercise\n" +msgstr "//1 => WireType::I64、 -- この演習では不要\n" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md +#, fuzzy +msgid "\"Invalid wire type: {value}\"" +msgstr "\"Invalid wire-type\"" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "\"Expected string to be a `Len` field\"" +msgstr "" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md +#, fuzzy +msgid "\"Invalid string\"" +msgstr "\"Invalid varint\"" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "\"Expected bytes to be a `Len` field\"" +msgstr "" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "\"Expected `u64` to be a `Varint` field\"" +msgstr "" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "" "/// Parse a VARINT, returning the parsed value and the remaining bytes.\n" msgstr "/// VARINT を解析し、解析した値と残りのバイトを返します。\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "\"Not enough bytes for varint\"" +msgstr "" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "" "// This is the last byte of the VARINT, so convert it to\n" " // a u64 and return it.\n" @@ -9826,19 +9750,23 @@ msgstr "" "// これは VARINT の最後のバイトであるため、\n" " // u64 に変換して返します。\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "// More than 7 bytes is invalid.\n" msgstr "// 7 バイトを超える値は無効です。\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "\"Too many bytes for varint\"" +msgstr "" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// Convert a tag into a field number and a WireType.\n" msgstr "/// タグをフィールド番号と WireType に変換します。\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// Parse a field, returning the remaining bytes\n" msgstr "/// フィールドを解析して残りのバイトを返します。\n" -#: src/slices-and-lifetimes/exercise.md +#: src/lifetimes/exercise.md msgid "" "\"Based on the wire type, build a Field, consuming as many bytes as " "necessary.\"" @@ -9846,11 +9774,11 @@ msgstr "" "\"ワイヤータイプに応じて、フィールドを構築し、必要な量のバイトを消費しま" "す。\"" -#: src/slices-and-lifetimes/exercise.md +#: src/lifetimes/exercise.md msgid "\"Return the field, and any un-consumed bytes.\"" msgstr "\"フィールドと、未消費のバイトを返します。\"" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "" "/// Parse a message in the given data, calling `T::add_field` for each field " "in\n" @@ -9863,22 +9791,52 @@ msgstr "" "///\n" "/// 入力全体が消費されます。\n" -#: src/slices-and-lifetimes/exercise.md +#: src/lifetimes/exercise.md msgid "// TODO: Implement ProtoMessage for Person and PhoneNumber.\n" msgstr "// TODO: Person と PhoneNumber の ProtoMessage を実装します。\n" -#: src/slices-and-lifetimes/solution.md -msgid "// Unwrap error because `value` is definitely 4 bytes long.\n" +#: src/lifetimes/exercise.md +msgid "" +"In this exercise there are various cases where protobuf parsing might fail, " +"e.g. if you try to parse an `i32` when there are fewer than 4 bytes left in " +"the data buffer. In normal Rust code we'd handle this with the `Result` " +"enum, but for simplicity in this exercise we panic if any errors are " +"encountered. On day 4 we'll cover error handling in Rust in more detail." +msgstr "" + +#: src/lifetimes/solution.md +msgid "\"len not a valid `usize`\"" msgstr "" -"// `value` の長さは明らかに 4 バイトであるため、エラーをアンラップします。\n" -#: src/slices-and-lifetimes/solution.md +#: src/lifetimes/solution.md +msgid "\"Unexpected EOF\"" +msgstr "\"Unexpected EOF\"" + +#: src/lifetimes/solution.md msgid "// skip everything else\n" msgstr "// それ以外をすべてスキップ\n" -#: src/slices-and-lifetimes/solution.md -msgid "b\"hello\"" -msgstr "b\"hello\"" +#: src/lifetimes/solution.md src/modules/exercise.md src/modules/solution.md +#: src/testing/unit-tests.md src/testing/solution.md +msgid "\"\"" +msgstr "\"\"" + +#: src/lifetimes/solution.md +#, fuzzy +msgid "\"beautiful name\"" +msgstr "\"Hello {name}\"" + +#: src/lifetimes/solution.md +msgid "\"Evan\"" +msgstr "" + +#: src/lifetimes/solution.md +msgid "\"+1234-777-9090\"" +msgstr "" + +#: src/lifetimes/solution.md +msgid "\"home\"" +msgstr "" #: src/welcome-day-4.md msgid "Welcome to Day 4" @@ -9914,38 +9872,25 @@ msgid "" msgstr "アンセーフRust: 安全な Rust では記述できない場合の回避策。" #: src/welcome-day-4.md -msgid "[Welcome](./welcome-day-4.md) (3 minutes)" -msgstr "[ようこそ](./welcome-day-4.md)（3 分）" - -#: src/welcome-day-4.md -msgid "[Iterators](./iterators.md) (45 minutes)" -msgstr "[イテレータ](./iterators.md)（45 分）" - -#: src/welcome-day-4.md -msgid "[Modules](./modules.md) (40 minutes)" -msgstr "[モジュール](./modules.md)（40 分）" - -#: src/welcome-day-4.md -msgid "[Testing](./testing.md) (1 hour and 5 minutes)" -msgstr "[テスト](./testing.md)（1 時間 5 分）" - -#: src/iterators.md -msgid "[Iterator](./iterators/iterator.md) (5 minutes)" -msgstr "[Iterator](./iterators/iterator.md)（5 分）" +#, fuzzy +msgid "" +"Including 10 minute breaks, this session should take about 2 hours and 40 " +"minutes. It contains:" +msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 2 時間 20 分です。" #: src/iterators.md -msgid "[IntoIterator](./iterators/intoiterator.md) (5 minutes)" -msgstr "[IntoIterator](./iterators/intoiterator.md)（5 分）" +#, fuzzy +msgid "Iterator" +msgstr "イテレータ" #: src/iterators.md -msgid "[FromIterator](./iterators/fromiterator.md) (5 minutes)" -msgstr "[FromIterator](./iterators/fromiterator.md)（5 分）" +#, fuzzy +msgid "IntoIterator" +msgstr "`IntoIterator`" -#: src/iterators.md -msgid "" -"[Exercise: Iterator Method Chaining](./iterators/exercise.md) (30 minutes)" -msgstr "" -"[演習: イテレータ メソッドのチェーン化](./iterators/exercise.md)（30 分）" +#: src/iterators.md src/iterators/fromiterator.md +msgid "FromIterator" +msgstr "FromIterator" #: src/iterators/iterator.md msgid "" @@ -10064,10 +10009,6 @@ msgstr "" "処理します。`some_vector` の要素への参照を反復処理するには、代わりに `for e " "in &some_vector` を使用します。" -#: src/iterators/fromiterator.md -msgid "FromIterator" -msgstr "FromIterator" - #: src/iterators/fromiterator.md msgid "" "[`FromIterator`](https://doc.rust-lang.org/std/iter/trait.FromIterator.html) " @@ -10151,30 +10092,9 @@ msgstr "" "///\n" "/// 結果の要素 `n` は `values[(n+offset)%len] - values[n]` です。\n" -#: src/modules.md -msgid "[Modules](./modules/modules.md) (5 minutes)" -msgstr "[モジュール](./modules/modules.md)（5 分）" - -#: src/modules.md -msgid "[Filesystem Hierarchy](./modules/filesystem.md) (5 minutes)" -msgstr "[ファイル システム階層](./modules/filesystem.md)（5 分）" - -#: src/modules.md -msgid "[Visibility](./modules/visibility.md) (5 minutes)" -msgstr "[可視性](./modules/visibility.md)（5 分）" - -#: src/modules.md -msgid "[use, super, self](./modules/paths.md) (10 minutes)" -msgstr "[use、super、self](./modules/paths.md)（10 分）" - -#: src/modules.md -msgid "" -"[Exercise: Modules for a GUI Library](./modules/exercise.md) (15 minutes)" -msgstr "[演習: GUI ライブラリのモジュール](./modules/exercise.md)（15 分）" - -#: src/modules.md -msgid "This segment should take about 40 minutes" -msgstr "このセグメントの所要時間は約 40 分です" +#: src/modules.md src/modules/paths.md +msgid "use, super, self" +msgstr "use、super、self" #: src/modules/modules.md msgid "We have seen how `impl` blocks let us namespace functions to a type." @@ -10392,10 +10312,6 @@ msgstr "" "どのような場合も、祖先モジュール（およびそのすべての子孫）に可視性を与える必" "要があります。" -#: src/modules/paths.md -msgid "use, super, self" -msgstr "use、super、self" - #: src/modules/paths.md msgid "" "A module can bring symbols from another module into scope with `use`. You " @@ -10558,11 +10474,6 @@ msgstr "" msgid "\"+-{:-` as long as it implements `std::" -"process:Termination`. In practice, this means that `E` implements `Debug`. " +"process::Termination`. In practice, this means that `E` implements `Debug`. " "The executable will print the `Err` variant and return a nonzero exit status " "on error." msgstr "" @@ -11432,8 +11165,8 @@ msgid "\"Found no username in {path}\"" msgstr "\"Found no username in {path}\"" #: src/error-handling/try-conversions.md -#: src/error-handling/thiserror-and-anyhow.md -msgid "//fs::write(\"config.dat\", \"\").unwrap();\n" +#, fuzzy +msgid "//std::fs::write(\"config.dat\", \"\").unwrap();\n" msgstr "//fs::write(\"config.dat\", \"\").unwrap();\n" #: src/error-handling/try-conversions.md @@ -11580,6 +11313,10 @@ msgstr "\"Failed to open {path}\"" msgid "\"Failed to read\"" msgstr "\"Failed to read\"" +#: src/error-handling/thiserror-and-anyhow.md +msgid "//fs::write(\"config.dat\", \"\").unwrap();\n" +msgstr "//fs::write(\"config.dat\", \"\").unwrap();\n" + #: src/error-handling/thiserror-and-anyhow.md msgid "\"Username: {username}\"" msgstr "\"Username: {username}\"" @@ -11653,10 +11390,6 @@ msgstr "" "す。これらの型で `.context()` と `.with_context()` を有効にするには、`use " "anyhow::Context` が必要です。" -#: src/error-handling/exercise.md -msgid "Exercise: Rewriting with Result" -msgstr "演習: Result を使用した書き換え" - #: src/error-handling/exercise.md msgid "" "The following implements a very simple parser for an expression language. " @@ -11703,10 +11436,6 @@ msgstr "/// リテラル数値。\n" msgid "/// A binary operation.\n" msgstr "/// バイナリ演算。\n" -#: src/error-handling/exercise.md src/error-handling/solution.md -msgid "'z'" -msgstr "'z'" - #: src/error-handling/exercise.md src/error-handling/solution.md msgid "'_'" msgstr "'_'" @@ -11764,33 +11493,9 @@ msgid "\"Invalid number\"" msgstr "\"Invalid number\"" #: src/unsafe-rust.md -msgid "[Unsafe](./unsafe-rust/unsafe.md) (5 minutes)" -msgstr "[アンセーフRust](./unsafe-rust/unsafe.md)（5 分）" - -#: src/unsafe-rust.md -msgid "" -"[Dereferencing Raw Pointers](./unsafe-rust/dereferencing.md) (10 minutes)" -msgstr "[未加工ポインタの参照外し](./unsafe-rust/dereferencing.md)（10 分）" - -#: src/unsafe-rust.md -msgid "[Mutable Static Variables](./unsafe-rust/mutable-static.md) (5 minutes)" -msgstr "[可変の静的変数](./unsafe-rust/mutable-static.md)（5 分）" - -#: src/unsafe-rust.md -msgid "[Unions](./unsafe-rust/unions.md) (5 minutes)" -msgstr "[共用体](./unsafe-rust/unions.md)（5 分）" - -#: src/unsafe-rust.md -msgid "[Unsafe Functions](./unsafe-rust/unsafe-functions.md) (5 minutes)" -msgstr "[アンセーフな関数](./unsafe-rust/unsafe-functions.md)（5 分）" - -#: src/unsafe-rust.md -msgid "[Unsafe Traits](./unsafe-rust/unsafe-traits.md) (5 minutes)" -msgstr "[アンセーフなトレイト](./unsafe-rust/unsafe-traits.md)（5 分）" - -#: src/unsafe-rust.md -msgid "[Exercise: FFI Wrapper](./unsafe-rust/exercise.md) (30 minutes)" -msgstr "[演習: FFI ラッパー](./unsafe-rust/exercise.md)（30 分）" +#, fuzzy +msgid "This segment should take about 1 hour and 5 minutes. It contains:" +msgstr "このセグメントの所要時間は約 1 時間 5 分です" #: src/unsafe-rust/unsafe.md msgid "The Rust language has two parts:" @@ -11879,13 +11584,14 @@ msgid "\"careful!\"" msgstr "\"careful!\"" #: src/unsafe-rust/dereferencing.md +#, fuzzy msgid "" -"// Safe because r1 and r2 were obtained from references and so are\n" -" // guaranteed to be non-null and properly aligned, the objects " -"underlying\n" -" // the references from which they were obtained are live throughout the\n" -" // whole unsafe block, and they are not accessed either through the\n" -" // references or concurrently through any other pointers.\n" +"// SAFETY: r1 and r2 were obtained from references and so are guaranteed to\n" +" // be non-null and properly aligned, the objects underlying the " +"references\n" +" // from which they were obtained are live throughout the whole unsafe\n" +" // block, and they are not accessed either through the references or\n" +" // concurrently through any other pointers.\n" msgstr "" "// 次の理由により安全: r1 と r2 は参照から取得されており、\n" " // 非 null で適切にアラインされていることが保証されています。\n" @@ -12003,6 +11709,11 @@ msgstr "" "ただし、データ競合が発生する可能性があるため、可変静的変数の読み取りと書き込" "みは安全ではありません。" +#: src/unsafe-rust/mutable-static.md +msgid "" +"// SAFETY: There are no other threads which could be accessing `COUNTER`.\n" +msgstr "" + #: src/unsafe-rust/mutable-static.md msgid "\"COUNTER: {COUNTER}\"" msgstr "\"COUNTER: {COUNTER}\"" @@ -12085,7 +11796,6 @@ msgstr "" #: src/android/interoperability/cpp/cpp-bridge.md #: src/exercises/chromium/build-rules.md src/bare-metal/aps/inline-assembly.md #: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md -#: src/exercises/bare-metal/rtc.md #: src/exercises/bare-metal/solutions-afternoon.md msgid "\"C\"" msgstr "\"C\"" @@ -12095,9 +11805,10 @@ msgid "\"🗻∈🌏\"" msgstr "\"🗻∈🌏\"" #: src/unsafe-rust/unsafe-functions.md +#, fuzzy msgid "" -"// Safe because the indices are in the correct order, within the bounds of\n" -" // the string slice, and lie on UTF-8 sequence boundaries.\n" +"// SAFETY: The indices are in the correct order, within the bounds of the\n" +" // string slice, and lie on UTF-8 sequence boundaries.\n" msgstr "" "// インデックスが正しい順序で文字列スライスの境界内にあり、\n" " // UTF-8 シーケンスの境界上にあるため、安全です。\n" @@ -12111,8 +11822,10 @@ msgid "\"char count: {}\"" msgstr "\"char count: {}\"" #: src/unsafe-rust/unsafe-functions.md -msgid "// Undefined behavior if abs misbehaves.\n" -msgstr "// abs 誤動作の場合の動作は未定義。\n" +msgid "" +"// SAFETY: `abs` doesn't deal with pointers and doesn't have any safety\n" +" // requirements.\n" +msgstr "" #: src/unsafe-rust/unsafe-functions.md msgid "\"Absolute value of -3 according to C: {}\"" @@ -12157,8 +11870,9 @@ msgstr "" "/// ポインタが有効で、適切にアラインされている必要があります。\n" #: src/unsafe-rust/unsafe-functions.md -msgid "// Safe because ...\n" -msgstr "// 安全です。理由は...\n" +#, fuzzy +msgid "// SAFETY: ...\n" +msgstr "// ...\n" #: src/unsafe-rust/unsafe-functions.md msgid "\"a = {}, b = {}\"" @@ -12238,7 +11952,8 @@ msgstr "" "/// 型には定義された表現が必要で、パディングがあってはなりません。\n" #: src/unsafe-rust/unsafe-traits.md -msgid "// Safe because u32 has a defined representation and no padding.\n" +#, fuzzy +msgid "// SAFETY: `u32` has a defined representation and no padding.\n" msgstr "// u32 には定義された表現があり、パディングがないため、安全です。\n" #: src/unsafe-rust/unsafe-traits.md @@ -12926,7 +12641,8 @@ msgstr "// ダイナミック リンク エラーを回避するために必要 msgid "\"greetings\"" msgstr "\"greetings\"" -#: src/android/build-rules/library.md src/android/aidl/implementation.md +#: src/android/build-rules/library.md +#: src/android/aidl/example-service/service.md src/android/testing.md #: src/android/interoperability/java.md msgid "\"src/lib.rs\"" msgstr "\"src/lib.rs\"" @@ -12983,141 +12699,242 @@ msgstr "Rust コードは既存の AIDL サーバーを呼び出すことがで msgid "You can create new AIDL servers in Rust." msgstr "Rust では新しい AIDL サーバーを作成できます。" -#: src/android/aidl/interface.md +#: src/android/aidl/birthday-service.md +msgid "" +"To illustrate how to use Rust with Binder, we're going to walk through the " +"process of creating a Binder interface. We're then going to both implement " +"the described service and write client code that talks to that service." +msgstr "" + +#: src/android/aidl/example-service/interface.md msgid "AIDL Interfaces" msgstr "AIDL インターフェース" -#: src/android/aidl/interface.md +#: src/android/aidl/example-service/interface.md msgid "You declare the API of your service using an AIDL interface:" msgstr "サービスの API を宣言するには、AIDL インターフェースを使用します。" -#: src/android/aidl/interface.md +#: src/android/aidl/example-service/interface.md +#: src/android/aidl/example-service/service-bindings.md msgid "" "_birthday_service/aidl/com/example/birthdayservice/IBirthdayService.aidl_:" msgstr "" "_birthday_service/aidl/com/example/birthdayservice/IBirthdayService.aidl_:" -#: src/android/aidl/interface.md src/android/aidl/changing.md +#: src/android/aidl/example-service/interface.md +#: src/android/aidl/example-service/service-bindings.md +#: src/android/aidl/example-service/changing-definition.md msgid "/** Birthday service interface. */" msgstr "/** 誕生日サービスのインターフェース。*/" -#: src/android/aidl/interface.md src/android/aidl/changing.md +#: src/android/aidl/example-service/interface.md +#: src/android/aidl/example-service/service-bindings.md +#: src/android/aidl/example-service/changing-definition.md msgid "/** Generate a Happy Birthday message. */" msgstr "/** 「お誕生日おめでとう」というメッセージを生成します。*/" -#: src/android/aidl/interface.md +#: src/android/aidl/example-service/interface.md msgid "_birthday_service/aidl/Android.bp_:" msgstr "_birthday_service/aidl/Android.bp_:" -#: src/android/aidl/interface.md +#: src/android/aidl/example-service/interface.md msgid "\"com.example.birthdayservice\"" msgstr "\"com.example.birthdayservice\"" -#: src/android/aidl/interface.md +#: src/android/aidl/example-service/interface.md msgid "\"com/example/birthdayservice/*.aidl\"" msgstr "\"com/example/birthdayservice/*.aidl\"" -#: src/android/aidl/interface.md +#: src/android/aidl/example-service/interface.md msgid "// Rust is not enabled by default\n" msgstr "// Rust はデフォルトでは無効です。\n" -#: src/android/aidl/interface.md +#: src/android/aidl/example-service/interface.md +msgid "" +"Note that the directory structure under the `aidl/` directory needs to match " +"the package name used in the AIDL file, i.e. the package is `com.example." +"birthdayservice` and the file is at `aidl/com/example/IBirthdayService.aidl`." +msgstr "" + +#: src/android/aidl/example-service/service-bindings.md +msgid "Generated Service API" +msgstr "" + +#: src/android/aidl/example-service/service-bindings.md +msgid "" +"Binder generates a trait corresponding to the interface definition. trait to " +"talk to the service." +msgstr "" + +#: src/android/aidl/example-service/service-bindings.md +#, fuzzy +msgid "_Generated trait_:" +msgstr "生成された Rust:" + +#: src/android/aidl/example-service/service-bindings.md +msgid "" +"Your service will need to implement this trait, and your client will use " +"this trait to talk to the service." +msgstr "" + +#: src/android/aidl/example-service/service-bindings.md msgid "" -"Add `vendor_available: true` if your AIDL file is used by a binary in the " -"vendor partition." +"The generated bindings can be found at `out/soong/.intermediates//`." msgstr "" -"AIDL ファイルがベンダー パーティション内のバイナリで使用されている場合は、" -"`vendor_available: true` を追加します。" -#: src/android/aidl/implementation.md +#: src/android/aidl/example-service/service-bindings.md +msgid "" +"Point out how the generated function signature, specifically the argument " +"and return types, correspond the interface definition." +msgstr "" + +#: src/android/aidl/example-service/service-bindings.md +msgid "" +"`String` for an argument results in a different Rust type than `String` as a " +"return type." +msgstr "" + +#: src/android/aidl/example-service/service.md msgid "Service Implementation" msgstr "サービスの実装" -#: src/android/aidl/implementation.md +#: src/android/aidl/example-service/service.md msgid "We can now implement the AIDL service:" msgstr "次に、AIDL サービスを実装します。" -#: src/android/aidl/implementation.md +#: src/android/aidl/example-service/service.md +#: src/android/aidl/example-service/changing-implementation.md msgid "_birthday_service/src/lib.rs_:" msgstr "_birthday_service/src/lib.rs_:" -#: src/android/aidl/implementation.md -msgid "//! Implementation of the `IBirthdayService` AIDL interface.\n" -msgstr "//! `IBirthdayService` AIDL インターフェースの実装。\n" - -#: src/android/aidl/implementation.md +#: src/android/aidl/example-service/service.md msgid "/// The `IBirthdayService` implementation.\n" msgstr "/// `IBirthdayService` の実装。\n" -#: src/android/aidl/implementation.md +#: src/android/aidl/example-service/service.md +#: src/android/aidl/example-service/changing-implementation.md +#: src/android/aidl/types/file-descriptor.md msgid "\"Happy Birthday {name}, congratulations with the {years} years!\"" msgstr "\"Happy Birthday {name}, congratulations with the {years} years!\"" -#: src/android/aidl/implementation.md src/android/aidl/server.md -#: src/android/aidl/client.md +#: src/android/aidl/example-service/service.md +#: src/android/aidl/example-service/server.md +#: src/android/aidl/example-service/client.md msgid "_birthday_service/Android.bp_:" msgstr "_birthday_service/Android.bp_:" -#: src/android/aidl/implementation.md src/android/aidl/server.md +#: src/android/aidl/example-service/service.md +#: src/android/aidl/example-service/server.md msgid "\"libbirthdayservice\"" msgstr "\"libbirthdayservice\"" -#: src/android/aidl/implementation.md src/android/aidl/server.md -#: src/android/aidl/client.md +#: src/android/aidl/example-service/service.md +#: src/android/aidl/example-service/server.md +#: src/android/aidl/example-service/client.md msgid "\"birthdayservice\"" msgstr "\"birthdayservice\"" -#: src/android/aidl/implementation.md src/android/aidl/server.md -#: src/android/aidl/client.md +#: src/android/aidl/example-service/service.md +#: src/android/aidl/example-service/server.md +#: src/android/aidl/example-service/client.md msgid "\"com.example.birthdayservice-rust\"" msgstr "\"com.example.birthdayservice-rust\"" -#: src/android/aidl/implementation.md src/android/aidl/server.md -#: src/android/aidl/client.md +#: src/android/aidl/example-service/service.md +#: src/android/aidl/example-service/server.md +#: src/android/aidl/example-service/client.md msgid "\"libbinder_rs\"" msgstr "\"libbinder_rs\"" -#: src/android/aidl/server.md +#: src/android/aidl/example-service/service.md +msgid "" +"Point out the path to the generated `IBirthdayService` trait, and explain " +"why each of the segments is necessary." +msgstr "" + +#: src/android/aidl/example-service/service.md +msgid "" +"TODO: What does the `binder::Interface` trait do? Are there methods to " +"override? Where source?" +msgstr "" + +#: src/android/aidl/example-service/server.md msgid "AIDL Server" msgstr "AIDL サーバー" -#: src/android/aidl/server.md +#: src/android/aidl/example-service/server.md msgid "Finally, we can create a server which exposes the service:" msgstr "次に、サービスを公開するサーバーを作成します。" -#: src/android/aidl/server.md +#: src/android/aidl/example-service/server.md msgid "_birthday_service/src/server.rs_:" msgstr "_birthday_service/src/server.rs_:" -#: src/android/aidl/server.md src/android/aidl/client.md +#: src/android/aidl/example-service/server.md msgid "//! Birthday service.\n" msgstr "//! 誕生日サービス。\n" -#: src/android/aidl/server.md +#: src/android/aidl/example-service/server.md msgid "/// Entry point for birthday service.\n" msgstr "/// 誕生日サービスのエントリ ポイント。\n" -#: src/android/aidl/server.md +#: src/android/aidl/example-service/server.md msgid "\"Failed to register service\"" msgstr "\"Failed to register service\"" -#: src/android/aidl/server.md +#: src/android/aidl/example-service/server.md msgid "\"birthday_server\"" msgstr "\"birthday_server\"" -#: src/android/aidl/server.md +#: src/android/aidl/example-service/server.md msgid "\"src/server.rs\"" msgstr "\"src/server.rs\"" -#: src/android/aidl/server.md src/android/aidl/client.md +#: src/android/aidl/example-service/server.md +#: src/android/aidl/example-service/client.md msgid "// To avoid dynamic link error.\n" msgstr "// ダイナミック リンク エラーを回避するためです。\n" -#: src/android/aidl/deploy.md +#: src/android/aidl/example-service/server.md +msgid "" +"The process for taking a user-defined service implementation (in this case " +"the `BirthdayService` type, which implements the `IBirthdayService`) and " +"starting it as a Binder service has multiple steps, and may appear more " +"complicated than students are used to if they've used Binder from C++ or " +"another language. Explain to students why each step is necessary." +msgstr "" + +#: src/android/aidl/example-service/server.md +msgid "Create an instance of your service type (`BirthdayService`)." +msgstr "" + +#: src/android/aidl/example-service/server.md +msgid "" +"Wrap the service object in corresponding `Bn*` type (`BnBirthdayService` in " +"this case). This type is generated by Binder and provides the common Binder " +"functionality that would be provided by the `BnBinder` base class in C++. We " +"don't have inheritance in Rust, so instead we use composition, putting our " +"`BirthdayService` within the generated `BnBinderService`." +msgstr "" + +#: src/android/aidl/example-service/server.md +msgid "" +"Call `add_service`, giving it a service identifier and your service object " +"(the `BnBirthdayService` object in the example)." +msgstr "" + +#: src/android/aidl/example-service/server.md +msgid "" +"Call `join_thread_pool` to add the current thread to Binder's thread pool " +"and start listening for connections." +msgstr "" + +#: src/android/aidl/example-service/deploy.md msgid "We can now build, push, and start the service:" msgstr "次に、サービスをビルド、push、開始します。" -#: src/android/aidl/deploy.md +#: src/android/aidl/example-service/deploy.md msgid "" "```shell\n" "m birthday_server\n" @@ -13135,60 +12952,64 @@ msgstr "" "adb shell /data/local/tmp/birthday_server\n" "```" -#: src/android/aidl/deploy.md +#: src/android/aidl/example-service/deploy.md msgid "In another terminal, check that the service runs:" msgstr "別のターミナルで、サービスが実行されていることを確認します。" -#: src/android/aidl/deploy.md +#: src/android/aidl/example-service/deploy.md msgid "You can also call the service with `service call`:" msgstr "`service call` を使用してサービスを呼び出すこともできます。" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "AIDL Client" msgstr "AIDL クライアント" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "Finally, we can create a Rust client for our new service." msgstr "ようやくここで、新しいサービス用の Rust クライアントを作成します。" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md +#: src/android/aidl/example-service/changing-implementation.md msgid "_birthday_service/src/client.rs_:" msgstr "_birthday_service/src/client.rs_:" -#: src/android/aidl/client.md -msgid "/// Connect to the BirthdayService.\n" -msgstr "/// BirthdayService に接続します。\n" - -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "/// Call the birthday service.\n" msgstr "/// 誕生日サービスを呼び出します。\n" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md src/android/aidl/types/objects.md +#: src/android/aidl/types/parcelables.md +#: src/android/aidl/types/file-descriptor.md msgid "\"Failed to connect to BirthdayService\"" msgstr "\"Failed to connect to BirthdayService\"" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md +#, fuzzy +msgid "// Call the service.\n" +msgstr "/// 誕生日サービスを呼び出します。\n" + +#: src/android/aidl/example-service/client.md msgid "\"{msg}\"" msgstr "\"{msg}\"" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "\"birthday_client\"" msgstr "\"birthday_client\"" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "\"src/client.rs\"" msgstr "\"src/client.rs\"" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "Notice that the client does not depend on `libbirthdayservice`." msgstr "" "クライアントが `libbirthdayservice` に依存していないことに注目してください。" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "Build, push, and run the client on your device:" msgstr "デバイスでクライアントをビルド、push、実行します。" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "" "```shell\n" "m birthday_client\n" @@ -13204,7 +13025,35 @@ msgstr "" "adb shell /data/local/tmp/birthday_client Charlie 60\n" "```" -#: src/android/aidl/changing.md +#: src/android/aidl/example-service/client.md +msgid "" +"`Strong` is the trait object representing the service " +"that the client has connected to." +msgstr "" + +#: src/android/aidl/example-service/client.md +msgid "" +"`Strong` is a custom smart pointer type for Binder. It handles both an in-" +"process ref count for the service trait object, and the global Binder ref " +"count that tracks how many processes have a reference to the object." +msgstr "" + +#: src/android/aidl/example-service/client.md +msgid "" +"Note that the trait object that the client uses to talk to the service uses " +"the exact same trait that the server implements. For a given Binder " +"interface, there is a single Rust trait generated that both client and " +"server use." +msgstr "" + +#: src/android/aidl/example-service/client.md +msgid "" +"Use the same service identifier used when registering the service. This " +"should ideally be defined in a common crate that both the client and server " +"can depend on." +msgstr "" + +#: src/android/aidl/example-service/changing-definition.md msgid "" "Let us extend the API with more functionality: we want to let clients " "specify a list of lines for the birthday card:" @@ -13212,11050 +13061,13109 @@ msgstr "" "APIを拡張して、クライアントが誕生日カードに追加する複数行のメッセージを指定で" "きるようにします。" -#: src/android/logging.md +#: src/android/aidl/example-service/changing-definition.md +msgid "This results in an updated trait definition for `IBirthdayService`:" +msgstr "" + +#: src/android/aidl/example-service/changing-definition.md msgid "" -"You should use the `log` crate to automatically log to `logcat` (on-device) " -"or `stdout` (on-host):" +"Note how the `String[]` in the AIDL definition is translated as a " +"`&[String]` in Rust, i.e. that idiomatic Rust types are used in the " +"generated bindings wherever possible:" msgstr "" -"`log` クレートを使用して、自動的に （デバイス上では）`logcat` または （ホスト" -"上では）`stdout`にログを記録するようにします。" -#: src/android/logging.md -msgid "_hello_rust_logs/Android.bp_:" -msgstr "_hello_rust_logs/Android.bp_:" +#: src/android/aidl/example-service/changing-definition.md +msgid "`in` array arguments are translated to slices." +msgstr "" -#: src/android/logging.md -msgid "\"hello_rust_logs\"" -msgstr "\"hello_rust_logs\"" +#: src/android/aidl/example-service/changing-definition.md +msgid "`out` and `inout` args are translated to `&mut Vec`." +msgstr "" -#: src/android/logging.md -msgid "\"liblog_rust\"" -msgstr "\"liblog_rust\"" +#: src/android/aidl/example-service/changing-definition.md +msgid "Return values are translated to returning a `Vec`." +msgstr "" -#: src/android/logging.md -msgid "\"liblogger\"" -msgstr "\"liblogger\"" +#: src/android/aidl/example-service/changing-implementation.md +msgid "Updating Client and Service" +msgstr "" -#: src/android/logging.md -msgid "_hello_rust_logs/src/main.rs_:" -msgstr "_hello_rust_logs/src/main.rs_:" +#: src/android/aidl/example-service/changing-implementation.md +msgid "Update the client and server code to account for the new API." +msgstr "" -#: src/android/logging.md -msgid "//! Rust logging demo.\n" -msgstr "//! Rust ロギングのデモ。\n" +#: src/android/aidl/example-service/changing-implementation.md +#, fuzzy +msgid "'\\n'" +msgstr "b'\\n'" -#: src/android/logging.md -msgid "/// Logs a greeting.\n" -msgstr "/// 挨拶をログに記録します。\n" +#: src/android/aidl/example-service/changing-implementation.md +msgid "\"Habby birfday to yuuuuu\"" +msgstr "" -#: src/android/logging.md -msgid "\"rust\"" -msgstr "\"rust\"" +#: src/android/aidl/example-service/changing-implementation.md +msgid "\"And also: many more\"" +msgstr "" -#: src/android/logging.md -msgid "\"Starting program.\"" -msgstr "\"Starting program.\"" +#: src/android/aidl/example-service/changing-implementation.md +msgid "" +"TODO: Move code snippets into project files where they'll actually be built?" +msgstr "" -#: src/android/logging.md -msgid "\"Things are going fine.\"" -msgstr "\"Things are going fine.\"" +#: src/android/aidl/types.md +msgid "Working With AIDL Types" +msgstr "" -#: src/android/logging.md -msgid "\"Something went wrong!\"" -msgstr "\"Something went wrong!\"" +#: src/android/aidl/types.md +msgid "AIDL types translate into the appropriate idiomatic Rust type:" +msgstr "" -#: src/android/logging.md src/android/interoperability/with-c/bindgen.md -#: src/android/interoperability/with-c/rust.md -msgid "Build, push, and run the binary on your device:" -msgstr "デバイスでバイナリをビルド、push、実行します。" +#: src/android/aidl/types.md +msgid "Primitive types map (mostly) to idiomatic Rust types." +msgstr "" -#: src/android/logging.md +#: src/android/aidl/types.md +msgid "Collection types like slices, `Vec`s and string types are supported." +msgstr "" + +#: src/android/aidl/types.md msgid "" -"```shell\n" -"m hello_rust_logs\n" -"adb push \"$ANDROID_PRODUCT_OUT/system/bin/hello_rust_logs\" /data/local/" -"tmp\n" -"adb shell /data/local/tmp/hello_rust_logs\n" -"```" +"References to AIDL objects and file handles can be sent between clients and " +"services." msgstr "" -"```shell\n" -"m hello_rust_logs\n" -"adb push \"$ANDROID_PRODUCT_OUT/system/bin/hello_rust_logs\" /data/local/" -"tmp\n" -"adb shell /data/local/tmp/hello_rust_logs\n" -"```" -#: src/android/logging.md -msgid "The logs show up in `adb logcat`:" -msgstr "`adb logcat` でログを表示できます。" +#: src/android/aidl/types.md +msgid "File handles and parcelables are fully supported." +msgstr "" -#: src/android/interoperability.md -msgid "" -"Rust has excellent support for interoperability with other languages. This " -"means that you can:" -msgstr "Rust は他の言語との相互運用性に優れているため、次のことが可能です。" +#: src/android/aidl/types/primitives.md +msgid "Primitive types map (mostly) idiomatically:" +msgstr "" -#: src/android/interoperability.md -msgid "Call Rust functions from other languages." -msgstr "他の言語から Rust 関数を呼び出す。" +#: src/android/aidl/types/primitives.md +#, fuzzy +msgid "AIDL Type" +msgstr "AIDL（Androidインターフェイス定義言語）" -#: src/android/interoperability.md -msgid "Call functions written in other languages from Rust." -msgstr "Rust から他の言語で記述された関数を呼び出す。" +#: src/android/aidl/types/primitives.md src/android/aidl/types/arrays.md +#: src/android/interoperability/cpp/type-mapping.md +msgid "Rust Type" +msgstr "Rust 型" -#: src/android/interoperability.md -msgid "" -"When you call functions in a foreign language we say that you're using a " -"_foreign function interface_, also known as FFI." +#: src/android/aidl/types/primitives.md +msgid "Note" msgstr "" -"他の言語の関数を呼び出す場合は、外部関数インターフェース（FFI: _foreign " -"function interface_）を使用します。" -#: src/android/interoperability/with-c.md -msgid "Interoperability with C" -msgstr "C との相互運用性" +#: src/android/aidl/types/primitives.md +#, fuzzy +msgid "`boolean`" +msgstr "`bool`" -#: src/android/interoperability/with-c.md -msgid "" -"Rust has full support for linking object files with a C calling convention. " -"Similarly, you can export Rust functions and call them from C." +#: src/android/aidl/types/primitives.md +msgid "`byte`" msgstr "" -"Rust は、C の呼び出し規則によるオブジェクト ファイルのリンクを完全にサポート" -"しています。同様に、Rust 関数をエクスポートして C から呼び出すことができま" -"す。" -#: src/android/interoperability/with-c.md -msgid "You can do it by hand if you want:" -msgstr "これは手動で行うこともできます。" +#: src/android/aidl/types/primitives.md +msgid "`i8`" +msgstr "" -#: src/android/interoperability/with-c.md -msgid "\"{x}, {abs_x}\"" -msgstr "\"{x}, {abs_x}\"" +#: src/android/aidl/types/primitives.md +#, fuzzy +msgid "Note that bytes are signed." +msgstr "// 7 バイトを超える値は無効です。\n" -#: src/android/interoperability/with-c.md -msgid "" -"We already saw this in the [Safe FFI Wrapper exercise](../../exercises/day-3/" -"safe-ffi-wrapper.md)." +#: src/android/aidl/types/primitives.md +msgid "`u16`" msgstr "" -"これは、[安全な FFI ラッパーの演習](../../exercises/day-3/safe-ffi-wrapper." -"md)ですでに取り扱いました。" -#: src/android/interoperability/with-c.md -msgid "" -"This assumes full knowledge of the target platform. Not recommended for " -"production." +#: src/android/aidl/types/primitives.md +msgid "Note the usage of `u16`, NOT `u32`." msgstr "" -"これは、ターゲット プラットフォームを完全に理解していることを前提としていま" -"す。本番環境での使用推奨されません。" -#: src/android/interoperability/with-c.md -msgid "We will look at better options next." -msgstr "次に、より良い選択肢を見ていきます。" +#: src/android/aidl/types/primitives.md +msgid "`int`" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "Using Bindgen" -msgstr "Bindgen の使用" +#: src/android/aidl/types/primitives.md +msgid "`i32`" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "" -"The [bindgen](https://rust-lang.github.io/rust-bindgen/introduction.html) " -"tool can auto-generate bindings from a C header file." +#: src/android/aidl/types/primitives.md +msgid "`long`" msgstr "" -"[bindgen](https://rust-lang.github.io/rust-bindgen/introduction.html) ツール" -"を使用すると、C ヘッダー ファイルからバインディングを自動生成できます。" -#: src/android/interoperability/with-c/bindgen.md -msgid "First create a small C library:" -msgstr "まず、小さな C ライブラリを作成します。" +#: src/android/aidl/types/primitives.md +msgid "`i64`" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "_interoperability/bindgen/libbirthday.h_:" -msgstr "_interoperability/bindgen/libbirthday.h_:" +#: src/android/aidl/types/primitives.md +msgid "`float`" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "_interoperability/bindgen/libbirthday.c_:" -msgstr "_interoperability/bindgen/libbirthday.c_:" +#: src/android/aidl/types/primitives.md +msgid "`f32`" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "" -msgstr "" +#: src/android/aidl/types/primitives.md +msgid "`double`" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"libbirthday.h\"" -msgstr "\"libbirthday.h\"" +#: src/android/aidl/types/primitives.md +msgid "`f64`" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"+--------------\\n\"" -msgstr "\"+--------------\\n\"" +#: src/android/aidl/types/arrays.md +msgid "" +"The array types (`T[]`, `byte[]`, and `List`) get translated to the " +"appropriate Rust array type depending on how they are used in the function " +"signature:" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"| Happy Birthday %s!\\n\"" -msgstr "\"| Happy Birthday %s!\\n\"" +#: src/android/aidl/types/arrays.md +#, fuzzy +msgid "Position" +msgstr "説明" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"| Congratulations with the %i years!\\n\"" -msgstr "\"| Congratulations with the %i years!\\n\"" +#: src/android/aidl/types/arrays.md +msgid "`in` argument" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "Add this to your `Android.bp` file:" -msgstr "これを `Android.bp` ファイルに追加します。" +#: src/android/aidl/types/arrays.md +#, fuzzy +msgid "`&[T]`" +msgstr "スライス型" -#: src/android/interoperability/with-c/bindgen.md -msgid "_interoperability/bindgen/Android.bp_:" -msgstr "_interoperability/bindgen/Android.bp_:" +#: src/android/aidl/types/arrays.md +msgid "`out`/`inout` argument" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"libbirthday\"" -msgstr "\"libbirthday\"" +#: src/android/aidl/types/arrays.md +#, fuzzy +msgid "`&mut Vec`" +msgstr "`Vec`" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"libbirthday.c\"" -msgstr "\"libbirthday.c\"" +#: src/android/aidl/types/arrays.md +msgid "Return" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md +#: src/android/aidl/types/arrays.md +#: src/android/interoperability/cpp/type-mapping.md +msgid "`Vec`" +msgstr "`Vec`" + +#: src/android/aidl/types/arrays.md msgid "" -"Create a wrapper header file for the library (not strictly needed in this " -"example):" +"In Android 13 or higher, fixed-size arrays are supported, i.e. `T[N]` " +"becomes `[T; N]`. Fixed-size arrays can have multiple dimensions (e.g. " +"`int[3][4]`). In the Java backend, fixed-size arrays are represented as " +"array types." msgstr "" -"ライブラリのラッパー ヘッダー ファイルを作成します（この例では必須ではありま" -"せん）。" -#: src/android/interoperability/with-c/bindgen.md -msgid "_interoperability/bindgen/libbirthday_wrapper.h_:" -msgstr "_interoperability/bindgen/libbirthday_wrapper.h_:" +#: src/android/aidl/types/arrays.md +msgid "Arrays in parcelable fields always get translated to `Vec`." +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "You can now auto-generate the bindings:" -msgstr "これで、バインディングを自動生成できます。" +#: src/android/aidl/types/objects.md +msgid "" +"AIDL objects can be sent either as a concrete AIDL type or as the type-" +"erased `IBinder` interface:" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"libbirthday_bindgen\"" -msgstr "\"libbirthday_bindgen\"" +#: src/android/aidl/types/objects.md +#, fuzzy +msgid "" +"**birthday_service/aidl/com/example/birthdayservice/IBirthdayInfoProvider." +"aidl**:" +msgstr "" +"_birthday_service/aidl/com/example/birthdayservice/IBirthdayService.aidl_:" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"birthday_bindgen\"" -msgstr "\"birthday_bindgen\"" +#: src/android/aidl/types/objects.md src/android/aidl/types/parcelables.md +#: src/android/aidl/types/file-descriptor.md +#, fuzzy +msgid "" +"**birthday_service/aidl/com/example/birthdayservice/IBirthdayService.aidl**:" +msgstr "" +"_birthday_service/aidl/com/example/birthdayservice/IBirthdayService.aidl_:" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"libbirthday_wrapper.h\"" -msgstr "\"libbirthday_wrapper.h\"" +#: src/android/aidl/types/objects.md +msgid "/** The same thing, but using a binder object. */" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"bindings\"" -msgstr "\"bindings\"" +#: src/android/aidl/types/objects.md +msgid "/** The same thing, but using `IBinder`. */" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "Finally, we can use the bindings in our Rust program:" -msgstr "これで、Rust プログラムでバインディングを使用できます。" +#: src/android/aidl/types/objects.md src/android/aidl/types/parcelables.md +#: src/android/aidl/types/file-descriptor.md +#, fuzzy +msgid "**birthday_service/src/client.rs**:" +msgstr "_birthday_service/src/client.rs_:" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"print_birthday_card\"" -msgstr "\"print_birthday_card\"" +#: src/android/aidl/types/objects.md +#, fuzzy +msgid "/// Rust struct implementing the `IBirthdayInfoProvider` interface.\n" +msgstr "//! `IBirthdayService` AIDL インターフェースの実装。\n" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"main.rs\"" -msgstr "\"main.rs\"" +#: src/android/aidl/types/objects.md +#, fuzzy +msgid "// Create a binder object for the `IBirthdayInfoProvider` interface.\n" +msgstr "//! `IBirthdayService` AIDL インターフェースの実装。\n" -#: src/android/interoperability/with-c/bindgen.md -msgid "_interoperability/bindgen/main.rs_:" -msgstr "_interoperability/bindgen/main.rs_:" +#: src/android/aidl/types/objects.md +#, fuzzy +msgid "// Send the binder object to the service.\n" +msgstr "/// 誕生日サービスを呼び出します。\n" -#: src/android/interoperability/with-c/bindgen.md -msgid "//! Bindgen demo.\n" -msgstr "//! Bindgen のデモ。\n" +#: src/android/aidl/types/objects.md +msgid "" +"// Perform the same operation but passing the provider as an `SpIBinder`.\n" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "// SAFETY: `print_card` is safe to call with a valid `card` pointer.\n" +#: src/android/aidl/types/objects.md +msgid "" +"Note the usage of `BnBirthdayInfoProvider`. This serves the same purpose as " +"`BnBirthdayService` that we saw previously." msgstr "" -"// SAFETY: `print_card` は有効な `card` ポインタで安全に呼び出せます。\n" -#: src/android/interoperability/with-c/bindgen.md +#: src/android/aidl/types/parcelables.md +msgid "Binder for Rust supports sending parcelables directly:" +msgstr "" + +#: src/android/aidl/types/parcelables.md +#, fuzzy msgid "" -"```shell\n" -"m print_birthday_card\n" -"adb push \"$ANDROID_PRODUCT_OUT/system/bin/print_birthday_card\" /data/local/" -"tmp\n" -"adb shell /data/local/tmp/print_birthday_card\n" -"```" +"**birthday_service/aidl/com/example/birthdayservice/BirthdayInfo.aidl**:" msgstr "" -"```shell\n" -"m print_birthday_card\n" -"adb push \"$ANDROID_PRODUCT_OUT/system/bin/print_birthday_card\" /data/local/" -"tmp\n" -"adb shell /data/local/tmp/print_birthday_card\n" -"```" +"_birthday_service/aidl/com/example/birthdayservice/IBirthdayService.aidl_:" -#: src/android/interoperability/with-c/bindgen.md -msgid "Finally, we can run auto-generated tests to ensure the bindings work:" +#: src/android/aidl/types/parcelables.md +msgid "/** The same thing, but with a parcelable. */" msgstr "" -"これで、自動生成されたテストを実行して、バインディングが機能していることを確" -"認できます。" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"libbirthday_bindgen_test\"" -msgstr "\"libbirthday_bindgen_test\"" +#: src/android/aidl/types/file-descriptor.md +msgid "" +"Files can be sent between Binder clients/servers using the " +"`ParcelFileDescriptor` type:" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "\":libbirthday_bindgen\"" -msgstr "\":libbirthday_bindgen\"" +#: src/android/aidl/types/file-descriptor.md +msgid "/** The same thing, but loads info from a file. */" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"general-tests\"" -msgstr "\"general-tests\"" +#: src/android/aidl/types/file-descriptor.md +msgid "// Open a file and put the birthday info in it.\n" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"none\"" -msgstr "\"none\"" +#: src/android/aidl/types/file-descriptor.md +msgid "\"/data/local/tmp/birthday.info\"" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "// Generated file, skip linting\n" -msgstr "// 生成されたファイル、lint チェックをスキップ\n" +#: src/android/aidl/types/file-descriptor.md +#, fuzzy +msgid "\"{name}\"" +msgstr "\"Hello {name}\"" -#: src/android/interoperability/with-c/rust.md -msgid "Calling Rust" -msgstr "Rust の呼び出し" +#: src/android/aidl/types/file-descriptor.md +msgid "\"{years}\"" +msgstr "" -#: src/android/interoperability/with-c/rust.md -msgid "Exporting Rust functions and types to C is easy:" -msgstr "Rust の関数と型は、C に簡単にエクスポートできます。" +#: src/android/aidl/types/file-descriptor.md +msgid "// Create a `ParcelFileDescriptor` from the file and send it.\n" +msgstr "" -#: src/android/interoperability/with-c/rust.md -msgid "_interoperability/rust/libanalyze/analyze.rs_" -msgstr "_interoperability/rust/libanalyze/analyze.rs_" +#: src/android/aidl/types/file-descriptor.md +#, fuzzy +msgid "**birthday_service/src/lib.rs**:" +msgstr "_birthday_service/src/lib.rs_:" -#: src/android/interoperability/with-c/rust.md -msgid "//! Rust FFI demo.\n" -msgstr "//! Rust FFI のデモ。\n" +#: src/android/aidl/types/file-descriptor.md +msgid "" +"// Convert the file descriptor to a `File`. `ParcelFileDescriptor` wraps\n" +" // an `OwnedFd`, which can be cloned and then used to create a " +"`File`\n" +" // object.\n" +msgstr "" -#: src/android/interoperability/with-c/rust.md -msgid "/// Analyze the numbers.\n" -msgstr "/// 数値を分析します。\n" +#: src/android/aidl/types/file-descriptor.md +#, fuzzy +msgid "\"Invalid file handle\"" +msgstr "\"Invalid length\"" -#: src/android/interoperability/with-c/rust.md -msgid "\"x ({x}) is smallest!\"" -msgstr "\"x ({x}) is smallest!\"" +#: src/android/aidl/types/file-descriptor.md +msgid "" +"`ParcelFileDescriptor` wraps an `OwnedFd`, and so can be created from a " +"`File` (or any other type that wraps an `OwnedFd`), and can be used to " +"create a new `File` handle on the other side." +msgstr "" -#: src/android/interoperability/with-c/rust.md -msgid "\"y ({y}) is probably larger than x ({x})\"" -msgstr "\"y ({y}) is probably larger than x ({x})\"" +#: src/android/aidl/types/file-descriptor.md +msgid "" +"Other types of file descriptors can be wrapped and sent, e.g. TCP, UDP, and " +"UNIX sockets." +msgstr "" -#: src/android/interoperability/with-c/rust.md -msgid "_interoperability/rust/libanalyze/analyze.h_" -msgstr "_interoperability/rust/libanalyze/analyze.h_" +#: src/android/testing.md +#, fuzzy +msgid "Testing in Android" +msgstr "Android での Rust へようこそ" -#: src/android/interoperability/with-c/rust.md -msgid "_interoperability/rust/libanalyze/Android.bp_" -msgstr "_interoperability/rust/libanalyze/Android.bp_" +#: src/android/testing.md +msgid "" +"Building on [Testing](../testing.md), we will now look at how unit tests " +"work in AOSP. Use the `rust_test` module for your unit tests:" +msgstr "" -#: src/android/interoperability/with-c/rust.md -msgid "\"libanalyze_ffi\"" -msgstr "\"libanalyze_ffi\"" +#: src/android/testing.md +#, fuzzy +msgid "_testing/Android.bp_:" +msgstr "_hello_rust/Android.bp_:" -#: src/android/interoperability/with-c/rust.md -msgid "\"analyze_ffi\"" -msgstr "\"analyze_ffi\"" +#: src/android/testing.md +#, fuzzy +msgid "\"libleftpad\"" +msgstr "\"libtextwrap\"" -#: src/android/interoperability/with-c/rust.md -msgid "\"analyze.rs\"" -msgstr "\"analyze.rs\"" +#: src/android/testing.md +msgid "\"leftpad\"" +msgstr "" -#: src/android/interoperability/with-c/rust.md -msgid "We can now call this from a C binary:" -msgstr "これで、これを C バイナリから呼び出せるようになりました。" +#: src/android/testing.md +#, fuzzy +msgid "\"libleftpad_test\"" +msgstr "\"libbirthday_bindgen_test\"" -#: src/android/interoperability/with-c/rust.md -msgid "_interoperability/rust/analyze/main.c_" -msgstr "_interoperability/rust/analyze/main.c_" +#: src/android/testing.md +msgid "\"leftpad_test\"" +msgstr "" -#: src/android/interoperability/with-c/rust.md -msgid "\"analyze.h\"" -msgstr "\"analyze.h\"" +#: src/android/testing.md src/android/interoperability/with-c/bindgen.md +msgid "\"general-tests\"" +msgstr "\"general-tests\"" -#: src/android/interoperability/with-c/rust.md -msgid "_interoperability/rust/analyze/Android.bp_" -msgstr "_interoperability/rust/analyze/Android.bp_" +#: src/android/testing.md +#, fuzzy +msgid "_testing/src/lib.rs_:" +msgstr "_hello_rust/src/lib.rs_:" -#: src/android/interoperability/with-c/rust.md -msgid "\"analyze_numbers\"" -msgstr "\"analyze_numbers\"" +#: src/android/testing.md +#, fuzzy +msgid "//! Left-padding library.\n" +msgstr "//! 挨拶ライブラリ。\n" -#: src/android/interoperability/with-c/rust.md -msgid "\"main.c\"" -msgstr "\"main.c\"" +#: src/android/testing.md +msgid "/// Left-pad `s` to `width`.\n" +msgstr "" -#: src/android/interoperability/with-c/rust.md -msgid "" -"```shell\n" -"m analyze_numbers\n" -"adb push \"$ANDROID_PRODUCT_OUT/system/bin/analyze_numbers\" /data/local/" -"tmp\n" -"adb shell /data/local/tmp/analyze_numbers\n" +#: src/android/testing.md +#, fuzzy +msgid "\"{s:>width$}\"" +msgstr "\"|{:^width$}|\"" + +#: src/android/testing.md +#, fuzzy +msgid "\" foo\"" +msgstr "\"foo\"" + +#: src/android/testing.md +#, fuzzy +msgid "\"foobar\"" +msgstr "\"foo\"" + +#: src/android/testing.md +#, fuzzy +msgid "You can now run the test with" +msgstr "これで、バインディングを自動生成できます。" + +#: src/android/testing.md +#, fuzzy +msgid "The output looks like this:" +msgstr "全体的なアプローチは次のようになります。" + +#: src/android/testing.md +msgid "" +"```text\n" +"INFO: Elapsed time: 2.666s, Critical Path: 2.40s\n" +"INFO: 3 processes: 2 internal, 1 linux-sandbox.\n" +"INFO: Build completed successfully, 3 total actions\n" +"//comprehensive-rust-android/testing:libleftpad_test_host PASSED " +"in 2.3s\n" +" PASSED libleftpad_test.tests::long_string (0.0s)\n" +" PASSED libleftpad_test.tests::short_string (0.0s)\n" +"Test cases: finished with 2 passing and 0 failing out of 2 test cases\n" "```" msgstr "" -"```shell\n" -"m analyze_numbers\n" -"adb push \"$ANDROID_PRODUCT_OUT/system/bin/analyze_numbers\" /data/local/" -"tmp\n" -"adb shell /data/local/tmp/analyze_numbers\n" -"```" -#: src/android/interoperability/with-c/rust.md +#: src/android/testing.md msgid "" -"`#[no_mangle]` disables Rust's usual name mangling, so the exported symbol " -"will just be the name of the function. You can also use `#[export_name = " -"\"some_name\"]` to specify whatever name you want." +"Notice how you only mention the root of the library crate. Tests are found " +"recursively in nested modules." msgstr "" -"`#[no_mangle]` により Rust の通常の名前のマングリングが無効になるため、エクス" -"ポートされたシンボルは単に関数の名前になります。`#[export_name = " -"\"some_name\"]` を使用して任意の名前を指定することもできます。" -#: src/android/interoperability/cpp.md +#: src/android/testing/googletest.md msgid "" -"The [CXX crate](https://cxx.rs/) makes it possible to do safe " -"interoperability between Rust and C++." +"The [GoogleTest](https://docs.rs/googletest/) crate allows for flexible test " +"assertions using _matchers_:" msgstr "" -"[CXX クレート](https://cxx.rs/)を使用すると、Rust と C++ の間で安全な相互運用" -"性を確保できます。" +"[GoogleTest](https://docs.rs/googletest/) クレートにより、マッチャーを使用し" +"た柔軟なテスト アサーションが可能になります。" -#: src/android/interoperability/cpp.md -msgid "The overall approach looks like this:" -msgstr "全体的なアプローチは次のようになります。" +#: src/android/testing/googletest.md +msgid "\"baz\"" +msgstr "\"baz\"" -#: src/android/interoperability/cpp/bridge.md +#: src/android/testing/googletest.md +msgid "\"xyz\"" +msgstr "\"xyz\"" + +#: src/android/testing/googletest.md msgid "" -"CXX relies on a description of the function signatures that will be exposed " -"from each language to the other. You provide this description using extern " -"blocks in a Rust module annotated with the `#[cxx::bridge]` attribute macro." +"If we change the last element to `\"!\"`, the test fails with a structured " +"error message pin-pointing the error:" msgstr "" -"CXX は、各言語から他の言語に公開される関数シグネチャの記述に依存します。この" -"記述は、`#[cxx::bridge]` 属性マクロでアノテーションされた Rust モジュール内" -"の extern ブロックを使用して指定します。" - -#: src/android/interoperability/cpp/bridge.md -msgid "\"org::blobstore\"" -msgstr "\"org::blobstore\"" - -#: src/android/interoperability/cpp/bridge.md -msgid "// Shared structs with fields visible to both languages.\n" -msgstr "// 両方の言語からアクセスできるフィールドを持つ共有構造体。\n" - -#: src/android/interoperability/cpp/bridge.md -#: src/android/interoperability/cpp/generated-cpp.md -msgid "// Rust types and signatures exposed to C++.\n" -msgstr "// C++ に公開される Rust の型とシグネチャ。\n" - -#: src/android/interoperability/cpp/bridge.md -#: src/android/interoperability/cpp/rust-bridge.md -#: src/android/interoperability/cpp/generated-cpp.md -#: src/android/interoperability/cpp/rust-result.md -#: src/chromium/interoperability-with-cpp/example-bindings.md -#: src/chromium/interoperability-with-cpp/error-handling-qr.md -#: src/chromium/interoperability-with-cpp/error-handling-png.md -msgid "\"Rust\"" -msgstr "\"Rust\"" - -#: src/android/interoperability/cpp/bridge.md -#: src/android/interoperability/cpp/cpp-bridge.md -msgid "// C++ types and signatures exposed to Rust.\n" -msgstr "// Rust に公開される C++ の型とシグネチャ。\n" - -#: src/android/interoperability/cpp/bridge.md -#: src/android/interoperability/cpp/cpp-bridge.md -#: src/android/interoperability/cpp/cpp-exception.md -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "\"C++\"" -msgstr "\"C++\"" - -#: src/android/interoperability/cpp/bridge.md -#: src/android/interoperability/cpp/cpp-bridge.md -msgid "\"include/blobstore.h\"" -msgstr "\"include/blobstore.h\"" - -#: src/android/interoperability/cpp/bridge.md -msgid "The bridge is generally declared in an `ffi` module within your crate." -msgstr "ブリッジは通常、クレート内の `ffi` モジュールで宣言します。" +"最後の要素を `\"!\"` に変更すると、テストは失敗し、エラー箇所を示す構造化され" +"たエラー メッセージが表示されます。" -#: src/android/interoperability/cpp/bridge.md +#: src/android/testing/googletest.md msgid "" -"From the declarations made in the bridge module, CXX will generate matching " -"Rust and C++ type/function definitions in order to expose those items to " -"both languages." +"GoogleTest is not part of the Rust Playground, so you need to run this " +"example in a local environment. Use `cargo add googletest` to quickly add it " +"to an existing Cargo project." msgstr "" -"ブリッジ モジュールで行われた宣言から、CXX はマッチする Rust と C++ の型 / 関" -"数の定義を生成し、これらのアイテムを両方の言語に公開します。" +"GoogleTest は Rust プレイグラウンドの一部ではないため、この例はローカル環境で" +"実行する必要があります。`cargo add googletest` を使用して、既存の Cargo プロ" +"ジェクトにすばやく追加します。" -#: src/android/interoperability/cpp/bridge.md +#: src/android/testing/googletest.md msgid "" -"To view the generated Rust code, use [cargo-expand](https://github.com/" -"dtolnay/cargo-expand) to view the expanded proc macro. For most of the " -"examples you would use `cargo expand ::ffi` to expand just the `ffi` module " -"(though this doesn't apply for Android projects)." +"The `use googletest::prelude::*;` line imports a number of [commonly used " +"macros and types](https://docs.rs/googletest/latest/googletest/prelude/index." +"html)." msgstr "" -"生成された Rust コードを表示するには、[cargo-expand](https://github.com/" -"dtolnay/cargo-expand) を使用して、展開された proc マクロを表示します。ほとん" -"どの例では、`cargo expand ::ffi` を使用して `ffi` モジュールのみを展開します" -"（ただし、これは Android プロジェクトには当てはまりません）。" - -#: src/android/interoperability/cpp/bridge.md -msgid "To view the generated C++ code, look in `target/cxxbridge`." -msgstr "生成された C++ コードを表示するには、`target/cxxbridge` を確認します。" - -#: src/android/interoperability/cpp/rust-bridge.md -msgid "Rust Bridge Declarations" -msgstr "Rust のブリッジ宣言" - -#: src/android/interoperability/cpp/rust-bridge.md -msgid "// Opaque type\n" -msgstr "// オペーク型\n" +"`use googletest::prelude::*;` 行は、[一般的に使用されるマクロと型](https://" +"docs.rs/googletest/latest/googletest/prelude/index.html)をインポートします。" -#: src/android/interoperability/cpp/rust-bridge.md -msgid "// Method on `MyType`\n" -msgstr "// `MyType` のメソッド\n" +#: src/android/testing/googletest.md +msgid "" +"This just scratches the surface, there are many builtin matchers. Consider " +"going through the first chapter of [\"Advanced testing for Rust " +"applications\"](https://rust-exercises.com/advanced-testing/), a self-guided " +"Rust course: it provides a guided introduction to the library, with " +"exercises to help you get comfortable with `googletest` macros, its matchers " +"and its overall philosophy." +msgstr "" -#: src/android/interoperability/cpp/rust-bridge.md +#: src/android/testing/googletest.md #, fuzzy -msgid "// Free function\n" -msgstr "関数" +msgid "" +"A particularly nice feature is that mismatches in multi-line strings are " +"shown as a diff:" +msgstr "特に便利なのは、複数行の文字列の不一致が差分として表示される機能です。" -#: src/android/interoperability/cpp/rust-bridge.md +#: src/android/testing/googletest.md msgid "" -"Items declared in the `extern \"Rust\"` reference items that are in scope in " -"the parent module." +"\"Memory safety found,\\n\\\n" +" Rust's strong typing guides the way,\\n\\\n" +" Secure code you'll write.\"" msgstr "" -"親モジュールのスコープ内にある `extern \"Rust\"` 参照アイテムで宣言されたアイ" -"テム。" +"\"Memory safety found,\\n\\\n" +" Rust's strong typing guides the way,\\n\\\n" +" Secure code you'll write.\"" -#: src/android/interoperability/cpp/rust-bridge.md +#: src/android/testing/googletest.md msgid "" -"The CXX code generator uses your `extern \"Rust\"` section(s) to produce a C+" -"+ header file containing the corresponding C++ declarations. The generated " -"header has the same path as the Rust source file containing the bridge, " -"except with a .rs.h file extension." +"\"Memory safety found,\\n\\\n" +" Rust's silly humor guides the way,\\n\\\n" +" Secure code you'll write.\"" msgstr "" -"CXX コード ジェネレータは、`extern \"Rust\"` セクションを使用して、対応する " -"C++ 宣言を含む C++ ヘッダー ファイルを生成します。生成されるヘッダーのパス" -"は、rs.hというファイル拡張子部分を除き、ブリッジを含む Rust ソースファイルと" -"同じになります。" - -#: src/android/interoperability/cpp/generated-cpp.md -msgid "Results in (roughly) the following C++:" -msgstr "おおよそ次のような C++ が生成されます。" - -#: src/android/interoperability/cpp/cpp-bridge.md -msgid "C++ Bridge Declarations" -msgstr "C++ のブリッジ宣言" - -#: src/android/interoperability/cpp/cpp-bridge.md -msgid "Results in (roughly) the following Rust:" -msgstr "おおよそ次のような Rust が生成されます。" - -#: src/android/interoperability/cpp/cpp-bridge.md -msgid "\"org$blobstore$cxxbridge1$new_blobstore_client\"" -msgstr "\"org$blobstore$cxxbridge1$new_blobstore_client\"" +"\"Memory safety found,\\n\\\n" +" Rust's silly humor guides the way,\\n\\\n" +" Secure code you'll write.\"" -#: src/android/interoperability/cpp/cpp-bridge.md -msgid "\"org$blobstore$cxxbridge1$BlobstoreClient$put\"" -msgstr "\"org$blobstore$cxxbridge1$BlobstoreClient$put\"" +#: src/android/testing/googletest.md +msgid "shows a color-coded diff (colors not shown here):" +msgstr "これにより、差分が色分けされます（ここでは色分けされていません）。" -#: src/android/interoperability/cpp/cpp-bridge.md +#: src/android/testing/googletest.md msgid "" -"The programmer does not need to promise that the signatures they have typed " -"in are accurate. CXX performs static assertions that the signatures exactly " -"correspond with what is declared in C++." +"The crate is a Rust port of [GoogleTest for C++](https://google.github.io/" +"googletest/)." msgstr "" -"プログラマーは、入力したシグネチャが正確であることを保証する必要はありませ" -"ん。CXX は、シグネチャが C++ で宣言されたものと完全に対応するということを静的" -"に保証します。" +"このクレートは [GoogleTest for C++](https://google.github.io/googletest/) を" +"Rustに移植したものです。" -#: src/android/interoperability/cpp/cpp-bridge.md +#: src/android/testing/mocking.md msgid "" -"`unsafe extern` blocks allow you to declare C++ functions that are safe to " -"call from Rust." +"For mocking, [Mockall](https://docs.rs/mockall/) is a widely used library. " +"You need to refactor your code to use traits, which you can then quickly " +"mock:" msgstr "" -"`unsafe extern` ブロックを使用すると、Rust から安全に呼び出せる C++ 関数を宣" -"言できます。" - -#: src/android/interoperability/cpp/shared-types.md -msgid "// A=1, J=11, Q=12, K=13\n" -msgstr "// A=1、J=11、Q=12、K=13\n" - -#: src/android/interoperability/cpp/shared-types.md -msgid "Only C-like (unit) enums are supported." -msgstr "C のような（単位）列挙型のみがサポートされています。" +"モックには、[Mockall](https://docs.rs/mockall/) というライブラリが広く使用さ" +"れています。トレイトを使用するようにコードをリファクタリングする必要がありま" +"す。これにより、すぐにモックできるようになります。" -#: src/android/interoperability/cpp/shared-types.md +#: src/android/testing/mocking.md +#, fuzzy msgid "" -"A limited number of traits are supported for `#[derive()]` on shared types. " -"Corresponding functionality is also generated for the C++ code, e.g. if you " -"derive `Hash` also generates an implementation of `std::hash` for the " -"corresponding C++ type." +"Mockall is the recommended mocking library in Android (AOSP). There are " +"other [mocking libraries available on crates.io](https://crates.io/keywords/" +"mock), in particular in the area of mocking HTTP services. The other mocking " +"libraries work in a similar fashion as Mockall, meaning that they make it " +"easy to get a mock implementation of a given trait." msgstr "" -"共有型の `#[derive()]` では、サポートされるトレイトの数が限られています。対応" -"する機能は C++ コードでも生成されます。たとえば、`Hash` を導出すると、対応す" -"る C++ 型の `std::hash` の実装も生成されます。" - -#: src/android/interoperability/cpp/shared-enums.md -msgid "Generated Rust:" -msgstr "生成された Rust:" - -#: src/android/interoperability/cpp/shared-enums.md -msgid "Generated C++:" -msgstr "生成された C++:" +"ここでは、Mockall が推奨モック ライブラリである Android（AOSP）向けのアドバイ" +"スを行います。特に HTTP サービスのモックに関しては、[crates.io で他のモック " +"ライブラリが公開されています](https://crates.io/keywords/mock)。他のモック ラ" +"イブラリも Mockall と 同様で、特定のトレイトのモック実装を簡単に得ることがで" +"きます。" -#: src/android/interoperability/cpp/shared-enums.md +#: src/android/testing/mocking.md msgid "" -"On the Rust side, the code generated for shared enums is actually a struct " -"wrapping a numeric value. This is because it is not UB in C++ for an enum " -"class to hold a value different from all of the listed variants, and our " -"Rust representation needs to have the same behavior." +"Note that mocking is somewhat _controversial_: mocks allow you to completely " +"isolate a test from its dependencies. The immediate result is faster and " +"more stable test execution. On the other hand, the mocks can be configured " +"wrongly and return output different from what the real dependencies would do." msgstr "" -"Rust 側では、共有列挙型に対して生成されるコードは、実際には数値をラップした構" -"造体です。これは、列挙型クラスがリストされたすべてのバリアントとは異なる値を" -"保持することは C++ では UB ではなく、Rust 表現は同じ動作をする必要があるため" -"です。" - -#: src/android/interoperability/cpp/rust-result.md -msgid "\"fallible1 requires depth > 0\"" -msgstr "\"fallible1 requires depth > 0\"" - -#: src/android/interoperability/cpp/rust-result.md -msgid "\"Success!\"" -msgstr "\"Success!\"" +"モックを使用する際は少し注意が必要です。モックを使用すると、テストを依存関係" +"から完全に分離できます。その結果、より高速で安定したテスト実行が可能になりま" +"す。一方、モックが誤って構成され、実際の依存関係の動作とは異なる出力が返され" +"る可能性があります。" -#: src/android/interoperability/cpp/rust-result.md +#: src/android/testing/mocking.md msgid "" -"Rust functions that return `Result` are translated to exceptions on the C++ " -"side." -msgstr "`Result` を返す Rust 関数は、C++ 側で例外に変換されます。" +"If at all possible, it is recommended that you use the real dependencies. As " +"an example, many databases allow you to configure an in-memory backend. This " +"means that you get the correct behavior in your tests, plus they are fast " +"and will automatically clean up after themselves." +msgstr "" +"可能な限り、実際の依存関係を使用することをおすすめします。たとえば、多くの" +"データベースではインメモリ バックエンドを構成できます。つまり、テストで正しい" +"動作が得られ、しかも高速で、テスト後は自動的にクリーンアップされます。" -#: src/android/interoperability/cpp/rust-result.md +#: src/android/testing/mocking.md msgid "" -"The exception thrown will always be of type `rust::Error`, which primarily " -"exposes a way to get the error message string. The error message will come " -"from the error type's `Display` impl." +"Similarly, many web frameworks allow you to start an in-process server which " +"binds to a random port on `localhost`. Always prefer this over mocking away " +"the framework since it helps you test your code in the real environment." msgstr "" -"スローされる例外は常に `rust::Error` 型で、主にエラー メッセージの文字列を取" -"得する手段を提供します。エラー メッセージは、エラー型の `Display` の実装から" -"取得されます。" +"同様に、多くのウェブ フレームワークでは、`localhost` 上のランダムなポートにバ" +"インドするプロセス内サーバーを起動できます。このような構成は実際の環境でコー" +"ドをテストすることを可能にするので、フレームワークをモックすることよりも常に" +"優先して利用しましょう。" -#: src/android/interoperability/cpp/rust-result.md +#: src/android/testing/mocking.md msgid "" -"A panic unwinding from Rust to C++ will always cause the process to " -"immediately terminate." +"Mockall is not part of the Rust Playground, so you need to run this example " +"in a local environment. Use `cargo add mockall` to quickly add Mockall to an " +"existing Cargo project." msgstr "" -"Rust から C++ にパニック アンワインドを行うと、プロセスは必ず直ちに終了しま" -"す。" - -#: src/android/interoperability/cpp/cpp-exception.md -msgid "\"example/include/example.h\"" -msgstr "\"example/include/example.h\"" +"Mockall は Rust プレイグラウンドの一部ではないため、この例はローカル環境で実" +"行する必要があります。`cargo add mockall` を使用して、Mockall を既存の Cargo " +"プロジェクトにすばやく追加します。" -#: src/android/interoperability/cpp/cpp-exception.md -msgid "\"Error: {}\"" -msgstr "\"Error: {}\"" +#: src/android/testing/mocking.md +msgid "" +"Mockall has a lot more functionality. In particular, you can set up " +"expectations which depend on the arguments passed. Here we use this to mock " +"a cat which becomes hungry 3 hours after the last time it was fed:" +msgstr "" +"Mockall にはさらに多くの機能があります。特に、渡される引数に応じて期待値を設" +"定できます。ここでは、最後に餌を与えてらえてから 3 時間後に空腹になる猫をモッ" +"クするためにこれを使用します。" -#: src/android/interoperability/cpp/cpp-exception.md +#: src/android/testing/mocking.md msgid "" -"C++ functions declared to return a `Result` will catch any thrown exception " -"on the C++ side and return it as an `Err` value to the calling Rust function." +"You can use `.times(n)` to limit the number of times a mock method can be " +"called to `n` --- the mock will automatically panic when dropped if this " +"isn't satisfied." msgstr "" -"`Result` を返すように宣言された C++ 関数は、C++ 側でスローされたあらゆる例外" -"をキャッチし、呼び出し元の Rust 関数に `Err` 値として返します。" +"`.times(n)` を使用すると、モックメソッドが呼び出される回数を`n` に制限できま" +"す。これが満たされない場合、モックはドロップ時に自動的にパニックになります。" -#: src/android/interoperability/cpp/cpp-exception.md +#: src/android/logging.md msgid "" -"If an exception is thrown from an extern \"C++\" function that is not " -"declared by the CXX bridge to return `Result`, the program calls C++'s `std::" -"terminate`. The behavior is equivalent to the same exception being thrown " -"through a `noexcept` C++ function." +"You should use the `log` crate to automatically log to `logcat` (on-device) " +"or `stdout` (on-host):" msgstr "" -"CXX ブリッジでResultを返すように宣言されていないextern \"C++\"関数から例外が" -"スローされると、`Result`が返されると、プログラムは C++ の`std::terminate`を呼" -"び出します。この動作は、同じ例外が`noexcept` C++ 関数でスローされた場合と同等" -"です。" +"`log` クレートを使用して、自動的に （デバイス上では）`logcat` または （ホスト" +"上では）`stdout`にログを記録するようにします。" -#: src/android/interoperability/cpp/type-mapping.md -msgid "Rust Type" -msgstr "Rust 型" +#: src/android/logging.md +msgid "_hello_rust_logs/Android.bp_:" +msgstr "_hello_rust_logs/Android.bp_:" -#: src/android/interoperability/cpp/type-mapping.md -msgid "C++ Type" -msgstr "C++ 型" +#: src/android/logging.md +msgid "\"hello_rust_logs\"" +msgstr "\"hello_rust_logs\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`rust::String`" -msgstr "`rust::String`" +#: src/android/logging.md +msgid "\"liblog_rust\"" +msgstr "\"liblog_rust\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`&str`" -msgstr "`&str`" +#: src/android/logging.md +msgid "\"liblogger\"" +msgstr "\"liblogger\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`rust::Str`" -msgstr "`rust::Str`" +#: src/android/logging.md +msgid "_hello_rust_logs/src/main.rs_:" +msgstr "_hello_rust_logs/src/main.rs_:" -#: src/android/interoperability/cpp/type-mapping.md -#, fuzzy -msgid "`CxxString`" -msgstr "`CxxString`" +#: src/android/logging.md +msgid "//! Rust logging demo.\n" +msgstr "//! Rust ロギングのデモ。\n" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`std::string`" -msgstr "`std::string`" +#: src/android/logging.md +msgid "/// Logs a greeting.\n" +msgstr "/// 挨拶をログに記録します。\n" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`&[T]`/`&mut [T]`" -msgstr "`&[T]`/`&mut [T]`" +#: src/android/logging.md +msgid "\"rust\"" +msgstr "\"rust\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`rust::Slice`" -msgstr "`rust::Slice`" +#: src/android/logging.md +msgid "\"Starting program.\"" +msgstr "\"Starting program.\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`rust::Box`" -msgstr "`rust::Box`" +#: src/android/logging.md +msgid "\"Things are going fine.\"" +msgstr "\"Things are going fine.\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`UniquePtr`" -msgstr "`UniquePtr`" +#: src/android/logging.md +msgid "\"Something went wrong!\"" +msgstr "\"Something went wrong!\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`std::unique_ptr`" -msgstr "`std::unique_ptr`" +#: src/android/logging.md src/android/interoperability/with-c/bindgen.md +#: src/android/interoperability/with-c/rust.md +msgid "Build, push, and run the binary on your device:" +msgstr "デバイスでバイナリをビルド、push、実行します。" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`Vec`" -msgstr "`Vec`" +#: src/android/logging.md +msgid "" +"```shell\n" +"m hello_rust_logs\n" +"adb push \"$ANDROID_PRODUCT_OUT/system/bin/hello_rust_logs\" /data/local/" +"tmp\n" +"adb shell /data/local/tmp/hello_rust_logs\n" +"```" +msgstr "" +"```shell\n" +"m hello_rust_logs\n" +"adb push \"$ANDROID_PRODUCT_OUT/system/bin/hello_rust_logs\" /data/local/" +"tmp\n" +"adb shell /data/local/tmp/hello_rust_logs\n" +"```" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`rust::Vec`" -msgstr "`rust::Vec`" +#: src/android/logging.md +msgid "The logs show up in `adb logcat`:" +msgstr "`adb logcat` でログを表示できます。" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`CxxVector`" -msgstr "`CxxVector`" +#: src/android/interoperability.md +msgid "" +"Rust has excellent support for interoperability with other languages. This " +"means that you can:" +msgstr "Rust は他の言語との相互運用性に優れているため、次のことが可能です。" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`std::vector`" -msgstr "`std::vector`" +#: src/android/interoperability.md +msgid "Call Rust functions from other languages." +msgstr "他の言語から Rust 関数を呼び出す。" -#: src/android/interoperability/cpp/type-mapping.md -msgid "" -"These types can be used in the fields of shared structs and the arguments " -"and returns of extern functions." -msgstr "" -"これらの型は、共有構造体のフィールドと、extern 関数の引数と戻り値で使用できま" -"す。" +#: src/android/interoperability.md +msgid "Call functions written in other languages from Rust." +msgstr "Rust から他の言語で記述された関数を呼び出す。" -#: src/android/interoperability/cpp/type-mapping.md +#: src/android/interoperability.md msgid "" -"Note that Rust's `String` does not map directly to `std::string`. There are " -"a few reasons for this:" +"When you call functions in a foreign language we say that you're using a " +"_foreign function interface_, also known as FFI." msgstr "" -"Rust の `String` は `std::string` に直接マッピングされません。これには次のよ" -"うな理由があります。" +"他の言語の関数を呼び出す場合は、外部関数インターフェース（FFI: _foreign " +"function interface_）を使用します。" -#: src/android/interoperability/cpp/type-mapping.md -msgid "" -"`std::string` does not uphold the UTF-8 invariant that `String` requires." -msgstr "`std::string` は、`String` が必要とする UTF-8 不変条件を満たしません。" +#: src/android/interoperability/with-c.md +msgid "Interoperability with C" +msgstr "C との相互運用性" -#: src/android/interoperability/cpp/type-mapping.md +#: src/android/interoperability/with-c.md msgid "" -"The two types have different layouts in memory and so can't be passed " -"directly between languages." +"Rust has full support for linking object files with a C calling convention. " +"Similarly, you can export Rust functions and call them from C." msgstr "" -"この 2 つの型はメモリ内のレイアウトが異なるため、言語間で直接渡すことはできま" -"せん。" +"Rust は、C の呼び出し規則によるオブジェクト ファイルのリンクを完全にサポート" +"しています。同様に、Rust 関数をエクスポートして C から呼び出すことができま" +"す。" -#: src/android/interoperability/cpp/type-mapping.md -msgid "" -"`std::string` requires move constructors that don't match Rust's move " -"semantics, so a `std::string` can't be passed by value to Rust." +#: src/android/interoperability/with-c.md +msgid "You can do it by hand if you want:" +msgstr "これは手動で行うこともできます。" + +#: src/android/interoperability/with-c.md +msgid "// SAFETY: `abs` doesn't have any safety requirements.\n" msgstr "" -"`std::string` は、Rust のムーブ セマンティクスと一致しないムーブコンストラク" -"タを必要とするため、`std::string` を Rust に値で渡すことはできません。" -#: src/android/interoperability/cpp/android-build-cpp.md -#: src/android/interoperability/cpp/android-cpp-genrules.md -#: src/android/interoperability/cpp/android-build-rust.md +#: src/android/interoperability/with-c.md +msgid "\"{x}, {abs_x}\"" +msgstr "\"{x}, {abs_x}\"" + +#: src/android/interoperability/with-c.md #, fuzzy -msgid "Building in Android" -msgstr "Android 向けのビルド" +msgid "" +"We already saw this in the [Safe FFI Wrapper exercise](../../unsafe-rust/" +"exercise.md)." +msgstr "" +"これは、[安全な FFI ラッパーの演習](../../exercises/day-3/safe-ffi-wrapper." +"md)ですでに取り扱いました。" -#: src/android/interoperability/cpp/android-build-cpp.md +#: src/android/interoperability/with-c.md msgid "" -"Create a `cc_library_static` to build the C++ library, including the CXX " -"generated header and source file." +"This assumes full knowledge of the target platform. Not recommended for " +"production." msgstr "" -"`cc_library_static` を作成して、CXX で生成されたヘッダーとソースファイルを含" -"む C++ ライブラリをビルドします。" +"これは、ターゲット プラットフォームを完全に理解していることを前提としていま" +"す。本番環境での使用推奨されません。" -#: src/android/interoperability/cpp/android-build-cpp.md -#: src/android/interoperability/cpp/android-build-rust.md -msgid "\"libcxx_test_cpp\"" -msgstr "\"libcxx_test_cpp\"" +#: src/android/interoperability/with-c.md +msgid "We will look at better options next." +msgstr "次に、より良い選択肢を見ていきます。" -#: src/android/interoperability/cpp/android-build-cpp.md -msgid "\"cxx_test.cpp\"" -msgstr "\"cxx_test.cpp\"" - -#: src/android/interoperability/cpp/android-build-cpp.md -msgid "\"cxx-bridge-header\"" -msgstr "\"cxx-bridge-header\"" - -#: src/android/interoperability/cpp/android-build-cpp.md -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "\"libcxx_test_bridge_header\"" -msgstr "\"libcxx_test_bridge_header\"" - -#: src/android/interoperability/cpp/android-build-cpp.md -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "\"libcxx_test_bridge_code\"" -msgstr "\"libcxx_test_bridge_code\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "Using Bindgen" +msgstr "Bindgen の使用" -#: src/android/interoperability/cpp/android-build-cpp.md +#: src/android/interoperability/with-c/bindgen.md msgid "" -"Point out that `libcxx_test_bridge_header` and `libcxx_test_bridge_code` are " -"the dependencies for the CXX-generated C++ bindings. We'll show how these " -"are setup on the next slide." +"The [bindgen](https://rust-lang.github.io/rust-bindgen/introduction.html) " +"tool can auto-generate bindings from a C header file." msgstr "" -"`libcxx_test_bridge_header` と `libcxx_test_bridge_code` が、CXX CXXにより生" -"成される C++ バインディングに対する依存関係であることを説明します。次のスライ" -"ドで、これらがどのような記述になっているかを説明します。" +"[bindgen](https://rust-lang.github.io/rust-bindgen/introduction.html) ツール" +"を使用すると、C ヘッダー ファイルからバインディングを自動生成できます。" -#: src/android/interoperability/cpp/android-build-cpp.md -msgid "" -"Note that you also need to depend on the `cxx-bridge-header` library in " -"order to pull in common CXX definitions." -msgstr "" -"また、一般的な CXX 定義を取得するためには、`cxx-bridge-header` ライブラリに依" -"存する必要があることにも注意してください。" +#: src/android/interoperability/with-c/bindgen.md +msgid "First create a small C library:" +msgstr "まず、小さな C ライブラリを作成します。" -#: src/android/interoperability/cpp/android-build-cpp.md -msgid "" -"Full docs for using CXX in Android can be found in [the Android docs]" -"(https://source.android.com/docs/setup/build/rust/building-rust-modules/" -"android-rust-patterns#rust-cpp-interop-using-cxx). You may want to share " -"that link with the class so that students know where they can find these " -"instructions again in the future." -msgstr "" -"Android で CXX を使用するための詳細なドキュメントについては、[Android のド" -"キュメント](https://source.android.com/docs/setup/build/rust/building-rust-" -"modules/android-rust-patterns#rust-cpp-interop-using-cxx)をご覧ください。その" -"リンクをクラスと共有して、受講者が後で手順を確認できるようにすることをおすす" -"めします。" +#: src/android/interoperability/with-c/bindgen.md +msgid "_interoperability/bindgen/libbirthday.h_:" +msgstr "_interoperability/bindgen/libbirthday.h_:" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "" -"Create two genrules: One to generate the CXX header, and one to generate the " -"CXX source file. These are then used as inputs to the `cc_library_static`." -msgstr "" -"genrule を 2 つ作成します。1 つは CXX ヘッダーの生成用、もう 1 つは CXX ソー" -"スファイルの生成用です。これらは `cc_library_static` への入力として使用されま" -"す。" +#: src/android/interoperability/with-c/bindgen.md +msgid "_interoperability/bindgen/libbirthday.c_:" +msgstr "_interoperability/bindgen/libbirthday.c_:" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "" -"// Generate a C++ header containing the C++ bindings\n" -"// to the Rust exported functions in lib.rs.\n" -msgstr "" -"// lib.rs にある Rustからエクスポートされた関数に対する\n" -"// C++ バインディングを含む C++ ヘッダーを生成します。\n" +#: src/android/interoperability/with-c/bindgen.md +msgid "" +msgstr "" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "\"cxxbridge\"" -msgstr "\"cxxbridge\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday.h\"" +msgstr "\"libbirthday.h\"" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "\"$(location cxxbridge) $(in) --header > $(out)\"" -msgstr "\"$(location cxxbridge) $(in) --header > $(out)\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"+--------------\\n\"" +msgstr "\"+--------------\\n\"" -#: src/android/interoperability/cpp/android-cpp-genrules.md -#: src/android/interoperability/cpp/android-build-rust.md -msgid "\"lib.rs\"" -msgstr "\"lib.rs\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"| Happy Birthday %s!\\n\"" +msgstr "\"| Happy Birthday %s!\\n\"" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "\"lib.rs.h\"" -msgstr "\"lib.rs.h\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"| Congratulations with the %i years!\\n\"" +msgstr "\"| Congratulations with the %i years!\\n\"" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "// Generate the C++ code that Rust calls into.\n" -msgstr "// Rust が呼び出す C++ コードを生成します。\n" +#: src/android/interoperability/with-c/bindgen.md +msgid "Add this to your `Android.bp` file:" +msgstr "これを `Android.bp` ファイルに追加します。" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "\"$(location cxxbridge) $(in) > $(out)\"" -msgstr "\"$(location cxxbridge) $(in) > $(out)\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "_interoperability/bindgen/Android.bp_:" +msgstr "_interoperability/bindgen/Android.bp_:" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "\"lib.rs.cc\"" -msgstr "\"lib.rs.cc\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday\"" +msgstr "\"libbirthday\"" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "" -"The `cxxbridge` tool is a standalone tool that generates the C++ side of the " -"bridge module. It is included in Android and available as a Soong tool." -msgstr "" -"`cxxbridge` ツールは、ブリッジ モジュールの C++ 側を生成するスタンドアロン " -"ツールです。Android に組み込まれており、Soong ツールとして利用できます。" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday.c\"" +msgstr "\"libbirthday.c\"" -#: src/android/interoperability/cpp/android-cpp-genrules.md +#: src/android/interoperability/with-c/bindgen.md msgid "" -"By convention, if your Rust source file is `lib.rs` your header file will be " -"named `lib.rs.h` and your source file will be named `lib.rs.cc`. This naming " -"convention isn't enforced, though." +"Create a wrapper header file for the library (not strictly needed in this " +"example):" msgstr "" -"慣例として、Rust ソースファイルが `lib.rs` の場合、ヘッダー ファイルの名前は " -"`lib.rs.h`、ソースファイルの名前は `lib.rs.cc` となります。ただし、この命名規" -"則は強制ではありません。" +"ライブラリのラッパー ヘッダー ファイルを作成します（この例では必須ではありま" +"せん）。" -#: src/android/interoperability/cpp/android-build-rust.md -msgid "" -"Create a `rust_binary` that depends on `libcxx` and your `cc_library_static`." -msgstr "`libcxx` と `cc_library_static`に依存する `rust_binary` を作成します。" +#: src/android/interoperability/with-c/bindgen.md +msgid "_interoperability/bindgen/libbirthday_wrapper.h_:" +msgstr "_interoperability/bindgen/libbirthday_wrapper.h_:" -#: src/android/interoperability/cpp/android-build-rust.md -msgid "\"cxx_test\"" -msgstr "\"cxx_test\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "You can now auto-generate the bindings:" +msgstr "これで、バインディングを自動生成できます。" -#: src/android/interoperability/cpp/android-build-rust.md -msgid "\"libcxx\"" -msgstr "\"libcxx\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday_bindgen\"" +msgstr "\"libbirthday_bindgen\"" -#: src/android/interoperability/java.md -msgid "Interoperability with Java" -msgstr "Java との相互運用性" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"birthday_bindgen\"" +msgstr "\"birthday_bindgen\"" -#: src/android/interoperability/java.md -msgid "" -"Java can load shared objects via [Java Native Interface (JNI)](https://en." -"wikipedia.org/wiki/Java_Native_Interface). The [`jni` crate](https://docs.rs/" -"jni/) allows you to create a compatible library." -msgstr "" -"Java では、[Java Native Interface（JNI）](https://en.wikipedia.org/wiki/" -"Java_Native_Interface) を介して共有オブジェクトを読み込むことができます。" -"[`jni` クレート](https://docs.rs/jni/) を使用すると、互換性のあるライブラリを" -"作成できます。" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday_wrapper.h\"" +msgstr "\"libbirthday_wrapper.h\"" -#: src/android/interoperability/java.md -msgid "First, we create a Rust function to export to Java:" -msgstr "まず、Java にエクスポートする Rust 関数を作成します。" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"bindings\"" +msgstr "\"bindings\"" -#: src/android/interoperability/java.md -msgid "_interoperability/java/src/lib.rs_:" -msgstr "_interoperability/java/src/lib.rs_:" +#: src/android/interoperability/with-c/bindgen.md +msgid "Finally, we can use the bindings in our Rust program:" +msgstr "これで、Rust プログラムでバインディングを使用できます。" -#: src/android/interoperability/java.md -msgid "//! Rust <-> Java FFI demo.\n" -msgstr "//! Rust <-> Java FFI のデモ。\n" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"print_birthday_card\"" +msgstr "\"print_birthday_card\"" -#: src/android/interoperability/java.md -msgid "/// HelloWorld::hello method implementation.\n" -msgstr "/// HelloWorld::hello メソッドの実装。\n" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"main.rs\"" +msgstr "\"main.rs\"" -#: src/android/interoperability/java.md -msgid "\"system\"" -msgstr "\"system\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "_interoperability/bindgen/main.rs_:" +msgstr "_interoperability/bindgen/main.rs_:" -#: src/android/interoperability/java.md -msgid "\"Hello, {input}!\"" -msgstr "\"Hello, {input}!\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "//! Bindgen demo.\n" +msgstr "//! Bindgen のデモ。\n" -#: src/android/interoperability/java.md -msgid "_interoperability/java/Android.bp_:" -msgstr "_interoperability/java/Android.bp_:" +#: src/android/interoperability/with-c/bindgen.md +msgid "" +"// SAFETY: The pointer we pass is valid because it came from a Rust\n" +" // reference, and the `name` it contains refers to `name` above which " +"also\n" +" // remains valid. `print_card` doesn't store either pointer to use " +"later\n" +" // after it returns.\n" +msgstr "" -#: src/android/interoperability/java.md -msgid "\"libhello_jni\"" -msgstr "\"libhello_jni\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "" +"```shell\n" +"m print_birthday_card\n" +"adb push \"$ANDROID_PRODUCT_OUT/system/bin/print_birthday_card\" /data/local/" +"tmp\n" +"adb shell /data/local/tmp/print_birthday_card\n" +"```" +msgstr "" +"```shell\n" +"m print_birthday_card\n" +"adb push \"$ANDROID_PRODUCT_OUT/system/bin/print_birthday_card\" /data/local/" +"tmp\n" +"adb shell /data/local/tmp/print_birthday_card\n" +"```" -#: src/android/interoperability/java.md -msgid "\"hello_jni\"" -msgstr "\"hello_jni\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "Finally, we can run auto-generated tests to ensure the bindings work:" +msgstr "" +"これで、自動生成されたテストを実行して、バインディングが機能していることを確" +"認できます。" -#: src/android/interoperability/java.md -msgid "\"libjni\"" -msgstr "\"libjni\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday_bindgen_test\"" +msgstr "\"libbirthday_bindgen_test\"" -#: src/android/interoperability/java.md -msgid "We then call this function from Java:" -msgstr "次に、Java からこの関数を呼び出します。" +#: src/android/interoperability/with-c/bindgen.md +msgid "\":libbirthday_bindgen\"" +msgstr "\":libbirthday_bindgen\"" -#: src/android/interoperability/java.md -msgid "_interoperability/java/HelloWorld.java_:" -msgstr "_interoperability/java/HelloWorld.java_:" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"none\"" +msgstr "\"none\"" -#: src/android/interoperability/java.md -msgid "\"helloworld_jni\"" -msgstr "\"helloworld_jni\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "// Generated file, skip linting\n" +msgstr "// 生成されたファイル、lint チェックをスキップ\n" -#: src/android/interoperability/java.md -msgid "\"HelloWorld.java\"" -msgstr "\"HelloWorld.java\"" +#: src/android/interoperability/with-c/rust.md +msgid "Calling Rust" +msgstr "Rust の呼び出し" -#: src/android/interoperability/java.md -msgid "\"HelloWorld\"" -msgstr "\"HelloWorld\"" +#: src/android/interoperability/with-c/rust.md +msgid "Exporting Rust functions and types to C is easy:" +msgstr "Rust の関数と型は、C に簡単にエクスポートできます。" -#: src/android/interoperability/java.md -msgid "Finally, you can build, sync, and run the binary:" -msgstr "最後に、バイナリをビルド、同期、実行します。" +#: src/android/interoperability/with-c/rust.md +msgid "_interoperability/rust/libanalyze/analyze.rs_" +msgstr "_interoperability/rust/libanalyze/analyze.rs_" -#: src/exercises/android/morning.md -msgid "" -"This is a group exercise: We will look at one of the projects you work with " -"and try to integrate some Rust into it. Some suggestions:" -msgstr "" -"これはグループ演習です。皆さんが取り組んでいるプロジェクトの一つを題材に、そ" -"こに Rust を統合してみましょう。以下にヒントを示します。" +#: src/android/interoperability/with-c/rust.md +msgid "//! Rust FFI demo.\n" +msgstr "//! Rust FFI のデモ。\n" -#: src/exercises/android/morning.md -msgid "Call your AIDL service with a client written in Rust." -msgstr "Rust で記述されたクライアントを使用して AIDL サービスを呼び出します。" +#: src/android/interoperability/with-c/rust.md +msgid "/// Analyze the numbers.\n" +msgstr "/// 数値を分析します。\n" -#: src/exercises/android/morning.md -msgid "Move a function from your project to Rust and call it." -msgstr "プロジェクトから Rust に関数を移動して呼び出します。" +#: src/android/interoperability/with-c/rust.md +msgid "\"x ({x}) is smallest!\"" +msgstr "\"x ({x}) is smallest!\"" -#: src/exercises/android/morning.md -msgid "" -"No solution is provided here since this is open-ended: it relies on someone " -"in the class having a piece of code which you can turn in to Rust on the fly." -msgstr "" -"この演習は自由回答形式であるため、解答は用意されていません。クラスの誰かが" -"コードを持っていて、その場で Rust に変換できることを前提としています。" +#: src/android/interoperability/with-c/rust.md +msgid "\"y ({y}) is probably larger than x ({x})\"" +msgstr "\"y ({y}) is probably larger than x ({x})\"" -#: src/chromium.md -msgid "Welcome to Rust in Chromium" -msgstr "Chromium の Rust へようこそ" +#: src/android/interoperability/with-c/rust.md +msgid "_interoperability/rust/libanalyze/analyze.h_" +msgstr "_interoperability/rust/libanalyze/analyze.h_" -#: src/chromium.md -msgid "" -"Rust is supported for third-party libraries in Chromium, with first-party " -"glue code to connect between Rust and existing Chromium C++ code." -msgstr "" -"Rust は Chromium のサードパーティ ライブラリでサポートされています。Rust と既" -"存の Chromium C++ コードを接続するには、ファースト パーティのグルーコードを使" -"用します。" +#: src/android/interoperability/with-c/rust.md +msgid "_interoperability/rust/libanalyze/Android.bp_" +msgstr "_interoperability/rust/libanalyze/Android.bp_" -#: src/chromium.md -msgid "" -"Today, we'll call into Rust to do something silly with strings. If you've " -"got a corner of the code where you're displaying a UTF8 string to the user, " -"feel free to follow this recipe in your part of the codebase instead of the " -"exact part we talk about." -msgstr "" -"本日は、Rust で文字列を使って面白いことをしたいと思います。もし自分の担当部分" -"にUTF8 文字列を表示するコードがある場合は、ここで述べた部分ではなく、自分の" -"コードに対してこの手順を実行して構いません。" +#: src/android/interoperability/with-c/rust.md +msgid "\"libanalyze_ffi\"" +msgstr "\"libanalyze_ffi\"" -#: src/chromium/setup.md -msgid "" -"Make sure you can build and run Chromium. Any platform and set of build " -"flags is OK, so long as your code is relatively recent (commit position " -"1223636 onwards, corresponding to November 2023):" -msgstr "" -"Chromium をビルドして実行できることを確認します。コードが比較的最近のもの" -"（2023 年 11 月に対応するコミット位置 1223636 以降）であれば、任意のプラット" -"フォームとビルドフラグのセットで問題ありません。" +#: src/android/interoperability/with-c/rust.md +msgid "\"analyze_ffi\"" +msgstr "\"analyze_ffi\"" -#: src/chromium/setup.md -msgid "" -"(A component, debug build is recommended for quickest iteration time. This " -"is the default!)" -msgstr "" -"（反復処理の時間を最短にするには、コンポーネントのデバッグビルドをおすすめし" -"ます。これがデフォルトです）" +#: src/android/interoperability/with-c/rust.md +msgid "\"analyze.rs\"" +msgstr "\"analyze.rs\"" -#: src/chromium/setup.md -msgid "" -"See [How to build Chromium](https://www.chromium.org/developers/how-tos/get-" -"the-code/) if you aren't already at that point. Be warned: setting up to " -"build Chromium takes time." -msgstr "" -"まだ確認していない場合は、[Chromium のビルド方法](https://www.chromium.org/" -"developers/how-tos/get-the-code/) を確認してください。なお、Chromium をビルド" -"するためのセットアップには時間がかかります。" +#: src/android/interoperability/with-c/rust.md +msgid "We can now call this from a C binary:" +msgstr "これで、これを C バイナリから呼び出せるようになりました。" -#: src/chromium/setup.md -msgid "It's also recommended that you have Visual Studio code installed." -msgstr "また、Visual Studio Code をインストールしておくことをおすすめします。" +#: src/android/interoperability/with-c/rust.md +msgid "_interoperability/rust/analyze/main.c_" +msgstr "_interoperability/rust/analyze/main.c_" -#: src/chromium/setup.md -msgid "About the exercises" -msgstr "演習について" +#: src/android/interoperability/with-c/rust.md +msgid "\"analyze.h\"" +msgstr "\"analyze.h\"" -#: src/chromium/setup.md -msgid "" -"This part of the course has a series of exercises which build on each other. " -"We'll be doing them spread throughout the course instead of just at the end. " -"If you don't have time to complete a certain part, don't worry: you can " -"catch up in the next slot." -msgstr "" -"コースのこのパートには、相互に関連した一連の演習があります。コースの最後だけ" -"でなく、全体を通して演習を行います。特定のパートを完了する時間がない場合も、" -"後で追いつけばよいため心配はいりません。" +#: src/android/interoperability/with-c/rust.md +msgid "_interoperability/rust/analyze/Android.bp_" +msgstr "_interoperability/rust/analyze/Android.bp_" -#: src/chromium/cargo.md -msgid "" -"Rust community typically uses `cargo` and libraries from [crates.io](https://" -"crates.io/). Chromium is built using `gn` and `ninja` and a curated set of " -"dependencies." -msgstr "" -"Rust コミュニティでは通常、`cargo` と [crates.io](https://crates.io/) のライ" -"ブラリを使用します。Chromium は、`gn` と `ninja`、および厳選された依存関係の" -"セットを使用してビルドされています。" +#: src/android/interoperability/with-c/rust.md +msgid "\"analyze_numbers\"" +msgstr "\"analyze_numbers\"" -#: src/chromium/cargo.md -msgid "When writing code in Rust, your choices are:" -msgstr "Rust でコードを記述する際は、次の選択肢があります。" +#: src/android/interoperability/with-c/rust.md +msgid "\"main.c\"" +msgstr "\"main.c\"" -#: src/chromium/cargo.md +#: src/android/interoperability/with-c/rust.md msgid "" -"Use `gn` and `ninja` with the help of the templates from `//build/rust/*." -"gni` (e.g. `rust_static_library` that we'll meet later). This uses " -"Chromium's audited toolchain and crates." +"```shell\n" +"m analyze_numbers\n" +"adb push \"$ANDROID_PRODUCT_OUT/system/bin/analyze_numbers\" /data/local/" +"tmp\n" +"adb shell /data/local/tmp/analyze_numbers\n" +"```" msgstr "" -"`//build/rust/*.gni` のテンプレート（例: 後で説明する `rust_static_library`）" -"を参考にして、`gn` と `ninja` を使用します。これには、Chromium の監査済みの" -"ツールチェーンとクレートが使用されます。" +"```shell\n" +"m analyze_numbers\n" +"adb push \"$ANDROID_PRODUCT_OUT/system/bin/analyze_numbers\" /data/local/" +"tmp\n" +"adb shell /data/local/tmp/analyze_numbers\n" +"```" -#: src/chromium/cargo.md +#: src/android/interoperability/with-c/rust.md msgid "" -"Use `cargo`, but [restrict yourself to Chromium's audited toolchain and " -"crates](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/" -"docs/rust.md#Using-cargo)" +"`#[no_mangle]` disables Rust's usual name mangling, so the exported symbol " +"will just be the name of the function. You can also use `#[export_name = " +"\"some_name\"]` to specify whatever name you want." msgstr "" -"`cargo` を使用しますが、実際の利用を[Chromium の監査済みのツールチェーンとク" -"レートに制限します](https://chromium.googlesource.com/chromium/src/+/refs/" -"heads/main/docs/rust.md#Using-cargo)。" +"`#[no_mangle]` により Rust の通常の名前のマングリングが無効になるため、エクス" +"ポートされたシンボルは単に関数の名前になります。`#[export_name = " +"\"some_name\"]` を使用して任意の名前を指定することもできます。" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp.md msgid "" -"Use `cargo`, trusting a [toolchain](https://rustup.rs/) and/or [crates " -"downloaded from the internet](https://crates.io/)" +"The [CXX crate](https://cxx.rs/) makes it possible to do safe " +"interoperability between Rust and C++." msgstr "" -"`cargo` を使用し、[ツールチェーン](https://rustup.rs/) や [インターネットから" -"ダウンロードしたクレート](https://crates.io/) を信頼します。" +"[CXX クレート](https://cxx.rs/)を使用すると、Rust と C++ の間で安全な相互運用" +"性を確保できます。" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp.md +msgid "The overall approach looks like this:" +msgstr "全体的なアプローチは次のようになります。" + +#: src/android/interoperability/cpp/bridge.md msgid "" -"From here on we'll be focusing on `gn` and `ninja`, because this is how Rust " -"code can be built into the Chromium browser. At the same time, Cargo is an " -"important part of the Rust ecosystem and you should keep it in your toolbox." +"CXX relies on a description of the function signatures that will be exposed " +"from each language to the other. You provide this description using extern " +"blocks in a Rust module annotated with the `#[cxx::bridge]` attribute macro." msgstr "" -"ここからは、`gn` と `ninja` に焦点を当てます。これらを使用することで、" -"Chromium ブラウザに Rust コードを組み込むことができます。それとは別に、Cargo " -"は Rust エコシステムの重要な部分であり、使いこなせるようになっているべきで" -"す。" - -#: src/chromium/cargo.md -#, fuzzy -msgid "Mini exercise" -msgstr "練習問題" +"CXX は、各言語から他の言語に公開される関数シグネチャの記述に依存します。この" +"記述は、`#[cxx::bridge]` 属性マクロでアノテーションされた Rust モジュール内" +"の extern ブロックを使用して指定します。" -#: src/chromium/cargo.md -msgid "Split into small groups and:" -msgstr "少人数のグループに分け、以下を行います。" +#: src/android/interoperability/cpp/bridge.md +msgid "\"org::blobstore\"" +msgstr "\"org::blobstore\"" -#: src/chromium/cargo.md -msgid "" -"Brainstorm scenarios where `cargo` may offer an advantage and assess the " -"risk profile of these scenarios." -msgstr "" -"`cargo` がメリットをもたらす可能性のあるシナリオをブレインストーミングし、そ" -"れらのシナリオのリスク プロファイルを評価します。" +#: src/android/interoperability/cpp/bridge.md +msgid "// Shared structs with fields visible to both languages.\n" +msgstr "// 両方の言語からアクセスできるフィールドを持つ共有構造体。\n" -#: src/chromium/cargo.md -msgid "" -"Discuss which tools, libraries, and groups of people need to be trusted when " -"using `gn` and `ninja`, offline `cargo`, etc." -msgstr "" -"`gn` や `ninja`、オフラインの `cargo` などを使用する際に、どのツール、ライブ" -"ラリ、人々を信頼しなければならないかについて話し合います。" +#: src/android/interoperability/cpp/bridge.md +#: src/android/interoperability/cpp/generated-cpp.md +msgid "// Rust types and signatures exposed to C++.\n" +msgstr "// C++ に公開される Rust の型とシグネチャ。\n" -#: src/chromium/cargo.md -msgid "" -"Ask students to avoid peeking at the speaker notes before completing the " -"exercise. Assuming folks taking the course are physically together, ask them " -"to discuss in small groups of 3-4 people." -msgstr "" -"受講者に、演習を完了する前にスピーカー ノートをのぞかないようお願いしてくださ" -"い。コースの受講者同士が地理的に集まっていると仮定して、3～4 人の少人数のグ" -"ループで話し合ってもらうようにお願いしてください。" +#: src/android/interoperability/cpp/bridge.md +#: src/android/interoperability/cpp/rust-bridge.md +#: src/android/interoperability/cpp/generated-cpp.md +#: src/android/interoperability/cpp/rust-result.md +#: src/chromium/interoperability-with-cpp/example-bindings.md +#: src/chromium/interoperability-with-cpp/error-handling-qr.md +#: src/chromium/interoperability-with-cpp/error-handling-png.md +msgid "\"Rust\"" +msgstr "\"Rust\"" -#: src/chromium/cargo.md -msgid "" -"Notes/hints related to the first part of the exercise (\"scenarios where " -"Cargo may offer an advantage\"):" -msgstr "" -"演習の前半に関するメモとヒント（「Cargo がメリットをもたらすシナリオ」）:" +#: src/android/interoperability/cpp/bridge.md +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "// C++ types and signatures exposed to Rust.\n" +msgstr "// Rust に公開される C++ の型とシグネチャ。\n" -#: src/chromium/cargo.md -msgid "" -"It's fantastic that when writing a tool, or prototyping a part of Chromium, " -"one has access to the rich ecosystem of crates.io libraries. There is a " -"crate for almost anything and they are usually quite pleasant to use. " -"(`clap` for command-line parsing, `serde` for serializing/deserializing to/" -"from various formats, `itertools` for working with iterators, etc.)." -msgstr "" -"ツールの作成時や Chromium の一部のプロトタイピング時に、crates.io ライブラリ" -"の充実したエコシステムにアクセスできるのは素晴らしいことです。ほぼすべての事" -"柄についてクレートが用意されており、大概の場合はとても快適に使用できます（コ" -"マンドラインを解析するための `clap`、さまざまな形式との間でシリアル化または逆" -"シリアル化を行うための `serde`、イテレータを操作するための `itertools` な" -"ど）。" +#: src/android/interoperability/cpp/bridge.md +#: src/android/interoperability/cpp/cpp-bridge.md +#: src/android/interoperability/cpp/cpp-exception.md +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "\"C++\"" +msgstr "\"C++\"" -#: src/chromium/cargo.md -msgid "" -"`cargo` makes it easy to try a library (just add a single line to `Cargo." -"toml` and start writing code)" -msgstr "" -"`cargo` を使用すると、ライブラリを簡単に試すことができます（`Cargo.toml` に " -"1 行追加してコードの記述を開始するだけです）。" +#: src/android/interoperability/cpp/bridge.md +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "\"include/blobstore.h\"" +msgstr "\"include/blobstore.h\"" -#: src/chromium/cargo.md -msgid "" -"It may be worth comparing how CPAN helped make `perl` a popular choice. Or " -"comparing with `python` + `pip`." -msgstr "" -"`perl` の普及に役立った CPAN や、`python` における `pip` と比較してみると良い" -"かもしれません。" +#: src/android/interoperability/cpp/bridge.md +msgid "The bridge is generally declared in an `ffi` module within your crate." +msgstr "ブリッジは通常、クレート内の `ffi` モジュールで宣言します。" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/bridge.md msgid "" -"Development experience is made really nice not only by core Rust tools (e.g. " -"using `rustup` to switch to a different `rustc` version when testing a crate " -"that needs to work on nightly, current stable, and older stable) but also by " -"an ecosystem of third-party tools (e.g. Mozilla provides `cargo vet` for " -"streamlining and sharing security audits; `criterion` crate gives a " -"streamlined way to run benchmarks)." +"From the declarations made in the bridge module, CXX will generate matching " +"Rust and C++ type/function definitions in order to expose those items to " +"both languages." msgstr "" -"主要な Rust ツール（ナイトリー、現在の安定版、古い安定版で動作する必要がある" -"クレートをテストするときに、別の `rustc` バージョンに切り替えるのに使用する " -"`rustup` など）だけでなく、サードパーティ ツールのエコシステム（Mozilla が提" -"供するセキュリティ監査の容易化と共有のため `cargo vet`、ベンチマークを容易に" -"実行する方法を提供する `criterion` クレートなど）により、開発エクスペリエンス" -"は非常に快適となっています。" +"ブリッジ モジュールで行われた宣言から、CXX はマッチする Rust と C++ の型 / 関" +"数の定義を生成し、これらのアイテムを両方の言語に公開します。" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/bridge.md msgid "" -"`cargo` makes it easy to add a tool via `cargo install --locked cargo-vet`." +"To view the generated Rust code, use [cargo-expand](https://github.com/" +"dtolnay/cargo-expand) to view the expanded proc macro. For most of the " +"examples you would use `cargo expand ::ffi` to expand just the `ffi` module " +"(though this doesn't apply for Android projects)." msgstr "" -"`cargo` を使用すると、`cargo install --locked cargo-vet` を介してツールを簡単" -"に追加できます。" +"生成された Rust コードを表示するには、[cargo-expand](https://github.com/" +"dtolnay/cargo-expand) を使用して、展開された proc マクロを表示します。ほとん" +"どの例では、`cargo expand ::ffi` を使用して `ffi` モジュールのみを展開します" +"（ただし、これは Android プロジェクトには当てはまりません）。" -#: src/chromium/cargo.md -msgid "It may be worth comparing with Chrome Extensions or VScode extensions." -msgstr "" -"Chrome 拡張機能や VScode 拡張機能と比較してみるのも良いかもしれません。" +#: src/android/interoperability/cpp/bridge.md +msgid "To view the generated C++ code, look in `target/cxxbridge`." +msgstr "生成された C++ コードを表示するには、`target/cxxbridge` を確認します。" -#: src/chromium/cargo.md -msgid "" -"Broad, generic examples of projects where `cargo` may be the right choice:" -msgstr "" -"`cargo` が適切な選択となるような、幅広い汎用的なプロジェクトの例を以下に示し" -"ます。" +#: src/android/interoperability/cpp/rust-bridge.md +msgid "Rust Bridge Declarations" +msgstr "Rust のブリッジ宣言" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/rust-bridge.md +msgid "// Opaque type\n" +msgstr "// オペーク型\n" + +#: src/android/interoperability/cpp/rust-bridge.md +msgid "// Method on `MyType`\n" +msgstr "// `MyType` のメソッド\n" + +#: src/android/interoperability/cpp/rust-bridge.md +#, fuzzy +msgid "// Free function\n" +msgstr "関数" + +#: src/android/interoperability/cpp/rust-bridge.md msgid "" -"Perhaps surprisingly, Rust is becoming increasingly popular in the industry " -"for writing command line tools. The breadth and ergonomics of libraries is " -"comparable to Python, while being more robust (thanks to the rich " -"typesystem) and running faster (as a compiled, rather than interpreted " -"language)." +"Items declared in the `extern \"Rust\"` reference items that are in scope in " +"the parent module." msgstr "" -"意外かもしれませんが、業界ではコマンドライン ツールの作成に使用する言語とし" -"て、Rust の人気が高まっています。ライブラリの幅とエルゴノミクスの点で Python " -"に匹敵しつつも、豊富な型システムのおかげで堅牢で、（インタプリタ言語ではなく" -"コンパイル言語なので）実行速度が高速です。" +"親モジュールのスコープ内にある `extern \"Rust\"` 参照アイテムで宣言されたアイ" +"テム。" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/rust-bridge.md msgid "" -"Participating in the Rust ecosystem requires using standard Rust tools like " -"Cargo. Libraries that want to get external contributions, and want to be " -"used outside of Chromium (e.g. in Bazel or Android/Soong build environments) " -"should probably use Cargo." +"The CXX code generator uses your `extern \"Rust\"` section(s) to produce a C+" +"+ header file containing the corresponding C++ declarations. The generated " +"header has the same path as the Rust source file containing the bridge, " +"except with a .rs.h file extension." msgstr "" -"Rust エコシステムに参加するには、Cargo などの標準の Rust ツールを使用する必要" -"があります。外部からコントリビューションを受け、Chromium 以外（Bazel や " -"Android / Soong のビルド環境など）での使用が推奨されるライブラリでは、Cargo " -"を使用することをおすすめします。" +"CXX コード ジェネレータは、`extern \"Rust\"` セクションを使用して、対応する " +"C++ 宣言を含む C++ ヘッダー ファイルを生成します。生成されるヘッダーのパス" +"は、rs.hというファイル拡張子部分を除き、ブリッジを含む Rust ソースファイルと" +"同じになります。" -#: src/chromium/cargo.md -msgid "Examples of Chromium-related projects that are `cargo`\\-based:" -msgstr "`cargo` ベースの Chromium 関連プロジェクトの例:" +#: src/android/interoperability/cpp/generated-cpp.md +msgid "Results in (roughly) the following C++:" +msgstr "おおよそ次のような C++ が生成されます。" -#: src/chromium/cargo.md -msgid "" -"`serde_json_lenient` (experimented with in other parts of Google which " -"resulted in PRs with performance improvements)" -msgstr "" -"`serde_json_lenient`（Google の他の部門でテストした結果、PR のパフォーマンス" -"が向上）" +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "C++ Bridge Declarations" +msgstr "C++ のブリッジ宣言" -#: src/chromium/cargo.md -msgid "Fontations libraries like `font-types`" -msgstr "`font-types` などのフォント化ライブラリ" +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "Results in (roughly) the following Rust:" +msgstr "おおよそ次のような Rust が生成されます。" -#: src/chromium/cargo.md -msgid "" -"`gnrt` tool (we will meet it later in the course) which depends on `clap` " -"for command-line parsing and on `toml` for configuration files." -msgstr "" -"`gnrt` ツール（このコースの後半で取り上げます）は、コマンドラインの解析には " -"`clap` を使用し、構成ファイルには `toml` を使用します。" +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "\"org$blobstore$cxxbridge1$new_blobstore_client\"" +msgstr "\"org$blobstore$cxxbridge1$new_blobstore_client\"" -#: src/chromium/cargo.md -msgid "" -"Disclaimer: a unique reason for using `cargo` was unavailability of `gn` " -"when building and bootstrapping Rust standard library when building Rust " -"toolchain.)" -msgstr "" -"免責条項: `cargo` を使用する唯一の理由は、Rust ツールチェーンのビルド中、" -"Rust 標準ライブラリのビルドとブートストラップを行う際に `gn` を使用できないこ" -"とでした。" +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "\"org$blobstore$cxxbridge1$BlobstoreClient$put\"" +msgstr "\"org$blobstore$cxxbridge1$BlobstoreClient$put\"" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/cpp-bridge.md msgid "" -"`run_gnrt.py` uses Chromium's copy of `cargo` and `rustc`. `gnrt` depends on " -"third-party libraries downloaded from the internet, by `run_gnrt.py` asks " -"`cargo` that only `--locked` content is allowed via `Cargo.lock`.)" +"The programmer does not need to promise that the signatures they have typed " +"in are accurate. CXX performs static assertions that the signatures exactly " +"correspond with what is declared in C++." msgstr "" -"`run_gnrt.py` は、Chromiumプロジェクト内の `cargo` と `rustc` のコピーを使用" -"します。`gnrt` はインターネットからダウンロードされたサードパーティ ライブラ" -"リに依存しており、`run_gnrt.py` で `Cargo.lock` を介して `--locked` コンテン" -"ツのみを許可することを `cargo` に要求します。" +"プログラマーは、入力したシグネチャが正確であることを保証する必要はありませ" +"ん。CXX は、シグネチャが C++ で宣言されたものと完全に対応するということを静的" +"に保証します。" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/cpp-bridge.md msgid "" -"Students may identify the following items as being implicitly or explicitly " -"trusted:" +"`unsafe extern` blocks allow you to declare C++ functions that are safe to " +"call from Rust." msgstr "" -"以下のアイテムは、暗黙的または明示的に信頼されているとみなして構いません。" +"`unsafe extern` ブロックを使用すると、Rust から安全に呼び出せる C++ 関数を宣" +"言できます。" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/shared-types.md +msgid "// A=1, J=11, Q=12, K=13\n" +msgstr "// A=1、J=11、Q=12、K=13\n" + +#: src/android/interoperability/cpp/shared-types.md +msgid "Only C-like (unit) enums are supported." +msgstr "C のような（単位）列挙型のみがサポートされています。" + +#: src/android/interoperability/cpp/shared-types.md msgid "" -"`rustc` (the Rust compiler) which in turn depends on the LLVM libraries, the " -"Clang compiler, the `rustc` sources (fetched from GitHub, reviewed by Rust " -"compiler team), binary Rust compiler downloaded for bootstrapping" +"A limited number of traits are supported for `#[derive()]` on shared types. " +"Corresponding functionality is also generated for the C++ code, e.g. if you " +"derive `Hash` also generates an implementation of `std::hash` for the " +"corresponding C++ type." msgstr "" -"LLVM ライブラリ、Clang コンパイラ、`rustc` ソース（GitHub から取得され、Rust " -"コンパイラ チームによるレビューを受けたもの）、ブートストラップ用にダウンロー" -"ドされたバイナリ Rust コンパイラに依存する `rustc`（Rust コンパイラ）" - -#: src/chromium/cargo.md -msgid "" -"`rustup` (it may be worth pointing out that `rustup` is developed under the " -"umbrella of the https://github.com/rust-lang/ organization - same as `rustc`)" -msgstr "" -"`rustup`（`rustup` は `rustc`と同じく https://github.com/rust-lang/ 組織の傘" -"下で開発されていることを説明すると良いかもしれません）" - -#: src/chromium/cargo.md -msgid "`cargo`, `rustfmt`, etc." -msgstr "`cargo`、`rustfmt` など" +"共有型の `#[derive()]` では、サポートされるトレイトの数が限られています。対応" +"する機能は C++ コードでも生成されます。たとえば、`Hash` を導出すると、対応す" +"る C++ 型の `std::hash` の実装も生成されます。" -#: src/chromium/cargo.md -msgid "" -"Various internal infrastructure (bots that build `rustc`, system for " -"distributing the prebuilt toolchain to Chromium engineers, etc.)" -msgstr "" -"さまざまな内部インフラストラクチャ（`rustc` をビルドする bot、事前構築済みの" -"ツールチェーンを Chromium エンジニアに配布するためのシステムなど）" +#: src/android/interoperability/cpp/shared-enums.md +msgid "Generated Rust:" +msgstr "生成された Rust:" -#: src/chromium/cargo.md -msgid "Cargo tools like `cargo audit`, `cargo vet`, etc." -msgstr "`cargo audit` や `cargo vet` などの Cargo ツール" +#: src/android/interoperability/cpp/shared-enums.md +msgid "Generated C++:" +msgstr "生成された C++:" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/shared-enums.md msgid "" -"Rust libraries vendored into `//third_party/rust` (audited by " -"security@chromium.org)" +"On the Rust side, the code generated for shared enums is actually a struct " +"wrapping a numeric value. This is because it is not UB in C++ for an enum " +"class to hold a value different from all of the listed variants, and our " +"Rust representation needs to have the same behavior." msgstr "" -"`//third_party/rust` に取り込まれたRust ライブラリ（security@chromium.org が" -"監査）" +"Rust 側では、共有列挙型に対して生成されるコードは、実際には数値をラップした構" +"造体です。これは、列挙型クラスがリストされたすべてのバリアントとは異なる値を" +"保持することは C++ では UB ではなく、Rust 表現は同じ動作をする必要があるため" +"です。" -#: src/chromium/cargo.md -msgid "Other Rust libraries (some niche, some quite popular and commonly used)" -msgstr "" -"その他の Rust ライブラリ（ニッチなものもあれば、非常に人気がありよく使用され" -"るものもあります）" +#: src/android/interoperability/cpp/rust-result.md +msgid "\"fallible1 requires depth > 0\"" +msgstr "\"fallible1 requires depth > 0\"" -#: src/chromium/policy.md -msgid "Chromium Rust policy" -msgstr "Chromium の Rust ポリシー" +#: src/android/interoperability/cpp/rust-result.md +msgid "\"Success!\"" +msgstr "\"Success!\"" -#: src/chromium/policy.md +#: src/android/interoperability/cpp/rust-result.md msgid "" -"Chromium does not yet allow first-party Rust except in rare cases as " -"approved by Chromium's [Area Tech Leads](https://source.chromium.org/" -"chromium/chromium/src/+/main:ATL_OWNERS)." -msgstr "" -"Chromium では、Chromium の [エリア テクニカル リード](https://source." -"chromium.org/chromium/chromium/src/+/main:ATL_OWNERS) によって承認されている" -"まれなケースを除き、ファースト パーティでのRust使用はまだ許可されていません。" +"Rust functions that return `Result` are translated to exceptions on the C++ " +"side." +msgstr "`Result` を返す Rust 関数は、C++ 側で例外に変換されます。" -#: src/chromium/policy.md +#: src/android/interoperability/cpp/rust-result.md msgid "" -"Chromium's policy on third party libraries is outlined [here](https://" -"chromium.googlesource.com/chromium/src/+/main/docs/adding_to_third_party." -"md#rust) - Rust is allowed for third party libraries under various " -"circumstances, including if they're the best option for performance or for " -"security." +"The exception thrown will always be of type `rust::Error`, which primarily " +"exposes a way to get the error message string. The error message will come " +"from the error type's `Display` impl." msgstr "" -"サードパーティ ライブラリに関する Chromium のポリシーについては、[こちら]" -"(https://chromium.googlesource.com/chromium/src/+/main/docs/" -"adding_to_third_party.md#rust) をご覧ください。Rust は、パフォーマンスやセ" -"キュリティを高めるうえで最適な選択肢である場合を含め、さまざまな状況でサード" -"パーティ ライブラリに使用することが許可されています。" +"スローされる例外は常に `rust::Error` 型で、主にエラー メッセージの文字列を取" +"得する手段を提供します。エラー メッセージは、エラー型の `Display` の実装から" +"取得されます。" -#: src/chromium/policy.md +#: src/android/interoperability/cpp/rust-result.md msgid "" -"Very few Rust libraries directly expose a C/C++ API, so that means that " -"nearly all such libraries will require a small amount of first-party glue " -"code." +"A panic unwinding from Rust to C++ will always cause the process to " +"immediately terminate." msgstr "" -"C / C++ API を直接公開する Rust ライブラリはほとんどないため、こうしたライブ" -"ラリのほぼすべてで、少量のファースト パーティ グルーコードが必要になります。" +"Rust から C++ にパニック アンワインドを行うと、プロセスは必ず直ちに終了しま" +"す。" -#: src/chromium/policy.md +#: src/android/interoperability/cpp/cpp-exception.md +msgid "\"example/include/example.h\"" +msgstr "\"example/include/example.h\"" + +#: src/android/interoperability/cpp/cpp-exception.md +msgid "\"Error: {}\"" +msgstr "\"Error: {}\"" + +#: src/android/interoperability/cpp/cpp-exception.md msgid "" -"```bob\n" -"\"C++\" Rust\n" -".- - - - - - - - - -. .- - - - - - - - - - - - - - - - - - - - - - " -"-.\n" -": : : :\n" -": Existing Chromium : : Chromium Rust Existing " -"Rust :\n" -": \"C++\" : : \"wrapper\" " -"crate :\n" -": +---------------+ : : +----------------+ +-------------" -"+ :\n" -": | | : : | | | " -"| :\n" -": | o-----+-+-----------+-+-> o-+----------+--> " -"| :\n" -": | | : Language : | | Crate | " -"| :\n" -": +---------------+ : boundary : +----------------+ API +-------------" -"+ :\n" -": : : :\n" -"`- - - - - - - - - -' `- - - - - - - - - - - - - - - - - - - - - - " -"-'\n" -"```" +"C++ functions declared to return a `Result` will catch any thrown exception " +"on the C++ side and return it as an `Err` value to the calling Rust function." msgstr "" -"```bob\n" -"\"C++\" Rust\n" -".- - - - - - - - - -. .- - - - - - - - - - - - - - - - - - - - - - " -"-.\n" -": : : :\n" -": 既存の Chromium : : \"Chromium Rust\" \"既存の " -"Rust\" :\n" -": \"C++\" : : \"ラッパー\" クレー" -"ト :\n" -": +---------------+ : : +----------------+ +-------------" -"+ :\n" -": | | : : | | | " -"| :\n" -": | o-----+-+-----------+-+-> o-+----------+--> " -"| :\n" -": | | : 言語 : | | Crate | " -"| :\n" -": +---------------+ : 境界 : +----------------+ API +-------------" -"+ :\n" -": : : :\n" -"`- - - - - - - - - -' `- - - - - - - - - - - - - - - - - - - - - - " -"-'\n" -"```" +"`Result` を返すように宣言された C++ 関数は、C++ 側でスローされたあらゆる例外" +"をキャッチし、呼び出し元の Rust 関数に `Err` 値として返します。" -#: src/chromium/policy.md +#: src/android/interoperability/cpp/cpp-exception.md msgid "" -"First-party Rust glue code for a particular third-party crate should " -"normally be kept in `third_party/rust///wrapper`." +"If an exception is thrown from an extern \"C++\" function that is not " +"declared by the CXX bridge to return `Result`, the program calls C++'s `std::" +"terminate`. The behavior is equivalent to the same exception being thrown " +"through a `noexcept` C++ function." msgstr "" -"特定のサードパーティ クレート用のファースト パーティ Rust グルーコードは通" -"常、`third_party/rust///wrapper` に置かれるべきです。" +"CXX ブリッジでResultを返すように宣言されていないextern \"C++\"関数から例外が" +"スローされると、`Result`が返されると、プログラムは C++ の`std::terminate`を呼" +"び出します。この動作は、同じ例外が`noexcept` C++ 関数でスローされた場合と同等" +"です。" -#: src/chromium/policy.md -msgid "Because of this, today's course will be heavily focused on:" -msgstr "以上の理由から、本日のコースでは以下に焦点を当てます。" +#: src/android/interoperability/cpp/type-mapping.md +msgid "C++ Type" +msgstr "C++ 型" -#: src/chromium/policy.md -msgid "Bringing in third-party Rust libraries (\"crates\")" -msgstr "サードパーティの Rust ライブラリ（「クレート」）を導入する。" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`rust::String`" +msgstr "`rust::String`" -#: src/chromium/policy.md -msgid "Writing glue code to be able to use those crates from Chromium C++." -msgstr "Chromium C++ からクレートを使用できるようにグルーコードを記述する。" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`&str`" +msgstr "`&str`" -#: src/chromium/policy.md -msgid "If this policy changes over time, the course will evolve to keep up." -msgstr "このポリシーが変更された場合は、それに合わせてコースも変更されます。" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`rust::Str`" +msgstr "`rust::Str`" -#: src/chromium/build-rules.md +#: src/android/interoperability/cpp/type-mapping.md #, fuzzy -msgid "Build rules" -msgstr "ビルドのルール" +msgid "`CxxString`" +msgstr "`CxxString`" -#: src/chromium/build-rules.md -msgid "" -"Rust code is usually built using `cargo`. Chromium builds with `gn` and " -"`ninja` for efficiency --- its static rules allow maximum parallelism. Rust " -"is no exception." -msgstr "" -"Rust コードは通常、`cargo` を使用してビルドされます。Chromium は効率を高める" -"ために `gn` と `ninja`を使用してビルドされますが、その静的ルールによって最大" -"限の並列処理が可能になります。Rust も例外ではありません。" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`std::string`" +msgstr "`std::string`" -#: src/chromium/build-rules.md -msgid "Adding Rust code to Chromium" -msgstr "Chromium に Rust コードを追加する" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`&[T]`/`&mut [T]`" +msgstr "`&[T]`/`&mut [T]`" -#: src/chromium/build-rules.md -msgid "" -"In some existing Chromium `BUILD.gn` file, declare a `rust_static_library`:" -msgstr "" -"Chromium の既存の `BUILD.gn` ファイルで、`rust_static_library` を宣言します。" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`rust::Slice`" +msgstr "`rust::Slice`" -#: src/chromium/build-rules.md -msgid "" -"```gn\n" -"import(\"//build/rust/rust_static_library.gni\")\n" -"\n" -"rust_static_library(\"my_rust_lib\") {\n" -" crate_root = \"lib.rs\"\n" -" sources = [ \"lib.rs\" ]\n" -"}\n" -"```" -msgstr "" -"```gn\n" -"import(\"//build/rust/rust_static_library.gni\")\n" -"\n" -"rust_static_library(\"my_rust_lib\") {\n" -" crate_root = \"lib.rs\"\n" -" sources = [ \"lib.rs\" ]\n" -"}\n" -"```" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`rust::Box`" +msgstr "`rust::Box`" -#: src/chromium/build-rules.md -msgid "" -"You can also add `deps` on other Rust targets. Later we'll use this to " -"depend upon third party code." -msgstr "" -"他の Rust ターゲットに `deps` を追加することもできます。後でこれを使用して、" -"サードパーティのコードへの依存を設定します。" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`UniquePtr`" +msgstr "`UniquePtr`" -#: src/chromium/build-rules.md -msgid "" -"You must specify _both_ the crate root, _and_ a full list of sources. The " -"`crate_root` is the file given to the Rust compiler representing the root " -"file of the compilation unit --- typically `lib.rs`. `sources` is a complete " -"list of all source files which `ninja` needs in order to determine when " -"rebuilds are necessary." -msgstr "" -"クレートルートとソースの完全なリストの両方を指定する必要があります。" -"`crate_root` は Rust コンパイラに渡されるファイルで、コンパイル単位のルート" -"ファイル（通常は `lib.rs`）を表します。`sources` はすべてのソースファイルの完" -"全なリストで、再ビルドが必要なタイミングを `ninja` が判断するために必要です。" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`std::unique_ptr`" +msgstr "`std::unique_ptr`" -#: src/chromium/build-rules.md -msgid "" -"(There's no such thing as a Rust `source_set`, because in Rust, an entire " -"crate is a compilation unit. A `static_library` is the smallest unit.)" -msgstr "" -"（Rust ではクレート全体がコンパイル単位であるため、`source_set`と呼べるような" -"ものは存在しません。`static_library` が最小単位です）。" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`rust::Vec`" +msgstr "`rust::Vec`" -#: src/chromium/build-rules.md -msgid "" -"Students might be wondering why we need a gn template, rather than using " -"[gn's built-in support for Rust static libraries](https://gn.googlesource." -"com/gn/+/main/docs/reference.md#func_static_library). The answer is that " -"this template provides support for CXX interop, Rust features, and unit " -"tests, some of which we'll use later." -msgstr "" -"受講者は、なぜ [Rust の静的ライブラリに対する gn の組み込みサポート](https://" -"gn.googlesource.com/gn/+/main/docs/reference.md#func_static_library) ではな" -"く、gn テンプレートを使用する必要があるのか疑問に思うかもしれません。その答え" -"は、このテンプレートが CXX 相互運用、Rustのfeatures、単体テストをサポートして" -"いるためです。その一部は後で使用します。" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`CxxVector`" +msgstr "`CxxVector`" -#: src/chromium/build-rules/unsafe.md -msgid "Including `unsafe` Rust Code" -msgstr "`unsafe` Rust コードの追加" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`std::vector`" +msgstr "`std::vector`" -#: src/chromium/build-rules/unsafe.md +#: src/android/interoperability/cpp/type-mapping.md msgid "" -"Unsafe Rust code is forbidden in `rust_static_library` by default --- it " -"won't compile. If you need unsafe Rust code, add `allow_unsafe = true` to " -"the gn target. (Later in the course we'll see circumstances where this is " -"necessary.)" +"These types can be used in the fields of shared structs and the arguments " +"and returns of extern functions." msgstr "" -"安全でない Rust コードはデフォルトでは `rust_static_library` で禁止されてお" -"り、コンパイルできません。安全でない Rust コードが必要な場合は、gn ターゲット" -"に `allow_unsafe = true` を追加します（これが必要になる状況については、この" -"コースの後半で説明します）。" +"これらの型は、共有構造体のフィールドと、extern 関数の引数と戻り値で使用できま" +"す。" -#: src/chromium/build-rules/unsafe.md +#: src/android/interoperability/cpp/type-mapping.md msgid "" -"```gn\n" -"import(\"//build/rust/rust_static_library.gni\")\n" -"\n" -"rust_static_library(\"my_rust_lib\") {\n" -" crate_root = \"lib.rs\"\n" -" sources = [\n" -" \"lib.rs\",\n" -" \"hippopotamus.rs\"\n" -" ]\n" -" allow_unsafe = true\n" -"}\n" -"```" -msgstr "" -"```gn\n" -"import(\"//build/rust/rust_static_library.gni\")\n" -"\n" -"rust_static_library(\"my_rust_lib\") {\n" -" crate_root = \"lib.rs\"\n" -" sources = [\n" -" \"lib.rs\",\n" -" \"hippopotamus.rs\"\n" -" ]\n" -" allow_unsafe = true\n" -"}\n" -"```" - -#: src/chromium/build-rules/depending.md -msgid "Simply add the above target to the `deps` of some Chromium C++ target." +"Note that Rust's `String` does not map directly to `std::string`. There are " +"a few reasons for this:" msgstr "" -"上記のターゲットをいくつかの Chromium C++ ターゲットの `deps` に追加するだけ" -"です。" +"Rust の `String` は `std::string` に直接マッピングされません。これには次のよ" +"うな理由があります。" -#: src/chromium/build-rules/depending.md +#: src/android/interoperability/cpp/type-mapping.md msgid "" -"```gn\n" -"import(\"//build/rust/rust_static_library.gni\")\n" -"\n" -"rust_static_library(\"my_rust_lib\") {\n" -" crate_root = \"lib.rs\"\n" -" sources = [ \"lib.rs\" ]\n" -"}\n" -"\n" -"# or source_set, static_library etc.\n" -"component(\"preexisting_cpp\") {\n" -" deps = [ \":my_rust_lib\" ]\n" -"}\n" -"```" -msgstr "" -"```gn\n" -"import(\"//build/rust/rust_static_library.gni\")\n" -"\n" -"rust_static_library(\"my_rust_lib\") {\n" -" crate_root = \"lib.rs\"\n" -" sources = [ \"lib.rs\" ]\n" -"}\n" -"\n" -"# または source_set、static_library など\n" -"component(\"preexisting_cpp\") {\n" -" deps = [ \":my_rust_lib\" ]\n" -"}\n" -"```" +"`std::string` does not uphold the UTF-8 invariant that `String` requires." +msgstr "`std::string` は、`String` が必要とする UTF-8 不変条件を満たしません。" -#: src/chromium/build-rules/vscode.md +#: src/android/interoperability/cpp/type-mapping.md msgid "" -"Types are elided in Rust code, which makes a good IDE even more useful than " -"for C++. Visual Studio code works well for Rust in Chromium. To use it," +"The two types have different layouts in memory and so can't be passed " +"directly between languages." msgstr "" -"Rust コードでは型が省略されているため、優れた IDE は C++ の場合よりもさらに有" -"用です。Visual Studio Code は Chromium の Rust で適切に機能します。Visual " -"Studio Code を使用するにあたり、以下の点を確認してください。" +"この 2 つの型はメモリ内のレイアウトが異なるため、言語間で直接渡すことはできま" +"せん。" -#: src/chromium/build-rules/vscode.md +#: src/android/interoperability/cpp/type-mapping.md msgid "" -"Ensure your VSCode has the `rust-analyzer` extension, not earlier forms of " -"Rust support" +"`std::string` requires move constructors that don't match Rust's move " +"semantics, so a `std::string` can't be passed by value to Rust." msgstr "" -"VSCode に、以前の形式の Rust サポートではなく、`rust-analyzer` 拡張機能がある" -"ことを確認" +"`std::string` は、Rust のムーブ セマンティクスと一致しないムーブコンストラク" +"タを必要とするため、`std::string` を Rust に値で渡すことはできません。" -#: src/chromium/build-rules/vscode.md +#: src/android/interoperability/cpp/android-build-cpp.md +#: src/android/interoperability/cpp/android-cpp-genrules.md +#: src/android/interoperability/cpp/android-build-rust.md +#, fuzzy +msgid "Building in Android" +msgstr "Android 向けのビルド" + +#: src/android/interoperability/cpp/android-build-cpp.md msgid "" -"`gn gen out/Debug --export-rust-project` (or equivalent for your output " -"directory)" +"Create a `cc_library_static` to build the C++ library, including the CXX " +"generated header and source file." msgstr "" -"`gn gen out/Debug --export-rust-project`（またはあなたのプロジェクトにおける" -"同様の出力ディレクトリ）" +"`cc_library_static` を作成して、CXX で生成されたヘッダーとソースファイルを含" +"む C++ ライブラリをビルドします。" -#: src/chromium/build-rules/vscode.md -msgid "`ln -s out/Debug/rust-project.json rust-project.json`" -msgstr "`ln -s out/Debug/rust-project.json rust-project.json`" +#: src/android/interoperability/cpp/android-build-cpp.md +#: src/android/interoperability/cpp/android-build-rust.md +msgid "\"libcxx_test_cpp\"" +msgstr "\"libcxx_test_cpp\"" -#: src/chromium/build-rules/vscode.md -msgid "" -"A demo of some of the code annotation and exploration features of rust-" -"analyzer might be beneficial if the audience are naturally skeptical of IDEs." -msgstr "" -"IDE に懐疑的な受講者に対しては、rust-analyzer のコード アノテーションと探索機" -"能のデモを行うと良いかもしれません。" +#: src/android/interoperability/cpp/android-build-cpp.md +msgid "\"cxx_test.cpp\"" +msgstr "\"cxx_test.cpp\"" -#: src/chromium/build-rules/vscode.md -msgid "" -"The following steps may help with the demo (but feel free to instead use a " -"piece of Chromium-related Rust that you are most familiar with):" -msgstr "" -"以下の手順に沿ってデモを行うことをおすすめします（代わりに自分が最も精通して" -"いる Chromium 関連の Rustコードを使用しても構いません）。" +#: src/android/interoperability/cpp/android-build-cpp.md +msgid "\"cxx-bridge-header\"" +msgstr "\"cxx-bridge-header\"" -#: src/chromium/build-rules/vscode.md -msgid "Open `components/qr_code_generator/qr_code_generator_ffi_glue.rs`" -msgstr "" -"`components/qr_code_generator/qr_code_generator_ffi_glue.rs` を開きます。" +#: src/android/interoperability/cpp/android-build-cpp.md +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"libcxx_test_bridge_header\"" +msgstr "\"libcxx_test_bridge_header\"" -#: src/chromium/build-rules/vscode.md +#: src/android/interoperability/cpp/android-build-cpp.md +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"libcxx_test_bridge_code\"" +msgstr "\"libcxx_test_bridge_code\"" + +#: src/android/interoperability/cpp/android-build-cpp.md msgid "" -"Place the cursor over the `QrCode::new` call (around line 26) in " -"\\`qr_code_generator_ffi_glue.rs" +"Point out that `libcxx_test_bridge_header` and `libcxx_test_bridge_code` are " +"the dependencies for the CXX-generated C++ bindings. We'll show how these " +"are setup on the next slide." msgstr "" -"\\`qr_code_generator_ffi_glue.rs の `QrCode::new` 呼び出し（26 行目付近）に" -"カーソルを合わせます。" +"`libcxx_test_bridge_header` と `libcxx_test_bridge_code` が、CXX CXXにより生" +"成される C++ バインディングに対する依存関係であることを説明します。次のスライ" +"ドで、これらがどのような記述になっているかを説明します。" -#: src/chromium/build-rules/vscode.md +#: src/android/interoperability/cpp/android-build-cpp.md msgid "" -"Demo **show documentation** (typical bindings: vscode = ctrl k i; vim/CoC = " -"K)." +"Note that you also need to depend on the `cxx-bridge-header` library in " +"order to pull in common CXX definitions." msgstr "" -"**show documentation** のデモを行います（一般的なバインディング: vscode = " -"ctrl ki、vim/CoC = K）。" +"また、一般的な CXX 定義を取得するためには、`cxx-bridge-header` ライブラリに依" +"存する必要があることにも注意してください。" -#: src/chromium/build-rules/vscode.md +#: src/android/interoperability/cpp/android-build-cpp.md msgid "" -"Demo **go to definition** (typical bindings: vscode = F12; vim/CoC = g d). " -"(This will take you to `//third_party/rust/.../qr_code-.../src/lib.rs`.)" +"Full docs for using CXX in Android can be found in [the Android docs]" +"(https://source.android.com/docs/setup/build/rust/building-rust-modules/" +"android-rust-patterns#rust-cpp-interop-using-cxx). You may want to share " +"that link with the class so that students know where they can find these " +"instructions again in the future." msgstr "" -"**go to definition** のデモを行います（一般的なバインディング: vscode = F12、" -"vim/CoC = g d）（これにより、`//third_party/rust/.../qr_code-.../src/lib.rs` " -"に移動します）。" +"Android で CXX を使用するための詳細なドキュメントについては、[Android のド" +"キュメント](https://source.android.com/docs/setup/build/rust/building-rust-" +"modules/android-rust-patterns#rust-cpp-interop-using-cxx)をご覧ください。その" +"リンクをクラスと共有して、受講者が後で手順を確認できるようにすることをおすす" +"めします。" -#: src/chromium/build-rules/vscode.md +#: src/android/interoperability/cpp/android-cpp-genrules.md msgid "" -"Demo **outline** and navigate to the `QrCode::with_bits` method (around line " -"164; the outline is in the file explorer pane in vscode; typical vim/CoC " -"bindings = space o)" +"Create two genrules: One to generate the CXX header, and one to generate the " +"CXX source file. These are then used as inputs to the `cc_library_static`." msgstr "" -"**outline** のデモを行い、`QrCode::with_bits` メソッドに移動します（164 行目" -"付近。アウトラインは VSCode のファイル エクスプローラ ペインにあります。一般" -"的な vim/CoC バインディング = space o）。" +"genrule を 2 つ作成します。1 つは CXX ヘッダーの生成用、もう 1 つは CXX ソー" +"スファイルの生成用です。これらは `cc_library_static` への入力として使用されま" +"す。" -#: src/chromium/build-rules/vscode.md +#: src/android/interoperability/cpp/android-cpp-genrules.md msgid "" -"Demo **type annotations** (there are quote a few nice examples in the " -"`QrCode::with_bits` method)" +"// Generate a C++ header containing the C++ bindings\n" +"// to the Rust exported functions in lib.rs.\n" msgstr "" -"**type annotations**のデモを行います（`QrCode::with_bits` メソッドにいくつか" -"の適切な例があります）。" +"// lib.rs にある Rustからエクスポートされた関数に対する\n" +"// C++ バインディングを含む C++ ヘッダーを生成します。\n" -#: src/chromium/build-rules/vscode.md -msgid "" -"It may be worth pointing out that `gn gen ... --export-rust-project` will " -"need to be rerun after editing `BUILD.gn` files (which we will do a few " -"times throughout the exercises in this session)." -msgstr "" -"`BUILD.gn` ファイルの編集後は `gn gen ... --export-rust-project` を再実行する" -"必要があることを説明してください（このセッションの演習全体で数回行います）。" +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"cxxbridge\"" +msgstr "\"cxxbridge\"" -#: src/exercises/chromium/build-rules.md -#, fuzzy -msgid "Build rules exercise" -msgstr "ビルドのルールに関する演習" +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"$(location cxxbridge) $(in) --header > $(out)\"" +msgstr "\"$(location cxxbridge) $(in) --header > $(out)\"" -#: src/exercises/chromium/build-rules.md -msgid "" -"In your Chromium build, add a new Rust target to `//ui/base/BUILD.gn` " -"containing:" -msgstr "" -"Chromium のビルドで、以下を含む新しい Rust ターゲットを `//ui/base/BUILD.gn` " -"に追加します。" +#: src/android/interoperability/cpp/android-cpp-genrules.md +#: src/android/interoperability/cpp/android-build-rust.md +msgid "\"lib.rs\"" +msgstr "\"lib.rs\"" -#: src/exercises/chromium/build-rules.md +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"lib.rs.h\"" +msgstr "\"lib.rs.h\"" + +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "// Generate the C++ code that Rust calls into.\n" +msgstr "// Rust が呼び出す C++ コードを生成します。\n" + +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"$(location cxxbridge) $(in) > $(out)\"" +msgstr "\"$(location cxxbridge) $(in) > $(out)\"" + +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"lib.rs.cc\"" +msgstr "\"lib.rs.cc\"" + +#: src/android/interoperability/cpp/android-cpp-genrules.md msgid "" -"**Important**: note that `no_mangle` here is considered a type of unsafety " -"by the Rust compiler, so you'll need to to allow unsafe code in your `gn` " -"target." +"The `cxxbridge` tool is a standalone tool that generates the C++ side of the " +"bridge module. It is included in Android and available as a Soong tool." msgstr "" -"**重要**: ここでの `no_mangle` は Rust コンパイラでは安全でない型とみなされる" -"ため、`gn` ターゲットで安全でないコードを許可する必要があります。" +"`cxxbridge` ツールは、ブリッジ モジュールの C++ 側を生成するスタンドアロン " +"ツールです。Android に組み込まれており、Soong ツールとして利用できます。" -#: src/exercises/chromium/build-rules.md +#: src/android/interoperability/cpp/android-cpp-genrules.md msgid "" -"Add this new Rust target as a dependency of `//ui/base:base`. Declare this " -"function at the top of `ui/base/resource/resource_bundle.cc` (later, we'll " -"see how this can be automated by bindings generation tools):" +"By convention, if your Rust source file is `lib.rs` your header file will be " +"named `lib.rs.h` and your source file will be named `lib.rs.cc`. This naming " +"convention isn't enforced, though." msgstr "" -"この新しい Rust ターゲットを `//ui/base:base` の依存関係として追加します。こ" -"の関数を `ui/base/resource/resource_bundle.cc` の先頭で宣言します（後ほど、バ" -"インディング生成ツールでこれを自動化する方法を説明します）。" +"慣例として、Rust ソースファイルが `lib.rs` の場合、ヘッダー ファイルの名前は " +"`lib.rs.h`、ソースファイルの名前は `lib.rs.cc` となります。ただし、この命名規" +"則は強制ではありません。" -#: src/exercises/chromium/build-rules.md +#: src/android/interoperability/cpp/android-build-rust.md msgid "" -"Call this function from somewhere in `ui/base/resource/resource_bundle.cc` - " -"we suggest the top of `ResourceBundle::MaybeMangleLocalizedString`. Build " -"and run Chromium, and ensure that \"Hello from Rust!\" is printed lots of " -"times." -msgstr "" -"この関数を `ui/base/resource/resource_bundle.cc` 内のどこかから呼び出します。" -"おすすめは`ResourceBundle::MaybeMangleLocalizedString` の先頭から呼び出すこと" -"です。Chromium をビルドして実行し、\"Hello from Rust!\" が何度も出力されてい" -"ることを確認します。" +"Create a `rust_binary` that depends on `libcxx` and your `cc_library_static`." +msgstr "`libcxx` と `cc_library_static`に依存する `rust_binary` を作成します。" -#: src/exercises/chromium/build-rules.md +#: src/android/interoperability/cpp/android-build-rust.md +msgid "\"cxx_test\"" +msgstr "\"cxx_test\"" + +#: src/android/interoperability/cpp/android-build-rust.md +msgid "\"libcxx\"" +msgstr "\"libcxx\"" + +#: src/android/interoperability/java.md +msgid "Interoperability with Java" +msgstr "Java との相互運用性" + +#: src/android/interoperability/java.md msgid "" -"If you use VSCode, now set up Rust to work well in VSCode. It will be useful " -"in subsequent exercises. If you've succeeded, you will be able to use right-" -"click \"Go to definition\" on `println!`." +"Java can load shared objects via [Java Native Interface (JNI)](https://en." +"wikipedia.org/wiki/Java_Native_Interface). The [`jni` crate](https://docs.rs/" +"jni/) allows you to create a compatible library." msgstr "" -"VSCode を使用している場合は、VSCode で適切に動作するように Rust を設定しま" -"す。これは、後続の演習で役立ちます。設定が完了したら、`println!` で \"Go to " -"definition\" を右クリックで利用できるようになります。" +"Java では、[Java Native Interface（JNI）](https://en.wikipedia.org/wiki/" +"Java_Native_Interface) を介して共有オブジェクトを読み込むことができます。" +"[`jni` クレート](https://docs.rs/jni/) を使用すると、互換性のあるライブラリを" +"作成できます。" -#: src/exercises/chromium/build-rules.md -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Where to find help" -msgstr "参考情報" +#: src/android/interoperability/java.md +msgid "First, we create a Rust function to export to Java:" +msgstr "まず、Java にエクスポートする Rust 関数を作成します。" -#: src/exercises/chromium/build-rules.md +#: src/android/interoperability/java.md +msgid "_interoperability/java/src/lib.rs_:" +msgstr "_interoperability/java/src/lib.rs_:" + +#: src/android/interoperability/java.md +msgid "//! Rust <-> Java FFI demo.\n" +msgstr "//! Rust <-> Java FFI のデモ。\n" + +#: src/android/interoperability/java.md +msgid "/// HelloWorld::hello method implementation.\n" +msgstr "/// HelloWorld::hello メソッドの実装。\n" + +#: src/android/interoperability/java.md +msgid "\"system\"" +msgstr "\"system\"" + +#: src/android/interoperability/java.md +msgid "\"Hello, {input}!\"" +msgstr "\"Hello, {input}!\"" + +#: src/android/interoperability/java.md +msgid "_interoperability/java/Android.bp_:" +msgstr "_interoperability/java/Android.bp_:" + +#: src/android/interoperability/java.md +msgid "\"libhello_jni\"" +msgstr "\"libhello_jni\"" + +#: src/android/interoperability/java.md +msgid "\"hello_jni\"" +msgstr "\"hello_jni\"" + +#: src/android/interoperability/java.md +msgid "\"libjni\"" +msgstr "\"libjni\"" + +#: src/android/interoperability/java.md +msgid "We then call this function from Java:" +msgstr "次に、Java からこの関数を呼び出します。" + +#: src/android/interoperability/java.md +msgid "_interoperability/java/HelloWorld.java_:" +msgstr "_interoperability/java/HelloWorld.java_:" + +#: src/android/interoperability/java.md +msgid "\"helloworld_jni\"" +msgstr "\"helloworld_jni\"" + +#: src/android/interoperability/java.md +msgid "\"HelloWorld.java\"" +msgstr "\"HelloWorld.java\"" + +#: src/android/interoperability/java.md +msgid "\"HelloWorld\"" +msgstr "\"HelloWorld\"" + +#: src/android/interoperability/java.md +msgid "Finally, you can build, sync, and run the binary:" +msgstr "最後に、バイナリをビルド、同期、実行します。" + +#: src/exercises/android/morning.md msgid "" -"The options available to the [`rust_static_library` gn template](https://" -"source.chromium.org/chromium/chromium/src/+/main:build/rust/" -"rust_static_library.gni;l=16)" +"This is a group exercise: We will look at one of the projects you work with " +"and try to integrate some Rust into it. Some suggestions:" msgstr "" -"[`rust_static_library` gn テンプレート](https://source.chromium.org/chromium/" -"chromium/src/+/main:build/rust/rust_static_library.gni;l=16) で使用できるオプ" -"ション" +"これはグループ演習です。皆さんが取り組んでいるプロジェクトの一つを題材に、そ" +"こに Rust を統合してみましょう。以下にヒントを示します。" -#: src/exercises/chromium/build-rules.md +#: src/exercises/android/morning.md +msgid "Call your AIDL service with a client written in Rust." +msgstr "Rust で記述されたクライアントを使用して AIDL サービスを呼び出します。" + +#: src/exercises/android/morning.md +msgid "Move a function from your project to Rust and call it." +msgstr "プロジェクトから Rust に関数を移動して呼び出します。" + +#: src/exercises/android/morning.md msgid "" -"Information about [`#[no_mangle]`](https://doc.rust-lang.org/beta/reference/" -"abi.html#the-no_mangle-attribute)" +"No solution is provided here since this is open-ended: it relies on someone " +"in the class having a piece of code which you can turn in to Rust on the fly." msgstr "" -"[`#[no_mangle]`](https://doc.rust-lang.org/beta/reference/abi.html#the-" -"no_mangle-attribute) に関する情報" +"この演習は自由回答形式であるため、解答は用意されていません。クラスの誰かが" +"コードを持っていて、その場で Rust に変換できることを前提としています。" -#: src/exercises/chromium/build-rules.md +#: src/chromium.md +msgid "Welcome to Rust in Chromium" +msgstr "Chromium の Rust へようこそ" + +#: src/chromium.md msgid "" -"Information about [`extern \"C\"`](https://doc.rust-lang.org/std/keyword." -"extern.html)" +"Rust is supported for third-party libraries in Chromium, with first-party " +"glue code to connect between Rust and existing Chromium C++ code." msgstr "" -"[`extern \"C\"`](https://doc.rust-lang.org/std/keyword.extern.html) に関する" -"情報" +"Rust は Chromium のサードパーティ ライブラリでサポートされています。Rust と既" +"存の Chromium C++ コードを接続するには、ファースト パーティのグルーコードを使" +"用します。" -#: src/exercises/chromium/build-rules.md +#: src/chromium.md msgid "" -"Information about gn's [`--export-rust-project`](https://gn.googlesource.com/" -"gn/+/main/docs/reference.md#compilation-database) switch" +"Today, we'll call into Rust to do something silly with strings. If you've " +"got a corner of the code where you're displaying a UTF8 string to the user, " +"feel free to follow this recipe in your part of the codebase instead of the " +"exact part we talk about." msgstr "" -"gn の [`--export-rust-project`](https://gn.googlesource.com/gn/+/main/docs/" -"reference.md#compilation-database) スイッチに関する情報" +"本日は、Rust で文字列を使って面白いことをしたいと思います。もし自分の担当部分" +"にUTF8 文字列を表示するコードがある場合は、ここで述べた部分ではなく、自分の" +"コードに対してこの手順を実行して構いません。" -#: src/exercises/chromium/build-rules.md +#: src/chromium/setup.md msgid "" -"[How to install rust-analyzer in VSCode](https://code.visualstudio.com/docs/" -"languages/rust)" +"Make sure you can build and run Chromium. Any platform and set of build " +"flags is OK, so long as your code is relatively recent (commit position " +"1223636 onwards, corresponding to November 2023):" msgstr "" -"[VSCode に rust-analyzer をインストールする方法](https://code.visualstudio." -"com/docs/languages/rust)" +"Chromium をビルドして実行できることを確認します。コードが比較的最近のもの" +"（2023 年 11 月に対応するコミット位置 1223636 以降）であれば、任意のプラット" +"フォームとビルドフラグのセットで問題ありません。" -#: src/exercises/chromium/build-rules.md +#: src/chromium/setup.md msgid "" -"This example is unusual because it boils down to the lowest-common-" -"denominator interop language, C. Both C++ and Rust can natively declare and " -"call C ABI functions. Later in the course, we'll connect C++ directly to " -"Rust." +"(A component, debug build is recommended for quickest iteration time. This " +"is the default!)" msgstr "" -"この例は、共通の相互運用言語である C に集約されているため、一般的ではありませ" -"ん。C++ と Rust はどちらも、C ABI 関数をネイティブに宣言して呼び出すことがで" -"きます。コースの後半で、C++ を Rust に直接接続します。" +"（反復処理の時間を最短にするには、コンポーネントのデバッグビルドをおすすめし" +"ます。これがデフォルトです）" -#: src/exercises/chromium/build-rules.md +#: src/chromium/setup.md msgid "" -"`allow_unsafe = true` is required here because `#[no_mangle]` might allow " -"Rust to generate two functions with the same name, and Rust can no longer " -"guarantee that the right one is called." +"See [How to build Chromium](https://www.chromium.org/developers/how-tos/get-" +"the-code/) if you aren't already at that point. Be warned: setting up to " +"build Chromium takes time." msgstr "" -"ここで `allow_unsafe = true` は必須です。`#[no_mangle]` により、Rust は同じ名" -"前の関数を2つ生成するようになり、Rust は正しい関数が呼び出されることを保証で" -"きなくなるためです。" +"まだ確認していない場合は、[Chromium のビルド方法](https://www.chromium.org/" +"developers/how-tos/get-the-code/) を確認してください。なお、Chromium をビルド" +"するためのセットアップには時間がかかります。" -#: src/exercises/chromium/build-rules.md -msgid "" -"If you need a pure Rust executable, you can also do that using the " -"`rust_executable` gn template." -msgstr "" -"純粋な Rust 実行可能ファイルが必要な場合は、`rust_executable` gn テンプレート" -"を使用して行うこともできます。" +#: src/chromium/setup.md +msgid "It's also recommended that you have Visual Studio code installed." +msgstr "また、Visual Studio Code をインストールしておくことをおすすめします。" -#: src/chromium/testing.md +#: src/chromium/setup.md +msgid "About the exercises" +msgstr "演習について" + +#: src/chromium/setup.md msgid "" -"Rust community typically authors unit tests in a module placed in the same " -"source file as the code being tested. This was covered [earlier](../testing." -"md) in the course and looks like this:" +"This part of the course has a series of exercises which build on each other. " +"We'll be doing them spread throughout the course instead of just at the end. " +"If you don't have time to complete a certain part, don't worry: you can " +"catch up in the next slot." msgstr "" -"Rust コミュニティは通常、テスト対象のコードと同じソースファイルに配置されたモ" -"ジュールで単体テストを作成します。これは本コースの [前の部分](../testing.md) " -"で説明しており、以下のようになります。" +"コースのこのパートには、相互に関連した一連の演習があります。コースの最後だけ" +"でなく、全体を通して演習を行います。特定のパートを完了する時間がない場合も、" +"後で追いつけばよいため心配はいりません。" -#: src/chromium/testing.md +#: src/chromium/cargo.md +#, fuzzy msgid "" -"In Chromium we place unit tests in a separate source file and we continue to " -"follow this practice for Rust --- this makes tests consistently discoverable " -"and helps to avoid rebuilding `.rs` files a second time (in the `test` " -"configuration)." +"The Rust community typically uses `cargo` and libraries from [crates.io]" +"(https://crates.io/). Chromium is built using `gn` and `ninja` and a curated " +"set of dependencies." msgstr "" -"Chromium では単体テストを別のソースファイルに配置しており、Rust でもこの方針" -"を継続します。これにより、テストが常に検出可能になり、2 度目に（`test` 構成" -"で）`.rs` ファイルを再ビルドする必要がなくなります。" +"Rust コミュニティでは通常、`cargo` と [crates.io](https://crates.io/) のライ" +"ブラリを使用します。Chromium は、`gn` と `ninja`、および厳選された依存関係の" +"セットを使用してビルドされています。" -#: src/chromium/testing.md +#: src/chromium/cargo.md +msgid "When writing code in Rust, your choices are:" +msgstr "Rust でコードを記述する際は、次の選択肢があります。" + +#: src/chromium/cargo.md msgid "" -"This results in the following options for testing Rust code in Chromium:" +"Use `gn` and `ninja` with the help of the templates from `//build/rust/*." +"gni` (e.g. `rust_static_library` that we'll meet later). This uses " +"Chromium's audited toolchain and crates." msgstr "" -"その結果、Chromium で Rust コードをテストするための次の選択肢が提供されます。" +"`//build/rust/*.gni` のテンプレート（例: 後で説明する `rust_static_library`）" +"を参考にして、`gn` と `ninja` を使用します。これには、Chromium の監査済みの" +"ツールチェーンとクレートが使用されます。" -#: src/chromium/testing.md +#: src/chromium/cargo.md msgid "" -"Native Rust tests (i.e. `#[test]`). Discouraged outside of `//third_party/" -"rust`." +"Use `cargo`, but [restrict yourself to Chromium's audited toolchain and " +"crates](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/" +"docs/rust.md#Using-cargo)" msgstr "" -"ネイティブ Rust テスト（例: `#[test]`）。`//third_party/rust` 以外では推奨さ" -"れません。" +"`cargo` を使用しますが、実際の利用を[Chromium の監査済みのツールチェーンとク" +"レートに制限します](https://chromium.googlesource.com/chromium/src/+/refs/" +"heads/main/docs/rust.md#Using-cargo)。" -#: src/chromium/testing.md +#: src/chromium/cargo.md msgid "" -"`gtest` tests authored in C++ and exercising Rust via FFI calls. Sufficient " -"when Rust code is just a thin FFI layer and the existing unit tests provide " -"sufficient coverage for the feature." +"Use `cargo`, trusting a [toolchain](https://rustup.rs/) and/or [crates " +"downloaded from the internet](https://crates.io/)" msgstr "" -"C++ で作成され、FFI 呼び出しを介して Rust を実行する `gtest` テスト。Rust " -"コードが単なる薄いFFI レイヤであり、既存の単体テストで今後この機能が漏れなく" -"カバーされる場合には十分です。" +"`cargo` を使用し、[ツールチェーン](https://rustup.rs/) や [インターネットから" +"ダウンロードしたクレート](https://crates.io/) を信頼します。" -#: src/chromium/testing.md +#: src/chromium/cargo.md msgid "" -"`gtest` tests authored in Rust and using the crate under test through its " -"public API (using `pub mod for_testing { ... }` if needed). This is the " -"subject of the next few slides." +"From here on we'll be focusing on `gn` and `ninja`, because this is how Rust " +"code can be built into the Chromium browser. At the same time, Cargo is an " +"important part of the Rust ecosystem and you should keep it in your toolbox." msgstr "" -"Rust で作成され、公開 API を介してテスト対象のクレートを使用する `gtest` テス" -"ト（必要に応じて `pub mod for_testing { ... }` を使用）。これについては、次の" -"数枚のスライドで説明します。" +"ここからは、`gn` と `ninja` に焦点を当てます。これらを使用することで、" +"Chromium ブラウザに Rust コードを組み込むことができます。それとは別に、Cargo " +"は Rust エコシステムの重要な部分であり、使いこなせるようになっているべきで" +"す。" -#: src/chromium/testing.md +#: src/chromium/cargo.md +#, fuzzy +msgid "Mini exercise" +msgstr "練習問題" + +#: src/chromium/cargo.md +msgid "Split into small groups and:" +msgstr "少人数のグループに分け、以下を行います。" + +#: src/chromium/cargo.md msgid "" -"Mention that native Rust tests of third-party crates should eventually be " -"exercised by Chromium bots. (Such testing is needed rarely --- only after " -"adding or updating third-party crates.)" +"Brainstorm scenarios where `cargo` may offer an advantage and assess the " +"risk profile of these scenarios." msgstr "" -"サードパーティ クレートのネイティブ Rust テストが最終的に Chromium bot によっ" -"て実行される必要があることを説明します（このようなテストが必要になることは" -"めったになく、サードパーティのクレートを追加または更新した後にのみ必要となり" -"ます）。" +"`cargo` がメリットをもたらす可能性のあるシナリオをブレインストーミングし、そ" +"れらのシナリオのリスク プロファイルを評価します。" -#: src/chromium/testing.md +#: src/chromium/cargo.md msgid "" -"Some examples may help illustrate when C++ `gtest` vs Rust `gtest` should be " -"used:" +"Discuss which tools, libraries, and groups of people need to be trusted when " +"using `gn` and `ninja`, offline `cargo`, etc." msgstr "" -"C++ の`gtest` と Rust の`gtest` をどのような場合に使うべきか、いくつかの例を" -"使って説明するとよいでしょう。" +"`gn` や `ninja`、オフラインの `cargo` などを使用する際に、どのツール、ライブ" +"ラリ、人々を信頼しなければならないかについて話し合います。" -#: src/chromium/testing.md +#: src/chromium/cargo.md msgid "" -"QR has very little functionality in the first-party Rust layer (it's just a " -"thin FFI glue) and therefore uses the existing C++ unit tests for testing " -"both the C++ and the Rust implementation (parameterizing the tests so they " -"enable or disable Rust using a `ScopedFeatureList`)." +"Ask students to avoid peeking at the speaker notes before completing the " +"exercise. Assuming folks taking the course are physically together, ask them " +"to discuss in small groups of 3-4 people." msgstr "" -"QR には、ファースト パーティの Rust レイヤの機能はほとんどありません（単なる" -"シン FFI グルーです）。そのため、C++ と Rust の実装の両方をテストするには、既" -"存の C++ 単体テストを使用します（テストをパラメータ化し、`ScopedFeatureList` " -"を使用して Rust を有効化または無効化できるようになっています）。" +"受講者に、演習を完了する前にスピーカー ノートをのぞかないようお願いしてくださ" +"い。コースの受講者同士が地理的に集まっていると仮定して、3～4 人の少人数のグ" +"ループで話し合ってもらうようにお願いしてください。" -#: src/chromium/testing.md +#: src/chromium/cargo.md msgid "" -"Hypothetical/WIP PNG integration may need to implement memory-safe " -"implementation of pixel transformations that are provided by `libpng` but " -"missing in the `png` crate - e.g. RGBA => BGRA, or gamma correction. Such " -"functionality may benefit from separate tests authored in Rust." +"Notes/hints related to the first part of the exercise (\"scenarios where " +"Cargo may offer an advantage\"):" msgstr "" -"仮定の、または開発中の PNG 統合では、`libpng` では提供されているのに、`png` " -"クレートでは欠落しているピクセル変換（RGBA => BGRA、ガンマ補正など）のメモリ" -"セーフな実装が必要となる場合があります。このような機能の開発においては、別途" -"Rustでテストを作成することが役立つ場合があります。" +"演習の前半に関するメモとヒント（「Cargo がメリットをもたらすシナリオ」）:" -#: src/chromium/testing/rust-gtest-interop.md +#: src/chromium/cargo.md msgid "" -"The [`rust_gtest_interop`](https://chromium.googlesource.com/chromium/src/+/" -"main/testing/rust_gtest_interop/README.md) library provides a way to:" +"It's fantastic that when writing a tool, or prototyping a part of Chromium, " +"one has access to the rich ecosystem of crates.io libraries. There is a " +"crate for almost anything and they are usually quite pleasant to use. " +"(`clap` for command-line parsing, `serde` for serializing/deserializing to/" +"from various formats, `itertools` for working with iterators, etc.)." msgstr "" -"[`rust_gtest_interop`](https://chromium.googlesource.com/chromium/src/+/main/" -"testing/rust_gtest_interop/README.md) ライブラリを使用すると、次のことができ" -"ます。" +"ツールの作成時や Chromium の一部のプロトタイピング時に、crates.io ライブラリ" +"の充実したエコシステムにアクセスできるのは素晴らしいことです。ほぼすべての事" +"柄についてクレートが用意されており、大概の場合はとても快適に使用できます（コ" +"マンドラインを解析するための `clap`、さまざまな形式との間でシリアル化または逆" +"シリアル化を行うための `serde`、イテレータを操作するための `itertools` な" +"ど）。" -#: src/chromium/testing/rust-gtest-interop.md +#: src/chromium/cargo.md msgid "" -"Use a Rust function as a `gtest` testcase (using the `#[gtest(...)]` " -"attribute)" +"`cargo` makes it easy to try a library (just add a single line to `Cargo." +"toml` and start writing code)" msgstr "" -"Rust 関数を `gtest` テストケースとして使用する（`#[gtest(...)]` 属性を使" -"用）。" +"`cargo` を使用すると、ライブラリを簡単に試すことができます（`Cargo.toml` に " +"1 行追加してコードの記述を開始するだけです）。" -#: src/chromium/testing/rust-gtest-interop.md +#: src/chromium/cargo.md msgid "" -"Use `expect_eq!` and similar macros (similar to `assert_eq!` but not " -"panicking and not terminating the test when the assertion fails)." +"It may be worth comparing how CPAN helped make `perl` a popular choice. Or " +"comparing with `python` + `pip`." msgstr "" -"`expect_eq!` などのマクロを使用する（`assert_eq!`と似ていますが、アサーション" -"が失敗してもパニックせず、テストを終了しません）。" - -#: src/chromium/testing/rust-gtest-interop.md -#, fuzzy -msgid "Example:" -msgstr "例" +"`perl` の普及に役立った CPAN や、`python` における `pip` と比較してみると良い" +"かもしれません。" -#: src/chromium/testing/build-gn.md +#: src/chromium/cargo.md msgid "" -"The simplest way to build Rust `gtest` tests is to add them to an existing " -"test binary that already contains tests authored in C++. For example:" +"Development experience is made really nice not only by core Rust tools (e.g. " +"using `rustup` to switch to a different `rustc` version when testing a crate " +"that needs to work on nightly, current stable, and older stable) but also by " +"an ecosystem of third-party tools (e.g. Mozilla provides `cargo vet` for " +"streamlining and sharing security audits; `criterion` crate gives a " +"streamlined way to run benchmarks)." msgstr "" -"Rust の `gtest` テストをビルドする最も簡単な方法は、C++ で作成されたテストが" -"すでに含まれている既存のテストバイナリに追加することです。次に例を示します。" +"主要な Rust ツール（ナイトリー、現在の安定版、古い安定版で動作する必要がある" +"クレートをテストするときに、別の `rustc` バージョンに切り替えるのに使用する " +"`rustup` など）だけでなく、サードパーティ ツールのエコシステム（Mozilla が提" +"供するセキュリティ監査の容易化と共有のため `cargo vet`、ベンチマークを容易に" +"実行する方法を提供する `criterion` クレートなど）により、開発エクスペリエンス" +"は非常に快適となっています。" -#: src/chromium/testing/build-gn.md +#: src/chromium/cargo.md msgid "" -"```gn\n" -"test(\"ui_base_unittests\") {\n" -" ...\n" -" sources += [ \"my_rust_lib_unittest.rs\" ]\n" -" deps += [ \":my_rust_lib\" ]\n" -"}\n" -"```" +"`cargo` makes it easy to add a tool via `cargo install --locked cargo-vet`." msgstr "" -"```gn\n" -"test(\"ui_base_unittests\") {\n" -" ...\n" -" sources += [ \"my_rust_lib_unittest.rs\" ]\n" -" deps += [ \":my_rust_lib\" ]\n" -"}\n" -"```" +"`cargo` を使用すると、`cargo install --locked cargo-vet` を介してツールを簡単" +"に追加できます。" -#: src/chromium/testing/build-gn.md -msgid "" -"Authoring Rust tests in a separate `static_library` also works, but requires " -"manually declaring the dependency on the support libraries:" +#: src/chromium/cargo.md +msgid "It may be worth comparing with Chrome Extensions or VScode extensions." msgstr "" -"別途、`static_library` で Rust テストを作成することも可能ですが、サポート ラ" -"イブラリへの依存関係を手動で宣言する必要があります。" +"Chrome 拡張機能や VScode 拡張機能と比較してみるのも良いかもしれません。" -#: src/chromium/testing/build-gn.md +#: src/chromium/cargo.md msgid "" -"```gn\n" -"rust_static_library(\"my_rust_lib_unittests\") {\n" -" testonly = true\n" -" is_gtest_unittests = true\n" -" crate_root = \"my_rust_lib_unittest.rs\"\n" -" sources = [ \"my_rust_lib_unittest.rs\" ]\n" -" deps = [\n" -" \":my_rust_lib\",\n" -" \"//testing/rust_gtest_interop\",\n" -" ]\n" -"}\n" -"\n" -"test(\"ui_base_unittests\") {\n" -" ...\n" -" deps += [ \":my_rust_lib_unittests\" ]\n" -"}\n" -"```" +"Broad, generic examples of projects where `cargo` may be the right choice:" msgstr "" -"```gn\n" -"rust_static_library(\"my_rust_lib_unittests\") {\n" -" testonly = true\n" -" is_gtest_unittests = true\n" -" crate_root = \"my_rust_lib_unittest.rs\"\n" -" sources = [ \"my_rust_lib_unittest.rs\" ]\n" -" deps = [\n" -" \":my_rust_lib\",\n" -" \"//testing/rust_gtest_interop\",\n" -" ]\n" -"}\n" -"\n" -"test(\"ui_base_unittests\") {\n" -" ...\n" -" deps += [ \":my_rust_lib_unittests\" ]\n" -"}\n" -"```" +"`cargo` が適切な選択となるような、幅広い汎用的なプロジェクトの例を以下に示し" +"ます。" -#: src/chromium/testing/chromium-import-macro.md +#: src/chromium/cargo.md msgid "" -"After adding `:my_rust_lib` to GN `deps`, we still need to learn how to " -"import and use `my_rust_lib` from `my_rust_lib_unittest.rs`. We haven't " -"provided an explicit `crate_name` for `my_rust_lib` so its crate name is " -"computed based on the full target path and name. Fortunately we can avoid " -"working with such an unwieldy name by using the `chromium::import!` macro " -"from the automatically-imported `chromium` crate:" +"Perhaps surprisingly, Rust is becoming increasingly popular in the industry " +"for writing command line tools. The breadth and ergonomics of libraries is " +"comparable to Python, while being more robust (thanks to the rich " +"typesystem) and running faster (as a compiled, rather than interpreted " +"language)." msgstr "" -"GN の `deps` に `:my_rust_lib` を追加した後も、`my_rust_lib_unittest.rs` か" -"ら `my_rust_lib` をインポートして使用する方法について学ぶ必要があります。" -"`my_rust_lib` には明示的な `crate_name` が指定されていないため、クレート名は" -"ターゲットのフルパスと名前に基づいて生成されます。幸い、自動的にインポートさ" -"れる `chromium` クレートから `chromium::import!` マクロを使用すれば、このよう" -"な扱いにくい名前の使用を回避できます。" +"意外かもしれませんが、業界ではコマンドライン ツールの作成に使用する言語とし" +"て、Rust の人気が高まっています。ライブラリの幅とエルゴノミクスの点で Python " +"に匹敵しつつも、豊富な型システムのおかげで堅牢で、（インタプリタ言語ではなく" +"コンパイル言語なので）実行速度が高速です。" -#: src/chromium/testing/chromium-import-macro.md -msgid "\"//ui/base:my_rust_lib\"" -msgstr "\"//ui/base:my_rust_lib\"" +#: src/chromium/cargo.md +msgid "" +"Participating in the Rust ecosystem requires using standard Rust tools like " +"Cargo. Libraries that want to get external contributions, and want to be " +"used outside of Chromium (e.g. in Bazel or Android/Soong build environments) " +"should probably use Cargo." +msgstr "" +"Rust エコシステムに参加するには、Cargo などの標準の Rust ツールを使用する必要" +"があります。外部からコントリビューションを受け、Chromium 以外（Bazel や " +"Android / Soong のビルド環境など）での使用が推奨されるライブラリでは、Cargo " +"を使用することをおすすめします。" -#: src/chromium/testing/chromium-import-macro.md -msgid "Under the covers the macro expands to something similar to:" -msgstr "内部で、マクロは次のように展開されます。" +#: src/chromium/cargo.md +msgid "Examples of Chromium-related projects that are `cargo`\\-based:" +msgstr "`cargo` ベースの Chromium 関連プロジェクトの例:" -#: src/chromium/testing/chromium-import-macro.md +#: src/chromium/cargo.md msgid "" -"More information can be found in [the doc comment](https://source.chromium." -"org/chromium/chromium/src/+/main:build/rust/chromium_prelude/" -"chromium_prelude.rs?q=f:chromium_prelude.rs%20pub.use.*%5Cbimport%5Cb;%20-f:" -"third_party&ss=chromium%2Fchromium%2Fsrc) of the `chromium::import` macro." +"`serde_json_lenient` (experimented with in other parts of Google which " +"resulted in PRs with performance improvements)" msgstr "" -"詳しくは、`chromium::import` マクロの [ドキュメント コメント](https://source." -"chromium.org/chromium/chromium/src/+/main:build/rust/chromium_prelude/" -"chromium_prelude.rs?q=f:chromium_prelude.rs%20pub.use.*%5Cbimport%5Cb;%20-f:" -"third_party&ss=chromium%2Fchromium%2Fsrc) をご覧ください。" +"`serde_json_lenient`（Google の他の部門でテストした結果、PR のパフォーマンス" +"が向上）" -#: src/chromium/testing/chromium-import-macro.md +#: src/chromium/cargo.md +msgid "Fontations libraries like `font-types`" +msgstr "`font-types` などのフォント化ライブラリ" + +#: src/chromium/cargo.md msgid "" -"`rust_static_library` supports specifying an explicit name via `crate_name` " -"property, but doing this is discouraged. And it is discouraged because the " -"crate name has to be globally unique. crates.io guarantees uniqueness of its " -"crate names so `cargo_crate` GN targets (generated by the `gnrt` tool " -"covered in a later section) use short crate names." +"`gnrt` tool (we will meet it later in the course) which depends on `clap` " +"for command-line parsing and on `toml` for configuration files." msgstr "" -"`rust_static_library` は、`crate_name` プロパティによる明示的な名前の指定をサ" -"ポートしていますが、クレート名はグローバルに一意である必要があるため、これは" -"推奨されません。crates.io はクレート名の一意性を保証しているため、" -"`cargo_crate` GN ターゲット（後述の `gnrt` ツールで生成）は短いクレート名を使" -"用します。" +"`gnrt` ツール（このコースの後半で取り上げます）は、コマンドラインの解析には " +"`clap` を使用し、構成ファイルには `toml` を使用します。" -#: src/exercises/chromium/testing.md +#: src/chromium/cargo.md #, fuzzy -msgid "Testing exercise" -msgstr "練習問題" - -#: src/exercises/chromium/testing.md -msgid "Time for another exercise!" -msgstr "新たな演習の時間です！" - -#: src/exercises/chromium/testing.md -msgid "In your Chromium build:" -msgstr "Chromium ビルドで以下を行ってください。" - -#: src/exercises/chromium/testing.md msgid "" -"Add a testable function next to `hello_from_rust`. Some suggestions: adding " -"two integers received as arguments, computing the nth Fibonacci number, " -"summing integers in a slice, etc." +"Disclaimer: a unique reason for using `cargo` was unavailability of `gn` " +"when building and bootstrapping Rust standard library when building Rust " +"toolchain." msgstr "" -"`hello_from_rust` の横にテスト可能な関数を追加します。たとえば、引数として受" -"け取った 2 つの整数を追加する、n 番目のフィボナッチ数を計算する、スライス内の" -"整数を合計する、などが考えられます。" +"免責条項: `cargo` を使用する唯一の理由は、Rust ツールチェーンのビルド中、" +"Rust 標準ライブラリのビルドとブートストラップを行う際に `gn` を使用できないこ" +"とでした。" -#: src/exercises/chromium/testing.md -msgid "Add a separate `..._unittest.rs` file with a test for the new function." +#: src/chromium/cargo.md +#, fuzzy +msgid "" +"`run_gnrt.py` uses Chromium's copy of `cargo` and `rustc`. `gnrt` depends on " +"third-party libraries downloaded from the internet, but `run_gnrt.py` asks " +"`cargo` that only `--locked` content is allowed via `Cargo.lock`.)" msgstr "" -"新しい関数のテストを含む別個の `..._unittest.rs` ファイルを追加します。" - -#: src/exercises/chromium/testing.md -msgid "Add the new tests to `BUILD.gn`." -msgstr "新しいテストを `BUILD.gn` に追加します。" - -#: src/exercises/chromium/testing.md -msgid "Build the tests, run them, and verify that the new test works." -msgstr "テストをビルドして実行し、新しいテストが機能することを確認します。" +"`run_gnrt.py` は、Chromiumプロジェクト内の `cargo` と `rustc` のコピーを使用" +"します。`gnrt` はインターネットからダウンロードされたサードパーティ ライブラ" +"リに依存しており、`run_gnrt.py` で `Cargo.lock` を介して `--locked` コンテン" +"ツのみを許可することを `cargo` に要求します。" -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/cargo.md msgid "" -"The Rust community offers multiple options for C++/Rust interop, with new " -"tools being developed all the time. At the moment, Chromium uses a tool " -"called CXX." +"Students may identify the following items as being implicitly or explicitly " +"trusted:" msgstr "" -"Rust コミュニティには C++ と Rust の相互運用のためのオプションが複数用意され" -"ており、絶えず新しいツールが開発されています。現在のところ、Chromium では " -"CXX というツールを使用しています。" +"以下のアイテムは、暗黙的または明示的に信頼されているとみなして構いません。" -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/cargo.md msgid "" -"You describe your whole language boundary in an interface definition " -"language (which looks a lot like Rust) and then CXX tools generate " -"declarations for functions and types in both Rust and C++." +"`rustc` (the Rust compiler) which in turn depends on the LLVM libraries, the " +"Clang compiler, the `rustc` sources (fetched from GitHub, reviewed by Rust " +"compiler team), binary Rust compiler downloaded for bootstrapping" msgstr "" -"言語境界全体をインターフェース定義言語（Rust によく似ています）で記述すると、" -"CXX ツールが Rust と C++ の両方で関数と型の宣言を生成します。" +"LLVM ライブラリ、Clang コンパイラ、`rustc` ソース（GitHub から取得され、Rust " +"コンパイラ チームによるレビューを受けたもの）、ブートストラップ用にダウンロー" +"ドされたバイナリ Rust コンパイラに依存する `rustc`（Rust コンパイラ）" -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/cargo.md msgid "" -"See the [CXX tutorial](https://cxx.rs/tutorial.html) for a full example of " -"using this." +"`rustup` (it may be worth pointing out that `rustup` is developed under the " +"umbrella of the https://github.com/rust-lang/ organization - same as `rustc`)" msgstr "" -"CXX の詳細な使用例については、[CXX チュートリアル](https://cxx.rs/tutorial." -"html) をご覧ください。" +"`rustup`（`rustup` は `rustc`と同じく https://github.com/rust-lang/ 組織の傘" +"下で開発されていることを説明すると良いかもしれません）" -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/cargo.md +msgid "`cargo`, `rustfmt`, etc." +msgstr "`cargo`、`rustfmt` など" + +#: src/chromium/cargo.md msgid "" -"Talk through the diagram. Explain that behind the scenes, this is doing just " -"the same as you previously did. Point out that automating the process has " -"the following benefits:" +"Various internal infrastructure (bots that build `rustc`, system for " +"distributing the prebuilt toolchain to Chromium engineers, etc.)" msgstr "" -"図を見ながら話しましょう。裏で行われる処理は以前とまったく同じであり、このプ" -"ロセスを自動化すると次のようなメリットがあることを説明します。" +"さまざまな内部インフラストラクチャ（`rustc` をビルドする bot、事前構築済みの" +"ツールチェーンを Chromium エンジニアに配布するためのシステムなど）" -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/cargo.md +msgid "Cargo tools like `cargo audit`, `cargo vet`, etc." +msgstr "`cargo audit` や `cargo vet` などの Cargo ツール" + +#: src/chromium/cargo.md msgid "" -"The tool guarantees that the C++ and Rust sides match (e.g. you get compile " -"errors if the `#[cxx::bridge]` doesn't match the actual C++ or Rust " -"definitions, but with out-of-sync manual bindings you'd get Undefined " -"Behavior)" +"Rust libraries vendored into `//third_party/rust` (audited by " +"security@chromium.org)" msgstr "" -"このツールは、C++ 側と Rust 側が一致することを保証します（たとえば、`#[cxx::" -"bridge]` が実際の C++ または Rust の定義と一致しない場合、コンパイル エラーが" -"発生しますが、同期されていない手動バインディングを使用すると、未定義の動作が" -"発生します）。" +"`//third_party/rust` に取り込まれたRust ライブラリ（security@chromium.org が" +"監査）" -#: src/chromium/interoperability-with-cpp.md -msgid "" -"The tool automates generation of FFI thunks (small, C-ABI-compatible, free " -"functions) for non-C features (e.g. enabling FFI calls into Rust or C++ " -"methods; manual bindings would require authoring such top-level, free " -"functions manually)" +#: src/chromium/cargo.md +msgid "Other Rust libraries (some niche, some quite popular and commonly used)" msgstr "" -"このツールは、C 以外の機能に対する FFI サンク（小さな C-ABI 互換のフリー関" -"数）の生成を自動化します（Rust または C++ メソッドへの FFI 呼び出しの有効化な" -"ど。手動バインディングでは、このようなトップレベルのフリー関数を手動で作成す" -"る必要があります）。" +"その他の Rust ライブラリ（ニッチなものもあれば、非常に人気がありよく使用され" +"るものもあります）" -#: src/chromium/interoperability-with-cpp.md -msgid "The tool and the library can handle a set of core types - for example:" -msgstr "ツールとライブラリは、次のような一連の主要な型を処理できます。" +#: src/chromium/policy.md +msgid "Chromium Rust policy" +msgstr "Chromium の Rust ポリシー" -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/policy.md msgid "" -"`&[T]` can be passed across the FFI boundary, even though it doesn't " -"guarantee any particular ABI or memory layout. With manual bindings `std::" -"span` / `&[T]` have to be manually destructured and rebuilt out of a " -"pointer and length - this is error-prone given that each language represents " -"empty slices slightly differently)" +"Chromium does not yet allow first-party Rust except in rare cases as " +"approved by Chromium's [Area Tech Leads](https://source.chromium.org/" +"chromium/chromium/src/+/main:ATL_OWNERS)." msgstr "" -"`&[T]` は、特定の ABI やメモリ レイアウトを保証するものではありませんが、FFI " -"の境界を超えて渡すことができます。手動バインディングでは、`std::span` / " -"`&[T]` を手動で分離し、ポインタと長さから再構築する必要があります。言語ごとに" -"空のスライスの表現方法が若干異なるため、エラーが発生しやすくなります。" +"Chromium では、Chromium の [エリア テクニカル リード](https://source." +"chromium.org/chromium/chromium/src/+/main:ATL_OWNERS) によって承認されている" +"まれなケースを除き、ファースト パーティでのRust使用はまだ許可されていません。" -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/policy.md msgid "" -"Smart pointers like `std::unique_ptr`, `std::shared_ptr`, and/or `Box` " -"are natively supported. With manual bindings, one would have to pass C-ABI-" -"compatible raw pointers, which would increase lifetime and memory-safety " -"risks." +"Chromium's policy on third party libraries is outlined [here](https://" +"chromium.googlesource.com/chromium/src/+/main/docs/adding_to_third_party." +"md#rust) - Rust is allowed for third party libraries under various " +"circumstances, including if they're the best option for performance or for " +"security." msgstr "" -"`std::unique_ptr`、`std::shared_ptr`、`Box` などのスマート ポインタは、" -"ネイティブにサポートされています。手動バインディングでは、C-ABI 互換の未加工" -"ポインタを渡す必要があるため、ライフタイムとメモリ安全性に関するリスクが高ま" -"ります。" +"サードパーティ ライブラリに関する Chromium のポリシーについては、[こちら]" +"(https://chromium.googlesource.com/chromium/src/+/main/docs/" +"adding_to_third_party.md#rust) をご覧ください。Rust は、パフォーマンスやセ" +"キュリティを高めるうえで最適な選択肢である場合を含め、さまざまな状況でサード" +"パーティ ライブラリに使用することが許可されています。" -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/policy.md msgid "" -"`rust::String` and `CxxString` types understand and maintain differences in " -"string representation across the languages (e.g. `rust::String::lossy` can " -"build a Rust string from non-UTF8 input and `rust::String::c_str` can NUL-" -"terminate a string)." +"Very few Rust libraries directly expose a C/C++ API, so that means that " +"nearly all such libraries will require a small amount of first-party glue " +"code." msgstr "" -"`rust::String` 型と `CxxString` 型は、言語間の文字列表現の違いを理解し、維持" -"します（たとえば、`rust::String::lossy` は、非 UTF8 の入力から Rust 文字列を" -"作成できます。また、`rust::String::c_str` は文字列を NUL 終端できます）。" +"C / C++ API を直接公開する Rust ライブラリはほとんどないため、こうしたライブ" +"ラリのほぼすべてで、少量のファースト パーティ グルーコードが必要になります。" -#: src/chromium/interoperability-with-cpp/example-bindings.md +#: src/chromium/policy.md msgid "" -"CXX requires that the whole C++/Rust boundary is declared in `cxx::bridge` " -"modules inside `.rs` source code." +"```bob\n" +"\"C++\" Rust\n" +".- - - - - - - - - -. .- - - - - - - - - - - - - - - - - - - - - - " +"-.\n" +": : : :\n" +": Existing Chromium : : Chromium Rust Existing " +"Rust :\n" +": \"C++\" : : \"wrapper\" " +"crate :\n" +": +---------------+ : : +----------------+ +-------------" +"+ :\n" +": | | : : | | | " +"| :\n" +": | o-----+-+-----------+-+-> o-+----------+--> " +"| :\n" +": | | : Language : | | Crate | " +"| :\n" +": +---------------+ : boundary : +----------------+ API +-------------" +"+ :\n" +": : : :\n" +"`- - - - - - - - - -' `- - - - - - - - - - - - - - - - - - - - - - " +"-'\n" +"```" msgstr "" -"CXX では、C++ と Rust の境界全体を `.rs` ソースコード内の `cxx::bridge` モ" -"ジュールで宣言する必要があります。" - -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "\"example/include/blobstore.h\"" -msgstr "\"example/include/blobstore.h\"" - -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "// Definitions of Rust types and functions go here\n" -msgstr "// Rust の型と関数の定義をここに記述します。\n" - -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "Point out:" -msgstr "以下を説明します。" +"```bob\n" +"\"C++\" Rust\n" +".- - - - - - - - - -. .- - - - - - - - - - - - - - - - - - - - - - " +"-.\n" +": : : :\n" +": 既存の Chromium : : \"Chromium Rust\" \"既存の " +"Rust\" :\n" +": \"C++\" : : \"ラッパー\" クレー" +"ト :\n" +": +---------------+ : : +----------------+ +-------------" +"+ :\n" +": | | : : | | | " +"| :\n" +": | o-----+-+-----------+-+-> o-+----------+--> " +"| :\n" +": | | : 言語 : | | Crate | " +"| :\n" +": +---------------+ : 境界 : +----------------+ API +-------------" +"+ :\n" +": : : :\n" +"`- - - - - - - - - -' `- - - - - - - - - - - - - - - - - - - - - - " +"-'\n" +"```" -#: src/chromium/interoperability-with-cpp/example-bindings.md +#: src/chromium/policy.md msgid "" -"Although this looks like a regular Rust `mod`, the `#[cxx::bridge]` " -"procedural macro does complex things to it. The generated code is quite a " -"bit more sophisticated - though this does still result in a `mod` called " -"`ffi` in your code." +"First-party Rust glue code for a particular third-party crate should " +"normally be kept in `third_party/rust///wrapper`." msgstr "" -"これは通常の Rust `mod` のように見えますが、`#[cxx::bridge]` プロシージャル " -"マクロはこれに対して複雑な処理を行います。生成されるコードはもっと洗練されて" -"いますが、それでもコードには `ffi` という `mod` が作成されます。" +"特定のサードパーティ クレート用のファースト パーティ Rust グルーコードは通" +"常、`third_party/rust///wrapper` に置かれるべきです。" -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "Native support for C++'s `std::unique_ptr` in Rust" -msgstr "Rust での C++ の `std::unique_ptr` のネイティブ サポート" +#: src/chromium/policy.md +msgid "Because of this, today's course will be heavily focused on:" +msgstr "以上の理由から、本日のコースでは以下に焦点を当てます。" -#: src/chromium/interoperability-with-cpp/example-bindings.md -#, fuzzy -msgid "Native support for Rust slices in C++" -msgstr "Rust での C++ の `std::unique_ptr` のネイティブ サポート" +#: src/chromium/policy.md +msgid "Bringing in third-party Rust libraries (\"crates\")" +msgstr "サードパーティの Rust ライブラリ（「クレート」）を導入する。" -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "Calls from C++ to Rust, and Rust types (in the top part)" -msgstr "C++ から Rust および Rust の型への呼び出し（上部）" +#: src/chromium/policy.md +msgid "Writing glue code to be able to use those crates from Chromium C++." +msgstr "Chromium C++ からクレートを使用できるようにグルーコードを記述する。" -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "Calls from Rust to C++, and C++ types (in the bottom part)" -msgstr "Rust から C++ および C++ の型への呼び出し（下部）" +#: src/chromium/policy.md +msgid "If this policy changes over time, the course will evolve to keep up." +msgstr "このポリシーが変更された場合は、それに合わせてコースも変更されます。" -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "" -"**Common misconception**: It _looks_ like a C++ header is being parsed by " -"Rust, but this is misleading. This header is never interpreted by Rust, but " -"simply `#include`d in the generated C++ code for the benefit of C++ " -"compilers." -msgstr "" -"**よくある誤解**: Rust で C++ ヘッダーが解析されているように見えますが、これ" -"は誤解です。このヘッダーは Rust では解釈されず、C++ コンパイラのために生成さ" -"れた C++ コードに `#include` されているだけです。" +#: src/chromium/build-rules.md +#, fuzzy +msgid "Build rules" +msgstr "ビルドのルール" -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#: src/chromium/build-rules.md msgid "" -"By far the most useful page when using CXX is the [type reference](https://" -"cxx.rs/bindings.html)." +"Rust code is usually built using `cargo`. Chromium builds with `gn` and " +"`ninja` for efficiency --- its static rules allow maximum parallelism. Rust " +"is no exception." msgstr "" -"CXX を使用するときに最も役立つページは、[型リファレンス](https://cxx.rs/" -"bindings.html) です。" - -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md -msgid "CXX fundamentally suits cases where:" -msgstr "CXX は基本的に、次のようなケースに適しています。" +"Rust コードは通常、`cargo` を使用してビルドされます。Chromium は効率を高める" +"ために `gn` と `ninja`を使用してビルドされますが、その静的ルールによって最大" +"限の並列処理が可能になります。Rust も例外ではありません。" -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md -msgid "" -"Your Rust-C++ interface is sufficiently simple that you can declare all of " -"it." -msgstr "Rust-C++ インターフェースが十分にシンプルで、すべてを宣言できる場合。" +#: src/chromium/build-rules.md +msgid "Adding Rust code to Chromium" +msgstr "Chromium に Rust コードを追加する" -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#: src/chromium/build-rules.md msgid "" -"You're using only the types natively supported by CXX already, for example " -"`std::unique_ptr`, `std::string`, `&[u8]` etc." +"In some existing Chromium `BUILD.gn` file, declare a `rust_static_library`:" msgstr "" -"すでに CXX でネイティブにサポートされている型のみを使用している場合（例: " -"`std::unique_ptr`、`std::string`、`&[u8]`）。" +"Chromium の既存の `BUILD.gn` ファイルで、`rust_static_library` を宣言します。" -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#: src/chromium/build-rules.md msgid "" -"It has many limitations --- for example lack of support for Rust's `Option` " -"type." +"```gn\n" +"import(\"//build/rust/rust_static_library.gni\")\n" +"\n" +"rust_static_library(\"my_rust_lib\") {\n" +" crate_root = \"lib.rs\"\n" +" sources = [ \"lib.rs\" ]\n" +"}\n" +"```" msgstr "" -"Rust の `Option` 型がサポートされていないなど、CXX には多くの制限があります。" +"```gn\n" +"import(\"//build/rust/rust_static_library.gni\")\n" +"\n" +"rust_static_library(\"my_rust_lib\") {\n" +" crate_root = \"lib.rs\"\n" +" sources = [ \"lib.rs\" ]\n" +"}\n" +"```" -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#: src/chromium/build-rules.md msgid "" -"These limitations constrain us to using Rust in Chromium only for well " -"isolated \"leaf nodes\" rather than for arbitrary Rust-C++ interop. When " -"considering a use-case for Rust in Chromium, a good starting point is to " -"draft the CXX bindings for the language boundary to see if it appears simple " -"enough." +"You can also add `deps` on other Rust targets. Later we'll use this to " +"depend upon third party code." msgstr "" -"こうした制限により、Chromium では 任意の Rust と C++ の相互運用は行われず、" -"Rustの使用は十分に独立したコードに限定されています。Chromium での Rust のユー" -"スケースを検討する際は、まず、言語境界の CXX バインディングの下書きを作成し" -"て、シンプルに見えるかどうかを確認することをおすすめします。" +"他の Rust ターゲットに `deps` を追加することもできます。後でこれを使用して、" +"サードパーティのコードへの依存を設定します。" -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#: src/chromium/build-rules.md msgid "" -"You should also discuss some of the other sticky points with CXX, for " -"example:" +"You must specify _both_ the crate root, _and_ a full list of sources. The " +"`crate_root` is the file given to the Rust compiler representing the root " +"file of the compilation unit --- typically `lib.rs`. `sources` is a complete " +"list of all source files which `ninja` needs in order to determine when " +"rebuilds are necessary." msgstr "" -"また、CXX のその他の厄介な点を説明する必要があります。次に例を示します。" - -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md -msgid "" -"Its error handling is based around C++ exceptions (given on the next slide)" -msgstr "エラー処理が C++ 例外に基づいて行われる（次のスライドを参照）。" - -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md -msgid "Function pointers are awkward to use." -msgstr "関数ポインタが使いにくい。" +"クレートルートとソースの完全なリストの両方を指定する必要があります。" +"`crate_root` は Rust コンパイラに渡されるファイルで、コンパイル単位のルート" +"ファイル（通常は `lib.rs`）を表します。`sources` はすべてのソースファイルの完" +"全なリストで、再ビルドが必要なタイミングを `ninja` が判断するために必要です。" -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/chromium/build-rules.md msgid "" -"CXX's [support for `Result`](https://cxx.rs/binding/result.html) relies " -"on C++ exceptions, so we can't use that in Chromium. Alternatives:" +"(There's no such thing as a Rust `source_set`, because in Rust, an entire " +"crate is a compilation unit. A `static_library` is the smallest unit.)" msgstr "" -"CXX の [`Result` のサポート](https://cxx.rs/binding/result.html) は、C+" -"+ 例外に依存しているため、Chromium では使用できません。以下の代替手段がありま" -"す。" - -#: src/chromium/interoperability-with-cpp/error-handling.md -msgid "The `T` part of `Result` can be:" -msgstr "`Result` の `T` の部分:" +"（Rust ではクレート全体がコンパイル単位であるため、`source_set`と呼べるような" +"ものは存在しません。`static_library` が最小単位です）。" -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/chromium/build-rules.md msgid "" -"Returned via out parameters (e.g. via `&mut T`). This requires that `T` can " -"be passed across the FFI boundary - for example `T` has to be:" +"Students might be wondering why we need a gn template, rather than using " +"[gn's built-in support for Rust static libraries](https://gn.googlesource." +"com/gn/+/main/docs/reference.md#func_static_library). The answer is that " +"this template provides support for CXX interop, Rust features, and unit " +"tests, some of which we'll use later." msgstr "" -"out パラメータを介して返すことができます（例: `&mut T`）。そのためには、`T` " -"を FFI の境界を越えて渡せる必要があります。たとえば、`T` には以下を指定する必" -"要があります。" +"受講者は、なぜ [Rust の静的ライブラリに対する gn の組み込みサポート](https://" +"gn.googlesource.com/gn/+/main/docs/reference.md#func_static_library) ではな" +"く、gn テンプレートを使用する必要があるのか疑問に思うかもしれません。その答え" +"は、このテンプレートが CXX 相互運用、Rustのfeatures、単体テストをサポートして" +"いるためです。その一部は後で使用します。" -#: src/chromium/interoperability-with-cpp/error-handling.md -msgid "A primitive type (like `u32` or `usize`)" -msgstr "プリミティブ型（`u32`、`usize` など）" +#: src/chromium/build-rules/unsafe.md +msgid "Including `unsafe` Rust Code" +msgstr "`unsafe` Rust コードの追加" -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/chromium/build-rules/unsafe.md msgid "" -"A type natively supported by `cxx` (like `UniquePtr`) that has a suitable " -"default value to use in a failure case (_unlike_ `Box`)." +"Unsafe Rust code is forbidden in `rust_static_library` by default --- it " +"won't compile. If you need unsafe Rust code, add `allow_unsafe = true` to " +"the gn target. (Later in the course we'll see circumstances where this is " +"necessary.)" msgstr "" -"(`Box` とは異なり)適切なデフォルト値を持つ`cxx` でネイティブにサポートされ" -"ている型（`UniquePtr` など）。" +"安全でない Rust コードはデフォルトでは `rust_static_library` で禁止されてお" +"り、コンパイルできません。安全でない Rust コードが必要な場合は、gn ターゲット" +"に `allow_unsafe = true` を追加します（これが必要になる状況については、この" +"コースの後半で説明します）。" -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/chromium/build-rules/unsafe.md msgid "" -"Retained on the Rust side, and exposed via reference. This may be needed " -"when `T` is a Rust type, which cannot be passed across the FFI boundary, and " -"cannot be stored in `UniquePtr`." +"```gn\n" +"import(\"//build/rust/rust_static_library.gni\")\n" +"\n" +"rust_static_library(\"my_rust_lib\") {\n" +" crate_root = \"lib.rs\"\n" +" sources = [\n" +" \"lib.rs\",\n" +" \"hippopotamus.rs\"\n" +" ]\n" +" allow_unsafe = true\n" +"}\n" +"```" msgstr "" -"Rust 側で保持し、参照を介して公開できます。これは、`T` が Rust 型の場合に必要" -"になることがあります。Rust 型は FFI の境界を超えて渡すことができず、" -"`UniquePtr` に格納することもできません。" +"```gn\n" +"import(\"//build/rust/rust_static_library.gni\")\n" +"\n" +"rust_static_library(\"my_rust_lib\") {\n" +" crate_root = \"lib.rs\"\n" +" sources = [\n" +" \"lib.rs\",\n" +" \"hippopotamus.rs\"\n" +" ]\n" +" allow_unsafe = true\n" +"}\n" +"```" -#: src/chromium/interoperability-with-cpp/error-handling.md -msgid "The `E` part of `Result` can be:" -msgstr "`Result` の `E` の部分:" +#: src/chromium/build-rules/depending.md +msgid "Simply add the above target to the `deps` of some Chromium C++ target." +msgstr "" +"上記のターゲットをいくつかの Chromium C++ ターゲットの `deps` に追加するだけ" +"です。" -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/chromium/build-rules/depending.md msgid "" -"Returned as a boolean (e.g. `true` representing success, and `false` " -"representing failure)" +"```gn\n" +"import(\"//build/rust/rust_static_library.gni\")\n" +"\n" +"rust_static_library(\"my_rust_lib\") {\n" +" crate_root = \"lib.rs\"\n" +" sources = [ \"lib.rs\" ]\n" +"}\n" +"\n" +"# or source_set, static_library etc.\n" +"component(\"preexisting_cpp\") {\n" +" deps = [ \":my_rust_lib\" ]\n" +"}\n" +"```" msgstr "" -"ブール値として返すことができます（たとえば、`true` は成功、`false` は失敗を表" -"します）。" +"```gn\n" +"import(\"//build/rust/rust_static_library.gni\")\n" +"\n" +"rust_static_library(\"my_rust_lib\") {\n" +" crate_root = \"lib.rs\"\n" +" sources = [ \"lib.rs\" ]\n" +"}\n" +"\n" +"# または source_set、static_library など\n" +"component(\"preexisting_cpp\") {\n" +" deps = [ \":my_rust_lib\" ]\n" +"}\n" +"```" -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/chromium/build-rules/vscode.md msgid "" -"Preserving error details is in theory possible, but so far hasn't been " -"needed in practice." +"Types are elided in Rust code, which makes a good IDE even more useful than " +"for C++. Visual Studio code works well for Rust in Chromium. To use it," msgstr "" -"理論上はエラーの詳細を保持できますが、これまでは実際に必要になることはありま" -"せんでした。" - -#: src/chromium/interoperability-with-cpp/error-handling-qr.md -#, fuzzy -msgid "CXX Error Handling: QR Example" -msgstr "エラー処理" +"Rust コードでは型が省略されているため、優れた IDE は C++ の場合よりもさらに有" +"用です。Visual Studio Code は Chromium の Rust で適切に機能します。Visual " +"Studio Code を使用するにあたり、以下の点を確認してください。" -#: src/chromium/interoperability-with-cpp/error-handling-qr.md +#: src/chromium/build-rules/vscode.md msgid "" -"The QR code generator is [an example](https://source.chromium.org/chromium/" -"chromium/src/+/main:components/qr_code_generator/qr_code_generator_ffi_glue." -"rs;l=13-18;drc=7bf1b75b910ca430501b9c6a74c1d18a0223ecca) where a boolean is " -"used to communicate success vs failure, and where the successful result can " -"be passed across the FFI boundary:" +"Ensure your VSCode has the `rust-analyzer` extension, not earlier forms of " +"Rust support" msgstr "" -"QR コード生成ツールは、ブール値が成功または失敗を伝達し、成功の結果を FFI の" -"境界を超えて受け渡すことができる [一例](https://source.chromium.org/chromium/" -"chromium/src/+/main:components/qr_code_generator/qr_code_generator_ffi_glue." -"rs;l=13-18;drc=7bf1b75b910ca430501b9c6a74c1d18a0223ecca) です。" - -#: src/chromium/interoperability-with-cpp/error-handling-qr.md -msgid "\"qr_code_generator\"" -msgstr "\"qr_code_generator\"" +"VSCode に、以前の形式の Rust サポートではなく、`rust-analyzer` 拡張機能がある" +"ことを確認" -#: src/chromium/interoperability-with-cpp/error-handling-qr.md +#: src/chromium/build-rules/vscode.md msgid "" -"Students may be curious about the semantics of the `out_qr_size` output. " -"This is not the size of the vector, but the size of the QR code (and " -"admittedly it is a bit redundant - this is the square root of the size of " -"the vector)." +"`gn gen out/Debug --export-rust-project` (or equivalent for your output " +"directory)" msgstr "" -"受講者は `out_qr_size` 出力のセマンティクスに関心を持っている可能性がありま" -"す。これはベクターのサイズではなく、QR コードのサイズです（つまり、この情報は" -"冗長であり、ベクターのサイズの平方根に相当します）。" +"`gn gen out/Debug --export-rust-project`（またはあなたのプロジェクトにおける" +"同様の出力ディレクトリ）" -#: src/chromium/interoperability-with-cpp/error-handling-qr.md +#: src/chromium/build-rules/vscode.md +msgid "`ln -s out/Debug/rust-project.json rust-project.json`" +msgstr "`ln -s out/Debug/rust-project.json rust-project.json`" + +#: src/chromium/build-rules/vscode.md msgid "" -"It may be worth pointing out the importance of initializing `out_qr_size` " -"before calling into the Rust function. Creation of a Rust reference that " -"points to uninitialized memory results in Undefined Behavior (unlike in C++, " -"when only the act of dereferencing such memory results in UB)." +"A demo of some of the code annotation and exploration features of rust-" +"analyzer might be beneficial if the audience are naturally skeptical of IDEs." msgstr "" -"Rust 関数を呼び出す前に `out_qr_size` を初期化することの重要性を説明しましょ" -"う。初期化されていないメモリを指す Rust 参照を作成すると、未定義の動作となり" -"ます（そのようなメモリを逆参照する操作のみが UB になるC++ とは異なります）。" +"IDE に懐疑的な受講者に対しては、rust-analyzer のコード アノテーションと探索機" +"能のデモを行うと良いかもしれません。" -#: src/chromium/interoperability-with-cpp/error-handling-qr.md +#: src/chromium/build-rules/vscode.md msgid "" -"If students ask about `Pin`, then explain why CXX needs it for mutable " -"references to C++ data: the answer is that C++ data can’t be moved around " -"like Rust data, because it may contain self-referential pointers." +"The following steps may help with the demo (but feel free to instead use a " +"piece of Chromium-related Rust that you are most familiar with):" msgstr "" -"`Pin` について受講者から尋ねられた場合は、CXX が C++ データへの可変参照のため" -"に `Pin` を必要とする理由を説明します。つまり、C++ のデータには自己参照ポイン" -"タが含まれている可能性があるため、Rust のデータのように移動することができませ" -"ん。" +"以下の手順に沿ってデモを行うことをおすすめします（代わりに自分が最も精通して" +"いる Chromium 関連の Rustコードを使用しても構いません）。" -#: src/chromium/interoperability-with-cpp/error-handling-png.md -#, fuzzy -msgid "CXX Error Handling: PNG Example" -msgstr "エラー処理" +#: src/chromium/build-rules/vscode.md +msgid "Open `components/qr_code_generator/qr_code_generator_ffi_glue.rs`" +msgstr "" +"`components/qr_code_generator/qr_code_generator_ffi_glue.rs` を開きます。" -#: src/chromium/interoperability-with-cpp/error-handling-png.md +#: src/chromium/build-rules/vscode.md msgid "" -"A prototype of a PNG decoder illustrates what can be done when the " -"successful result cannot be passed across the FFI boundary:" +"Place the cursor over the `QrCode::new` call (around line 26) in " +"\\`qr_code_generator_ffi_glue.rs" msgstr "" -"PNG デコーダのプロトタイプは、成功した結果を FFI の境界を越えて渡せない場合に" -"何ができるかを示しています。" - -#: src/chromium/interoperability-with-cpp/error-handling-png.md -msgid "\"gfx::rust_bindings\"" -msgstr "\"gfx::rust_bindings\"" +"\\`qr_code_generator_ffi_glue.rs の `QrCode::new` 呼び出し（26 行目付近）に" +"カーソルを合わせます。" -#: src/chromium/interoperability-with-cpp/error-handling-png.md +#: src/chromium/build-rules/vscode.md msgid "" -"/// This returns an FFI-friendly equivalent of `Result,\n" -" /// ()>`.\n" +"Demo **show documentation** (typical bindings: vscode = ctrl k i; vim/CoC = " +"K)." msgstr "" -"/// これは `Result,()>` と同等の FFI 対応の結果を\n" -" /// 返します。\n" +"**show documentation** のデモを行います（一般的なバインディング: vscode = " +"ctrl ki、vim/CoC = K）。" -#: src/chromium/interoperability-with-cpp/error-handling-png.md -msgid "/// C++ bindings for the `crate::png::ResultOfPngReader` type.\n" -msgstr "/// `crate::png::ResultOfPngReader` 型の C++ バインディング\n" - -#: src/chromium/interoperability-with-cpp/error-handling-png.md -msgid "/// C++ bindings for the `crate::png::PngReader` type.\n" -msgstr "/// `crate::png::PngReader` 型の C++ バインディング\n" - -#: src/chromium/interoperability-with-cpp/error-handling-png.md +#: src/chromium/build-rules/vscode.md msgid "" -"`PngReader` and `ResultOfPngReader` are Rust types --- objects of these " -"types cannot cross the FFI boundary without indirection of a `Box`. We " -"can't have an `out_parameter: &mut PngReader`, because CXX doesn't allow C++ " -"to store Rust objects by value." +"Demo **go to definition** (typical bindings: vscode = F12; vim/CoC = g d). " +"(This will take you to `//third_party/rust/.../qr_code-.../src/lib.rs`.)" msgstr "" -"`PngReader` と `ResultOfPngReader`は Rust 型です。これらの型のオブジェクト" -"は、`Box` を介さずに FFI 境界を越えることはできません。CXX では Rust オブ" -"ジェクトを値で格納できないため、`out_parameter: &mut PngReader` と書くことは" -"できません。" +"**go to definition** のデモを行います（一般的なバインディング: vscode = F12、" +"vim/CoC = g d）（これにより、`//third_party/rust/.../qr_code-.../src/lib.rs` " +"に移動します）。" -#: src/chromium/interoperability-with-cpp/error-handling-png.md +#: src/chromium/build-rules/vscode.md msgid "" -"This example illustrates that even though CXX doesn't support arbitrary " -"generics nor templates, we can still pass them across the FFI boundary by " -"manually specializing / monomorphizing them into a non-generic type. In the " -"example `ResultOfPngReader` is a non-generic type that forwards into " -"appropriate methods of `Result` (e.g. into `is_err`, `unwrap`, and/or " -"`as_mut`)." +"Demo **outline** and navigate to the `QrCode::with_bits` method (around line " +"164; the outline is in the file explorer pane in vscode; typical vim/CoC " +"bindings = space o)" msgstr "" -"この例は、CXX が任意のジェネリクスやテンプレートをサポートしていなくても、手" -"動で非ジェネリック型に特化 / 単相化することで、FFI 境界を越えて渡せることを示" -"しています。この例では、`ResultOfPngReader` は`Result` の適切なメソッド" -"（`is_err`、`unwrap`、`as_mut` など）に渡される非ジェネリック型です。" - -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md -msgid "Using cxx in Chromium" -msgstr "Chromium で cxx を使用する" +"**outline** のデモを行い、`QrCode::with_bits` メソッドに移動します（164 行目" +"付近。アウトラインは VSCode のファイル エクスプローラ ペインにあります。一般" +"的な vim/CoC バインディング = space o）。" -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +#: src/chromium/build-rules/vscode.md +#, fuzzy msgid "" -"In Chromium, we define an independent `#[cxx::bridge] mod` for each leaf-" -"node where we want to use Rust. You'd typically have one for each " -"`rust_static_library`. Just add" +"Demo **type annotations** (there are quite a few nice examples in the " +"`QrCode::with_bits` method)" msgstr "" -"Chromium では、Rust を使用するリーフノードごとに独立した `#[cxx::bridge] " -"mod` を定義します。通常は、`rust_static_library` ごとに 1 つずつになります。" +"**type annotations**のデモを行います（`QrCode::with_bits` メソッドにいくつか" +"の適切な例があります）。" -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +#: src/chromium/build-rules/vscode.md msgid "" -"```gn\n" -"cxx_bindings = [ \"my_rust_file.rs\" ]\n" -" # list of files containing #[cxx::bridge], not all source files\n" -"allow_unsafe = true\n" -"```" +"It may be worth pointing out that `gn gen ... --export-rust-project` will " +"need to be rerun after editing `BUILD.gn` files (which we will do a few " +"times throughout the exercises in this session)." msgstr "" -"```gn\n" -"cxx_bindings = [ \"my_rust_file.rs\" ]\n" -" # すべてのソースファイルではなく、#[cxx::bridge] を含むファイルのリスト\n" -"allow_unsafe = true\n" -"```" +"`BUILD.gn` ファイルの編集後は `gn gen ... --export-rust-project` を再実行する" +"必要があることを説明してください（このセッションの演習全体で数回行います）。" -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md -msgid "" -"to your existing `rust_static_library` target alongside `crate_root` and " -"`sources`." -msgstr "" -"上記のコードを、`crate_root` や `sources`と並んで、既存の " -"`rust_static_library` ターゲットに追加するだけです。" +#: src/exercises/chromium/build-rules.md +#, fuzzy +msgid "Build rules exercise" +msgstr "ビルドのルールに関する演習" -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md -msgid "C++ headers will be generated at a sensible location, so you can just" +#: src/exercises/chromium/build-rules.md +msgid "" +"In your Chromium build, add a new Rust target to `//ui/base/BUILD.gn` " +"containing:" msgstr "" -"C++ ヘッダーは適切な場所で生成されるため、次のようにインクルードできます。" - -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md -msgid "\"ui/base/my_rust_file.rs.h\"" -msgstr "\"ui/base/my_rust_file.rs.h\"" +"Chromium のビルドで、以下を含む新しい Rust ターゲットを `//ui/base/BUILD.gn` " +"に追加します。" -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +#: src/exercises/chromium/build-rules.md +#, fuzzy msgid "" -"You will find some utility functions in `//base` to convert to/from Chromium " -"C++ types to CXX Rust types --- for example [`SpanToRustSlice`](https://" -"source.chromium.org/chromium/chromium/src/+/main:base/containers/span_rust.h;" -"l=21)." +"**Important**: note that `no_mangle` here is considered a type of unsafety " +"by the Rust compiler, so you'll need to allow unsafe code in your `gn` " +"target." msgstr "" -"`//base` には、Chromium C++ 型から CXX Rust 型（およびその逆方向）への変換を" -"行うためのユーティリティ関数がいくつかあります（例: [`SpanToRustSlice`]" -"(https://source.chromium.org/chromium/chromium/src/+/main:base/containers/" -"span_rust.h;l=21)）。" +"**重要**: ここでの `no_mangle` は Rust コンパイラでは安全でない型とみなされる" +"ため、`gn` ターゲットで安全でないコードを許可する必要があります。" -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md -msgid "Students may ask --- why do we still need `allow_unsafe = true`?" +#: src/exercises/chromium/build-rules.md +msgid "" +"Add this new Rust target as a dependency of `//ui/base:base`. Declare this " +"function at the top of `ui/base/resource/resource_bundle.cc` (later, we'll " +"see how this can be automated by bindings generation tools):" msgstr "" -"受講者から、`allow_unsafe = true` がなぜここでも必要なのかを尋ねられる可能性" -"があります。" +"この新しい Rust ターゲットを `//ui/base:base` の依存関係として追加します。こ" +"の関数を `ui/base/resource/resource_bundle.cc` の先頭で宣言します（後ほど、バ" +"インディング生成ツールでこれを自動化する方法を説明します）。" -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +#: src/exercises/chromium/build-rules.md msgid "" -"The broad answer is that no C/C++ code is \"safe\" by the normal Rust " -"standards. Calling back and forth to C/C++ from Rust may do arbitrary things " -"to memory, and compromise the safety of Rust's own data layouts. Presence of " -"_too many_ `unsafe` keywords in C/C++ interop can harm the signal-to-noise " -"ratio of such a keyword, and is [controversial](https://steveklabnik.com/" -"writing/the-cxx-debate), but strictly, bringing any foreign code into a Rust " -"binary can cause unexpected behavior from Rust's perspective." +"Call this function from somewhere in `ui/base/resource/resource_bundle.cc` - " +"we suggest the top of `ResourceBundle::MaybeMangleLocalizedString`. Build " +"and run Chromium, and ensure that \"Hello from Rust!\" is printed lots of " +"times." msgstr "" -"大まかに答えると、C/C++ コードは通常の Rust 標準では「安全」ではありません。" -"Rust から C/C++ に行ったり来たりすると、メモリに対して任意の処理が行われ、" -"Rust 独自のデータ レイアウトの安全性が損なわれる可能性があります。C/C++ の相" -"互運用で `unsafe` キーワードが多すぎると、`unsafe`に対する注目度が薄れるの" -"で、これには [賛否両論があります](https://steveklabnik.com/writing/the-cxx-" -"debate)。ただし厳密には、外部コードを Rust バイナリに取り込むと、Rust の観点" -"からは想定していない動作が発生する可能性があります。" +"この関数を `ui/base/resource/resource_bundle.cc` 内のどこかから呼び出します。" +"おすすめは`ResourceBundle::MaybeMangleLocalizedString` の先頭から呼び出すこと" +"です。Chromium をビルドして実行し、\"Hello from Rust!\" が何度も出力されてい" +"ることを確認します。" -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +#: src/exercises/chromium/build-rules.md msgid "" -"The narrow answer lies in the diagram at the top of [this page](../" -"interoperability-with-cpp.md) --- behind the scenes, CXX generates Rust " -"`unsafe` and `extern \"C\"` functions just like we did manually in the " -"previous section." +"If you use VSCode, now set up Rust to work well in VSCode. It will be useful " +"in subsequent exercises. If you've succeeded, you will be able to use right-" +"click \"Go to definition\" on `println!`." msgstr "" -"具体的な答えは、[このページ](../interoperability-with-cpp.md) の上部の図にあ" -"ります。裏では、CXX は Rust の `unsafe` 関数と `extern \"C\"` 関数を生成しま" -"す。これは前のセクションで手動で行ったのとまったく同じです。" - -#: src/exercises/chromium/interoperability-with-cpp.md -#, fuzzy -msgid "Exercise: Interoperability with C++" -msgstr "演習: C++との相互運用性" +"VSCode を使用している場合は、VSCode で適切に動作するように Rust を設定しま" +"す。これは、後続の演習で役立ちます。設定が完了したら、`println!` で \"Go to " +"definition\" を右クリックで利用できるようになります。" +#: src/exercises/chromium/build-rules.md #: src/exercises/chromium/interoperability-with-cpp.md -msgid "Part one" -msgstr "パート 1" +msgid "Where to find help" +msgstr "参考情報" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/exercises/chromium/build-rules.md msgid "" -"In the Rust file you previously created, add a `#[cxx::bridge]` which " -"specifies a single function, to be called from C++, called " -"`hello_from_rust`, taking no parameters and returning no value." +"The options available to the [`rust_static_library` gn template](https://" +"source.chromium.org/chromium/chromium/src/+/main:build/rust/" +"rust_static_library.gni;l=16)" msgstr "" -"先ほど作成した Rust ファイルに、C++ から呼び出す単一の関数を示す `#[cxx::" -"bridge]` を追加します。これは `hello_from_rust` という関数で、パラメータを受" -"け取らず、値も返しません。" +"[`rust_static_library` gn テンプレート](https://source.chromium.org/chromium/" +"chromium/src/+/main:build/rust/rust_static_library.gni;l=16) で使用できるオプ" +"ション" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/exercises/chromium/build-rules.md msgid "" -"Modify your previous `hello_from_rust` function to remove `extern \"C\"` and " -"`#[no_mangle]`. This is now just a standard Rust function." +"Information about [`#[no_mangle]`](https://doc.rust-lang.org/beta/reference/" +"abi.html#the-no_mangle-attribute)" msgstr "" -"前の `hello_from_rust` 関数を変更して `extern \"C\"` と `#[no_mangle]` を削除" -"します。これで標準の Rust 関数になります。" - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Modify your `gn` target to build these bindings." -msgstr "`gn` ターゲットを変更して、これらのバインディングをビルドします。" +"[`#[no_mangle]`](https://doc.rust-lang.org/beta/reference/abi.html#the-" +"no_mangle-attribute) に関する情報" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/exercises/chromium/build-rules.md msgid "" -"In your C++ code, remove the forward-declaration of `hello_from_rust`. " -"Instead, include the generated header file." +"Information about [`extern \"C\"`](https://doc.rust-lang.org/std/keyword." +"extern.html)" msgstr "" -"C++ コードで、`hello_from_rust` の前方宣言を削除し、代わりに生成されたヘッ" -"ダー ファイルをインクルードします。" - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Build and run!" -msgstr "ビルドして実行します。" - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Part two" -msgstr "パート 2" +"[`extern \"C\"`](https://doc.rust-lang.org/std/keyword.extern.html) に関する" +"情報" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/exercises/chromium/build-rules.md msgid "" -"It's a good idea to play with CXX a little. It helps you think about how " -"flexible Rust in Chromium actually is." +"Information about gn's [`--export-rust-project`](https://gn.googlesource.com/" +"gn/+/main/docs/reference.md#compilation-database) switch" msgstr "" -"CXX を少し使ってみて、Chromium における Rust の柔軟性について理解を深めましょ" -"う。" - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Some things to try:" -msgstr "以下を試してください。" - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Call back into C++ from Rust. You will need:" -msgstr "Rust から C++ を呼び出します。これには以下が必要です。" +"gn の [`--export-rust-project`](https://gn.googlesource.com/gn/+/main/docs/" +"reference.md#compilation-database) スイッチに関する情報" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/exercises/chromium/build-rules.md msgid "" -"An additional header file which you can `include!` from your `cxx::bridge`. " -"You'll need to declare your C++ function in that new header file." +"[How to install rust-analyzer in VSCode](https://code.visualstudio.com/docs/" +"languages/rust)" msgstr "" -"`cxx::bridge` から `include!` できる追加のヘッダー ファイル。その新しいヘッ" -"ダー ファイルで C++ 関数を宣言する必要があります。" +"[VSCode に rust-analyzer をインストールする方法](https://code.visualstudio." +"com/docs/languages/rust)" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/exercises/chromium/build-rules.md msgid "" -"An `unsafe` block to call such a function, or alternatively specify the " -"`unsafe` keyword in your `#[cxx::bridge]` [as described here](https://cxx.rs/" -"extern-c++.html#functions-and-member-functions)." +"This example is unusual because it boils down to the lowest-common-" +"denominator interop language, C. Both C++ and Rust can natively declare and " +"call C ABI functions. Later in the course, we'll connect C++ directly to " +"Rust." msgstr "" -"このような関数を呼び出す `unsafe` ブロック。または [こちら](https://cxx.rs/" -"extern-c++.html#functions-and-member-functions) に記載されているとおり、" -"`#[cxx::bridge]` 内で `unsafe` キーワードを指定する必要があります。" +"この例は、共通の相互運用言語である C に集約されているため、一般的ではありませ" +"ん。C++ と Rust はどちらも、C ABI 関数をネイティブに宣言して呼び出すことがで" +"きます。コースの後半で、C++ を Rust に直接接続します。" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/exercises/chromium/build-rules.md msgid "" -"You may also need to `#include \"third_party/rust/cxx/v1/crate/include/cxx." -"h\"`" +"`allow_unsafe = true` is required here because `#[no_mangle]` might allow " +"Rust to generate two functions with the same name, and Rust can no longer " +"guarantee that the right one is called." msgstr "" -"`#include \"third_party/rust/cxx/v1/crate/include/cxx.h\"` も必要になるかもし" -"れません。" - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Pass a C++ string from C++ into Rust." -msgstr "C++ から Rust に C++ 文字列を渡します。" - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Pass a reference to a C++ object into Rust." -msgstr "C++ オブジェクトへの参照を Rust に渡します。" +"ここで `allow_unsafe = true` は必須です。`#[no_mangle]` により、Rust は同じ名" +"前の関数を2つ生成するようになり、Rust は正しい関数が呼び出されることを保証で" +"きなくなるためです。" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/exercises/chromium/build-rules.md msgid "" -"Intentionally get the Rust function signatures mismatched from the `#[cxx::" -"bridge]`, and get used to the errors you see." +"If you need a pure Rust executable, you can also do that using the " +"`rust_executable` gn template." msgstr "" -"意図的に`#[cxx::bridge]`と一致しないようにRust 関数のシグネチャを変更し、表示" -"されるエラーに慣れるようにします。" +"純粋な Rust 実行可能ファイルが必要な場合は、`rust_executable` gn テンプレート" +"を使用して行うこともできます。" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing.md msgid "" -"Intentionally get the C++ function signatures mismatched from the `#[cxx::" -"bridge]`, and get used to the errors you see." +"Rust community typically authors unit tests in a module placed in the same " +"source file as the code being tested. This was covered [earlier](../testing." +"md) in the course and looks like this:" msgstr "" -"意図的に`#[cxx::bridge]`と一致しないようにC++ 関数のシグネチャを変更し、表示" -"されるエラーに慣れるようにします。" +"Rust コミュニティは通常、テスト対象のコードと同じソースファイルに配置されたモ" +"ジュールで単体テストを作成します。これは本コースの [前の部分](../testing.md) " +"で説明しており、以下のようになります。" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing.md msgid "" -"Pass a `std::unique_ptr` of some type from C++ into Rust, so that Rust can " -"own some C++ object." +"In Chromium we place unit tests in a separate source file and we continue to " +"follow this practice for Rust --- this makes tests consistently discoverable " +"and helps to avoid rebuilding `.rs` files a second time (in the `test` " +"configuration)." msgstr "" -"なんらかの型の `std::unique_ptr` を C++ から Rust に渡して、Rust がいくつか" -"の C++ オブジェクトを所有できるようにします。" +"Chromium では単体テストを別のソースファイルに配置しており、Rust でもこの方針" +"を継続します。これにより、テストが常に検出可能になり、2 度目に（`test` 構成" +"で）`.rs` ファイルを再ビルドする必要がなくなります。" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing.md msgid "" -"Create a Rust object and pass it into C++, so that C++ owns it. (Hint: you " -"need a `Box`)." +"This results in the following options for testing Rust code in Chromium:" msgstr "" -"Rust オブジェクトを作成して C++ に渡して、C++ がそれを所有できるようにします" -"（ヒント: `Box` が必要です）。" - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Declare some methods on a C++ type. Call them from Rust." -msgstr "C++ 型でいくつかのメソッドを宣言し、Rust から呼び出します。" - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Declare some methods on a Rust type. Call them from C++." -msgstr "Rust 型に対していくつかのメソッドを宣言し、C++ から呼び出します。" +"その結果、Chromium で Rust コードをテストするための次の選択肢が提供されます。" -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Part three" -msgstr "パート 3" +#: src/chromium/testing.md +msgid "" +"Native Rust tests (i.e. `#[test]`). Discouraged outside of `//third_party/" +"rust`." +msgstr "" +"ネイティブ Rust テスト（例: `#[test]`）。`//third_party/rust` 以外では推奨さ" +"れません。" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing.md msgid "" -"Now you understand the strengths and limitations of CXX interop, think of a " -"couple of use-cases for Rust in Chromium where the interface would be " -"sufficiently simple. Sketch how you might define that interface." +"`gtest` tests authored in C++ and exercising Rust via FFI calls. Sufficient " +"when Rust code is just a thin FFI layer and the existing unit tests provide " +"sufficient coverage for the feature." msgstr "" -"CXX の相互運用性の長所と制限事項について理解したところで、インターフェースが" -"非常にシンプルな、Chromium での Rust のユースケースをいくつか考えてみましょ" -"う。このインターフェースをどのように定義すればよいか考えてみましょう。" +"C++ で作成され、FFI 呼び出しを介して Rust を実行する `gtest` テスト。Rust " +"コードが単なる薄いFFI レイヤであり、既存の単体テストで今後この機能が漏れなく" +"カバーされる場合には十分です。" -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "The [`cxx` binding reference](https://cxx.rs/bindings.html)" -msgstr "[`cxx` バインディング リファレンス](https://cxx.rs/bindings.html)" +#: src/chromium/testing.md +msgid "" +"`gtest` tests authored in Rust and using the crate under test through its " +"public API (using `pub mod for_testing { ... }` if needed). This is the " +"subject of the next few slides." +msgstr "" +"Rust で作成され、公開 API を介してテスト対象のクレートを使用する `gtest` テス" +"ト（必要に応じて `pub mod for_testing { ... }` を使用）。これについては、次の" +"数枚のスライドで説明します。" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing.md msgid "" -"The [`rust_static_library` gn template](https://source.chromium.org/chromium/" -"chromium/src/+/main:build/rust/rust_static_library.gni;l=16)" +"Mention that native Rust tests of third-party crates should eventually be " +"exercised by Chromium bots. (Such testing is needed rarely --- only after " +"adding or updating third-party crates.)" msgstr "" -"[`rust_static_library` gn テンプレート](https://source.chromium.org/chromium/" -"chromium/src/+/main:build/rust/rust_static_library.gni;l=16)" +"サードパーティ クレートのネイティブ Rust テストが最終的に Chromium bot によっ" +"て実行される必要があることを説明します（このようなテストが必要になることは" +"めったになく、サードパーティのクレートを追加または更新した後にのみ必要となり" +"ます）。" -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Some of the questions you may encounter:" -msgstr "次のような質問が寄せられる可能性があります。" +#: src/chromium/testing.md +msgid "" +"Some examples may help illustrate when C++ `gtest` vs Rust `gtest` should be " +"used:" +msgstr "" +"C++ の`gtest` と Rust の`gtest` をどのような場合に使うべきか、いくつかの例を" +"使って説明するとよいでしょう。" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing.md msgid "" -"I'm seeing a problem initializing a variable of type X with type Y, where X " -"and Y are both function types. This is because your C++ function doesn't " -"quite match the declaration in your `cxx::bridge`." +"QR has very little functionality in the first-party Rust layer (it's just a " +"thin FFI glue) and therefore uses the existing C++ unit tests for testing " +"both the C++ and the Rust implementation (parameterizing the tests so they " +"enable or disable Rust using a `ScopedFeatureList`)." msgstr "" -"X と Y の両方が関数型である場合に、型 X の変数を型 Y で初期化すると問題が発生" -"します。これは、C++ 関数が `cxx::bridge` 内の宣言と完全に一致しないためです。" +"QR には、ファースト パーティの Rust レイヤの機能はほとんどありません（単なる" +"シン FFI グルーです）。そのため、C++ と Rust の実装の両方をテストするには、既" +"存の C++ 単体テストを使用します（テストをパラメータ化し、`ScopedFeatureList` " +"を使用して Rust を有効化または無効化できるようになっています）。" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing.md msgid "" -"I seem to be able to freely convert C++ references into Rust references. " -"Doesn't that risk UB? For CXX's _opaque_ types, no, because they are zero-" -"sized. For CXX trivial types yes, it's _possible_ to cause UB, although " -"CXX's design makes it quite difficult to craft such an example." +"Hypothetical/WIP PNG integration may need to implement memory-safe " +"implementation of pixel transformations that are provided by `libpng` but " +"missing in the `png` crate - e.g. RGBA => BGRA, or gamma correction. Such " +"functionality may benefit from separate tests authored in Rust." msgstr "" -"C++ 参照を Rust 参照に自由に変換できるようですが、UB のリスクはないでしょう" -"か？CXX の不透明型の場合、サイズがゼロであるため、そのリスクはありません。" -"CXX のトリビアル型では UB が発生する可能性がありますが、CXX の設計上、そのよ" -"うな例を作成するのは非常に困難です。" +"仮定の、または開発中の PNG 統合では、`libpng` では提供されているのに、`png` " +"クレートでは欠落しているピクセル変換（RGBA => BGRA、ガンマ補正など）のメモリ" +"セーフな実装が必要となる場合があります。このような機能の開発においては、別途" +"Rustでテストを作成することが役立つ場合があります。" -#: src/chromium/adding-third-party-crates.md +#: src/chromium/testing/rust-gtest-interop.md msgid "" -"Rust libraries are called \"crates\" and are found at [crates.io](https://" -"crates.io). It's _very easy_ for Rust crates to depend upon one another. So " -"they do!" +"The [`rust_gtest_interop`](https://chromium.googlesource.com/chromium/src/+/" +"main/testing/rust_gtest_interop/README.md) library provides a way to:" msgstr "" -"Rust ライブラリは「クレート」と呼ばれ、[crates.io](https://crates.io) にあり" -"ます。Rust クレートを互いに依存させるのは非常に簡単であり、実際にそのように" -"なっています" +"[`rust_gtest_interop`](https://chromium.googlesource.com/chromium/src/+/main/" +"testing/rust_gtest_interop/README.md) ライブラリを使用すると、次のことができ" +"ます。" -#: src/chromium/adding-third-party-crates.md -#, fuzzy -msgid "C++ library" -msgstr "ライブラリ" +#: src/chromium/testing/rust-gtest-interop.md +msgid "" +"Use a Rust function as a `gtest` testcase (using the `#[gtest(...)]` " +"attribute)" +msgstr "" +"Rust 関数を `gtest` テストケースとして使用する（`#[gtest(...)]` 属性を使" +"用）。" -#: src/chromium/adding-third-party-crates.md -#, fuzzy -msgid "Rust crate" -msgstr "Rustクレート" +#: src/chromium/testing/rust-gtest-interop.md +msgid "" +"Use `expect_eq!` and similar macros (similar to `assert_eq!` but not " +"panicking and not terminating the test when the assertion fails)." +msgstr "" +"`expect_eq!` などのマクロを使用する（`assert_eq!`と似ていますが、アサーション" +"が失敗してもパニックせず、テストを終了しません）。" -#: src/chromium/adding-third-party-crates.md +#: src/chromium/testing/rust-gtest-interop.md #, fuzzy -msgid "Build system" -msgstr "ビルドシステム" - -#: src/chromium/adding-third-party-crates.md -msgid "Lots" -msgstr "多数" - -#: src/chromium/adding-third-party-crates.md -msgid "Consistent: `Cargo.toml`" -msgstr "一貫して `Cargo.toml`" - -#: src/chromium/adding-third-party-crates.md -msgid "Typical library size" -msgstr "一般的なライブラリ サイズ" - -#: src/chromium/adding-third-party-crates.md -msgid "Large-ish" -msgstr "やや大" - -#: src/chromium/adding-third-party-crates.md -msgid "Small" -msgstr "小" - -#: src/chromium/adding-third-party-crates.md -msgid "Transitive dependencies" -msgstr "推移的依存関係" - -#: src/chromium/adding-third-party-crates.md -msgid "Few" -msgstr "少" - -#: src/chromium/adding-third-party-crates.md -msgid "For a Chromium engineer, this has pros and cons:" -msgstr "Chromium のエンジニアにとって、クレートには長所と短所があります。" +msgid "Example:" +msgstr "例" -#: src/chromium/adding-third-party-crates.md +#: src/chromium/testing/build-gn.md msgid "" -"All crates use a common build system so we can automate their inclusion into " -"Chromium..." +"The simplest way to build Rust `gtest` tests is to add them to an existing " +"test binary that already contains tests authored in C++. For example:" msgstr "" -"すべてのクレートが共通のビルドシステムを使用しているため、Chromium への取り込" -"みを自動化できます。" +"Rust の `gtest` テストをビルドする最も簡単な方法は、C++ で作成されたテストが" +"すでに含まれている既存のテストバイナリに追加することです。次に例を示します。" -#: src/chromium/adding-third-party-crates.md +#: src/chromium/testing/build-gn.md msgid "" -"... but, crates typically have transitive dependencies, so you will likely " -"have to bring in multiple libraries." -msgstr "" -"しかし、クレートには通常、推移的依存関係があるため、複数のライブラリを取り込" -"むことが必要になる可能性があります。" - -#: src/chromium/adding-third-party-crates.md -msgid "We'll discuss:" -msgstr "議論する内容は次のとおりです。" - -#: src/chromium/adding-third-party-crates.md -msgid "How to put a crate in the Chromium source code tree" -msgstr "Chromium ソースコード ツリーにクレートを配置する方法" - -#: src/chromium/adding-third-party-crates.md -msgid "How to make `gn` build rules for it" -msgstr "クレート用の `gn` ビルドルールを作成する方法" - -#: src/chromium/adding-third-party-crates.md -msgid "How to audit its source code for sufficient safety." -msgstr "クレートのソースコードの十分な安全性を監査する方法。" - -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md -msgid "Configuring the `Cargo.toml` file to add crates" -msgstr " `Cargo.toml` ファイルによりクレートを追加する方法" - -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md -msgid "" -"Chromium has a single set of centrally-managed direct crate dependencies. " -"These are managed through a single [`Cargo.toml`](https://source.chromium." -"org/chromium/chromium/src/+/main:third_party/rust/chromium_crates_io/Cargo." -"toml):" -msgstr "" -"Chromium には、一元管理される直接的なクレート依存関係が 1 セットあります。こ" -"れらは単一の [`Cargo.toml`](https://source.chromium.org/chromium/chromium/" -"src/+/main:third_party/rust/chromium_crates_io/Cargo.toml) で管理されます。" - -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md -msgid "" -"```toml\n" -"[dependencies]\n" -"bitflags = \"1\"\n" -"cfg-if = \"1\"\n" -"cxx = \"1\"\n" -"# lots more...\n" +"```gn\n" +"test(\"ui_base_unittests\") {\n" +" ...\n" +" sources += [ \"my_rust_lib_unittest.rs\" ]\n" +" deps += [ \":my_rust_lib\" ]\n" +"}\n" "```" msgstr "" -"```toml\n" -"[dependencies]\n" -"bitflags = \"1\"\n" -"cfg-if = \"1\"\n" -"cxx = \"1\"\n" -"# lots more...\n" +"```gn\n" +"test(\"ui_base_unittests\") {\n" +" ...\n" +" sources += [ \"my_rust_lib_unittest.rs\" ]\n" +" deps += [ \":my_rust_lib\" ]\n" +"}\n" "```" -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md +#: src/chromium/testing/build-gn.md msgid "" -"As with any other `Cargo.toml`, you can specify [more details about the " -"dependencies](https://doc.rust-lang.org/cargo/reference/specifying-" -"dependencies.html) --- most commonly, you'll want to specify the `features` " -"that you wish to enable in the crate." +"Authoring Rust tests in a separate `static_library` also works, but requires " +"manually declaring the dependency on the support libraries:" msgstr "" -"他の `Cargo.toml` と同様に、[依存関係の詳細](https://doc.rust-lang.org/cargo/" -"reference/specifying-dependencies.html) を指定できます。通常は、クレートで有" -"効にする `features` を指定します。" +"別途、`static_library` で Rust テストを作成することも可能ですが、サポート ラ" +"イブラリへの依存関係を手動で宣言する必要があります。" -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md +#: src/chromium/testing/build-gn.md msgid "" -"When adding a crate to Chromium, you'll often need to provide some extra " -"information in an additional file, `gnrt_config.toml`, which we'll meet next." +"```gn\n" +"rust_static_library(\"my_rust_lib_unittests\") {\n" +" testonly = true\n" +" is_gtest_unittests = true\n" +" crate_root = \"my_rust_lib_unittest.rs\"\n" +" sources = [ \"my_rust_lib_unittest.rs\" ]\n" +" deps = [\n" +" \":my_rust_lib\",\n" +" \"//testing/rust_gtest_interop\",\n" +" ]\n" +"}\n" +"\n" +"test(\"ui_base_unittests\") {\n" +" ...\n" +" deps += [ \":my_rust_lib_unittests\" ]\n" +"}\n" +"```" msgstr "" -"Chromium にクレートを追加する際は、多くの場合、 `gnrt_config.toml`という追加" -"ファイルに情報を指定する必要があります。これについては後で説明します。" +"```gn\n" +"rust_static_library(\"my_rust_lib_unittests\") {\n" +" testonly = true\n" +" is_gtest_unittests = true\n" +" crate_root = \"my_rust_lib_unittest.rs\"\n" +" sources = [ \"my_rust_lib_unittest.rs\" ]\n" +" deps = [\n" +" \":my_rust_lib\",\n" +" \"//testing/rust_gtest_interop\",\n" +" ]\n" +"}\n" +"\n" +"test(\"ui_base_unittests\") {\n" +" ...\n" +" deps += [ \":my_rust_lib_unittests\" ]\n" +"}\n" +"```" -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md +#: src/chromium/testing/chromium-import-macro.md msgid "" -"Alongside `Cargo.toml` is [`gnrt_config.toml`](https://source.chromium.org/" -"chromium/chromium/src/+/main:third_party/rust/chromium_crates_io/gnrt_config." -"toml). This contains Chromium-specific extensions to crate handling." +"After adding `:my_rust_lib` to GN `deps`, we still need to learn how to " +"import and use `my_rust_lib` from `my_rust_lib_unittest.rs`. We haven't " +"provided an explicit `crate_name` for `my_rust_lib` so its crate name is " +"computed based on the full target path and name. Fortunately we can avoid " +"working with such an unwieldy name by using the `chromium::import!` macro " +"from the automatically-imported `chromium` crate:" msgstr "" -"`Cargo.toml` のほかに、[`gnrt_config.toml`](https://source.chromium.org/" -"chromium/chromium/src/+/main:third_party/rust/chromium_crates_io/gnrt_config." -"toml) があります。これには、クレートを扱うための Chromium 固有の拡張機能が含" -"まれています。" +"GN の `deps` に `:my_rust_lib` を追加した後も、`my_rust_lib_unittest.rs` か" +"ら `my_rust_lib` をインポートして使用する方法について学ぶ必要があります。" +"`my_rust_lib` には明示的な `crate_name` が指定されていないため、クレート名は" +"ターゲットのフルパスと名前に基づいて生成されます。幸い、自動的にインポートさ" +"れる `chromium` クレートから `chromium::import!` マクロを使用すれば、このよう" +"な扱いにくい名前の使用を回避できます。" -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md -msgid "" -"If you add a new crate, you should specify at least the `group`. This is one " -"of:" -msgstr "" -"新しいクレートを追加する場合は、少なくとも次のいずれかの `group` を指定する必" -"要があります。" +#: src/chromium/testing/chromium-import-macro.md +msgid "\"//ui/base:my_rust_lib\"" +msgstr "\"//ui/base:my_rust_lib\"" -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md -msgid "For instance," -msgstr "次に例を示します。" +#: src/chromium/testing/chromium-import-macro.md +msgid "Under the covers the macro expands to something similar to:" +msgstr "内部で、マクロは次のように展開されます。" -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md +#: src/chromium/testing/chromium-import-macro.md msgid "" -"Depending on the crate source code layout, you may also need to use this " -"file to specify where its `LICENSE` file(s) can be found." +"More information can be found in [the doc comment](https://source.chromium." +"org/chromium/chromium/src/+/main:build/rust/chromium_prelude/" +"chromium_prelude.rs?q=f:chromium_prelude.rs%20pub.use.*%5Cbimport%5Cb;%20-f:" +"third_party&ss=chromium%2Fchromium%2Fsrc) of the `chromium::import` macro." msgstr "" -"クレートのソースコードのレイアウトによっては、このファイルを使用して " -"`LICENSE` ファイルを見つける場所も指定する必要があります。" +"詳しくは、`chromium::import` マクロの [ドキュメント コメント](https://source." +"chromium.org/chromium/chromium/src/+/main:build/rust/chromium_prelude/" +"chromium_prelude.rs?q=f:chromium_prelude.rs%20pub.use.*%5Cbimport%5Cb;%20-f:" +"third_party&ss=chromium%2Fchromium%2Fsrc) をご覧ください。" -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md +#: src/chromium/testing/chromium-import-macro.md msgid "" -"Later, we'll see some other things you will need to configure in this file " -"to resolve problems." +"`rust_static_library` supports specifying an explicit name via `crate_name` " +"property, but doing this is discouraged. And it is discouraged because the " +"crate name has to be globally unique. crates.io guarantees uniqueness of its " +"crate names so `cargo_crate` GN targets (generated by the `gnrt` tool " +"covered in a later section) use short crate names." msgstr "" -"後ほど、いくつかの問題を解決するためにこのファイルに指定する必要がある設定に" -"ついて取り扱います。" +"`rust_static_library` は、`crate_name` プロパティによる明示的な名前の指定をサ" +"ポートしていますが、クレート名はグローバルに一意である必要があるため、これは" +"推奨されません。crates.io はクレート名の一意性を保証しているため、" +"`cargo_crate` GN ターゲット（後述の `gnrt` ツールで生成）は短いクレート名を使" +"用します。" -#: src/chromium/adding-third-party-crates/downloading-crates.md -msgid "" -"A tool called `gnrt` knows how to download crates and how to generate `BUILD." -"gn` rules." -msgstr "" -"`gnrt` というツールは、クレートのダウンロード方法と `BUILD.gn` ルールの生成方" -"法を把握しています。" +#: src/exercises/chromium/testing.md +#, fuzzy +msgid "Testing exercise" +msgstr "練習問題" -#: src/chromium/adding-third-party-crates/downloading-crates.md -msgid "To start, download the crate you want like this:" -msgstr "まず、必要なクレートを次のようにダウンロードします。" +#: src/exercises/chromium/testing.md +msgid "Time for another exercise!" +msgstr "新たな演習の時間です！" -#: src/chromium/adding-third-party-crates/downloading-crates.md +#: src/exercises/chromium/testing.md +msgid "In your Chromium build:" +msgstr "Chromium ビルドで以下を行ってください。" + +#: src/exercises/chromium/testing.md msgid "" -"Although the `gnrt` tool is part of the Chromium source code, by running " -"this command you will be downloading and running its dependencies from " -"`crates.io`. See [the earlier section](../cargo.md) discussing this security " -"decision." +"Add a testable function next to `hello_from_rust`. Some suggestions: adding " +"two integers received as arguments, computing the nth Fibonacci number, " +"summing integers in a slice, etc." msgstr "" -"`gnrt` ツールは Chromium のソースコードの一部ですが、このコマンドを実行する" -"と、`crates.io` から依存関係をダウンロードして実行します。これに関するセキュ" -"リティ上の決定については、[前のセクション](../cargo.md) をご覧ください。" +"`hello_from_rust` の横にテスト可能な関数を追加します。たとえば、引数として受" +"け取った 2 つの整数を追加する、n 番目のフィボナッチ数を計算する、スライス内の" +"整数を合計する、などが考えられます。" -#: src/chromium/adding-third-party-crates/downloading-crates.md -msgid "This `vendor` command may download:" -msgstr "この `vendor` コマンドにより、以下がダウンロードされる場合があります。" +#: src/exercises/chromium/testing.md +msgid "Add a separate `..._unittest.rs` file with a test for the new function." +msgstr "" +"新しい関数のテストを含む別個の `..._unittest.rs` ファイルを追加します。" -#: src/chromium/adding-third-party-crates/downloading-crates.md -#, fuzzy -msgid "Your crate" -msgstr "あなたのクレート" +#: src/exercises/chromium/testing.md +msgid "Add the new tests to `BUILD.gn`." +msgstr "新しいテストを `BUILD.gn` に追加します。" -#: src/chromium/adding-third-party-crates/downloading-crates.md -msgid "Direct and transitive dependencies" -msgstr "直接的および推移的依存関係" +#: src/exercises/chromium/testing.md +msgid "Build the tests, run them, and verify that the new test works." +msgstr "テストをビルドして実行し、新しいテストが機能することを確認します。" -#: src/chromium/adding-third-party-crates/downloading-crates.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"New versions of other crates, as required by `cargo` to resolve the complete " -"set of crates required by Chromium." +"The Rust community offers multiple options for C++/Rust interop, with new " +"tools being developed all the time. At the moment, Chromium uses a tool " +"called CXX." msgstr "" -" `cargo` によって指示される、Chromium で必要となるクレートの完全セットを得る" -"ための他のクレートの新しいバージョン。" +"Rust コミュニティには C++ と Rust の相互運用のためのオプションが複数用意され" +"ており、絶えず新しいツールが開発されています。現在のところ、Chromium では " +"CXX というツールを使用しています。" -#: src/chromium/adding-third-party-crates/downloading-crates.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"Chromium maintains patches for some crates, kept in `//third_party/rust/" -"chromium_crates_io/patches`. These will be reapplied automatically, but if " -"patching fails you may need to take manual action." +"You describe your whole language boundary in an interface definition " +"language (which looks a lot like Rust) and then CXX tools generate " +"declarations for functions and types in both Rust and C++." msgstr "" -"Chromium では、一部のクレートに対するパッチが `//third_party/rust/" -"chromium_crates_io/patches` に保存されています。これらは自動的に再適用されま" -"すが、パッチ適用が失敗した場合は、手動による解決が必要になる場合があります。" +"言語境界全体をインターフェース定義言語（Rust によく似ています）で記述すると、" +"CXX ツールが Rust と C++ の両方で関数と型の宣言を生成します。" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"Once you've downloaded the crate, generate the `BUILD.gn` files like this:" +"See the [CXX tutorial](https://cxx.rs/tutorial.html) for a full example of " +"using this." msgstr "" -"クレートをダウンロードしたら、以下のように `BUILD.gn` ファイルを作成します。" - -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md -msgid "Now run `git status`. You should find:" -msgstr "`git status` を実行し、以下を確認します。" +"CXX の詳細な使用例については、[CXX チュートリアル](https://cxx.rs/tutorial." +"html) をご覧ください。" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"At least one new crate source code in `third_party/rust/chromium_crates_io/" -"vendor`" +"Talk through the diagram. Explain that behind the scenes, this is doing just " +"the same as you previously did. Point out that automating the process has " +"the following benefits:" msgstr "" -"`third_party/rust/chromium_crates_io/vendor` に 1 つ以上の新しいクレート ソー" -"スコードがあること" +"図を見ながら話しましょう。裏で行われる処理は以前とまったく同じであり、このプ" +"ロセスを自動化すると次のようなメリットがあることを説明します。" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"At least one new `BUILD.gn` in `third_party/rust//v`" +"The tool guarantees that the C++ and Rust sides match (e.g. you get compile " +"errors if the `#[cxx::bridge]` doesn't match the actual C++ or Rust " +"definitions, but with out-of-sync manual bindings you'd get Undefined " +"Behavior)" msgstr "" -"`third_party/rust//v` に 1 つ以上の新しい " -"`BUILD.gn` があること" - -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md -msgid "An appropriate `README.chromium`" -msgstr "適切な `README.chromium` があること" +"このツールは、C++ 側と Rust 側が一致することを保証します（たとえば、`#[cxx::" +"bridge]` が実際の C++ または Rust の定義と一致しない場合、コンパイル エラーが" +"発生しますが、同期されていない手動バインディングを使用すると、未定義の動作が" +"発生します）。" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md -#, fuzzy +#: src/chromium/interoperability-with-cpp.md msgid "" -"The \"major semver version\" is a [Rust \"semver\" version number](https://" -"doc.rust-lang.org/cargo/reference/semver.html)." +"The tool automates generation of FFI thunks (small, C-ABI-compatible, free " +"functions) for non-C features (e.g. enabling FFI calls into Rust or C++ " +"methods; manual bindings would require authoring such top-level, free " +"functions manually)" msgstr "" -"[workspaces](https://doc.rust-lang.org/cargo/reference/workspaces.html)（ワー" -"クスペース）" +"このツールは、C 以外の機能に対する FFI サンク（小さな C-ABI 互換のフリー関" +"数）の生成を自動化します（Rust または C++ メソッドへの FFI 呼び出しの有効化な" +"ど。手動バインディングでは、このようなトップレベルのフリー関数を手動で作成す" +"る必要があります）。" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md -msgid "" -"Take a close look, especially at the things generated in `third_party/rust`." -msgstr "特に `third_party/rust` 以下に生成されるものをよく確認してください。" +#: src/chromium/interoperability-with-cpp.md +msgid "The tool and the library can handle a set of core types - for example:" +msgstr "ツールとライブラリは、次のような一連の主要な型を処理できます。" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"Talk a little about semver --- and specifically the way that in Chromium " -"it's to allow multiple incompatible versions of a crate, which is " -"discouraged but sometimes necessary in the Cargo ecosystem." +"`&[T]` can be passed across the FFI boundary, even though it doesn't " +"guarantee any particular ABI or memory layout. With manual bindings `std::" +"span` / `&[T]` have to be manually destructured and rebuilt out of a " +"pointer and length - this is error-prone given that each language represents " +"empty slices slightly differently)" msgstr "" -"semver について、特に Chromium では互換性のないクレートのバージョンが複数許可" -"されることを説明しておきましょう。これは推奨されませんが、Cargo エコシステム" -"で必要になることがあります。" +"`&[T]` は、特定の ABI やメモリ レイアウトを保証するものではありませんが、FFI " +"の境界を超えて渡すことができます。手動バインディングでは、`std::span` / " +"`&[T]` を手動で分離し、ポインタと長さから再構築する必要があります。言語ごとに" +"空のスライスの表現方法が若干異なるため、エラーが発生しやすくなります。" -#: src/chromium/adding-third-party-crates/resolving-problems.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"If your build fails, it may be because of a `build.rs`: programs which do " -"arbitrary things at build time. This is fundamentally at odds with the " -"design of `gn` and `ninja` which aim for static, deterministic, build rules " -"to maximize parallelism and repeatability of builds." +"Smart pointers like `std::unique_ptr`, `std::shared_ptr`, and/or `Box` " +"are natively supported. With manual bindings, one would have to pass C-ABI-" +"compatible raw pointers, which would increase lifetime and memory-safety " +"risks." msgstr "" -"ビルドが失敗した場合、`build.rs`（ビルド時に任意の処理を行うプログラム）が原" -"因である可能性があります。これは、ビルドの並列性と再現性を最大化するために静" -"的で決定的なビルドルールを目指す `gn` と `ninja` の設計とは、基本的に矛盾して" -"います。" +"`std::unique_ptr`、`std::shared_ptr`、`Box` などのスマート ポインタは、" +"ネイティブにサポートされています。手動バインディングでは、C-ABI 互換の未加工" +"ポインタを渡す必要があるため、ライフタイムとメモリ安全性に関するリスクが高ま" +"ります。" -#: src/chromium/adding-third-party-crates/resolving-problems.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"Some `build.rs` actions are automatically supported; others require action:" +"`rust::String` and `CxxString` types understand and maintain differences in " +"string representation across the languages (e.g. `rust::String::lossy` can " +"build a Rust string from non-UTF8 input and `rust::String::c_str` can NUL-" +"terminate a string)." msgstr "" -"一部の `build.rs` アクションは自動的にサポートされますが、他のアクションには" -"対応が必要です。" +"`rust::String` 型と `CxxString` 型は、言語間の文字列表現の違いを理解し、維持" +"します（たとえば、`rust::String::lossy` は、非 UTF8 の入力から Rust 文字列を" +"作成できます。また、`rust::String::c_str` は文字列を NUL 終端できます）。" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "build script effect" -msgstr "ビルド スクリプトの効果" +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "" +"CXX requires that the whole C++/Rust boundary is declared in `cxx::bridge` " +"modules inside `.rs` source code." +msgstr "" +"CXX では、C++ と Rust の境界全体を `.rs` ソースコード内の `cxx::bridge` モ" +"ジュールで宣言する必要があります。" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Supported by our gn templates" -msgstr "gn テンプレートによるサポート" +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "\"example/include/blobstore.h\"" +msgstr "\"example/include/blobstore.h\"" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Work required by you" -msgstr "必要な作業" +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "// Definitions of Rust types and functions go here\n" +msgstr "// Rust の型と関数の定義をここに記述します。\n" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Checking rustc version to configure features on and off" -msgstr "rustc のバージョンを確認して機能を有効または無効にする" +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "Point out:" +msgstr "以下を説明します。" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "None" -msgstr "なし" +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "" +"Although this looks like a regular Rust `mod`, the `#[cxx::bridge]` " +"procedural macro does complex things to it. The generated code is quite a " +"bit more sophisticated - though this does still result in a `mod` called " +"`ffi` in your code." +msgstr "" +"これは通常の Rust `mod` のように見えますが、`#[cxx::bridge]` プロシージャル " +"マクロはこれに対して複雑な処理を行います。生成されるコードはもっと洗練されて" +"いますが、それでもコードには `ffi` という `mod` が作成されます。" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Checking platform or CPU to configure features on and off" -msgstr "プラットフォームまたは CPU を確認して機能を有効または無効にする" +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "Native support for C++'s `std::unique_ptr` in Rust" +msgstr "Rust での C++ の `std::unique_ptr` のネイティブ サポート" -#: src/chromium/adding-third-party-crates/resolving-problems.md +#: src/chromium/interoperability-with-cpp/example-bindings.md #, fuzzy -msgid "Generating code" -msgstr "コードの生成" - -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Yes - specify in `gnrt_config.toml`" -msgstr "あり - `gnrt_config.toml` で指定する" - -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Building C/C++" -msgstr "C/C++ のビルド" +msgid "Native support for Rust slices in C++" +msgstr "Rust での C++ の `std::unique_ptr` のネイティブ サポート" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Patch around it" -msgstr "パッチを適用する" +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "Calls from C++ to Rust, and Rust types (in the top part)" +msgstr "C++ から Rust および Rust の型への呼び出し（上部）" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Arbitrary other actions" -msgstr "その他の任意のアクション" +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "Calls from Rust to C++, and C++ types (in the bottom part)" +msgstr "Rust から C++ および C++ の型への呼び出し（下部）" -#: src/chromium/adding-third-party-crates/resolving-problems.md +#: src/chromium/interoperability-with-cpp/example-bindings.md msgid "" -"Fortunately, most crates don't contain a build script, and fortunately, most " -"build scripts only do the top two actions." +"**Common misconception**: It _looks_ like a C++ header is being parsed by " +"Rust, but this is misleading. This header is never interpreted by Rust, but " +"simply `#include`d in the generated C++ code for the benefit of C++ " +"compilers." msgstr "" -"幸い、ほとんどのクレートにはビルド スクリプトが含まれておらず、ほとんどのビル" -"ド スクリプトは上位 2 つのアクションのみを実行します。" +"**よくある誤解**: Rust で C++ ヘッダーが解析されているように見えますが、これ" +"は誤解です。このヘッダーは Rust では解釈されず、C++ コンパイラのために生成さ" +"れた C++ コードに `#include` されているだけです。" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" -"If `ninja` complains about missing files, check the `build.rs` to see if it " -"writes source code files." +"By far the most useful page when using CXX is the [type reference](https://" +"cxx.rs/bindings.html)." msgstr "" -"`ninja`がファイルを見つけられないというメッセージを表示する場合は、`build." -"rs` がソースコード ファイルを作成しているかどうかを確認します。" +"CXX を使用するときに最も役立つページは、[型リファレンス](https://cxx.rs/" +"bindings.html) です。" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +msgid "CXX fundamentally suits cases where:" +msgstr "CXX は基本的に、次のようなケースに適しています。" + +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" -"If so, modify [`gnrt_config.toml`](../configuring-gnrt-config-toml.md) to " -"add `build-script-outputs` to the crate. If this is a transitive dependency, " -"that is, one on which Chromium code should not directly depend, also add " -"`allow-first-party-usage=false`. There are several examples already in that " -"file:" -msgstr "" -"もしファイルが作成されるようになっていたら、[`gnrt_config.toml`](../" -"configuring-gnrt-config-toml.md) を変更して、クレートに `build-script-" -"outputs` を追加します。これが推移的依存関係（Chromium コードが直接依存すべき" -"でない依存関係）の場合は、`allow-first-party-usage=false` も追加します。この" -"ファイルには、すでにいくつかの例が含まれています。" +"Your Rust-C++ interface is sufficiently simple that you can declare all of " +"it." +msgstr "Rust-C++ インターフェースが十分にシンプルで、すべてを宣言できる場合。" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" -"```toml\n" -"[crate.unicode-linebreak]\n" -"allow-first-party-usage = false\n" -"build-script-outputs = [\"tables.rs\"]\n" -"```" +"You're using only the types natively supported by CXX already, for example " +"`std::unique_ptr`, `std::string`, `&[u8]` etc." msgstr "" -"```toml\n" -"[crate.unicode-linebreak]\n" -"allow-first-party-usage = false\n" -"build-script-outputs = [\"tables.rs\"]\n" -"```" +"すでに CXX でネイティブにサポートされている型のみを使用している場合（例: " +"`std::unique_ptr`、`std::string`、`&[u8]`）。" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" -"Now rerun [`gnrt.py -- gen`](../generating-gn-build-rules.md) to regenerate " -"`BUILD.gn` files to inform ninja that this particular output file is input " -"to subsequent build steps." +"It has many limitations --- for example lack of support for Rust's `Option` " +"type." msgstr "" -"次に、[`gnrt.py -- gen`](../generating-gn-build-rules.md) を再実行して " -"`BUILD.gn` ファイルを再生成し、この特定の出力ファイルが後続のビルドステップで" -"入力されることを ninja に教えます。" +"Rust の `Option` 型がサポートされていないなど、CXX には多くの制限があります。" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" -"Some crates use the [`cc`](https://crates.io/crates/cc) crate to build and " -"link C/C++ libraries. Other crates parse C/C++ using [`bindgen`](https://" -"crates.io/crates/bindgen) within their build scripts. These actions can't be " -"supported in a Chromium context --- our gn, ninja and LLVM build system is " -"very specific in expressing relationships between build actions." +"These limitations constrain us to using Rust in Chromium only for well " +"isolated \"leaf nodes\" rather than for arbitrary Rust-C++ interop. When " +"considering a use-case for Rust in Chromium, a good starting point is to " +"draft the CXX bindings for the language boundary to see if it appears simple " +"enough." msgstr "" -"一部のクレートは、[`cc`](https://crates.io/crates/cc) クレートを使用して、" -"C / C++ ライブラリのビルドとリンクを行います。他のクレートは、ビルド スクリプ" -"ト内で [`bindgen`](https://crates.io/crates/bindgen) を使用して C / C++ を解" -"析します。これらのアクションは、Chromium のコンテキストではサポートできませ" -"ん。Chromiumの gn、ninja、LLVM ビルドシステムは、ビルド アクション間の関係を" -"非常に具体的に表現するためです。" +"こうした制限により、Chromium では 任意の Rust と C++ の相互運用は行われず、" +"Rustの使用は十分に独立したコードに限定されています。Chromium での Rust のユー" +"スケースを検討する際は、まず、言語境界の CXX バインディングの下書きを作成し" +"て、シンプルに見えるかどうかを確認することをおすすめします。" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md -msgid "So, your options are:" -msgstr "したがって、次のようなオプションがあります。" +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +msgid "" +"You should also discuss some of the other sticky points with CXX, for " +"example:" +msgstr "" +"また、CXX のその他の厄介な点を説明する必要があります。次に例を示します。" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md -msgid "Avoid these crates" -msgstr "これらのクレートを使用しない" +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +msgid "" +"Its error handling is based around C++ exceptions (given on the next slide)" +msgstr "エラー処理が C++ 例外に基づいて行われる（次のスライドを参照）。" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md -msgid "Apply a patch to the crate." -msgstr "クレートにパッチを適用する" +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +msgid "Function pointers are awkward to use." +msgstr "関数ポインタが使いにくい。" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "" -"Patches should be kept in `third_party/rust/chromium_crates_io/patches/" -"` - see for example the [patches against the `cxx` crate](https://" -"source.chromium.org/chromium/chromium/src/+/main:third_party/rust/" -"chromium_crates_io/patches/cxx/) - and will be applied automatically by " -"`gnrt` each time it upgrades the crate." +"CXX's [support for `Result`](https://cxx.rs/binding/result.html) relies " +"on C++ exceptions, so we can't use that in Chromium. Alternatives:" msgstr "" -"パッチは `third_party/rust/chromium_crates_io/patches/` に保存する必要" -"があります。たとえば、[`cxx` クレートに対するパッチ](https://source.chromium." -"org/chromium/chromium/src/+/main:third_party/rust/chromium_crates_io/patches/" -"cxx/) をご覧ください。また、パッチはクレートがアップグレードされるたびに " -"`gnrt` によって自動的に適用されます。" +"CXX の [`Result` のサポート](https://cxx.rs/binding/result.html) は、C+" +"+ 例外に依存しているため、Chromium では使用できません。以下の代替手段がありま" +"す。" -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md +#: src/chromium/interoperability-with-cpp/error-handling.md +msgid "The `T` part of `Result` can be:" +msgstr "`Result` の `T` の部分:" + +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "" -"Once you've added a third-party crate and generated build rules, depending " -"on a crate is simple. Find your `rust_static_library` target, and add a " -"`dep` on the `:lib` target within your crate." +"Returned via out parameters (e.g. via `&mut T`). This requires that `T` can " +"be passed across the FFI boundary - for example `T` has to be:" msgstr "" -"サードパーティ クレートを追加してビルドルールを生成したら、クレートへの依存を" -"簡単に設定できます。`rust_static_library` ターゲットを見つけて、クレート内の " -"`:lib` ターゲットに `dep` を追加します。" +"out パラメータを介して返すことができます（例: `&mut T`）。そのためには、`T` " +"を FFI の境界を越えて渡せる必要があります。たとえば、`T` には以下を指定する必" +"要があります。" -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md -msgid "Specifically," -msgstr "具体的には次のようにします。" +#: src/chromium/interoperability-with-cpp/error-handling.md +msgid "A primitive type (like `u32` or `usize`)" +msgstr "プリミティブ型（`u32`、`usize` など）" -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "" -"```bob\n" -" +------------+ +----------------------+\n" -"\"//third_party/rust\" | crate name | \"/v\" | major semver version | \":" -"lib\"\n" -" +------------+ +----------------------+\n" -"```" +"A type natively supported by `cxx` (like `UniquePtr`) that has a suitable " +"default value to use in a failure case (_unlike_ `Box`)." msgstr "" -"```bob\n" -" +------------+ +------------------------------+\n" -"\"//third_party/rust\" | クレート名 | \"/v\" | semver のメジャー バージョン " -"| \":lib\"\n" -" +------------+ +------------------------------+\n" -"```" +"(`Box` とは異なり)適切なデフォルト値を持つ`cxx` でネイティブにサポートされ" +"ている型（`UniquePtr` など）。" -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "" -"```gn\n" -"rust_static_library(\"my_rust_lib\") {\n" -" crate_root = \"lib.rs\"\n" -" sources = [ \"lib.rs\" ]\n" -" deps = [ \"//third_party/rust/example_rust_crate/v1:lib\" ]\n" -"}\n" -"```" +"Retained on the Rust side, and exposed via reference. This may be needed " +"when `T` is a Rust type, which cannot be passed across the FFI boundary, and " +"cannot be stored in `UniquePtr`." msgstr "" -"```gn\n" -"rust_static_library(\"my_rust_lib\") {\n" -" crate_root = \"lib.rs\"\n" -" sources = [ \"lib.rs\" ]\n" -" deps = [ \"//third_party/rust/example_rust_crate/v1:lib\" ]\n" -"}\n" -"```" +"Rust 側で保持し、参照を介して公開できます。これは、`T` が Rust 型の場合に必要" +"になることがあります。Rust 型は FFI の境界を超えて渡すことができず、" +"`UniquePtr` に格納することもできません。" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md -msgid "Auditing Third Party Crates" -msgstr "サードパーティ クレートの監査" +#: src/chromium/interoperability-with-cpp/error-handling.md +msgid "The `E` part of `Result` can be:" +msgstr "`Result` の `E` の部分:" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "" -"Adding new libraries is subject to Chromium's standard [policies](https://" -"chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/rust." -"md#Third_party-review), but of course also subject to security review. As " -"you may be bringing in not just a single crate but also transitive " -"dependencies, there may be a lot of code to review. On the other hand, safe " -"Rust code can have limited negative side effects. How should you review it?" +"Returned as a boolean (e.g. `true` representing success, and `false` " +"representing failure)" msgstr "" -"新しいライブラリを追加する場合、Chromium の標準の [ポリシー](https://" -"chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/rust." -"md#Third_party-review) が適用されますが、当然ながらセキュリティ審査の対象にも" -"なります。1 つのクレートだけでなく推移的依存関係も取り込む場合、審査すべき" -"コードが多数存在することがあります。その一方で、安全な Rust コードの取り込み" -"に関しては、悪い副作用は限定的となります。クレートの審査はどのように行われる" -"べきでしょうか。" +"ブール値として返すことができます（たとえば、`true` は成功、`false` は失敗を表" +"します）。" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "" -"Over time Chromium aims to move to a process based around [cargo vet]" -"(https://mozilla.github.io/cargo-vet/)." +"Preserving error details is in theory possible, but so far hasn't been " +"needed in practice." msgstr "" -"Chromium は今後 [cargo vet](https://mozilla.github.io/cargo-vet/) を中心とし" -"たプロセスに移行されていく予定ですが、" +"理論上はエラーの詳細を保持できますが、これまでは実際に必要になることはありま" +"せんでした。" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/error-handling-qr.md +#, fuzzy +msgid "CXX Error Handling: QR Example" +msgstr "エラー処理" + +#: src/chromium/interoperability-with-cpp/error-handling-qr.md msgid "" -"Meanwhile, for each new crate addition, we are checking for the following:" +"The QR code generator is [an example](https://source.chromium.org/chromium/" +"chromium/src/+/main:components/qr_code_generator/qr_code_generator_ffi_glue." +"rs;l=13-18;drc=7bf1b75b910ca430501b9c6a74c1d18a0223ecca) where a boolean is " +"used to communicate success vs failure, and where the successful result can " +"be passed across the FFI boundary:" msgstr "" -"それまでの間、新しいクレートが追加されるたびに、以下のチェックを行います。" +"QR コード生成ツールは、ブール値が成功または失敗を伝達し、成功の結果を FFI の" +"境界を超えて受け渡すことができる [一例](https://source.chromium.org/chromium/" +"chromium/src/+/main:components/qr_code_generator/qr_code_generator_ffi_glue." +"rs;l=13-18;drc=7bf1b75b910ca430501b9c6a74c1d18a0223ecca) です。" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/error-handling-qr.md +msgid "\"qr_code_generator\"" +msgstr "\"qr_code_generator\"" + +#: src/chromium/interoperability-with-cpp/error-handling-qr.md msgid "" -"Understand why each crate is used. What's the relationship between crates? " -"If the build system for each crate contains a `build.rs` or procedural " -"macros, work out what they're for. Are they compatible with the way Chromium " -"is normally built?" +"Students may be curious about the semantics of the `out_qr_size` output. " +"This is not the size of the vector, but the size of the QR code (and " +"admittedly it is a bit redundant - this is the square root of the size of " +"the vector)." msgstr "" -"各クレートが使用されている理由と、クレート同士の関係を理解します。各クレート" -"のビルドシステムに`build.rs` または手続き型マクロが含まれている場合は、その目" -"的を調べます。また、Chromium の通常のビルド方法と互換性があるかどうかも確認し" -"ます。" - -#: src/chromium/adding-third-party-crates/reviews-and-audits.md -msgid "Check each crate seems to be reasonably well maintained" -msgstr "各クレートが十分にメンテナンスされているか確認します。" +"受講者は `out_qr_size` 出力のセマンティクスに関心を持っている可能性がありま" +"す。これはベクターのサイズではなく、QR コードのサイズです（つまり、この情報は" +"冗長であり、ベクターのサイズの平方根に相当します）。" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/error-handling-qr.md msgid "" -"Use `cd third-party/rust/chromium_crates_io; cargo audit` to check for known " -"vulnerabilities (first you'll need to `cargo install cargo-audit`, which " -"ironically involves downloading lots of dependencies from the internet[2](../" -"cargo.md))" +"It may be worth pointing out the importance of initializing `out_qr_size` " +"before calling into the Rust function. Creation of a Rust reference that " +"points to uninitialized memory results in Undefined Behavior (unlike in C++, " +"when only the act of dereferencing such memory results in UB)." msgstr "" -"`cd third-party/rust/chromium_crates_io; cargo audit` を使用して既知の脆弱性" -"をチェックします（最初に `cargo install cargo-audit` を実行する必要があります" -"が、皮肉なことに、これによってインターネットから多くの依存関係をダウンロード" -"することになります [2](../cargo.md)）。" +"Rust 関数を呼び出す前に `out_qr_size` を初期化することの重要性を説明しましょ" +"う。初期化されていないメモリを指す Rust 参照を作成すると、未定義の動作となり" +"ます（そのようなメモリを逆参照する操作のみが UB になるC++ とは異なります）。" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/error-handling-qr.md msgid "" -"Ensure any `unsafe` code is good enough for the [Rule of Two](https://" -"chromium.googlesource.com/chromium/src/+/main/docs/security/rule-of-2." -"md#unsafe-code-in-safe-languages)" +"If students ask about `Pin`, then explain why CXX needs it for mutable " +"references to C++ data: the answer is that C++ data can’t be moved around " +"like Rust data, because it may contain self-referential pointers." msgstr "" -"`unsafe` なコードが [Rule of Two](https://chromium.googlesource.com/chromium/" -"src/+/main/docs/security/rule-of-2.md#unsafe-code-in-safe-languages) を満たし" -"ていることを確認します。" +"`Pin` について受講者から尋ねられた場合は、CXX が C++ データへの可変参照のため" +"に `Pin` を必要とする理由を説明します。つまり、C++ のデータには自己参照ポイン" +"タが含まれている可能性があるため、Rust のデータのように移動することができませ" +"ん。" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md -msgid "Check for any use of `fs` or `net` APIs" -msgstr "`fs`および`net`のAPI が使用されているかどうかを確認します。" +#: src/chromium/interoperability-with-cpp/error-handling-png.md +#, fuzzy +msgid "CXX Error Handling: PNG Example" +msgstr "エラー処理" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/error-handling-png.md msgid "" -"Read all the code at a sufficient level to look for anything out of place " -"that might have been maliciously inserted. (You can't realistically aim for " -"100% perfection here: there's often just too much code.)" +"A prototype of a PNG decoder illustrates what can be done when the " +"successful result cannot be passed across the FFI boundary:" msgstr "" -"悪意を持って不正に挿入された可能性のある部分がないか探すのに十分なレベルで" -"コードを読みます（多くの場合、コードが多すぎて完璧にチェックすることはできま" -"せん）。" +"PNG デコーダのプロトタイプは、成功した結果を FFI の境界を越えて渡せない場合に" +"何ができるかを示しています。" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/error-handling-png.md +msgid "\"gfx::rust_bindings\"" +msgstr "\"gfx::rust_bindings\"" + +#: src/chromium/interoperability-with-cpp/error-handling-png.md msgid "" -"These are just guidelines --- work with reviewers from `security@chromium." -"org` to work out the right way to become confident of the crate." +"/// This returns an FFI-friendly equivalent of `Result,\n" +" /// ()>`.\n" msgstr "" -"これらはガイドラインにすぎません。`security@chromium.org` の審査担当者と協力" -"して、自信を持ってクレートを使用するための適切な方法を見つけてください。" - -#: src/chromium/adding-third-party-crates/checking-in.md -msgid "Checking Crates into Chromium Source Code" -msgstr "クレートを Chromium ソースコードにチェックインする" +"/// これは `Result,()>` と同等の FFI 対応の結果を\n" +" /// 返します。\n" -#: src/chromium/adding-third-party-crates/checking-in.md -msgid "`git status` should reveal:" -msgstr "`git status` を実行すると、以下を確認できます。" +#: src/chromium/interoperability-with-cpp/error-handling-png.md +msgid "/// C++ bindings for the `crate::png::ResultOfPngReader` type.\n" +msgstr "/// `crate::png::ResultOfPngReader` 型の C++ バインディング\n" -#: src/chromium/adding-third-party-crates/checking-in.md -msgid "Crate code in `//third_party/rust/chromium_crates_io`" -msgstr "`//third_party/rust/chromium_crates_io` にあるクレートコード" +#: src/chromium/interoperability-with-cpp/error-handling-png.md +msgid "/// C++ bindings for the `crate::png::PngReader` type.\n" +msgstr "/// `crate::png::PngReader` 型の C++ バインディング\n" -#: src/chromium/adding-third-party-crates/checking-in.md +#: src/chromium/interoperability-with-cpp/error-handling-png.md msgid "" -"Metadata (`BUILD.gn` and `README.chromium`) in `//third_party/rust//" -"`" +"`PngReader` and `ResultOfPngReader` are Rust types --- objects of these " +"types cannot cross the FFI boundary without indirection of a `Box`. We " +"can't have an `out_parameter: &mut PngReader`, because CXX doesn't allow C++ " +"to store Rust objects by value." msgstr "" -"`//third_party/rust//` にあるメタデータ（`BUILD.gn` と " -"`README.chromium`）" - -#: src/chromium/adding-third-party-crates/checking-in.md -msgid "Please also add an `OWNERS` file in the latter location." -msgstr "後者の場所に `OWNERS` ファイルも追加してください。" +"`PngReader` と `ResultOfPngReader`は Rust 型です。これらの型のオブジェクト" +"は、`Box` を介さずに FFI 境界を越えることはできません。CXX では Rust オブ" +"ジェクトを値で格納できないため、`out_parameter: &mut PngReader` と書くことは" +"できません。" -#: src/chromium/adding-third-party-crates/checking-in.md +#: src/chromium/interoperability-with-cpp/error-handling-png.md msgid "" -"You should land all this, along with your `Cargo.toml` and `gnrt_config." -"toml` changes, into the Chromium repo." +"This example illustrates that even though CXX doesn't support arbitrary " +"generics nor templates, we can still pass them across the FFI boundary by " +"manually specializing / monomorphizing them into a non-generic type. In the " +"example `ResultOfPngReader` is a non-generic type that forwards into " +"appropriate methods of `Result` (e.g. into `is_err`, `unwrap`, and/or " +"`as_mut`)." msgstr "" -"これらすべてを、`Cargo.toml` および `gnrt_config.toml` の変更とともに " -"Chromium リポジトリに追加する必要があります。" +"この例は、CXX が任意のジェネリクスやテンプレートをサポートしていなくても、手" +"動で非ジェネリック型に特化 / 単相化することで、FFI 境界を越えて渡せることを示" +"しています。この例では、`ResultOfPngReader` は`Result` の適切なメソッド" +"（`is_err`、`unwrap`、`as_mut` など）に渡される非ジェネリック型です。" -#: src/chromium/adding-third-party-crates/checking-in.md -msgid "" -"**Important**: you need to use `git add -f` because otherwise `.gitignore` " -"files may result in some files being skipped." -msgstr "" -"**重要**: `git add -f` を使用する必要があります。そうしないと、`.gitignore` " -"ファイルによって一部のファイルがスキップされる可能性があるためです。" +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +msgid "Using cxx in Chromium" +msgstr "Chromium で cxx を使用する" -#: src/chromium/adding-third-party-crates/checking-in.md +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md msgid "" -"As you do so, you might find presubmit checks fail because of non-inclusive " -"language. This is because Rust crate data tends to include names of git " -"branches, and many projects still use non-inclusive terminology there. So " -"you may need to run:" +"In Chromium, we define an independent `#[cxx::bridge] mod` for each leaf-" +"node where we want to use Rust. You'd typically have one for each " +"`rust_static_library`. Just add" msgstr "" -"その際、インクルーシブでない表現が原因で presubmit チェックが失敗することがあ" -"ります。これは、Rust のクレートデータには Git ブランチの名前が含まれている傾" -"向があり、多くのプロジェクトで依然としてインクルーシブでない表現が使用されて" -"いるためです。そのため、以下を実行する必要があります。" +"Chromium では、Rust を使用するリーフノードごとに独立した `#[cxx::bridge] " +"mod` を定義します。通常は、`rust_static_library` ごとに 1 つずつになります。" -#: src/chromium/adding-third-party-crates/keeping-up-to-date.md +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md msgid "" -"As the OWNER of any third party Chromium dependency, you are [expected to " -"keep it up to date with any security fixes](https://chromium.googlesource." -"com/chromium/src/+/main/docs/adding_to_third_party.md#add-owners). It is " -"hoped that we will soon automate this for Rust crates, but for now, it's " -"still your responsibility just as it is for any other third party dependency." +"```gn\n" +"cxx_bindings = [ \"my_rust_file.rs\" ]\n" +" # list of files containing #[cxx::bridge], not all source files\n" +"allow_unsafe = true\n" +"```" msgstr "" -"サードパーティの Chromium 依存関係の所有者は、[セキュリティに関する修正を行っ" -"て依存関係を最新の状態に保つことが求められます](https://chromium." -"googlesource.com/chromium/src/+/main/docs/adding_to_third_party.md#add-" -"owners)。これはまもなく自動化されることが期待されていますが、現状は他のサード" -"パーティの依存関係の場合と同様に、デベロッパーがその責任を負います。" +"```gn\n" +"cxx_bindings = [ \"my_rust_file.rs\" ]\n" +" # すべてのソースファイルではなく、#[cxx::bridge] を含むファイルのリスト\n" +"allow_unsafe = true\n" +"```" -#: src/exercises/chromium/third-party.md +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md msgid "" -"Add [uwuify](https://crates.io/crates/uwuify) to Chromium, turning off the " -"crate's [default features](https://doc.rust-lang.org/cargo/reference/" -"features.html#the-default-feature). Assume that the crate will be used in " -"shipping Chromium, but won't be used to handle untrustworthy input." +"to your existing `rust_static_library` target alongside `crate_root` and " +"`sources`." msgstr "" -"Chromium に [uwuify](https://crates.io/crates/uwuify) を追加し、クレートの " -"[デフォルトの機能](https://doc.rust-lang.org/cargo/reference/features." -"html#the-default-feature) を無効にします。クレートは Chromium の公開板で使用" -"されますが、信頼できない入力の処理には使用されないと仮定してください。" +"上記のコードを、`crate_root` や `sources`と並んで、既存の " +"`rust_static_library` ターゲットに追加するだけです。" -#: src/exercises/chromium/third-party.md -msgid "" -"(In the next exercise we'll use uwuify from Chromium, but feel free to skip " -"ahead and do that now if you like. Or, you could create a new " -"[`rust_executable` target](https://source.chromium.org/chromium/chromium/src/" -"+/main:build/rust/rust_executable.gni) which uses `uwuify`)." +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +msgid "C++ headers will be generated at a sensible location, so you can just" msgstr "" -"（次の演習で Chromium の uwuify を使用しますが、ここで行っても構いません。ま" -"たは、`uwuify` を使用する新しい [`rust_executable` ターゲット](https://" -"source.chromium.org/chromium/chromium/src/+/main:build/rust/rust_executable." -"gni) を作成することもできます）。" - -#: src/exercises/chromium/third-party.md -msgid "Students will need to download lots of transitive dependencies." -msgstr "受講者は多数の推移的依存関係をダウンロードする必要があります。" - -#: src/exercises/chromium/third-party.md -msgid "The total crates needed are:" -msgstr "必要なクレートは次のとおりです。" - -#: src/exercises/chromium/third-party.md -msgid "`instant`," -msgstr "`instant`" +"C++ ヘッダーは適切な場所で生成されるため、次のようにインクルードできます。" -#: src/exercises/chromium/third-party.md -msgid "`lock_api`," -msgstr "`lock_api`" +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +msgid "\"ui/base/my_rust_file.rs.h\"" +msgstr "\"ui/base/my_rust_file.rs.h\"" -#: src/exercises/chromium/third-party.md -msgid "`parking_lot`," -msgstr "`parking_lot`" +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +msgid "" +"You will find some utility functions in `//base` to convert to/from Chromium " +"C++ types to CXX Rust types --- for example [`SpanToRustSlice`](https://" +"source.chromium.org/chromium/chromium/src/+/main:base/containers/span_rust.h;" +"l=21)." +msgstr "" +"`//base` には、Chromium C++ 型から CXX Rust 型（およびその逆方向）への変換を" +"行うためのユーティリティ関数がいくつかあります（例: [`SpanToRustSlice`]" +"(https://source.chromium.org/chromium/chromium/src/+/main:base/containers/" +"span_rust.h;l=21)）。" -#: src/exercises/chromium/third-party.md -msgid "`parking_lot_core`," -msgstr "`parking_lot_core`" +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +msgid "Students may ask --- why do we still need `allow_unsafe = true`?" +msgstr "" +"受講者から、`allow_unsafe = true` がなぜここでも必要なのかを尋ねられる可能性" +"があります。" -#: src/exercises/chromium/third-party.md -msgid "`redox_syscall`," -msgstr "`redox_syscall`" +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +msgid "" +"The broad answer is that no C/C++ code is \"safe\" by the normal Rust " +"standards. Calling back and forth to C/C++ from Rust may do arbitrary things " +"to memory, and compromise the safety of Rust's own data layouts. Presence of " +"_too many_ `unsafe` keywords in C/C++ interop can harm the signal-to-noise " +"ratio of such a keyword, and is [controversial](https://steveklabnik.com/" +"writing/the-cxx-debate), but strictly, bringing any foreign code into a Rust " +"binary can cause unexpected behavior from Rust's perspective." +msgstr "" +"大まかに答えると、C/C++ コードは通常の Rust 標準では「安全」ではありません。" +"Rust から C/C++ に行ったり来たりすると、メモリに対して任意の処理が行われ、" +"Rust 独自のデータ レイアウトの安全性が損なわれる可能性があります。C/C++ の相" +"互運用で `unsafe` キーワードが多すぎると、`unsafe`に対する注目度が薄れるの" +"で、これには [賛否両論があります](https://steveklabnik.com/writing/the-cxx-" +"debate)。ただし厳密には、外部コードを Rust バイナリに取り込むと、Rust の観点" +"からは想定していない動作が発生する可能性があります。" -#: src/exercises/chromium/third-party.md -msgid "`scopeguard`," -msgstr "`scopeguard`" +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +msgid "" +"The narrow answer lies in the diagram at the top of [this page](../" +"interoperability-with-cpp.md) --- behind the scenes, CXX generates Rust " +"`unsafe` and `extern \"C\"` functions just like we did manually in the " +"previous section." +msgstr "" +"具体的な答えは、[このページ](../interoperability-with-cpp.md) の上部の図にあ" +"ります。裏では、CXX は Rust の `unsafe` 関数と `extern \"C\"` 関数を生成しま" +"す。これは前のセクションで手動で行ったのとまったく同じです。" -#: src/exercises/chromium/third-party.md -msgid "`smallvec`, and" -msgstr "`smallvec`" +#: src/exercises/chromium/interoperability-with-cpp.md +#, fuzzy +msgid "Exercise: Interoperability with C++" +msgstr "演習: C++との相互運用性" -#: src/exercises/chromium/third-party.md -msgid "`uwuify`." -msgstr "`uwuify`" +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Part one" +msgstr "パート 1" -#: src/exercises/chromium/third-party.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"If students are downloading even more than that, they probably forgot to " -"turn off the default features." +"In the Rust file you previously created, add a `#[cxx::bridge]` which " +"specifies a single function, to be called from C++, called " +"`hello_from_rust`, taking no parameters and returning no value." msgstr "" -"受講者が上記以外のクレートをダウンロードしている場合は、デフォルトの機能を無" -"効にするのを忘れている可能性があります。" +"先ほど作成した Rust ファイルに、C++ から呼び出す単一の関数を示す `#[cxx::" +"bridge]` を追加します。これは `hello_from_rust` という関数で、パラメータを受" +"け取らず、値も返しません。" -#: src/exercises/chromium/third-party.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"Thanks to [Daniel Liu](https://github.com/Daniel-Liu-c0deb0t) for this crate!" +"Modify your previous `hello_from_rust` function to remove `extern \"C\"` and " +"`#[no_mangle]`. This is now just a standard Rust function." msgstr "" -"このクレートに協力してくれた [Daniel Liu](https://github.com/Daniel-Liu-" -"c0deb0t) に感謝します。" +"前の `hello_from_rust` 関数を変更して `extern \"C\"` と `#[no_mangle]` を削除" +"します。これで標準の Rust 関数になります。" -#: src/exercises/chromium/bringing-it-together.md -msgid "Bringing It Together --- Exercise" -msgstr "まとめ --- 演習" +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Modify your `gn` target to build these bindings." +msgstr "`gn` ターゲットを変更して、これらのバインディングをビルドします。" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"In this exercise, you're going to add a whole new Chromium feature, bringing " -"together everything you already learned." +"In your C++ code, remove the forward-declaration of `hello_from_rust`. " +"Instead, include the generated header file." msgstr "" -"この演習では、Chromium の新しい機能を追加しながら、これまで学んだことをまとめ" -"ます。" +"C++ コードで、`hello_from_rust` の前方宣言を削除し、代わりに生成されたヘッ" +"ダー ファイルをインクルードします。" -#: src/exercises/chromium/bringing-it-together.md -msgid "The Brief from Product Management" -msgstr "プロダクト マネジメント部門からのブリーフィング" +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Build and run!" +msgstr "ビルドして実行します。" -#: src/exercises/chromium/bringing-it-together.md -msgid "" -"A community of pixies has been discovered living in a remote rainforest. " -"It's important that we get Chromium for Pixies delivered to them as soon as " -"possible." -msgstr "" -"人里離れた熱帯雨林に生息するピクシー（妖精の一種）の村が発見されました。ピク" -"シー向けの Chromium をできるだけ早く提供することが重要です。" +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Part two" +msgstr "パート 2" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"The requirement is to translate all Chromium's UI strings into Pixie " -"language." +"It's a good idea to play with CXX a little. It helps you think about how " +"flexible Rust in Chromium actually is." msgstr "" -"要件は、Chromium のすべての UI 文字列をピクシーの言語に翻訳することです。" +"CXX を少し使ってみて、Chromium における Rust の柔軟性について理解を深めましょ" +"う。" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Some things to try:" +msgstr "以下を試してください。" + +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Call back into C++ from Rust. You will need:" +msgstr "Rust から C++ を呼び出します。これには以下が必要です。" + +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"There's not time to wait for proper translations, but fortunately pixie " -"language is very close to English, and it turns out there's a Rust crate " -"which does the translation." +"An additional header file which you can `include!` from your `cxx::bridge`. " +"You'll need to declare your C++ function in that new header file." msgstr "" -"正式な翻訳を行っている時間はありませんが、幸いにもピクシーの言語は英語に非常" -"に近く、その翻訳を行う Rust クレートがあることがわかりました。" +"`cxx::bridge` から `include!` できる追加のヘッダー ファイル。その新しいヘッ" +"ダー ファイルで C++ 関数を宣言する必要があります。" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"In fact, you already [imported that crate in the previous exercise](https://" -"crates.io/crates/uwuify)." +"An `unsafe` block to call such a function, or alternatively specify the " +"`unsafe` keyword in your `#[cxx::bridge]` [as described here](https://cxx.rs/" +"extern-c++.html#functions-and-member-functions)." msgstr "" -"実は、[前の演習でそのクレートをインポートしています](https://crates.io/" -"crates/uwuify)。" +"このような関数を呼び出す `unsafe` ブロック。または [こちら](https://cxx.rs/" +"extern-c++.html#functions-and-member-functions) に記載されているとおり、" +"`#[cxx::bridge]` 内で `unsafe` キーワードを指定する必要があります。" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"(Obviously, real translations of Chrome require incredible care and " -"diligence. Don't ship this!)" +"You may also need to `#include \"third_party/rust/cxx/v1/crate/include/cxx." +"h\"`" msgstr "" -"（言うまでもなく、Chrome を実際に翻訳するには細心の注意と努力が必要ですので、" -"これは公開しないでください）。" +"`#include \"third_party/rust/cxx/v1/crate/include/cxx.h\"` も必要になるかもし" +"れません。" -#: src/exercises/chromium/bringing-it-together.md -msgid "Steps" -msgstr "手順" +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Pass a C++ string from C++ into Rust." +msgstr "C++ から Rust に C++ 文字列を渡します。" -#: src/exercises/chromium/bringing-it-together.md -msgid "" -"Modify `ResourceBundle::MaybeMangleLocalizedString` so that it uwuifies all " -"strings before display. In this special build of Chromium, it should always " -"do this irrespective of the setting of `mangle_localized_strings_`." -msgstr "" -"表示前にすべての文字列を翻訳するように `ResourceBundle::" -"MaybeMangleLocalizedString` を変更します。Chromium のこの特別なビルドでは、" -"`mangle_localized_strings_` の設定に関係なく、常にこのようにします。" +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Pass a reference to a C++ object into Rust." +msgstr "C++ オブジェクトへの参照を Rust に渡します。" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"If you've done everything right across all these exercises, congratulations, " -"you should have created Chrome for pixies!" +"Intentionally get the Rust function signatures mismatched from the `#[cxx::" +"bridge]`, and get used to the errors you see." msgstr "" -"ここまでの演習をすべて正しく終わらせれていれば、これでピクシー向けの Chrome " -"が完成しているはずです。" +"意図的に`#[cxx::bridge]`と一致しないようにRust 関数のシグネチャを変更し、表示" +"されるエラーに慣れるようにします。" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"UTF16 vs UTF8. Students should be aware that Rust strings are always UTF8, " -"and will probably decide that it's better to do the conversion on the C++ " -"side using `base::UTF16ToUTF8` and back again." +"Intentionally get the C++ function signatures mismatched from the `#[cxx::" +"bridge]`, and get used to the errors you see." msgstr "" -"UTF16 と UTF8 について、受講者は Rust 文字列が常に UTF8 であることに注意する" -"必要があります。おそらく、C++ 側で `base::UTF16ToUTF8` を使用して変換、逆変換" -"する方がよいと判断するでしょう。" +"意図的に`#[cxx::bridge]`と一致しないようにC++ 関数のシグネチャを変更し、表示" +"されるエラーに慣れるようにします。" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"If students decide to do the conversion on the Rust side, they'll need to " -"consider [`String::from_utf16`](https://doc.rust-lang.org/std/string/struct." -"String.html#method.from_utf16), consider error handling, and consider which " -"[CXX supported types can transfer a lot of u16s](https://cxx.rs/binding/" -"slice.html)." +"Pass a `std::unique_ptr` of some type from C++ into Rust, so that Rust can " +"own some C++ object." msgstr "" -"Rust 側で変換を行う場合は、[`String::from_utf16`](https://doc.rust-lang.org/" -"std/string/struct.String.html#method.from_utf16)の利用、エラー処理、[多くの " -"u16s を転送可能な CXX でサポートされている型](https://cxx.rs/binding/slice." -"html) はどれかを検討する必要があります。" +"なんらかの型の `std::unique_ptr` を C++ から Rust に渡して、Rust がいくつか" +"の C++ オブジェクトを所有できるようにします。" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"Students may design the C++/Rust boundary in several different ways, e.g. " -"taking and returning strings by value, or taking a mutable reference to a " -"string. If a mutable reference is used, CXX will likely tell the student " -"that they need to use [`Pin`](https://doc.rust-lang.org/std/pin/). You may " -"need to explain what `Pin` does, and then explain why CXX needs it for " -"mutable references to C++ data: the answer is that C++ data can't be moved " -"around like Rust data, because it may contain self-referential pointers." +"Create a Rust object and pass it into C++, so that C++ owns it. (Hint: you " +"need a `Box`)." msgstr "" -"受講者はいくつかの異なる方法で C++ と Rust の境界を設計できます。たとえば、文" -"字列を値で取得して返す、または文字列への可変参照を取得するなどです。可変参照" -"が使用されている場合は、おそらく CXX は [`Pin`](https://doc.rust-lang.org/" -"std/pin/) を使用する必要がある旨のメッセージを表示します。`Pin` の機能を説明" -"し、C++ データへの可変参照のために CXX で `Pin` が必要になる理由を説明する必" -"要があるかもしれません。答えは、C++ データには自己参照ポインタが含まれている" -"可能性があるため、Rust データのように移動できないためです。" +"Rust オブジェクトを作成して C++ に渡して、C++ がそれを所有できるようにします" +"（ヒント: `Box` が必要です）。" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Declare some methods on a C++ type. Call them from Rust." +msgstr "C++ 型でいくつかのメソッドを宣言し、Rust から呼び出します。" + +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Declare some methods on a Rust type. Call them from C++." +msgstr "Rust 型に対していくつかのメソッドを宣言し、C++ から呼び出します。" + +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Part three" +msgstr "パート 3" + +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"The C++ target containing `ResourceBundle::MaybeMangleLocalizedString` will " -"need to depend on a `rust_static_library` target. The student probably " -"already did this." +"Now you understand the strengths and limitations of CXX interop, think of a " +"couple of use-cases for Rust in Chromium where the interface would be " +"sufficiently simple. Sketch how you might define that interface." msgstr "" -"`ResourceBundle::MaybeMangleLocalizedString` を含む C++ ターゲットは、" -"`rust_static_library` ターゲットに依存する必要があります。受講者はすでにこれ" -"を行っているはずです。" +"CXX の相互運用性の長所と制限事項について理解したところで、インターフェースが" +"非常にシンプルな、Chromium での Rust のユースケースをいくつか考えてみましょ" +"う。このインターフェースをどのように定義すればよいか考えてみましょう。" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "The [`cxx` binding reference](https://cxx.rs/bindings.html)" +msgstr "[`cxx` バインディング リファレンス](https://cxx.rs/bindings.html)" + +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"The `rust_static_library` target will need to depend on `//third_party/rust/" -"uwuify/v0_2:lib`." +"The [`rust_static_library` gn template](https://source.chromium.org/chromium/" +"chromium/src/+/main:build/rust/rust_static_library.gni;l=16)" msgstr "" -"`rust_static_library` ターゲットは `//third_party/rust/uwuify/v0_2:lib` に依" -"存する必要があります。" +"[`rust_static_library` gn テンプレート](https://source.chromium.org/chromium/" +"chromium/src/+/main:build/rust/rust_static_library.gni;l=16)" -#: src/exercises/chromium/solutions.md +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Some of the questions you may encounter:" +msgstr "次のような質問が寄せられる可能性があります。" + +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"Solutions to the Chromium exercises can be found in [this series of CLs]" -"(https://chromium-review.googlesource.com/c/chromium/src/+/5096560)." +"I'm seeing a problem initializing a variable of type X with type Y, where X " +"and Y are both function types. This is because your C++ function doesn't " +"quite match the declaration in your `cxx::bridge`." msgstr "" -"Chromium の演習の解答については、[こちらの CL シリーズ](https://chromium-" -"review.googlesource.com/c/chromium/src/+/5096560) をご覧ください。" - -#: src/bare-metal.md -msgid "Welcome to Bare Metal Rust" -msgstr "ベアメタルRustへようこそ" +"X と Y の両方が関数型である場合に、型 X の変数を型 Y で初期化すると問題が発生" +"します。これは、C++ 関数が `cxx::bridge` 内の宣言と完全に一致しないためです。" -#: src/bare-metal.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"This is a standalone one-day course about bare-metal Rust, aimed at people " -"who are familiar with the basics of Rust (perhaps from completing the " -"Comprehensive Rust course), and ideally also have some experience with bare-" -"metal programming in some other language such as C." +"I seem to be able to freely convert C++ references into Rust references. " +"Doesn't that risk UB? For CXX's _opaque_ types, no, because they are zero-" +"sized. For CXX trivial types yes, it's _possible_ to cause UB, although " +"CXX's design makes it quite difficult to craft such an example." msgstr "" -"こちらはベアメタルRustに関する独立した１日コースです。対象としているのは、" -"Rustの基本的な部分に関しては習得済みな人で（例えば、本講座で）、Cなどの他の言" -"語でベアメタル開発の経験があると理想的です。" +"C++ 参照を Rust 参照に自由に変換できるようですが、UB のリスクはないでしょう" +"か？CXX の不透明型の場合、サイズがゼロであるため、そのリスクはありません。" +"CXX のトリビアル型では UB が発生する可能性がありますが、CXX の設計上、そのよ" +"うな例を作成するのは非常に困難です。" -#: src/bare-metal.md +#: src/chromium/adding-third-party-crates.md msgid "" -"Today we will talk about 'bare-metal' Rust: running Rust code without an OS " -"underneath us. This will be divided into several parts:" +"Rust libraries are called \"crates\" and are found at [crates.io](https://" +"crates.io). It's _very easy_ for Rust crates to depend upon one another. So " +"they do!" msgstr "" -"今日、取り扱うのは、ベアメタルRustです。すなわち、OSなしでRustのコードを実行" -"します。この章は以下のような構成になります:" +"Rust ライブラリは「クレート」と呼ばれ、[crates.io](https://crates.io) にあり" +"ます。Rust クレートを互いに依存させるのは非常に簡単であり、実際にそのように" +"なっています" -#: src/bare-metal.md -msgid "What is `no_std` Rust?" -msgstr "`no_std` Rustとは?" +#: src/chromium/adding-third-party-crates.md +msgid "Property" +msgstr "プロパティ" -#: src/bare-metal.md -msgid "Writing firmware for microcontrollers." -msgstr "マイクロコントローラ向けのファームウェア開発。" +#: src/chromium/adding-third-party-crates.md +#, fuzzy +msgid "C++ library" +msgstr "ライブラリ" -#: src/bare-metal.md -msgid "Writing bootloader / kernel code for application processors." -msgstr "アプリケーションプロセッサ向けのブートローダ／カーネル開発。" +#: src/chromium/adding-third-party-crates.md +#, fuzzy +msgid "Rust crate" +msgstr "Rustクレート" -#: src/bare-metal.md -msgid "Some useful crates for bare-metal Rust development." -msgstr "ベアメタルRust開発に役立つクレートの紹介。" - -#: src/bare-metal.md -msgid "" -"For the microcontroller part of the course we will use the [BBC micro:bit]" -"(https://microbit.org/) v2 as an example. It's a [development board](https://" -"tech.microbit.org/hardware/) based on the Nordic nRF51822 microcontroller " -"with some LEDs and buttons, an I2C-connected accelerometer and compass, and " -"an on-board SWD debugger." -msgstr "" -"マイクロコントローラ向けの学習では[BBC micro:bit](https://microbit.org/) v2を" -"題材として使います。これは、Nordic nRF51822マイコンベースの[開発ボード]" -"(https://tech.microbit.org/hardware/) で、いくつかのLEDやボタンスイッチ、I2C" -"接続の加速度センサやコンパス、そしてオンボードSWDデバッガを搭載しています。" - -#: src/bare-metal.md -msgid "" -"To get started, install some tools we'll need later. On gLinux or Debian:" -msgstr "" -"まずはじめに、後ほど必要となるいくつかのツールをインストールします。gLinuxま" -"たはDebianの場合は以下のようになります:" - -#: src/bare-metal.md -msgid "" -"And give users in the `plugdev` group access to the micro:bit programmer:" -msgstr "" -"さらに、`plugdev`グループにmicro:bitプログラム用デバイスへのアクセスを付与し" -"ます:" - -#: src/bare-metal.md src/bare-metal/microcontrollers/debugging.md -msgid "On MacOS:" -msgstr "MacOSの場合は以下のようになります:" - -#: src/bare-metal/no_std.md -msgid "`core`" -msgstr "`core`" - -#: src/bare-metal/no_std.md -msgid "`std`" -msgstr "`std`" - -#: src/bare-metal/no_std.md -msgid "Slices, `&str`, `CStr`" -msgstr "Slice、`&str`、`CStr`" - -#: src/bare-metal/no_std.md -msgid "`NonZeroU8`..." -msgstr "`NonZeroU8` など" - -#: src/bare-metal/no_std.md -msgid "`Option`, `Result`" -msgstr "`Option`、`Result`" - -#: src/bare-metal/no_std.md -msgid "`Display`, `Debug`, `write!`..." -msgstr "`Display`、`Debug`、`write!` など" - -#: src/bare-metal/no_std.md -msgid "`panic!`, `assert_eq!`..." -msgstr "`panic!`、`assert_eq!` など" - -#: src/bare-metal/no_std.md -msgid "`NonNull` and all the usual pointer-related functions" -msgstr "`NonNull` とポインターに関する全ての一般的な関数" - -#: src/bare-metal/no_std.md -msgid "`Future` and `async`/`await`" -msgstr "`Future` と `async` / `await`" - -#: src/bare-metal/no_std.md -msgid "`fence`, `AtomicBool`, `AtomicPtr`, `AtomicU32`..." -msgstr "`fence`、`AtomicBool`、`AtomicPtr`、`AtomicU32` など" - -#: src/bare-metal/no_std.md -msgid "`Duration`" -msgstr "`Duration`" - -#: src/bare-metal/no_std.md -msgid "`Box`, `Cow`, `Arc`, `Rc`" -msgstr "`Box`、`Cow`、`Arc`、`Rc`" +#: src/chromium/adding-third-party-crates.md +#, fuzzy +msgid "Build system" +msgstr "ビルドシステム" -#: src/bare-metal/no_std.md -msgid "`Vec`, `BinaryHeap`, `BtreeMap`, `LinkedList`, `VecDeque`" -msgstr "`Vec`、`BinaryHeap`、`BtreeMap`、`LinkedList`、`VecDeque`" +#: src/chromium/adding-third-party-crates.md +msgid "Lots" +msgstr "多数" -#: src/bare-metal/no_std.md -msgid "`String`, `CString`, `format!`" -msgstr "`String`、`CString`、`format!`" +#: src/chromium/adding-third-party-crates.md +msgid "Consistent: `Cargo.toml`" +msgstr "一貫して `Cargo.toml`" -#: src/bare-metal/no_std.md -msgid "`Error`" -msgstr "`Error`" +#: src/chromium/adding-third-party-crates.md +msgid "Typical library size" +msgstr "一般的なライブラリ サイズ" -#: src/bare-metal/no_std.md -msgid "`Mutex`, `Condvar`, `Barrier`, `Once`, `RwLock`, `mpsc`" -msgstr "`Mutex`、`Condvar`、`Barrier`、`Once`、`RwLock`、`mpsc`" +#: src/chromium/adding-third-party-crates.md +msgid "Large-ish" +msgstr "やや大" -#: src/bare-metal/no_std.md -msgid "`File` and the rest of `fs`" -msgstr "`File`、残りの `fs`" +#: src/chromium/adding-third-party-crates.md +msgid "Small" +msgstr "小" -#: src/bare-metal/no_std.md -msgid "`println!`, `Read`, `Write`, `Stdin`, `Stdout` and the rest of `io`" -msgstr "`println!`、`Read`、`Write`、`Stdin`、`Stdout`、残りの `io`" +#: src/chromium/adding-third-party-crates.md +msgid "Transitive dependencies" +msgstr "推移的依存関係" -#: src/bare-metal/no_std.md -msgid "`Path`, `OsString`" -msgstr "`Path`、`OsString`" +#: src/chromium/adding-third-party-crates.md +msgid "Few" +msgstr "少" -#: src/bare-metal/no_std.md -msgid "`net`" -msgstr "`net`" +#: src/chromium/adding-third-party-crates.md +msgid "For a Chromium engineer, this has pros and cons:" +msgstr "Chromium のエンジニアにとって、クレートには長所と短所があります。" -#: src/bare-metal/no_std.md -msgid "`Command`, `Child`, `ExitCode`" -msgstr "`Command`、`Child`、`ExitCode`" +#: src/chromium/adding-third-party-crates.md +msgid "" +"All crates use a common build system so we can automate their inclusion into " +"Chromium..." +msgstr "" +"すべてのクレートが共通のビルドシステムを使用しているため、Chromium への取り込" +"みを自動化できます。" -#: src/bare-metal/no_std.md -msgid "`spawn`, `sleep` and the rest of `thread`" -msgstr "`spawn`、`sleep`、残りの `thread`" +#: src/chromium/adding-third-party-crates.md +msgid "" +"... but, crates typically have transitive dependencies, so you will likely " +"have to bring in multiple libraries." +msgstr "" +"しかし、クレートには通常、推移的依存関係があるため、複数のライブラリを取り込" +"むことが必要になる可能性があります。" -#: src/bare-metal/no_std.md -msgid "`SystemTime`, `Instant`" -msgstr "`SystemTime`、`Instant`" +#: src/chromium/adding-third-party-crates.md +msgid "We'll discuss:" +msgstr "議論する内容は次のとおりです。" -#: src/bare-metal/no_std.md -msgid "`HashMap` depends on RNG." -msgstr "`HashMap`はRNGに依存します。" +#: src/chromium/adding-third-party-crates.md +msgid "How to put a crate in the Chromium source code tree" +msgstr "Chromium ソースコード ツリーにクレートを配置する方法" -#: src/bare-metal/no_std.md -msgid "`std` re-exports the contents of both `core` and `alloc`." -msgstr "`std`は`core`と`alloc`の両方を再エクスポートします。" +#: src/chromium/adding-third-party-crates.md +msgid "How to make `gn` build rules for it" +msgstr "クレート用の `gn` ビルドルールを作成する方法" -#: src/bare-metal/minimal.md -msgid "A minimal `no_std` program" -msgstr "最小限の`no_std`プログラム" +#: src/chromium/adding-third-party-crates.md +msgid "How to audit its source code for sufficient safety." +msgstr "クレートのソースコードの十分な安全性を監査する方法。" -#: src/bare-metal/minimal.md -msgid "This will compile to an empty binary." -msgstr "このコードは空のバイナリにコンパイルされます。" +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md +msgid "Configuring the `Cargo.toml` file to add crates" +msgstr " `Cargo.toml` ファイルによりクレートを追加する方法" -#: src/bare-metal/minimal.md -msgid "`std` provides a panic handler; without it we must provide our own." +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md +msgid "" +"Chromium has a single set of centrally-managed direct crate dependencies. " +"These are managed through a single [`Cargo.toml`](https://source.chromium." +"org/chromium/chromium/src/+/main:third_party/rust/chromium_crates_io/Cargo." +"toml):" msgstr "" -"パニックハンドラは`std`が提供するので、それを使わない場合は自分で提供する必要" -"があります。" +"Chromium には、一元管理される直接的なクレート依存関係が 1 セットあります。こ" +"れらは単一の [`Cargo.toml`](https://source.chromium.org/chromium/chromium/" +"src/+/main:third_party/rust/chromium_crates_io/Cargo.toml) で管理されます。" -#: src/bare-metal/minimal.md -msgid "It can also be provided by another crate, such as `panic-halt`." +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md +msgid "" +"```toml\n" +"[dependencies]\n" +"bitflags = \"1\"\n" +"cfg-if = \"1\"\n" +"cxx = \"1\"\n" +"# lots more...\n" +"```" msgstr "" -"あるいは、`panic-halt`のような別のクレートが提供するパニックハンドラを利用す" -"ることもできます。" +"```toml\n" +"[dependencies]\n" +"bitflags = \"1\"\n" +"cfg-if = \"1\"\n" +"cxx = \"1\"\n" +"# lots more...\n" +"```" -#: src/bare-metal/minimal.md +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md msgid "" -"Depending on the target, you may need to compile with `panic = \"abort\"` to " -"avoid an error about `eh_personality`." +"As with any other `Cargo.toml`, you can specify [more details about the " +"dependencies](https://doc.rust-lang.org/cargo/reference/specifying-" +"dependencies.html) --- most commonly, you'll want to specify the `features` " +"that you wish to enable in the crate." msgstr "" -"ターゲットによっては、`eh_personality`に関するエラーを回避するために`panic = " -"\"abort\"`を指定してコンパイルする必要があります。" +"他の `Cargo.toml` と同様に、[依存関係の詳細](https://doc.rust-lang.org/cargo/" +"reference/specifying-dependencies.html) を指定できます。通常は、クレートで有" +"効にする `features` を指定します。" -#: src/bare-metal/minimal.md +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md msgid "" -"Note that there is no `main` or any other entry point; it's up to you to " -"define your own entry point. This will typically involve a linker script and " -"some assembly code to set things up ready for Rust code to run." +"When adding a crate to Chromium, you'll often need to provide some extra " +"information in an additional file, `gnrt_config.toml`, which we'll meet next." msgstr "" -"なお、`main`のようなプログラムの規定エントリポイントはないので、自分でエント" -"リポイントを定義する必要があります。通常、Rustコードを実行できるようにするた" -"めには、リンカスクリプトとある程度のアセンブリコードを必要とします。" +"Chromium にクレートを追加する際は、多くの場合、 `gnrt_config.toml`という追加" +"ファイルに情報を指定する必要があります。これについては後で説明します。" -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md msgid "" -"To use `alloc` you must implement a [global (heap) allocator](https://doc." -"rust-lang.org/stable/std/alloc/trait.GlobalAlloc.html)." +"Alongside `Cargo.toml` is [`gnrt_config.toml`](https://source.chromium.org/" +"chromium/chromium/src/+/main:third_party/rust/chromium_crates_io/gnrt_config." +"toml). This contains Chromium-specific extensions to crate handling." msgstr "" -"`alloc`を使うためには、[グローバル（ヒープ）アロケータ](https://doc.rust-" -"lang.org/stable/std/alloc/trait.GlobalAlloc.html)を実装しなければなりません。" +"`Cargo.toml` のほかに、[`gnrt_config.toml`](https://source.chromium.org/" +"chromium/chromium/src/+/main:third_party/rust/chromium_crates_io/gnrt_config." +"toml) があります。これには、クレートを扱うための Chromium 固有の拡張機能が含" +"まれています。" -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md msgid "" -"// Safe because `HEAP` is only used here and `entry` is only called once.\n" +"If you add a new crate, you should specify at least the `group`. This is one " +"of:" msgstr "" -"// `HEAP` はここでのみ使用され、`entry` は一度だけ呼び出されるため、安全で" -"す。\n" - -#: src/bare-metal/alloc.md -msgid "// Give the allocator some memory to allocate.\n" -msgstr "// アロケーターにメモリを割り当てます。\n" - -#: src/bare-metal/alloc.md -msgid "// Now we can do things that require heap allocation.\n" -msgstr "" -"// これで、ヒープ割り当てを必要とする処理を実行できるようになりました。\n" +"新しいクレートを追加する場合は、少なくとも次のいずれかの `group` を指定する必" +"要があります。" -#: src/bare-metal/alloc.md -msgid "\"A string\"" -msgstr "\"A string\"" +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md +#: src/chromium/adding-third-party-crates/depending-on-a-crate.md +msgid "For instance," +msgstr "次に例を示します。" -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md msgid "" -"`buddy_system_allocator` is a third-party crate implementing a basic buddy " -"system allocator. Other crates are available, or you can write your own or " -"hook into your existing allocator." +"Depending on the crate source code layout, you may also need to use this " +"file to specify where its `LICENSE` file(s) can be found." msgstr "" -"`buddy_system_allocator`はサードパーティのクレートで、単純なバディシステムア" -"ロケータです。その他にも利用できるクレートはありますし、自前で実装したり、別" -"のアロケータに自分のコードをフックすることも可能です。" +"クレートのソースコードのレイアウトによっては、このファイルを使用して " +"`LICENSE` ファイルを見つける場所も指定する必要があります。" -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md msgid "" -"The const parameter of `LockedHeap` is the max order of the allocator; i.e. " -"in this case it can allocate regions of up to 2\\*\\*32 bytes." +"Later, we'll see some other things you will need to configure in this file " +"to resolve problems." msgstr "" -"パラメータ定数`LockedHeap`はアロケータの最大オーダを示します。この場合、" -"2\\*\\*32バイトの領域を確保することが可能です。" +"後ほど、いくつかの問題を解決するためにこのファイルに指定する必要がある設定に" +"ついて取り扱います。" -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/downloading-crates.md msgid "" -"If any crate in your dependency tree depends on `alloc` then you must have " -"exactly one global allocator defined in your binary. Usually this is done in " -"the top-level binary crate." +"A tool called `gnrt` knows how to download crates and how to generate `BUILD." +"gn` rules." msgstr "" -"もし依存関係にあるクレートが`alloc`に依存する場合、必ずバイナリファイルあたり" -"一つだけのグローバルなアロケータが存在するようにしなければなりません。通常、" -"これはトップレベルのバイナリを生成するクレートにより制御されます。" +"`gnrt` というツールは、クレートのダウンロード方法と `BUILD.gn` ルールの生成方" +"法を把握しています。" -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/downloading-crates.md +msgid "To start, download the crate you want like this:" +msgstr "まず、必要なクレートを次のようにダウンロードします。" + +#: src/chromium/adding-third-party-crates/downloading-crates.md msgid "" -"`extern crate panic_halt as _` is necessary to ensure that the `panic_halt` " -"crate is linked in so we get its panic handler." +"Although the `gnrt` tool is part of the Chromium source code, by running " +"this command you will be downloading and running its dependencies from " +"`crates.io`. See [the earlier section](../cargo.md) discussing this security " +"decision." msgstr "" -"`extern crate panic_halt as _` という部分は、`panic_halt`クレートを確実にリン" -"クし、パニックハンドラを利用可能にするために必要です。" +"`gnrt` ツールは Chromium のソースコードの一部ですが、このコマンドを実行する" +"と、`crates.io` から依存関係をダウンロードして実行します。これに関するセキュ" +"リティ上の決定については、[前のセクション](../cargo.md) をご覧ください。" -#: src/bare-metal/alloc.md -msgid "This example will build but not run, as it doesn't have an entry point." -msgstr "" -"この例で示したコードはビルドできますが、エントリポイントがないので実行するこ" -"とはできません。" +#: src/chromium/adding-third-party-crates/downloading-crates.md +msgid "This `vendor` command may download:" +msgstr "この `vendor` コマンドにより、以下がダウンロードされる場合があります。" -#: src/bare-metal/microcontrollers.md -msgid "" -"The `cortex_m_rt` crate provides (among other things) a reset handler for " -"Cortex M microcontrollers." -msgstr "" -"`cortex_m_rt`クレートはCortex Mマイクロコントローラ向けのリセットハンドラ（と" -"その他もろもろ）を提供します。" +#: src/chromium/adding-third-party-crates/downloading-crates.md +#, fuzzy +msgid "Your crate" +msgstr "あなたのクレート" -#: src/bare-metal/microcontrollers.md +#: src/chromium/adding-third-party-crates/downloading-crates.md +msgid "Direct and transitive dependencies" +msgstr "直接的および推移的依存関係" + +#: src/chromium/adding-third-party-crates/downloading-crates.md msgid "" -"Next we'll look at how to access peripherals, with increasing levels of " -"abstraction." +"New versions of other crates, as required by `cargo` to resolve the complete " +"set of crates required by Chromium." msgstr "" -"次は、抽象度の低いレベルから順に周辺I/Oにアクセスする方法について見ていきま" -"す。" +" `cargo` によって指示される、Chromium で必要となるクレートの完全セットを得る" +"ための他のクレートの新しいバージョン。" -#: src/bare-metal/microcontrollers.md +#: src/chromium/adding-third-party-crates/downloading-crates.md msgid "" -"The `cortex_m_rt::entry` macro requires that the function have type `fn() -" -"> !`, because returning to the reset handler doesn't make sense." +"Chromium maintains patches for some crates, kept in `//third_party/rust/" +"chromium_crates_io/patches`. These will be reapplied automatically, but if " +"patching fails you may need to take manual action." msgstr "" -"リセットハンドラはリターンしないので、`cortex_m_rt::entry`マクロは対象関数が" -"`fn() -> !`という型であることを要求します。" - -#: src/bare-metal/microcontrollers.md -msgid "Run the example with `cargo embed --bin minimal`" -msgstr "この例は`cargo embed --bin minimal`により実行します" +"Chromium では、一部のクレートに対するパッチが `//third_party/rust/" +"chromium_crates_io/patches` に保存されています。これらは自動的に再適用されま" +"すが、パッチ適用が失敗した場合は、手動による解決が必要になる場合があります。" -#: src/bare-metal/microcontrollers/mmio.md +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "" -"Most microcontrollers access peripherals via memory-mapped IO. Let's try " -"turning on an LED on our micro:bit:" +"Once you've downloaded the crate, generate the `BUILD.gn` files like this:" msgstr "" -"大半のマイクロコントローラはメモリマップドRIO空間を通して周辺I/Oにアクセスし" -"ます。micro:bitのLEDを光らせてみましょう:" - -#: src/bare-metal/microcontrollers/mmio.md -msgid "/// GPIO port 0 peripheral address\n" -msgstr "/// GPIO 0 番ポートの周辺アドレス\n" - -#: src/bare-metal/microcontrollers/mmio.md -msgid "// GPIO peripheral offsets\n" -msgstr "// GPIO 周辺機器オフセット\n" - -#: src/bare-metal/microcontrollers/mmio.md -msgid "// PIN_CNF fields\n" -msgstr "// PIN_CNF フィールド\n" +"クレートをダウンロードしたら、以下のように `BUILD.gn` ファイルを作成します。" -#: src/bare-metal/microcontrollers/mmio.md -#: src/bare-metal/microcontrollers/pacs.md -#: src/bare-metal/microcontrollers/hals.md -msgid "// Configure GPIO 0 pins 21 and 28 as push-pull outputs.\n" -msgstr "" -"// GPIO 0 の 21 番ピンと 28 番ピンをプッシュプル出力として設定します。\n" +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +msgid "Now run `git status`. You should find:" +msgstr "`git status` を実行し、以下を確認します。" -#: src/bare-metal/microcontrollers/mmio.md +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "" -"// Safe because the pointers are to valid peripheral control registers, and\n" -" // no aliases exist.\n" +"At least one new crate source code in `third_party/rust/chromium_crates_io/" +"vendor`" msgstr "" -"// ポインタは有効な周辺機器制御レジスタを指しており、\n" -" // エイリアスが存在しないため、安全です。\n" - -#: src/bare-metal/microcontrollers/mmio.md -#: src/bare-metal/microcontrollers/pacs.md -#: src/bare-metal/microcontrollers/hals.md -msgid "// Set pin 28 low and pin 21 high to turn the LED on.\n" -msgstr "// 28 番ピンをロー、21 番ピンをハイに設定して LED をオンにします。\n" +"`third_party/rust/chromium_crates_io/vendor` に 1 つ以上の新しいクレート ソー" +"スコードがあること" -#: src/bare-metal/microcontrollers/mmio.md +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "" -"GPIO 0 pin 21 is connected to the first column of the LED matrix, and pin 28 " -"to the first row." +"At least one new `BUILD.gn` in `third_party/rust//v`" msgstr "" -"GPIO 0のピン21はマトリクスLEDの一番目の列に、ピン28は最初の行に接続されていま" -"す。" - -#: src/bare-metal/microcontrollers/mmio.md -#: src/bare-metal/microcontrollers/pacs.md -#: src/bare-metal/microcontrollers/hals.md -#: src/bare-metal/microcontrollers/board-support.md -msgid "Run the example with:" -msgstr "例の実行方法:" +"`third_party/rust//v` に 1 つ以上の新しい " +"`BUILD.gn` があること" -#: src/bare-metal/microcontrollers/pacs.md -msgid "Peripheral Access Crates" -msgstr "周辺I/Oへアクセスするためのクレート（PACs）" +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +msgid "An appropriate `README.chromium`" +msgstr "適切な `README.chromium` があること" -#: src/bare-metal/microcontrollers/pacs.md +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +#, fuzzy msgid "" -"[`svd2rust`](https://crates.io/crates/svd2rust) generates mostly-safe Rust " -"wrappers for memory-mapped peripherals from [CMSIS-SVD](https://www.keil.com/" -"pack/doc/CMSIS/SVD/html/index.html) files." +"The \"major semver version\" is a [Rust \"semver\" version number](https://" +"doc.rust-lang.org/cargo/reference/semver.html)." msgstr "" -"[`svd2rust`](https://crates.io/crates/svd2rust) は[CMSIS-SVD](https://www." -"keil.com/pack/doc/CMSIS/SVD/html/index.html) ファイルから、メモリマップされた" -"周辺I/Oに対するほぼ安全（mostly-safe）なRustラッパーを生成します。" +"[workspaces](https://doc.rust-lang.org/cargo/reference/workspaces.html)（ワー" +"クスペース）" -#: src/bare-metal/microcontrollers/pacs.md +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "" -"SVD (System View Description) files are XML files typically provided by " -"silicon vendors which describe the memory map of the device." -msgstr "" -"SVD (System View Description)ファイルはXMLファイルでデバイスのメモリマップを" -"記述したものであり、通常シリコンベンダにより提供されます。" +"Take a close look, especially at the things generated in `third_party/rust`." +msgstr "特に `third_party/rust` 以下に生成されるものをよく確認してください。" -#: src/bare-metal/microcontrollers/pacs.md +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "" -"They are organised by peripheral, register, field and value, with names, " -"descriptions, addresses and so on." +"Talk a little about semver --- and specifically the way that in Chromium " +"it's to allow multiple incompatible versions of a crate, which is " +"discouraged but sometimes necessary in the Cargo ecosystem." msgstr "" -"周辺I/Oごとに、レジスタ、フィールドと値、名前、説明、アドレスなどにより構成さ" -"れています。" +"semver について、特に Chromium では互換性のないクレートのバージョンが複数許可" +"されることを説明しておきましょう。これは推奨されませんが、Cargo エコシステム" +"で必要になることがあります。" -#: src/bare-metal/microcontrollers/pacs.md +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "" -"SVD files are often buggy and incomplete, so there are various projects " -"which patch the mistakes, add missing details, and publish the generated " -"crates." +"If your build fails, it may be because of a `build.rs`: programs which do " +"arbitrary things at build time. This is fundamentally at odds with the " +"design of `gn` and `ninja` which aim for static, deterministic, build rules " +"to maximize parallelism and repeatability of builds." msgstr "" -"SVDファイルにはよく誤りがあり、また情報が不足していることも多いので、様々なプ" -"ロジェクトがそれを修正・追加し、クレートとして公開しています。" - -#: src/bare-metal/microcontrollers/pacs.md -msgid "`cortex-m-rt` provides the vector table, among other things." -msgstr "`cortex-m-rt`はベクタテーブルも提供します。" +"ビルドが失敗した場合、`build.rs`（ビルド時に任意の処理を行うプログラム）が原" +"因である可能性があります。これは、ビルドの並列性と再現性を最大化するために静" +"的で決定的なビルドルールを目指す `gn` と `ninja` の設計とは、基本的に矛盾して" +"います。" -#: src/bare-metal/microcontrollers/pacs.md +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "" -"If you `cargo install cargo-binutils` then you can run `cargo objdump --bin " -"pac -- -d --no-show-raw-insn` to see the resulting binary." +"Some `build.rs` actions are automatically supported; others require action:" msgstr "" -"もし`cargo install cargo-binutils`を実行していれば、`cargo objdump --bin pac " -"-- -d --no-show-raw-insn`を実行することにより生成されたバイナリの中身を見るこ" -"とができます。" +"一部の `build.rs` アクションは自動的にサポートされますが、他のアクションには" +"対応が必要です。" -#: src/bare-metal/microcontrollers/hals.md -msgid "HAL crates" -msgstr "HALクレート" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "build script effect" +msgstr "ビルド スクリプトの効果" -#: src/bare-metal/microcontrollers/hals.md -msgid "" -"[HAL crates](https://github.com/rust-embedded/awesome-embedded-rust#hal-" -"implementation-crates) for many microcontrollers provide wrappers around " -"various peripherals. These generally implement traits from [`embedded-hal`]" -"(https://crates.io/crates/embedded-hal)." -msgstr "" -"多くのマイクロコントローラに対する[HALクレート](https://github.com/rust-" -"embedded/awesome-embedded-rust#hal-implementation-crates)が様々な周辺I/Oに対" -"するラッパーを提供しています。これらのクレートの多くは[`embedded-hal`]" -"(https://crates.io/crates/embedded-hal)が定義するトレイトを実装しています。" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Supported by our gn templates" +msgstr "gn テンプレートによるサポート" -#: src/bare-metal/microcontrollers/hals.md -msgid "// Create HAL wrapper for GPIO port 0.\n" -msgstr "// GPIO 0 番ポートの HAL ラッパーを作成します。\n" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Work required by you" +msgstr "必要な作業" -#: src/bare-metal/microcontrollers/hals.md -msgid "" -"`set_low` and `set_high` are methods on the `embedded_hal` `OutputPin` trait." -msgstr "" -"`set_low`と`set_high`は`embedded_hal`の`OutputPin`トレイトの定義するメソッド" -"です。" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Checking rustc version to configure features on and off" +msgstr "rustc のバージョンを確認して機能を有効または無効にする" -#: src/bare-metal/microcontrollers/hals.md -msgid "" -"HAL crates exist for many Cortex-M and RISC-V devices, including various " -"STM32, GD32, nRF, NXP, MSP430, AVR and PIC microcontrollers." -msgstr "" -"Cortex-MやRISC-Vの多くのデバイスに対してHALクレートが存在し、これらには" -"STM32、GD32、nRF、NXP、MSP430、AVR、PICマイクロコントローラなどが含まれます。" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Yes" +msgstr "はい" -#: src/bare-metal/microcontrollers/board-support.md -msgid "Board support crates" -msgstr "ボードサポートクレート" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "None" +msgstr "なし" -#: src/bare-metal/microcontrollers/board-support.md -msgid "" -"Board support crates provide a further level of wrapping for a specific " -"board for convenience." -msgstr "" -"ボードサポートクレードは特定のボードに対して更に利便性を向上させるラッパーを" -"提供します。" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Checking platform or CPU to configure features on and off" +msgstr "プラットフォームまたは CPU を確認して機能を有効または無効にする" -#: src/bare-metal/microcontrollers/board-support.md -msgid "" -"In this case the board support crate is just providing more useful names, " -"and a bit of initialisation." -msgstr "" -"この例では、ボードサポートクレートは単に分かりやすい名前を提供し、少しの初期" -"化を実施しているだけです。" +#: src/chromium/adding-third-party-crates/resolving-problems.md +#, fuzzy +msgid "Generating code" +msgstr "コードの生成" -#: src/bare-metal/microcontrollers/board-support.md -msgid "" -"The crate may also include drivers for some on-board devices outside of the " -"microcontroller itself." -msgstr "" -"マイクロコントローラの外に実装されたオンボードデバイスに対するドライバも提供" -"されていることがあります。" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Yes - specify in `gnrt_config.toml`" +msgstr "あり - `gnrt_config.toml` で指定する" -#: src/bare-metal/microcontrollers/board-support.md -msgid "`microbit-v2` includes a simple driver for the LED matrix." -msgstr "`microbit-v2`はマトリクスLEDに対する簡単なドライバを含んでいます。" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Building C/C++" +msgstr "C/C++ のビルド" -#: src/bare-metal/microcontrollers/type-state.md -msgid "The type state pattern" -msgstr "タイプステートパターン" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "No" +msgstr "いいえ" -#: src/bare-metal/microcontrollers/type-state.md -msgid "// let gpio0_01_again = gpio0.p0_01; // Error, moved.\n" -msgstr "// let gpio0_01_again = gpio0.p0_01; // エラー、移動済み。\n" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Patch around it" +msgstr "パッチを適用する" -#: src/bare-metal/microcontrollers/type-state.md -msgid "// pin_input.is_high(); // Error, moved.\n" -msgstr "// pin_input.is_high(); // エラー、移動済み。\n" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Arbitrary other actions" +msgstr "その他の任意のアクション" -#: src/bare-metal/microcontrollers/type-state.md +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "" -"Pins don't implement `Copy` or `Clone`, so only one instance of each can " -"exist. Once a pin is moved out of the port struct nobody else can take it." +"Fortunately, most crates don't contain a build script, and fortunately, most " +"build scripts only do the top two actions." msgstr "" -"この例では、ピンを表すタイプは`Copy`も`Clone`も実装していません。そのため、た" -"だ一つのインスタンスだけが存在可能です。ピンがポート構造体からムーブされる" -"と、他の誰もそのピンにアクセスすることはできなくなります。" +"幸い、ほとんどのクレートにはビルド スクリプトが含まれておらず、ほとんどのビル" +"ド スクリプトは上位 2 つのアクションのみを実行します。" -#: src/bare-metal/microcontrollers/type-state.md +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md msgid "" -"Changing the configuration of a pin consumes the old pin instance, so you " -"can’t keep use the old instance afterwards." +"If `ninja` complains about missing files, check the `build.rs` to see if it " +"writes source code files." msgstr "" -"ピンの設定を変更することは古いピンのインスタンスを消費することになります。そ" -"のため、それ以降は古いインスタンスを使い続けることはできなくなります。" +"`ninja`がファイルを見つけられないというメッセージを表示する場合は、`build." +"rs` がソースコード ファイルを作成しているかどうかを確認します。" -#: src/bare-metal/microcontrollers/type-state.md +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md msgid "" -"The type of a value indicates the state that it is in: e.g. in this case, " -"the configuration state of a GPIO pin. This encodes the state machine into " -"the type system, and ensures that you don't try to use a pin in a certain " -"way without properly configuring it first. Illegal state transitions are " -"caught at compile time." +"If so, modify [`gnrt_config.toml`](../configuring-gnrt-config-toml.md) to " +"add `build-script-outputs` to the crate. If this is a transitive dependency, " +"that is, one on which Chromium code should not directly depend, also add " +"`allow-first-party-usage=false`. There are several examples already in that " +"file:" msgstr "" -"変数の型はその状態を表すようになっています。例えば、この例では型がGPIOピンの" -"状態を表しています。このようにステートマシンをタイプシステムに織り込むこと" -"で、正しい設定をせずにピンを使ってしまうことがなくなります。不正な状態遷移に" -"関してはコンパイル時に発見されるようになります。" +"もしファイルが作成されるようになっていたら、[`gnrt_config.toml`](../" +"configuring-gnrt-config-toml.md) を変更して、クレートに `build-script-" +"outputs` を追加します。これが推移的依存関係（Chromium コードが直接依存すべき" +"でない依存関係）の場合は、`allow-first-party-usage=false` も追加します。この" +"ファイルには、すでにいくつかの例が含まれています。" -#: src/bare-metal/microcontrollers/type-state.md +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md msgid "" -"You can call `is_high` on an input pin and `set_high` on an output pin, but " -"not vice-versa." +"```toml\n" +"[crate.unicode-linebreak]\n" +"allow-first-party-usage = false\n" +"build-script-outputs = [\"tables.rs\"]\n" +"```" msgstr "" -"インプットピンに対して`is_high`を呼び出すことは可能で、アウトプットピンに対し" -"て`set_high`を呼び出すことも可能です。しかし、その逆の組み合わせは不可能で" -"す。" - -#: src/bare-metal/microcontrollers/type-state.md -msgid "Many HAL crates follow this pattern." -msgstr "多くのHALクレートがこのパターンを用いています。" +"```toml\n" +"[crate.unicode-linebreak]\n" +"allow-first-party-usage = false\n" +"build-script-outputs = [\"tables.rs\"]\n" +"```" -#: src/bare-metal/microcontrollers/embedded-hal.md +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md msgid "" -"The [`embedded-hal`](https://crates.io/crates/embedded-hal) crate provides a " -"number of traits covering common microcontroller peripherals." +"Now rerun [`gnrt.py -- gen`](../generating-gn-build-rules.md) to regenerate " +"`BUILD.gn` files to inform ninja that this particular output file is input " +"to subsequent build steps." msgstr "" -"[`embedded-hal`](https://crates.io/crates/embedded-hal)クレートはマイクロコン" -"トローラの周辺I/Oに関して共通に必要とされる多くのトレイトを提供します。" - -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "GPIO" -msgstr "GPIO" - -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "ADC" -msgstr "ADC" +"次に、[`gnrt.py -- gen`](../generating-gn-build-rules.md) を再実行して " +"`BUILD.gn` ファイルを再生成し、この特定の出力ファイルが後続のビルドステップで" +"入力されることを ninja に教えます。" -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "I2C, SPI, UART, CAN" -msgstr "I2C、SPI、UART、CAN" +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md +msgid "" +"Some crates use the [`cc`](https://crates.io/crates/cc) crate to build and " +"link C/C++ libraries. Other crates parse C/C++ using [`bindgen`](https://" +"crates.io/crates/bindgen) within their build scripts. These actions can't be " +"supported in a Chromium context --- our gn, ninja and LLVM build system is " +"very specific in expressing relationships between build actions." +msgstr "" +"一部のクレートは、[`cc`](https://crates.io/crates/cc) クレートを使用して、" +"C / C++ ライブラリのビルドとリンクを行います。他のクレートは、ビルド スクリプ" +"ト内で [`bindgen`](https://crates.io/crates/bindgen) を使用して C / C++ を解" +"析します。これらのアクションは、Chromium のコンテキストではサポートできませ" +"ん。Chromiumの gn、ninja、LLVM ビルドシステムは、ビルド アクション間の関係を" +"非常に具体的に表現するためです。" -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "RNG" -msgstr "RNG" +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md +msgid "So, your options are:" +msgstr "したがって、次のようなオプションがあります。" -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "Timers" -msgstr "タイマー" +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md +msgid "Avoid these crates" +msgstr "これらのクレートを使用しない" -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "Watchdogs" -msgstr "ウォッチドッグ" +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md +msgid "Apply a patch to the crate." +msgstr "クレートにパッチを適用する" -#: src/bare-metal/microcontrollers/embedded-hal.md +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md msgid "" -"Other crates then implement [drivers](https://github.com/rust-embedded/" -"awesome-embedded-rust#driver-crates) in terms of these traits, e.g. an " -"accelerometer driver might need an I2C or SPI bus implementation." +"Patches should be kept in `third_party/rust/chromium_crates_io/patches/" +"` - see for example the [patches against the `cxx` crate](https://" +"source.chromium.org/chromium/chromium/src/+/main:third_party/rust/" +"chromium_crates_io/patches/cxx/) - and will be applied automatically by " +"`gnrt` each time it upgrades the crate." msgstr "" -"多くのクレートはこれらのトレイトに対応することで[ドライバ](https://github." -"com/rust-embedded/awesome-embedded-rust#driver-crates)を実装します。例えば、" -"加速度センサのドライバにはI2CやSPIバスの実装が必要かもしれません。" +"パッチは `third_party/rust/chromium_crates_io/patches/` に保存する必要" +"があります。たとえば、[`cxx` クレートに対するパッチ](https://source.chromium." +"org/chromium/chromium/src/+/main:third_party/rust/chromium_crates_io/patches/" +"cxx/) をご覧ください。また、パッチはクレートがアップグレードされるたびに " +"`gnrt` によって自動的に適用されます。" -#: src/bare-metal/microcontrollers/embedded-hal.md +#: src/chromium/adding-third-party-crates/depending-on-a-crate.md msgid "" -"There are implementations for many microcontrollers, as well as other " -"platforms such as Linux on Raspberry Pi." +"Once you've added a third-party crate and generated build rules, depending " +"on a crate is simple. Find your `rust_static_library` target, and add a " +"`dep` on the `:lib` target within your crate." msgstr "" -"多くのマイクロコントローラに対する実装に加えて、Raspberry Pi上のLinux向けの実" -"装も存在します。" +"サードパーティ クレートを追加してビルドルールを生成したら、クレートへの依存を" +"簡単に設定できます。`rust_static_library` ターゲットを見つけて、クレート内の " +"`:lib` ターゲットに `dep` を追加します。" -#: src/bare-metal/microcontrollers/embedded-hal.md +#: src/chromium/adding-third-party-crates/depending-on-a-crate.md +msgid "Specifically," +msgstr "具体的には次のようにします。" + +#: src/chromium/adding-third-party-crates/depending-on-a-crate.md msgid "" -"There is work in progress on an `async` version of `embedded-hal`, but it " -"isn't stable yet." +"```bob\n" +" +------------+ +----------------------+\n" +"\"//third_party/rust\" | crate name | \"/v\" | major semver version | \":" +"lib\"\n" +" +------------+ +----------------------+\n" +"```" msgstr "" -"`embedded-hal`の`async`バージョンも開発中ですが、まだ安定してはいません。" +"```bob\n" +" +------------+ +------------------------------+\n" +"\"//third_party/rust\" | クレート名 | \"/v\" | semver のメジャー バージョン " +"| \":lib\"\n" +" +------------+ +------------------------------+\n" +"```" -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/chromium/adding-third-party-crates/depending-on-a-crate.md msgid "" -"[probe-rs](https://probe.rs/) is a handy toolset for embedded debugging, " -"like OpenOCD but better integrated." -msgstr "" -"[probe-rs](https://probe.rs/)は組み込み向けデバッグに有用なツールセットです。" -"これはOpenOCDのようなものですが、より高度に統合されています。" - -#: src/bare-metal/microcontrollers/probe-rs.md -msgid "" -"SWD (Serial Wire Debug) and JTAG via CMSIS-DAP, ST-Link and J-Link probes" +"```gn\n" +"rust_static_library(\"my_rust_lib\") {\n" +" crate_root = \"lib.rs\"\n" +" sources = [ \"lib.rs\" ]\n" +" deps = [ \"//third_party/rust/example_rust_crate/v1:lib\" ]\n" +"}\n" +"```" msgstr "" -"SWD (Serial Wire Debug) やCMSIS-DAP経由のJTAG、 ST-LinkやJ-Linkプローブ" - -#: src/bare-metal/microcontrollers/probe-rs.md -msgid "GDB stub and Microsoft DAP (Debug Adapter Protocol) server" -msgstr "GDBスタブやMicrosoft DAP (Debug Adapter Protocol)サーバ" +"```gn\n" +"rust_static_library(\"my_rust_lib\") {\n" +" crate_root = \"lib.rs\"\n" +" sources = [ \"lib.rs\" ]\n" +" deps = [ \"//third_party/rust/example_rust_crate/v1:lib\" ]\n" +"}\n" +"```" -#: src/bare-metal/microcontrollers/probe-rs.md -msgid "Cargo integration" -msgstr "Cargoとのインテグレーション" +#: src/chromium/adding-third-party-crates/reviews-and-audits.md +msgid "Auditing Third Party Crates" +msgstr "サードパーティ クレートの監査" -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"`cargo-embed` is a cargo subcommand to build and flash binaries, log RTT " -"(Real Time Transfers) output and connect GDB. It's configured by an `Embed." -"toml` file in your project directory." +"Adding new libraries is subject to Chromium's standard [policies](https://" +"chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/rust." +"md#Third_party-review), but of course also subject to security review. As " +"you may be bringing in not just a single crate but also transitive " +"dependencies, there may be a lot of code to review. On the other hand, safe " +"Rust code can have limited negative side effects. How should you review it?" msgstr "" -"`cargo-embed`はcargoのサブコマンドであり、バイナリをビルドしたり、フラッシュ" -"したり、RTT（Real Time Transfers）の出力ログを取得したり、GDBに接続するための" -"ものです。設定は対象とするプロジェクトディレクトリにおける`Embed.toml`ファイ" -"ルにより行います。" +"新しいライブラリを追加する場合、Chromium の標準の [ポリシー](https://" +"chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/rust." +"md#Third_party-review) が適用されますが、当然ながらセキュリティ審査の対象にも" +"なります。1 つのクレートだけでなく推移的依存関係も取り込む場合、審査すべき" +"コードが多数存在することがあります。その一方で、安全な Rust コードの取り込み" +"に関しては、悪い副作用は限定的となります。クレートの審査はどのように行われる" +"べきでしょうか。" -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"[CMSIS-DAP](https://arm-software.github.io/CMSIS_5/DAP/html/index.html) is " -"an Arm standard protocol over USB for an in-circuit debugger to access the " -"CoreSight Debug Access Port of various Arm Cortex processors. It's what the " -"on-board debugger on the BBC micro:bit uses." +"Over time Chromium aims to move to a process based around [cargo vet]" +"(https://mozilla.github.io/cargo-vet/)." msgstr "" -"[CMSIS-DAP](https://arm-software.github.io/CMSIS_5/DAP/html/index.html) はUSB" -"上のARM標準プロトコルで、インサーキット・デバッガが様々なArm Cortexプロセッサ" -"のコアサイト・デバッグ・アクセスポートにアクセスするためのものです。BBC " -"micro:bit のオンボード・デバッガもこれを利用しています。" +"Chromium は今後 [cargo vet](https://mozilla.github.io/cargo-vet/) を中心とし" +"たプロセスに移行されていく予定ですが、" -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"ST-Link is a range of in-circuit debuggers from ST Microelectronics, J-Link " -"is a range from SEGGER." +"Meanwhile, for each new crate addition, we are checking for the following:" msgstr "" -"ST-Link はST Microelectronicsによるインサーキット・デバッガの総称で、 J-Link" -"はSEGGERによるインサーキット・デバッガの総称です。" +"それまでの間、新しいクレートが追加されるたびに、以下のチェックを行います。" -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"The Debug Access Port is usually either a 5-pin JTAG interface or 2-pin " -"Serial Wire Debug." +"Understand why each crate is used. What's the relationship between crates? " +"If the build system for each crate contains a `build.rs` or procedural " +"macros, work out what they're for. Are they compatible with the way Chromium " +"is normally built?" msgstr "" -"デバッグ・アクセスポートは通常５ピンのJTAGインタフェースか、2ピンのシリアルワ" -"イヤデバッグです。" +"各クレートが使用されている理由と、クレート同士の関係を理解します。各クレート" +"のビルドシステムに`build.rs` または手続き型マクロが含まれている場合は、その目" +"的を調べます。また、Chromium の通常のビルド方法と互換性があるかどうかも確認し" +"ます。" -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md +msgid "Check each crate seems to be reasonably well maintained" +msgstr "各クレートが十分にメンテナンスされているか確認します。" + +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"probe-rs is a library which you can integrate into your own tools if you " -"want to." +"Use `cd third-party/rust/chromium_crates_io; cargo audit` to check for known " +"vulnerabilities (first you'll need to `cargo install cargo-audit`, which " +"ironically involves downloading lots of dependencies from the internet[2](../" +"cargo.md))" msgstr "" -"probe-rsは自分で独自のツールを統合したい場合に利用できるライブラリです。" +"`cd third-party/rust/chromium_crates_io; cargo audit` を使用して既知の脆弱性" +"をチェックします（最初に `cargo install cargo-audit` を実行する必要があります" +"が、皮肉なことに、これによってインターネットから多くの依存関係をダウンロード" +"することになります [2](../cargo.md)）。" -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"The [Microsoft Debug Adapter Protocol](https://microsoft.github.io/debug-" -"adapter-protocol/) lets VSCode and other IDEs debug code running on any " -"supported microcontroller." +"Ensure any `unsafe` code is good enough for the [Rule of Two](https://" +"chromium.googlesource.com/chromium/src/+/main/docs/security/rule-of-2." +"md#unsafe-code-in-safe-languages)" msgstr "" -"[Microsoft Debug Adapter Protocol](https://microsoft.github.io/debug-adapter-" -"protocol/) はVSCodeや他のIDEから、サポートされたマイクロコントローラ上で実行" -"されているコードをデバッグすることを可能にします。" +"`unsafe` なコードが [Rule of Two](https://chromium.googlesource.com/chromium/" +"src/+/main/docs/security/rule-of-2.md#unsafe-code-in-safe-languages) を満たし" +"ていることを確認します。" -#: src/bare-metal/microcontrollers/probe-rs.md -msgid "cargo-embed is a binary built using the probe-rs library." -msgstr "cargo-embedはprobe-rsライブラリを利用して生成されたバイナリです。" +#: src/chromium/adding-third-party-crates/reviews-and-audits.md +msgid "Check for any use of `fs` or `net` APIs" +msgstr "`fs`および`net`のAPI が使用されているかどうかを確認します。" -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"RTT (Real Time Transfers) is a mechanism to transfer data between the debug " -"host and the target through a number of ringbuffers." +"Read all the code at a sufficient level to look for anything out of place " +"that might have been maliciously inserted. (You can't realistically aim for " +"100% perfection here: there's often just too much code.)" msgstr "" -"RTT (Real Time Transfers)はデバッグホストとターゲット間のデータを多くのリング" -"バッファを介してやりとりするためのメカニズムです。" - -#: src/bare-metal/microcontrollers/debugging.md -msgid "_Embed.toml_:" -msgstr "_Embed.toml_:" +"悪意を持って不正に挿入された可能性のある部分がないか探すのに十分なレベルで" +"コードを読みます（多くの場合、コードが多すぎて完璧にチェックすることはできま" +"せん）。" -#: src/bare-metal/microcontrollers/debugging.md -msgid "In one terminal under `src/bare-metal/microcontrollers/examples/`:" +#: src/chromium/adding-third-party-crates/reviews-and-audits.md +msgid "" +"These are just guidelines --- work with reviewers from `security@chromium." +"org` to work out the right way to become confident of the crate." msgstr "" -"ひとつのターミナルで、`src/bare-metal/microcontrollers/examples/`において下記" -"を実行:" - -#: src/bare-metal/microcontrollers/debugging.md -msgid "In another terminal in the same directory:" -msgstr "別のターミナルで、同じディレクトリで下記を実行:" - -#: src/bare-metal/microcontrollers/debugging.md -msgid "On gLinux or Debian:" -msgstr "gLinuxまたはDebianの場合:" - -#: src/bare-metal/microcontrollers/debugging.md -msgid "In GDB, try running:" -msgstr "GDBで下記を実行してみてください:" +"これらはガイドラインにすぎません。`security@chromium.org` の審査担当者と協力" +"して、自信を持ってクレートを使用するための適切な方法を見つけてください。" -#: src/bare-metal/microcontrollers/other-projects.md -#: src/bare-metal/aps/other-projects.md -msgid "Other projects" -msgstr "他のプロジェクト" +#: src/chromium/adding-third-party-crates/checking-in.md +msgid "Checking Crates into Chromium Source Code" +msgstr "クレートを Chromium ソースコードにチェックインする" -#: src/bare-metal/microcontrollers/other-projects.md -msgid "[RTIC](https://rtic.rs/)" -msgstr "[RTIC](https://rtic.rs/)" +#: src/chromium/adding-third-party-crates/checking-in.md +msgid "`git status` should reveal:" +msgstr "`git status` を実行すると、以下を確認できます。" -#: src/bare-metal/microcontrollers/other-projects.md -msgid "\"Real-Time Interrupt-driven Concurrency\"" -msgstr "\"Real-Time Interrupt-driven Concurrency\"の略" +#: src/chromium/adding-third-party-crates/checking-in.md +msgid "Crate code in `//third_party/rust/chromium_crates_io`" +msgstr "`//third_party/rust/chromium_crates_io` にあるクレートコード" -#: src/bare-metal/microcontrollers/other-projects.md +#: src/chromium/adding-third-party-crates/checking-in.md msgid "" -"Shared resource management, message passing, task scheduling, timer queue" +"Metadata (`BUILD.gn` and `README.chromium`) in `//third_party/rust//" +"`" msgstr "" -"共有リソース管理、メッセージパッシング、タスクスケジューリング、タイマキュー" -"を提供" - -#: src/bare-metal/microcontrollers/other-projects.md -msgid "[Embassy](https://embassy.dev/)" -msgstr "[Embassy](https://embassy.dev/)" - -#: src/bare-metal/microcontrollers/other-projects.md -msgid "`async` executors with priorities, timers, networking, USB" -msgstr "優先度付き`async` エグゼキュータ、タイマ、ネットワーク、USB" +"`//third_party/rust//` にあるメタデータ（`BUILD.gn` と " +"`README.chromium`）" -#: src/bare-metal/microcontrollers/other-projects.md -msgid "[TockOS](https://www.tockos.org/documentation/getting-started)" -msgstr "[TockOS](https://www.tockos.org/documentation/getting-started)" +#: src/chromium/adding-third-party-crates/checking-in.md +msgid "Please also add an `OWNERS` file in the latter location." +msgstr "後者の場所に `OWNERS` ファイルも追加してください。" -#: src/bare-metal/microcontrollers/other-projects.md +#: src/chromium/adding-third-party-crates/checking-in.md msgid "" -"Security-focused RTOS with preemptive scheduling and Memory Protection Unit " -"support" +"You should land all this, along with your `Cargo.toml` and `gnrt_config." +"toml` changes, into the Chromium repo." msgstr "" -"セキュリティに焦点をあてたRTOSで、プリエンプティブ・スケジューリングとMemory " -"Protection Unitをサポート" - -#: src/bare-metal/microcontrollers/other-projects.md -msgid "[Hubris](https://hubris.oxide.computer/)" -msgstr "[Hubris](https://hubris.oxide.computer/)" +"これらすべてを、`Cargo.toml` および `gnrt_config.toml` の変更とともに " +"Chromium リポジトリに追加する必要があります。" -#: src/bare-metal/microcontrollers/other-projects.md +#: src/chromium/adding-third-party-crates/checking-in.md msgid "" -"Microkernel RTOS from Oxide Computer Company with memory protection, " -"unprivileged drivers, IPC" +"**Important**: you need to use `git add -f` because otherwise `.gitignore` " +"files may result in some files being skipped." msgstr "" -"Oxide Computer CompanyによるマイクロカーネルのRTOSでメモリ保護、非特権ドライ" -"バ、IPCを提供" +"**重要**: `git add -f` を使用する必要があります。そうしないと、`.gitignore` " +"ファイルによって一部のファイルがスキップされる可能性があるためです。" -#: src/bare-metal/microcontrollers/other-projects.md -msgid "[Bindings for FreeRTOS](https://github.com/lobaro/FreeRTOS-rust)" +#: src/chromium/adding-third-party-crates/checking-in.md +msgid "" +"As you do so, you might find presubmit checks fail because of non-inclusive " +"language. This is because Rust crate data tends to include names of git " +"branches, and many projects still use non-inclusive terminology there. So " +"you may need to run:" msgstr "" -"[FreeRTOSに対するRustバインディング](https://github.com/lobaro/FreeRTOS-rust)" +"その際、インクルーシブでない表現が原因で presubmit チェックが失敗することがあ" +"ります。これは、Rust のクレートデータには Git ブランチの名前が含まれている傾" +"向があり、多くのプロジェクトで依然としてインクルーシブでない表現が使用されて" +"いるためです。そのため、以下を実行する必要があります。" -#: src/bare-metal/microcontrollers/other-projects.md +#: src/chromium/adding-third-party-crates/keeping-up-to-date.md msgid "" -"Some platforms have `std` implementations, e.g. [esp-idf](https://esp-rs." -"github.io/book/overview/using-the-standard-library.html)." +"As the OWNER of any third party Chromium dependency, you are [expected to " +"keep it up to date with any security fixes](https://chromium.googlesource." +"com/chromium/src/+/main/docs/adding_to_third_party.md#add-owners). It is " +"hoped that we will soon automate this for Rust crates, but for now, it's " +"still your responsibility just as it is for any other third party dependency." msgstr "" -"いくつかのプラットフォームでは `std`の実装あり、例えば [esp-idf](https://esp-" -"rs.github.io/book/overview/using-the-standard-library.html)。" +"サードパーティの Chromium 依存関係の所有者は、[セキュリティに関する修正を行っ" +"て依存関係を最新の状態に保つことが求められます](https://chromium." +"googlesource.com/chromium/src/+/main/docs/adding_to_third_party.md#add-" +"owners)。これはまもなく自動化されることが期待されていますが、現状は他のサード" +"パーティの依存関係の場合と同様に、デベロッパーがその責任を負います。" -#: src/bare-metal/microcontrollers/other-projects.md -msgid "RTIC can be considered either an RTOS or a concurrency framework." +#: src/exercises/chromium/third-party.md +msgid "" +"Add [uwuify](https://crates.io/crates/uwuify) to Chromium, turning off the " +"crate's [default features](https://doc.rust-lang.org/cargo/reference/" +"features.html#the-default-feature). Assume that the crate will be used in " +"shipping Chromium, but won't be used to handle untrustworthy input." msgstr "" -"RTICはRTOSとして捉えることもできますし、並行実行のフレームワークとして捉える" -"こともできます。" - -#: src/bare-metal/microcontrollers/other-projects.md -msgid "It doesn't include any HALs." -msgstr "他のHALを全く含んでいません。" +"Chromium に [uwuify](https://crates.io/crates/uwuify) を追加し、クレートの " +"[デフォルトの機能](https://doc.rust-lang.org/cargo/reference/features." +"html#the-default-feature) を無効にします。クレートは Chromium の公開板で使用" +"されますが、信頼できない入力の処理には使用されないと仮定してください。" -#: src/bare-metal/microcontrollers/other-projects.md +#: src/exercises/chromium/third-party.md msgid "" -"It uses the Cortex-M NVIC (Nested Virtual Interrupt Controller) for " -"scheduling rather than a proper kernel." +"(In the next exercise we'll use uwuify from Chromium, but feel free to skip " +"ahead and do that now if you like. Or, you could create a new " +"[`rust_executable` target](https://source.chromium.org/chromium/chromium/src/" +"+/main:build/rust/rust_executable.gni) which uses `uwuify`)." msgstr "" -"スケジューリングはカーネルではなく、Cortex-M NVIC (Nested Virtual Interrupt " -"Controller)を利用して行います。" +"（次の演習で Chromium の uwuify を使用しますが、ここで行っても構いません。ま" +"たは、`uwuify` を使用する新しい [`rust_executable` ターゲット](https://" +"source.chromium.org/chromium/chromium/src/+/main:build/rust/rust_executable." +"gni) を作成することもできます）。" -#: src/bare-metal/microcontrollers/other-projects.md -msgid "Cortex-M only." -msgstr "Cortex-Mのみの対応です。" +#: src/exercises/chromium/third-party.md +msgid "Students will need to download lots of transitive dependencies." +msgstr "受講者は多数の推移的依存関係をダウンロードする必要があります。" -#: src/bare-metal/microcontrollers/other-projects.md -msgid "" -"Google uses TockOS on the Haven microcontroller for Titan security keys." -msgstr "" -"GoogleはTockOSをTitanセキュリティキーのHavenマイクロコントローラで利用してい" -"ます。" +#: src/exercises/chromium/third-party.md +msgid "The total crates needed are:" +msgstr "必要なクレートは次のとおりです。" -#: src/bare-metal/microcontrollers/other-projects.md -msgid "" -"FreeRTOS is mostly written in C, but there are Rust bindings for writing " -"applications." -msgstr "" -"FreeRTOS はほとんどCで書かれていますが、アプリケーションを開発するためのRust" -"バインディングが存在します。" +#: src/exercises/chromium/third-party.md +msgid "`instant`," +msgstr "`instant`" -#: src/exercises/bare-metal/morning.md -msgid "" -"We will read the direction from an I2C compass, and log the readings to a " -"serial port." -msgstr "" -"I2C接続のコンパスから方位を読み取り、その結果をシリアルポートに出力します。" +#: src/exercises/chromium/third-party.md +msgid "`lock_api`," +msgstr "`lock_api`" + +#: src/exercises/chromium/third-party.md +msgid "`parking_lot`," +msgstr "`parking_lot`" + +#: src/exercises/chromium/third-party.md +msgid "`parking_lot_core`," +msgstr "`parking_lot_core`" + +#: src/exercises/chromium/third-party.md +msgid "`redox_syscall`," +msgstr "`redox_syscall`" + +#: src/exercises/chromium/third-party.md +msgid "`scopeguard`," +msgstr "`scopeguard`" + +#: src/exercises/chromium/third-party.md +msgid "`smallvec`, and" +msgstr "`smallvec`" + +#: src/exercises/chromium/third-party.md +msgid "`uwuify`." +msgstr "`uwuify`" -#: src/exercises/bare-metal/morning.md src/exercises/concurrency/morning.md +#: src/exercises/chromium/third-party.md msgid "" -"After looking at the exercises, you can look at the [solutions](solutions-" -"morning.md) provided." +"If students are downloading even more than that, they probably forgot to " +"turn off the default features." msgstr "" -"練習問題に取り組んだあとは、 [解答](solutions-morning.md)をみても構いません。" +"受講者が上記以外のクレートをダウンロードしている場合は、デフォルトの機能を無" +"効にするのを忘れている可能性があります。" -#: src/exercises/bare-metal/compass.md +#: src/exercises/chromium/third-party.md msgid "" -"We will read the direction from an I2C compass, and log the readings to a " -"serial port. If you have time, try displaying it on the LEDs somehow too, or " -"use the buttons somehow." +"Thanks to [Daniel Liu](https://github.com/Daniel-Liu-c0deb0t) for this crate!" msgstr "" -"I2C接続のコンパスから方位を読み取り、その結果をシリアルポートに出力します。も" -"し時間があれば、LEDやボタンをなんとか利用して方位を出力してみてください。" +"このクレートに協力してくれた [Daniel Liu](https://github.com/Daniel-Liu-" +"c0deb0t) に感謝します。" -#: src/exercises/bare-metal/compass.md -msgid "Hints:" -msgstr "ヒント:" +#: src/exercises/chromium/bringing-it-together.md +msgid "Bringing It Together --- Exercise" +msgstr "まとめ --- 演習" -#: src/exercises/bare-metal/compass.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"Check the documentation for the [`lsm303agr`](https://docs.rs/lsm303agr/" -"latest/lsm303agr/) and [`microbit-v2`](https://docs.rs/microbit-v2/latest/" -"microbit/) crates, as well as the [micro:bit hardware](https://tech.microbit." -"org/hardware/)." +"In this exercise, you're going to add a whole new Chromium feature, bringing " +"together everything you already learned." msgstr "" -"[`lsm303agr`](https://docs.rs/lsm303agr/latest/lsm303agr/) クレートと " -"[`microbit-v2`](https://docs.rs/microbit-v2/latest/microbit/)クレートのドキュ" -"メント、ならびに[micro:bitハードウェア仕様](https://tech.microbit.org/" -"hardware/)を確認してみてください。" +"この演習では、Chromium の新しい機能を追加しながら、これまで学んだことをまとめ" +"ます。" -#: src/exercises/bare-metal/compass.md -msgid "" -"The LSM303AGR Inertial Measurement Unit is connected to the internal I2C bus." -msgstr "LSM303AGR慣性計測器は内部のI2Cバスに接続されています。" +#: src/exercises/chromium/bringing-it-together.md +msgid "The Brief from Product Management" +msgstr "プロダクト マネジメント部門からのブリーフィング" -#: src/exercises/bare-metal/compass.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"TWI is another name for I2C, so the I2C master peripheral is called TWIM." -msgstr "TWIはI2Cの別名なので、I2CマスタはTWIMという名前になっています。" +"A community of pixies has been discovered living in a remote rainforest. " +"It's important that we get Chromium for Pixies delivered to them as soon as " +"possible." +msgstr "" +"人里離れた熱帯雨林に生息するピクシー（妖精の一種）の村が発見されました。ピク" +"シー向けの Chromium をできるだけ早く提供することが重要です。" -#: src/exercises/bare-metal/compass.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"The LSM303AGR driver needs something implementing the `embedded_hal::" -"blocking::i2c::WriteRead` trait. The [`microbit::hal::Twim`](https://docs.rs/" -"microbit-v2/latest/microbit/hal/struct.Twim.html) struct implements this." +"The requirement is to translate all Chromium's UI strings into Pixie " +"language." msgstr "" -"LSM303AGRドライバは`embedded_hal::blocking::i2c::WriteRead`を実装するものを必" -"要とします。 [`microbit::hal::Twim`](https://docs.rs/microbit-v2/latest/" -"microbit/hal/struct.Twim.html)構造体がこれを実装しています。" +"要件は、Chromium のすべての UI 文字列をピクシーの言語に翻訳することです。" -#: src/exercises/bare-metal/compass.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"You have a [`microbit::Board`](https://docs.rs/microbit-v2/latest/microbit/" -"struct.Board.html) struct with fields for the various pins and peripherals." +"There's not time to wait for proper translations, but fortunately pixie " +"language is very close to English, and it turns out there's a Rust crate " +"which does the translation." msgstr "" -"様々なピンや周辺I/Oのための [`microbit::Board`](https://docs.rs/microbit-v2/" -"latest/microbit/struct.Board.html)という構造体があります。" +"正式な翻訳を行っている時間はありませんが、幸いにもピクシーの言語は英語に非常" +"に近く、その翻訳を行う Rust クレートがあることがわかりました。" -#: src/exercises/bare-metal/compass.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"You can also look at the [nRF52833 datasheet](https://infocenter.nordicsemi." -"com/pdf/nRF52833_PS_v1.5.pdf) if you want, but it shouldn't be necessary for " -"this exercise." +"In fact, you already [imported that crate in the previous exercise](https://" +"crates.io/crates/uwuify)." msgstr "" -"[nRF52833データシート](https://infocenter.nordicsemi.com/pdf/" -"nRF52833_PS_v1.5.pdf)を見ることもできますが、この練習問題のためには必要ないは" -"ずです。" +"実は、[前の演習でそのクレートをインポートしています](https://crates.io/" +"crates/uwuify)。" -#: src/exercises/bare-metal/compass.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"Download the [exercise template](../../comprehensive-rust-exercises.zip) and " -"look in the `compass` directory for the following files." +"(Obviously, real translations of Chrome require incredible care and " +"diligence. Don't ship this!)" msgstr "" -"[練習問題のテンプレート](../../comprehensive-rust-exercises.zip) をダウンロー" -"ドして、`compass`というディレクトリの中にある下記のファイルを見てください。" - -#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md -msgid "_src/main.rs_:" -msgstr "_src/main.rs_:" - -#: src/exercises/bare-metal/compass.md -#: src/exercises/bare-metal/solutions-morning.md -msgid "// Configure serial port.\n" -msgstr "// シリアルポートを設定します。\n" +"（言うまでもなく、Chrome を実際に翻訳するには細心の注意と努力が必要ですので、" +"これは公開しないでください）。" -#: src/exercises/bare-metal/compass.md -#: src/exercises/bare-metal/solutions-morning.md -msgid "// Use the system timer as a delay provider.\n" -msgstr "// システム タイマーを遅延目的で使用します。\n" +#: src/exercises/chromium/bringing-it-together.md +msgid "Steps" +msgstr "手順" -#: src/exercises/bare-metal/compass.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"// Set up the I2C controller and Inertial Measurement Unit.\n" -" // TODO\n" +"Modify `ResourceBundle::MaybeMangleLocalizedString` so that it uwuifies all " +"strings before display. In this special build of Chromium, it should always " +"do this irrespective of the setting of `mangle_localized_strings_`." msgstr "" -"// I2C コントローラと慣性測定ユニットをセットアップします。\n" -" // TODO\n" - -#: src/exercises/bare-metal/compass.md -#: src/exercises/bare-metal/solutions-morning.md -msgid "\"Ready.\"" -msgstr "\"Ready.\"" +"表示前にすべての文字列を翻訳するように `ResourceBundle::" +"MaybeMangleLocalizedString` を変更します。Chromium のこの特別なビルドでは、" +"`mangle_localized_strings_` の設定に関係なく、常にこのようにします。" -#: src/exercises/bare-metal/compass.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"// Read compass data and log it to the serial port.\n" -" // TODO\n" +"If you've done everything right across all these exercises, congratulations, " +"you should have created Chrome for pixies!" msgstr "" -"// コンパスデータを読み取り、シリアルポートに記録します。\n" -" // TODO\n" - -#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md -msgid "_Cargo.toml_ (you shouldn't need to change this):" -msgstr "_Cargo.toml_ (変更は不要なはずです):" - -#: src/exercises/bare-metal/compass.md -msgid "_Embed.toml_ (you shouldn't need to change this):" -msgstr "_Embed.toml_ (変更は不要なはずです):" - -#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md -msgid "_.cargo/config.toml_ (you shouldn't need to change this):" -msgstr "_.cargo/config.toml_ (変更は不要なはずです):" - -#: src/exercises/bare-metal/compass.md -msgid "See the serial output on Linux with:" -msgstr "Linuxではシリアルポート出力を下記のコマンドで確認します:" +"ここまでの演習をすべて正しく終わらせれていれば、これでピクシー向けの Chrome " +"が完成しているはずです。" -#: src/exercises/bare-metal/compass.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"Or on Mac OS something like (the device name may be slightly different):" -msgstr "Mac OSではこんな感じになります（デバイス名が少し違うかもしれません）:" +"UTF16 vs UTF8. Students should be aware that Rust strings are always UTF8, " +"and will probably decide that it's better to do the conversion on the C++ " +"side using `base::UTF16ToUTF8` and back again." +msgstr "" +"UTF16 と UTF8 について、受講者は Rust 文字列が常に UTF8 であることに注意する" +"必要があります。おそらく、C++ 側で `base::UTF16ToUTF8` を使用して変換、逆変換" +"する方がよいと判断するでしょう。" -#: src/exercises/bare-metal/compass.md -msgid "Use Ctrl+A Ctrl+Q to quit picocom." -msgstr "Ctrl+A Ctrl+Q でpicocomを終了します。" +#: src/exercises/chromium/bringing-it-together.md +msgid "" +"If students decide to do the conversion on the Rust side, they'll need to " +"consider [`String::from_utf16`](https://doc.rust-lang.org/std/string/struct." +"String.html#method.from_utf16), consider error handling, and consider which " +"[CXX supported types can transfer a lot of u16s](https://cxx.rs/binding/" +"slice.html)." +msgstr "" +"Rust 側で変換を行う場合は、[`String::from_utf16`](https://doc.rust-lang.org/" +"std/string/struct.String.html#method.from_utf16)の利用、エラー処理、[多くの " +"u16s を転送可能な CXX でサポートされている型](https://cxx.rs/binding/slice." +"html) はどれかを検討する必要があります。" + +#: src/exercises/chromium/bringing-it-together.md +msgid "" +"Students may design the C++/Rust boundary in several different ways, e.g. " +"taking and returning strings by value, or taking a mutable reference to a " +"string. If a mutable reference is used, CXX will likely tell the student " +"that they need to use [`Pin`](https://doc.rust-lang.org/std/pin/). You may " +"need to explain what `Pin` does, and then explain why CXX needs it for " +"mutable references to C++ data: the answer is that C++ data can't be moved " +"around like Rust data, because it may contain self-referential pointers." +msgstr "" +"受講者はいくつかの異なる方法で C++ と Rust の境界を設計できます。たとえば、文" +"字列を値で取得して返す、または文字列への可変参照を取得するなどです。可変参照" +"が使用されている場合は、おそらく CXX は [`Pin`](https://doc.rust-lang.org/" +"std/pin/) を使用する必要がある旨のメッセージを表示します。`Pin` の機能を説明" +"し、C++ データへの可変参照のために CXX で `Pin` が必要になる理由を説明する必" +"要があるかもしれません。答えは、C++ データには自己参照ポインタが含まれている" +"可能性があるため、Rust データのように移動できないためです。" + +#: src/exercises/chromium/bringing-it-together.md +msgid "" +"The C++ target containing `ResourceBundle::MaybeMangleLocalizedString` will " +"need to depend on a `rust_static_library` target. The student probably " +"already did this." +msgstr "" +"`ResourceBundle::MaybeMangleLocalizedString` を含む C++ ターゲットは、" +"`rust_static_library` ターゲットに依存する必要があります。受講者はすでにこれ" +"を行っているはずです。" + +#: src/exercises/chromium/bringing-it-together.md +msgid "" +"The `rust_static_library` target will need to depend on `//third_party/rust/" +"uwuify/v0_2:lib`." +msgstr "" +"`rust_static_library` ターゲットは `//third_party/rust/uwuify/v0_2:lib` に依" +"存する必要があります。" + +#: src/exercises/chromium/solutions.md +msgid "" +"Solutions to the Chromium exercises can be found in [this series of CLs]" +"(https://chromium-review.googlesource.com/c/chromium/src/+/5096560)." +msgstr "" +"Chromium の演習の解答については、[こちらの CL シリーズ](https://chromium-" +"review.googlesource.com/c/chromium/src/+/5096560) をご覧ください。" + +#: src/bare-metal.md +msgid "Welcome to Bare Metal Rust" +msgstr "ベアメタルRustへようこそ" + +#: src/bare-metal.md +msgid "" +"This is a standalone one-day course about bare-metal Rust, aimed at people " +"who are familiar with the basics of Rust (perhaps from completing the " +"Comprehensive Rust course), and ideally also have some experience with bare-" +"metal programming in some other language such as C." +msgstr "" +"こちらはベアメタルRustに関する独立した１日コースです。対象としているのは、" +"Rustの基本的な部分に関しては習得済みな人で（例えば、本講座で）、Cなどの他の言" +"語でベアメタル開発の経験があると理想的です。" + +#: src/bare-metal.md +msgid "" +"Today we will talk about 'bare-metal' Rust: running Rust code without an OS " +"underneath us. This will be divided into several parts:" +msgstr "" +"今日、取り扱うのは、ベアメタルRustです。すなわち、OSなしでRustのコードを実行" +"します。この章は以下のような構成になります:" + +#: src/bare-metal.md +msgid "What is `no_std` Rust?" +msgstr "`no_std` Rustとは?" + +#: src/bare-metal.md +msgid "Writing firmware for microcontrollers." +msgstr "マイクロコントローラ向けのファームウェア開発。" + +#: src/bare-metal.md +msgid "Writing bootloader / kernel code for application processors." +msgstr "アプリケーションプロセッサ向けのブートローダ／カーネル開発。" + +#: src/bare-metal.md +msgid "Some useful crates for bare-metal Rust development." +msgstr "ベアメタルRust開発に役立つクレートの紹介。" + +#: src/bare-metal.md +#, fuzzy +msgid "" +"For the microcontroller part of the course we will use the [BBC micro:bit]" +"(https://microbit.org/) v2 as an example. It's a [development board](https://" +"tech.microbit.org/hardware/) based on the Nordic nRF52833 microcontroller " +"with some LEDs and buttons, an I2C-connected accelerometer and compass, and " +"an on-board SWD debugger." +msgstr "" +"マイクロコントローラ向けの学習では[BBC micro:bit](https://microbit.org/) v2を" +"題材として使います。これは、Nordic nRF51822マイコンベースの[開発ボード]" +"(https://tech.microbit.org/hardware/) で、いくつかのLEDやボタンスイッチ、I2C" +"接続の加速度センサやコンパス、そしてオンボードSWDデバッガを搭載しています。" + +#: src/bare-metal.md +msgid "" +"To get started, install some tools we'll need later. On gLinux or Debian:" +msgstr "" +"まずはじめに、後ほど必要となるいくつかのツールをインストールします。gLinuxま" +"たはDebianの場合は以下のようになります:" + +#: src/bare-metal.md +msgid "" +"And give users in the `plugdev` group access to the micro:bit programmer:" +msgstr "" +"さらに、`plugdev`グループにmicro:bitプログラム用デバイスへのアクセスを付与し" +"ます:" + +#: src/bare-metal.md src/bare-metal/microcontrollers/debugging.md +msgid "On MacOS:" +msgstr "MacOSの場合は以下のようになります:" + +#: src/bare-metal/no_std.md +msgid "`core`" +msgstr "`core`" + +#: src/bare-metal/no_std.md +msgid "`std`" +msgstr "`std`" + +#: src/bare-metal/no_std.md +msgid "Slices, `&str`, `CStr`" +msgstr "Slice、`&str`、`CStr`" + +#: src/bare-metal/no_std.md +msgid "`NonZeroU8`..." +msgstr "`NonZeroU8` など" + +#: src/bare-metal/no_std.md +msgid "`Option`, `Result`" +msgstr "`Option`、`Result`" + +#: src/bare-metal/no_std.md +msgid "`Display`, `Debug`, `write!`..." +msgstr "`Display`、`Debug`、`write!` など" + +#: src/bare-metal/no_std.md +msgid "`panic!`, `assert_eq!`..." +msgstr "`panic!`、`assert_eq!` など" + +#: src/bare-metal/no_std.md +msgid "`NonNull` and all the usual pointer-related functions" +msgstr "`NonNull` とポインターに関する全ての一般的な関数" + +#: src/bare-metal/no_std.md +msgid "`Future` and `async`/`await`" +msgstr "`Future` と `async` / `await`" + +#: src/bare-metal/no_std.md +msgid "`fence`, `AtomicBool`, `AtomicPtr`, `AtomicU32`..." +msgstr "`fence`、`AtomicBool`、`AtomicPtr`、`AtomicU32` など" + +#: src/bare-metal/no_std.md +msgid "`Duration`" +msgstr "`Duration`" + +#: src/bare-metal/no_std.md +msgid "`Box`, `Cow`, `Arc`, `Rc`" +msgstr "`Box`、`Cow`、`Arc`、`Rc`" + +#: src/bare-metal/no_std.md +msgid "`Vec`, `BinaryHeap`, `BtreeMap`, `LinkedList`, `VecDeque`" +msgstr "`Vec`、`BinaryHeap`、`BtreeMap`、`LinkedList`、`VecDeque`" + +#: src/bare-metal/no_std.md +msgid "`String`, `CString`, `format!`" +msgstr "`String`、`CString`、`format!`" + +#: src/bare-metal/no_std.md +msgid "`Error`" +msgstr "`Error`" + +#: src/bare-metal/no_std.md +msgid "`Mutex`, `Condvar`, `Barrier`, `Once`, `RwLock`, `mpsc`" +msgstr "`Mutex`、`Condvar`、`Barrier`、`Once`、`RwLock`、`mpsc`" + +#: src/bare-metal/no_std.md +msgid "`File` and the rest of `fs`" +msgstr "`File`、残りの `fs`" + +#: src/bare-metal/no_std.md +msgid "`println!`, `Read`, `Write`, `Stdin`, `Stdout` and the rest of `io`" +msgstr "`println!`、`Read`、`Write`、`Stdin`、`Stdout`、残りの `io`" + +#: src/bare-metal/no_std.md +msgid "`Path`, `OsString`" +msgstr "`Path`、`OsString`" + +#: src/bare-metal/no_std.md +msgid "`net`" +msgstr "`net`" + +#: src/bare-metal/no_std.md +msgid "`Command`, `Child`, `ExitCode`" +msgstr "`Command`、`Child`、`ExitCode`" + +#: src/bare-metal/no_std.md +msgid "`spawn`, `sleep` and the rest of `thread`" +msgstr "`spawn`、`sleep`、残りの `thread`" + +#: src/bare-metal/no_std.md +msgid "`SystemTime`, `Instant`" +msgstr "`SystemTime`、`Instant`" + +#: src/bare-metal/no_std.md +msgid "`HashMap` depends on RNG." +msgstr "`HashMap`はRNGに依存します。" + +#: src/bare-metal/no_std.md +msgid "`std` re-exports the contents of both `core` and `alloc`." +msgstr "`std`は`core`と`alloc`の両方を再エクスポートします。" + +#: src/bare-metal/minimal.md +msgid "A minimal `no_std` program" +msgstr "最小限の`no_std`プログラム" + +#: src/bare-metal/minimal.md +msgid "This will compile to an empty binary." +msgstr "このコードは空のバイナリにコンパイルされます。" + +#: src/bare-metal/minimal.md +msgid "`std` provides a panic handler; without it we must provide our own." +msgstr "" +"パニックハンドラは`std`が提供するので、それを使わない場合は自分で提供する必要" +"があります。" + +#: src/bare-metal/minimal.md +msgid "It can also be provided by another crate, such as `panic-halt`." +msgstr "" +"あるいは、`panic-halt`のような別のクレートが提供するパニックハンドラを利用す" +"ることもできます。" + +#: src/bare-metal/minimal.md +msgid "" +"Depending on the target, you may need to compile with `panic = \"abort\"` to " +"avoid an error about `eh_personality`." +msgstr "" +"ターゲットによっては、`eh_personality`に関するエラーを回避するために`panic = " +"\"abort\"`を指定してコンパイルする必要があります。" + +#: src/bare-metal/minimal.md +msgid "" +"Note that there is no `main` or any other entry point; it's up to you to " +"define your own entry point. This will typically involve a linker script and " +"some assembly code to set things up ready for Rust code to run." +msgstr "" +"なお、`main`のようなプログラムの規定エントリポイントはないので、自分でエント" +"リポイントを定義する必要があります。通常、Rustコードを実行できるようにするた" +"めには、リンカスクリプトとある程度のアセンブリコードを必要とします。" + +#: src/bare-metal/alloc.md +msgid "" +"To use `alloc` you must implement a [global (heap) allocator](https://doc." +"rust-lang.org/stable/std/alloc/trait.GlobalAlloc.html)." +msgstr "" +"`alloc`を使うためには、[グローバル（ヒープ）アロケータ](https://doc.rust-" +"lang.org/stable/std/alloc/trait.GlobalAlloc.html)を実装しなければなりません。" + +#: src/bare-metal/alloc.md +#, fuzzy +msgid "// SAFETY: `HEAP` is only used here and `entry` is only called once.\n" +msgstr "" +"// `HEAP` はここでのみ使用され、`entry` は一度だけ呼び出されるため、安全で" +"す。\n" + +#: src/bare-metal/alloc.md +msgid "// Give the allocator some memory to allocate.\n" +msgstr "// アロケーターにメモリを割り当てます。\n" + +#: src/bare-metal/alloc.md +msgid "// Now we can do things that require heap allocation.\n" +msgstr "" +"// これで、ヒープ割り当てを必要とする処理を実行できるようになりました。\n" + +#: src/bare-metal/alloc.md +msgid "\"A string\"" +msgstr "\"A string\"" + +#: src/bare-metal/alloc.md +msgid "" +"`buddy_system_allocator` is a third-party crate implementing a basic buddy " +"system allocator. Other crates are available, or you can write your own or " +"hook into your existing allocator." +msgstr "" +"`buddy_system_allocator`はサードパーティのクレートで、単純なバディシステムア" +"ロケータです。その他にも利用できるクレートはありますし、自前で実装したり、別" +"のアロケータに自分のコードをフックすることも可能です。" + +#: src/bare-metal/alloc.md +msgid "" +"The const parameter of `LockedHeap` is the max order of the allocator; i.e. " +"in this case it can allocate regions of up to 2\\*\\*32 bytes." +msgstr "" +"パラメータ定数`LockedHeap`はアロケータの最大オーダを示します。この場合、" +"2\\*\\*32バイトの領域を確保することが可能です。" + +#: src/bare-metal/alloc.md +msgid "" +"If any crate in your dependency tree depends on `alloc` then you must have " +"exactly one global allocator defined in your binary. Usually this is done in " +"the top-level binary crate." +msgstr "" +"もし依存関係にあるクレートが`alloc`に依存する場合、必ずバイナリファイルあたり" +"一つだけのグローバルなアロケータが存在するようにしなければなりません。通常、" +"これはトップレベルのバイナリを生成するクレートにより制御されます。" + +#: src/bare-metal/alloc.md +msgid "" +"`extern crate panic_halt as _` is necessary to ensure that the `panic_halt` " +"crate is linked in so we get its panic handler." +msgstr "" +"`extern crate panic_halt as _` という部分は、`panic_halt`クレートを確実にリン" +"クし、パニックハンドラを利用可能にするために必要です。" + +#: src/bare-metal/alloc.md +msgid "This example will build but not run, as it doesn't have an entry point." +msgstr "" +"この例で示したコードはビルドできますが、エントリポイントがないので実行するこ" +"とはできません。" + +#: src/bare-metal/microcontrollers.md +msgid "" +"The `cortex_m_rt` crate provides (among other things) a reset handler for " +"Cortex M microcontrollers." +msgstr "" +"`cortex_m_rt`クレートはCortex Mマイクロコントローラ向けのリセットハンドラ（と" +"その他もろもろ）を提供します。" + +#: src/bare-metal/microcontrollers.md +msgid "" +"Next we'll look at how to access peripherals, with increasing levels of " +"abstraction." +msgstr "" +"次は、抽象度の低いレベルから順に周辺I/Oにアクセスする方法について見ていきま" +"す。" + +#: src/bare-metal/microcontrollers.md +msgid "" +"The `cortex_m_rt::entry` macro requires that the function have type `fn() -" +"> !`, because returning to the reset handler doesn't make sense." +msgstr "" +"リセットハンドラはリターンしないので、`cortex_m_rt::entry`マクロは対象関数が" +"`fn() -> !`という型であることを要求します。" + +#: src/bare-metal/microcontrollers.md +msgid "Run the example with `cargo embed --bin minimal`" +msgstr "この例は`cargo embed --bin minimal`により実行します" + +#: src/bare-metal/microcontrollers/mmio.md +msgid "" +"Most microcontrollers access peripherals via memory-mapped IO. Let's try " +"turning on an LED on our micro:bit:" +msgstr "" +"大半のマイクロコントローラはメモリマップドRIO空間を通して周辺I/Oにアクセスし" +"ます。micro:bitのLEDを光らせてみましょう:" + +#: src/bare-metal/microcontrollers/mmio.md +msgid "/// GPIO port 0 peripheral address\n" +msgstr "/// GPIO 0 番ポートの周辺アドレス\n" + +#: src/bare-metal/microcontrollers/mmio.md +msgid "// GPIO peripheral offsets\n" +msgstr "// GPIO 周辺機器オフセット\n" + +#: src/bare-metal/microcontrollers/mmio.md +msgid "// PIN_CNF fields\n" +msgstr "// PIN_CNF フィールド\n" + +#: src/bare-metal/microcontrollers/mmio.md +#: src/bare-metal/microcontrollers/pacs.md +#: src/bare-metal/microcontrollers/hals.md +msgid "// Configure GPIO 0 pins 21 and 28 as push-pull outputs.\n" +msgstr "" +"// GPIO 0 の 21 番ピンと 28 番ピンをプッシュプル出力として設定します。\n" + +#: src/bare-metal/microcontrollers/mmio.md +#, fuzzy +msgid "" +"// SAFETY: The pointers are to valid peripheral control registers, and no\n" +" // aliases exist.\n" +msgstr "" +"// ポインタは有効な周辺機器制御レジスタを指しており、\n" +" // エイリアスが存在しないため、安全です。\n" + +#: src/bare-metal/microcontrollers/mmio.md +#: src/bare-metal/microcontrollers/pacs.md +#: src/bare-metal/microcontrollers/hals.md +msgid "// Set pin 28 low and pin 21 high to turn the LED on.\n" +msgstr "// 28 番ピンをロー、21 番ピンをハイに設定して LED をオンにします。\n" + +#: src/bare-metal/microcontrollers/mmio.md +msgid "" +"GPIO 0 pin 21 is connected to the first column of the LED matrix, and pin 28 " +"to the first row." +msgstr "" +"GPIO 0のピン21はマトリクスLEDの一番目の列に、ピン28は最初の行に接続されていま" +"す。" + +#: src/bare-metal/microcontrollers/mmio.md +#: src/bare-metal/microcontrollers/pacs.md +#: src/bare-metal/microcontrollers/hals.md +#: src/bare-metal/microcontrollers/board-support.md +msgid "Run the example with:" +msgstr "例の実行方法:" + +#: src/bare-metal/microcontrollers/pacs.md +msgid "Peripheral Access Crates" +msgstr "周辺I/Oへアクセスするためのクレート（PACs）" + +#: src/bare-metal/microcontrollers/pacs.md +msgid "" +"[`svd2rust`](https://crates.io/crates/svd2rust) generates mostly-safe Rust " +"wrappers for memory-mapped peripherals from [CMSIS-SVD](https://www.keil.com/" +"pack/doc/CMSIS/SVD/html/index.html) files." +msgstr "" +"[`svd2rust`](https://crates.io/crates/svd2rust) は[CMSIS-SVD](https://www." +"keil.com/pack/doc/CMSIS/SVD/html/index.html) ファイルから、メモリマップされた" +"周辺I/Oに対するほぼ安全（mostly-safe）なRustラッパーを生成します。" + +#: src/bare-metal/microcontrollers/pacs.md +msgid "" +"SVD (System View Description) files are XML files typically provided by " +"silicon vendors which describe the memory map of the device." +msgstr "" +"SVD (System View Description)ファイルはXMLファイルでデバイスのメモリマップを" +"記述したものであり、通常シリコンベンダにより提供されます。" + +#: src/bare-metal/microcontrollers/pacs.md +msgid "" +"They are organised by peripheral, register, field and value, with names, " +"descriptions, addresses and so on." +msgstr "" +"周辺I/Oごとに、レジスタ、フィールドと値、名前、説明、アドレスなどにより構成さ" +"れています。" + +#: src/bare-metal/microcontrollers/pacs.md +msgid "" +"SVD files are often buggy and incomplete, so there are various projects " +"which patch the mistakes, add missing details, and publish the generated " +"crates." +msgstr "" +"SVDファイルにはよく誤りがあり、また情報が不足していることも多いので、様々なプ" +"ロジェクトがそれを修正・追加し、クレートとして公開しています。" + +#: src/bare-metal/microcontrollers/pacs.md +msgid "`cortex-m-rt` provides the vector table, among other things." +msgstr "`cortex-m-rt`はベクタテーブルも提供します。" + +#: src/bare-metal/microcontrollers/pacs.md +msgid "" +"If you `cargo install cargo-binutils` then you can run `cargo objdump --bin " +"pac -- -d --no-show-raw-insn` to see the resulting binary." +msgstr "" +"もし`cargo install cargo-binutils`を実行していれば、`cargo objdump --bin pac " +"-- -d --no-show-raw-insn`を実行することにより生成されたバイナリの中身を見るこ" +"とができます。" + +#: src/bare-metal/microcontrollers/hals.md +msgid "HAL crates" +msgstr "HALクレート" + +#: src/bare-metal/microcontrollers/hals.md +msgid "" +"[HAL crates](https://github.com/rust-embedded/awesome-embedded-rust#hal-" +"implementation-crates) for many microcontrollers provide wrappers around " +"various peripherals. These generally implement traits from [`embedded-hal`]" +"(https://crates.io/crates/embedded-hal)." +msgstr "" +"多くのマイクロコントローラに対する[HALクレート](https://github.com/rust-" +"embedded/awesome-embedded-rust#hal-implementation-crates)が様々な周辺I/Oに対" +"するラッパーを提供しています。これらのクレートの多くは[`embedded-hal`]" +"(https://crates.io/crates/embedded-hal)が定義するトレイトを実装しています。" + +#: src/bare-metal/microcontrollers/hals.md +msgid "// Create HAL wrapper for GPIO port 0.\n" +msgstr "// GPIO 0 番ポートの HAL ラッパーを作成します。\n" + +#: src/bare-metal/microcontrollers/hals.md +msgid "" +"`set_low` and `set_high` are methods on the `embedded_hal` `OutputPin` trait." +msgstr "" +"`set_low`と`set_high`は`embedded_hal`の`OutputPin`トレイトの定義するメソッド" +"です。" + +#: src/bare-metal/microcontrollers/hals.md +msgid "" +"HAL crates exist for many Cortex-M and RISC-V devices, including various " +"STM32, GD32, nRF, NXP, MSP430, AVR and PIC microcontrollers." +msgstr "" +"Cortex-MやRISC-Vの多くのデバイスに対してHALクレートが存在し、これらには" +"STM32、GD32、nRF、NXP、MSP430、AVR、PICマイクロコントローラなどが含まれます。" + +#: src/bare-metal/microcontrollers/board-support.md +msgid "Board support crates" +msgstr "ボードサポートクレート" + +#: src/bare-metal/microcontrollers/board-support.md +msgid "" +"Board support crates provide a further level of wrapping for a specific " +"board for convenience." +msgstr "" +"ボードサポートクレードは特定のボードに対して更に利便性を向上させるラッパーを" +"提供します。" + +#: src/bare-metal/microcontrollers/board-support.md +msgid "" +"In this case the board support crate is just providing more useful names, " +"and a bit of initialisation." +msgstr "" +"この例では、ボードサポートクレートは単に分かりやすい名前を提供し、少しの初期" +"化を実施しているだけです。" + +#: src/bare-metal/microcontrollers/board-support.md +msgid "" +"The crate may also include drivers for some on-board devices outside of the " +"microcontroller itself." +msgstr "" +"マイクロコントローラの外に実装されたオンボードデバイスに対するドライバも提供" +"されていることがあります。" + +#: src/bare-metal/microcontrollers/board-support.md +msgid "`microbit-v2` includes a simple driver for the LED matrix." +msgstr "`microbit-v2`はマトリクスLEDに対する簡単なドライバを含んでいます。" + +#: src/bare-metal/microcontrollers/type-state.md +msgid "The type state pattern" +msgstr "タイプステートパターン" + +#: src/bare-metal/microcontrollers/type-state.md +msgid "// let gpio0_01_again = gpio0.p0_01; // Error, moved.\n" +msgstr "// let gpio0_01_again = gpio0.p0_01; // エラー、移動済み。\n" + +#: src/bare-metal/microcontrollers/type-state.md +msgid "// pin_input.is_high(); // Error, moved.\n" +msgstr "// pin_input.is_high(); // エラー、移動済み。\n" + +#: src/bare-metal/microcontrollers/type-state.md +msgid "" +"Pins don't implement `Copy` or `Clone`, so only one instance of each can " +"exist. Once a pin is moved out of the port struct nobody else can take it." +msgstr "" +"この例では、ピンを表すタイプは`Copy`も`Clone`も実装していません。そのため、た" +"だ一つのインスタンスだけが存在可能です。ピンがポート構造体からムーブされる" +"と、他の誰もそのピンにアクセスすることはできなくなります。" + +#: src/bare-metal/microcontrollers/type-state.md +msgid "" +"Changing the configuration of a pin consumes the old pin instance, so you " +"can’t keep use the old instance afterwards." +msgstr "" +"ピンの設定を変更することは古いピンのインスタンスを消費することになります。そ" +"のため、それ以降は古いインスタンスを使い続けることはできなくなります。" + +#: src/bare-metal/microcontrollers/type-state.md +msgid "" +"The type of a value indicates the state that it is in: e.g. in this case, " +"the configuration state of a GPIO pin. This encodes the state machine into " +"the type system, and ensures that you don't try to use a pin in a certain " +"way without properly configuring it first. Illegal state transitions are " +"caught at compile time." +msgstr "" +"変数の型はその状態を表すようになっています。例えば、この例では型がGPIOピンの" +"状態を表しています。このようにステートマシンをタイプシステムに織り込むこと" +"で、正しい設定をせずにピンを使ってしまうことがなくなります。不正な状態遷移に" +"関してはコンパイル時に発見されるようになります。" + +#: src/bare-metal/microcontrollers/type-state.md +msgid "" +"You can call `is_high` on an input pin and `set_high` on an output pin, but " +"not vice-versa." +msgstr "" +"インプットピンに対して`is_high`を呼び出すことは可能で、アウトプットピンに対し" +"て`set_high`を呼び出すことも可能です。しかし、その逆の組み合わせは不可能で" +"す。" + +#: src/bare-metal/microcontrollers/type-state.md +msgid "Many HAL crates follow this pattern." +msgstr "多くのHALクレートがこのパターンを用いています。" + +#: src/bare-metal/microcontrollers/embedded-hal.md +#, fuzzy +msgid "" +"The [`embedded-hal`](https://crates.io/crates/embedded-hal) crate provides a " +"number of traits covering common microcontroller peripherals:" +msgstr "" +"[`embedded-hal`](https://crates.io/crates/embedded-hal)クレートはマイクロコン" +"トローラの周辺I/Oに関して共通に必要とされる多くのトレイトを提供します。" + +#: src/bare-metal/microcontrollers/embedded-hal.md +msgid "GPIO" +msgstr "GPIO" + +#: src/bare-metal/microcontrollers/embedded-hal.md +msgid "PWM" +msgstr "" + +#: src/bare-metal/microcontrollers/embedded-hal.md +msgid "Delay timers" +msgstr "" + +#: src/bare-metal/microcontrollers/embedded-hal.md +msgid "I2C and SPI buses and devices" +msgstr "" + +#: src/bare-metal/microcontrollers/embedded-hal.md +msgid "" +"Similar traits for byte streams (e.g. UARTs), CAN buses and RNGs and broken " +"out into [`embedded-io`](https://crates.io/crates/embedded-io), [`embedded-" +"can`](https://crates.io/crates/embedded-can) and [`rand_core`](https://" +"crates.io/crates/rand_core) respectively." +msgstr "" + +#: src/bare-metal/microcontrollers/embedded-hal.md +#, fuzzy +msgid "" +"Other crates then implement [drivers](https://github.com/rust-embedded/" +"awesome-embedded-rust#driver-crates) in terms of these traits, e.g. an " +"accelerometer driver might need an I2C or SPI device instance." +msgstr "" +"多くのクレートはこれらのトレイトに対応することで[ドライバ](https://github." +"com/rust-embedded/awesome-embedded-rust#driver-crates)を実装します。例えば、" +"加速度センサのドライバにはI2CやSPIバスの実装が必要かもしれません。" + +#: src/bare-metal/microcontrollers/embedded-hal.md +msgid "" +"The traits cover using the peripherals but not initialising or configuring " +"them, as initialisation and configuration is usually highly platform-" +"specific." +msgstr "" + +#: src/bare-metal/microcontrollers/embedded-hal.md +msgid "" +"There are implementations for many microcontrollers, as well as other " +"platforms such as Linux on Raspberry Pi." +msgstr "" +"多くのマイクロコントローラに対する実装に加えて、Raspberry Pi上のLinux向けの実" +"装も存在します。" + +#: src/bare-metal/microcontrollers/embedded-hal.md +#, fuzzy +msgid "" +"[`embedded-hal-async`](https://crates.io/crates/embedded-hal-async) provides " +"async versions of the traits." +msgstr "" +"[`embedded-hal`](https://crates.io/crates/embedded-hal)クレートはマイクロコン" +"トローラの周辺I/Oに関して共通に必要とされる多くのトレイトを提供します。" + +#: src/bare-metal/microcontrollers/embedded-hal.md +#, fuzzy +msgid "" +"[`embedded-hal-nb`](https://crates.io/crates/embedded-hal-nb) provides " +"another approach to non-blocking I/O, based on the [`nb`](https://crates.io/" +"crates/nb) crate." +msgstr "" +"[`embedded-hal`](https://crates.io/crates/embedded-hal)クレートはマイクロコン" +"トローラの周辺I/Oに関して共通に必要とされる多くのトレイトを提供します。" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "" +"[probe-rs](https://probe.rs/) is a handy toolset for embedded debugging, " +"like OpenOCD but better integrated." +msgstr "" +"[probe-rs](https://probe.rs/)は組み込み向けデバッグに有用なツールセットです。" +"これはOpenOCDのようなものですが、より高度に統合されています。" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "" +"SWD (Serial Wire Debug) and JTAG via CMSIS-DAP, ST-Link and J-Link probes" +msgstr "" +"SWD (Serial Wire Debug) やCMSIS-DAP経由のJTAG、 ST-LinkやJ-Linkプローブ" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "GDB stub and Microsoft DAP (Debug Adapter Protocol) server" +msgstr "GDBスタブやMicrosoft DAP (Debug Adapter Protocol)サーバ" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "Cargo integration" +msgstr "Cargoとのインテグレーション" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "" +"`cargo-embed` is a cargo subcommand to build and flash binaries, log RTT " +"(Real Time Transfers) output and connect GDB. It's configured by an `Embed." +"toml` file in your project directory." +msgstr "" +"`cargo-embed`はcargoのサブコマンドであり、バイナリをビルドしたり、フラッシュ" +"したり、RTT（Real Time Transfers）の出力ログを取得したり、GDBに接続するための" +"ものです。設定は対象とするプロジェクトディレクトリにおける`Embed.toml`ファイ" +"ルにより行います。" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "" +"[CMSIS-DAP](https://arm-software.github.io/CMSIS_5/DAP/html/index.html) is " +"an Arm standard protocol over USB for an in-circuit debugger to access the " +"CoreSight Debug Access Port of various Arm Cortex processors. It's what the " +"on-board debugger on the BBC micro:bit uses." +msgstr "" +"[CMSIS-DAP](https://arm-software.github.io/CMSIS_5/DAP/html/index.html) はUSB" +"上のARM標準プロトコルで、インサーキット・デバッガが様々なArm Cortexプロセッサ" +"のコアサイト・デバッグ・アクセスポートにアクセスするためのものです。BBC " +"micro:bit のオンボード・デバッガもこれを利用しています。" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "" +"ST-Link is a range of in-circuit debuggers from ST Microelectronics, J-Link " +"is a range from SEGGER." +msgstr "" +"ST-Link はST Microelectronicsによるインサーキット・デバッガの総称で、 J-Link" +"はSEGGERによるインサーキット・デバッガの総称です。" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "" +"The Debug Access Port is usually either a 5-pin JTAG interface or 2-pin " +"Serial Wire Debug." +msgstr "" +"デバッグ・アクセスポートは通常５ピンのJTAGインタフェースか、2ピンのシリアルワ" +"イヤデバッグです。" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "" +"probe-rs is a library which you can integrate into your own tools if you " +"want to." +msgstr "" +"probe-rsは自分で独自のツールを統合したい場合に利用できるライブラリです。" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "" +"The [Microsoft Debug Adapter Protocol](https://microsoft.github.io/debug-" +"adapter-protocol/) lets VSCode and other IDEs debug code running on any " +"supported microcontroller." +msgstr "" +"[Microsoft Debug Adapter Protocol](https://microsoft.github.io/debug-adapter-" +"protocol/) はVSCodeや他のIDEから、サポートされたマイクロコントローラ上で実行" +"されているコードをデバッグすることを可能にします。" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "cargo-embed is a binary built using the probe-rs library." +msgstr "cargo-embedはprobe-rsライブラリを利用して生成されたバイナリです。" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "" +"RTT (Real Time Transfers) is a mechanism to transfer data between the debug " +"host and the target through a number of ringbuffers." +msgstr "" +"RTT (Real Time Transfers)はデバッグホストとターゲット間のデータを多くのリング" +"バッファを介してやりとりするためのメカニズムです。" + +#: src/bare-metal/microcontrollers/debugging.md +msgid "_Embed.toml_:" +msgstr "_Embed.toml_:" + +#: src/bare-metal/microcontrollers/debugging.md +msgid "In one terminal under `src/bare-metal/microcontrollers/examples/`:" +msgstr "" +"ひとつのターミナルで、`src/bare-metal/microcontrollers/examples/`において下記" +"を実行:" + +#: src/bare-metal/microcontrollers/debugging.md +msgid "In another terminal in the same directory:" +msgstr "別のターミナルで、同じディレクトリで下記を実行:" + +#: src/bare-metal/microcontrollers/debugging.md +msgid "On gLinux or Debian:" +msgstr "gLinuxまたはDebianの場合:" + +#: src/bare-metal/microcontrollers/debugging.md +msgid "In GDB, try running:" +msgstr "GDBで下記を実行してみてください:" + +#: src/bare-metal/microcontrollers/other-projects.md +#: src/bare-metal/aps/other-projects.md +msgid "Other projects" +msgstr "他のプロジェクト" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "[RTIC](https://rtic.rs/)" +msgstr "[RTIC](https://rtic.rs/)" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "\"Real-Time Interrupt-driven Concurrency\"" +msgstr "\"Real-Time Interrupt-driven Concurrency\"の略" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"Shared resource management, message passing, task scheduling, timer queue" +msgstr "" +"共有リソース管理、メッセージパッシング、タスクスケジューリング、タイマキュー" +"を提供" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "[Embassy](https://embassy.dev/)" +msgstr "[Embassy](https://embassy.dev/)" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "`async` executors with priorities, timers, networking, USB" +msgstr "優先度付き`async` エグゼキュータ、タイマ、ネットワーク、USB" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "[TockOS](https://www.tockos.org/documentation/getting-started)" +msgstr "[TockOS](https://www.tockos.org/documentation/getting-started)" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"Security-focused RTOS with preemptive scheduling and Memory Protection Unit " +"support" +msgstr "" +"セキュリティに焦点をあてたRTOSで、プリエンプティブ・スケジューリングとMemory " +"Protection Unitをサポート" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "[Hubris](https://hubris.oxide.computer/)" +msgstr "[Hubris](https://hubris.oxide.computer/)" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"Microkernel RTOS from Oxide Computer Company with memory protection, " +"unprivileged drivers, IPC" +msgstr "" +"Oxide Computer CompanyによるマイクロカーネルのRTOSでメモリ保護、非特権ドライ" +"バ、IPCを提供" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "[Bindings for FreeRTOS](https://github.com/lobaro/FreeRTOS-rust)" +msgstr "" +"[FreeRTOSに対するRustバインディング](https://github.com/lobaro/FreeRTOS-rust)" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"Some platforms have `std` implementations, e.g. [esp-idf](https://esp-rs." +"github.io/book/overview/using-the-standard-library.html)." +msgstr "" +"いくつかのプラットフォームでは `std`の実装あり、例えば [esp-idf](https://esp-" +"rs.github.io/book/overview/using-the-standard-library.html)。" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "RTIC can be considered either an RTOS or a concurrency framework." +msgstr "" +"RTICはRTOSとして捉えることもできますし、並行実行のフレームワークとして捉える" +"こともできます。" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "It doesn't include any HALs." +msgstr "他のHALを全く含んでいません。" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"It uses the Cortex-M NVIC (Nested Virtual Interrupt Controller) for " +"scheduling rather than a proper kernel." +msgstr "" +"スケジューリングはカーネルではなく、Cortex-M NVIC (Nested Virtual Interrupt " +"Controller)を利用して行います。" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "Cortex-M only." +msgstr "Cortex-Mのみの対応です。" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"Google uses TockOS on the Haven microcontroller for Titan security keys." +msgstr "" +"GoogleはTockOSをTitanセキュリティキーのHavenマイクロコントローラで利用してい" +"ます。" + +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"FreeRTOS is mostly written in C, but there are Rust bindings for writing " +"applications." +msgstr "" +"FreeRTOS はほとんどCで書かれていますが、アプリケーションを開発するためのRust" +"バインディングが存在します。" + +#: src/exercises/bare-metal/morning.md +msgid "" +"We will read the direction from an I2C compass, and log the readings to a " +"serial port." +msgstr "" +"I2C接続のコンパスから方位を読み取り、その結果をシリアルポートに出力します。" + +#: src/exercises/bare-metal/morning.md +msgid "" +"After looking at the exercises, you can look at the [solutions](solutions-" +"morning.md) provided." +msgstr "" +"練習問題に取り組んだあとは、 [解答](solutions-morning.md)をみても構いません。" + +#: src/exercises/bare-metal/compass.md +msgid "" +"We will read the direction from an I2C compass, and log the readings to a " +"serial port. If you have time, try displaying it on the LEDs somehow too, or " +"use the buttons somehow." +msgstr "" +"I2C接続のコンパスから方位を読み取り、その結果をシリアルポートに出力します。も" +"し時間があれば、LEDやボタンをなんとか利用して方位を出力してみてください。" + +#: src/exercises/bare-metal/compass.md +msgid "Hints:" +msgstr "ヒント:" + +#: src/exercises/bare-metal/compass.md +msgid "" +"Check the documentation for the [`lsm303agr`](https://docs.rs/lsm303agr/" +"latest/lsm303agr/) and [`microbit-v2`](https://docs.rs/microbit-v2/latest/" +"microbit/) crates, as well as the [micro:bit hardware](https://tech.microbit." +"org/hardware/)." +msgstr "" +"[`lsm303agr`](https://docs.rs/lsm303agr/latest/lsm303agr/) クレートと " +"[`microbit-v2`](https://docs.rs/microbit-v2/latest/microbit/)クレートのドキュ" +"メント、ならびに[micro:bitハードウェア仕様](https://tech.microbit.org/" +"hardware/)を確認してみてください。" + +#: src/exercises/bare-metal/compass.md +msgid "" +"The LSM303AGR Inertial Measurement Unit is connected to the internal I2C bus." +msgstr "LSM303AGR慣性計測器は内部のI2Cバスに接続されています。" + +#: src/exercises/bare-metal/compass.md +msgid "" +"TWI is another name for I2C, so the I2C master peripheral is called TWIM." +msgstr "TWIはI2Cの別名なので、I2CマスタはTWIMという名前になっています。" + +#: src/exercises/bare-metal/compass.md +#, fuzzy +msgid "" +"The LSM303AGR driver needs something implementing the `embedded_hal::i2c::" +"I2c` trait. The [`microbit::hal::Twim`](https://docs.rs/microbit-v2/latest/" +"microbit/hal/struct.Twim.html) struct implements this." +msgstr "" +"LSM303AGRドライバは`embedded_hal::blocking::i2c::WriteRead`を実装するものを必" +"要とします。 [`microbit::hal::Twim`](https://docs.rs/microbit-v2/latest/" +"microbit/hal/struct.Twim.html)構造体がこれを実装しています。" + +#: src/exercises/bare-metal/compass.md +msgid "" +"You have a [`microbit::Board`](https://docs.rs/microbit-v2/latest/microbit/" +"struct.Board.html) struct with fields for the various pins and peripherals." +msgstr "" +"様々なピンや周辺I/Oのための [`microbit::Board`](https://docs.rs/microbit-v2/" +"latest/microbit/struct.Board.html)という構造体があります。" + +#: src/exercises/bare-metal/compass.md +msgid "" +"You can also look at the [nRF52833 datasheet](https://infocenter.nordicsemi." +"com/pdf/nRF52833_PS_v1.5.pdf) if you want, but it shouldn't be necessary for " +"this exercise." +msgstr "" +"[nRF52833データシート](https://infocenter.nordicsemi.com/pdf/" +"nRF52833_PS_v1.5.pdf)を見ることもできますが、この練習問題のためには必要ないは" +"ずです。" + +#: src/exercises/bare-metal/compass.md +msgid "" +"Download the [exercise template](../../comprehensive-rust-exercises.zip) and " +"look in the `compass` directory for the following files." +msgstr "" +"[練習問題のテンプレート](../../comprehensive-rust-exercises.zip) をダウンロー" +"ドして、`compass`というディレクトリの中にある下記のファイルを見てください。" + +#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md +msgid "_src/main.rs_:" +msgstr "_src/main.rs_:" + +#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md +msgid "_Cargo.toml_ (you shouldn't need to change this):" +msgstr "_Cargo.toml_ (変更は不要なはずです):" + +#: src/exercises/bare-metal/compass.md +msgid "_Embed.toml_ (you shouldn't need to change this):" +msgstr "_Embed.toml_ (変更は不要なはずです):" + +#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md +msgid "_.cargo/config.toml_ (you shouldn't need to change this):" +msgstr "_.cargo/config.toml_ (変更は不要なはずです):" + +#: src/exercises/bare-metal/compass.md +msgid "See the serial output on Linux with:" +msgstr "Linuxではシリアルポート出力を下記のコマンドで確認します:" + +#: src/exercises/bare-metal/compass.md +msgid "" +"Or on Mac OS something like (the device name may be slightly different):" +msgstr "Mac OSではこんな感じになります（デバイス名が少し違うかもしれません）:" + +#: src/exercises/bare-metal/compass.md +msgid "Use Ctrl+A Ctrl+Q to quit picocom." +msgstr "Ctrl+A Ctrl+Q でpicocomを終了します。" + +#: src/exercises/bare-metal/solutions-morning.md +msgid "Bare Metal Rust Morning Exercise" +msgstr "ベアメタル Rust の午前の演習" + +#: src/exercises/bare-metal/solutions-morning.md +msgid "([back to exercise](compass.md))" +msgstr "（[演習に戻る](compass.md)）" + +#: src/exercises/bare-metal/solutions-morning.md +msgid "// Configure serial port.\n" +msgstr "// シリアルポートを設定します。\n" + +#: src/exercises/bare-metal/solutions-morning.md +msgid "// Use the system timer as a delay provider.\n" +msgstr "// システム タイマーを遅延目的で使用します。\n" + +#: src/exercises/bare-metal/solutions-morning.md +msgid "// Set up the I2C controller and Inertial Measurement Unit.\n" +msgstr "// I2C コントローラと慣性測定ユニットをセットアップします。\n" + +#: src/exercises/bare-metal/solutions-morning.md +msgid "\"Setting up IMU...\"" +msgstr "\"Setting up IMU...\"" + +#: src/exercises/bare-metal/solutions-morning.md +msgid "// Set up display and timer.\n" +msgstr "// ディスプレイとタイマーをセットアップします。\n" + +#: src/exercises/bare-metal/solutions-morning.md +msgid "\"Ready.\"" +msgstr "\"Ready.\"" + +#: src/exercises/bare-metal/solutions-morning.md +msgid "// Read compass data and log it to the serial port.\n" +msgstr "// コンパスデータを読み取り、シリアルポートに記録します。\n" + +#: src/exercises/bare-metal/solutions-morning.md +msgid "\"{},{},{}\\t{},{},{}\"" +msgstr "\"{},{},{}\\t{},{},{}\"" + +#: src/exercises/bare-metal/solutions-morning.md +msgid "" +"// If button A is pressed, switch to the next mode and briefly blink all " +"LEDs\n" +" // on.\n" +msgstr "" +"// ボタン A が押された場合、次のモードに切り替えてすべての LED を短時間点滅\n" +" // させます。\n" + +#: src/bare-metal/aps.md +msgid "Application processors" +msgstr "アプリケーションプロセッサ" + +#: src/bare-metal/aps.md +msgid "" +"So far we've talked about microcontrollers, such as the Arm Cortex-M series. " +"Now let's try writing something for Cortex-A. For simplicity we'll just work " +"with QEMU's aarch64 ['virt'](https://qemu-project.gitlab.io/qemu/system/arm/" +"virt.html) board." +msgstr "" +"ここまではArm Cortex-Mシリーズのようなマイクロコントローラについて見てきまし" +"た。今度はCortex-Aを対象として何かを書いてみましょう。簡単化のために、ここで" +"は（本物のハードウェアではなく）QEMUのaarch64 ['virt'](https://qemu-project." +"gitlab.io/qemu/system/arm/virt.html)ボードを利用します。" + +#: src/bare-metal/aps.md +msgid "" +"Broadly speaking, microcontrollers don't have an MMU or multiple levels of " +"privilege (exception levels on Arm CPUs, rings on x86), while application " +"processors do." +msgstr "" +"大まかに言って、マイクロコントローラがMMUや複数の特権レベル（Arm CPUにおける" +"例外レベル、x86におけるリング）を持たないのに対し、アプリケーションプロセッサ" +"はこれらを持っています。" + +#: src/bare-metal/aps.md +msgid "" +"QEMU supports emulating various different machines or board models for each " +"architecture. The 'virt' board doesn't correspond to any particular real " +"hardware, but is designed purely for virtual machines." +msgstr "" +"QEMU は個々のアーキテクチャに対して様々な異なるマシンやボードモデルをサポート" +"しています。今回使う 'virt' ボードは特定の本物のハードウェアに対応したもので" +"はなく、純粋に仮想マシンとして設計されたものです。" + +#: src/bare-metal/aps/entry-point.md +msgid "" +"Before we can start running Rust code, we need to do some initialisation." +msgstr "Rustのコードを実行できるようになる前にいくつかの初期化が必要です。" + +#: src/bare-metal/aps/entry-point.md +msgid "" +"```armasm\n" +".section .init.entry, \"ax\"\n" +".global entry\n" +"entry:\n" +" /*\n" +" * Load and apply the memory management configuration, ready to enable " +"MMU and\n" +" * caches.\n" +" */\n" +" adrp x30, idmap\n" +" msr ttbr0_el1, x30\n" +"\n" +" mov_i x30, .Lmairval\n" +" msr mair_el1, x30\n" +"\n" +" mov_i x30, .Ltcrval\n" +" /* Copy the supported PA range into TCR_EL1.IPS. */\n" +" mrs x29, id_aa64mmfr0_el1\n" +" bfi x30, x29, #32, #4\n" +"\n" +" msr tcr_el1, x30\n" +"\n" +" mov_i x30, .Lsctlrval\n" +"\n" +" /*\n" +" * Ensure everything before this point has completed, then invalidate " +"any\n" +" * potentially stale local TLB entries before they start being used.\n" +" */\n" +" isb\n" +" tlbi vmalle1\n" +" ic iallu\n" +" dsb nsh\n" +" isb\n" +"\n" +" /*\n" +" * Configure sctlr_el1 to enable MMU and cache and don't proceed until " +"this\n" +" * has completed.\n" +" */\n" +" msr sctlr_el1, x30\n" +" isb\n" +"\n" +" /* Disable trapping floating point access in EL1. */\n" +" mrs x30, cpacr_el1\n" +" orr x30, x30, #(0x3 << 20)\n" +" msr cpacr_el1, x30\n" +" isb\n" +"\n" +" /* Zero out the bss section. */\n" +" adr_l x29, bss_begin\n" +" adr_l x30, bss_end\n" +"0: cmp x29, x30\n" +" b.hs 1f\n" +" stp xzr, xzr, [x29], #16\n" +" b 0b\n" +"\n" +"1: /* Prepare the stack. */\n" +" adr_l x30, boot_stack_end\n" +" mov sp, x30\n" +"\n" +" /* Set up exception vector. */\n" +" adr x30, vector_table_el1\n" +" msr vbar_el1, x30\n" +"\n" +" /* Call into Rust code. */\n" +" bl main\n" +"\n" +" /* Loop forever waiting for interrupts. */\n" +"2: wfi\n" +" b 2b\n" +"```" +msgstr "" +"```armasm\n" +".section .init.entry, \"ax\"\n" +".global entry\n" +"entry:\n" +" /*\n" +" * メモリ管理に関するコンフィギュレーションを読み込んで適用し、MMU と" +"キャッシュを有効にする準備を\n" +" * します。\n" +" */\n" +" adrp x30, idmap\n" +" msr ttbr0_el1, x30\n" +"\n" +" mov_i x30, .Lmairval\n" +" msr mair_el1, x30\n" +"\n" +" mov_i x30, .Ltcrval\n" +" /* サポートされている PA 範囲を TCR_EL1.IPS にコピーします。*/\n" +" mrs x29, id_aa64mmfr0_el1\n" +" bfi x30, x29, #32, #4\n" +"\n" +" msr tcr_el1, x30\n" +"\n" +" mov_i x30, .Lsctlrval\n" +"\n" +" /*\n" +" * ここより前のすべての処理が完了していることを確認してから、\n" +" * 古くなった可能性のあるローカル TLB エントリを使用開始前に無効にしま" +"す。\n" +" */\n" +" isb\n" +" tlbi vmalle1\n" +" ic iallu\n" +" dsb nsh\n" +" isb\n" +"\n" +" /*\n" +" * MMU とキャッシュを有効にするように sctlr_el1 を設定し、\n" +" * これが完了するまでは先に進まないようにします。\n" +" */\n" +" msr sctlr_el1, x30\n" +" isb\n" +"\n" +" /* EL1 の浮動小数点アクセスのトラップを無効にします。*/\n" +" mrs x30, cpacr_el1\n" +" orr x30, x30, #(0x3 << 20)\n" +" msr cpacr_el1, x30\n" +" isb\n" +"\n" +" /* bss セクションをゼロにします。*/\n" +" adr_l x29, bss_begin\n" +" adr_l x30, bss_end\n" +"0: cmp x29, x30\n" +" b.hs 1f\n" +" stp xzr, xzr, [x29], #16\n" +" b 0b\n" +"\n" +"1: /* スタックを準備します。*/\n" +" adr_l x30, boot_stack_end\n" +" mov sp, x30\n" +"\n" +" /* 例外ベクターを設定します。*/\n" +" adr x30, vector_table_el1\n" +" msr vbar_el1, x30\n" +"\n" +" /* Rust コードを呼び出します。*/\n" +" bl main\n" +"\n" +" /* 割り込みを待機して永久にループします。*/\n" +"2: wfi\n" +" b 2b\n" +"```" + +#: src/bare-metal/aps/entry-point.md +msgid "" +"This is the same as it would be for C: initialising the processor state, " +"zeroing the BSS, and setting up the stack pointer." +msgstr "" +"この初期化内容はCの場合と同じになります。プロセッサ状態を初期化して、BSSをゼ" +"ロ埋めして、スタックポインタを設定します。" + +#: src/bare-metal/aps/entry-point.md +msgid "" +"The BSS (block starting symbol, for historical reasons) is the part of the " +"object file which containing statically allocated variables which are " +"initialised to zero. They are omitted from the image, to avoid wasting space " +"on zeroes. The compiler assumes that the loader will take care of zeroing " +"them." +msgstr "" +"BSS（歴史的な理由によりblock starting symbolと呼ばれているもの）はオブジェク" +"トファイルにおいてゼロ初期化される静的な変数を含む部分です。この部分はゼロに" +"よる領域の浪費を避けるためにイメージからは除外されています。コンパイラはロー" +"ダがこの領域をゼロ初期化することを想定しているのです。" + +#: src/bare-metal/aps/entry-point.md +msgid "" +"The BSS may already be zeroed, depending on how memory is initialised and " +"the image is loaded, but we zero it to be sure." +msgstr "" +"メモリの初期化方法やイメージのロード方法によってはBSSはすでにゼロ埋めされてい" +"ることがありますが、ここでは念の為にゼロ埋めしています。" + +#: src/bare-metal/aps/entry-point.md +msgid "" +"We need to enable the MMU and cache before reading or writing any memory. If " +"we don't:" +msgstr "" +"いかなるメモリのreadやwriteよりも前にMMUとキャッシュを有効化する必要がありま" +"す。それをしないと：" + +#: src/bare-metal/aps/entry-point.md +msgid "" +"Unaligned accesses will fault. We build the Rust code for the `aarch64-" +"unknown-none` target which sets `+strict-align` to prevent the compiler " +"generating unaligned accesses, so it should be fine in this case, but this " +"is not necessarily the case in general." +msgstr "" +"アラインされていないアクセスがフォールトになります。我々はコンパイラがアライ" +"ンされていないアクセスを生成しないように`+strict-align`オプション を設定する" +"`aarch64-unknown-none` ターゲット向けにRustコードをビルドします。そのためここ" +"では問題にはなりませんが、一般的にはそうとは言えません。" + +#: src/bare-metal/aps/entry-point.md +msgid "" +"If it were running in a VM, this can lead to cache coherency issues. The " +"problem is that the VM is accessing memory directly with the cache disabled, " +"while the host has cacheable aliases to the same memory. Even if the host " +"doesn't explicitly access the memory, speculative accesses can lead to cache " +"fills, and then changes from one or the other will get lost when the cache " +"is cleaned or the VM enables the cache. (Cache is keyed by physical address, " +"not VA or IPA.)" +msgstr "" +"もしVM上で実行していたとすると、キャッシュコヒーレンシーの問題を起こすことが" +"あります。問題なのはVMがキャッシュを無効化したまま直接メモリにアクセスしてい" +"るのに対し、ホストは同じメモリに対してキャッシュ可能なエイリアスを持ってしま" +"うということです。ホストが仮に明示的にメモリにアクセスしないとしても、投機的" +"なアクセスによりキャッシュフィルが起きることがあります。そうなると、ホストが" +"キャッシュをフラッシュするかVMがキャッシュを有効化したときに、VMかホストのど" +"ちらかによる変更が失われてしまいます。（キャッシュは仮想アドレスやIPAではなく" +"物理アドレスをキーとしてアクセスされます）" + +#: src/bare-metal/aps/entry-point.md +msgid "" +"For simplicity, we just use a hardcoded pagetable (see `idmap.S`) which " +"identity maps the first 1 GiB of address space for devices, the next 1 GiB " +"for DRAM, and another 1 GiB higher up for more devices. This matches the " +"memory layout that QEMU uses." +msgstr "" +"単純化のために、ハードコードしたページテーブル（`idmap.S`参照）を利用します。" +"このページテーブルは最初の1GiBをデバイス用に、次の1GiBをDRAM用に、次の1GiBを" +"さらなるデバイス用に透過的にマップします。これはQEMUのメモリレイアウトに合致" +"します。" + +#: src/bare-metal/aps/entry-point.md +msgid "" +"We also set up the exception vector (`vbar_el1`), which we'll see more about " +"later." +msgstr "" +"例外ベクタ（`vbar_el1`）も設定します。これに関しては後ほど詳しく見ます。" + +#: src/bare-metal/aps/entry-point.md +msgid "" +"All examples this afternoon assume we will be running at exception level 1 " +"(EL1). If you need to run at a different exception level you'll need to " +"modify `entry.S` accordingly." +msgstr "" +"今日の午後に扱うすべての例は例外レベル１（EL1）で実行されることを想定していま" +"す。もし、別の例外レベルで実行する必要がある場合には、`entry.S`をそれに合わせ" +"て変更する必要があります。" + +#: src/bare-metal/aps/inline-assembly.md +msgid "Inline assembly" +msgstr "インラインアセンブリ" + +#: src/bare-metal/aps/inline-assembly.md +msgid "" +"Sometimes we need to use assembly to do things that aren't possible with " +"Rust code. For example, to make an HVC (hypervisor call) to tell the " +"firmware to power off the system:" +msgstr "" +"時折Rustコードでは書けないことを行うためにアセンブリ言語を使う必要がありま" +"す。例えば、電源を落とすためにファームウェアに対してHVC（ハイパーバイザコー" +"ル）を発行する場合です：" + +#: src/bare-metal/aps/inline-assembly.md +#, fuzzy +msgid "" +"// SAFETY: this only uses the declared registers and doesn't do anything\n" +" // with memory.\n" +msgstr "" +"// 宣言されたレジスタのみを使用し、メモリについては\n" +" // 何もしないため、安全です。\n" + +#: src/bare-metal/aps/inline-assembly.md +msgid "\"hvc #0\"" +msgstr "\"hvc #0\"" + +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w0\"" +msgstr "\"w0\"" + +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w1\"" +msgstr "\"w1\"" + +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w2\"" +msgstr "\"w2\"" + +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w3\"" +msgstr "\"w3\"" + +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w4\"" +msgstr "\"w4\"" + +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w5\"" +msgstr "\"w5\"" + +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w6\"" +msgstr "\"w6\"" + +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w7\"" +msgstr "\"w7\"" + +#: src/bare-metal/aps/inline-assembly.md +msgid "" +"(If you actually want to do this, use the [`smccc`](https://crates.io/crates/" +"smccc) crate which has wrappers for all these functions.)" +msgstr "" +"（もし実際に電源を落とすプログラムを書きたい場合は、これらのすべての機能に対" +"するラッパーを提供している[`smccc`](https://crates.io/crates/smccc)を使うと良" +"いでしょう。）" + +#: src/bare-metal/aps/inline-assembly.md +msgid "" +"PSCI is the Arm Power State Coordination Interface, a standard set of " +"functions to manage system and CPU power states, among other things. It is " +"implemented by EL3 firmware and hypervisors on many systems." +msgstr "" +"PSCI はArmのPower State Coordination Interfaceのことであり、これはシステムや" +"CPU電力状態管理の機能を含む標準的なセットです。これは多くのシステムでEL3" +"ファームウェアとハイパーバイザにより実装されています。" + +#: src/bare-metal/aps/inline-assembly.md +msgid "" +"The `0 => _` syntax means initialise the register to 0 before running the " +"inline assembly code, and ignore its contents afterwards. We need to use " +"`inout` rather than `in` because the call could potentially clobber the " +"contents of the registers." +msgstr "" +"`0 => _` というシンタックスは、インラインアセンブリを実行する前にレジスタをゼ" +"ロで初期化し、実行後はその値は気にしないということを示しています。`in`ではな" +"く`inout`を使う必要があるのは、この実行でレジスタの値を上書きしてしまう可能性" +"があるからです。" + +#: src/bare-metal/aps/inline-assembly.md +msgid "" +"This `main` function needs to be `#[no_mangle]` and `extern \"C\"` because " +"it is called from our entry point in `entry.S`." +msgstr "" +"この `main` 関数は`entry.S`にあるエントリポイントから呼ばれるため、" +"`#[no_mangle]`と`extern \"C\"`を必要とします。" + +#: src/bare-metal/aps/inline-assembly.md +msgid "" +"`_x0`–`_x3` are the values of registers `x0`–`x3`, which are conventionally " +"used by the bootloader to pass things like a pointer to the device tree. " +"According to the standard aarch64 calling convention (which is what `extern " +"\"C\"` specifies to use), registers `x0`–`x7` are used for the first 8 " +"arguments passed to a function, so `entry.S` doesn't need to do anything " +"special except make sure it doesn't change these registers." +msgstr "" +"`_x0`–`_x3`はレジスタ`x0`–`x3`の値であり、慣習的にブートロードがデバイスツ" +"リーなどへのポインタを渡すのに利用されています。（`extern \"C\"`により指定さ" +"れた）aarch64 の関数コール規約ではレジスタ`x0`–`x7`は最初の８個の引数を関数に" +"渡すのに利用されることになっているため、`entry.S` はこれらの値を変更しないよ" +"うにする以外の特別なことをする必要はありません。" + +#: src/bare-metal/aps/inline-assembly.md +msgid "" +"Run the example in QEMU with `make qemu_psci` under `src/bare-metal/aps/" +"examples`." +msgstr "" +"この例を`src/bare-metal/aps/examples`において`make qemu_psci`とすることでQEMU" +"により実行してみましょう。" + +#: src/bare-metal/aps/mmio.md +msgid "Volatile memory access for MMIO" +msgstr "MMIOに対するvolatileアクセス" + +#: src/bare-metal/aps/mmio.md +msgid "Use `pointer::read_volatile` and `pointer::write_volatile`." +msgstr "`pointer::read_volatile`と`pointer::write_volatile`を使います。" + +#: src/bare-metal/aps/mmio.md +msgid "Never hold a reference." +msgstr "絶対に参照を保持してはいけません。" + +#: src/bare-metal/aps/mmio.md +msgid "" +"`addr_of!` lets you get fields of structs without creating an intermediate " +"reference." +msgstr "" +"`addr_of!`を用いると、中間的な参照を作らずに構造体のフィールドにアクセスする" +"ことができます。" + +#: src/bare-metal/aps/mmio.md +msgid "" +"Volatile access: read or write operations may have side-effects, so prevent " +"the compiler or hardware from reordering, duplicating or eliding them." +msgstr "" +"Volatileアクセス：MMIO領域に対するreadやwriteは副作用があることがあるので、コ" +"ンパイラやハードウェアが実行順序を変更したり、複製したり、省略したりできない" +"ようにするためのものです。" + +#: src/bare-metal/aps/mmio.md +msgid "" +"Usually if you write and then read, e.g. via a mutable reference, the " +"compiler may assume that the value read is the same as the value just " +"written, and not bother actually reading memory." +msgstr "" +"通常は、例えばある可変参照に対してライトしリードすると、コンパイラはライトし" +"たのと同じ値がリードで読み出されると想定し、実際にメモリをリードする必要はな" +"いと判断します。" + +#: src/bare-metal/aps/mmio.md +msgid "" +"Some existing crates for volatile access to hardware do hold references, but " +"this is unsound. Whenever a reference exist, the compiler may choose to " +"dereference it." +msgstr "" +"ハードウェアへのvolatileアクセスを行うための既存のクレートには参照を保持する" +"ものがありますが、これは健全ではありません。参照が存在する間はいつでもコンパ" +"イラがその参照を外して（MMIO領域にアクセスして）しまう可能性があります。" + +#: src/bare-metal/aps/mmio.md +msgid "" +"Use the `addr_of!` macro to get struct field pointers from a pointer to the " +"struct." +msgstr "" +"構造体のポインタからそのフィールドへのポインタを得るには`addr_of!` マクロを" +"使ってください。" + +#: src/bare-metal/aps/uart.md +msgid "Let's write a UART driver" +msgstr "UARTドライバを書いてみましょう" + +#: src/bare-metal/aps/uart.md +msgid "" +"The QEMU 'virt' machine has a [PL011](https://developer.arm.com/" +"documentation/ddi0183/g) UART, so let's write a driver for that." +msgstr "" +"QEMUの'virt' マシンには[PL011](https://developer.arm.com/documentation/" +"ddi0183/g)というUARTがあるので、それに対するドライバを書いてみましょう。" + +#: src/bare-metal/aps/uart.md +msgid "/// Minimal driver for a PL011 UART.\n" +msgstr "/// PL011 UARTの最小ドライバ。\n" + +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md +msgid "" +"/// Constructs a new instance of the UART driver for a PL011 device at the\n" +" /// given base address.\n" +" ///\n" +" /// # Safety\n" +" ///\n" +" /// The given base address must point to the 8 MMIO control registers of " +"a\n" +" /// PL011 device, which must be mapped into the address space of the " +"process\n" +" /// as device memory and not have any other aliases.\n" +msgstr "" +"/// 指定されたベースアドレスに存在する\n" +" /// PL011 デバイス用の UART ドライバの新しいインスタンスを作成します。\n" +" ///\n" +" /// # 安全性\n" +" ///\n" +" /// 指定されたベースアドレスは PL011 デバイスの 8 つの MMIO 制御レジスタ" +"を指していなければなりません。\n" +" /// これらはデバイスメモリとしてプロセスのアドレス空間に\n" +" /// マッピングされ、他のエイリアスはありません。\n" + +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md +msgid "/// Writes a single byte to the UART.\n" +msgstr "/// UART に 1 バイトを書き込みます。\n" + +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md +msgid "// Wait until there is room in the TX buffer.\n" +msgstr "// TX バッファに空きができるまで待機します。\n" + +#: src/bare-metal/aps/uart.md +#, fuzzy +msgid "" +"// SAFETY: We know that the base address points to the control\n" +" // registers of a PL011 device which is appropriately mapped.\n" +msgstr "" +"// ベースアドレスが、適切にマッピングされた PL011 デバイスのコントロール レジ" +"スタを\n" +" // 指していることがわかっているため、安全です。\n" + +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md +msgid "// Write to the TX buffer.\n" +msgstr "// TX バッファに書き込みます。\n" + +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md +msgid "// Wait until the UART is no longer busy.\n" +msgstr "// UART がビジーでなくなるまで待機します。\n" + +#: src/bare-metal/aps/uart.md +msgid "" +"Note that `Uart::new` is unsafe while the other methods are safe. This is " +"because as long as the caller of `Uart::new` guarantees that its safety " +"requirements are met (i.e. that there is only ever one instance of the " +"driver for a given UART, and nothing else aliasing its address space), then " +"it is always safe to call `write_byte` later because we can assume the " +"necessary preconditions." +msgstr "" +"`Uart::new`がアンセーフでその他のメソッドがセーフであるということに注目してく" +"ださい。これは、`Uart::new`の安全性要求が満たされている（すなわち特定のUARTに" +"対して一つしかドライバのインスタンスが存在せず、そのアドレス空間に対してエイ" +"リアスが全く存在しない）ことをその呼び出し元が保証する限り、それ以降は必要な" +"事前条件が満たされていると想定することができ`write_byte`を常に安全に呼び出す" +"ことができるようになることが理由です。" + +#: src/bare-metal/aps/uart.md +msgid "" +"We could have done it the other way around (making `new` safe but " +"`write_byte` unsafe), but that would be much less convenient to use as every " +"place that calls `write_byte` would need to reason about the safety" +msgstr "" +"逆に（`new`をセーフにして、`write_byte` をアンセーフに）することもできました" +"が、そうすると`write_byte`の全呼び出し箇所において安全性を考慮しなければなら" +"なくなり、利便性が低下します" + +#: src/bare-metal/aps/uart.md +msgid "" +"This is a common pattern for writing safe wrappers of unsafe code: moving " +"the burden of proof for soundness from a large number of places to a smaller " +"number of places." +msgstr "" +"これはアンセーフなコードに対してセーフなラッパーを構築する場合の共通パターン" +"です：健全性に関する証明に関する労力を多数の場所から少数の場所に集約します。" + +#: src/bare-metal/aps/uart/traits.md +msgid "More traits" +msgstr "他のトレイト" + +#: src/bare-metal/aps/uart/traits.md +msgid "" +"We derived the `Debug` trait. It would be useful to implement a few more " +"traits too." +msgstr "" +"ここでは`Debug`トレイトを導出しました。この他にもいくつかのトレイトを実装する" +"と良いでしょう。" + +#: src/bare-metal/aps/uart/traits.md +#, fuzzy +msgid "" +"// SAFETY: `Uart` just contains a pointer to device memory, which can be\n" +"// accessed from any context.\n" +msgstr "" +"// デバイスメモリへのポインタのみが含まれ、どのコンテキストからでも\n" +"// アクセスできるため、安全です。\n" + +#: src/bare-metal/aps/uart/traits.md +msgid "" +"Implementing `Write` lets us use the `write!` and `writeln!` macros with our " +"`Uart` type." +msgstr "" +"`Write`を実装すると、`Uart` タイプに対して `write!`と`writeln!`マクロが利用で" +"きるようになります。" + +#: src/bare-metal/aps/uart/traits.md +msgid "" +"Run the example in QEMU with `make qemu_minimal` under `src/bare-metal/aps/" +"examples`." +msgstr "" +"この例を`src/bare-metal/aps/examples`において`make qemu_minimal`とすること" +"で、QEMUにより実行してみましょう。" + +#: src/bare-metal/aps/better-uart.md +msgid "A better UART driver" +msgstr "UARTドライバの改善" + +#: src/bare-metal/aps/better-uart.md +msgid "" +"The PL011 actually has [a bunch more registers](https://developer.arm.com/" +"documentation/ddi0183/g/programmers-model/summary-of-registers), and adding " +"offsets to construct pointers to access them is error-prone and hard to " +"read. Plus, some of them are bit fields which would be nice to access in a " +"structured way." +msgstr "" +"実際のところPL011には[もっと多くのレジスタ](https://developer.arm.com/" +"documentation/ddi0183/g/programmers-model/summary-of-registers)があり、それら" +"にアクセスするためにオフセットを足してポインタを得ることは間違えになりやす" +"く、可読性を低下させます。さらに、いくつかはビットフィールドなので、構造化さ" +"れた方法でアクセスできたほうが良いでしょう。" + +#: src/bare-metal/aps/better-uart.md +msgid "Offset" +msgstr "オフセット" + +#: src/bare-metal/aps/better-uart.md +msgid "Register name" +msgstr "レジスタ名" + +#: src/bare-metal/aps/better-uart.md +msgid "Width" +msgstr "幅" + +#: src/bare-metal/aps/better-uart.md +msgid "0x00" +msgstr "0x00" + +#: src/bare-metal/aps/better-uart.md +msgid "DR" +msgstr "DR" + +#: src/bare-metal/aps/better-uart.md +msgid "12" +msgstr "12" + +#: src/bare-metal/aps/better-uart.md +msgid "0x04" +msgstr "0x04" + +#: src/bare-metal/aps/better-uart.md +msgid "RSR" +msgstr "RSR" + +#: src/bare-metal/aps/better-uart.md +msgid "4" +msgstr "4" + +#: src/bare-metal/aps/better-uart.md +msgid "0x18" +msgstr "0x18" + +#: src/bare-metal/aps/better-uart.md +msgid "FR" +msgstr "FR" + +#: src/bare-metal/aps/better-uart.md +msgid "9" +msgstr "9" + +#: src/bare-metal/aps/better-uart.md +msgid "0x20" +msgstr "0x20" + +#: src/bare-metal/aps/better-uart.md +msgid "ILPR" +msgstr "ILPR" + +#: src/bare-metal/aps/better-uart.md +msgid "8" +msgstr "8" + +#: src/bare-metal/aps/better-uart.md +msgid "0x24" +msgstr "0x24" + +#: src/bare-metal/aps/better-uart.md +msgid "IBRD" +msgstr "IBRD" + +#: src/bare-metal/aps/better-uart.md +msgid "16" +msgstr "16" + +#: src/bare-metal/aps/better-uart.md +msgid "0x28" +msgstr "0x28" + +#: src/bare-metal/aps/better-uart.md +msgid "FBRD" +msgstr "FBRD" + +#: src/bare-metal/aps/better-uart.md +msgid "6" +msgstr "6" + +#: src/bare-metal/aps/better-uart.md +msgid "0x2c" +msgstr "0x2c" + +#: src/bare-metal/aps/better-uart.md +msgid "LCR_H" +msgstr "LCR_H" + +#: src/bare-metal/aps/better-uart.md +msgid "0x30" +msgstr "0x30" + +#: src/bare-metal/aps/better-uart.md +msgid "CR" +msgstr "CR" + +#: src/bare-metal/aps/better-uart.md +msgid "0x34" +msgstr "0x34" + +#: src/bare-metal/aps/better-uart.md +msgid "IFLS" +msgstr "IFLS" + +#: src/bare-metal/aps/better-uart.md +msgid "0x38" +msgstr "0x38" + +#: src/bare-metal/aps/better-uart.md +msgid "IMSC" +msgstr "IMSC" + +#: src/bare-metal/aps/better-uart.md +msgid "11" +msgstr "11" + +#: src/bare-metal/aps/better-uart.md +msgid "0x3c" +msgstr "0x3c" + +#: src/bare-metal/aps/better-uart.md +msgid "RIS" +msgstr "RIS" + +#: src/bare-metal/aps/better-uart.md +msgid "0x40" +msgstr "0x40" + +#: src/bare-metal/aps/better-uart.md +msgid "MIS" +msgstr "MIS" + +#: src/bare-metal/aps/better-uart.md +msgid "0x44" +msgstr "0x44" + +#: src/bare-metal/aps/better-uart.md +msgid "ICR" +msgstr "ICR" + +#: src/bare-metal/aps/better-uart.md +msgid "0x48" +msgstr "0x48" + +#: src/bare-metal/aps/better-uart.md +msgid "DMACR" +msgstr "DMACR" + +#: src/bare-metal/aps/better-uart.md +msgid "3" +msgstr "3" + +#: src/bare-metal/aps/better-uart.md +msgid "There are also some ID registers which have been omitted for brevity." +msgstr "いくつかのIDレジスタは簡単化のための省略しています。" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "" +"The [`bitflags`](https://crates.io/crates/bitflags) crate is useful for " +"working with bitflags." +msgstr "" +"[`bitflags`](https://crates.io/crates/bitflags) クレートはビットフラグを扱う" +"のに便利です。" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Flags from the UART flag register.\n" +msgstr "/// UART フラグレジスタからのフラグ。\n" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Clear to send.\n" +msgstr "/// 送信可。\n" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Data set ready.\n" +msgstr "/// データセット レディ。\n" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Data carrier detect.\n" +msgstr "/// データキャリア検出。\n" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// UART busy transmitting data.\n" +msgstr "/// UART はデータ送信のためビジー状態。\n" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Receive FIFO is empty.\n" +msgstr "/// 受信 FIFO が空。\n" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Transmit FIFO is full.\n" +msgstr "/// 送信 FIFO が満杯。\n" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Receive FIFO is full.\n" +msgstr "/// 受信 FIFO が満杯。\n" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Transmit FIFO is empty.\n" +msgstr "/// 送信 FIFO が空。\n" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Ring indicator.\n" +msgstr "/// 着呼表示。\n" + +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "" +"The `bitflags!` macro creates a newtype something like `Flags(u16)`, along " +"with a bunch of method implementations to get and set flags." +msgstr "" +"`bitflags!`マクロは`Flags(u16)`のような新しいタイプを生成し、フラグを読み書き" +"するための多くのメソッド実装を一緒に提供します。" + +#: src/bare-metal/aps/better-uart/registers.md +msgid "Multiple registers" +msgstr "複数のレジスタ" + +#: src/bare-metal/aps/better-uart/registers.md +msgid "" +"We can use a struct to represent the memory layout of the UART's registers." +msgstr "" +"構造体を使ってUARTのレジスタのメモリレイアウトを表現することができます。" + +#: src/bare-metal/aps/better-uart/registers.md +msgid "" +"[`#[repr(C)]`](https://doc.rust-lang.org/reference/type-layout.html#the-c-" +"representation) tells the compiler to lay the struct fields out in order, " +"following the same rules as C. This is necessary for our struct to have a " +"predictable layout, as default Rust representation allows the compiler to " +"(among other things) reorder fields however it sees fit." +msgstr "" +"[`#[repr(C)]`](https://doc.rust-lang.org/reference/type-layout.html#the-c-" +"representation) はコンパイラに対して、Cと同じ規則に従って構造体のフィールドを" +"定義されている順番で配置することを指示します。これは構造体のレイアウトを予測" +"可能にするために必要です。なぜならば、Rust標準の表現はコンパイラがフィールド" +"を好きなように並び替えること（他にも色々とありますが）を許しているからです。" + +#: src/bare-metal/aps/better-uart/driver.md +msgid "Now let's use the new `Registers` struct in our driver." +msgstr "新しく定義した`Registers` 構造体を我々のドライバで使ってみましょう。" + +#: src/bare-metal/aps/better-uart/driver.md +msgid "/// Driver for a PL011 UART.\n" +msgstr "/// PL011 UART のドライバ。\n" + +#: src/bare-metal/aps/better-uart/driver.md +#, fuzzy +msgid "" +"// SAFETY: We know that self.registers points to the control registers\n" +" // of a PL011 device which is appropriately mapped.\n" +msgstr "" +"// self.registers が、適切にマッピングされた PL011 デバイスのコントロール レ" +"ジスタを\n" +" // 指していることがわかっているため、安全です。\n" + +#: src/bare-metal/aps/better-uart/driver.md +msgid "" +"/// Reads and returns a pending byte, or `None` if nothing has been\n" +" /// received.\n" +msgstr "" +"/// 保留中のバイトを読み取り、何も受け取っていない場合は`None` を\n" +" /// 返します。\n" + +#: src/bare-metal/aps/better-uart/driver.md +#, fuzzy +msgid "" +"// SAFETY: We know that self.registers points to the control\n" +" // registers of a PL011 device which is appropriately mapped.\n" +msgstr "" +"// self.registers が、適切にマッピングされた PL011 デバイスのコントロール レ" +"ジスタを\n" +" // 指していることがわかっているため、安全です。\n" + +#: src/bare-metal/aps/better-uart/driver.md +msgid "// TODO: Check for error conditions in bits 8-11.\n" +msgstr "// TODO: ビット 8～11 でエラー状態をチェックします。\n" + +#: src/bare-metal/aps/better-uart/driver.md +msgid "" +"Note the use of `addr_of!` / `addr_of_mut!` to get pointers to individual " +"fields without creating an intermediate reference, which would be unsound." +msgstr "" +"`addr_of!`と`addr_of_mut!` を使用して個々のフィールドに対するポインタを取得す" +"ることで、不健全となってしまう中間的な参照を作らずに済んでいることに注目して" +"ください。" + +#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md +msgid "Using it" +msgstr "使用例" + +#: src/bare-metal/aps/better-uart/using.md +msgid "" +"Let's write a small program using our driver to write to the serial console, " +"and echo incoming bytes." +msgstr "" +"我々のドライバを使って、シリアルコンソールにライトし、そして入力されたバイト" +"をエコーする小さなプログラムを書いてみましょう。" + +#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Base address of the primary PL011 UART.\n" +msgstr "/// プライマリ PL011 UART のベースアドレス。\n" + +#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md +#: src/exercises/bare-metal/solutions-afternoon.md +#, fuzzy +msgid "" +"// SAFETY: `PL011_BASE_ADDRESS` is the base address of a PL011 device, and\n" +" // nothing else accesses that address range.\n" +msgstr "" +"// `PL011_BASE_ADDRESS` が PL011 デバイスのベースアドレスであり、\n" +" // 他からこのアドレス範囲にアクセスされることがないため、安全です。\n" + +#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md +msgid "\"main({x0:#x}, {x1:#x}, {x2:#x}, {x3:#x})\"" +msgstr "\"main({x0:#x}, {x1:#x}, {x2:#x}, {x3:#x})\"" + +#: src/bare-metal/aps/better-uart/using.md +msgid "b'\\r'" +msgstr "b'\\r'" + +#: src/bare-metal/aps/better-uart/using.md +#: src/concurrency/async-pitfalls/cancellation.md +msgid "b'\\n'" +msgstr "b'\\n'" + +#: src/bare-metal/aps/better-uart/using.md +msgid "b'q'" +msgstr "b'q'" + +#: src/bare-metal/aps/better-uart/using.md +msgid "\"Bye!\"" +msgstr "\"Bye!\"" + +#: src/bare-metal/aps/better-uart/using.md +msgid "" +"As in the [inline assembly](../inline-assembly.md) example, this `main` " +"function is called from our entry point code in `entry.S`. See the speaker " +"notes there for details." +msgstr "" +"[インラインアセンブリ](../inline-assembly.md) の例と同じように、この`main`関" +"数は`entry.S`におけるエントリポイントから呼び出されます。詳細はそちらの" +"speaker notesを参照してください。" + +#: src/bare-metal/aps/better-uart/using.md +msgid "" +"Run the example in QEMU with `make qemu` under `src/bare-metal/aps/examples`." +msgstr "" +"この例を`src/bare-metal/aps/examples`において`make qemu`とすることでQEMUによ" +"り実行してみましょう。" + +#: src/bare-metal/aps/logging.md +msgid "" +"It would be nice to be able to use the logging macros from the [`log`]" +"(https://crates.io/crates/log) crate. We can do this by implementing the " +"`Log` trait." +msgstr "" +"[`log`](https://crates.io/crates/log) クレートが提供するログ用マクロを使える" +"と良いでしょう。これは`Log`トレイトを実装することで可能になります。" + +#: src/bare-metal/aps/logging.md +msgid "\"[{}] {}\"" +msgstr "\"[{}] {}\"" + +#: src/bare-metal/aps/logging.md +msgid "/// Initialises UART logger.\n" +msgstr "/// UART ロガーを初期化します。\n" + +#: src/bare-metal/aps/logging.md +msgid "" +"The unwrap in `log` is safe because we initialise `LOGGER` before calling " +"`set_logger`." +msgstr "" +"`LOGGER` を`set_logger`を呼び出す前に初期化しているので、log` におけるunwrap" +"はセーフです。" + +#: src/bare-metal/aps/logging/using.md +msgid "We need to initialise the logger before we use it." +msgstr "使用前にloggerを初期化する必要があります。" + +#: src/bare-metal/aps/logging/using.md +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "\"{info}\"" +msgstr "\"{info}\"" + +#: src/bare-metal/aps/logging/using.md +msgid "Note that our panic handler can now log details of panics." +msgstr "" +"我々のパニックハンドラがパニックの詳細についてログ出力できるようになったこと" +"に注目してください。" + +#: src/bare-metal/aps/logging/using.md +msgid "" +"Run the example in QEMU with `make qemu_logger` under `src/bare-metal/aps/" +"examples`." +msgstr "" +"この例を`src/bare-metal/aps/examples`において`make qemu_logger`とすることで" +"QEMUにより実行してみましょう。" + +#: src/bare-metal/aps/exceptions.md +msgid "" +"AArch64 defines an exception vector table with 16 entries, for 4 types of " +"exceptions (synchronous, IRQ, FIQ, SError) from 4 states (current EL with " +"SP0, current EL with SPx, lower EL using AArch64, lower EL using AArch32). " +"We implement this in assembly to save volatile registers to the stack before " +"calling into Rust code:" +msgstr "" +"AArch64は16エントリを持つ例外ベクターテーブルを定義しており、これらは４つのス" +"テート（現在のELでSP0利用、現在のELでSPx利用、低位のELでAArch64、低位のELで" +"AArch32）における４つのタイプの例外（同期、IRQ、FIQ、SError）に対応します。こ" +"こではRustコードの呼び出し前に揮発レジスタの値をスタックに退避するためにベク" +"ターテーブルをアセンブリ言語で実装しています：" + +#: src/bare-metal/aps/exceptions.md +msgid "EL is exception level; all our examples this afternoon run in EL1." +msgstr "" +"ELは例外レベルです。本日の午後に扱ったすべての例はEL1で実行されています。" + +#: src/bare-metal/aps/exceptions.md +msgid "" +"For simplicity we aren't distinguishing between SP0 and SPx for the current " +"EL exceptions, or between AArch32 and AArch64 for the lower EL exceptions." +msgstr "" +"簡単化のために、ここでは現在のEL例外におけるSP0とSPｘの違い、低位のELレベルに" +"おけるAArch32とAArch64の違いを区別していません。" + +#: src/bare-metal/aps/exceptions.md +msgid "" +"For this example we just log the exception and power down, as we don't " +"expect any of them to actually happen." +msgstr "" +"ここではこれらの例外が発生しないはずなので、ただ例外に関するログを出力し、電" +"源を落としています。" + +#: src/bare-metal/aps/exceptions.md +msgid "" +"We can think of exception handlers and our main execution context more or " +"less like different threads. [`Send` and `Sync`](../../concurrency/send-sync." +"md) will control what we can share between them, just like with threads. For " +"example, if we want to share some value between exception handlers and the " +"rest of the program, and it's `Send` but not `Sync`, then we'll need to wrap " +"it in something like a `Mutex` and put it in a static." +msgstr "" +"例外ハンドラとメインの実行コンテキストは異なるスレッドのようなものだと考える" +"ことができます。ちょうどスレッド間の共有と同じように、[`Send`と`Sync`](../../" +"concurrency/send-sync.md)により何を共有するかを制御することができます。例え" +"ば、例外ハンドラとプログラムの他のコンテキストでとある値を共有したい場合に、" +"もしそれが `Send`であり`Sync`でなければ、`Mutex` のようなものでラップして、" +"staticに定義しなければなりません。" + +#: src/bare-metal/aps/other-projects.md +msgid "[oreboot](https://github.com/oreboot/oreboot)" +msgstr "[oreboot](https://github.com/oreboot/oreboot)" + +#: src/bare-metal/aps/other-projects.md +msgid "\"coreboot without the C\"" +msgstr "\"Cのない（つまり、C言語を使わない）coreboot\"" + +#: src/bare-metal/aps/other-projects.md +msgid "Supports x86, aarch64 and RISC-V." +msgstr "アーキテクチャはx86、aarch64ならびにRISC-Vをサポート。" + +#: src/bare-metal/aps/other-projects.md +msgid "Relies on LinuxBoot rather than having many drivers itself." +msgstr "自身で多くのドライバを抱えずにLinuxBootに依存。" + +#: src/bare-metal/aps/other-projects.md +msgid "" +"[Rust RaspberryPi OS tutorial](https://github.com/rust-embedded/rust-" +"raspberrypi-OS-tutorials)" +msgstr "" +"[Rust RaspberryPi OS のチュートリアル](https://github.com/rust-embedded/rust-" +"raspberrypi-OS-tutorials)" + +#: src/bare-metal/aps/other-projects.md +msgid "" +"Initialisation, UART driver, simple bootloader, JTAG, exception levels, " +"exception handling, page tables" +msgstr "" +"初期化、UARTドライバ、単純なブートローダ、JTAG、例外レベル、例外ハンドラ、" +"ページテーブル" + +#: src/bare-metal/aps/other-projects.md +msgid "" +"Some dodginess around cache maintenance and initialisation in Rust, not " +"necessarily a good example to copy for production code." +msgstr "" +"キャッシュメンテナンスとRustの初期化に関してちょっと疑わしいところがあるの" +"で、製品コードで真似するには必ずしも良い例ではありません。" + +#: src/bare-metal/aps/other-projects.md +msgid "[`cargo-call-stack`](https://crates.io/crates/cargo-call-stack)" +msgstr "[`cargo-call-stack`](https://crates.io/crates/cargo-call-stack)" + +#: src/bare-metal/aps/other-projects.md +msgid "Static analysis to determine maximum stack usage." +msgstr "スタックの最大使用量に関する静的解析。" + +#: src/bare-metal/aps/other-projects.md +msgid "" +"The RaspberryPi OS tutorial runs Rust code before the MMU and caches are " +"enabled. This will read and write memory (e.g. the stack). However:" +msgstr "" +"RaspberryPi OS チュートリアルはMMUやキャッシュを有効化する前にRustコードを実" +"行しています。これにより、例えばスタックメモリをreadしたりwriteしたりすること" +"になります。しかし：" + +#: src/bare-metal/aps/other-projects.md +msgid "" +"Without the MMU and cache, unaligned accesses will fault. It builds with " +"`aarch64-unknown-none` which sets `+strict-align` to prevent the compiler " +"generating unaligned accesses so it should be alright, but this is not " +"necessarily the case in general." +msgstr "" +"MMUとキャッシュを有効化していないと、アラインされていないアクセスはフォールト" +"を引き起こします。そのチュートリアルでは、コンパイラがアラインされていないア" +"クセスを生成しない`+strict-align`オプションをセットする`aarch64-unknown-none`" +"をターゲットとしてビルドしているので大丈夫なはずですが、一般的には大丈夫とは" +"限りません。" + +#: src/bare-metal/aps/other-projects.md +msgid "" +"If it were running in a VM, this can lead to cache coherency issues. The " +"problem is that the VM is accessing memory directly with the cache disabled, " +"while the host has cacheable aliases to the same memory. Even if the host " +"doesn't explicitly access the memory, speculative accesses can lead to cache " +"fills, and then changes from one or the other will get lost. Again this is " +"alright in this particular case (running directly on the hardware with no " +"hypervisor), but isn't a good pattern in general." +msgstr "" +"もしVM上で実行していたとすると、キャッシュコヒーレンシーの問題を起こすことが" +"あります。問題なのはVMがキャッシュを無効化したまま直接メモリにアクセスしてい" +"るのに対し、ホストは同じメモリに対してキャッシュ可能なエイリアスを持ってしま" +"うということです。ホストが仮に明示的にメモリにアクセスしないとしても、投機的" +"なアクセスによりキャッシュフィルが起きることがあり、そうなるとVMかホストのど" +"ちらかによる変更が失われてしまいます。この（ハイパーバイザなしで直接ハード" +"ウェアで実行する）場合には問題にはなりませんが、一般的には良くないパターンで" +"す。" + +#: src/bare-metal/useful-crates.md +msgid "Useful crates" +msgstr "便利クレート" + +#: src/bare-metal/useful-crates.md +msgid "" +"We'll go over a few crates which solve some common problems in bare-metal " +"programming." +msgstr "" +"ベアメタルプログラミングにおいて共通に発生する問題に対する解を与えるクレート" +"についていくつか紹介します。" + +#: src/bare-metal/useful-crates/zerocopy.md +msgid "" +"The [`zerocopy`](https://docs.rs/zerocopy/) crate (from Fuchsia) provides " +"traits and macros for safely converting between byte sequences and other " +"types." +msgstr "" +"（Fuchsiaの）[`zerocopy`](https://docs.rs/zerocopy/)クレートはバイトシーケン" +"スとその他の型の変換を安全に行うためのトレイトやマクロを提供します。" + +#: src/bare-metal/useful-crates/zerocopy.md +msgid "" +"This is not suitable for MMIO (as it doesn't use volatile reads and writes), " +"but can be useful for working with structures shared with hardware e.g. by " +"DMA, or sent over some external interface." +msgstr "" +"これは（volatile read、writeを使用していないため）MMIOには適してませんが、例" +"えばDMAのようなハードウェアと共有するデータ構造あるいは外部インタフェースを通" +"して送信するデータ構造を扱うに場合には有用です。" + +#: src/bare-metal/useful-crates/zerocopy.md +msgid "" +"`FromBytes` can be implemented for types for which any byte pattern is " +"valid, and so can safely be converted from an untrusted sequence of bytes." +msgstr "" +"`FromBytes`はいかなるバイトパターンも有効な値となる型に対して実装することがで" +"き、信用できないバイトシーケンスからの安全な変換を可能にします。" + +#: src/bare-metal/useful-crates/zerocopy.md +msgid "" +"Attempting to derive `FromBytes` for these types would fail, because " +"`RequestType` doesn't use all possible u32 values as discriminants, so not " +"all byte patterns are valid." +msgstr "" +"`RequestType`はu32型のすべての値を有効なenum値として定義していないので、すべ" +"てのバイトパターンが有効とはならず、これらに対する`FromBytes`の導出はフェール" +"するでしょう。" + +#: src/bare-metal/useful-crates/zerocopy.md +msgid "" +"`zerocopy::byteorder` has types for byte-order aware numeric primitives." +msgstr "" +"`zerocopy::byteorder`はバイトオーダを気にする数値プリミティブに関する型を提供" +"します。" + +#: src/bare-metal/useful-crates/zerocopy.md +msgid "" +"Run the example with `cargo run` under `src/bare-metal/useful-crates/" +"zerocopy-example/`. (It won't run in the Playground because of the crate " +"dependency.)" +msgstr "" +"この例を`src/bare-metal/useful-crates/zerocopy-example/`において`cargo run`と" +"とすることで実行してみましょう。（Playgroundではこの例が依存するクレートを利" +"用できないため実行できません）" + +#: src/bare-metal/useful-crates/aarch64-paging.md +msgid "" +"The [`aarch64-paging`](https://crates.io/crates/aarch64-paging) crate lets " +"you create page tables according to the AArch64 Virtual Memory System " +"Architecture." +msgstr "" +"[`aarch64-paging`](https://crates.io/crates/aarch64-paging)クレートはAArch64" +"仮想メモリシステムアーキテクチャに則ったページテーブルの生成を可能にします。" + +#: src/bare-metal/useful-crates/aarch64-paging.md +msgid "// Create a new page table with identity mapping.\n" +msgstr "// 仮想物理同一となる新しいページテーブルを作成します。\n" + +#: src/bare-metal/useful-crates/aarch64-paging.md +msgid "// Map a 2 MiB region of memory as read-only.\n" +msgstr "// 2 MiB のメモリ領域を読み取り専用としてマッピングします。\n" + +#: src/bare-metal/useful-crates/aarch64-paging.md +msgid "// Set `TTBR0_EL1` to activate the page table.\n" +msgstr "// `TTBR0_EL1` を設定してページテーブルを有効にします。\n" + +#: src/bare-metal/useful-crates/aarch64-paging.md +msgid "" +"For now it only supports EL1, but support for other exception levels should " +"be straightforward to add." +msgstr "" +"現時点ではEL1しかサポートされていませんが、他の例外レベルのサポートも簡単に追" +"加できるはずです。" + +#: src/bare-metal/useful-crates/aarch64-paging.md +msgid "" +"This is used in Android for the [Protected VM Firmware](https://cs.android." +"com/android/platform/superproject/+/master:packages/modules/Virtualization/" +"pvmfw/)." +msgstr "" +"これはAndroidで[Protected VM Firmware](https://cs.android.com/android/" +"platform/superproject/+/master:packages/modules/Virtualization/pvmfw/)のため" +"に利用されています。" + +#: src/bare-metal/useful-crates/aarch64-paging.md +msgid "" +"There's no easy way to run this example, as it needs to run on real hardware " +"or under QEMU." +msgstr "" +"この例は本物のハードウェアかQEMUを必要とするので、簡単には実行できません。" + +#: src/bare-metal/useful-crates/buddy_system_allocator.md +msgid "" +"[`buddy_system_allocator`](https://crates.io/crates/buddy_system_allocator) " +"is a third-party crate implementing a basic buddy system allocator. It can " +"be used both for [`LockedHeap`](https://docs.rs/buddy_system_allocator/0.9.0/" +"buddy_system_allocator/struct.LockedHeap.html) implementing [`GlobalAlloc`]" +"(https://doc.rust-lang.org/core/alloc/trait.GlobalAlloc.html) so you can use " +"the standard `alloc` crate (as we saw [before](../alloc.md)), or for " +"allocating other address space. For example, we might want to allocate MMIO " +"space for PCI BARs:" +msgstr "" +"[`buddy_system_allocator`](https://crates.io/crates/buddy_system_allocator) " +"はサードパーティのクレートで、基本的なバディシステムアローケータを実装してい" +"ます。このクレートは[`GlobalAlloc`](https://doc.rust-lang.org/core/alloc/" +"trait.GlobalAlloc.html) を実装する [`LockedHeap`](https://docs.rs/" +"buddy_system_allocator/0.9.0/buddy_system_allocator/struct.LockedHeap.html) " +"により（ [以前](../alloc.md)見たように）標準の`alloc` クレートを利用可能にす" +"るために使えますし、別のアドレス空間をアロケートするためにも使えます。例え" +"ば、PCI BARに対するMMIO領域をアロケートしたい場合には以下のようにできます：" + +#: src/bare-metal/useful-crates/buddy_system_allocator.md +msgid "PCI BARs always have alignment equal to their size." +msgstr "PCI BARは常にサイズと同じアラインになります。" + +#: src/bare-metal/useful-crates/buddy_system_allocator.md +msgid "" +"Run the example with `cargo run` under `src/bare-metal/useful-crates/" +"allocator-example/`. (It won't run in the Playground because of the crate " +"dependency.)" +msgstr "" +"この例を`src/bare-metal/useful-crates/allocator-example/`において `cargo run`" +"とすることで実行してみましょう。（Playgroundではこの例が依存するクレートを利" +"用できないため実行できません）" + +#: src/bare-metal/useful-crates/tinyvec.md +msgid "" +"Sometimes you want something which can be resized like a `Vec`, but without " +"heap allocation. [`tinyvec`](https://crates.io/crates/tinyvec) provides " +"this: a vector backed by an array or slice, which could be statically " +"allocated or on the stack, which keeps track of how many elements are used " +"and panics if you try to use more than are allocated." +msgstr "" +"時には`Vec`のようにリサイズできる領域をヒープを使わずに確保したいと思うことが" +"あります。[`tinyvec`](https://crates.io/crates/tinyvec)は静的に確保、またはス" +"タック上に確保した配列またはスライスを割当領域とするベクタを提供します。この" +"実装では、いくつの要素が使われているかが管理され、確保された以上に使おうとす" +"るとパニックします。" + +#: src/bare-metal/useful-crates/tinyvec.md +msgid "" +"`tinyvec` requires that the element type implement `Default` for " +"initialisation." +msgstr "" +"`tinyvec` は初期化のために要素となるタイプが`Default`を実装することを必要とし" +"ます。" + +#: src/bare-metal/useful-crates/tinyvec.md +msgid "" +"The Rust Playground includes `tinyvec`, so this example will run fine inline." +msgstr "" +"Rust Playgroundは`tinyvec`を内包しているので、オンラインでこの例を実行するこ" +"とができます。" + +#: src/bare-metal/useful-crates/spin.md +msgid "" +"`std::sync::Mutex` and the other synchronisation primitives from `std::sync` " +"are not available in `core` or `alloc`. How can we manage synchronisation or " +"interior mutability, such as for sharing state between different CPUs?" +msgstr "" +"`std::sync`が提供する`std::sync::Mutex` とその他の同期プリミティブは`core`ま" +"たは`alloc`では利用できません。となると、例えば異なるCPU間での状態共有のため" +"の、同期や内部可変性はどのように実現したら良いのでしょうか？" + +#: src/bare-metal/useful-crates/spin.md +msgid "" +"The [`spin`](https://crates.io/crates/spin) crate provides spinlock-based " +"equivalents of many of these primitives." +msgstr "" +"[`spin`](https://crates.io/crates/spin) クレートはこれらの多くのプリミティブ" +"と等価なスピンロックベースのものを提供します。" + +#: src/bare-metal/useful-crates/spin.md +msgid "Be careful to avoid deadlock if you take locks in interrupt handlers." +msgstr "" +"割り込みハンドラでロックを取得する場合にはデッドロックを引き起こさないように" +"気をつけてください。" + +#: src/bare-metal/useful-crates/spin.md +#, fuzzy +msgid "" +"`spin` also has a ticket lock mutex implementation; equivalents of `RwLock`, " +"`Barrier` and `Once` from `std::sync`; and `Lazy` for lazy initialisation." +msgstr "" +"`spin` はチケットロックのミューテックス実装も持っています。これは`std::sync`" +"における`RwLock`, `Barrier`、`Once` と等価であり、またレイジー初期化の観点で" +"は`Lazy`と等価なものです。" + +#: src/bare-metal/useful-crates/spin.md +msgid "" +"The [`once_cell`](https://crates.io/crates/once_cell) crate also has some " +"useful types for late initialisation with a slightly different approach to " +"`spin::once::Once`." +msgstr "" +"[`once_cell`](https://crates.io/crates/once_cell) クレートも`spin::once::" +"Once`とは少し異なるアプローチの遅延初期化のための有用な型をいくつか持っていま" +"す。" + +#: src/bare-metal/useful-crates/spin.md +msgid "" +"The Rust Playground includes `spin`, so this example will run fine inline." +msgstr "" +"Rust Playgroundは`spin`を内包しているので、この例はオンラインで実行できます。" + +#: src/bare-metal/android.md +msgid "" +"To build a bare-metal Rust binary in AOSP, you need to use a " +"`rust_ffi_static` Soong rule to build your Rust code, then a `cc_binary` " +"with a linker script to produce the binary itself, and then a `raw_binary` " +"to convert the ELF to a raw binary ready to be run." +msgstr "" +"AOSPにおいてベアメタルRustバイナリをビルドするためには、Rustコードをビルドす" +"るための`rust_ffi_static`というSoongルール、リンカスクリプトとそれを使ってバ" +"イナリを生成するための`cc_binary`というルール、さらにELFを実行可能な形式の生" +"バイナリに変換する`raw_binary`というルールが必要です。" + +#: src/bare-metal/android/vmbase.md +msgid "vmbase" +msgstr "vmbase" + +#: src/bare-metal/android/vmbase.md +#, fuzzy +msgid "" +"For VMs running under crosvm on aarch64, the [vmbase](https://android." +"googlesource.com/platform/packages/modules/Virtualization/+/refs/heads/main/" +"libs/libvmbase/) library provides a linker script and useful defaults for " +"the build rules, along with an entry point, UART console logging and more." +msgstr "" +"[vmbase](https://android.googlesource.com/platform/packages/modules/" +"Virtualization/+/refs/heads/master/vmbase/)というライブラリは、aarch64上の" +"crosvm下で実行されるVMに対して、エントリポイント、UARTコンソールロギングなど" +"に加えて、リンカスクリプトと有用なデフォルトビルドルールを提供してくれます。" + +#: src/bare-metal/android/vmbase.md +msgid "" +"The `main!` macro marks your main function, to be called from the `vmbase` " +"entry point." +msgstr "" +"`main!`というマクロはメイン関数を指定するもので、指定された関数は`vmbase`のエ" +"ントリポイントから呼び出されることになります。" + +#: src/bare-metal/android/vmbase.md +msgid "" +"The `vmbase` entry point handles console initialisation, and issues a " +"PSCI_SYSTEM_OFF to shutdown the VM if your main function returns." +msgstr "" +"`vmbase`のエントリポイントはコンソールの初期化を行い、メイン関数がリターンし" +"た場合にはPSCI_SYSTEM_OFF を発行しVMをシャットダウンします。" + +#: src/exercises/bare-metal/afternoon.md +msgid "We will write a driver for the PL031 real-time clock device." +msgstr "PL031 リアルタイム クロック デバイス用のドライバを作成します。" + +#: src/exercises/bare-metal/afternoon.md +msgid "" +"After looking at the exercises, you can look at the [solutions](solutions-" +"afternoon.md) provided." +msgstr "" +"演習の終了後は、提供されている [ソリューション](solutions-afternoon.md) を確" +"認してください。" + +#: src/exercises/bare-metal/rtc.md +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "RTC driver" +msgstr "RTC ドライバ" + +#: src/exercises/bare-metal/rtc.md +msgid "" +"The QEMU aarch64 virt machine has a [PL031](https://developer.arm.com/" +"documentation/ddi0224/c) real-time clock at 0x9010000. For this exercise, " +"you should write a driver for it." +msgstr "" +"QEMU aarch64 virt マシンの 0x9010000 には、[PL031](https://developer.arm.com/" +"documentation/ddi0224/c) リアルタイム クロックが搭載されています。この演習で" +"は、そのドライバを作成する必要があります。" + +#: src/exercises/bare-metal/rtc.md +msgid "" +"Use it to print the current time to the serial console. You can use the " +"[`chrono`](https://crates.io/crates/chrono) crate for date/time formatting." +msgstr "" +"これを使用して現在の時刻をシリアル コンソールに出力します。日時の形式には " +"[`chrono`](https://crates.io/crates/chrono) クレートを使用できます。" + +#: src/exercises/bare-metal/rtc.md +msgid "" +"Use the match register and raw interrupt status to busy-wait until a given " +"time, e.g. 3 seconds in the future. (Call [`core::hint::spin_loop`](https://" +"doc.rust-lang.org/core/hint/fn.spin_loop.html) inside the loop.)" +msgstr "" +"一致レジスタと未加工の割り込みステータスを使用して、指定時刻（たとえば 3 秒" +"後）までビジーウェイトします（ループ内で [`core::hint::spin_loop`](https://" +"doc.rust-lang.org/core/hint/fn.spin_loop.html) を呼び出します）。" + +#: src/exercises/bare-metal/rtc.md +msgid "" +"_Extension if you have time:_ Enable and handle the interrupt generated by " +"the RTC match. You can use the driver provided in the [`arm-gic`](https://" +"docs.rs/arm-gic/) crate to configure the Arm Generic Interrupt Controller." +msgstr "" +"時間がある場合は、RTC の一致によって生成された割り込みを有効にして処理しま" +"す。[`arm-gic`](https://docs.rs/arm-gic/) クレートで提供されているドライバを" +"使用して、Arm 汎用割り込みコントローラを設定して構いません。" + +#: src/exercises/bare-metal/rtc.md +msgid "Use the RTC interrupt, which is wired to the GIC as `IntId::spi(2)`." +msgstr "" +"RTC 割り込みを使用します。この割り込みは GIC に `IntId::spi(2)` として接続さ" +"れています。" + +#: src/exercises/bare-metal/rtc.md +msgid "" +"Once the interrupt is enabled, you can put the core to sleep via `arm_gic::" +"wfi()`, which will cause the core to sleep until it receives an interrupt." +msgstr "" +"割り込みを有効にすると、`arm_gic::wfi()` を使用してコアをスリープさせることが" +"できます。これにより、コアは割り込みを受けるまでスリープ状態になります。" + +#: src/exercises/bare-metal/rtc.md +msgid "" +"Download the [exercise template](../../comprehensive-rust-exercises.zip) and " +"look in the `rtc` directory for the following files." +msgstr "" +"[演習テンプレート](../../comprehensive-rust-exercises.zip) をダウンロードし、" +"`rtc` ディレクトリで以下のファイルを探します。" + +#: src/exercises/bare-metal/rtc.md +msgid "" +"_src/exceptions.rs_ (you should only need to change this for the 3rd part of " +"the exercise):" +msgstr "" +"_src/exceptions.rs_（この演習の 3 番目のパートでのみ変更する必要があります）:" + +#: src/exercises/bare-metal/rtc.md +msgid "_src/logger.rs_ (you shouldn't need to change this):" +msgstr "_src/logger.rs_（変更する必要はありません）:" + +#: src/exercises/bare-metal/rtc.md +msgid "_src/pl011.rs_ (you shouldn't need to change this):" +msgstr "_src/pl011.rs_（変更する必要はありません）:" + +#: src/exercises/bare-metal/rtc.md +msgid "_build.rs_ (you shouldn't need to change this):" +msgstr "_build.rs_（変更する必要はありません）:" + +#: src/exercises/bare-metal/rtc.md +msgid "_entry.S_ (you shouldn't need to change this):" +msgstr "_entry.S_（変更する必要はありません）:" + +#: src/exercises/bare-metal/rtc.md +msgid "_exceptions.S_ (you shouldn't need to change this):" +msgstr "_exceptions.S_（変更する必要はありません）:" + +#: src/exercises/bare-metal/rtc.md +#, fuzzy +msgid "_idmap.S_ (you shouldn't need to change this):" +msgstr "_image.ld_（変更する必要はありません）:" + +#: src/exercises/bare-metal/rtc.md +msgid "_image.ld_ (you shouldn't need to change this):" +msgstr "_image.ld_（変更する必要はありません）:" + +#: src/exercises/bare-metal/rtc.md +msgid "_Makefile_ (you shouldn't need to change this):" +msgstr "_Makefile_（変更する必要はありません）:" + +#: src/exercises/bare-metal/rtc.md +msgid "Run the code in QEMU with `make qemu`." +msgstr "`make qemu`によりQEMU でコードを実行します。" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "Bare Metal Rust Afternoon" +msgstr "ベアメタルRust PM" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "([back to exercise](rtc.md))" +msgstr "（[演習に戻る](rtc.md)）" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "_main.rs_:" +msgstr "_main.rs_:" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Base addresses of the GICv3.\n" +msgstr "/// GICv3 のベースアドレス。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Base address of the PL031 RTC.\n" +msgstr "/// PL031 RTC のベースアドレス。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// The IRQ used by the PL031 RTC.\n" +msgstr "/// PL031 RTC が使用する IRQ。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "\"main({:#x}, {:#x}, {:#x}, {:#x})\"" +msgstr "\"main({:#x}, {:#x}, {:#x}, {:#x})\"" + +#: src/exercises/bare-metal/solutions-afternoon.md +#, fuzzy +msgid "" +"// SAFETY: `GICD_BASE_ADDRESS` and `GICR_BASE_ADDRESS` are the base\n" +" // addresses of a GICv3 distributor and redistributor respectively, and\n" +" // nothing else accesses those address ranges.\n" +msgstr "" +"// `GICD_BASE_ADDRESS` と `GICR_BASE_ADDRESS` がそれぞれ GICv3 の\n" +" // ディストリビューターと再ディストリビューターのベースアドレスであり、\n" +" // 他にはこれらのアドレス範囲にアクセスするものがないため、安全です。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +#, fuzzy +msgid "" +"// SAFETY: `PL031_BASE_ADDRESS` is the base address of a PL031 device, and\n" +" // nothing else accesses that address range.\n" +msgstr "" +"// `PL031_BASE_ADDRESS` が PL031 デバイスのベースアドレスであり、\n" +" // それ以外はこのアドレス範囲にアクセスしないため、安全です。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "\"RTC: {time}\"" +msgstr "\"RTC: {time}\"" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "// Wait for 3 seconds, without interrupts.\n" +msgstr "// 割り込みなしで 3 秒間待機します。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "\"Waiting for {}\"" +msgstr "\"Waiting for {}\"" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "\"matched={}, interrupt_pending={}\"" +msgstr "\"matched={}, interrupt_pending={}\"" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "\"Finished waiting\"" +msgstr "\"Finished waiting\"" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "// Wait another 3 seconds for an interrupt.\n" +msgstr "// 割り込みまでさらに 3 秒待ちます。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "_pl031.rs_:" +msgstr "_pl031.rs_:" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Data register\n" +msgstr "/// データレジスタ\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Match register\n" +msgstr "/// 一致レジスタ\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Load register\n" +msgstr "/// 読み込みレジスタ\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Control register\n" +msgstr "/// 制御レジスタ\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Interrupt Mask Set or Clear register\n" +msgstr "/// 割り込みマスクセットまたはクリアレジスタ\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Raw Interrupt Status\n" +msgstr "/// 未加工の割り込みステータス\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Masked Interrupt Status\n" +msgstr "/// マスクされた割り込みステータス\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Interrupt Clear Register\n" +msgstr "/// 割り込みクリアレジスタ\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Driver for a PL031 real-time clock.\n" +msgstr "/// PL031 リアルタイム クロック用のドライバ。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "" +"/// Constructs a new instance of the RTC driver for a PL031 device at the\n" +" /// given base address.\n" +" ///\n" +" /// # Safety\n" +" ///\n" +" /// The given base address must point to the MMIO control registers of " +"a\n" +" /// PL031 device, which must be mapped into the address space of the " +"process\n" +" /// as device memory and not have any other aliases.\n" +msgstr "" +"/// 指定されたベースアドレスに\n" +" /// PL031 デバイス用の RTC ドライバの新しいインスタンスを作成します。\n" +" ///\n" +" /// # 安全性\n" +" ///\n" +" /// 指定されたベースアドレスは PL031 デバイスの MMIO 制御レジスタを指して" +"いる必要があります。\n" +" /// これらはデバイスメモリとしてプロセスのアドレス空間に\n" +" /// マッピングされ、他のエイリアスはありません。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Reads the current RTC value.\n" +msgstr "/// 現在の RTC 値を読み取ります。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +#, fuzzy +msgid "" +"// SAFETY: We know that self.registers points to the control registers\n" +" // of a PL031 device which is appropriately mapped.\n" +msgstr "" +"// self.registers が、適切にマッピングされた PL031 デバイスのコントロール レ" +"ジスタを\n" +" // 指していることがわかっているため、安全です。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "" +"/// Writes a match value. When the RTC value matches this then an interrupt\n" +" /// will be generated (if it is enabled).\n" +msgstr "" +"/// 一致値を書き込みます。RTC 値がこれに一致すると、割り込みが生成されます\n" +" /// （割り込みが有効になっている場合）。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "" +"/// Returns whether the match register matches the RTC value, whether or " +"not\n" +" /// the interrupt is enabled.\n" +msgstr "" +"/// 割り込みが有効になっているかどうかに関係なく、一致レジスタが RTC 値と\n" +" /// 一致するかどうかを返します。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "" +"/// Returns whether there is currently an interrupt pending.\n" +" ///\n" +" /// This should be true if and only if `matched` returns true and the\n" +" /// interrupt is masked.\n" +msgstr "" +"/// 現在保留中の割り込みがあるかどうかを返します。\n" +" ///\n" +" /// これは `matched` が true を返し、割り込みがマスクされている場合にの" +"み\n" +" /// true になります。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "" +"/// Sets or clears the interrupt mask.\n" +" ///\n" +" /// When the mask is true the interrupt is enabled; when it is false " +"the\n" +" /// interrupt is disabled.\n" +msgstr "" +"/// 割り込みマスクを設定またはクリアします。\n" +" ///\n" +" /// マスクが true の場合、割り込みは有効になります。false の場合、\n" +" /// 割り込みは無効になります。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Clears a pending interrupt, if any.\n" +msgstr "/// 保留中の割り込みがあればクリアします。\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +#, fuzzy +msgid "" +"// SAFETY: `Rtc` just contains a pointer to device memory, which can be\n" +"// accessed from any context.\n" +msgstr "" +"// デバイスメモリへのポインタのみが含まれ、どのコンテキストからでも\n" +"// アクセスできるため、安全です。\n" + +#: src/concurrency/welcome.md +msgid "Welcome to Concurrency in Rust" +msgstr "Rustでの並行性へようこそ" + +#: src/concurrency/welcome.md +msgid "" +"Rust has full support for concurrency using OS threads with mutexes and " +"channels." +msgstr "" +"Rustはミューテックスとチャネルを用いてOSスレッドを扱う並行性を十分にサポート" +"しています。" + +#: src/concurrency/welcome.md +msgid "" +"The Rust type system plays an important role in making many concurrency bugs " +"compile time bugs. This is often referred to as _fearless concurrency_ since " +"you can rely on the compiler to ensure correctness at runtime." +msgstr "" +"Rustの型システムは多くの並行性にまつわるバグをコンパイル時のバグにとどめると" +"いう点で、重要な役割を果たします。これは時に _fearless concurrency_ （「怖く" +"ない並行性」） と呼ばれます。なぜなら、コンパイラに実行時での正しさを保証する" +"ことをまかせてよいためです。" + +#: src/concurrency/welcome.md src/concurrency/welcome-async.md +#, fuzzy +msgid "" +"Including 10 minute breaks, this session should take about 3 hours and 20 " +"minutes. It contains:" +msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 2 時間 20 分です。" + +#: src/concurrency/welcome.md +msgid "" +"Rust lets us access OS concurrency toolkit: threads, sync. primitives, etc." +msgstr "" + +#: src/concurrency/welcome.md +msgid "" +"The type system gives us safety for concurrency without any special features." +msgstr "" + +#: src/concurrency/welcome.md +msgid "" +"The same tools that help with \"concurrent\" access in a single thread (e." +"g., a called function that might mutate an argument or save references to it " +"to read later) save us from multi-threading issues." +msgstr "" + +#: src/concurrency/threads.md src/concurrency/shared-state.md +#: src/concurrency/async.md +#, fuzzy +msgid "This segment should take about 30 minutes. It contains:" +msgstr "このセグメントの所要時間は約 20 分です" + +#: src/concurrency/threads/plain.md +msgid "Rust threads work similarly to threads in other languages:" +msgstr "Rustのスレッドは他の言語のスレッドと似た挙動をします:" + +#: src/concurrency/threads/plain.md +msgid "\"Count in thread: {i}!\"" +msgstr "\"Count in thread: {i}!\"" + +#: src/concurrency/threads/plain.md +msgid "\"Main thread: {i}\"" +msgstr "\"Main thread: {i}\"" + +#: src/concurrency/threads/plain.md +msgid "" +"Spawning new threads does not automatically delay program termination at the " +"end of `main`." +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "Thread panics are independent of each other." +msgstr "スレッドパニックは互いに独立です。" + +#: src/concurrency/threads/plain.md +msgid "Panics can carry a payload, which can be unpacked with `downcast_ref`." +msgstr "" +"パニックはペイロードを保持していることがあり、それは`downcast_ref`で展開可能" +"です。" + +#: src/concurrency/threads/plain.md +msgid "Rust thread APIs look not too different from e.g. C++ ones." +msgstr "" + +#: src/concurrency/threads/plain.md +#, fuzzy +msgid "Run the example." +msgstr "例の実行方法:" + +#: src/concurrency/threads/plain.md +msgid "" +"5ms timing is loose enough that main and spawned threads stay mostly in " +"lockstep." +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "Notice that the program ends before the spawned thread reaches 10!" +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "" +"This is because main ends the program and spawned threads do not make it " +"persist." +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "Compare to pthreads/C++ std::thread/boost::thread if desired." +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "How do we wait around for the spawned thread to complete?" +msgstr "" + +#: src/concurrency/threads/plain.md +#, fuzzy +msgid "" +"[`thread::spawn`](https://doc.rust-lang.org/std/thread/fn.spawn.html) " +"returns a `JoinHandle`. Look at the docs." +msgstr "" +"[`Box`](https://doc.rust-lang.org/std/boxed/struct.Box.html) は、ヒープ上の" +"データへの所有ポインタです。" + +#: src/concurrency/threads/plain.md +msgid "" +"`JoinHandle` has a [`.join()`](https://doc.rust-lang.org/std/thread/struct." +"JoinHandle.html#method.join) method that blocks." +msgstr "" + +#: src/concurrency/threads/plain.md +#, fuzzy +msgid "" +"Use `let handle = thread::spawn(...)` and later `handle.join()` to wait for " +"the thread to finish and have the program count all the way to 10." +msgstr "" +"`let handle = thread::spawn(…)`と後に`handle.join()`を使って、スレッドが完了" +"するのを待ってみてください。" + +#: src/concurrency/threads/plain.md +msgid "Now what if we want to return a value?" +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "Look at docs again:" +msgstr "" + +#: src/concurrency/threads/plain.md +#, fuzzy +msgid "" +"[`thread::spawn`](https://doc.rust-lang.org/std/thread/fn.spawn.html)'s " +"closure returns `T`" +msgstr "" +"しかし、そのために[スコープ付きスレッド](https://doc.rust-lang.org/std/" +"thread/fn.scope.html)を使うことができます:" + +#: src/concurrency/threads/plain.md +msgid "" +"`JoinHandle` [`.join()`](https://doc.rust-lang.org/std/thread/struct." +"JoinHandle.html#method.join) returns `thread::Result`" +msgstr "" + +#: src/concurrency/threads/plain.md +#, fuzzy +msgid "" +"Use the `Result` return value from `handle.join()` to get access to the " +"returned value." +msgstr "" +"`handle.join()`の返り値の`Result`を使って、パニックペイロードへのアクセスを得" +"てみてください。 これは[`Any`](https://doc.rust-lang.org/std/any/index.html)" +"について話すのに良いタイミングです。" + +#: src/concurrency/threads/plain.md +msgid "Ok, what about the other case?" +msgstr "" + +#: src/concurrency/threads/plain.md +#, fuzzy +msgid "Trigger a panic in the thread. Note that this doesn't panic `main`." +msgstr "" +"スレッド内でパニックを引き起こしてみて、それがどのように`main`に影響しないか" +"を観察してみてください。" + +#: src/concurrency/threads/plain.md +#, fuzzy +msgid "" +"Access the panic payload. This is a good time to talk about [`Any`](https://" +"doc.rust-lang.org/std/any/index.html)." +msgstr "" +"`handle.join()`の返り値の`Result`を使って、パニックペイロードへのアクセスを得" +"てみてください。 これは[`Any`](https://doc.rust-lang.org/std/any/index.html)" +"について話すのに良いタイミングです。" + +#: src/concurrency/threads/plain.md +msgid "Now we can return values from threads! What about taking inputs?" +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "Capture something by reference in the thread closure." +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "An error message indicates we must move it." +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "Move it in, see we can compute and then return a derived value." +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "If we want to borrow?" +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "" +"Main kills child threads when it returns, but another function would just " +"return and leave them running." +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "That would be stack use-after-return, which violates memory safety!" +msgstr "" + +#: src/concurrency/threads/plain.md +msgid "How do we avoid this? see next slide." +msgstr "" + +#: src/concurrency/threads/scoped.md +msgid "Normal threads cannot borrow from their environment:" +msgstr "通常のスレッドはそれらの環境から借用することはできません:" + +#: src/concurrency/threads/scoped.md +msgid "" +"However, you can use a [scoped thread](https://doc.rust-lang.org/std/thread/" +"fn.scope.html) for this:" +msgstr "" +"しかし、そのために[スコープ付きスレッド](https://doc.rust-lang.org/std/" +"thread/fn.scope.html)を使うことができます:" + +#: src/concurrency/threads/scoped.md +msgid "" +"The reason for that is that when the `thread::scope` function completes, all " +"the threads are guaranteed to be joined, so they can return borrowed data." +msgstr "" +"この理由は、関数`thread::scope`が完了するとき、全てのスレッドはjoinされること" +"が保証されているので、スレッドが借用したデータを返すことができるためです。" + +#: src/concurrency/threads/scoped.md +msgid "" +"Normal Rust borrowing rules apply: you can either borrow mutably by one " +"thread, or immutably by any number of threads." +msgstr "" +"通常のRustの借用のルールが適用されます:　一つのスレッドがミュータブルで借用す" +"ること、または任意の数のスレッドからイミュータブルで借用すること。" + +#: src/concurrency/channels.md src/concurrency/async-control-flow.md +#, fuzzy +msgid "This segment should take about 20 minutes. It contains:" +msgstr "このセグメントの所要時間は約 20 分です" + +#: src/concurrency/channels/senders-receivers.md +msgid "" +"Rust channels have two parts: a `Sender` and a `Receiver`. The two " +"parts are connected via the channel, but you only see the end-points." +msgstr "" +"Rustのチャネルには二つの部品があります： `Sender` と`Receiver`です。こ" +"の２つの部品はチャネルによって繋がっていますが、見ることができるのはエンドポ" +"イントだけです。" + +#: src/concurrency/channels/senders-receivers.md +msgid "\"Received: {:?}\"" +msgstr "\"Received: {:?}\"" + +#: src/concurrency/channels/senders-receivers.md +msgid "" +"`mpsc` stands for Multi-Producer, Single-Consumer. `Sender` and `SyncSender` " +"implement `Clone` (so you can make multiple producers) but `Receiver` does " +"not." +msgstr "" +"`mpsc` は Multi-Producer, Single-Consumerの略称です。 `Sender`と`SyncSender`" +"は`Clone`を実装している（よって複数のproducerが作成可能）のですが、`Receiver`" +"についてはそうではありません。" + +#: src/concurrency/channels/senders-receivers.md +msgid "" +"`send()` and `recv()` return `Result`. If they return `Err`, it means the " +"counterpart `Sender` or `Receiver` is dropped and the channel is closed." +msgstr "" +"`send()`と`recv()`は`Result`を返します。もし`Err`が返された場合、これは、対応" +"する`Sender`か`Receiver`のいずれかがドロップされ、チャンネルが閉じられたこと" +"を意味します。" -#: src/exercises/bare-metal/solutions-morning.md -msgid "Bare Metal Rust Morning Exercise" -msgstr "ベアメタル Rust の午前の演習" +#: src/concurrency/channels/unbounded.md +msgid "You get an unbounded and asynchronous channel with `mpsc::channel()`:" +msgstr "Unboundedで非同期的なチャネルは`mpsc::channel()`によって得られます：" -#: src/exercises/bare-metal/solutions-morning.md -msgid "([back to exercise](compass.md))" -msgstr "（[演習に戻る](compass.md)）" +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md +msgid "\"Message {i}\"" +msgstr "\"Message {i}\"" -#: src/exercises/bare-metal/solutions-morning.md -msgid "// Set up the I2C controller and Inertial Measurement Unit.\n" -msgstr "// I2C コントローラと慣性測定ユニットをセットアップします。\n" +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md +msgid "\"{thread_id:?}: sent Message {i}\"" +msgstr "\"{thread_id:?}: sent Message {i}\"" -#: src/exercises/bare-metal/solutions-morning.md -msgid "\"Setting up IMU...\"" -msgstr "\"Setting up IMU...\"" +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md +msgid "\"{thread_id:?}: done\"" +msgstr "\"{thread_id:?}: done\"" -#: src/exercises/bare-metal/solutions-morning.md -msgid "// Set up display and timer.\n" -msgstr "// ディスプレイとタイマーをセットアップします。\n" +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md +msgid "\"Main: got {msg}\"" +msgstr "\"Main: got {msg}\"" -#: src/exercises/bare-metal/solutions-morning.md -msgid "// Read compass data and log it to the serial port.\n" -msgstr "// コンパスデータを読み取り、シリアルポートに記録します。\n" +#: src/concurrency/channels/bounded.md +msgid "" +"With bounded (synchronous) channels, `send` can block the current thread:" +msgstr "" +"Bounded（かつ同期的）なチャネルを用いたとき、`send`は現在のスレッドをブロック" +"することがあります：" -#: src/exercises/bare-metal/solutions-morning.md -msgid "\"{},{},{}\\t{},{},{}\"" -msgstr "\"{},{},{}\\t{},{},{}\"" +#: src/concurrency/channels/bounded.md +msgid "" +"Calling `send` will block the current thread until there is space in the " +"channel for the new message. The thread can be blocked indefinitely if there " +"is nobody who reads from the channel." +msgstr "" +"`send`を呼んだときにチャネルに空きがなければ、現在のスレッドはブロックされま" +"す。もし誰もチャネルから値を読み取らない場合は、このスレッドは無期限にブロッ" +"クされることがあります。" -#: src/exercises/bare-metal/solutions-morning.md +#: src/concurrency/channels/bounded.md msgid "" -"// If button A is pressed, switch to the next mode and briefly blink all " -"LEDs\n" -" // on.\n" +"A call to `send` will abort with an error (that is why it returns `Result`) " +"if the channel is closed. A channel is closed when the receiver is dropped." msgstr "" -"// ボタン A が押された場合、次のモードに切り替えてすべての LED を短時間点滅\n" -" // させます。\n" +"もしもチャネルが閉じられた場合、`send`の呼び出しはエラーとともに中断します。" +"（`send`が`Result`を返すのはこのためです。）受け取り側がドロップされたとき" +"に、チャネルは閉じられます。" -#: src/bare-metal/aps.md -msgid "Application processors" -msgstr "アプリケーションプロセッサ" +#: src/concurrency/channels/bounded.md +#, fuzzy +msgid "" +"A bounded channel with a size of zero is called a \"rendezvous channel\". " +"Every send will block the current thread until another thread calls `recv`." +msgstr "" +"サイズが０のBoundedチャネルは「ランデブーチャネル」と呼ばれます。別のスレッド" +"が`read`を呼ぶまでは、それぞれのsendは現在のスレッドをブロックします。" -#: src/bare-metal/aps.md +#: src/concurrency/send-sync.md +msgid "Send" +msgstr "Send" + +#: src/concurrency/send-sync.md +msgid "Sync" +msgstr "Sync" + +#: src/concurrency/send-sync/marker-traits.md +#, fuzzy msgid "" -"So far we've talked about microcontrollers, such as the Arm Cortex-M series. " -"Now let's try writing something for Cortex-A. For simplicity we'll just work " -"with QEMU's aarch64 ['virt'](https://qemu-project.gitlab.io/qemu/system/arm/" -"virt.html) board." +"How does Rust know to forbid shared access across threads? The answer is in " +"two traits:" msgstr "" -"ここまではArm Cortex-Mシリーズのようなマイクロコントローラについて見てきまし" -"た。今度はCortex-Aを対象として何かを書いてみましょう。簡単化のために、ここで" -"は（本物のハードウェアではなく）QEMUのaarch64 ['virt'](https://qemu-project." -"gitlab.io/qemu/system/arm/virt.html)ボードを利用します。" +"Rustはどのようにスレッド間での値の共有アクセスを禁止するのでしょうか？その答" +"えとなるのが、以下の２つのトレイトです：" + +#: src/concurrency/send-sync/marker-traits.md +msgid "" +"[`Send`](https://doc.rust-lang.org/std/marker/trait.Send.html): a type `T` " +"is `Send` if it is safe to move a `T` across a thread boundary." +msgstr "" +"[`Send`](https://doc.rust-lang.org/std/marker/trait.Send.html): スレッド境界" +"をまたいでの型`T`のムーブが安全に行える場合、型`T`は`Send`である。" + +#: src/concurrency/send-sync/marker-traits.md +msgid "" +"[`Sync`](https://doc.rust-lang.org/std/marker/trait.Sync.html): a type `T` " +"is `Sync` if it is safe to move a `&T` across a thread boundary." +msgstr "" +"[`Sync`](https://doc.rust-lang.org/std/marker/trait.Sync.html): スレッド境界" +"をまたいで`&T`のムーブが安全に行える場合、型`T`は`Sync`である。" + +#: src/concurrency/send-sync/marker-traits.md +#, fuzzy +msgid "" +"`Send` and `Sync` are [unsafe traits](../../unsafe-rust/unsafe-traits.md). " +"The compiler will automatically derive them for your types as long as they " +"only contain `Send` and `Sync` types. You can also implement them manually " +"when you know it is valid." +msgstr "" +"`Send`と`Sync`は[unsafeなトレイト](../unsafe/unsafe-traits.md)です。 あなたが" +"新たに定義する型が`Send`と`Sync`の型のみを含む場合、コンパイラはその新しい型" +"に対して`Send`と`Sync`を自動的に導出します。そうでなくても妥当であるならば" +"`Send`と`Sync`を自分自身で実装することもできます。" + +#: src/concurrency/send-sync/marker-traits.md +msgid "" +"One can think of these traits as markers that the type has certain thread-" +"safety properties." +msgstr "" +"これらのトレイトは、ある型が特定のスレッドセーフの特性を持っていることを示す" +"マーカーと考えることもできます。" + +#: src/concurrency/send-sync/marker-traits.md +msgid "They can be used in the generic constraints as normal traits." +msgstr "" +"これらは通常のトレイトと同じように、ジェネリック境界の中で利用することができ" +"ます。" + +#: src/concurrency/send-sync/send.md +msgid "" +"A type `T` is [`Send`](https://doc.rust-lang.org/std/marker/trait.Send.html) " +"if it is safe to move a `T` value to another thread." +msgstr "" +"型`T`の値を安全に別のスレッドにムーブできる場合、型`T`は[`Send`](https://doc." +"rust-lang.org/std/marker/trait.Send.html)である。" + +#: src/concurrency/send-sync/send.md +msgid "" +"The effect of moving ownership to another thread is that _destructors_ will " +"run in that thread. So the question is when you can allocate a value in one " +"thread and deallocate it in another." +msgstr "" +"所有権を別のスレットにムーブするということは、_デストラクタ_ がそのスレッドで" +"実行されるということです。つまり、あるスレッドでアロケートされた値を別のス" +"レッドで解放しても良いかというのが判断基準になります。" + +#: src/concurrency/send-sync/send.md +msgid "" +"As an example, a connection to the SQLite library must only be accessed from " +"a single thread." +msgstr "" +"例を挙げると、SQLiteライブラリへのコネクションは、一つのスレッドからのみアク" +"セスされる必要があります。" + +#: src/concurrency/send-sync/sync.md +msgid "" +"A type `T` is [`Sync`](https://doc.rust-lang.org/std/marker/trait.Sync.html) " +"if it is safe to access a `T` value from multiple threads at the same time." +msgstr "" +"型`T`の値を複数のスレッドから同時にアクセスしても安全な場合、型`T`は [`Sync`]" +"(https://doc.rust-lang.org/std/marker/trait.Sync.html) である。" + +#: src/concurrency/send-sync/sync.md +msgid "More precisely, the definition is:" +msgstr "より正確には、以下のような定義です：" + +#: src/concurrency/send-sync/sync.md +msgid "`T` is `Sync` if and only if `&T` is `Send`" +msgstr "`&T`が`Send`である場合、かつその場合に限り、`T`は`Sync`である" + +#: src/concurrency/send-sync/sync.md +msgid "" +"This statement is essentially a shorthand way of saying that if a type is " +"thread-safe for shared use, it is also thread-safe to pass references of it " +"across threads." +msgstr "" +"これはつまり、「ある型の共有がスレッドセーフであれば、その参照をスレッド間で" +"受け渡すこともスレッドセーフである」ということを手短に表したものです。" + +#: src/concurrency/send-sync/sync.md +msgid "" +"This is because if a type is Sync it means that it can be shared across " +"multiple threads without the risk of data races or other synchronization " +"issues, so it is safe to move it to another thread. A reference to the type " +"is also safe to move to another thread, because the data it references can " +"be accessed from any thread safely." +msgstr "" +"なぜなら、ある型がSyncである場合、データ競合や他の同期の問題などのリスクなし" +"にその型を複数のスレッド間で共有でき、その型を別のスレッドにムーブしても安全" +"だからです。また、型への参照は別のスレッドにムーブしても安全です。それは、そ" +"れが参照するデータは任意のスレッドから安全にアクセスすることができるからで" +"す。" + +#: src/concurrency/send-sync/examples.md +msgid "`Send + Sync`" +msgstr "`Send + Sync`" + +#: src/concurrency/send-sync/examples.md +msgid "Most types you come across are `Send + Sync`:" +msgstr "見かけるほとんどの型は`Send + Sync`です：" + +#: src/concurrency/send-sync/examples.md +msgid "`i8`, `f32`, `bool`, `char`, `&str`, ..." +msgstr "`i8`、`f32`、`bool`、`char`、`&str` など" + +#: src/concurrency/send-sync/examples.md +msgid "`(T1, T2)`, `[T; N]`, `&[T]`, `struct { x: T }`, ..." +msgstr "`(T1, T2)`、`[T; N]`、`&[T]`、`struct { x: T }` など" + +#: src/concurrency/send-sync/examples.md +msgid "`String`, `Option`, `Vec`, `Box`, ..." +msgstr "`String`、`Option`、`Vec`、`Box` など" + +#: src/concurrency/send-sync/examples.md +msgid "`Arc`: Explicitly thread-safe via atomic reference count." +msgstr "`Arc`: アトミック参照カウントにより、明示的にスレッドセーフ。" + +#: src/concurrency/send-sync/examples.md +msgid "`Mutex`: Explicitly thread-safe via internal locking." +msgstr "`Mutex`: 内部ロックにより明示的にスレッドセーフ。" + +#: src/concurrency/send-sync/examples.md +#, fuzzy +msgid "`mpsc::Sender`: As of 1.72.0." +msgstr "`mpsc::Sender`" + +#: src/concurrency/send-sync/examples.md +msgid "`AtomicBool`, `AtomicU8`, ...: Uses special atomic instructions." +msgstr "`AtomicBool`, `AtomicU8`, …: 特別なアトミック命令を利用。" + +#: src/concurrency/send-sync/examples.md +msgid "" +"The generic types are typically `Send + Sync` when the type parameters are " +"`Send + Sync`." +msgstr "" +"ジェネリクスは、型パラメタが`Send + Sync`であるとき、通常は`Send + Sync`で" +"す。" + +#: src/concurrency/send-sync/examples.md +msgid "`Send + !Sync`" +msgstr "`Send + !Sync`" + +#: src/concurrency/send-sync/examples.md +msgid "" +"These types can be moved to other threads, but they're not thread-safe. " +"Typically because of interior mutability:" +msgstr "" +"これらの型は別のスレッドにムーブすることができますが、このようなムーブはス" +"レッドセーフではありません。通常は内部可変性がその原因です：" + +#: src/concurrency/send-sync/examples.md +msgid "`mpsc::Receiver`" +msgstr "`mpsc::Receiver`" + +#: src/concurrency/send-sync/examples.md +msgid "`Cell`" +msgstr "`Cell`" -#: src/bare-metal/aps.md +#: src/concurrency/send-sync/examples.md +msgid "`RefCell`" +msgstr "`RefCell`" + +#: src/concurrency/send-sync/examples.md +msgid "`!Send + Sync`" +msgstr "`!Send + Sync`" + +#: src/concurrency/send-sync/examples.md +#, fuzzy msgid "" -"Broadly speaking, microcontrollers don't have an MMU or multiple levels of " -"privilege (exception levels on Arm CPUs, rings on x86), while application " -"processors do." +"These types are safe to access (via shared references) from multiple " +"threads, but they cannot be moved to another thread:" msgstr "" -"大まかに言って、マイクロコントローラがMMUや複数の特権レベル（Arm CPUにおける" -"例外レベル、x86におけるリング）を持たないのに対し、アプリケーションプロセッサ" -"はこれらを持っています。" +"このような型はスレッドセーフですが、別のスレッドにムーブすることはできませ" +"ん：" -#: src/bare-metal/aps.md +#: src/concurrency/send-sync/examples.md +#, fuzzy msgid "" -"QEMU supports emulating various different machines or board models for each " -"architecture. The 'virt' board doesn't correspond to any particular real " -"hardware, but is designed purely for virtual machines." +"`MutexGuard`: Uses OS level primitives which must be deallocated on " +"the thread which created them. However, an already-locked mutex can have its " +"guarded variable read by any thread with which the guard is shared." msgstr "" -"QEMU は個々のアーキテクチャに対して様々な異なるマシンやボードモデルをサポート" -"しています。今回使う 'virt' ボードは特定の本物のハードウェアに対応したもので" -"はなく、純粋に仮想マシンとして設計されたものです。" +"`MutexGuard`: プリミティブを作成したスレッド自身により、割り当てを解除され" +"るべきであるようなOSレベルのプリミティブを利用。" -#: src/bare-metal/aps/entry-point.md -msgid "" -"Before we can start running Rust code, we need to do some initialisation." -msgstr "Rustのコードを実行できるようになる前にいくつかの初期化が必要です。" +#: src/concurrency/send-sync/examples.md +msgid "`!Send + !Sync`" +msgstr "`!Send + !Sync`" -#: src/bare-metal/aps/entry-point.md +#: src/concurrency/send-sync/examples.md +msgid "These types are not thread-safe and cannot be moved to other threads:" +msgstr "" +"このような型はスレッドセーフではないため、別のスレッドにムーブすることはでき" +"ません：" + +#: src/concurrency/send-sync/examples.md msgid "" -"```armasm\n" -".section .init.entry, \"ax\"\n" -".global entry\n" -"entry:\n" -" /*\n" -" * Load and apply the memory management configuration, ready to enable " -"MMU and\n" -" * caches.\n" -" */\n" -" adrp x30, idmap\n" -" msr ttbr0_el1, x30\n" -"\n" -" mov_i x30, .Lmairval\n" -" msr mair_el1, x30\n" -"\n" -" mov_i x30, .Ltcrval\n" -" /* Copy the supported PA range into TCR_EL1.IPS. */\n" -" mrs x29, id_aa64mmfr0_el1\n" -" bfi x30, x29, #32, #4\n" -"\n" -" msr tcr_el1, x30\n" -"\n" -" mov_i x30, .Lsctlrval\n" -"\n" -" /*\n" -" * Ensure everything before this point has completed, then invalidate " -"any\n" -" * potentially stale local TLB entries before they start being used.\n" -" */\n" -" isb\n" -" tlbi vmalle1\n" -" ic iallu\n" -" dsb nsh\n" -" isb\n" -"\n" -" /*\n" -" * Configure sctlr_el1 to enable MMU and cache and don't proceed until " -"this\n" -" * has completed.\n" -" */\n" -" msr sctlr_el1, x30\n" -" isb\n" -"\n" -" /* Disable trapping floating point access in EL1. */\n" -" mrs x30, cpacr_el1\n" -" orr x30, x30, #(0x3 << 20)\n" -" msr cpacr_el1, x30\n" -" isb\n" -"\n" -" /* Zero out the bss section. */\n" -" adr_l x29, bss_begin\n" -" adr_l x30, bss_end\n" -"0: cmp x29, x30\n" -" b.hs 1f\n" -" stp xzr, xzr, [x29], #16\n" -" b 0b\n" -"\n" -"1: /* Prepare the stack. */\n" -" adr_l x30, boot_stack_end\n" -" mov sp, x30\n" -"\n" -" /* Set up exception vector. */\n" -" adr x30, vector_table_el1\n" -" msr vbar_el1, x30\n" -"\n" -" /* Call into Rust code. */\n" -" bl main\n" -"\n" -" /* Loop forever waiting for interrupts. */\n" -"2: wfi\n" -" b 2b\n" -"```" +"`Rc`: each `Rc` has a reference to an `RcBox`, which contains a non-" +"atomic reference count." msgstr "" -"```armasm\n" -".section .init.entry, \"ax\"\n" -".global entry\n" -"entry:\n" -" /*\n" -" * メモリ管理に関するコンフィギュレーションを読み込んで適用し、MMU と" -"キャッシュを有効にする準備を\n" -" * します。\n" -" */\n" -" adrp x30, idmap\n" -" msr ttbr0_el1, x30\n" -"\n" -" mov_i x30, .Lmairval\n" -" msr mair_el1, x30\n" -"\n" -" mov_i x30, .Ltcrval\n" -" /* サポートされている PA 範囲を TCR_EL1.IPS にコピーします。*/\n" -" mrs x29, id_aa64mmfr0_el1\n" -" bfi x30, x29, #32, #4\n" -"\n" -" msr tcr_el1, x30\n" -"\n" -" mov_i x30, .Lsctlrval\n" -"\n" -" /*\n" -" * ここより前のすべての処理が完了していることを確認してから、\n" -" * 古くなった可能性のあるローカル TLB エントリを使用開始前に無効にしま" -"す。\n" -" */\n" -" isb\n" -" tlbi vmalle1\n" -" ic iallu\n" -" dsb nsh\n" -" isb\n" -"\n" -" /*\n" -" * MMU とキャッシュを有効にするように sctlr_el1 を設定し、\n" -" * これが完了するまでは先に進まないようにします。\n" -" */\n" -" msr sctlr_el1, x30\n" -" isb\n" -"\n" -" /* EL1 の浮動小数点アクセスのトラップを無効にします。*/\n" -" mrs x30, cpacr_el1\n" -" orr x30, x30, #(0x3 << 20)\n" -" msr cpacr_el1, x30\n" -" isb\n" -"\n" -" /* bss セクションをゼロにします。*/\n" -" adr_l x29, bss_begin\n" -" adr_l x30, bss_end\n" -"0: cmp x29, x30\n" -" b.hs 1f\n" -" stp xzr, xzr, [x29], #16\n" -" b 0b\n" -"\n" -"1: /* スタックを準備します。*/\n" -" adr_l x30, boot_stack_end\n" -" mov sp, x30\n" -"\n" -" /* 例外ベクターを設定します。*/\n" -" adr x30, vector_table_el1\n" -" msr vbar_el1, x30\n" -"\n" -" /* Rust コードを呼び出します。*/\n" -" bl main\n" -"\n" -" /* 割り込みを待機して永久にループします。*/\n" -"2: wfi\n" -" b 2b\n" -"```" +"`Rc`: それぞれの `Rc` は`RcBox`への参照を持っています。これは、アト" +"ミックでない参照カウントを持っています。" -#: src/bare-metal/aps/entry-point.md +#: src/concurrency/send-sync/examples.md msgid "" -"This is the same as it would be for C: initialising the processor state, " -"zeroing the BSS, and setting up the stack pointer." +"`*const T`, `*mut T`: Rust assumes raw pointers may have special concurrency " +"considerations." msgstr "" -"この初期化内容はCの場合と同じになります。プロセッサ状態を初期化して、BSSをゼ" -"ロ埋めして、スタックポインタを設定します。" +"`*const T`, `*mut T`: Rust は、生ポインターは同時実行性に関する特別な考慮事項" +"がある可能性があることを仮定しています。" -#: src/bare-metal/aps/entry-point.md +#: src/concurrency/shared-state.md +msgid "Arc" +msgstr "Arc" + +#: src/concurrency/shared-state.md +msgid "Mutex" +msgstr "Mutex" + +#: src/concurrency/shared-state/arc.md msgid "" -"The BSS (block starting symbol, for historical reasons) is the part of the " -"object file which containing statically allocated variables which are " -"initialised to zero. They are omitted from the image, to avoid wasting space " -"on zeroes. The compiler assumes that the loader will take care of zeroing " -"them." +"[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html) allows shared " +"read-only access via `Arc::clone`:" msgstr "" -"BSS（歴史的な理由によりblock starting symbolと呼ばれているもの）はオブジェク" -"トファイルにおいてゼロ初期化される静的な変数を含む部分です。この部分はゼロに" -"よる領域の浪費を避けるためにイメージからは除外されています。コンパイラはロー" -"ダがこの領域をゼロ初期化することを想定しているのです。" +"[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html) は読み取り専用" +"の共有アクセスを`Arc::clone`により可能にします：" -#: src/bare-metal/aps/entry-point.md +#: src/concurrency/shared-state/arc.md +msgid "\"{thread_id:?}: {v:?}\"" +msgstr "\"{thread_id:?}: {v:?}\"" + +#: src/concurrency/shared-state/arc.md src/concurrency/shared-state/example.md +msgid "\"v: {v:?}\"" +msgstr "\"v: {v:?}\"" + +#: src/concurrency/shared-state/arc.md msgid "" -"The BSS may already be zeroed, depending on how memory is initialised and " -"the image is loaded, but we zero it to be sure." +"`Arc` stands for \"Atomic Reference Counted\", a thread safe version of `Rc` " +"that uses atomic operations." msgstr "" -"メモリの初期化方法やイメージのロード方法によってはBSSはすでにゼロ埋めされてい" -"ることがありますが、ここでは念の為にゼロ埋めしています。" +"`Arc` は\"Atomic Reference Counted\"の略で、アトミック操作を利用するという点" +"で、`Rc`がスレッド安全になったバージョンのようなものです。" -#: src/bare-metal/aps/entry-point.md +#: src/concurrency/shared-state/arc.md msgid "" -"We need to enable the MMU and cache before reading or writing any memory. If " -"we don't:" +"`Arc` implements `Clone` whether or not `T` does. It implements `Send` " +"and `Sync` if and only if `T` implements them both." msgstr "" -"いかなるメモリのreadやwriteよりも前にMMUとキャッシュを有効化する必要がありま" -"す。それをしないと：" +"`Arc` は `Clone` を実装します。このことは`T`が`Clone`を実装するしないに関" +"係ありません。`T`が`Send`と`Sync`の両方を実装している場合で、かつその場合に限" +"り、`Arc` は両者を実装します。" -#: src/bare-metal/aps/entry-point.md +#: src/concurrency/shared-state/arc.md msgid "" -"Unaligned accesses will fault. We build the Rust code for the `aarch64-" -"unknown-none` target which sets `+strict-align` to prevent the compiler " -"generating unaligned accesses, so it should be fine in this case, but this " -"is not necessarily the case in general." +"`Arc::clone()` has the cost of atomic operations that get executed, but " +"after that the use of the `T` is free." msgstr "" -"アラインされていないアクセスがフォールトになります。我々はコンパイラがアライ" -"ンされていないアクセスを生成しないように`+strict-align`オプション を設定する" -"`aarch64-unknown-none` ターゲット向けにRustコードをビルドします。そのためここ" -"では問題にはなりませんが、一般的にはそうとは言えません。" +"`Arc::clone()`にはアトミック操作のコストがかかります。ただ、その後は、`T`の利" +"用に関するコストはかかりません。" -#: src/bare-metal/aps/entry-point.md +#: src/concurrency/shared-state/arc.md msgid "" -"If it were running in a VM, this can lead to cache coherency issues. The " -"problem is that the VM is accessing memory directly with the cache disabled, " -"while the host has cacheable aliases to the same memory. Even if the host " -"doesn't explicitly access the memory, speculative accesses can lead to cache " -"fills, and then changes from one or the other will get lost when the cache " -"is cleaned or the VM enables the cache. (Cache is keyed by physical address, " -"not VA or IPA.)" +"Beware of reference cycles, `Arc` does not use a garbage collector to detect " +"them." msgstr "" -"もしVM上で実行していたとすると、キャッシュコヒーレンシーの問題を起こすことが" -"あります。問題なのはVMがキャッシュを無効化したまま直接メモリにアクセスしてい" -"るのに対し、ホストは同じメモリに対してキャッシュ可能なエイリアスを持ってしま" -"うということです。ホストが仮に明示的にメモリにアクセスしないとしても、投機的" -"なアクセスによりキャッシュフィルが起きることがあります。そうなると、ホストが" -"キャッシュをフラッシュするかVMがキャッシュを有効化したときに、VMかホストのど" -"ちらかによる変更が失われてしまいます。（キャッシュは仮想アドレスやIPAではなく" -"物理アドレスをキーとしてアクセスされます）" +"参照サイクルに気をつけてください。`Arc` には参照サイクルを検知するためのガ" +"ベージコレクタはありません。" -#: src/bare-metal/aps/entry-point.md +#: src/concurrency/shared-state/arc.md +msgid "`std::sync::Weak` can help." +msgstr "`std::sync::Weak` が役立ちます。" + +#: src/concurrency/shared-state/mutex.md +#, fuzzy msgid "" -"For simplicity, we just use a hardcoded pagetable (see `idmap.S`) which " -"identity maps the first 1 GiB of address space for devices, the next 1 GiB " -"for DRAM, and another 1 GiB higher up for more devices. This matches the " -"memory layout that QEMU uses." +"[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html) ensures " +"mutual exclusion _and_ allows mutable access to `T` behind a read-only " +"interface (another form of [interior mutability](../../borrowing/interior-" +"mutability.md)):" msgstr "" -"単純化のために、ハードコードしたページテーブル（`idmap.S`参照）を利用します。" -"このページテーブルは最初の1GiBをデバイス用に、次の1GiBをDRAM用に、次の1GiBを" -"さらなるデバイス用に透過的にマップします。これはQEMUのメモリレイアウトに合致" -"します。" +"[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html) は相互排他" +"を保証し、 _かつ_ 読み取り専用のインターフェースの裏側で `T` へのミュータブル" +"なアクセスを可能にします：" -#: src/bare-metal/aps/entry-point.md +#: src/concurrency/shared-state/mutex.md +msgid "\"v: {:?}\"" +msgstr "\"v: {:?}\"" + +#: src/concurrency/shared-state/mutex.md msgid "" -"We also set up the exception vector (`vbar_el1`), which we'll see more about " -"later." +"Notice how we have a [`impl Sync for Mutex`](https://doc.rust-" +"lang.org/std/sync/struct.Mutex.html#impl-Sync-for-Mutex%3CT%3E) blanket " +"implementation." msgstr "" -"例外ベクタ（`vbar_el1`）も設定します。これに関しては後ほど詳しく見ます。" +"[`impl Sync for Mutex`](https://doc.rust-lang.org/std/sync/" +"struct.Mutex.html#impl-Sync-for-Mutex%3CT%3E) のブランケット実装があることに" +"注目してください。" -#: src/bare-metal/aps/entry-point.md +#: src/concurrency/shared-state/mutex.md msgid "" -"All examples this afternoon assume we will be running at exception level 1 " -"(EL1). If you need to run at a different exception level you'll need to " -"modify `entry.S` accordingly." +"`Mutex` in Rust looks like a collection with just one element --- the " +"protected data." msgstr "" -"今日の午後に扱うすべての例は例外レベル１（EL1）で実行されることを想定していま" -"す。もし、別の例外レベルで実行する必要がある場合には、`entry.S`をそれに合わせ" -"て変更する必要があります。" +"Rustにおける`Mutex`とは、保護されるデータである、たった一つの要素から構成され" +"たコレクションのようなものです。" -#: src/bare-metal/aps/inline-assembly.md -msgid "Inline assembly" -msgstr "インラインアセンブリ" +#: src/concurrency/shared-state/mutex.md +msgid "" +"It is not possible to forget to acquire the mutex before accessing the " +"protected data." +msgstr "" +"保護されたデータにアクセスする前に、ミューテックスを確保し忘れることはありま" +"せん。" -#: src/bare-metal/aps/inline-assembly.md +#: src/concurrency/shared-state/mutex.md msgid "" -"Sometimes we need to use assembly to do things that aren't possible with " -"Rust code. For example, to make an HVC (hypervisor call) to tell the " -"firmware to power off the system:" +"You can get an `&mut T` from an `&Mutex` by taking the lock. The " +"`MutexGuard` ensures that the `&mut T` doesn't outlive the lock being held." msgstr "" -"時折Rustコードでは書けないことを行うためにアセンブリ言語を使う必要がありま" -"す。例えば、電源を落とすためにファームウェアに対してHVC（ハイパーバイザコー" -"ル）を発行する場合です：" +"`&Mutex` からロックを取得することで、`&mut T`を得ることができます。この" +"`MutexGuard`は`&mut T`が保持されているロックよりも長く存続しないことを保証し" +"ます。" -#: src/bare-metal/aps/inline-assembly.md +#: src/concurrency/shared-state/mutex.md msgid "" -"// Safe because this only uses the declared registers and doesn't do\n" -" // anything with memory.\n" +"`Mutex` implements both `Send` and `Sync` iff (if and only if) `T` " +"implements `Send`." msgstr "" -"// 宣言されたレジスタのみを使用し、メモリについては\n" -" // 何もしないため、安全です。\n" +"`T`が`Send`を実装している場合で、かつその場合に限り、`Mutex` は`Send`と" +"`Sync`の両方を実装します。" -#: src/bare-metal/aps/inline-assembly.md -msgid "\"hvc #0\"" -msgstr "\"hvc #0\"" +#: src/concurrency/shared-state/mutex.md +msgid "A read-write lock counterpart: `RwLock`." +msgstr "読み書きのロックの場合に対応するものがあります： `RwLock`。" -#: src/bare-metal/aps/inline-assembly.md -msgid "\"w0\"" -msgstr "\"w0\"" +#: src/concurrency/shared-state/mutex.md +msgid "Why does `lock()` return a `Result`?" +msgstr "なぜ`lock()`は`Result`を返すのでしょう？" -#: src/bare-metal/aps/inline-assembly.md -msgid "\"w1\"" -msgstr "\"w1\"" +#: src/concurrency/shared-state/mutex.md +msgid "" +"If the thread that held the `Mutex` panicked, the `Mutex` becomes " +"\"poisoned\" to signal that the data it protected might be in an " +"inconsistent state. Calling `lock()` on a poisoned mutex fails with a " +"[`PoisonError`](https://doc.rust-lang.org/std/sync/struct.PoisonError.html). " +"You can call `into_inner()` on the error to recover the data regardless." +msgstr "" +"Mutex`を保持したスレッドがパニックを起こした場合、保護すべきデータが整合性の" +"欠けた状態にある可能性を伝えるため、`Mutex`は「ポイゾンされた」" +"（\"poisoned\"）状態になります。ポイゾンされたMutexに対して `lock()` をコール" +"すると、[`PoisonError`](https://doc.rust-lang.org/std/sync/struct." +"PoisonError.html)とともに失敗します。`into_inner()` を用いることで、そのエ" +"ラーにおいて、とりあえずデータを回復することはできます。" -#: src/bare-metal/aps/inline-assembly.md -msgid "\"w2\"" -msgstr "\"w2\"" +#: src/concurrency/shared-state/example.md +msgid "Let us see `Arc` and `Mutex` in action:" +msgstr "`Arc` と `Mutex` の動作を見てみましょう：" -#: src/bare-metal/aps/inline-assembly.md -msgid "\"w3\"" -msgstr "\"w3\"" +#: src/concurrency/shared-state/example.md +msgid "// use std::sync::{Arc, Mutex};\n" +msgstr "// use std::sync::{Arc, Mutex};\n" -#: src/bare-metal/aps/inline-assembly.md -msgid "\"w4\"" -msgstr "\"w4\"" +#: src/concurrency/shared-state/example.md +msgid "Possible solution:" +msgstr "考えられる対処法：" -#: src/bare-metal/aps/inline-assembly.md -msgid "\"w5\"" -msgstr "\"w5\"" +#: src/concurrency/shared-state/example.md +msgid "Notable parts:" +msgstr "注目するとよい箇所：" -#: src/bare-metal/aps/inline-assembly.md -msgid "\"w6\"" -msgstr "\"w6\"" +#: src/concurrency/shared-state/example.md +msgid "" +"`v` is wrapped in both `Arc` and `Mutex`, because their concerns are " +"orthogonal." +msgstr "" +"`v`は `Arc` と `Mutex`の両方でラップされています。なぜなら、それらの関心は互" +"いに独立なものであるからです。" -#: src/bare-metal/aps/inline-assembly.md -msgid "\"w7\"" -msgstr "\"w7\"" +#: src/concurrency/shared-state/example.md +msgid "" +"Wrapping a `Mutex` in an `Arc` is a common pattern to share mutable state " +"between threads." +msgstr "" +"`Mutex`を`Arc`でラップすることは、スレッド間でミュータブルな状態を共有するた" +"めによく見られるパターンです。" -#: src/bare-metal/aps/inline-assembly.md +#: src/concurrency/shared-state/example.md msgid "" -"(If you actually want to do this, use the [`smccc`](https://crates.io/crates/" -"smccc) crate which has wrappers for all these functions.)" +"`v: Arc<_>` needs to be cloned as `v2` before it can be moved into another " +"thread. Note `move` was added to the lambda signature." msgstr "" -"（もし実際に電源を落とすプログラムを書きたい場合は、これらのすべての機能に対" -"するラッパーを提供している[`smccc`](https://crates.io/crates/smccc)を使うと良" -"いでしょう。）" +"`v: Arc<_>`は別のスレッドにムーブされる前に、`v2`としてクローンされる必要があ" +"ります。`move` がラムダ式に追加されたことに注意してください。" -#: src/bare-metal/aps/inline-assembly.md +#: src/concurrency/shared-state/example.md msgid "" -"PSCI is the Arm Power State Coordination Interface, a standard set of " -"functions to manage system and CPU power states, among other things. It is " -"implemented by EL3 firmware and hypervisors on many systems." +"Blocks are introduced to narrow the scope of the `LockGuard` as much as " +"possible." msgstr "" -"PSCI はArmのPower State Coordination Interfaceのことであり、これはシステムや" -"CPU電力状態管理の機能を含む標準的なセットです。これは多くのシステムでEL3" -"ファームウェアとハイパーバイザにより実装されています。" +"ブロックは`LockGuard`のスコープを可能な限り狭めるために導入されています。" -#: src/bare-metal/aps/inline-assembly.md +#: src/concurrency/sync-exercises/dining-philosophers.md +msgid "The dining philosophers problem is a classic problem in concurrency:" +msgstr "食事する哲学者の問題は、並行性に関する古典的な問題です。" + +#: src/concurrency/sync-exercises/dining-philosophers.md msgid "" -"The `0 => _` syntax means initialise the register to 0 before running the " -"inline assembly code, and ignore its contents afterwards. We need to use " -"`inout` rather than `in` because the call could potentially clobber the " -"contents of the registers." +"Five philosophers dine together at the same table. Each philosopher has " +"their own place at the table. There is a fork between each plate. The dish " +"served is a kind of spaghetti which has to be eaten with two forks. Each " +"philosopher can only alternately think and eat. Moreover, a philosopher can " +"only eat their spaghetti when they have both a left and right fork. Thus two " +"forks will only be available when their two nearest neighbors are thinking, " +"not eating. After an individual philosopher finishes eating, they will put " +"down both forks." msgstr "" -"`0 => _` というシンタックスは、インラインアセンブリを実行する前にレジスタをゼ" -"ロで初期化し、実行後はその値は気にしないということを示しています。`in`ではな" -"く`inout`を使う必要があるのは、この実行でレジスタの値を上書きしてしまう可能性" -"があるからです。" +"5 人の哲学者が同じテーブルで食事をしています。それぞれの哲学者がテーブルの定" +"位置に座り、皿の間にはフォークが 1 本置かれています。提供される料理はスパゲッ" +"ティで、2 本のフォークで食べる必要があります。哲学者は思索と食事を交互に繰り" +"返すことしかできません。さらに、哲学者は左右両方のフォークを持っている場合に" +"のみ、スパゲッティを食べることができます。したがって、2 つのフォークは、両隣" +"の哲学者が食べるのではなく考えている場合にのみ使用できます。それぞれの哲学者" +"は、食べ終わった後、両方のフォークを置きます。" -#: src/bare-metal/aps/inline-assembly.md +#: src/concurrency/sync-exercises/dining-philosophers.md msgid "" -"This `main` function needs to be `#[no_mangle]` and `extern \"C\"` because " -"it is called from our entry point in `entry.S`." +"You will need a local [Cargo installation](../../cargo/running-locally.md) " +"for this exercise. Copy the code below to a file called `src/main.rs`, fill " +"out the blanks, and test that `cargo run` does not deadlock:" msgstr "" -"この `main` 関数は`entry.S`にあるエントリポイントから呼ばれるため、" -"`#[no_mangle]`と`extern \"C\"`を必要とします。" +"この演習では、ローカルの [Cargo インストール](../../cargo/running-locally.md)" +"が必要です。以下のコードを `src/main.rs` というファイルにコピーし、空欄を埋め" +"て、`cargo run` がデッドロックしないことを確認します。" -#: src/bare-metal/aps/inline-assembly.md +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/dining-philosophers.md msgid "" -"`_x0`–`_x3` are the values of registers `x0`–`x3`, which are conventionally " -"used by the bootloader to pass things like a pointer to the device tree. " -"According to the standard aarch64 calling convention (which is what `extern " -"\"C\"` specifies to use), registers `x0`–`x7` are used for the first 8 " -"arguments passed to a function, so `entry.S` doesn't need to do anything " -"special except make sure it doesn't change these registers." +"// left_fork: ...\n" +" // right_fork: ...\n" +" // thoughts: ...\n" msgstr "" -"`_x0`–`_x3`はレジスタ`x0`–`x3`の値であり、慣習的にブートロードがデバイスツ" -"リーなどへのポインタを渡すのに利用されています。（`extern \"C\"`により指定さ" -"れた）aarch64 の関数コール規約ではレジスタ`x0`–`x7`は最初の８個の引数を関数に" -"渡すのに利用されることになっているため、`entry.S` はこれらの値を変更しないよ" -"うにする以外の特別なことをする必要はありません。" +"// left_fork: ...\n" +" // right_fork: ...\n" +" // thoughts: ...\n" + +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/sync-exercises/solutions.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"Eureka! {} has a new idea!\"" +msgstr "\"Eureka! {} has a new idea!\"" + +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "// Pick up forks...\n" +msgstr "// Pick up forks...\n" + +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/sync-exercises/solutions.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"{} is eating...\"" +msgstr "\"{} is eating...\"" + +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/sync-exercises/solutions.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"Socrates\"" +msgstr "\"Socrates\"" + +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/sync-exercises/solutions.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"Hypatia\"" +msgstr "\"Hypatia\"" + +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/sync-exercises/solutions.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"Plato\"" +msgstr "\"Plato\"" + +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/sync-exercises/solutions.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"Aristotle\"" +msgstr "\"Aristotle\"" + +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/sync-exercises/solutions.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"Pythagoras\"" +msgstr "\"Pythagoras\"" -#: src/bare-metal/aps/inline-assembly.md -msgid "" -"Run the example in QEMU with `make qemu_psci` under `src/bare-metal/aps/" -"examples`." -msgstr "" -"この例を`src/bare-metal/aps/examples`において`make qemu_psci`とすることでQEMU" -"により実行してみましょう。" +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "// Create forks\n" +msgstr "// フォークを作成する\n" -#: src/bare-metal/aps/mmio.md -msgid "Volatile memory access for MMIO" -msgstr "MMIOに対するvolatileアクセス" +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "// Create philosophers\n" +msgstr "// 哲学者を作成する\n" -#: src/bare-metal/aps/mmio.md -msgid "Use `pointer::read_volatile` and `pointer::write_volatile`." -msgstr "`pointer::read_volatile`と`pointer::write_volatile`を使います。" +#: src/concurrency/sync-exercises/dining-philosophers.md +msgid "// Make each of them think and eat 100 times\n" +msgstr "// それぞれの哲学者が思索と食事を 100 回行うようにする\n" -#: src/bare-metal/aps/mmio.md -msgid "Never hold a reference." -msgstr "絶対に参照を保持してはいけません。" +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "// Output their thoughts\n" +msgstr "// 哲学者の思索を出力する\n" -#: src/bare-metal/aps/mmio.md +#: src/concurrency/sync-exercises/dining-philosophers.md +msgid "You can use the following `Cargo.toml`:" +msgstr "次の `Cargo.toml` を使用できます。" + +#: src/concurrency/sync-exercises/dining-philosophers.md msgid "" -"`addr_of!` lets you get fields of structs without creating an intermediate " -"reference." +"```toml\n" +"[package]\n" +"name = \"dining-philosophers\"\n" +"version = \"0.1.0\"\n" +"edition = \"2021\"\n" +"```" msgstr "" -"`addr_of!`を用いると、中間的な参照を作らずに構造体のフィールドにアクセスする" -"ことができます。" +"```toml\n" +"[package]\n" +"name = \"dining-philosophers\"\n" +"version = \"0.1.0\"\n" +"edition = \"2021\"\n" +"```" -#: src/bare-metal/aps/mmio.md +#: src/concurrency/sync-exercises/link-checker.md msgid "" -"Volatile access: read or write operations may have side-effects, so prevent " -"the compiler or hardware from reordering, duplicating or eliding them." +"Let us use our new knowledge to create a multi-threaded link checker. It " +"should start at a webpage and check that links on the page are valid. It " +"should recursively check other pages on the same domain and keep doing this " +"until all pages have been validated." msgstr "" -"Volatileアクセス：MMIO領域に対するreadやwriteは副作用があることがあるので、コ" -"ンパイラやハードウェアが実行順序を変更したり、複製したり、省略したりできない" -"ようにするためのものです。" +"新たに身に付けた知識を活かして、マルチスレッド リンク チェッカーを作成しま" +"しょう。まず、ウェブページ上のリンクが有効かどうかを確認する必要があります。" +"同じドメインの他のページを再帰的にチェックし、すべてのページの検証が完了する" +"までこの処理を繰り返します。" -#: src/bare-metal/aps/mmio.md +#: src/concurrency/sync-exercises/link-checker.md msgid "" -"Usually if you write and then read, e.g. via a mutable reference, the " -"compiler may assume that the value read is the same as the value just " -"written, and not bother actually reading memory." +"For this, you will need an HTTP client such as [`reqwest`](https://docs.rs/" +"reqwest/). You will also need a way to find links, we can use [`scraper`]" +"(https://docs.rs/scraper/). Finally, we'll need some way of handling errors, " +"we will use [`thiserror`](https://docs.rs/thiserror/)." msgstr "" -"通常は、例えばある可変参照に対してライトしリードすると、コンパイラはライトし" -"たのと同じ値がリードで読み出されると想定し、実際にメモリをリードする必要はな" -"いと判断します。" -#: src/bare-metal/aps/mmio.md +#: src/concurrency/sync-exercises/link-checker.md +#, fuzzy +msgid "Create a new Cargo project and `reqwest` it as a dependency with:" +msgstr "新しい Cargo プロジェクトを作成し、次の依存関係を追加します。" + +#: src/concurrency/sync-exercises/link-checker.md msgid "" -"Some existing crates for volatile access to hardware do hold references, but " -"this is unsound. Whenever a reference exist, the compiler may choose to " -"dereference it." +"If `cargo add` fails with `error: no such subcommand`, then please edit the " +"`Cargo.toml` file by hand. Add the dependencies listed below." msgstr "" -"ハードウェアへのvolatileアクセスを行うための既存のクレートには参照を保持する" -"ものがありますが、これは健全ではありません。参照が存在する間はいつでもコンパ" -"イラがその参照を外して（MMIO領域にアクセスして）しまう可能性があります。" +"`cargo add` が `error: no such subcommand` で失敗する場合は、`Cargo.toml` " +"ファイルを手動で編集してください。下記の依存関係を追加します。" -#: src/bare-metal/aps/mmio.md +#: src/concurrency/sync-exercises/link-checker.md msgid "" -"Use the `addr_of!` macro to get struct field pointers from a pointer to the " -"struct." +"The `cargo add` calls will update the `Cargo.toml` file to look like this:" msgstr "" -"構造体のポインタからそのフィールドへのポインタを得るには`addr_of!` マクロを" -"使ってください。" - -#: src/bare-metal/aps/uart.md -msgid "Let's write a UART driver" -msgstr "UARTドライバを書いてみましょう" +"`cargo add` の呼び出しにより、`Cargo.toml` ファイルは次のように更新されます。" -#: src/bare-metal/aps/uart.md +#: src/concurrency/sync-exercises/link-checker.md msgid "" -"The QEMU 'virt' machine has a [PL011](https://developer.arm.com/" -"documentation/ddi0183/g) UART, so let's write a driver for that." +"```toml\n" +"[package]\n" +"name = \"link-checker\"\n" +"version = \"0.1.0\"\n" +"edition = \"2021\"\n" +"publish = false\n" +"\n" +"[dependencies]\n" +"reqwest = { version = \"0.11.12\", features = [\"blocking\", \"rustls-" +"tls\"] }\n" +"scraper = \"0.13.0\"\n" +"thiserror = \"1.0.37\"\n" +"```" msgstr "" -"QEMUの'virt' マシンには[PL011](https://developer.arm.com/documentation/" -"ddi0183/g)というUARTがあるので、それに対するドライバを書いてみましょう。" - -#: src/bare-metal/aps/uart.md -msgid "/// Minimal driver for a PL011 UART.\n" -msgstr "/// PL011 UARTの最小ドライバ。\n" +"```toml\n" +"[package]\n" +"name = \"link-checker\"\n" +"version = \"0.1.0\"\n" +"edition = \"2021\"\n" +"publish = false\n" +"\n" +"[dependencies]\n" +"reqwest = { version = \"0.11.12\", features = [\"blocking\", \"rustls-" +"tls\"] }\n" +"scraper = \"0.13.0\"\n" +"thiserror = \"1.0.37\"\n" +"```" -#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md +#: src/concurrency/sync-exercises/link-checker.md msgid "" -"/// Constructs a new instance of the UART driver for a PL011 device at the\n" -" /// given base address.\n" -" ///\n" -" /// # Safety\n" -" ///\n" -" /// The given base address must point to the 8 MMIO control registers of " -"a\n" -" /// PL011 device, which must be mapped into the address space of the " -"process\n" -" /// as device memory and not have any other aliases.\n" +"You can now download the start page. Try with a small site such as `https://" +"www.google.org/`." msgstr "" -"/// 指定されたベースアドレスに存在する\n" -" /// PL011 デバイス用の UART ドライバの新しいインスタンスを作成します。\n" -" ///\n" -" /// # 安全性\n" -" ///\n" -" /// 指定されたベースアドレスは PL011 デバイスの 8 つの MMIO 制御レジスタ" -"を指していなければなりません。\n" -" /// これらはデバイスメモリとしてプロセスのアドレス空間に\n" -" /// マッピングされ、他のエイリアスはありません。\n" - -#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md -#: src/exercises/bare-metal/rtc.md -msgid "/// Writes a single byte to the UART.\n" -msgstr "/// UART に 1 バイトを書き込みます。\n" +"これで、スタートページをダウンロードできるようになりました。`https://www." +"google.org/` のような小規模なサイトで試してみましょう。" -#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md -#: src/exercises/bare-metal/rtc.md -msgid "// Wait until there is room in the TX buffer.\n" -msgstr "// TX バッファに空きができるまで待機します。\n" +#: src/concurrency/sync-exercises/link-checker.md +msgid "Your `src/main.rs` file should look something like this:" +msgstr "`src/main.rs` ファイルは次のようになります。" -#: src/bare-metal/aps/uart.md -msgid "" -"// Safe because we know that the base address points to the control\n" -" // registers of a PL011 device which is appropriately mapped.\n" -msgstr "" -"// ベースアドレスが、適切にマッピングされた PL011 デバイスのコントロール レジ" -"スタを\n" -" // 指していることがわかっているため、安全です。\n" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"request error: {0}\"" +msgstr "\"request error: {0}\"" -#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md -#: src/exercises/bare-metal/rtc.md -msgid "// Write to the TX buffer.\n" -msgstr "// TX バッファに書き込みます。\n" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"bad http response: {0}\"" +msgstr "\"bad http response: {0}\"" -#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md -#: src/exercises/bare-metal/rtc.md -msgid "// Wait until the UART is no longer busy.\n" -msgstr "// UART がビジーでなくなるまで待機します。\n" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"Checking {:#}\"" +msgstr "\"Checking {:#}\"" -#: src/bare-metal/aps/uart.md -msgid "" -"Note that `Uart::new` is unsafe while the other methods are safe. This is " -"because as long as the caller of `Uart::new` guarantees that its safety " -"requirements are met (i.e. that there is only ever one instance of the " -"driver for a given UART, and nothing else aliasing its address space), then " -"it is always safe to call `write_byte` later because we can assume the " -"necessary preconditions." -msgstr "" -"`Uart::new`がアンセーフでその他のメソッドがセーフであるということに注目してく" -"ださい。これは、`Uart::new`の安全性要求が満たされている（すなわち特定のUARTに" -"対して一つしかドライバのインスタンスが存在せず、そのアドレス空間に対してエイ" -"リアスが全く存在しない）ことをその呼び出し元が保証する限り、それ以降は必要な" -"事前条件が満たされていると想定することができ`write_byte`を常に安全に呼び出す" -"ことができるようになることが理由です。" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"href\"" +msgstr "\"href\"" -#: src/bare-metal/aps/uart.md -msgid "" -"We could have done it the other way around (making `new` safe but " -"`write_byte` unsafe), but that would be much less convenient to use as every " -"place that calls `write_byte` would need to reason about the safety" -msgstr "" -"逆に（`new`をセーフにして、`write_byte` をアンセーフに）することもできました" -"が、そうすると`write_byte`の全呼び出し箇所において安全性を考慮しなければなら" -"なくなり、利便性が低下します" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"On {base_url:#}: ignored unparsable {href:?}: {err}\"" +msgstr "\"On {base_url:#}: ignored unparsable {href:?}: {err}\"" -#: src/bare-metal/aps/uart.md -msgid "" -"This is a common pattern for writing safe wrappers of unsafe code: moving " -"the burden of proof for soundness from a large number of places to a smaller " -"number of places." -msgstr "" -"これはアンセーフなコードに対してセーフなラッパーを構築する場合の共通パターン" -"です：健全性に関する証明に関する労力を多数の場所から少数の場所に集約します。" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"https://www.google.org\"" +msgstr "\"https://www.google.org\"" -#: src/bare-metal/aps/uart/traits.md -msgid "More traits" -msgstr "他のトレイト" +#: src/concurrency/sync-exercises/link-checker.md +msgid "\"Links: {links:#?}\"" +msgstr "\"Links: {links:#?}\"" -#: src/bare-metal/aps/uart/traits.md -msgid "" -"We derived the `Debug` trait. It would be useful to implement a few more " -"traits too." -msgstr "" -"ここでは`Debug`トレイトを導出しました。この他にもいくつかのトレイトを実装する" -"と良いでしょう。" +#: src/concurrency/sync-exercises/link-checker.md +msgid "\"Could not extract links: {err:#}\"" +msgstr "\"Could not extract links: {err:#}\"" -#: src/bare-metal/aps/uart/traits.md src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "" -"// Safe because it just contains a pointer to device memory, which can be\n" -"// accessed from any context.\n" -msgstr "" -"// デバイスメモリへのポインタのみが含まれ、どのコンテキストからでも\n" -"// アクセスできるため、安全です。\n" +#: src/concurrency/sync-exercises/link-checker.md +msgid "Run the code in `src/main.rs` with" +msgstr "`src/main.rs` 内のコードを、次のコマンドで実行します。" -#: src/bare-metal/aps/uart/traits.md +#: src/concurrency/sync-exercises/link-checker.md msgid "" -"Implementing `Write` lets us use the `write!` and `writeln!` macros with our " -"`Uart` type." +"Use threads to check the links in parallel: send the URLs to be checked to a " +"channel and let a few threads check the URLs in parallel." msgstr "" -"`Write`を実装すると、`Uart` タイプに対して `write!`と`writeln!`マクロが利用で" -"きるようになります。" +"スレッドを使用してリンクを同時にチェックします。つまり、チェックする URL を" +"チャンネルに送信し、いくつかのスレッドで同時に URL を確認します。" -#: src/bare-metal/aps/uart/traits.md +#: src/concurrency/sync-exercises/link-checker.md msgid "" -"Run the example in QEMU with `make qemu_minimal` under `src/bare-metal/aps/" -"examples`." +"Extend this to recursively extract links from all pages on the `www.google." +"org` domain. Put an upper limit of 100 pages or so so that you don't end up " +"being blocked by the site." msgstr "" -"この例を`src/bare-metal/aps/examples`において`make qemu_minimal`とすること" -"で、QEMUにより実行してみましょう。" +"これを拡張して、`www.google.org` ドメインのすべてのページからリンクを再帰的に" +"抽出します。サイトがブロックされないように、ページ数の上限を 100 程度に設定し" +"ます。" -#: src/bare-metal/aps/better-uart.md -msgid "A better UART driver" -msgstr "UARTドライバの改善" +#: src/concurrency/sync-exercises/solutions.md +msgid "\"{} is trying to eat\"" +msgstr "\"{} is trying to eat\"" -#: src/bare-metal/aps/better-uart.md +#: src/concurrency/sync-exercises/solutions.md msgid "" -"The PL011 actually has [a bunch more registers](https://developer.arm.com/" -"documentation/ddi0183/g/programmers-model/summary-of-registers), and adding " -"offsets to construct pointers to access them is error-prone and hard to " -"read. Plus, some of them are bit fields which would be nice to access in a " -"structured way." +"// To avoid a deadlock, we have to break the symmetry\n" +" // somewhere. This will swap the forks without deinitializing\n" +" // either of them.\n" msgstr "" -"実際のところPL011には[もっと多くのレジスタ](https://developer.arm.com/" -"documentation/ddi0183/g/programmers-model/summary-of-registers)があり、それら" -"にアクセスするためにオフセットを足してポインタを得ることは間違えになりやす" -"く、可読性を低下させます。さらに、いくつかはビットフィールドなので、構造化さ" -"れた方法でアクセスできたほうが良いでしょう。" +"// デッドロックを避けるために、どこかで対称性を\n" +" // 崩す必要があります。下記のコードでは、\n" +" // 領域を開放することなく2つのフォークを交換します。\n" -#: src/bare-metal/aps/better-uart.md -msgid "Offset" -msgstr "オフセット" +#: src/concurrency/sync-exercises/solutions.md +msgid "\"{thought}\"" +msgstr "\"{thought}\"" -#: src/bare-metal/aps/better-uart.md -msgid "Register name" -msgstr "レジスタ名" +#: src/concurrency/sync-exercises/solutions.md +#, fuzzy +msgid "Link Checker" +msgstr "マルチスレッド・リンクチェッカー" -#: src/bare-metal/aps/better-uart.md -msgid "Width" -msgstr "幅" +#: src/concurrency/sync-exercises/solutions.md +msgid "" +"/// Determine whether links within the given page should be extracted.\n" +msgstr "/// 指定されたページ内のリンクを抽出するかどうかを決定します。\n" -#: src/bare-metal/aps/better-uart.md -msgid "0x00" -msgstr "0x00" +#: src/concurrency/sync-exercises/solutions.md +msgid "" +"/// Mark the given page as visited, returning false if it had already\n" +" /// been visited.\n" +msgstr "" +"/// 指定されたページを訪問済みとしてマークし、すでに訪問済みであれば\n" +" /// false を返します。\n" -#: src/bare-metal/aps/better-uart.md -msgid "DR" -msgstr "DR" +#: src/concurrency/sync-exercises/solutions.md +msgid "// The sender got dropped. No more commands coming in.\n" +msgstr "// 送信者がドロップされました。今後コマンドは受信されません。\n" -#: src/bare-metal/aps/better-uart.md -msgid "12" -msgstr "12" +#: src/concurrency/sync-exercises/solutions.md +msgid "\"Got crawling error: {:#}\"" +msgstr "\"Got crawling error: {:#}\"" -#: src/bare-metal/aps/better-uart.md -msgid "0x04" -msgstr "0x04" +#: src/concurrency/sync-exercises/solutions.md +msgid "\"Bad URLs: {:#?}\"" +msgstr "\"Bad URLs: {:#?}\"" -#: src/bare-metal/aps/better-uart.md -msgid "RSR" -msgstr "RSR" +#: src/concurrency/welcome-async.md +msgid "" +"\"Async\" is a concurrency model where multiple tasks are executed " +"concurrently by executing each task until it would block, then switching to " +"another task that is ready to make progress. The model allows running a " +"larger number of tasks on a limited number of threads. This is because the " +"per-task overhead is typically very low and operating systems provide " +"primitives for efficiently identifying I/O that is able to proceed." +msgstr "" +"「Async」は複数のタスクが並行処理される並行性モデルです。それぞれのタスクはブ" +"ロックされるまで実行され、そして次に進むことのできる他のタスクに切り替えるこ" +"とにより実現されます。このモデルは限られた数のスレッド上でより多くのタスクを" +"実行することを可能にします。なぜなら、タスクごとのオーバーヘッドは通常はとて" +"も低く、効率的に実行可能なI/Oを特定するために必要なプリミティブをOSが提供して" +"くれるからです。" -#: src/bare-metal/aps/better-uart.md -msgid "0x18" -msgstr "0x18" +#: src/concurrency/welcome-async.md +msgid "" +"Rust's asynchronous operation is based on \"futures\", which represent work " +"that may be completed in the future. Futures are \"polled\" until they " +"signal that they are complete." +msgstr "" +"Rustの非同期的な操作は「future」に基づいていて、これは将来に完了するかもしれ" +"ない作業を表しています。Futureは、タスクが完了したことを知らせるシグナルが得" +"られるまでポーリングされます。" -#: src/bare-metal/aps/better-uart.md -msgid "FR" -msgstr "FR" +#: src/concurrency/welcome-async.md +msgid "" +"Futures are polled by an async runtime, and several different runtimes are " +"available." +msgstr "" +"Futureは非同期的なランタイムによりポーリングされます。ランタイムにはいくつか" +"の選択肢があります。" -#: src/bare-metal/aps/better-uart.md -msgid "9" -msgstr "9" +#: src/concurrency/welcome-async.md +msgid "" +"Python has a similar model in its `asyncio`. However, its `Future` type is " +"callback-based, and not polled. Async Python programs require a \"loop\", " +"similar to a runtime in Rust." +msgstr "" +"Pythonには似たようなモデルが`asyncio`として搭載されています。しかし、ここでの" +"`Future`型はコールバックに基づくものであって、ポーリングによるものではありま" +"せん。Pythonの非同期プログラムは「ループ」を必要とし、Rustのランタイムに似て" +"います。" -#: src/bare-metal/aps/better-uart.md -msgid "0x20" -msgstr "0x20" +#: src/concurrency/welcome-async.md +msgid "" +"JavaScript's `Promise` is similar, but again callback-based. The language " +"runtime implements the event loop, so many of the details of Promise " +"resolution are hidden." +msgstr "" +"JavaScriptの`Promise`は似ているものの、これもまたもやコールバックに基づきま" +"す。 この言語のランタイムはイベントループにより実装されているため、多くの" +"Promise解決の詳細は隠されています。" -#: src/bare-metal/aps/better-uart.md -msgid "ILPR" -msgstr "ILPR" +#: src/concurrency/async.md +msgid "async/await" +msgstr "async/await" -#: src/bare-metal/aps/better-uart.md -msgid "0x24" -msgstr "0x24" +#: src/concurrency/async/async-await.md +msgid "" +"At a high level, async Rust code looks very much like \"normal\" sequential " +"code:" +msgstr "" +"おおまかには、Rustの非同期コードはほとんど「通常の」逐次的なコードのように見" +"えます:" -#: src/bare-metal/aps/better-uart.md -msgid "IBRD" -msgstr "IBRD" +#: src/concurrency/async/async-await.md +msgid "\"Count is: {i}!\"" +msgstr "\"Count is: {i}!\"" -#: src/bare-metal/aps/better-uart.md -msgid "16" -msgstr "16" +#: src/concurrency/async/async-await.md +msgid "" +"Note that this is a simplified example to show the syntax. There is no long " +"running operation or any real concurrency in it!" +msgstr "" +"これは構文を示すための単純化された例であることに注意してください。長く実行さ" +"れうる操作や本物の並行処理はここには含まれません。" -#: src/bare-metal/aps/better-uart.md -msgid "0x28" -msgstr "0x28" +#: src/concurrency/async/async-await.md +msgid "What is the return type of an async call?" +msgstr "非同期の呼び出しの返り値の型は？" -#: src/bare-metal/aps/better-uart.md -msgid "FBRD" -msgstr "FBRD" +#: src/concurrency/async/async-await.md +msgid "Use `let future: () = async_main(10);` in `main` to see the type." +msgstr "" +"型を知るために`main`で`let future: () = async_main(10);`を使ってみてくださ" +"い。" -#: src/bare-metal/aps/better-uart.md -msgid "0x2c" -msgstr "0x2c" +#: src/concurrency/async/async-await.md +#, fuzzy +msgid "" +"The \"async\" keyword is syntactic sugar. The compiler replaces the return " +"type with a future." +msgstr "" +"「async」キーワードは糖衣構文です。コンパイラは返り値をfutureに置き換えます。" -#: src/bare-metal/aps/better-uart.md -msgid "LCR_H" -msgstr "LCR_H" +#: src/concurrency/async/async-await.md +msgid "" +"You cannot make `main` async, without additional instructions to the " +"compiler on how to use the returned future." +msgstr "" +"コンパイラに対して、返されたfutureの値をその後どう扱うべきかという、追加の指" +"示を含めない限り、`main`をasyncにすることはできません。" -#: src/bare-metal/aps/better-uart.md -msgid "0x30" -msgstr "0x30" +#: src/concurrency/async/async-await.md +#, fuzzy +msgid "" +"You need an executor to run async code. `block_on` blocks the current thread " +"until the provided future has run to completion." +msgstr "" +"非同期のコードを実行するためには、エグゼキュータが必要です。`block_on`は、与" +"えられたfutureが最後まで実行されるまで、現在のスレッドをブロックします。" -#: src/bare-metal/aps/better-uart.md -msgid "CR" -msgstr "CR" +#: src/concurrency/async/async-await.md +msgid "" +"`.await` asynchronously waits for the completion of another operation. " +"Unlike `block_on`, `.await` doesn't block the current thread." +msgstr "" +"`.await`は非同期的に他の操作の完了を待ちます。`block_on`とは異なり、`.await`" +"は現在のスレッドをブロックしません。" -#: src/bare-metal/aps/better-uart.md -msgid "0x34" -msgstr "0x34" +#: src/concurrency/async/async-await.md +#, fuzzy +msgid "" +"`.await` can only be used inside an `async` function (or block; these are " +"introduced later)." +msgstr "" +"`.await`はasync関数(またはasync ブロック)の中でのみ利用できます。(async関数・" +"ブロックについては後ほど紹介します。)" -#: src/bare-metal/aps/better-uart.md -msgid "IFLS" -msgstr "IFLS" +#: src/concurrency/async/futures.md +msgid "" +"[`Future`](https://doc.rust-lang.org/std/future/trait.Future.html) is a " +"trait, implemented by objects that represent an operation that may not be " +"complete yet. A future can be polled, and `poll` returns a [`Poll`](https://" +"doc.rust-lang.org/std/task/enum.Poll.html)." +msgstr "" +"[`Future`](https://doc.rust-lang.org/std/future/trait.Future.html)はトレイト" +"であり、まだ完了してないかもしれない操作を表現するオブジェクトにより実装され" +"ます。Futureはポーリングされることがあり、`poll`は[`Poll`](https://doc.rust-" +"lang.org/std/task/enum.Poll.html)を返します。" -#: src/bare-metal/aps/better-uart.md -msgid "0x38" -msgstr "0x38" +#: src/concurrency/async/futures.md +msgid "" +"An async function returns an `impl Future`. It's also possible (but " +"uncommon) to implement `Future` for your own types. For example, the " +"`JoinHandle` returned from `tokio::spawn` implements `Future` to allow " +"joining to it." +msgstr "" +"非同期の関数は`impl Future`を返します。自分で定義した型に対して`Future`を実装" +"することも（あまりないことですが）可能です。例えば、`tokio::spawn`から返され" +"る`JoinHandle`は`Future`を実装することにより、joinすることを可能にしていま" +"す。" -#: src/bare-metal/aps/better-uart.md -msgid "IMSC" -msgstr "IMSC" +#: src/concurrency/async/futures.md +msgid "" +"The `.await` keyword, applied to a Future, causes the current async function " +"to pause until that Future is ready, and then evaluates to its output." +msgstr "" +"Futureに適用される`.await`キーワードは、そのFutureの準備ができるまで、現在の" +"非同期の関数の一時停止を起こし、そしてその出力を評価します。" -#: src/bare-metal/aps/better-uart.md -msgid "11" -msgstr "11" +#: src/concurrency/async/futures.md +msgid "" +"The `Future` and `Poll` types are implemented exactly as shown; click the " +"links to show the implementations in the docs." +msgstr "" +"`Future`と`Poll`の型はまさに示されたように実装されます; ドキュメントの具体的" +"な実装を見るにはリンクをクリックしてください。" -#: src/bare-metal/aps/better-uart.md -msgid "0x3c" -msgstr "0x3c" +#: src/concurrency/async/futures.md +msgid "" +"We will not get to `Pin` and `Context`, as we will focus on writing async " +"code, rather than building new async primitives. Briefly:" +msgstr "" +"`Pin`と`Context`については詳しくは扱いません。なぜなら、新しく非同期のプリミ" +"ティブを作るよりも、非同期のコードを書くことに我々は重点を置くつもりだからで" +"す。簡潔には以下で説明されます：" -#: src/bare-metal/aps/better-uart.md -msgid "RIS" -msgstr "RIS" +#: src/concurrency/async/futures.md +msgid "" +"`Context` allows a Future to schedule itself to be polled again when an " +"event occurs." +msgstr "" +"`Context`は、特定のイベントが発生した時に、Futureが自分自身を再びポーリングさ" +"れるようにスケジュールすることを可能にします。" -#: src/bare-metal/aps/better-uart.md -msgid "0x40" -msgstr "0x40" +#: src/concurrency/async/futures.md +msgid "" +"`Pin` ensures that the Future isn't moved in memory, so that pointers into " +"that future remain valid. This is required to allow references to remain " +"valid after an `.await`." +msgstr "" +"`Pin`はfutureへのポインタが有効であり続けるために、Futureがメモリの中で移動さ" +"れないことを確実にします。これは、参照が`.await`の後に有効であり続けるために" +"必要です。" -#: src/bare-metal/aps/better-uart.md -msgid "MIS" -msgstr "MIS" +#: src/concurrency/async/runtimes.md +msgid "" +"A _runtime_ provides support for performing operations asynchronously (a " +"_reactor_) and is responsible for executing futures (an _executor_). Rust " +"does not have a \"built-in\" runtime, but several options are available:" +msgstr "" +"\\_runtime_は非同期な演算（_reactor_）のサポートを提供し、また、futureを実行" +"すること（_executor_）を担当しています。Rustには「ビルトイン」のランタイムは" +"ありませんが、いくつかのランタイムの選択肢があります: " -#: src/bare-metal/aps/better-uart.md -msgid "0x44" -msgstr "0x44" +#: src/concurrency/async/runtimes.md +#, fuzzy +msgid "" +"[Tokio](https://tokio.rs/): performant, with a well-developed ecosystem of " +"functionality like [Hyper](https://hyper.rs/) for HTTP or [Tonic](https://" +"github.com/hyperium/tonic) for gRPC." +msgstr "" +"[Tokio](https://tokio.rs/) - パフォーマンスが高い。HTTP向けの[Hyper](https://" +"hyper.rs/)やgRPC向けの[Tonic](https://github.com/hyperium/tonic)のような発達" +"したエコシステムも持っている" -#: src/bare-metal/aps/better-uart.md -msgid "ICR" -msgstr "ICR" +#: src/concurrency/async/runtimes.md +#, fuzzy +msgid "" +"[async-std](https://async.rs/): aims to be a \"std for async\", and includes " +"a basic runtime in `async::task`." +msgstr "" +"[async-std](https://async.rs/) - 「async」のための「std」であることを目指した" +"もの。また、`async::task`に基本的なランタイムを含む。" -#: src/bare-metal/aps/better-uart.md -msgid "0x48" -msgstr "0x48" +#: src/concurrency/async/runtimes.md +#, fuzzy +msgid "[smol](https://docs.rs/smol/latest/smol/): simple and lightweight" +msgstr "[smol](https://docs.rs/smol/latest/smol/) - シンプルで軽量" -#: src/bare-metal/aps/better-uart.md -msgid "DMACR" -msgstr "DMACR" +#: src/concurrency/async/runtimes.md +msgid "" +"Several larger applications have their own runtimes. For example, [Fuchsia]" +"(https://fuchsia.googlesource.com/fuchsia/+/refs/heads/main/src/lib/fuchsia-" +"async/src/lib.rs) already has one." +msgstr "" +"いくつかのより巨大なアプリケーションは、独自のランタイムを備えています。例え" +"ば[Fuchsia](https://fuchsia.googlesource.com/fuchsia/+/refs/heads/main/src/" +"lib/fuchsia-async/src/lib.rs)はそのようなものをすでに備えています。" -#: src/bare-metal/aps/better-uart.md -msgid "There are also some ID registers which have been omitted for brevity." -msgstr "いくつかのIDレジスタは簡単化のための省略しています。" +#: src/concurrency/async/runtimes.md +msgid "" +"Note that of the listed runtimes, only Tokio is supported in the Rust " +"playground. The playground also does not permit any I/O, so most interesting " +"async things can't run in the playground." +msgstr "" +"上で挙げられたランタイムのうち、TokioのみがRustプレイグラウンドでサポートされ" +"ています。このプレイグラウンドではいかなる入出力操作も許可されていないため、" +"大抵の興味深い非同期のあれこれは、プレイグラウンドで実行することはできませ" +"ん。" -#: src/bare-metal/aps/better-uart/bitflags.md +#: src/concurrency/async/runtimes.md msgid "" -"The [`bitflags`](https://crates.io/crates/bitflags) crate is useful for " -"working with bitflags." +"Futures are \"inert\" in that they do not do anything (not even start an I/O " +"operation) unless there is an executor polling them. This differs from JS " +"Promises, for example, which will run to completion even if they are never " +"used." msgstr "" -"[`bitflags`](https://crates.io/crates/bitflags) クレートはビットフラグを扱う" -"のに便利です。" +"Futureは、ポーリングを行うエグゼキュータの存在なしには何も行わない（入出力操" +"作さえ始めない）という点で「怠惰」です。例えば、これは、エグゼキュータがなく" +"とも最後まで実行されるJavaScriptのPromiseとは異なります。" -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Flags from the UART flag register.\n" -msgstr "/// UART フラグレジスタからのフラグ。\n" +#: src/concurrency/async/runtimes/tokio.md +#, fuzzy +msgid "Tokio provides:" +msgstr "Tokioは以下を提供します: " -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Clear to send.\n" -msgstr "/// 送信可。\n" +#: src/concurrency/async/runtimes/tokio.md +msgid "A multi-threaded runtime for executing asynchronous code." +msgstr "非同期のコードを実行するためのマルチスレッドのランタイム。" -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Data set ready.\n" -msgstr "/// データセット レディ。\n" +#: src/concurrency/async/runtimes/tokio.md +msgid "An asynchronous version of the standard library." +msgstr "標準ライブラリの非同期バージョン。" -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Data carrier detect.\n" -msgstr "/// データキャリア検出。\n" +#: src/concurrency/async/runtimes/tokio.md +msgid "A large ecosystem of libraries." +msgstr "大きなライブラリのエコシステム。" -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// UART busy transmitting data.\n" -msgstr "/// UART はデータ送信のためビジー状態。\n" +#: src/concurrency/async/runtimes/tokio.md +msgid "\"Count in task: {i}!\"" +msgstr "\"Count in task: {i}!\"" -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Receive FIFO is empty.\n" -msgstr "/// 受信 FIFO が空。\n" +#: src/concurrency/async/runtimes/tokio.md +msgid "\"Main task: {i}\"" +msgstr "\"Main task: {i}\"" -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Transmit FIFO is full.\n" -msgstr "/// 送信 FIFO が満杯。\n" +#: src/concurrency/async/runtimes/tokio.md +msgid "With the `tokio::main` macro we can now make `main` async." +msgstr "`tokio::main`のマクロにより、`main`の非同期処理を作ることができます。" -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Receive FIFO is full.\n" -msgstr "/// 受信 FIFO が満杯。\n" +#: src/concurrency/async/runtimes/tokio.md +msgid "The `spawn` function creates a new, concurrent \"task\"." +msgstr "`spawn`関数は新しい並行の「タスク」を作成します。" -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Transmit FIFO is empty.\n" -msgstr "/// 送信 FIFO が空。\n" +#: src/concurrency/async/runtimes/tokio.md +msgid "Note: `spawn` takes a `Future`, you don't call `.await` on `count_to`." +msgstr "" +"注意：`spawn`は`Future`を引数に取るため、`count_to`に対して`.await`を呼ぶこと" +"はありません。" -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Ring indicator.\n" -msgstr "/// 着呼表示。\n" +#: src/concurrency/async/runtimes/tokio.md +msgid "**Further exploration:**" +msgstr "**さらなる探求:**" -#: src/bare-metal/aps/better-uart/bitflags.md +#: src/concurrency/async/runtimes/tokio.md msgid "" -"The `bitflags!` macro creates a newtype something like `Flags(u16)`, along " -"with a bunch of method implementations to get and set flags." +"Why does `count_to` not (usually) get to 10? This is an example of async " +"cancellation. `tokio::spawn` returns a handle which can be awaited to wait " +"until it finishes." msgstr "" -"`bitflags!`マクロは`Flags(u16)`のような新しいタイプを生成し、フラグを読み書き" -"するための多くのメソッド実装を一緒に提供します。" - -#: src/bare-metal/aps/better-uart/registers.md -msgid "Multiple registers" -msgstr "複数のレジスタ" +"どうして`count_to`は（通常は）10に辿り着かないのでしょうか？これは非同期処理" +"のキャンセルの例です。 `tokio::spawn`は完了まで待機するためのハンドラを返しま" +"す。" -#: src/bare-metal/aps/better-uart/registers.md -msgid "" -"We can use a struct to represent the memory layout of the UART's registers." +#: src/concurrency/async/runtimes/tokio.md +msgid "Try `count_to(10).await` instead of spawning." msgstr "" -"構造体を使ってUARTのレジスタのメモリレイアウトを表現することができます。" +"プロセスを新しく作る代わりに、`count_to(10).await`を試してみてください。" -#: src/bare-metal/aps/better-uart/registers.md +#: src/concurrency/async/runtimes/tokio.md +msgid "Try awaiting the task returned from `tokio::spawn`." +msgstr "`tokio::spawn`から返されたタスクを待機してみてください。" + +#: src/concurrency/async/tasks.md +msgid "Rust has a task system, which is a form of lightweight threading." +msgstr "Rust には、軽量のスレッド形式の一種であるタスクシステムがあります。" + +#: src/concurrency/async/tasks.md msgid "" -"[`#[repr(C)]`](https://doc.rust-lang.org/reference/type-layout.html#the-c-" -"representation) tells the compiler to lay the struct fields out in order, " -"following the same rules as C. This is necessary for our struct to have a " -"predictable layout, as default Rust representation allows the compiler to " -"(among other things) reorder fields however it sees fit." +"A task has a single top-level future which the executor polls to make " +"progress. That future may have one or more nested futures that its `poll` " +"method polls, corresponding loosely to a call stack. Concurrency within a " +"task is possible by polling multiple child futures, such as racing a timer " +"and an I/O operation." msgstr "" -"[`#[repr(C)]`](https://doc.rust-lang.org/reference/type-layout.html#the-c-" -"representation) はコンパイラに対して、Cと同じ規則に従って構造体のフィールドを" -"定義されている順番で配置することを指示します。これは構造体のレイアウトを予測" -"可能にするために必要です。なぜならば、Rust標準の表現はコンパイラがフィールド" -"を好きなように並び替えること（他にも色々とありますが）を許しているからです。" +"タスクには、単一のトップレベルのfutureがあり、これはエグゼキュータが先に進む" +"ためにポーリングする対象となります。そのfutureには一つまたは複数のfutureがネ" +"ストされていることもあり、トップレベルのfutureの`poll`メソッドがポーリングす" +"ることになり、大まかにはコールスタックに対応すると言えます。タスクにおける並" +"行処理は、例えば競合タイマーや入出力操作など、複数の子のfutureをポーリングす" +"ることにより可能になります。" -#: src/bare-metal/aps/better-uart/driver.md -msgid "Now let's use the new `Registers` struct in our driver." -msgstr "新しく定義した`Registers` 構造体を我々のドライバで使ってみましょう。" +#: src/concurrency/async/tasks.md +msgid "\"127.0.0.1:0\"" +msgstr "\"127.0.0.1:0\"" -#: src/bare-metal/aps/better-uart/driver.md -msgid "/// Driver for a PL011 UART.\n" -msgstr "/// PL011 UART のドライバ。\n" +#: src/concurrency/async/tasks.md +msgid "\"listening on port {}\"" +msgstr "\"listening on port {}\"" -#: src/bare-metal/aps/better-uart/driver.md src/exercises/bare-metal/rtc.md +#: src/concurrency/async/tasks.md +msgid "\"connection from {addr:?}\"" +msgstr "\"connection from {addr:?}\"" + +#: src/concurrency/async/tasks.md +msgid "b\"Who are you?\\n\"" +msgstr "b\"Who are you?\\n\"" + +#: src/concurrency/async/tasks.md +msgid "\"socket error\"" +msgstr "\"socket error\"" + +#: src/concurrency/async/tasks.md +msgid "\"Thanks for dialing in, {name}!\\n\"" +msgstr "\"Thanks for dialing in, {name}!\\n\"" + +#: src/concurrency/async/tasks.md src/concurrency/async-control-flow/join.md msgid "" -"// Safe because we know that self.registers points to the control\n" -" // registers of a PL011 device which is appropriately mapped.\n" +"Copy this example into your prepared `src/main.rs` and run it from there." msgstr "" -"// self.registers が、適切にマッピングされた PL011 デバイスのコントロール レ" -"ジスタを\n" -" // 指していることがわかっているため、安全です。\n" +"この例を準備した`src/main.rs`にコピーして、そこから実行してみましょう。" -#: src/bare-metal/aps/better-uart/driver.md src/exercises/bare-metal/rtc.md +#: src/concurrency/async/tasks.md msgid "" -"/// Reads and returns a pending byte, or `None` if nothing has been\n" -" /// received.\n" +"Try connecting to it with a TCP connection tool like [nc](https://www.unix." +"com/man-page/linux/1/nc/) or [telnet](https://www.unix.com/man-page/linux/1/" +"telnet/)." msgstr "" -"/// 保留中のバイトを読み取り、何も受け取っていない場合は`None` を\n" -" /// 返します。\n" - -#: src/bare-metal/aps/better-uart/driver.md src/exercises/bare-metal/rtc.md -msgid "// TODO: Check for error conditions in bits 8-11.\n" -msgstr "// TODO: ビット 8～11 でエラー状態をチェックします。\n" +"[nc](https://www.unix.com/man-page/linux/1/nc/) や [telnet](https://www.unix." +"com/man-page/linux/1/telnet/) などの TCP 接続ツールを使用して接続してみてくだ" +"さい。" -#: src/bare-metal/aps/better-uart/driver.md +#: src/concurrency/async/tasks.md msgid "" -"Note the use of `addr_of!` / `addr_of_mut!` to get pointers to individual " -"fields without creating an intermediate reference, which would be unsound." +"Ask students to visualize what the state of the example server would be with " +"a few connected clients. What tasks exist? What are their Futures?" msgstr "" -"`addr_of!`と`addr_of_mut!` を使用して個々のフィールドに対するポインタを取得す" -"ることで、不健全となってしまう中間的な参照を作らずに済んでいることに注目して" -"ください。" - -#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md -msgid "Using it" -msgstr "使用例" +"例のサーバーがどのような状態の時に、いくつかのクライアントと接続された状態に" +"あるのかを、可視化するように受講者に指示してください。どんなタスクが存在して" +"いますか？それらのfutureは何ですか？" -#: src/bare-metal/aps/better-uart/using.md +#: src/concurrency/async/tasks.md +#, fuzzy msgid "" -"Let's write a small program using our driver to write to the serial console, " -"and echo incoming bytes." +"This is the first time we've seen an `async` block. This is similar to a " +"closure, but does not take any arguments. Its return value is a Future, " +"similar to an `async fn`." msgstr "" -"我々のドライバを使って、シリアルコンソールにライトし、そして入力されたバイト" -"をエコーする小さなプログラムを書いてみましょう。" +"私たちが`async`ブロックを見かけるのは初めてですね。これはクロージャと似ていま" +"すが、何も引数は取りません。この返り値はFutureであり、`async fn`と似ていま" +"す。" -#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md -#: src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Base address of the primary PL011 UART.\n" -msgstr "/// プライマリ PL011 UART のベースアドレス。\n" +#: src/concurrency/async/tasks.md +msgid "" +"Refactor the async block into a function, and improve the error handling " +"using `?`." +msgstr "" +"mainのasyncブロックを関数にリファクタして、`?`を使ったエラーハンドリングを改" +"善してみましょう。" -#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md -#: src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/concurrency/async-control-flow/channels.md +#, fuzzy msgid "" -"// Safe because `PL011_BASE_ADDRESS` is the base address of a PL011 device,\n" -" // and nothing else accesses that address range.\n" +"Several crates have support for asynchronous channels. For instance `tokio`:" msgstr "" -"// `PL011_BASE_ADDRESS` が PL011 デバイスのベースアドレスであり、\n" -" // 他からこのアドレス範囲にアクセスされることがないため、安全です。\n" +"いくつかのクレートは`async`/`await`をサポートしています。例えば、`tokio`チャ" +"ネルは:" -#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md -msgid "\"main({x0:#x}, {x1:#x}, {x2:#x}, {x3:#x})\"" -msgstr "\"main({x0:#x}, {x1:#x}, {x2:#x}, {x3:#x})\"" +#: src/concurrency/async-control-flow/channels.md +msgid "\"Received {count} pings so far.\"" +msgstr "\"Received {count} pings so far.\"" -#: src/bare-metal/aps/better-uart/using.md -msgid "b'\\r'" -msgstr "b'\\r'" +#: src/concurrency/async-control-flow/channels.md +msgid "\"ping_handler complete\"" +msgstr "\"ping_handler complete\"" -#: src/bare-metal/aps/better-uart/using.md src/async/pitfalls/cancellation.md -msgid "b'\\n'" -msgstr "b'\\n'" +#: src/concurrency/async-control-flow/channels.md +msgid "\"Failed to send ping.\"" +msgstr "\"Failed to send ping.\"" -#: src/bare-metal/aps/better-uart/using.md -msgid "b'q'" -msgstr "b'q'" +#: src/concurrency/async-control-flow/channels.md +msgid "\"Sent {} pings so far.\"" +msgstr "\"Sent {} pings so far.\"" -#: src/bare-metal/aps/better-uart/using.md -msgid "\"Bye!\"" -msgstr "\"Bye!\"" +#: src/concurrency/async-control-flow/channels.md +msgid "\"Something went wrong in ping handler task.\"" +msgstr "\"Something went wrong in ping handler task.\"" -#: src/bare-metal/aps/better-uart/using.md -msgid "" -"As in the [inline assembly](../inline-assembly.md) example, this `main` " -"function is called from our entry point code in `entry.S`. See the speaker " -"notes there for details." +#: src/concurrency/async-control-flow/channels.md +msgid "Change the channel size to `3` and see how it affects the execution." msgstr "" -"[インラインアセンブリ](../inline-assembly.md) の例と同じように、この`main`関" -"数は`entry.S`におけるエントリポイントから呼び出されます。詳細はそちらの" -"speaker notesを参照してください。" +"チャネルサイズを `3`に変えてみて、これがどのように処理に影響するか確認してみ" +"ましょう。" -#: src/bare-metal/aps/better-uart/using.md +#: src/concurrency/async-control-flow/channels.md +#, fuzzy msgid "" -"Run the example in QEMU with `make qemu` under `src/bare-metal/aps/examples`." +"Overall, the interface is similar to the `sync` channels as seen in the " +"[morning class](../channels.md)." msgstr "" -"この例を`src/bare-metal/aps/examples`において`make qemu`とすることでQEMUによ" -"り実行してみましょう。" +"一般的に、このインターフェースは、[朝の講座](concurrency/channels.md)で見られ" +"たような`sync`チャネルに似ています。" -#: src/bare-metal/aps/logging.md -msgid "" -"It would be nice to be able to use the logging macros from the [`log`]" -"(https://crates.io/crates/log) crate. We can do this by implementing the " -"`Log` trait." +#: src/concurrency/async-control-flow/channels.md +msgid "Try removing the `std::mem::drop` call. What happens? Why?" msgstr "" -"[`log`](https://crates.io/crates/log) クレートが提供するログ用マクロを使える" -"と良いでしょう。これは`Log`トレイトを実装することで可能になります。" +"`std::mem::drop`の呼び出しを除いてみましょう。何か起こるでしょうか？それはな" +"ぜでしょうか？" -#: src/bare-metal/aps/logging.md src/exercises/bare-metal/rtc.md -msgid "\"[{}] {}\"" -msgstr "\"[{}] {}\"" +#: src/concurrency/async-control-flow/channels.md +msgid "" +"The [Flume](https://docs.rs/flume/latest/flume/) crate has channels that " +"implement both `sync` and `async` `send` and `recv`. This can be convenient " +"for complex applications with both IO and heavy CPU processing tasks." +msgstr "" +"[Flume](https://docs.rs/flume/latest/flume/)クレートには`sync`と`async`や" +"`send`と`recv`の両方を実装するチャネルがあります。 これは入出力と重いCPUの処" +"理のタスクの両方を含む、複雑なアプリケーションで便利です。" -#: src/bare-metal/aps/logging.md src/exercises/bare-metal/rtc.md -msgid "/// Initialises UART logger.\n" -msgstr "/// UART ロガーを初期化します。\n" +#: src/concurrency/async-control-flow/channels.md +msgid "" +"What makes working with `async` channels preferable is the ability to " +"combine them with other `future`s to combine them and create complex control " +"flow." +msgstr "" +"`async`チャネルを扱うことを好ましくするのは、チャネルと繋げるためにや、複雑な" +"コントロールフローを作るために、チャネルを他の`future`と繋げられることです。" -#: src/bare-metal/aps/logging.md +#: src/concurrency/async-control-flow/join.md msgid "" -"The unwrap in `log` is safe because we initialise `LOGGER` before calling " -"`set_logger`." +"A join operation waits until all of a set of futures are ready, and returns " +"a collection of their results. This is similar to `Promise.all` in " +"JavaScript or `asyncio.gather` in Python." msgstr "" -"`LOGGER` を`set_logger`を呼び出す前に初期化しているので、log` におけるunwrap" -"はセーフです。" +"Joinという操作では、futureの集合の準備が整うまで待機し、その後に結果をまとめ" +"て返します。これはJavaScriptにおける `Promise.all` やPythonにおける`asyncio." +"gather`に似ています。" -#: src/bare-metal/aps/logging/using.md -msgid "We need to initialise the logger before we use it." -msgstr "使用前にloggerを初期化する必要があります。" +#: src/concurrency/async-control-flow/join.md +msgid "\"https://google.com\"" +msgstr "\"https://google.com\"" -#: src/bare-metal/aps/logging/using.md src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "\"{info}\"" -msgstr "\"{info}\"" +#: src/concurrency/async-control-flow/join.md +msgid "\"https://httpbin.org/ip\"" +msgstr "\"https://httpbin.org/ip\"" -#: src/bare-metal/aps/logging/using.md -msgid "Note that our panic handler can now log details of panics." -msgstr "" -"我々のパニックハンドラがパニックの詳細についてログ出力できるようになったこと" -"に注目してください。" +#: src/concurrency/async-control-flow/join.md +msgid "\"https://play.rust-lang.org/\"" +msgstr "\"https://play.rust-lang.org/\"" -#: src/bare-metal/aps/logging/using.md -msgid "" -"Run the example in QEMU with `make qemu_logger` under `src/bare-metal/aps/" -"examples`." -msgstr "" -"この例を`src/bare-metal/aps/examples`において`make qemu_logger`とすることで" -"QEMUにより実行してみましょう。" +#: src/concurrency/async-control-flow/join.md +msgid "\"BAD_URL\"" +msgstr "\"BAD_URL\"" -#: src/bare-metal/aps/exceptions.md +#: src/concurrency/async-control-flow/join.md msgid "" -"AArch64 defines an exception vector table with 16 entries, for 4 types of " -"exceptions (synchronous, IRQ, FIQ, SError) from 4 states (current EL with " -"SP0, current EL with SPx, lower EL using AArch64, lower EL using AArch32). " -"We implement this in assembly to save volatile registers to the stack before " -"calling into Rust code:" +"For multiple futures of disjoint types, you can use `std::future::join!` but " +"you must know how many futures you will have at compile time. This is " +"currently in the `futures` crate, soon to be stabilised in `std::future`." msgstr "" -"AArch64は16エントリを持つ例外ベクターテーブルを定義しており、これらは４つのス" -"テート（現在のELでSP0利用、現在のELでSPx利用、低位のELでAArch64、低位のELで" -"AArch32）における４つのタイプの例外（同期、IRQ、FIQ、SError）に対応します。こ" -"こではRustコードの呼び出し前に揮発レジスタの値をスタックに退避するためにベク" -"ターテーブルをアセンブリ言語で実装しています：" +"複数の互いに素な型のfutureに対しては、`std::future::join!`を利用できます。し" +"かし、いくつのfutureがコンパイル時に存在しているのかを把握しておく必要があり" +"ます。これは現在`futures`クレートにありますが、近いうちに`std::future`に統合" +"される予定です。" -#: src/bare-metal/aps/exceptions.md -msgid "EL is exception level; all our examples this afternoon run in EL1." +#: src/concurrency/async-control-flow/join.md +#, fuzzy +msgid "" +"The risk of `join` is that one of the futures may never resolve, this would " +"cause your program to stall." msgstr "" -"ELは例外レベルです。本日の午後に扱ったすべての例はEL1で実行されています。" +"`join`のリスクは、複数のfutureのうちの１つでも解決されないとプログラムがス" +"トールしてしまうということです。 " -#: src/bare-metal/aps/exceptions.md +#: src/concurrency/async-control-flow/join.md msgid "" -"For simplicity we aren't distinguishing between SP0 and SPx for the current " -"EL exceptions, or between AArch32 and AArch64 for the lower EL exceptions." +"You can also combine `join_all` with `join!` for instance to join all " +"requests to an http service as well as a database query. Try adding a " +"`tokio::time::sleep` to the future, using `futures::join!`. This is not a " +"timeout (that requires `select!`, explained in the next chapter), but " +"demonstrates `join!`." msgstr "" -"簡単化のために、ここでは現在のEL例外におけるSP0とSPｘの違い、低位のELレベルに" -"おけるAArch32とAArch64の違いを区別していません。" +"また、`join_all`と`join!`を組み合わせることもできます。それは、例えばデータ" +"ベースのクエリと一緒にhttpサービスへの全てのリクエストをjoinする場合です。" +"futureに`futures::join!`を用いて、`tokio::time::sleep`を追加してみてくださ" +"い。これは（次のチャプターで説明する、`select!`を必要とする）タイムアウトでは" +"ありませんが、`join!`の良い実演となっています。" -#: src/bare-metal/aps/exceptions.md +#: src/concurrency/async-control-flow/select.md msgid "" -"For this example we just log the exception and power down, as we don't " -"expect any of them to actually happen." +"A select operation waits until any of a set of futures is ready, and " +"responds to that future's result. In JavaScript, this is similar to `Promise." +"race`. In Python, it compares to `asyncio.wait(task_set, return_when=asyncio." +"FIRST_COMPLETED)`." msgstr "" -"ここではこれらの例外が発生しないはずなので、ただ例外に関するログを出力し、電" -"源を落としています。" +"Selectという操作では、futureの集合のうち、いずれか１つの準備が整うまで待機" +"し、そのfutureが提供する結果に対して応答します。これはJavaScriptにおける" +"`Promise.race`に似ています。また、Pythonにおける `asyncio.wait(task_set, " +"return_when=asyncio.FIRST_COMPLETED)`と比べることができます。" -#: src/bare-metal/aps/exceptions.md +#: src/concurrency/async-control-flow/select.md +#, fuzzy msgid "" -"We can think of exception handlers and our main execution context more or " -"less like different threads. [`Send` and `Sync`](../../concurrency/send-sync." -"md) will control what we can share between them, just like with threads. For " -"example, if we want to share some value between exception handlers and the " -"rest of the program, and it's `Send` but not `Sync`, then we'll need to wrap " -"it in something like a `Mutex` and put it in a static." +"Similar to a match statement, the body of `select!` has a number of arms, " +"each of the form `pattern = future => statement`. When a `future` is ready, " +"its return value is destructured by the `pattern`. The `statement` is then " +"run with the resulting variables. The `statement` result becomes the result " +"of the `select!` macro." msgstr "" -"例外ハンドラとメインの実行コンテキストは異なるスレッドのようなものだと考える" -"ことができます。ちょうどスレッド間の共有と同じように、[`Send`と`Sync`](../../" -"concurrency/send-sync.md)により何を共有するかを制御することができます。例え" -"ば、例外ハンドラとプログラムの他のコンテキストでとある値を共有したい場合に、" -"もしそれが `Send`であり`Sync`でなければ、`Mutex` のようなものでラップして、" -"staticに定義しなければなりません。" +"Matchステートメントのように、`select!`の本体にはいくつかの 「腕」があり、それ" +"ぞれは`pattern = future => statement`の形をとっています。 `future`の準備が" +"整った時、その`statement`は`future`の結果に紐づく`pattern`の変数を用いて実行" +"されます。" -#: src/bare-metal/aps/other-projects.md -msgid "[oreboot](https://github.com/oreboot/oreboot)" -msgstr "[oreboot](https://github.com/oreboot/oreboot)" +#: src/concurrency/async-control-flow/select.md +#, fuzzy +msgid "\"got: {msg}\"" +msgstr "\"Main: got {msg}\"" -#: src/bare-metal/aps/other-projects.md -msgid "\"coreboot without the C\"" -msgstr "\"Cのない（つまり、C言語を使わない）coreboot\"" +#: src/concurrency/async-control-flow/select.md +msgid "\"timeout\"" +msgstr "" -#: src/bare-metal/aps/other-projects.md -msgid "Supports x86, aarch64 and RISC-V." -msgstr "アーキテクチャはx86、aarch64ならびにRISC-Vをサポート。" +#: src/concurrency/async-control-flow/select.md +#, fuzzy +msgid "\"Failed to send greeting\"" +msgstr "\"Failed to send ping.\"" -#: src/bare-metal/aps/other-projects.md -msgid "Relies on LinuxBoot rather than having many drivers itself." -msgstr "自身で多くのドライバを抱えずにLinuxBootに依存。" +#: src/concurrency/async-control-flow/select.md +msgid "\"Listener failed\"" +msgstr "" -#: src/bare-metal/aps/other-projects.md +#: src/concurrency/async-control-flow/select.md msgid "" -"[Rust RaspberryPi OS tutorial](https://github.com/rust-embedded/rust-" -"raspberrypi-OS-tutorials)" +"The `listener` async block here is a common form: wait for some async event, " +"or for a timeout. Change the `sleep` to sleep longer to see it fail. Why " +"does the `send` also fail in this situation?" msgstr "" -"[Rust RaspberryPi OS のチュートリアル](https://github.com/rust-embedded/rust-" -"raspberrypi-OS-tutorials)" -#: src/bare-metal/aps/other-projects.md +#: src/concurrency/async-control-flow/select.md msgid "" -"Initialisation, UART driver, simple bootloader, JTAG, exception levels, " -"exception handling, page tables" +"`select!` is also often used in a loop in \"actor\" architectures, where a " +"task reacts to events in a loop. That has some pitfalls, which will be " +"discussed in the next segment." msgstr "" -"初期化、UARTドライバ、単純なブートローダ、JTAG、例外レベル、例外ハンドラ、" -"ページテーブル" -#: src/bare-metal/aps/other-projects.md +#: src/concurrency/async-pitfalls.md +#, fuzzy +msgid "" +"Async / await provides convenient and efficient abstraction for concurrent " +"asynchronous programming. However, the async/await model in Rust also comes " +"with its share of pitfalls and footguns. We illustrate some of them in this " +"chapter." +msgstr "" +"async / await は、同時実行非同期プログラミングのための便利で効率的な抽象化を" +"提供します。しかし、Rust の async / await モデルには、注意点や誤用されやすい" +"機能もいくつかあるため、この章ではその点について説明します。" + +#: src/concurrency/async-pitfalls.md +msgid "Pin" +msgstr "Pin" + +#: src/concurrency/async-pitfalls/blocking-executor.md +msgid "Blocking the executor" +msgstr "エグゼキュータのブロック" + +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"Some dodginess around cache maintenance and initialisation in Rust, not " -"necessarily a good example to copy for production code." +"Most async runtimes only allow IO tasks to run concurrently. This means that " +"CPU blocking tasks will block the executor and prevent other tasks from " +"being executed. An easy workaround is to use async equivalent methods where " +"possible." msgstr "" -"キャッシュメンテナンスとRustの初期化に関してちょっと疑わしいところがあるの" -"で、製品コードで真似するには必ずしも良い例ではありません。" +"ほとんどの非同期ランタイムは、IO タスクの同時実行のみを許可します。つまり、" +"CPU ブロックタスクはエグゼキュータをブロックし、他のタスクの実行を妨げます。" +"簡単な回避策は、可能であれば非同期の同等のメソッドを使用することです。" -#: src/bare-metal/aps/other-projects.md -msgid "[`cargo-call-stack`](https://crates.io/crates/cargo-call-stack)" -msgstr "[`cargo-call-stack`](https://crates.io/crates/cargo-call-stack)" +#: src/concurrency/async-pitfalls/blocking-executor.md +msgid "\"future {id} slept for {duration_ms}ms, finished after {}ms\"" +msgstr "\"future {id} slept for {duration_ms}ms, finished after {}ms\"" -#: src/bare-metal/aps/other-projects.md -msgid "Static analysis to determine maximum stack usage." -msgstr "スタックの最大使用量に関する静的解析。" +#: src/concurrency/async-pitfalls/blocking-executor.md +msgid "\"current_thread\"" +msgstr "\"current_thread\"" -#: src/bare-metal/aps/other-projects.md +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"The RaspberryPi OS tutorial runs Rust code before the MMU and caches are " -"enabled. This will read and write memory (e.g. the stack). However:" +"Run the code and see that the sleeps happen consecutively rather than " +"concurrently." msgstr "" -"RaspberryPi OS チュートリアルはMMUやキャッシュを有効化する前にRustコードを実" -"行しています。これにより、例えばスタックメモリをreadしたりwriteしたりすること" -"になります。しかし：" +"コードを続けて、スリープが同時ではなく連続して発生することを確認します。" -#: src/bare-metal/aps/other-projects.md +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"Without the MMU and cache, unaligned accesses will fault. It builds with " -"`aarch64-unknown-none` which sets `+strict-align` to prevent the compiler " -"generating unaligned accesses so it should be alright, but this is not " -"necessarily the case in general." +"The `\"current_thread\"` flavor puts all tasks on a single thread. This " +"makes the effect more obvious, but the bug is still present in the multi-" +"threaded flavor." msgstr "" -"MMUとキャッシュを有効化していないと、アラインされていないアクセスはフォールト" -"を引き起こします。そのチュートリアルでは、コンパイラがアラインされていないア" -"クセスを生成しない`+strict-align`オプションをセットする`aarch64-unknown-none`" -"をターゲットとしてビルドしているので大丈夫なはずですが、一般的には大丈夫とは" -"限りません。" +"`\"current_thread\"` フレーバーは、すべてのタスクを 1 つのスレッドに配置しま" +"す。これにより、影響はより明確になりますが、バグはまだマルチスレッド フレー" +"バーに存在します。" -#: src/bare-metal/aps/other-projects.md +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"If it were running in a VM, this can lead to cache coherency issues. The " -"problem is that the VM is accessing memory directly with the cache disabled, " -"while the host has cacheable aliases to the same memory. Even if the host " -"doesn't explicitly access the memory, speculative accesses can lead to cache " -"fills, and then changes from one or the other will get lost. Again this is " -"alright in this particular case (running directly on the hardware with no " -"hypervisor), but isn't a good pattern in general." +"Switch the `std::thread::sleep` to `tokio::time::sleep` and await its result." msgstr "" -"もしVM上で実行していたとすると、キャッシュコヒーレンシーの問題を起こすことが" -"あります。問題なのはVMがキャッシュを無効化したまま直接メモリにアクセスしてい" -"るのに対し、ホストは同じメモリに対してキャッシュ可能なエイリアスを持ってしま" -"うということです。ホストが仮に明示的にメモリにアクセスしないとしても、投機的" -"なアクセスによりキャッシュフィルが起きることがあり、そうなるとVMかホストのど" -"ちらかによる変更が失われてしまいます。この（ハイパーバイザなしで直接ハード" -"ウェアで実行する）場合には問題にはなりませんが、一般的には良くないパターンで" +"`std::thread::sleep` を `tokio::time::sleep` に切り替えて、その結果を待ちま" "す。" -#: src/bare-metal/useful-crates.md -msgid "Useful crates" -msgstr "便利クレート" - -#: src/bare-metal/useful-crates.md +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"We'll go over a few crates which solve some common problems in bare-metal " -"programming." +"Another fix would be to `tokio::task::spawn_blocking` which spawns an actual " +"thread and transforms its handle into a future without blocking the executor." msgstr "" -"ベアメタルプログラミングにおいて共通に発生する問題に対する解を与えるクレート" -"についていくつか紹介します。" +"もう 1 つの修正策は、`tokio::task::spawn_blocking` を使用することです。これ" +"は、実際のスレッドを生成し、エグゼキュータをブロックせずにそのハンドルを " +"Future に変換します。" -#: src/bare-metal/useful-crates/zerocopy.md +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"The [`zerocopy`](https://docs.rs/zerocopy/) crate (from Fuchsia) provides " -"traits and macros for safely converting between byte sequences and other " -"types." +"You should not think of tasks as OS threads. They do not map 1 to 1 and most " +"executors will allow many tasks to run on a single OS thread. This is " +"particularly problematic when interacting with other libraries via FFI, " +"where that library might depend on thread-local storage or map to specific " +"OS threads (e.g., CUDA). Prefer `tokio::task::spawn_blocking` in such " +"situations." msgstr "" -"（Fuchsiaの）[`zerocopy`](https://docs.rs/zerocopy/)クレートはバイトシーケン" -"スとその他の型の変換を安全に行うためのトレイトやマクロを提供します。" +"タスクは OS スレッドとはみなすべきではありません。これらは 1 対 1 に対応して" +"おらず、ほとんどのエグゼキュータは、単一の OS スレッドで多くのタスクを実行す" +"ることを許可します。これは、FFI を介して他のライブラリとやり取りする場合に特" +"に問題となります。FFI では、そのライブラリはスレッド ローカル ストレージに依" +"存しているか、特定の OS スレッド（CUDA など）にマッピングされている可能性があ" +"るためです。そのような場合は `tokio::task::spawn_blocking` を使用することをお" +"すすめします。" -#: src/bare-metal/useful-crates/zerocopy.md +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"This is not suitable for MMIO (as it doesn't use volatile reads and writes), " -"but can be useful for working with structures shared with hardware e.g. by " -"DMA, or sent over some external interface." +"Use sync mutexes with care. Holding a mutex over an `.await` may cause " +"another task to block, and that task may be running on the same thread." msgstr "" -"これは（volatile read、writeを使用していないため）MMIOには適してませんが、例" -"えばDMAのようなハードウェアと共有するデータ構造あるいは外部インタフェースを通" -"して送信するデータ構造を扱うに場合には有用です。" +"同期ミューテックスは慎重に使用してください。`.await` でミューテックスを保持す" +"ると、別のタスクがブロックされ、そのタスクが同じスレッドで実行される可能性が" +"あります。" -#: src/bare-metal/useful-crates/zerocopy.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"`FromBytes` can be implemented for types for which any byte pattern is " -"valid, and so can safely be converted from an untrusted sequence of bytes." +"Async blocks and functions return types implementing the `Future` trait. The " +"type returned is the result of a compiler transformation which turns local " +"variables into data stored inside the future." msgstr "" -"`FromBytes`はいかなるバイトパターンも有効な値となる型に対して実装することがで" -"き、信用できないバイトシーケンスからの安全な変換を可能にします。" +"非同期ブロックと関数は、`Future` トレイトを実装する型を返します。返される型" +"は、ローカル変数を Future の内部に格納されるデータに変換するコンパイラ変換の" +"結果です。" -#: src/bare-metal/useful-crates/zerocopy.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"Attempting to derive `FromBytes` for these types would fail, because " -"`RequestType` doesn't use all possible u32 values as discriminants, so not " -"all byte patterns are valid." +"Some of those variables can hold pointers to other local variables. Because " +"of that, the future should never be moved to a different memory location, as " +"it would invalidate those pointers." msgstr "" -"`RequestType`はu32型のすべての値を有効なenum値として定義していないので、すべ" -"てのバイトパターンが有効とはならず、これらに対する`FromBytes`の導出はフェール" -"するでしょう。" +"これらの変数の一部は、他のローカル変数へのポインタを保持できます。これらのポ" +"インタが無効になるため、Futureを別のメモリ位置に移動しないでください。" -#: src/bare-metal/useful-crates/zerocopy.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"`zerocopy::byteorder` has types for byte-order aware numeric primitives." +"To prevent moving the future type in memory, it can only be polled through a " +"pinned pointer. `Pin` is a wrapper around a reference that disallows all " +"operations that would move the instance it points to into a different memory " +"location." msgstr "" -"`zerocopy::byteorder`はバイトオーダを気にする数値プリミティブに関する型を提供" -"します。" +"メモリ内の Future 型が移動するのを防ぐには、固定されたポインタのみを介して" +"ポーリングするようにします。`Pin` は参照のラッパーで、参照先のインスタンスを" +"別のメモリ位置に移動するオペレーションをすべて禁止します。" -#: src/bare-metal/useful-crates/zerocopy.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"Run the example with `cargo run` under `src/bare-metal/useful-crates/" -"zerocopy-example/`. (It won't run in the Playground because of the crate " -"dependency.)" +"// A work item. In this case, just sleep for the given time and respond\n" +"// with a message on the `respond_on` channel.\n" msgstr "" -"この例を`src/bare-metal/useful-crates/zerocopy-example/`において`cargo run`と" -"とすることで実行してみましょう。（Playgroundではこの例が依存するクレートを利" -"用できないため実行できません）" +"// 作業アイテム。この場合、指定された時間だけスリープし、\n" +"// `respond_on` チャンネルでメッセージを返します。\n" -#: src/bare-metal/useful-crates/aarch64-paging.md -msgid "" -"The [`aarch64-paging`](https://crates.io/crates/aarch64-paging) crate lets " -"you create page tables according to the AArch64 Virtual Memory System " -"Architecture." -msgstr "" -"[`aarch64-paging`](https://crates.io/crates/aarch64-paging)クレートはAArch64" -"仮想メモリシステムアーキテクチャに則ったページテーブルの生成を可能にします。" +#: src/concurrency/async-pitfalls/pin.md +msgid "// A worker which listens for work on a queue and performs it.\n" +msgstr "// キュー上の処理をリッスンして実行するワーカー。\n" -#: src/bare-metal/useful-crates/aarch64-paging.md -msgid "// Create a new page table with identity mapping.\n" -msgstr "// 仮想物理同一となる新しいページテーブルを作成します。\n" +#: src/concurrency/async-pitfalls/pin.md +msgid "// Pretend to work.\n" +msgstr "// Pretend to work.\n" -#: src/bare-metal/useful-crates/aarch64-paging.md -msgid "// Map a 2 MiB region of memory as read-only.\n" -msgstr "// 2 MiB のメモリ領域を読み取り専用としてマッピングします。\n" +#: src/concurrency/async-pitfalls/pin.md +msgid "\"failed to send response\"" +msgstr "\"failed to send response\"" -#: src/bare-metal/useful-crates/aarch64-paging.md -msgid "// Set `TTBR0_EL1` to activate the page table.\n" -msgstr "// `TTBR0_EL1` を設定してページテーブルを有効にします。\n" +#: src/concurrency/async-pitfalls/pin.md +msgid "// TODO: report number of iterations every 100ms\n" +msgstr "// TODO: 100 ミリ秒ごとの反復処理の回数をレポート\n" -#: src/bare-metal/useful-crates/aarch64-paging.md -msgid "" -"For now it only supports EL1, but support for other exception levels should " -"be straightforward to add." -msgstr "" -"現時点ではEL1しかサポートされていませんが、他の例外レベルのサポートも簡単に追" -"加できるはずです。" +#: src/concurrency/async-pitfalls/pin.md +msgid "// A requester which requests work and waits for it to complete.\n" +msgstr "// 処理をリクエストし、処理が完了するまで待機するリクエスト元。\n" -#: src/bare-metal/useful-crates/aarch64-paging.md -msgid "" -"This is used in Android for the [Protected VM Firmware](https://cs.android." -"com/android/platform/superproject/+/master:packages/modules/Virtualization/" -"pvmfw/)." -msgstr "" -"これはAndroidで[Protected VM Firmware](https://cs.android.com/android/" -"platform/superproject/+/master:packages/modules/Virtualization/pvmfw/)のため" -"に利用されています。" +#: src/concurrency/async-pitfalls/pin.md +msgid "\"failed to send on work queue\"" +msgstr "\"failed to send on work queue\"" -#: src/bare-metal/useful-crates/aarch64-paging.md -msgid "" -"There's no easy way to run this example, as it needs to run on real hardware " -"or under QEMU." -msgstr "" -"この例は本物のハードウェアかQEMUを必要とするので、簡単には実行できません。" +#: src/concurrency/async-pitfalls/pin.md +msgid "\"failed waiting for response\"" +msgstr "\"failed waiting for response\"" -#: src/bare-metal/useful-crates/buddy_system_allocator.md +#: src/concurrency/async-pitfalls/pin.md +msgid "\"work result for iteration {i}: {resp}\"" +msgstr "\"work result for iteration {i}: {resp}\"" + +#: src/concurrency/async-pitfalls/pin.md msgid "" -"[`buddy_system_allocator`](https://crates.io/crates/buddy_system_allocator) " -"is a third-party crate implementing a basic buddy system allocator. It can " -"be used both for [`LockedHeap`](https://docs.rs/buddy_system_allocator/0.9.0/" -"buddy_system_allocator/struct.LockedHeap.html) implementing [`GlobalAlloc`]" -"(https://doc.rust-lang.org/core/alloc/trait.GlobalAlloc.html) so you can use " -"the standard `alloc` crate (as we saw [before](../alloc.md)), or for " -"allocating other address space. For example, we might want to allocate MMIO " -"space for PCI BARs:" +"You may recognize this as an example of the actor pattern. Actors typically " +"call `select!` in a loop." msgstr "" -"[`buddy_system_allocator`](https://crates.io/crates/buddy_system_allocator) " -"はサードパーティのクレートで、基本的なバディシステムアローケータを実装してい" -"ます。このクレートは[`GlobalAlloc`](https://doc.rust-lang.org/core/alloc/" -"trait.GlobalAlloc.html) を実装する [`LockedHeap`](https://docs.rs/" -"buddy_system_allocator/0.9.0/buddy_system_allocator/struct.LockedHeap.html) " -"により（ [以前](../alloc.md)見たように）標準の`alloc` クレートを利用可能にす" -"るために使えますし、別のアドレス空間をアロケートするためにも使えます。例え" -"ば、PCI BARに対するMMIO領域をアロケートしたい場合には以下のようにできます：" - -#: src/bare-metal/useful-crates/buddy_system_allocator.md -msgid "PCI BARs always have alignment equal to their size." -msgstr "PCI BARは常にサイズと同じアラインになります。" +"これはアクターのパターンの一例です。アクターは通常、ループ内で `select!` を呼" +"び出します。" -#: src/bare-metal/useful-crates/buddy_system_allocator.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"Run the example with `cargo run` under `src/bare-metal/useful-crates/" -"allocator-example/`. (It won't run in the Playground because of the crate " -"dependency.)" +"This serves as a summation of a few of the previous lessons, so take your " +"time with it." msgstr "" -"この例を`src/bare-metal/useful-crates/allocator-example/`において `cargo run`" -"とすることで実行してみましょう。（Playgroundではこの例が依存するクレートを利" -"用できないため実行できません）" +"これはこれまでのレッスンの一部をまとめたものですので、時間をかけて復習してく" +"ださい。" -#: src/bare-metal/useful-crates/tinyvec.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"Sometimes you want something which can be resized like a `Vec`, but without " -"heap allocation. [`tinyvec`](https://crates.io/crates/tinyvec) provides " -"this: a vector backed by an array or slice, which could be statically " -"allocated or on the stack, which keeps track of how many elements are used " -"and panics if you try to use more than are allocated." +"Naively add a `_ = sleep(Duration::from_millis(100)) => { println!(..) }` to " +"the `select!`. This will never execute. Why?" msgstr "" -"時には`Vec`のようにリサイズできる領域をヒープを使わずに確保したいと思うことが" -"あります。[`tinyvec`](https://crates.io/crates/tinyvec)は静的に確保、またはス" -"タック上に確保した配列またはスライスを割当領域とするベクタを提供します。この" -"実装では、いくつの要素が使われているかが管理され、確保された以上に使おうとす" -"るとパニックします。" +"`_ = sleep(Duration::from_millis(100)) => { println!(..) }` を `select!` に追" +"加しただけでは、実行されません。なぜでしょうか？" -#: src/bare-metal/useful-crates/tinyvec.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"`tinyvec` requires that the element type implement `Default` for " -"initialisation." +"Instead, add a `timeout_fut` containing that future outside of the `loop`:" msgstr "" -"`tinyvec` は初期化のために要素となるタイプが`Default`を実装することを必要とし" -"ます。" +"代わりに、`loop` の外側で、その Future を含む `timeout_fut` を追加します。" -#: src/bare-metal/useful-crates/tinyvec.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"The Rust Playground includes `tinyvec`, so this example will run fine inline." +"This still doesn't work. Follow the compiler errors, adding `&mut` to the " +"`timeout_fut` in the `select!` to work around the move, then using `Box::" +"pin`:" msgstr "" -"Rust Playgroundは`tinyvec`を内包しているので、オンラインでこの例を実行するこ" -"とができます。" +"これでもうまくいきません。コンパイルエラーにあるように、`select!` 内の " +"`timeout_fut` に `&mut` を追加して移動を回避してから、`Box::pin` を使用しま" +"す。" -#: src/bare-metal/useful-crates/spin.md +#: src/concurrency/async-pitfalls/pin.md +#, fuzzy msgid "" -"`std::sync::Mutex` and the other synchronisation primitives from `std::sync` " -"are not available in `core` or `alloc`. How can we manage synchronisation or " -"interior mutability, such as for sharing state between different CPUs?" +"This compiles, but once the timeout expires it is `Poll::Ready` on every " +"iteration (a fused future would help with this). Update to reset " +"`timeout_fut` every time it expires:" msgstr "" -"`std::sync`が提供する`std::sync::Mutex` とその他の同期プリミティブは`core`ま" -"たは`alloc`では利用できません。となると、例えば異なるCPU間での状態共有のため" -"の、同期や内部可変性はどのように実現したら良いのでしょうか？" +"これはコンパイルされますが、タイムアウトになると、すべての反復処理で `Poll::" +"Ready` になります（融合された Future がこれに役立ちます）。期限が切れるたび" +"に `timeout_fut` をリセットするように更新します。" -#: src/bare-metal/useful-crates/spin.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"The [`spin`](https://crates.io/crates/spin) crate provides spinlock-based " -"equivalents of many of these primitives." +"Box allocates on the heap. In some cases, `std::pin::pin!` (only recently " +"stabilized, with older code often using `tokio::pin!`) is also an option, " +"but that is difficult to use for a future that is reassigned." msgstr "" -"[`spin`](https://crates.io/crates/spin) クレートはこれらの多くのプリミティブ" -"と等価なスピンロックベースのものを提供します。" +"Box でヒープに割り当てます。場合によっては `std::pin::pin!`（最近安定化された" +"ばかりで、古いコードでは多くの場合に `tokio::pin!` を使用します）も使用できま" +"すが、再割り当てされる Future に使用することは困難です。" -#: src/bare-metal/useful-crates/spin.md -msgid "Be careful to avoid deadlock if you take locks in interrupt handlers." +#: src/concurrency/async-pitfalls/pin.md +msgid "" +"Another alternative is to not use `pin` at all but spawn another task that " +"will send to a `oneshot` channel every 100ms." msgstr "" -"割り込みハンドラでロックを取得する場合にはデッドロックを引き起こさないように" -"気をつけてください。" +"別の方法としては、`pin` をまったく使用せずに、100 ミリ秒ごとに `oneshot` チャ" +"ネルに送信する別のタスクを生成するという方法もあります。" -#: src/bare-metal/useful-crates/spin.md -#, fuzzy +#: src/concurrency/async-pitfalls/pin.md msgid "" -"`spin` also has a ticket lock mutex implementation; equivalents of `RwLock`, " -"`Barrier` and `Once` from `std::sync`; and `Lazy` for lazy initialisation." +"Data that contains pointers to itself is called self-referential. Normally, " +"the Rust borrow checker would prevent self-referential data from being " +"moved, as the references cannot outlive the data they point to. However, the " +"code transformation for async blocks and functions is not verified by the " +"borrow checker." msgstr "" -"`spin` はチケットロックのミューテックス実装も持っています。これは`std::sync`" -"における`RwLock`, `Barrier`、`Once` と等価であり、またレイジー初期化の観点で" -"は`Lazy`と等価なものです。" +"それ自体へのポインタを含むデータは、自己参照と呼ばれます。通常、Rust 借用" +"チェッカーは、参照が参照先のデータより長く存続できないため、自己参照データの" +"移動を防ぎます。ただし、非同期ブロックと関数のコード変換は、借用チェッカーに" +"よって検証されません。" -#: src/bare-metal/useful-crates/spin.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"The [`once_cell`](https://crates.io/crates/once_cell) crate also has some " -"useful types for late initialisation with a slightly different approach to " -"`spin::once::Once`." +"`Pin` is a wrapper around a reference. An object cannot be moved from its " +"place using a pinned pointer. However, it can still be moved through an " +"unpinned pointer." msgstr "" -"[`once_cell`](https://crates.io/crates/once_cell) クレートも`spin::once::" -"Once`とは少し異なるアプローチの遅延初期化のための有用な型をいくつか持っていま" -"す。" +"`Pin` は参照のラッパーです。固定されたポインタを使用して、オブジェクトをその" +"場所から移動することはできません。ただし、固定されていないポインタを介して移" +"動することは可能です。" -#: src/bare-metal/useful-crates/spin.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"The Rust Playground includes `spin`, so this example will run fine inline." +"The `poll` method of the `Future` trait uses `Pin<&mut Self>` instead of " +"`&mut Self` to refer to the instance. That's why it can only be called on a " +"pinned pointer." msgstr "" -"Rust Playgroundは`spin`を内包しているので、この例はオンラインで実行できます。" +"`Future` トレイトの `poll` メソッドは、`&mut Self` ではなく `Pin<&mut Self>` " +"を使用してインスタンスを参照します。固定されたポインタでのみ呼び出すことがで" +"きるのはこのためです。" -#: src/bare-metal/android.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "" -"To build a bare-metal Rust binary in AOSP, you need to use a " -"`rust_ffi_static` Soong rule to build your Rust code, then a `cc_binary` " -"with a linker script to produce the binary itself, and then a `raw_binary` " -"to convert the ELF to a raw binary ready to be run." +"Async methods in traits are were stabilized only recently, in the 1.75 " +"release. This required support for using return-position `impl Trait` (RPIT) " +"in traits, as the desugaring for `async fn` includes `-> impl Future`." msgstr "" -"AOSPにおいてベアメタルRustバイナリをビルドするためには、Rustコードをビルドす" -"るための`rust_ffi_static`というSoongルール、リンカスクリプトとそれを使ってバ" -"イナリを生成するための`cc_binary`というルール、さらにELFを実行可能な形式の生" -"バイナリに変換する`raw_binary`というルールが必要です。" -#: src/bare-metal/android/vmbase.md -msgid "vmbase" -msgstr "vmbase" +#: src/concurrency/async-pitfalls/async-traits.md +msgid "" +"However, even with the native support today there are some pitfalls around " +"`async fn` and RPIT in traits:" +msgstr "" -#: src/bare-metal/android/vmbase.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "" -"For VMs running under crosvm on aarch64, the [vmbase](https://android." -"googlesource.com/platform/packages/modules/Virtualization/+/refs/heads/" -"master/vmbase/) library provides a linker script and useful defaults for the " -"build rules, along with an entry point, UART console logging and more." +"Return-position impl Trait captures all in-scope lifetimes (so some patterns " +"of borrowing cannot be expressed)" msgstr "" -"[vmbase](https://android.googlesource.com/platform/packages/modules/" -"Virtualization/+/refs/heads/master/vmbase/)というライブラリは、aarch64上の" -"crosvm下で実行されるVMに対して、エントリポイント、UARTコンソールロギングなど" -"に加えて、リンカスクリプトと有用なデフォルトビルドルールを提供してくれます。" -#: src/bare-metal/android/vmbase.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "" -"The `main!` macro marks your main function, to be called from the `vmbase` " -"entry point." +"Traits whose methods use return-position `impl trait` or `async` are not " +"`dyn` compatible." msgstr "" -"`main!`というマクロはメイン関数を指定するもので、指定された関数は`vmbase`のエ" -"ントリポイントから呼び出されることになります。" -#: src/bare-metal/android/vmbase.md +#: src/concurrency/async-pitfalls/async-traits.md +#, fuzzy msgid "" -"The `vmbase` entry point handles console initialisation, and issues a " -"PSCI_SYSTEM_OFF to shutdown the VM if your main function returns." +"If we do need `dyn` support, the crate [async_trait](https://docs.rs/async-" +"trait/latest/async_trait/) provides a workaround through a macro, with some " +"caveats:" msgstr "" -"`vmbase`のエントリポイントはコンソールの初期化を行い、メイン関数がリターンし" -"た場合にはPSCI_SYSTEM_OFF を発行しVMをシャットダウンします。" +"クレート [async_trait](https://docs.rs/async-trait/latest/async_trait/) は、" +"マクロによる回避策を提供します。" -#: src/exercises/bare-metal/afternoon.md -msgid "We will write a driver for the PL031 real-time clock device." -msgstr "PL031 リアルタイム クロック デバイス用のドライバを作成します。" +#: src/concurrency/async-pitfalls/async-traits.md +msgid "\"running all sleepers..\"" +msgstr "\"running all sleepers..\"" + +#: src/concurrency/async-pitfalls/async-traits.md +msgid "\"slept for {}ms\"" +msgstr "\"slept for {}ms\"" -#: src/exercises/bare-metal/afternoon.md src/exercises/concurrency/afternoon.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "" -"After looking at the exercises, you can look at the [solutions](solutions-" -"afternoon.md) provided." +"`async_trait` is easy to use, but note that it's using heap allocations to " +"achieve this. This heap allocation has performance overhead." msgstr "" -"演習の終了後は、提供されている [ソリューション](solutions-afternoon.md) を確" -"認してください。" - -#: src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "RTC driver" -msgstr "RTC ドライバ" +"`async_trait` は簡単に使用できますが、ヒープ割り当てを使用してこれを実現して" +"います。このヒープ割り当てには、パフォーマンス オーバーヘッドが伴います。" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "" -"The QEMU aarch64 virt machine has a [PL031](https://developer.arm.com/" -"documentation/ddi0224/c) real-time clock at 0x9010000. For this exercise, " -"you should write a driver for it." +"The challenges in language support for `async trait` are deep Rust and " +"probably not worth describing in-depth. Niko Matsakis did a good job of " +"explaining them in [this post](https://smallcultfollowing.com/babysteps/" +"blog/2019/10/26/async-fn-in-traits-are-hard/) if you are interested in " +"digging deeper." msgstr "" -"QEMU aarch64 virt マシンの 0x9010000 には、[PL031](https://developer.arm.com/" -"documentation/ddi0224/c) リアルタイム クロックが搭載されています。この演習で" -"は、そのドライバを作成する必要があります。" +"`async trait` の言語サポートにおける課題は、Rust の中でも難解な部類に入るた" +"め、ここでは詳しく説明する必要はないでしょう。Niko Matsakis が [こちらの投稿]" +"(https://smallcultfollowing.com/babysteps/blog/2019/10/26/async-fn-in-traits-" +"are-hard/) で詳しく説明していますので、深く掘り下げたい方はご覧ください。" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "" -"Use it to print the current time to the serial console. You can use the " -"[`chrono`](https://crates.io/crates/chrono) crate for date/time formatting." +"Try creating a new sleeper struct that will sleep for a random amount of " +"time and adding it to the Vec." msgstr "" -"これを使用して現在の時刻をシリアル コンソールに出力します。日時の形式には " -"[`chrono`](https://crates.io/crates/chrono) クレートを使用できます。" +"ランダムな時間スリープする新しいスリーパー構造体を作成し、Vec に追加してみま" +"しょう。" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-pitfalls/cancellation.md msgid "" -"Use the match register and raw interrupt status to busy-wait until a given " -"time, e.g. 3 seconds in the future. (Call [`core::hint::spin_loop`](https://" -"doc.rust-lang.org/core/hint/fn.spin_loop.html) inside the loop.)" +"Dropping a future implies it can never be polled again. This is called " +"_cancellation_ and it can occur at any `await` point. Care is needed to " +"ensure the system works correctly even when futures are cancelled. For " +"example, it shouldn't deadlock or lose data." msgstr "" -"一致レジスタと未加工の割り込みステータスを使用して、指定時刻（たとえば 3 秒" -"後）までビジーウェイトします（ループ内で [`core::hint::spin_loop`](https://" -"doc.rust-lang.org/core/hint/fn.spin_loop.html) を呼び出します）。" +"Future をドロップすると、その Future を再度ポーリングすることはできません。こ" +"れはキャンセルと呼ばれ、どの `await` ポイントでも発生する可能性があります。そ" +"のため、Future がキャンセルされた場合でも、システムが正常に動作するようにして" +"おく必要があります。たとえば、デッドロックやデータの消失があってはなりませ" +"ん。" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-pitfalls/cancellation.md +msgid "\"not UTF-8\"" +msgstr "\"not UTF-8\"" + +#: src/concurrency/async-pitfalls/cancellation.md +msgid "\"hi\\nthere\\n\"" +msgstr "\"hi\\nthere\\n\"" + +#: src/concurrency/async-pitfalls/cancellation.md +msgid "\"tick!\"" +msgstr "\"tick!\"" + +#: src/concurrency/async-pitfalls/cancellation.md msgid "" -"_Extension if you have time:_ Enable and handle the interrupt generated by " -"the RTC match. You can use the driver provided in the [`arm-gic`](https://" -"docs.rs/arm-gic/) crate to configure the Arm Generic Interrupt Controller." +"The compiler doesn't help with cancellation-safety. You need to read API " +"documentation and consider what state your `async fn` holds." msgstr "" -"時間がある場合は、RTC の一致によって生成された割り込みを有効にして処理しま" -"す。[`arm-gic`](https://docs.rs/arm-gic/) クレートで提供されているドライバを" -"使用して、Arm 汎用割り込みコントローラを設定して構いません。" +"コンパイラではキャンセル安全性を確保できません。API ドキュメントを読み、" +"`async fn` が保持する状態を考慮する必要があります。" -#: src/exercises/bare-metal/rtc.md -msgid "Use the RTC interrupt, which is wired to the GIC as `IntId::spi(2)`." +#: src/concurrency/async-pitfalls/cancellation.md +msgid "" +"Unlike `panic` and `?`, cancellation is part of normal control flow (vs " +"error-handling)." msgstr "" -"RTC 割り込みを使用します。この割り込みは GIC に `IntId::spi(2)` として接続さ" -"れています。" +"`panic` や `?`とは異なり、キャンセルは（エラー処理ではなく）通常の制御フロー" +"の一部です。" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-pitfalls/cancellation.md +msgid "The example loses parts of the string." +msgstr "この例では、文字列の一部が失われています。" + +#: src/concurrency/async-pitfalls/cancellation.md msgid "" -"Once the interrupt is enabled, you can put the core to sleep via `arm_gic::" -"wfi()`, which will cause the core to sleep until it receives an interrupt." +"Whenever the `tick()` branch finishes first, `next()` and its `buf` are " +"dropped." msgstr "" -"割り込みを有効にすると、`arm_gic::wfi()` を使用してコアをスリープさせることが" -"できます。これにより、コアは割り込みを受けるまでスリープ状態になります。" +"`tick()` 分岐が先に終了するたびに、`next()` とその `buf` がドロップされます。" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-pitfalls/cancellation.md msgid "" -"Download the [exercise template](../../comprehensive-rust-exercises.zip) and " -"look in the `rtc` directory for the following files." +"`LinesReader` can be made cancellation-safe by making `buf` part of the " +"struct:" msgstr "" -"[演習テンプレート](../../comprehensive-rust-exercises.zip) をダウンロードし、" -"`rtc` ディレクトリで以下のファイルを探します。" +"`buf` を構造体の一部にすることで、`LinesReader` にキャンセル安全性を持たせる" +"ことができます。" -#: src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Base addresses of the GICv3.\n" -msgstr "/// GICv3 のベースアドレス。\n" +#: src/concurrency/async-pitfalls/cancellation.md +msgid "// prefix buf and bytes with self.\n" +msgstr "// buf と bytes の先頭に self を付加します。\n" -#: src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "\"main({:#x}, {:#x}, {:#x}, {:#x})\"" -msgstr "\"main({:#x}, {:#x}, {:#x}, {:#x})\"" +#: src/concurrency/async-pitfalls/cancellation.md +msgid "" +"[`Interval::tick`](https://docs.rs/tokio/latest/tokio/time/struct.Interval." +"html#method.tick) is cancellation-safe because it keeps track of whether a " +"tick has been 'delivered'." +msgstr "" +"[`Interval::tick`](https://docs.rs/tokio/latest/tokio/time/struct.Interval." +"html#method.tick) は、ティックが「配信済み」かどうかを追跡しているため、安全" +"にキャンセルできます。" -#: src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/concurrency/async-pitfalls/cancellation.md msgid "" -"// Safe because `GICD_BASE_ADDRESS` and `GICR_BASE_ADDRESS` are the base\n" -" // addresses of a GICv3 distributor and redistributor respectively, and\n" -" // nothing else accesses those address ranges.\n" +"[`AsyncReadExt::read`](https://docs.rs/tokio/latest/tokio/io/trait." +"AsyncReadExt.html#method.read) is cancellation-safe because it either " +"returns or doesn't read data." msgstr "" -"// `GICD_BASE_ADDRESS` と `GICR_BASE_ADDRESS` がそれぞれ GICv3 の\n" -" // ディストリビューターと再ディストリビューターのベースアドレスであり、\n" -" // 他にはこれらのアドレス範囲にアクセスするものがないため、安全です。\n" +"[`AsyncReadExt::read`](https://docs.rs/tokio/latest/tokio/io/trait." +"AsyncReadExt.html#method.read) は、データを返すか、データを読み取らないかのい" +"ずれかであるため、安全にキャンセルできます。" -#: src/exercises/bare-metal/rtc.md -msgid "// TODO: Create instance of RTC driver and print current time.\n" +#: src/concurrency/async-pitfalls/cancellation.md +msgid "" +"[`AsyncBufReadExt::read_line`](https://docs.rs/tokio/latest/tokio/io/trait." +"AsyncBufReadExt.html#method.read_line) is similar to the example and _isn't_ " +"cancellation-safe. See its documentation for details and alternatives." msgstr "" -"// TODO: RTC ドライバのインスタンスを作成し、現在の時刻を出力します。\n" +"[`AsyncBufReadExt::read_line`](https://docs.rs/tokio/latest/tokio/io/trait." +"AsyncBufReadExt.html#method.read_line) はこの例と類似しており、安全にキャンセ" +"ルできません。詳細と代替方法については、ドキュメントをご覧ください。" -#: src/exercises/bare-metal/rtc.md -msgid "// TODO: Wait for 3 seconds.\n" -msgstr "// TODO: 3 秒間待機します。\n" +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +#, fuzzy +msgid "Dining Philosophers --- Async" +msgstr "食事する哲学者" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-exercises/dining-philosophers.md +#, fuzzy msgid "" -"_src/exceptions.rs_ (you should only need to change this for the 3rd part of " -"the exercise):" +"See [dining philosophers](../sync-exercises/dining-philosophers.md) for a " +"description of the problem." msgstr "" -"_src/exceptions.rs_（この演習の 3 番目のパートでのみ変更する必要があります）:" +"この問題の詳細については、[食事する哲学者](dining-philosophers.md) をご覧くだ" +"さい。" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-exercises/dining-philosophers.md msgid "" -"// Copyright 2023 Google LLC\n" -"//\n" -"// Licensed under the Apache License, Version 2.0 (the \"License\");\n" -"// you may not use this file except in compliance with the License.\n" -"// You may obtain a copy of the License at\n" -"//\n" -"// http://www.apache.org/licenses/LICENSE-2.0\n" -"//\n" -"// Unless required by applicable law or agreed to in writing, software\n" -"// distributed under the License is distributed on an \"AS IS\" BASIS,\n" -"// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n" -"// See the License for the specific language governing permissions and\n" -"// limitations under the License.\n" -msgstr "" -"// Copyright 2023 Google LLC\n" -"//\n" -"// バージョン 2.0 の Apache ライセンス（以下「本ライセンス」）により使用が許" -"諾されています。\n" -"// このファイルを使用するには、本ライセンスに準拠する必要があります。\n" -" // 本ライセンスのコピーは下記のリンクから入手できます。\n" -"//\n" -"// http://www.apache.org/licenses/LICENSE-2.0\n" -"//\n" -"// 本ライセンスで配布されるソフトウェアは、\n" -"// 適用される法律によって要求される場合または書面で合意した場合を除き、\n" -"// 明示されるか黙示されるかを問わず、いかなる種類の保証も条件もなく、「現状有" -"姿」で提供されます。\n" -"// 本ライセンスの下で適用される具体的な許可および制限については、\n" -"// ライセンス本文をご覧ください。\n" - -#: src/exercises/bare-metal/rtc.md -msgid "\"sync_exception_current\"" -msgstr "\"sync_exception_current\"" - -#: src/exercises/bare-metal/rtc.md -msgid "\"irq_current\"" -msgstr "\"irq_current\"" - -#: src/exercises/bare-metal/rtc.md -msgid "\"No pending interrupt\"" -msgstr "\"No pending interrupt\"" +"As before, you will need a local [Cargo installation](../../cargo/running-" +"locally.md) for this exercise. Copy the code below to a file called `src/" +"main.rs`, fill out the blanks, and test that `cargo run` does not deadlock:" +msgstr "" +"前と同様に、この演習でもローカルの [Cargo インストール](../../cargo/running-" +"locally.md) が必要です。以下のコードを `src/main.rs` というファイルにコピー" +"し、空欄を埋めて、`cargo run` がデッドロックしないことを確認します。" -#: src/exercises/bare-metal/rtc.md -msgid "\"IRQ {intid:?}\"" -msgstr "\"IRQ {intid:?}\"" +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "// Keep trying until we have both forks\n" +msgstr "" -#: src/exercises/bare-metal/rtc.md -msgid "\"fiq_current\"" -msgstr "\"fiq_current\"" +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "// Make them think and eat\n" +msgstr "// 哲学者が思索と食事を行うようにする\n" -#: src/exercises/bare-metal/rtc.md -msgid "\"serr_current\"" -msgstr "\"serr_current\"" +#: src/concurrency/async-exercises/dining-philosophers.md +msgid "" +"Since this time you are using Async Rust, you'll need a `tokio` dependency. " +"You can use the following `Cargo.toml`:" +msgstr "" +"今回は非同期 Rust を使用するため、`tokio` 依存関係が必要になります。次の " +"`Cargo.toml` を使用できます。" -#: src/exercises/bare-metal/rtc.md -msgid "\"sync_lower\"" -msgstr "\"sync_lower\"" +#: src/concurrency/async-exercises/dining-philosophers.md +msgid "" +"```toml\n" +"[package]\n" +"name = \"dining-philosophers-async-dine\"\n" +"version = \"0.1.0\"\n" +"edition = \"2021\"\n" +"\n" +"[dependencies]\n" +"tokio = { version = \"1.26.0\", features = [\"sync\", \"time\", \"macros\", " +"\"rt-multi-thread\"] }\n" +"```" +msgstr "" +"```toml\n" +"[package]\n" +"name = \"dining-philosophers-async-dine\"\n" +"version = \"0.1.0\"\n" +"edition = \"2021\"\n" +"\n" +"[dependencies]\n" +"tokio = { version = \"1.26.0\", features = [\"sync\", \"time\", \"macros\", " +"\"rt-multi-thread\"] }\n" +"```" -#: src/exercises/bare-metal/rtc.md -msgid "\"irq_lower\"" -msgstr "\"irq_lower\"" +#: src/concurrency/async-exercises/dining-philosophers.md +msgid "" +"Also note that this time you have to use the `Mutex` and the `mpsc` module " +"from the `tokio` crate." +msgstr "" +"また、今度は `tokio` クレートの `Mutex` モジュールと `mpsc` モジュールを使用" +"する必要があることにも注意してください。" -#: src/exercises/bare-metal/rtc.md -msgid "\"fiq_lower\"" -msgstr "\"fiq_lower\"" +#: src/concurrency/async-exercises/dining-philosophers.md +msgid "Can you make your implementation single-threaded?" +msgstr "実装をシングルスレッドにできますか？" -#: src/exercises/bare-metal/rtc.md -msgid "\"serr_lower\"" -msgstr "\"serr_lower\"" +#: src/concurrency/async-exercises/chat-app.md +msgid "" +"In this exercise, we want to use our new knowledge to implement a broadcast " +"chat application. We have a chat server that the clients connect to and " +"publish their messages. The client reads user messages from the standard " +"input, and sends them to the server. The chat server broadcasts each message " +"that it receives to all the clients." +msgstr "" +"この演習では、新たに身に付けた知識を活かしてブロードキャスト チャット アプリ" +"を実装します。クライアントが接続してメッセージを公開するチャット サーバーがあ" +"ります。クライアントは標準入力からユーザー メッセージを読み取り、サーバーに送" +"信します。チャット サーバーは受信した各メッセージをすべてのクライアントにブ" +"ロードキャストします。" -#: src/exercises/bare-metal/rtc.md -msgid "_src/logger.rs_ (you shouldn't need to change this):" -msgstr "_src/logger.rs_（変更する必要はありません）:" +#: src/concurrency/async-exercises/chat-app.md +msgid "" +"For this, we use [a broadcast channel](https://docs.rs/tokio/latest/tokio/" +"sync/broadcast/fn.channel.html) on the server, and [`tokio_websockets`]" +"(https://docs.rs/tokio-websockets/) for the communication between the client " +"and the server." +msgstr "" +"このために、サーバー上の [ブロードキャスト チャンネル](https://docs.rs/tokio/" +"latest/tokio/sync/broadcast/fn.channel.html) を使用し、クライアントとサーバー" +"間の通信には [`tokio_websockets`](https://docs.rs/tokio-websockets/) を使用し" +"ます。" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR: main\n" -msgstr "// ANCHOR: main\n" +#: src/concurrency/async-exercises/chat-app.md +msgid "Create a new Cargo project and add the following dependencies:" +msgstr "新しい Cargo プロジェクトを作成し、次の依存関係を追加します。" -#: src/exercises/bare-metal/rtc.md -msgid "_src/pl011.rs_ (you shouldn't need to change this):" -msgstr "_src/pl011.rs_（変更する必要はありません）:" +#: src/concurrency/async-exercises/chat-app.md +msgid "_Cargo.toml_:" +msgstr "_Cargo.toml_:" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR: Flags\n" -msgstr "// ANCHOR: Flags\n" +#: src/concurrency/async-exercises/chat-app.md +#, fuzzy +msgid "" +"```toml\n" +"[package]\n" +"name = \"chat-async\"\n" +"version = \"0.1.0\"\n" +"edition = \"2021\"\n" +"\n" +"[dependencies]\n" +"futures-util = { version = \"0.3.30\", features = [\"sink\"] }\n" +"http = \"1.1.0\"\n" +"tokio = { version = \"1.40.0\", features = [\"full\"] }\n" +"tokio-websockets = { version = \"0.9.0\", features = [\"client\", " +"\"fastrand\", \"server\", \"sha1_smol\"] }\n" +"```" +msgstr "" +"```toml\n" +"[package]\n" +"name = \"chat-async\"\n" +"version = \"0.1.0\"\n" +"edition = \"2021\"\n" +"\n" +"[dependencies]\n" +"futures-util = { version = \"0.3.30\", features = [\"sink\"] }\n" +"http = \"1.0.0\"\n" +"tokio = { version = \"1.28.1\", features = [\"full\"] }\n" +"tokio-websockets = { version = \"0.5.1\", features = [\"client\", " +"\"fastrand\", \"server\", \"sha1_smol\"] }\n" +"```" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR_END: Flags\n" -msgstr "// ANCHOR_END: Flags\n" +#: src/concurrency/async-exercises/chat-app.md +msgid "The required APIs" +msgstr "必要な API" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-exercises/chat-app.md msgid "" -"/// Flags from the UART Receive Status Register / Error Clear Register.\n" +"You are going to need the following functions from `tokio` and " +"[`tokio_websockets`](https://docs.rs/tokio-websockets/). Spend a few minutes " +"to familiarize yourself with the API." msgstr "" -"/// UART 受信ステータス レジスタ / エラー クリア レジスタからのフラグ\n" - -#: src/exercises/bare-metal/rtc.md -msgid "/// Framing error.\n" -msgstr "/// フレーム処理エラー。\n" +"`tokio` と [`tokio_websockets`](https://docs.rs/tokio-websockets/) の以下の関" +"数が必要になります。少し時間をかけて API に対する理解を深めてください。" -#: src/exercises/bare-metal/rtc.md -msgid "/// Parity error.\n" -msgstr "/// パリティエラー。\n" +#: src/concurrency/async-exercises/chat-app.md +msgid "" +"[StreamExt::next()](https://docs.rs/futures-util/0.3.28/futures_util/stream/" +"trait.StreamExt.html#method.next) implemented by `WebSocketStream`: for " +"asynchronously reading messages from a Websocket Stream." +msgstr "" +"`WebSocketStream` によって実装された [StreamExt::next()](https://docs.rs/" +"futures-util/0.3.28/futures_util/stream/trait.StreamExt.html#method.next): " +"Websocket Stream からのメッセージを非同期で読み取ります。" -#: src/exercises/bare-metal/rtc.md -msgid "/// Break error.\n" -msgstr "/// ブレイクエラー。\n" +#: src/concurrency/async-exercises/chat-app.md +msgid "" +"[SinkExt::send()](https://docs.rs/futures-util/0.3.28/futures_util/sink/" +"trait.SinkExt.html#method.send) implemented by `WebSocketStream`: for " +"asynchronously sending messages on a Websocket Stream." +msgstr "" +"`WebSocketStream` によって実装された [SinkExt::send()](https://docs.rs/" +"futures-util/0.3.28/futures_util/sink/trait.SinkExt.html#method.send): " +"Websocket Stream 上でメッセージを非同期で送信します。" -#: src/exercises/bare-metal/rtc.md -msgid "/// Overrun error.\n" -msgstr "/// オーバーラン エラー。\n" +#: src/concurrency/async-exercises/chat-app.md +msgid "" +"[Lines::next_line()](https://docs.rs/tokio/latest/tokio/io/struct.Lines." +"html#method.next_line): for asynchronously reading user messages from the " +"standard input." +msgstr "" +"[Lines::next_line()](https://docs.rs/tokio/latest/tokio/io/struct.Lines." +"html#method.next_line): 標準入力からのユーザー メッセージを非同期で読み取りま" +"す。" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR: Registers\n" -msgstr "// ANCHOR: Registers\n" +#: src/concurrency/async-exercises/chat-app.md +msgid "" +"[Sender::subscribe()](https://docs.rs/tokio/latest/tokio/sync/broadcast/" +"struct.Sender.html#method.subscribe): for subscribing to a broadcast channel." +msgstr "" +"[Sender::subscribe()](https://docs.rs/tokio/latest/tokio/sync/broadcast/" +"struct.Sender.html#method.subscribe): ブロードキャスト チャンネルをサブスクラ" +"イブします。" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR_END: Registers\n" -msgstr "// ANCHOR_END: Registers\n" +#: src/concurrency/async-exercises/chat-app.md +msgid "Two binaries" +msgstr "2 つのバイナリ" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-exercises/chat-app.md msgid "" -"// ANCHOR: Uart\n" -"/// Driver for a PL011 UART.\n" +"Normally in a Cargo project, you can have only one binary, and one `src/main." +"rs` file. In this project, we need two binaries. One for the client, and one " +"for the server. You could potentially make them two separate Cargo projects, " +"but we are going to put them in a single Cargo project with two binaries. " +"For this to work, the client and the server code should go under `src/bin` " +"(see the [documentation](https://doc.rust-lang.org/cargo/reference/cargo-" +"targets.html#binaries))." msgstr "" -"// ANCHOR: Uart\n" -"/// PL011 UART のドライバ。\n" +"通常、Cargo プロジェクトに含めることができるのは 1 つのバイナリと 1 つの " +"`src/main.rs` ファイルのみです。このプロジェクトには 2 つのバイナリが必要で" +"す。1 つはクライアント用、もう 1 つはサーバー用です。2 つの独立した Cargo プ" +"ロジェクトを作成することもできますが、ここでは 1 つの Cargo プロジェクトに 2 " +"つのバイナリを入れます。そのためには、クライアントとサーバーのコードを `src/" +"bin` に配置する必要があります（[ドキュメント](https://doc.rust-lang.org/" +"cargo/reference/cargo-targets.html#binaries) をご覧ください）。" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-exercises/chat-app.md msgid "" -"/// Constructs a new instance of the UART driver for a PL011 device at the\n" -" /// given base address.\n" -" ///\n" -" /// # Safety\n" -" ///\n" -" /// The given base address must point to the MMIO control registers of " -"a\n" -" /// PL011 device, which must be mapped into the address space of the " -"process\n" -" /// as device memory and not have any other aliases.\n" +"Copy the following server and client code into `src/bin/server.rs` and `src/" +"bin/client.rs`, respectively. Your task is to complete these files as " +"described below." msgstr "" -"/// 指定されたベースアドレスに存在する\n" -" /// PL011 デバイス用の UART ドライバの新しいインスタンスを作成します。\n" -" ///\n" -" /// # 安全性\n" -" ///\n" -" /// 指定されたベースアドレスは PL011 デバイスの MMIO 制御レジスタを指して" -"いる必要があります。\n" -" /// これらはデバイスメモリとしてプロセスのアドレス空間に\n" -" /// マッピングされ、他のエイリアスはありません。\n" +"次のサーバーとクライアントのコードを、それぞれ`src/bin/server.rs` と `src/" +"bin/client.rs` にコピーします。ここでのタスクは、以下で説明するように、これら" +"のファイルを完成させることです。" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR_END: Uart\n" -msgstr "// ANCHOR_END: Uart\n" +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md +msgid "_src/bin/server.rs_:" +msgstr "_src/bin/server.rs_:" -#: src/exercises/bare-metal/rtc.md -msgid "_build.rs_ (you shouldn't need to change this):" -msgstr "_build.rs_（変更する必要はありません）:" +#: src/concurrency/async-exercises/chat-app.md +msgid "// TODO: For a hint, see the description of the task below.\n" +msgstr "// TODO: ヒントについては、以下のタスクの説明をご覧ください。\n" + +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"127.0.0.1:2000\"" +msgstr "\"127.0.0.1:2000\"" + +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"listening on port 2000\"" +msgstr "\"listening on port 2000\"" -#: src/exercises/bare-metal/rtc.md -msgid "\"linux\"" -msgstr "\"linux\"" +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"New connection from {addr:?}\"" +msgstr "\"New connection from {addr:?}\"" -#: src/exercises/bare-metal/rtc.md -msgid "\"CROSS_COMPILE\"" -msgstr "\"CROSS_COMPILE\"" +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md +msgid "// Wrap the raw TCP stream into a websocket.\n" +msgstr "// 未加工の TCP ストリームを WebSocket にラップします。\n" -#: src/exercises/bare-metal/rtc.md -msgid "\"aarch64-linux-gnu\"" -msgstr "\"aarch64-linux-gnu\"" +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md +msgid "_src/bin/client.rs_:" +msgstr "_src/bin/client.rs_:" -#: src/exercises/bare-metal/rtc.md -msgid "\"aarch64-none-elf\"" -msgstr "\"aarch64-none-elf\"" +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"ws://127.0.0.1:2000\"" +msgstr "\"ws://127.0.0.1:2000\"" -#: src/exercises/bare-metal/rtc.md -msgid "\"entry.S\"" -msgstr "\"entry.S\"" +#: src/concurrency/async-exercises/chat-app.md +msgid "Running the binaries" +msgstr "バイナリの実行" -#: src/exercises/bare-metal/rtc.md -msgid "\"exceptions.S\"" -msgstr "\"exceptions.S\"" +#: src/concurrency/async-exercises/chat-app.md +msgid "Run the server with:" +msgstr "次のコマンドでサーバーを実行します。" -#: src/exercises/bare-metal/rtc.md -msgid "\"idmap.S\"" -msgstr "\"idmap.S\"" +#: src/concurrency/async-exercises/chat-app.md +msgid "and the client with:" +msgstr "次のコマンドでクライアントを実行します。" -#: src/exercises/bare-metal/rtc.md -msgid "\"empty\"" -msgstr "\"empty\"" +#: src/concurrency/async-exercises/chat-app.md +msgid "Implement the `handle_connection` function in `src/bin/server.rs`." +msgstr "`src/bin/server.rs` に `handle_connection` 関数を実装します。" -#: src/exercises/bare-metal/rtc.md -msgid "_entry.S_ (you shouldn't need to change this):" -msgstr "_entry.S_（変更する必要はありません）:" +#: src/concurrency/async-exercises/chat-app.md +msgid "" +"Hint: Use `tokio::select!` for concurrently performing two tasks in a " +"continuous loop. One task receives messages from the client and broadcasts " +"them. The other sends messages received by the server to the client." +msgstr "" +"ヒント: 2 つのタスクを連続ループで同時に実行するには、`tokio::select!` を使用" +"します。1 つのタスクは、クライアントからメッセージを受信してブロードキャスト" +"します。もう 1 つのタスクは、サーバーで受信したメッセージをクライアントに送信" +"します。" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-exercises/chat-app.md +msgid "Complete the main function in `src/bin/client.rs`." +msgstr "`src/bin/client.rs` のメイン関数を完成させます。" + +#: src/concurrency/async-exercises/chat-app.md msgid "" -"```armasm\n" -"/*\n" -" * Copyright 2023 Google LLC\n" -" *\n" -" * Licensed under the Apache License, Version 2.0 (the \"License\");\n" -" * you may not use this file except in compliance with the License.\n" -" * You may obtain a copy of the License at\n" -" *\n" -" * https://www.apache.org/licenses/LICENSE-2.0\n" -" *\n" -" * Unless required by applicable law or agreed to in writing, software\n" -" * distributed under the License is distributed on an \"AS IS\" BASIS,\n" -" * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n" -" * See the License for the specific language governing permissions and\n" -" * limitations under the License.\n" -" */\n" -"\n" -".macro adr_l, reg:req, sym:req\n" -"\tadrp \\reg, \\sym\n" -"\tadd \\reg, \\reg, :lo12:\\sym\n" -".endm\n" -"\n" -".macro mov_i, reg:req, imm:req\n" -"\tmovz \\reg, :abs_g3:\\imm\n" -"\tmovk \\reg, :abs_g2_nc:\\imm\n" -"\tmovk \\reg, :abs_g1_nc:\\imm\n" -"\tmovk \\reg, :abs_g0_nc:\\imm\n" -".endm\n" -"\n" -".set .L_MAIR_DEV_nGnRE,\t0x04\n" -".set .L_MAIR_MEM_WBWA,\t0xff\n" -".set .Lmairval, .L_MAIR_DEV_nGnRE | (.L_MAIR_MEM_WBWA << 8)\n" -"\n" -"/* 4 KiB granule size for TTBR0_EL1. */\n" -".set .L_TCR_TG0_4KB, 0x0 << 14\n" -"/* 4 KiB granule size for TTBR1_EL1. */\n" -".set .L_TCR_TG1_4KB, 0x2 << 30\n" -"/* Disable translation table walk for TTBR1_EL1, generating a translation " -"fault instead. */\n" -".set .L_TCR_EPD1, 0x1 << 23\n" -"/* Translation table walks for TTBR0_EL1 are inner sharable. */\n" -".set .L_TCR_SH_INNER, 0x3 << 12\n" -"/*\n" -" * Translation table walks for TTBR0_EL1 are outer write-back read-allocate " -"write-allocate\n" -" * cacheable.\n" -" */\n" -".set .L_TCR_RGN_OWB, 0x1 << 10\n" -"/*\n" -" * Translation table walks for TTBR0_EL1 are inner write-back read-allocate " -"write-allocate\n" -" * cacheable.\n" -" */\n" -".set .L_TCR_RGN_IWB, 0x1 << 8\n" -"/* Size offset for TTBR0_EL1 is 2**39 bytes (512 GiB). */\n" -".set .L_TCR_T0SZ_512, 64 - 39\n" -".set .Ltcrval, .L_TCR_TG0_4KB | .L_TCR_TG1_4KB | .L_TCR_EPD1 | ." -"L_TCR_RGN_OWB\n" -".set .Ltcrval, .Ltcrval | .L_TCR_RGN_IWB | .L_TCR_SH_INNER | ." -"L_TCR_T0SZ_512\n" -"\n" -"/* Stage 1 instruction access cacheability is unaffected. */\n" -".set .L_SCTLR_ELx_I, 0x1 << 12\n" -"/* SP alignment fault if SP is not aligned to a 16 byte boundary. */\n" -".set .L_SCTLR_ELx_SA, 0x1 << 3\n" -"/* Stage 1 data access cacheability is unaffected. */\n" -".set .L_SCTLR_ELx_C, 0x1 << 2\n" -"/* EL0 and EL1 stage 1 MMU enabled. */\n" -".set .L_SCTLR_ELx_M, 0x1 << 0\n" -"/* Privileged Access Never is unchanged on taking an exception to EL1. */\n" -".set .L_SCTLR_EL1_SPAN, 0x1 << 23\n" -"/* SETEND instruction disabled at EL0 in aarch32 mode. */\n" -".set .L_SCTLR_EL1_SED, 0x1 << 8\n" -"/* Various IT instructions are disabled at EL0 in aarch32 mode. */\n" -".set .L_SCTLR_EL1_ITD, 0x1 << 7\n" -".set .L_SCTLR_EL1_RES1, (0x1 << 11) | (0x1 << 20) | (0x1 << 22) | (0x1 << " -"28) | (0x1 << 29)\n" -".set .Lsctlrval, .L_SCTLR_ELx_M | .L_SCTLR_ELx_C | .L_SCTLR_ELx_SA | ." -"L_SCTLR_EL1_ITD | .L_SCTLR_EL1_SED\n" -".set .Lsctlrval, .Lsctlrval | .L_SCTLR_ELx_I | .L_SCTLR_EL1_SPAN | ." -"L_SCTLR_EL1_RES1\n" -"\n" -"/**\n" -" * This is a generic entry point for an image. It carries out the operations " -"required to prepare the\n" -" * loaded image to be run. Specifically, it zeroes the bss section using " -"registers x25 and above,\n" -" * prepares the stack, enables floating point, and sets up the exception " -"vector. It preserves x0-x3\n" -" * for the Rust entry point, as these may contain boot parameters.\n" -" */\n" -".section .init.entry, \"ax\"\n" -".global entry\n" -"entry:\n" -"\t/* Load and apply the memory management configuration, ready to enable MMU " -"and caches. */\n" -"\tadrp x30, idmap\n" -"\tmsr ttbr0_el1, x30\n" -"\n" -"\tmov_i x30, .Lmairval\n" -"\tmsr mair_el1, x30\n" -"\n" -"\tmov_i x30, .Ltcrval\n" -"\t/* Copy the supported PA range into TCR_EL1.IPS. */\n" -"\tmrs x29, id_aa64mmfr0_el1\n" -"\tbfi x30, x29, #32, #4\n" -"\n" -"\tmsr tcr_el1, x30\n" -"\n" -"\tmov_i x30, .Lsctlrval\n" -"\n" -"\t/*\n" -"\t * Ensure everything before this point has completed, then invalidate any " -"potentially stale\n" -"\t * local TLB entries before they start being used.\n" -"\t */\n" -"\tisb\n" -"\ttlbi vmalle1\n" -"\tic iallu\n" -"\tdsb nsh\n" -"\tisb\n" -"\n" -"\t/*\n" -"\t * Configure sctlr_el1 to enable MMU and cache and don't proceed until " -"this has completed.\n" -"\t */\n" -"\tmsr sctlr_el1, x30\n" -"\tisb\n" -"\n" -"\t/* Disable trapping floating point access in EL1. */\n" -"\tmrs x30, cpacr_el1\n" -"\torr x30, x30, #(0x3 << 20)\n" -"\tmsr cpacr_el1, x30\n" -"\tisb\n" -"\n" -"\t/* Zero out the bss section. */\n" -"\tadr_l x29, bss_begin\n" -"\tadr_l x30, bss_end\n" -"0:\tcmp x29, x30\n" -"\tb.hs 1f\n" -"\tstp xzr, xzr, [x29], #16\n" -"\tb 0b\n" -"\n" -"1:\t/* Prepare the stack. */\n" -"\tadr_l x30, boot_stack_end\n" -"\tmov sp, x30\n" -"\n" -"\t/* Set up exception vector. */\n" -"\tadr x30, vector_table_el1\n" -"\tmsr vbar_el1, x30\n" -"\n" -"\t/* Call into Rust code. */\n" -"\tbl main\n" -"\n" -"\t/* Loop forever waiting for interrupts. */\n" -"2:\twfi\n" -"\tb 2b\n" -"```" +"Hint: As before, use `tokio::select!` in a continuous loop for concurrently " +"performing two tasks: (1) reading user messages from standard input and " +"sending them to the server, and (2) receiving messages from the server, and " +"displaying them for the user." msgstr "" -"```armasm\n" -"/*\n" -" * Copyright 2023 Google LLC\n" -" *\n" -" * バージョン 2.0 の Apache ライセンス（以下「本ライセンス」）により使用が許" -"諾されています。\n" -" * このファイルを使用するには、本ライセンスに準拠する必要があります。\n" -" * 本ライセンスのコピーは下記のリンクから入手できます。\n" -" *\n" -" * https://www.apache.org/licenses/LICENSE-2.0\n" -" *\n" -" * 本ライセンスで配布されるソフトウェアは、\n" -" * 適用される法律によって要求される場合または書面で合意した場合を除き、\n" -" * 明示されるか黙示されるかを問わず、いかなる種類の保証も条件もなく、「現状有" -"姿」で提供されます。\n" -" * 本ライセンスの下で適用される具体的な許可および制限については、\n" -" * ライセンス本文をご覧ください。\n" -" */\n" -"\n" -".macro adr_l, reg:req, sym:req\n" -"\tadrp \\reg, \\sym\n" -"\tadd \\reg, \\reg, :lo12:\\sym\n" -".endm\n" -"\n" -".macro mov_i, reg:req, imm:req\n" -"\tmovz \\reg, :abs_g3:\\imm\n" -"\tmovk \\reg, :abs_g2_nc:\\imm\n" -"\tmovk \\reg, :abs_g1_nc:\\imm\n" -"\tmovk \\reg, :abs_g0_nc:\\imm\n" -".endm\n" -"\n" -".set .L_MAIR_DEV_nGnRE,\t0x04\n" -".set .L_MAIR_MEM_WBWA,\t0xff\n" -".set .Lmairval, .L_MAIR_DEV_nGnRE | (.L_MAIR_MEM_WBWA << 8)\n" -"\n" -"/* TTBR0_EL1におけるページサイズを4KiB単位に設定。*/\n" -".set .L_TCR_TG0_4KB, 0x0 << 14\n" -"/* TTBR1_EL1におけるページサイズを4KiB単位に設定。*/\n" -".set .L_TCR_TG1_4KB, 0x2 << 30\n" -"/* TTBR1_EL1 の変換テーブル ウォークを無効にして、代わりに変換エラーを生成し" -"ます。*/\n" -".set .L_TCR_EPD1, 0x1 << 23\n" -"/* TTBR0_EL1 の変換テーブル ウォークは内部共有可能です。*/\n" -".set .L_TCR_SH_INNER, 0x3 << 12\n" -"/*\n" -" * TTBR0_EL1 の変換テーブル ウォークは、外部書き戻し、読み取り割り当て、書き" -"込み割り当ての\n" -" * キャッシュが可能です。\n" -" */\n" -".set . L_TCR_RGN_OWB, 0x1 << 10\n" -"/*\n" -" * TTBR0_EL1 の変換テーブル ウォークは、内部書き戻し、読み取り割り当て、書き" -"込み割り当ての\n" -" * キャッシュが可能です。\n" -" */\n" -".set .L_TCR_RGN_IWB, 0x1 << 8\n" -"/* TTBR0_EL1 のサイズ オフセットは 2**39 バイト（512 GiB）です。*/\n" -".set .L_TCR_T0SZ_512, 64 - 39\n" -".set .Ltcrval, .L_TCR_TG0_4KB | .L_TCR_TG1_4KB | .L_TCR_EPD1 | ." -"L_TCR_RGN_OWB\n" -".set .Ltcrval, .Ltcrval | .L_TCR_RGN_IWB | .L_TCR_SH_INNER | ." -"L_TCR_T0SZ_512\n" -"\n" -"/* ステージ 1 の命令アクセスのキャッシュ可能設定は影響を受けません。*/\n" -".set .L_SCTLR_ELx_I, 0x1 << 12\n" -"/* SP が 16 バイト境界にアライメントされていない場合の SP アライメント フォー" -"ルト。*/\n" -".set .L_SCTLR_ELx_SA, 0x1 << 3\n" -"/* ステージ 1 のデータアクセスのキャッシュ可能性設定は影響を受けません。*/\n" -".set .L_SCTLR_ELx_C, 0x1 << 2\n" -"/* EL0 および EL1 ステージ 1 MMU が有効になっています。*/\n" -".set .L_SCTLR_ELx_M, 0x1 << 0\n" -"/* EL1 の例外を受け取っても、特権アクセスは変更されません。*/\n" -".set .L_SCTLR_EL1_SPAN, 0x1 << 23\n" -"/* aarch32 モードの EL0 で SETEND 命令が無効になっています。*/\n" -".set .L_SCTLR_EL1_SED, 0x1 << 8\n" -"/* さまざまな IT 命令が aarch32 モードの EL0 で無効になっています。*/\n" -".set .L_SCTLR_EL1_ITD, 0x1 << 7\n" -".set .L_SCTLR_EL1_RES1, (0x1 << 11) | (0x1 << 20) | (0x1 << 22) | (0x1 << " -"28) | (0x1 << 29)\n" -".set .Lsctlrval, .L_SCTLR_ELx_M | .L_SCTLR_ELx_C | .L_SCTLR_ELx_SA | ." -"L_SCTLR_EL1_ITD | .L_SCTLR_EL1_SED\n" -".set .Lsctlrval, .Lsctlrval | .L_SCTLR_ELx_I | .L_SCTLR_EL1_SPAN | ." -"L_SCTLR_EL1_RES1\n" -"\n" -"/**\n" -" * これはイメージの一般的なエントリ ポイントです。読み込まれたイメージの実行" -"を\n" -" * 準備するために必要なオペレーションを実行します。具体的には、x25 以上のレジ" -"スタを使用して bss セクションをゼロにし、\n" -" * スタックを準備し、浮動小数点数を有効にして、例外ベクターを設定します。" -"Rust エントリ ポイントのために x0-x3\n" -" * には下の値を保持します。これは起動パラメータを含む可能性があるためです。\n" -" */\n" -".section .init.entry, \"ax\"\n" -".global entry\n" -"entry:\n" -"\t/* メモリ管理に関する設定を読み込んで適用し、MMU とキャッシュを有効にする準" -"備をします。*/\n" -"\tadrp x30, idmap\n" -"\tmsr ttbr0_el1, x30\n" -"\n" -"\tmov_i x30, .Lmairval\n" -"\tmsr mair_el1, x30\n" -"\n" -"\tmov_i x30, .Ltcrval\n" -"\t/* サポートしている PA 範囲を TCR_EL1.IPS にコピーします。*/\n" -"\tmrs x29, id_aa64mmfr0_el1\n" -"\tbfi x30, x29, #32, #4\n" -"\n" -"\tmsr tcr_el1, x30\n" -"\n" -"\tmov_i x30, .Lsctlrval\n" -"\n" -"\t/*\n" -"\t * ここより前のすべての処理が完了していることを確認してから、\n" -"\t * 古くなった可能性のあるローカル TLB エントリを使用開始前に無効にしま" -"す。\n" -"\t */\n" -"\tisb\n" -"\ttlbi vmalle1\n" -"\tic iallu\n" -"\tdsb nsh\n" -"\tisb\n" -"\n" -"\t/*\n" -"\t * MMU とキャッシュを有効にするように sctlr_el1 を構成し、これが完了するま" -"では先に進みません。\n" -"\t */\n" -"\tmsr sctlr_el1, x30\n" -"\tisb\n" -"\n" -"\t/* EL1 の浮動小数点アクセスのトラップを無効にします。*/\n" -"\tmrs x30, cpacr_el1\n" -"\torr x30, x30, #(0x3 << 20)\n" -"\tmsr cpacr_el1, x30\n" -"\tisb\n" -"\n" -"\t/* bss セクションをゼロにします。*/\n" -"\tadr_l x29, bss_begin\n" -"\tadr_l x30, bss_end\n" -"0:\tcmp x29, x30\n" -"\tb.hs 1f\n" -"\tstp xzr, xzr, [x29], #16\n" -"\tb 0b\n" -"\n" -"1:\t/* スタックを準備します。*/\n" -"\tadr_l x30, boot_stack_end\n" -"\tmov sp, x30\n" -"\n" -"\t/* 例外ベクターを設定します。*/\n" -"\tadr x30, vector_table_el1\n" -"\tmsr vbar_el1, x30\n" -"\n" -"\t/* Rust コードを呼び出します。*/\n" -"\tbl main\n" -"\n" -"\t/* 割り込みを待機して永久にループします。*/\n" -"2:\twfi\n" -"\tb 2b\n" -"```" +"ヒント: 前の例と同様に、`tokio::select!` を連続ループで使用し、（1）標準入力" +"からユーザー メッセージを読み取ってサーバーに送信するタスクと、（2）サーバー" +"からメッセージを受信してユーザーに表示するタスクを同時に実行します。" -#: src/exercises/bare-metal/rtc.md -msgid "_exceptions.S_ (you shouldn't need to change this):" -msgstr "_exceptions.S_（変更する必要はありません）:" +#: src/concurrency/async-exercises/chat-app.md +msgid "" +"Optional: Once you are done, change the code to broadcast messages to all " +"clients, but the sender of the message." +msgstr "" +"省略可: 完了したら、メッセージの送信者以外のすべてのクライアントにメッセージ" +"をブロードキャストするようにコードを変更します。" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-exercises/solutions.md msgid "" -"```armasm\n" -"/*\n" -" * Copyright 2023 Google LLC\n" -" *\n" -" * Licensed under the Apache License, Version 2.0 (the \"License\");\n" -" * you may not use this file except in compliance with the License.\n" -" * You may obtain a copy of the License at\n" -" *\n" -" * https://www.apache.org/licenses/LICENSE-2.0\n" -" *\n" -" * Unless required by applicable law or agreed to in writing, software\n" -" * distributed under the License is distributed on an \"AS IS\" BASIS,\n" -" * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n" -" * See the License for the specific language governing permissions and\n" -" * limitations under the License.\n" -" */\n" -"\n" -"/**\n" -" * Saves the volatile registers onto the stack. This currently takes 14\n" -" * instructions, so it can be used in exception handlers with 18 " -"instructions\n" -" * left.\n" -" *\n" -" * On return, x0 and x1 are initialised to elr_el2 and spsr_el2 " -"respectively,\n" -" * which can be used as the first and second arguments of a subsequent " -"call.\n" -" */\n" -".macro save_volatile_to_stack\n" -"\t/* Reserve stack space and save registers x0-x18, x29 & x30. */\n" -"\tstp x0, x1, [sp, #-(8 * 24)]!\n" -"\tstp x2, x3, [sp, #8 * 2]\n" -"\tstp x4, x5, [sp, #8 * 4]\n" -"\tstp x6, x7, [sp, #8 * 6]\n" -"\tstp x8, x9, [sp, #8 * 8]\n" -"\tstp x10, x11, [sp, #8 * 10]\n" -"\tstp x12, x13, [sp, #8 * 12]\n" -"\tstp x14, x15, [sp, #8 * 14]\n" -"\tstp x16, x17, [sp, #8 * 16]\n" -"\tstr x18, [sp, #8 * 18]\n" -"\tstp x29, x30, [sp, #8 * 20]\n" -"\n" -"\t/*\n" -"\t * Save elr_el1 & spsr_el1. This such that we can take nested exception\n" -"\t * and still be able to unwind.\n" -"\t */\n" -"\tmrs x0, elr_el1\n" -"\tmrs x1, spsr_el1\n" -"\tstp x0, x1, [sp, #8 * 22]\n" -".endm\n" -"\n" -"/**\n" -" * Restores the volatile registers from the stack. This currently takes 14\n" -" * instructions, so it can be used in exception handlers while still leaving " -"18\n" -" * instructions left; if paired with save_volatile_to_stack, there are 4\n" -" * instructions to spare.\n" -" */\n" -".macro restore_volatile_from_stack\n" -"\t/* Restore registers x2-x18, x29 & x30. */\n" -"\tldp x2, x3, [sp, #8 * 2]\n" -"\tldp x4, x5, [sp, #8 * 4]\n" -"\tldp x6, x7, [sp, #8 * 6]\n" -"\tldp x8, x9, [sp, #8 * 8]\n" -"\tldp x10, x11, [sp, #8 * 10]\n" -"\tldp x12, x13, [sp, #8 * 12]\n" -"\tldp x14, x15, [sp, #8 * 14]\n" -"\tldp x16, x17, [sp, #8 * 16]\n" -"\tldr x18, [sp, #8 * 18]\n" -"\tldp x29, x30, [sp, #8 * 20]\n" -"\n" -"\t/* Restore registers elr_el1 & spsr_el1, using x0 & x1 as scratch. */\n" -"\tldp x0, x1, [sp, #8 * 22]\n" -"\tmsr elr_el1, x0\n" -"\tmsr spsr_el1, x1\n" -"\n" -"\t/* Restore x0 & x1, and release stack space. */\n" -"\tldp x0, x1, [sp], #8 * 24\n" -".endm\n" -"\n" -"/**\n" -" * This is a generic handler for exceptions taken at the current EL while " -"using\n" -" * SP0. It behaves similarly to the SPx case by first switching to SPx, " -"doing\n" -" * the work, then switching back to SP0 before returning.\n" -" *\n" -" * Switching to SPx and calling the Rust handler takes 16 instructions. To\n" -" * restore and return we need an additional 16 instructions, so we can " -"implement\n" -" * the whole handler within the allotted 32 instructions.\n" -" */\n" -".macro current_exception_sp0 handler:req\n" -"\tmsr spsel, #1\n" -"\tsave_volatile_to_stack\n" -"\tbl \\handler\n" -"\trestore_volatile_from_stack\n" -"\tmsr spsel, #0\n" -"\teret\n" -".endm\n" -"\n" -"/**\n" -" * This is a generic handler for exceptions taken at the current EL while " -"using\n" -" * SPx. It saves volatile registers, calls the Rust handler, restores " -"volatile\n" -" * registers, then returns.\n" -" *\n" -" * This also works for exceptions taken from EL0, if we don't care about\n" -" * non-volatile registers.\n" -" *\n" -" * Saving state and jumping to the Rust handler takes 15 instructions, and\n" -" * restoring and returning also takes 15 instructions, so we can fit the " -"whole\n" -" * handler in 30 instructions, under the limit of 32.\n" -" */\n" -".macro current_exception_spx handler:req\n" -"\tsave_volatile_to_stack\n" -"\tbl \\handler\n" -"\trestore_volatile_from_stack\n" -"\teret\n" -".endm\n" -"\n" -".section .text.vector_table_el1, \"ax\"\n" -".global vector_table_el1\n" -".balign 0x800\n" -"vector_table_el1:\n" -"sync_cur_sp0:\n" -"\tcurrent_exception_sp0 sync_exception_current\n" -"\n" -".balign 0x80\n" -"irq_cur_sp0:\n" -"\tcurrent_exception_sp0 irq_current\n" -"\n" -".balign 0x80\n" -"fiq_cur_sp0:\n" -"\tcurrent_exception_sp0 fiq_current\n" -"\n" -".balign 0x80\n" -"serr_cur_sp0:\n" -"\tcurrent_exception_sp0 serr_current\n" -"\n" -".balign 0x80\n" -"sync_cur_spx:\n" -"\tcurrent_exception_spx sync_exception_current\n" -"\n" -".balign 0x80\n" -"irq_cur_spx:\n" -"\tcurrent_exception_spx irq_current\n" -"\n" -".balign 0x80\n" -"fiq_cur_spx:\n" -"\tcurrent_exception_spx fiq_current\n" -"\n" -".balign 0x80\n" -"serr_cur_spx:\n" -"\tcurrent_exception_spx serr_current\n" -"\n" -".balign 0x80\n" -"sync_lower_64:\n" -"\tcurrent_exception_spx sync_lower\n" -"\n" -".balign 0x80\n" -"irq_lower_64:\n" -"\tcurrent_exception_spx irq_lower\n" -"\n" -".balign 0x80\n" -"fiq_lower_64:\n" -"\tcurrent_exception_spx fiq_lower\n" -"\n" -".balign 0x80\n" -"serr_lower_64:\n" -"\tcurrent_exception_spx serr_lower\n" -"\n" -".balign 0x80\n" -"sync_lower_32:\n" -"\tcurrent_exception_spx sync_lower\n" -"\n" -".balign 0x80\n" -"irq_lower_32:\n" -"\tcurrent_exception_spx irq_lower\n" -"\n" -".balign 0x80\n" -"fiq_lower_32:\n" -"\tcurrent_exception_spx fiq_lower\n" -"\n" -".balign 0x80\n" -"serr_lower_32:\n" -"\tcurrent_exception_spx serr_lower\n" -"```" +"// If we didn't get the left fork, drop the right fork if we\n" +" // have it and let other tasks make progress.\n" msgstr "" -"```armasm\n" -"/*\n" -" * Copyright 2023 Google LLC\n" -" *\n" -" * バージョン 2.0 の Apache ライセンス（以下「本ライセンス」）により使用が許" -"諾されています。\n" -" * このファイルを使用するには、本ライセンスに準拠する必要があります。\n" -" * 本ライセンスのコピーは下記のリンクから入手できます。\n" -" *\n" -" * https://www.apache.org/licenses/LICENSE-2.0\n" -" *\n" -" * 本ライセンスで配布されるソフトウェアは、\n" -" * 適用される法律によって要求される場合または書面で合意した場合を除き、\n" -" * 明示されるか黙示されるかを問わず、いかなる種類の保証も条件もなく、「現状有" -"姿」で提供されます。\n" -" * 本ライセンスの下で適用される具体的な許可および制限については、\n" -" * ライセンス本文をご覧ください。\n" -" */\n" -"\n" -"/**\n" -" * 揮発性レジスタをスタックに保存します。この部分は現在 14 個の\n" -" * 命令で構成されているので、例外ハンドラで\n" -" * 使用できます。その場合、残りは18命令分になります。\n" -" *\n" -" * 戻った際に、x0 と x1 はそれぞれ elr_el2 と spsr_el2 に初期化され、\n" -" * これらは後続の呼び出しの 1 つ目と 2 つ目の引数として使用できます。\n" -" */\n" -".macro save_volatile_to_stack\n" -"\t/* スタック空間を予約し、レジスタ x0～x18、x29、x30 を保存します。*/\n" -"\tstp x0, x1, [sp, #-(8 * 24)]!\n" -"\tstp x2, x3, [sp, #8 * 2]\n" -"\tstp x4, x5, [sp, #8 * 4]\n" -"\tstp x6, x7, [sp, #8 * 6]\n" -"\tstp x8, x9, [sp, #8 * 8]\n" -"\tstp x10, x11, [sp, #8 * 10]\n" -"\tstp x12, x13, [sp, #8 * 12]\n" -"\tstp x14, x15, [sp, #8 * 14]\n" -"\tstp x16, x17, [sp, #8 * 16]\n" -"\tstr x18, [sp, #8 * 18]\n" -"\tstp x29, x30, [sp, #8 * 20]\n" -"\n" -"\t/*\n" -"\t * elr_el1 と spsr_el1 を保存します。これにより、ネストされた例外を受付可能" -"になり、\n" -"\t * また、アンワインドできるようになります。\n" -"\t */\n" -"\tmrs x0, elr_el1\n" -"\tmrs x1, spsr_el1\n" -"\tstp x0, x1, [sp, #8 * 22]\n" -".endm\n" -"\n" -"/**\n" -" * スタックから揮発性レジスタを復元します。この部分は現在14 個の\n" -" * 命令で構成されているので、\n" -" * 例外ハンドラで使用できます。また、その場合18命令分の領域が残ります。" -"save_volatile_to_stack と組み合わせた場合、\n" -" * 4 個の命令が残ります。\n" -" */\n" -".macro restore_volatile_from_stack\n" -"\t/* レジスタ x2～x18、x29、x30 を復元します。*/\n" -"\tldp x2, x3, [sp, #8 * 2]\n" -"\tldp x4, x5, [sp, #8 * 4]\n" -"\tldp x6, x7, [sp, #8 * 6]\n" -"\tldp x8, x9, [sp, #8 * 8]\n" -"\tldp x10, x11, [sp, #8 * 10]\n" -"\tldp x12, x13, [sp, #8 * 12]\n" -"\tldp x14, x15, [sp, #8 * 14]\n" -"\tldp x16, x17, [sp, #8 * 16]\n" -"\tldr x18, [sp, #8 * 18]\n" -"\tldp x29, x30, [sp, #8 * 20]\n" -"\n" -"\t/* x0 と x1 をスクラッチとして使用して、レジスタ elr_el1 および spsr_el1 を" -"復元します。*/\n" -"\tldp x0, x1, [sp, #8 * 22]\n" -"\tmsr elr_el1, x0\n" -"\tmsr spsr_el1, x1\n" -"\n" -"\t/* x0 と x1 を復元し、スタック空間を解放します。*/\n" -"\tldp x0, x1, [sp], #8 * 24\n" -".endm\n" -"\n" -"/**\n" -" * これは、SP0 の使用中に現在の EL で取得される例外の\n" -" * 汎用ハンドラです。SPx の場合と同様に、最初に SPx に切り替えて処理を実行" -"し、\n" -" * 戻る前に再度 SP0 に切り替えます。\n" -" *\n" -" * SPx に切り替えて Rust ハンドラを呼び出すには、16 個の命令が必要です。復元" -"して戻るには、\n" -" * さらに 16 個の命令が必要であるため、割り当てられた 32 個の命令の中で\n" -" * ハンドラ全体を実装できます。\n" -" */\n" -".macro current_exception_sp0 handler:req\n" -"\tmsr spsel, #1\n" -"\tsave_volatile_to_stack\n" -"\tbl \\handler\n" -"\trestore_volatile_from_stack\n" -"\tmsr spsel, #0\n" -"\teret\n" -".endm\n" -"\n" -"/**\n" -" * これは、\n" -" * SPx の使用中に現在の EL で受け付けた例外の汎用ハンドラです。揮発性レジスタ" -"を保存し、Rust ハンドラを呼び出し、揮発性レジスタを\n" -" * してから戻ります。\n" -" *\n" -" * 不揮発性レジスタを考慮しなければ、EL0 から取得した例外に対しても\n" -" * 機能します。\n" -" *\n" -" * 状態の保存と Rust ハンドラへのジャンプには 15 個の命令が必要で、\n" -" * 復元して戻るのにも 15 個の命令が必要であるため、\n" -" * ハンドラ全体を 32 個の制限内である 30 個の命令に収めることができます。\n" -" */\n" -".macro current_exception_spx handler:req\n" -"\tsave_volatile_to_stack\n" -"\tbl \\handler\n" -"\trestore_volatile_from_stack\n" -"\teret\n" -".endm\n" -"\n" -".section .text.vector_table_el1, \"ax\"\n" -".global vector_table_el1\n" -".balign 0x800\n" -"vector_table_el1:\n" -"sync_cur_sp0:\n" -"\tcurrent_exception_sp0 sync_exception_current\n" -"\n" -".balign 0x80\n" -"irq_cur_sp0:\n" -"\tcurrent_exception_sp0 irq_current\n" -"\n" -".balign 0x80\n" -"fiq_cur_sp0:\n" -"\tcurrent_exception_sp0 fiq_current\n" -"\n" -".balign 0x80\n" -"serr_cur_sp0:\n" -"\tcurrent_exception_sp0 serr_current\n" -"\n" -".balign 0x80\n" -"sync_cur_spx:\n" -"\tcurrent_exception_spx sync_exception_current\n" -"\n" -".balign 0x80\n" -"irq_cur_spx:\n" -"\tcurrent_exception_spx irq_current\n" -"\n" -".balign 0x80\n" -"fiq_cur_spx:\n" -"\tcurrent_exception_spx fiq_current\n" -"\n" -".balign 0x80\n" -"serr_cur_spx:\n" -"\tcurrent_exception_spx serr_current\n" -"\n" -".balign 0x80\n" -"sync_lower_64:\n" -"\tcurrent_exception_spx sync_lower\n" -"\n" -".balign 0x80\n" -"irq_lower_64:\n" -"\tcurrent_exception_spx irq_lower\n" -"\n" -".balign 0x80\n" -"fiq_lower_64:\n" -"\tcurrent_exception_spx fiq_lower\n" -"\n" -".balign 0x80\n" -"serr_lower_64:\n" -"\tcurrent_exception_spx serr_lower\n" -"\n" -".balign 0x80\n" -"sync_lower_32:\n" -"\tcurrent_exception_spx sync_lower\n" -"\n" -".balign 0x80\n" -"irq_lower_32:\n" -"\tcurrent_exception_spx irq_lower\n" -"\n" -".balign 0x80\n" -"fiq_lower_32:\n" -"\tcurrent_exception_spx fiq_lower\n" -"\n" -".balign 0x80\n" -"serr_lower_32:\n" -"\tcurrent_exception_spx serr_lower\n" -"```" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-exercises/solutions.md msgid "" -"```armasm\n" -"/*\n" -" * Copyright 2023 Google LLC\n" -" *\n" -" * Licensed under the Apache License, Version 2.0 (the \"License\");\n" -" * you may not use this file except in compliance with the License.\n" -" * You may obtain a copy of the License at\n" -" *\n" -" * https://www.apache.org/licenses/LICENSE-2.0\n" -" *\n" -" * Unless required by applicable law or agreed to in writing, software\n" -" * distributed under the License is distributed on an \"AS IS\" BASIS,\n" -" * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n" -" * See the License for the specific language governing permissions and\n" -" * limitations under the License.\n" -" */\n" -"\n" -".set .L_TT_TYPE_BLOCK, 0x1\n" -".set .L_TT_TYPE_PAGE, 0x3\n" -".set .L_TT_TYPE_TABLE, 0x3\n" -"\n" -"/* Access flag. */\n" -".set .L_TT_AF, 0x1 << 10\n" -"/* Not global. */\n" -".set .L_TT_NG, 0x1 << 11\n" -".set .L_TT_XN, 0x3 << 53\n" -"\n" -".set .L_TT_MT_DEV, 0x0 << 2\t\t\t// MAIR #0 (DEV_nGnRE)\n" -".set .L_TT_MT_MEM, (0x1 << 2) | (0x3 << 8)\t// MAIR #1 (MEM_WBWA), inner " -"shareable\n" -"\n" -".set .L_BLOCK_DEV, .L_TT_TYPE_BLOCK | .L_TT_MT_DEV | .L_TT_AF | .L_TT_XN\n" -".set .L_BLOCK_MEM, .L_TT_TYPE_BLOCK | .L_TT_MT_MEM | .L_TT_AF | .L_TT_NG\n" -"\n" -".section \".rodata.idmap\", \"a\", %progbits\n" -".global idmap\n" -".align 12\n" -"idmap:\n" -"\t/* level 1 */\n" -"\t.quad\t\t.L_BLOCK_DEV | 0x0\t\t // 1 GiB of device mappings\n" -"\t.quad\t\t.L_BLOCK_MEM | 0x40000000\t// 1 GiB of DRAM\n" -"\t.fill\t\t254, 8, 0x0\t\t\t// 254 GiB of unmapped VA space\n" -"\t.quad\t\t.L_BLOCK_DEV | 0x4000000000 // 1 GiB of device mappings\n" -"\t.fill\t\t255, 8, 0x0\t\t\t// 255 GiB of remaining VA space\n" -"```" +"// If we didn't get the right fork, drop the left fork and let\n" +" // other tasks make progress.\n" msgstr "" -"```armasm\n" -"/*\n" -" * Copyright 2023 Google LLC\n" -" *\n" -" * バージョン 2.0 の Apache ライセンス（以下「本ライセンス」）により使用が許" -"諾されています。\n" -" * このファイルを使用するには、本ライセンスに準拠する必要があります。\n" -" * 本ライセンスのコピーは下記のリンクから入手できます。\n" -" *\n" -" * https://www.apache.org/licenses/LICENSE-2.0\n" -" *\n" -" * 本ライセンスで配布されるソフトウェアは、\n" -" * 適用される法律によって要求される場合または書面で合意した場合を除き、\n" -" * 明示されるか黙示されるかを問わず、いかなる種類の保証も条件もなく、「現状有" -"姿」で提供されます。\n" -" * 本ライセンスの下で適用される具体的な許可および制限については、\n" -" * ライセンス本文をご覧ください。\n" -" */\n" -"\n" -".set .L_TT_TYPE_BLOCK, 0x1\n" -".set .L_TT_TYPE_PAGE, 0x3\n" -".set .L_TT_TYPE_TABLE, 0x3\n" -"\n" -"/* アクセスフラグ。*/\n" -".set .L_TT_AF, 0x1 << 10\n" -"/* グローバルではありません。*/\n" -".set .L_TT_NG, 0x1 << 11\n" -".set .L_TT_XN, 0x3 << 53\n" -"\n" -".set .L_TT_MT_DEV, 0x0 << 2\t\t\t// MAIR #0 (DEV_nGnRE)\n" -".set .L_TT_MT_MEM, (0x1 << 2) | (0x3 << 8)\t// MAIR #1 (MEM_WBWA)、内部共有可" -"能\n" -"\n" -".set .L_BLOCK_DEV, .L_TT_TYPE_BLOCK | .L_TT_MT_DEV | .L_TT_AF | .L_TT_XN\n" -".set .L_BLOCK_MEM, .L_TT_TYPE_BLOCK | .L_TT_MT_MEM | .L_TT_AF | .L_TT_NG\n" -"\n" -".section \".rodata.idmap\", \"a\", %progbits\n" -".global idmap\n" -".align 12\n" -"idmap:\n" -"\t/* レベル 1 */\n" -"\t.quad\t\t.L_BLOCK_DEV | 0x0\t\t // 1 GiB のデバイス マッピング\n" -"\t.quad\t\t.L_BLOCK_MEM | 0x40000000\t// 1 GiB の DRAM\n" -"\t.fill\t\t254, 8, 0x0\t\t\t// 254 GiB のマッピングされていない VA 空間\n" -"\t.quad\t\t.L_BLOCK_DEV | 0x4000000000 // 1 GiB のデバイス マッピング\n" -"\t.fill\t\t255, 8, 0x0\t\t\t// 255 GiB の残りの VA 空間\n" -"```" -#: src/exercises/bare-metal/rtc.md -msgid "_image.ld_ (you shouldn't need to change this):" -msgstr "_image.ld_（変更する必要はありません）:" +#: src/concurrency/async-exercises/solutions.md +msgid "// The locks are dropped here\n" +msgstr "// ここでロックがドロップされます。\n" -#: src/exercises/bare-metal/rtc.md +#: src/concurrency/async-exercises/solutions.md +msgid "// tx is dropped here, so we don't need to explicitly drop it later\n" +msgstr "" +"// tx はここでドロップされるので、後で明示的に削除する必要はありません。\n" + +#: src/concurrency/async-exercises/solutions.md +msgid "\"Here is a thought: {thought}\"" +msgstr "\"Here is a thought: {thought}\"" + +#: src/concurrency/async-exercises/solutions.md +msgid "\"Welcome to chat! Type a message\"" +msgstr "\"Welcome to chat! Type a message\"" + +#: src/concurrency/async-exercises/solutions.md msgid "" -"```ld\n" -"/*\n" -" * Copyright 2023 Google LLC\n" -" *\n" -" * Licensed under the Apache License, Version 2.0 (the \"License\");\n" -" * you may not use this file except in compliance with the License.\n" -" * You may obtain a copy of the License at\n" -" *\n" -" * https://www.apache.org/licenses/LICENSE-2.0\n" -" *\n" -" * Unless required by applicable law or agreed to in writing, software\n" -" * distributed under the License is distributed on an \"AS IS\" BASIS,\n" -" * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n" -" * See the License for the specific language governing permissions and\n" -" * limitations under the License.\n" -" */\n" -"\n" -"/*\n" -" * Code will start running at this symbol which is placed at the start of " -"the\n" -" * image.\n" -" */\n" -"ENTRY(entry)\n" -"\n" -"MEMORY\n" -"{\n" -"\timage : ORIGIN = 0x40080000, LENGTH = 2M\n" -"}\n" -"\n" -"SECTIONS\n" -"{\n" -"\t/*\n" -"\t * Collect together the code.\n" -"\t */\n" -"\t.init : ALIGN(4096) {\n" -"\t\ttext_begin = .;\n" -"\t\t*(.init.entry)\n" -"\t\t*(.init.*)\n" -"\t} >image\n" -"\t.text : {\n" -"\t\t*(.text.*)\n" -"\t} >image\n" -"\ttext_end = .;\n" -"\n" -"\t/*\n" -"\t * Collect together read-only data.\n" -"\t */\n" -"\t.rodata : ALIGN(4096) {\n" -"\t\trodata_begin = .;\n" -"\t\t*(.rodata.*)\n" -"\t} >image\n" -"\t.got : {\n" -"\t\t*(.got)\n" -"\t} >image\n" -"\trodata_end = .;\n" -"\n" -"\t/*\n" -"\t * Collect together the read-write data including .bss at the end which\n" -"\t * will be zero'd by the entry code.\n" -"\t */\n" -"\t.data : ALIGN(4096) {\n" -"\t\tdata_begin = .;\n" -"\t\t*(.data.*)\n" -"\t\t/*\n" -"\t\t * The entry point code assumes that .data is a multiple of 32\n" -"\t\t * bytes long.\n" -"\t\t */\n" -"\t\t. = ALIGN(32);\n" -"\t\tdata_end = .;\n" -"\t} >image\n" -"\n" -"\t/* Everything beyond this point will not be included in the binary. */\n" -"\tbin_end = .;\n" -"\n" -"\t/* The entry point code assumes that .bss is 16-byte aligned. */\n" -"\t.bss : ALIGN(16) {\n" -"\t\tbss_begin = .;\n" -"\t\t*(.bss.*)\n" -"\t\t*(COMMON)\n" -"\t\t. = ALIGN(16);\n" -"\t\tbss_end = .;\n" -"\t} >image\n" -"\n" -"\t.stack (NOLOAD) : ALIGN(4096) {\n" -"\t\tboot_stack_begin = .;\n" -"\t\t. += 40 * 4096;\n" -"\t\t. = ALIGN(4096);\n" -"\t\tboot_stack_end = .;\n" -"\t} >image\n" -"\n" -"\t. = ALIGN(4K);\n" -"\tPROVIDE(dma_region = .);\n" -"\n" -"\t/*\n" -"\t * Remove unused sections from the image.\n" -"\t */\n" -"\t/DISCARD/ : {\n" -"\t\t/* The image loads itself so doesn't need these sections. */\n" -"\t\t*(.gnu.hash)\n" -"\t\t*(.hash)\n" -"\t\t*(.interp)\n" -"\t\t*(.eh_frame_hdr)\n" -"\t\t*(.eh_frame)\n" -"\t\t*(.note.gnu.build-id)\n" -"\t}\n" -"}\n" -"```" +"// A continuous loop for concurrently performing two tasks: (1) receiving\n" +" // messages from `ws_stream` and broadcasting them, and (2) receiving\n" +" // messages on `bcast_rx` and sending them to the client.\n" msgstr "" -"```ld\n" -"/*\n" -" * Copyright 2023 Google LLC\n" -" *\n" -" * バージョン 2.0 の Apache ライセンス（以下「本ライセンス」）により使用が許" -"諾されています。\n" -" * このファイルを使用するには、本ライセンスに準拠する必要があります。\n" -" * 本ライセンスのコピーは下記のリンクから入手できます。\n" -" *\n" -" * https://www.apache.org/licenses/LICENSE-2.0\n" -" *\n" -" * 本ライセンスで配布されるソフトウェアは、\n" -" * 適用される法律によって要求される場合または書面で合意した場合を除き、\n" -" * 明示されるか黙示されるかを問わず、いかなる種類の保証も条件もなく、「現状有" -"姿」で提供されます。\n" -" * 本ライセンスの下で適用される具体的な許可および制限については、\n" -" * ライセンス本文をご覧ください。\n" -" */\n" -"\n" -"/*\n" -" * コードの実行は、イメージの先頭にあるこのシンボルから\n" -" * 開始されます。\n" -" */\n" -"ENTRY(entry)\n" -"\n" -"MEMORY\n" -"{\n" -"\timage : ORIGIN = 0x40080000, LENGTH = 2M\n" -"}\n" -"\n" -"SECTIONS\n" -"{\n" -"\t/*\n" -"\t * コードを集約します\n" -"\t */\n" -"\t.init : ALIGN(4096) {\n" -"\t\ttext_begin = .;\n" -"\t\t*(.init.entry)\n" -"\t\t*(.init.*)\n" -"\t} >image\n" -"\t.text : {\n" -"\t\t*(.text.*)\n" -"\t} >image\n" -"\ttext_end = .;\n" -"\n" -"\t/*\n" -"\t * 読み取り専用データを集約します。\n" -"\t */\n" -"\t.rodata : ALIGN(4096) {\n" -"\t\trodata_begin = .;\n" -"\t\t*(.rodata.*)\n" -"\t} >image\n" -"\t.got : {\n" -"\t\t*(.got)\n" -"\t} >image\n" -"\trodata_end = .;\n" -"\n" -"\t/*\n" -"\t * エントリコードによってゼロ初期化される.bssを末尾に含む、書き込み可能デー" -"タを集約します。\n" -"\t */\n" -"\t.data : ALIGN(4096) {\n" -"\t\tdata_begin = .;\n" -"\t\t*(.data.*)\n" -"\t\t/*\n" -"\t\t * このエントリポイントは.dataの大きさが32バイトの倍数になっていることを" -"前提としています。\n" -"\t\t */\n" -"\t\t. = ALIGN(32);\n" -"\t\tdata_end = .;\n" -"\t} >image\n" -"\n" -"\t/* これ以降はすべてバイナリに含まれません。*/\n" -"\tbin_end = .;\n" -"\n" -"\t/* このエントリ ポイント コードは、.bss が 16 バイトでアラインされているこ" -"とを前提としています。*/\n" -"\t.bss : ALIGN(16) {\n" -"\t\tbss_begin = .;\n" -"\t\t*(.bss.*)\n" -"\t\t*(COMMON)\n" -"\t\t. = ALIGN(16);\n" -"\t\tbss_end = .;\n" -"\t} >image\n" -"\n" -"\t.stack (NOLOAD) : ALIGN(4096) {\n" -"\t\tboot_stack_begin = .;\n" -"\t\t. += 40 * 4096;\n" -"\t\t. = ALIGN(4096);\n" -"\t\tboot_stack_end = .;\n" -"\t} >image\n" -"\n" -"\t. = ALIGN(4K);\n" -"\tPROVIDE(dma_region = .);\n" -"\n" -"\t/*\n" -"\t * 使用されていないセクションをイメージから削除します。\n" -"\t */\n" -"\t/DISCARD/ : {\n" -"\t\t/* イメージは自分自身によりロードされるのでこれらのセクションは不要です。" -"*/\n" -"\t\t*(.gnu.hash)\n" -"\t\t*(.hash)\n" -"\t\t*(.interp)\n" -"\t\t*(.eh_frame_hdr)\n" -"\t\t*(.eh_frame)\n" -"\t\t*(.note.gnu.build-id)\n" -"\t}\n" -"}\n" -"```" +"// (1) `ws_stream` からメッセージを受信してブロードキャストするタスクと、\n" +" // （2）`bcast_rx` でメッセージを受信してクライアントに送信しするタスク" +"を\n" +" // 同時に実行するための連続ループ。\n" -#: src/exercises/bare-metal/rtc.md -msgid "_Makefile_ (you shouldn't need to change this):" -msgstr "_Makefile_（変更する必要はありません）:" +#: src/concurrency/async-exercises/solutions.md +msgid "\"From client {addr:?} {text:?}\"" +msgstr "\"From client {addr:?} {text:?}\"" -#: src/exercises/bare-metal/rtc.md -msgid "# Copyright 2023 Google LLC" -msgstr "# Copyright 2023 Google LLC" +#: src/concurrency/async-exercises/solutions.md +msgid "// Continuous loop for concurrently sending and receiving messages.\n" +msgstr "// メッセージの同時送受信のための継続的なループ。\n" -#: src/exercises/bare-metal/rtc.md -msgid "$(shell uname -s)" -msgstr "$(shell uname -s)" +#: src/concurrency/async-exercises/solutions.md +msgid "\"From server: {}\"" +msgstr "\"From server: {}\"" + +#: src/thanks.md +msgid "" +"_Thank you for taking Comprehensive Rust 🦀!_ We hope you enjoyed it and " +"that it was useful." +msgstr "Comprehensive Rust 🦀! を受講いただきありがとうございました。" + +#: src/thanks.md +msgid "" +"We've had a lot of fun putting the course together. The course is not " +"perfect, so if you spotted any mistakes or have ideas for improvements, " +"please get in [contact with us on GitHub](https://github.com/google/" +"comprehensive-rust/discussions). We would love to hear from you." +msgstr "" +"ここまで多くのことを学んできましたが、このコースは完璧ではないため、間違いを" +"見つけた場合や改善のアイデアがある場合は [GitHub でお知らせください](https://" +"github.com/google/comprehensive-rust/discussions)。皆さんからのフィードバック" +"をお待ちしています。" + +#: src/glossary.md +msgid "" +"The following is a glossary which aims to give a short definition of many " +"Rust terms. For translations, this also serves to connect the term back to " +"the English original." +msgstr "" +"以下は、Rust の多くの用語を簡単に定義することを目的とした用語集です。翻訳時に" +"用語を英語の原文に関連付けるのにも役立ちます。" -#: src/exercises/bare-metal/rtc.md -msgid "aarch64-linux-gnu" -msgstr "aarch64-linux-gnu" +#. Please add the English term in italic after your translated term. Also, please keep the hard line breaks to ensure a nice formatting. +#: src/glossary.md +#, fuzzy +msgid "" +"allocate: \n" +"Dynamic memory allocation on [the heap](memory-management/review.md)." +msgstr "" +"割り当て（allocate）: \n" +"[ヒープ](memory-management/stack-vs-heap.md) での動的メモリ割り当て。" -#: src/exercises/bare-metal/rtc.md -msgid "stdio -display none -kernel $< -s" -msgstr "stdio -display none -kernel $< -s" +#: src/glossary.md +msgid "" +"argument: \n" +"Information that is passed into a function or method." +msgstr "" +"引数（argument）: \n" +"関数またはメソッドに渡される情報。" -#: src/exercises/bare-metal/rtc.md -msgid "cargo clean" -msgstr "cargo clean" +#: src/glossary.md +msgid "" +"associated type: \n" +"A type associated with a specific trait. Useful for defining the " +"relationship between types." +msgstr "" -#: src/exercises/bare-metal/rtc.md -msgid "Run the code in QEMU with `make qemu`." -msgstr "`make qemu`によりQEMU でコードを実行します。" +#: src/glossary.md +msgid "" +"Bare-metal Rust: \n" +"Low-level Rust development, often deployed to a system without an operating " +"system. See [Bare-metal Rust](bare-metal.md)." +msgstr "" +"ベアメタル Rust（Bare-metal Rust）: \n" +"低レベルの Rust 開発。多くの場合、オペレーティング システムのないシステムにデ" +"プロイされます。[ベアメタル Rust](bare-metal.md) をご覧ください。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "Bare Metal Rust Afternoon" -msgstr "ベアメタルRust PM" +#: src/glossary.md +#, fuzzy +msgid "" +"block: \n" +"See [Blocks](control-flow-basics/blocks-and-scopes.md) and _scope_." +msgstr "" +"ブロック（block）: \n" +"[ブロック](control-flow/blocks.md) とスコープをご覧ください。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "([back to exercise](rtc.md))" -msgstr "（[演習に戻る](rtc.md)）" +#: src/glossary.md +#, fuzzy +msgid "" +"borrow: \n" +"See [Borrowing](borrowing/shared.md)." +msgstr "" +"借用（borrow）: \n" +"[借用](ownership/borrowing.md) をご覧ください。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "_main.rs_:" -msgstr "_main.rs_:" +#: src/glossary.md +msgid "" +"borrow checker: \n" +"The part of the Rust compiler which checks that all borrows are valid." +msgstr "" +"借用チェッカー（borrow checker）: \n" +"Rust コンパイラの一部。すべての借用が有効かどうかをチェックします。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Base address of the PL031 RTC.\n" -msgstr "/// PL031 RTC のベースアドレス。\n" +#: src/glossary.md +msgid "" +"brace: \n" +"`{` and `}`. Also called _curly brace_, they delimit _blocks_." +msgstr "" +"中かっこ（brace）: \n" +"`{` and `}`。ブロックを区切ります。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// The IRQ used by the PL031 RTC.\n" -msgstr "/// PL031 RTC が使用する IRQ。\n" +#: src/glossary.md +msgid "" +"build: \n" +"The process of converting source code into executable code or a usable " +"program." +msgstr "" +"ビルド（build）: \n" +"ソースコードを実行可能なコードまたは使用可能なプログラムに変換するプロセス。" -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/glossary.md msgid "" -"// Safe because `PL031_BASE_ADDRESS` is the base address of a PL031 device,\n" -" // and nothing else accesses that address range.\n" +"call: \n" +"To invoke or execute a function or method." msgstr "" -"// `PL031_BASE_ADDRESS` が PL031 デバイスのベースアドレスであり、\n" -" // それ以外はこのアドレス範囲にアクセスしないため、安全です。\n" +"呼び出し（call）: \n" +"関数またはメソッドを呼び出します。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "\"RTC: {time}\"" -msgstr "\"RTC: {time}\"" +#: src/glossary.md +msgid "" +"channel: \n" +"Used to safely pass messages [between threads](concurrency/channels.md)." +msgstr "" +"チャンネル（channel）: \n" +"[スレッド間](concurrency/channels.md) でメッセージを安全に渡すために使用され" +"ます。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "// Wait for 3 seconds, without interrupts.\n" -msgstr "// 割り込みなしで 3 秒間待機します。\n" +#: src/glossary.md +msgid "" +"Comprehensive Rust 🦀: \n" +"The courses here are jointly called Comprehensive Rust 🦀." +msgstr "" +"Comprehensive Rust 🦀: \n" +"このコースは、まとめて Comprehensive Rust 🦀 と呼びます。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "\"Waiting for {}\"" -msgstr "\"Waiting for {}\"" +#: src/glossary.md +msgid "" +"concurrency: \n" +"The execution of multiple tasks or processes at the same time." +msgstr "" +"同時実行（concurrency）: \n" +"複数のタスクまたはプロセスを同時に実行することを指します。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "\"matched={}, interrupt_pending={}\"" -msgstr "\"matched={}, interrupt_pending={}\"" +#: src/glossary.md +#, fuzzy +msgid "" +"Concurrency in Rust: \n" +"See [Concurrency in Rust](concurrency/welcome.md)." +msgstr "" +"Rust での同時実行（Concurrency in Rust）: \n" +"[Rust での同時実行](concurrency.md) をご覧ください。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "\"Finished waiting\"" -msgstr "\"Finished waiting\"" +#: src/glossary.md +msgid "" +"constant: \n" +"A value that does not change during the execution of a program." +msgstr "" +"定数（constant）: \n" +"プログラムの実行中に変更されない値。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "// Wait another 3 seconds for an interrupt.\n" -msgstr "// 割り込みまでさらに 3 秒待ちます。\n" +#: src/glossary.md +msgid "" +"control flow: \n" +"The order in which the individual statements or instructions are executed in " +"a program." +msgstr "" +"制御フロー（control flow）: \n" +"個々のステートメントまたは命令がプログラム内で実行される順序。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "_pl031.rs_:" -msgstr "_pl031.rs_:" +#: src/glossary.md +msgid "" +"crash: \n" +"An unexpected and unhandled failure or termination of a program." +msgstr "" +"クラッシュ（crash）: \n" +"予期しない制御不能なエラーまたは終了。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Data register\n" -msgstr "/// データレジスタ\n" +#: src/glossary.md +msgid "" +"enumeration: \n" +"A data type that holds one of several named constants, possibly with an " +"associated tuple or struct." +msgstr "" +"列挙型（enumeration）: \n" +"複数の名前付き定数のうちの 1 つを保持するデータ型。関連するタプルまたは構造体" +"を伴う場合があります。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Match register\n" -msgstr "/// 一致レジスタ\n" +#: src/glossary.md +msgid "" +"error: \n" +"An unexpected condition or result that deviates from the expected behavior." +msgstr "" +"エラー（error）: \n" +"想定された動作から逸脱した、予期しない条件または結果。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Load register\n" -msgstr "/// 読み込みレジスタ\n" +#: src/glossary.md +msgid "" +"error handling: \n" +"The process of managing and responding to errors that occur during program " +"execution." +msgstr "" +"エラー処理（error handling）: \n" +"プログラムの実行中に発生するエラーを管理し、それに対応するプロセス。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Control register\n" -msgstr "/// 制御レジスタ\n" +#: src/glossary.md +msgid "" +"exercise: \n" +"A task or problem designed to practice and test programming skills." +msgstr "" +"演習（exercise:）: \n" +"プログラミング スキルの向上とテストを目的としたタスクまたは問題。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Interrupt Mask Set or Clear register\n" -msgstr "/// 割り込みマスクセットまたはクリアレジスタ\n" +#: src/glossary.md +msgid "" +"function: \n" +"A reusable block of code that performs a specific task." +msgstr "" +"関数（function）: \n" +"特定のタスクを実行する再利用可能なコードブロック。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Raw Interrupt Status\n" -msgstr "/// 未加工の割り込みステータス\n" +#: src/glossary.md +msgid "" +"garbage collector: \n" +"A mechanism that automatically frees up memory occupied by objects that are " +"no longer in use." +msgstr "" +"ガベージ コレクタ（garbage collector）: \n" +"使用されなくなったオブジェクトが占有していたメモリを自動的に解放するメカニズ" +"ム。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Masked Interrupt Status\n" -msgstr "/// マスクされた割り込みステータス\n" +#: src/glossary.md +msgid "" +"generics: \n" +"A feature that allows writing code with placeholders for types, enabling " +"code reuse with different data types." +msgstr "" +"ジェネリクス（generics）: \n" +"型のプレースホルダを使用してコードを記述し、さまざまなデータ型でコードを再利" +"用できるようにする機能。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Interrupt Clear Register\n" -msgstr "/// 割り込みクリアレジスタ\n" +#: src/glossary.md +msgid "" +"immutable: \n" +"Unable to be changed after creation." +msgstr "" +"不変（immutable）: \n" +" 作成後に変更できないこと。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Driver for a PL031 real-time clock.\n" -msgstr "/// PL031 リアルタイム クロック用のドライバ。\n" +#: src/glossary.md +msgid "" +"integration test: \n" +"A type of test that verifies the interactions between different parts or " +"components of a system." +msgstr "" +"統合テスト（integration test）: \n" +"システムのさまざまな部分やコンポーネント間の相互作用を検証するテストの一種。" -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/glossary.md msgid "" -"/// Constructs a new instance of the RTC driver for a PL031 device at the\n" -" /// given base address.\n" -" ///\n" -" /// # Safety\n" -" ///\n" -" /// The given base address must point to the MMIO control registers of " -"a\n" -" /// PL031 device, which must be mapped into the address space of the " -"process\n" -" /// as device memory and not have any other aliases.\n" +"keyword: \n" +"A reserved word in a programming language that has a specific meaning and " +"cannot be used as an identifier." msgstr "" -"/// 指定されたベースアドレスに\n" -" /// PL031 デバイス用の RTC ドライバの新しいインスタンスを作成します。\n" -" ///\n" -" /// # 安全性\n" -" ///\n" -" /// 指定されたベースアドレスは PL031 デバイスの MMIO 制御レジスタを指して" -"いる必要があります。\n" -" /// これらはデバイスメモリとしてプロセスのアドレス空間に\n" -" /// マッピングされ、他のエイリアスはありません。\n" +"キーワード（keyword）: \n" +"特定の意味を持ち、識別子として使用できない、プログラミング言語の予約語。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Reads the current RTC value.\n" -msgstr "/// 現在の RTC 値を読み取ります。\n" +#: src/glossary.md +msgid "" +"library: \n" +"A collection of precompiled routines or code that can be used by programs." +msgstr "" +"ライブラリ（library）: \n" +"プログラムで使用できるプリコンパイル済みのルーチンまたはコードのコレクショ" +"ン。" -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/glossary.md msgid "" -"// Safe because we know that self.registers points to the control\n" -" // registers of a PL031 device which is appropriately mapped.\n" +"macro: \n" +"Rust macros can be recognized by a `!` in the name. Macros are used when " +"normal functions are not enough. A typical example is `format!`, which takes " +"a variable number of arguments, which isn't supported by Rust functions." msgstr "" -"// self.registers が、適切にマッピングされた PL031 デバイスのコントロール レ" -"ジスタを\n" -" // 指していることがわかっているため、安全です。\n" +"マクロ（macro）: \n" +"Rust マクロは名前に `!` を含めることで認識できます。マクロは、通常の関数では" +"不十分な場合に使用されます。典型的な例が `format!` です。これは可変長引数を取" +"りますが、Rust 関数ではサポートされていません。" -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/glossary.md msgid "" -"/// Writes a match value. When the RTC value matches this then an interrupt\n" -" /// will be generated (if it is enabled).\n" +"`main` function: \n" +"Rust programs start executing with the `main` function." msgstr "" -"/// 一致値を書き込みます。RTC 値がこれに一致すると、割り込みが生成されます\n" -" /// （割り込みが有効になっている場合）。\n" +"`main` 関数（`main` function）: \n" +"Rust プログラムの実行は `main` 関数で開始されます。" -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/glossary.md msgid "" -"/// Returns whether the match register matches the RTC value, whether or " -"not\n" -" /// the interrupt is enabled.\n" +"match: \n" +"A control flow construct in Rust that allows for pattern matching on the " +"value of an expression." msgstr "" -"/// 割り込みが有効になっているかどうかに関係なく、一致レジスタが RTC 値と\n" -" /// 一致するかどうかを返します。\n" +"一致（match）: \n" +"式の値に対するパターン マッチングを可能にする、Rust の制御フロー構造。" -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/glossary.md msgid "" -"/// Returns whether there is currently an interrupt pending.\n" -" ///\n" -" /// This should be true if and only if `matched` returns true and the\n" -" /// interrupt is masked.\n" +"memory leak: \n" +"A situation where a program fails to release memory that is no longer " +"needed, leading to a gradual increase in memory usage." msgstr "" -"/// 現在保留中の割り込みがあるかどうかを返します。\n" -" ///\n" -" /// これは `matched` が true を返し、割り込みがマスクされている場合にの" -"み\n" -" /// true になります。\n" +"メモリリーク（memory leak）: \n" +"プログラムで不要になったメモリの解放に失敗し、メモリ使用量が徐々に増加する状" +"況。" -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/glossary.md msgid "" -"/// Sets or clears the interrupt mask.\n" -" ///\n" -" /// When the mask is true the interrupt is enabled; when it is false " -"the\n" -" /// interrupt is disabled.\n" +"method: \n" +"A function associated with an object or a type in Rust." msgstr "" -"/// 割り込みマスクを設定またはクリアします。\n" -" ///\n" -" /// マスクが true の場合、割り込みは有効になります。false の場合、\n" -" /// 割り込みは無効になります。\n" +"メソッド（method）: \n" +"Rust のオブジェクトまたは型に関連付けられた関数。" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Clears a pending interrupt, if any.\n" -msgstr "/// 保留中の割り込みがあればクリアします。\n" +#: src/glossary.md +msgid "" +"module: \n" +"A namespace that contains definitions, such as functions, types, or traits, " +"to organize code in Rust." +msgstr "" +"モジュール（module）: \n" +"関数、型、トレイトなどの定義を含む名前空間。Rust でコードを整理するために使用" +"されます。" -#: src/concurrency.md -msgid "Welcome to Concurrency in Rust" -msgstr "Rustでの並行性へようこそ" +#: src/glossary.md +msgid "" +"move: \n" +"The transfer of ownership of a value from one variable to another in Rust." +msgstr "" +"移動（move）: \n" +"Rust である変数から別の変数に値の所有権を移動すること。" -#: src/concurrency.md +#: src/glossary.md msgid "" -"Rust has full support for concurrency using OS threads with mutexes and " -"channels." +"mutable: \n" +"A property in Rust that allows variables to be modified after they have been " +"declared." msgstr "" -"Rustはミューテックスとチャネルを用いてOSスレッドを扱う並行性を十分にサポート" -"しています。" +"可変（mutable）: \n" +"宣言後の変数の変更を可能にする Rust のプロパティ。" -#: src/concurrency.md +#: src/glossary.md msgid "" -"The Rust type system plays an important role in making many concurrency bugs " -"compile time bugs. This is often referred to as _fearless concurrency_ since " -"you can rely on the compiler to ensure correctness at runtime." +"ownership: \n" +"The concept in Rust that defines which part of the code is responsible for " +"managing the memory associated with a value." msgstr "" -"Rustの型システムは多くの並行性にまつわるバグをコンパイル時のバグにとどめると" -"いう点で、重要な役割を果たします。これは時に _fearless concurrency_ （「怖く" -"ない並行性」） と呼ばれます。なぜなら、コンパイラに実行時での正しさを保証する" -"ことをまかせてよいためです。" +"所有権（ownership）: \n" +"値に関連付けられたメモリの管理をコードのどの部分が担うかを定義する Rust の概" +"念。" -#: src/concurrency/threads.md -msgid "Rust threads work similarly to threads in other languages:" -msgstr "Rustのスレッドは他の言語のスレッドと似た挙動をします:" +#: src/glossary.md +msgid "" +"panic: \n" +"An unrecoverable error condition in Rust that results in the termination of " +"the program." +msgstr "" +"パニック（panic）: \n" +"プログラムの終了を引き起こす、Rust の回復不能なエラー状態。" -#: src/concurrency/threads.md -msgid "\"Count in thread: {i}!\"" -msgstr "\"Count in thread: {i}!\"" +#: src/glossary.md +msgid "" +"parameter: \n" +"A value that is passed into a function or method when it is called." +msgstr "" +"パラメータ（parameter）: \n" +"関数またはメソッドが呼び出されたときに渡される値。" -#: src/concurrency/threads.md -msgid "\"Main thread: {i}\"" -msgstr "\"Main thread: {i}\"" +#: src/glossary.md +msgid "" +"pattern: \n" +"A combination of values, literals, or structures that can be matched against " +"an expression in Rust." +msgstr "" +"パターン（pattern）: \n" +"Rust の式と照合できる値、リテラル、構造体の組み合わせ。" -#: src/concurrency/threads.md -msgid "Threads are all daemon threads, the main thread does not wait for them." +#: src/glossary.md +msgid "" +"payload: \n" +"The data or information carried by a message, event, or data structure." msgstr "" -"スレッドはすべてデーモンスレッドで、メインスレッドはそれらを待ちません。" +"ペイロード（payload）: \n" +"メッセージ、イベント、またはデータ構造体で保持されるデータまたは情報。" -#: src/concurrency/threads.md -msgid "Thread panics are independent of each other." -msgstr "スレッドパニックは互いに独立です。" +#: src/glossary.md +msgid "" +"program: \n" +"A set of instructions that a computer can execute to perform a specific task " +"or solve a particular problem." +msgstr "" +"プログラム（program）: \n" +"特定のタスクを実行したり、特定の問題を解決したりするためにコンピュータが実行" +"できる一連の命令。" -#: src/concurrency/threads.md -msgid "Panics can carry a payload, which can be unpacked with `downcast_ref`." +#: src/glossary.md +msgid "" +"programming language: \n" +"A formal system used to communicate instructions to a computer, such as Rust." msgstr "" -"パニックはペイロードを保持していることがあり、それは`downcast_ref`で展開可能" -"です。" +"プログラミング言語（programming language）: \n" +"コンピュータに命令を伝えるために使用される正式なシステム（Rust など）。" -#: src/concurrency/threads.md -#, fuzzy +#: src/glossary.md msgid "" -"Notice that the thread is stopped before it reaches 10 --- the main thread " -"is not waiting." +"receiver: \n" +"The first parameter in a Rust method that represents the instance on which " +"the method is called." msgstr "" -"スレッドはカウントが10に到達するまでに止められます。メインのスレッドは待機し" -"ません。" +"レシーバ（receiver）: \n" +"メソッドが呼び出されたインスタンスを表す Rust メソッドの最初のパラメータ。" -#: src/concurrency/threads.md +#: src/glossary.md msgid "" -"Use `let handle = thread::spawn(...)` and later `handle.join()` to wait for " -"the thread to finish." +"reference counting: \n" +"A memory management technique in which the number of references to an object " +"is tracked, and the object is deallocated when the count reaches zero." msgstr "" -"`let handle = thread::spawn(…)`と後に`handle.join()`を使って、スレッドが完了" -"するのを待ってみてください。" +"参照カウント（reference counting）: \n" +"オブジェクトへの参照の数をトラッキングし、カウントがゼロになるとオブジェクト" +"の割り当てを解除するメモリ管理技術。" -#: src/concurrency/threads.md -msgid "Trigger a panic in the thread, notice how this doesn't affect `main`." +#: src/glossary.md +msgid "" +"return: \n" +"A keyword in Rust used to indicate the value to be returned from a function." msgstr "" -"スレッド内でパニックを引き起こしてみて、それがどのように`main`に影響しないか" -"を観察してみてください。" +"戻り値（return）: \n" +"関数から返される値を示すために使用される Rust のキーワード。" -#: src/concurrency/threads.md +#: src/glossary.md msgid "" -"Use the `Result` return value from `handle.join()` to get access to the " -"panic payload. This is a good time to talk about [`Any`](https://doc.rust-" -"lang.org/std/any/index.html)." +"Rust: \n" +"A systems programming language that focuses on safety, performance, and " +"concurrency." msgstr "" -"`handle.join()`の返り値の`Result`を使って、パニックペイロードへのアクセスを得" -"てみてください。 これは[`Any`](https://doc.rust-lang.org/std/any/index.html)" -"について話すのに良いタイミングです。" +"Rust: \n" +"安全性、パフォーマンス、同時実行に重点を置いたシステム プログラミング言語。" -#: src/concurrency/scoped-threads.md -msgid "Normal threads cannot borrow from their environment:" -msgstr "通常のスレッドはそれらの環境から借用することはできません:" +#: src/glossary.md +#, fuzzy +msgid "" +"Rust Fundamentals: \n" +"Days 1 to 4 of this course." +msgstr "" +"Rust の基礎（Rust Fundamentals）: \n" +"このコースの 1～3 日目。" -#: src/concurrency/scoped-threads.md +#: src/glossary.md msgid "" -"However, you can use a [scoped thread](https://doc.rust-lang.org/std/thread/" -"fn.scope.html) for this:" +"Rust in Android: \n" +"See [Rust in Android](android.md)." msgstr "" -"しかし、そのために[スコープ付きスレッド](https://doc.rust-lang.org/std/" -"thread/fn.scope.html)を使うことができます:" +"Android での Rust（Rust in Android）: \n" +"[Android での Rust](android.md) をご覧ください。" -#: src/concurrency/scoped-threads.md +#: src/glossary.md msgid "" -"The reason for that is that when the `thread::scope` function completes, all " -"the threads are guaranteed to be joined, so they can return borrowed data." +"Rust in Chromium: \n" +"See [Rust in Chromium](chromium.md)." msgstr "" -"この理由は、関数`thread::scope`が完了するとき、全てのスレッドはjoinされること" -"が保証されているので、スレッドが借用したデータを返すことができるためです。" +"Chromium での Rust（Rust in Chromium）: \n" +"[Chromium での Rust](chromium.md) をご覧ください。" -#: src/concurrency/scoped-threads.md +#: src/glossary.md msgid "" -"Normal Rust borrowing rules apply: you can either borrow mutably by one " -"thread, or immutably by any number of threads." +"safe: \n" +"Refers to code that adheres to Rust's ownership and borrowing rules, " +"preventing memory-related errors." msgstr "" -"通常のRustの借用のルールが適用されます:　一つのスレッドがミュータブルで借用す" -"ること、または任意の数のスレッドからイミュータブルで借用すること。" +"安全（safe）: \n" +"Rust の所有権と借用に関するルールに従って、メモリ関連のエラーを防止するコード" +"を指します。" -#: src/concurrency/channels.md +#: src/glossary.md msgid "" -"Rust channels have two parts: a `Sender` and a `Receiver`. The two " -"parts are connected via the channel, but you only see the end-points." +"scope: \n" +"The region of a program where a variable is valid and can be used." msgstr "" -"Rustのチャネルには二つの部品があります： `Sender` と`Receiver`です。こ" -"の２つの部品はチャネルによって繋がっていますが、見ることができるのはエンドポ" -"イントだけです。" - -#: src/concurrency/channels.md -msgid "\"Received: {:?}\"" -msgstr "\"Received: {:?}\"" +"スコープ（scope）: \n" +"変数が有効かつ使用可能なプログラムの領域。" -#: src/concurrency/channels.md +#: src/glossary.md msgid "" -"`mpsc` stands for Multi-Producer, Single-Consumer. `Sender` and `SyncSender` " -"implement `Clone` (so you can make multiple producers) but `Receiver` does " -"not." +"standard library: \n" +"A collection of modules providing essential functionality in Rust." msgstr "" -"`mpsc` は Multi-Producer, Single-Consumerの略称です。 `Sender`と`SyncSender`" -"は`Clone`を実装している（よって複数のproducerが作成可能）のですが、`Receiver`" -"についてはそうではありません。" +"標準ライブラリ（standard library）: \n" +"Rust の必須機能を提供するモジュールのコレクション。" -#: src/concurrency/channels.md +#: src/glossary.md msgid "" -"`send()` and `recv()` return `Result`. If they return `Err`, it means the " -"counterpart `Sender` or `Receiver` is dropped and the channel is closed." +"static: \n" +"A keyword in Rust used to define static variables or items with a `'static` " +"lifetime." msgstr "" -"`send()`と`recv()`は`Result`を返します。もし`Err`が返された場合、これは、対応" -"する`Sender`か`Receiver`のいずれかがドロップされ、チャンネルが閉じられたこと" -"を意味します。" - -#: src/concurrency/channels/unbounded.md -msgid "You get an unbounded and asynchronous channel with `mpsc::channel()`:" -msgstr "Unboundedで非同期的なチャネルは`mpsc::channel()`によって得られます：" - -#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md -msgid "\"Message {i}\"" -msgstr "\"Message {i}\"" - -#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md -msgid "\"{thread_id:?}: sent Message {i}\"" -msgstr "\"{thread_id:?}: sent Message {i}\"" - -#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md -msgid "\"{thread_id:?}: done\"" -msgstr "\"{thread_id:?}: done\"" - -#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md -msgid "\"Main: got {msg}\"" -msgstr "\"Main: got {msg}\"" +"静的（static）: \n" +"静的な変数や `'static` ライフタイムを持つアイテムを定義するために使用される " +"Rust のキーワード。" -#: src/concurrency/channels/bounded.md +#: src/glossary.md +#, fuzzy msgid "" -"With bounded (synchronous) channels, `send` can block the current thread:" +"string: \n" +"A data type storing textual data. See [Strings](references/strings.html) for " +"more." msgstr "" -"Bounded（かつ同期的）なチャネルを用いたとき、`send`は現在のスレッドをブロック" -"することがあります：" +"文字列（string）: \n" +"テキストデータを格納するデータ型。詳しくは、[`String` と `str`](basic-syntax/" +"string-slices.html) をご覧ください。" -#: src/concurrency/channels/bounded.md +#: src/glossary.md msgid "" -"Calling `send` will block the current thread until there is space in the " -"channel for the new message. The thread can be blocked indefinitely if there " -"is nobody who reads from the channel." +"struct: \n" +"A composite data type in Rust that groups together variables of different " +"types under a single name." msgstr "" -"`send`を呼んだときにチャネルに空きがなければ、現在のスレッドはブロックされま" -"す。もし誰もチャネルから値を読み取らない場合は、このスレッドは無期限にブロッ" -"クされることがあります。" +"構造体（struct）: \n" +"異なる型の変数を 1 つの名前でグループ化する Rust の複合データ型。" -#: src/concurrency/channels/bounded.md +#: src/glossary.md msgid "" -"A call to `send` will abort with an error (that is why it returns `Result`) " -"if the channel is closed. A channel is closed when the receiver is dropped." +"test: \n" +"A Rust module containing functions that test the correctness of other " +"functions." msgstr "" -"もしもチャネルが閉じられた場合、`send`の呼び出しはエラーとともに中断します。" -"（`send`が`Result`を返すのはこのためです。）受け取り側がドロップされたとき" -"に、チャネルは閉じられます。" +"テスト（test）: \n" +"他の関数の正しさをテストする関数を含む Rust モジュール。" -#: src/concurrency/channels/bounded.md +#: src/glossary.md msgid "" -"A bounded channel with a size of zero is called a \"rendezvous channel\". " -"Every send will block the current thread until another thread calls `read`." +"thread: \n" +"A separate sequence of execution in a program, allowing concurrent execution." msgstr "" -"サイズが０のBoundedチャネルは「ランデブーチャネル」と呼ばれます。別のスレッド" -"が`read`を呼ぶまでは、それぞれのsendは現在のスレッドをブロックします。" +"スレッド（thread）: \n" +"同時実行を可能にする、プログラム内の独立した実行シーケンス。" -#: src/concurrency/send-sync.md -#, fuzzy +#: src/glossary.md msgid "" -"How does Rust know to forbid shared access across threads? The answer is in " -"two traits:" +"thread safety: \n" +"The property of a program that ensures correct behavior in a multithreaded " +"environment." msgstr "" -"Rustはどのようにスレッド間での値の共有アクセスを禁止するのでしょうか？その答" -"えとなるのが、以下の２つのトレイトです：" +"スレッドセーフ（thread safety）: \n" +"マルチスレッド環境で正しい動作を保証するプログラムの特性。" -#: src/concurrency/send-sync.md +#: src/glossary.md msgid "" -"[`Send`](https://doc.rust-lang.org/std/marker/trait.Send.html): a type `T` " -"is `Send` if it is safe to move a `T` across a thread boundary." +"trait: \n" +"A collection of methods defined for an unknown type, providing a way to " +"achieve polymorphism in Rust." msgstr "" -"[`Send`](https://doc.rust-lang.org/std/marker/trait.Send.html): スレッド境界" -"をまたいでの型`T`のムーブが安全に行える場合、型`T`は`Send`である。" +"トレイト（trait）: \n" +"未知の型に対して定義されたメソッドのコレクション。Rust でポリモーフィズムを実" +"現する方法を提供します。" -#: src/concurrency/send-sync.md +#: src/glossary.md msgid "" -"[`Sync`](https://doc.rust-lang.org/std/marker/trait.Sync.html): a type `T` " -"is `Sync` if it is safe to move a `&T` across a thread boundary." +"trait bound: \n" +"An abstraction where you can require types to implement some traits of your " +"interest." msgstr "" -"[`Sync`](https://doc.rust-lang.org/std/marker/trait.Sync.html): スレッド境界" -"をまたいで`&T`のムーブが安全に行える場合、型`T`は`Sync`である。" +"トレイト境界（trait bound）: \n" +"特定のトレイトを実装するために型を要求できる抽象化。" -#: src/concurrency/send-sync.md +#: src/glossary.md msgid "" -"`Send` and `Sync` are [unsafe traits](../unsafe/unsafe-traits.md). The " -"compiler will automatically derive them for your types as long as they only " -"contain `Send` and `Sync` types. You can also implement them manually when " -"you know it is valid." +"tuple: \n" +"A composite data type that contains variables of different types. Tuple " +"fields have no names, and are accessed by their ordinal numbers." msgstr "" -"`Send`と`Sync`は[unsafeなトレイト](../unsafe/unsafe-traits.md)です。 あなたが" -"新たに定義する型が`Send`と`Sync`の型のみを含む場合、コンパイラはその新しい型" -"に対して`Send`と`Sync`を自動的に導出します。そうでなくても妥当であるならば" -"`Send`と`Sync`を自分自身で実装することもできます。" +"タプル（tuple）: \n" +"さまざまな型の変数を含む複合データ型。タプル フィールドには名前がなく、序数で" +"アクセスします。" -#: src/concurrency/send-sync.md +#: src/glossary.md msgid "" -"One can think of these traits as markers that the type has certain thread-" -"safety properties." +"type: \n" +"A classification that specifies which operations can be performed on values " +"of a particular kind in Rust." msgstr "" -"これらのトレイトは、ある型が特定のスレッドセーフの特性を持っていることを示す" -"マーカーと考えることもできます。" +"型（type）: \n" +"Rust の特定の種類の値に対してどのオペレーションを実行できるかを指定する分類。" -#: src/concurrency/send-sync.md -msgid "They can be used in the generic constraints as normal traits." +#: src/glossary.md +msgid "" +"type inference: \n" +"The ability of the Rust compiler to deduce the type of a variable or " +"expression." msgstr "" -"これらは通常のトレイトと同じように、ジェネリック境界の中で利用することができ" -"ます。" +"型推論（type inference）: \n" +"変数または式の型を推測する Rust コンパイラの機能。" -#: src/concurrency/send-sync/send.md +#: src/glossary.md msgid "" -"A type `T` is [`Send`](https://doc.rust-lang.org/std/marker/trait.Send.html) " -"if it is safe to move a `T` value to another thread." +"undefined behavior: \n" +"Actions or conditions in Rust that have no specified result, often leading " +"to unpredictable program behavior." msgstr "" -"型`T`の値を安全に別のスレッドにムーブできる場合、型`T`は[`Send`](https://doc." -"rust-lang.org/std/marker/trait.Send.html)である。" +"未定義の動作（undefined behavior）: \n" +"結果が指定されていない Rust のアクションまたは条件。多くの場合、プログラムの" +"予測不能な動作を引き起こします。" -#: src/concurrency/send-sync/send.md +#: src/glossary.md msgid "" -"The effect of moving ownership to another thread is that _destructors_ will " -"run in that thread. So the question is when you can allocate a value in one " -"thread and deallocate it in another." +"union: \n" +"A data type that can hold values of different types but only one at a time." msgstr "" -"所有権を別のスレットにムーブするということは、_デストラクタ_ がそのスレッドで" -"実行されるということです。つまり、あるスレッドでアロケートされた値を別のス" -"レッドで解放しても良いかというのが判断基準になります。" +"共用体（union）: \n" +"異なる型の値を一度に 1 つだけ保持できるデータ型。" -#: src/concurrency/send-sync/send.md +#: src/glossary.md msgid "" -"As an example, a connection to the SQLite library must only be accessed from " -"a single thread." +"unit test: \n" +"Rust comes with built-in support for running small unit tests and larger " +"integration tests. See [Unit Tests](testing/unit-tests.html)." msgstr "" -"例を挙げると、SQLiteライブラリへのコネクションは、一つのスレッドからのみアク" -"セスされる必要があります。" +"単体テスト（unit test）: \n" +"Rust には、小規模な単体テストと大規模な統合テストを実行するための組み込みサ" +"ポートが付属しています。[単体テスト](testing/unit-tests.html) をご覧くださ" +"い。" -#: src/concurrency/send-sync/sync.md +#: src/glossary.md msgid "" -"A type `T` is [`Sync`](https://doc.rust-lang.org/std/marker/trait.Sync.html) " -"if it is safe to access a `T` value from multiple threads at the same time." +"unit type: \n" +"Type that holds no data, written as a tuple with no members." msgstr "" -"型`T`の値を複数のスレッドから同時にアクセスしても安全な場合、型`T`は [`Sync`]" -"(https://doc.rust-lang.org/std/marker/trait.Sync.html) である。" - -#: src/concurrency/send-sync/sync.md -msgid "More precisely, the definition is:" -msgstr "より正確には、以下のような定義です：" - -#: src/concurrency/send-sync/sync.md -msgid "`T` is `Sync` if and only if `&T` is `Send`" -msgstr "`&T`が`Send`である場合、かつその場合に限り、`T`は`Sync`である" +"ユニット型（unit type）: \n" +"データを保持しない型。メンバーのないタプルとして記述されます。" -#: src/concurrency/send-sync/sync.md +#: src/glossary.md +#, fuzzy msgid "" -"This statement is essentially a shorthand way of saying that if a type is " -"thread-safe for shared use, it is also thread-safe to pass references of it " -"across threads." +"unsafe: \n" +"The subset of Rust which allows you to trigger _undefined behavior_. See " +"[Unsafe Rust](unsafe-rust/unsafe.md)." msgstr "" -"これはつまり、「ある型の共有がスレッドセーフであれば、その参照をスレッド間で" -"受け渡すこともスレッドセーフである」ということを手短に表したものです。" +"安全でない（unsafe）: \n" +"未定義の動作をトリガーできる Rust のサブセット。[安全でない Rust](unsafe." +"html) をご覧ください。" -#: src/concurrency/send-sync/sync.md +#: src/glossary.md msgid "" -"This is because if a type is Sync it means that it can be shared across " -"multiple threads without the risk of data races or other synchronization " -"issues, so it is safe to move it to another thread. A reference to the type " -"is also safe to move to another thread, because the data it references can " -"be accessed from any thread safely." +"variable: \n" +"A memory location storing data. Variables are valid in a _scope_." msgstr "" -"なぜなら、ある型がSyncである場合、データ競合や他の同期の問題などのリスクなし" -"にその型を複数のスレッド間で共有でき、その型を別のスレッドにムーブしても安全" -"だからです。また、型への参照は別のスレッドにムーブしても安全です。それは、そ" -"れが参照するデータは任意のスレッドから安全にアクセスすることができるからで" -"す。" - -#: src/concurrency/send-sync/examples.md -msgid "`Send + Sync`" -msgstr "`Send + Sync`" - -#: src/concurrency/send-sync/examples.md -msgid "Most types you come across are `Send + Sync`:" -msgstr "見かけるほとんどの型は`Send + Sync`です：" - -#: src/concurrency/send-sync/examples.md -msgid "`i8`, `f32`, `bool`, `char`, `&str`, ..." -msgstr "`i8`、`f32`、`bool`、`char`、`&str` など" - -#: src/concurrency/send-sync/examples.md -msgid "`(T1, T2)`, `[T; N]`, `&[T]`, `struct { x: T }`, ..." -msgstr "`(T1, T2)`、`[T; N]`、`&[T]`、`struct { x: T }` など" +"変数（variable）: \n" +"データを格納するメモリの場所。変数はスコープ内で有効です。" -#: src/concurrency/send-sync/examples.md -msgid "`String`, `Option`, `Vec`, `Box`, ..." -msgstr "`String`、`Option`、`Vec`、`Box` など" +#: src/other-resources.md +msgid "Other Rust Resources" +msgstr "Rust のその他のリソース" -#: src/concurrency/send-sync/examples.md -msgid "`Arc`: Explicitly thread-safe via atomic reference count." -msgstr "`Arc`: アトミック参照カウントにより、明示的にスレッドセーフ。" +#: src/other-resources.md +msgid "" +"The Rust community has created a wealth of high-quality and free resources " +"online." +msgstr "" +"Rust コミュニティは、高品質な無料のリソースをオンラインで多数提供しています。" -#: src/concurrency/send-sync/examples.md -msgid "`Mutex`: Explicitly thread-safe via internal locking." -msgstr "`Mutex`: 内部ロックにより明示的にスレッドセーフ。" +#: src/other-resources.md +msgid "Official Documentation" +msgstr "正式なドキュメント" -#: src/concurrency/send-sync/examples.md -msgid "`AtomicBool`, `AtomicU8`, ...: Uses special atomic instructions." -msgstr "`AtomicBool`, `AtomicU8`, …: 特別なアトミック命令を利用。" +#: src/other-resources.md +msgid "The Rust project hosts many resources. These cover Rust in general:" +msgstr "" +"Rust プロジェクトは多くのリソースをホストしており、これらは Rust 全般に対応し" +"ています。" -#: src/concurrency/send-sync/examples.md +#: src/other-resources.md msgid "" -"The generic types are typically `Send + Sync` when the type parameters are " -"`Send + Sync`." +"[The Rust Programming Language](https://doc.rust-lang.org/book/): the " +"canonical free book about Rust. Covers the language in detail and includes a " +"few projects for people to build." msgstr "" -"ジェネリクスは、型パラメタが`Send + Sync`であるとき、通常は`Send + Sync`で" -"す。" - -#: src/concurrency/send-sync/examples.md -msgid "`Send + !Sync`" -msgstr "`Send + !Sync`" +"[The Rust Programming Language](https://doc.rust-lang.org/book/): Rust の標準" +"的な書籍で、無料で利用できます。Rust について詳しく説明されているほか、ビルド" +"できるプロジェクトがいくつか含まれています。" -#: src/concurrency/send-sync/examples.md +#: src/other-resources.md msgid "" -"These types can be moved to other threads, but they're not thread-safe. " -"Typically because of interior mutability:" +"[Rust By Example](https://doc.rust-lang.org/rust-by-example/): covers the " +"Rust syntax via a series of examples which showcase different constructs. " +"Sometimes includes small exercises where you are asked to expand on the code " +"in the examples." msgstr "" -"これらの型は別のスレッドにムーブすることができますが、このようなムーブはス" -"レッドセーフではありません。通常は内部可変性がその原因です：" - -#: src/concurrency/send-sync/examples.md -msgid "`mpsc::Sender`" -msgstr "`mpsc::Sender`" +"[Rust By Example](https://doc.rust-lang.org/rust-by-example/): さまざまな構造" +"を示す一連のサンプルを使用して、Rust の構文を解説しています。小規模な演習がい" +"くつか用意されており、そこでサンプルのコードを拡張するよう求められます。" -#: src/concurrency/send-sync/examples.md -msgid "`mpsc::Receiver`" -msgstr "`mpsc::Receiver`" +#: src/other-resources.md +msgid "" +"[Rust Standard Library](https://doc.rust-lang.org/std/): full documentation " +"of the standard library for Rust." +msgstr "" +"[Rust Standard Library](https://doc.rust-lang.org/std/): Rust の標準ライブラ" +"リの完全なドキュメントです。" -#: src/concurrency/send-sync/examples.md -msgid "`Cell`" -msgstr "`Cell`" +#: src/other-resources.md +msgid "" +"[The Rust Reference](https://doc.rust-lang.org/reference/): an incomplete " +"book which describes the Rust grammar and memory model." +msgstr "" +"[The Rust Reference](https://doc.rust-lang.org/reference/): Rust の文法とメモ" +"リモデルについて説明している未完成の書籍です。" -#: src/concurrency/send-sync/examples.md -msgid "`RefCell`" -msgstr "`RefCell`" +#: src/other-resources.md +msgid "More specialized guides hosted on the official Rust site:" +msgstr "Rust の公式サイトでホストされている、より専門的なガイド:" -#: src/concurrency/send-sync/examples.md -msgid "`!Send + Sync`" -msgstr "`!Send + Sync`" +#: src/other-resources.md +msgid "" +"[The Rustonomicon](https://doc.rust-lang.org/nomicon/): covers unsafe Rust, " +"including working with raw pointers and interfacing with other languages " +"(FFI)." +msgstr "" +"[The Rustonomicon](https://doc.rust-lang.org/nomicon/): 未加工のポインタの操" +"作や、他の言語（FFI）とのやり取りなど、安全でない Rust について説明していま" +"す。" -#: src/concurrency/send-sync/examples.md +#: src/other-resources.md msgid "" -"These types are thread-safe, but they cannot be moved to another thread:" +"[Asynchronous Programming in Rust](https://rust-lang.github.io/async-book/): " +"covers the new asynchronous programming model which was introduced after the " +"Rust Book was written." msgstr "" -"このような型はスレッドセーフですが、別のスレッドにムーブすることはできませ" -"ん：" +"[Asynchronous Programming in Rust](https://rust-lang.github.io/async-book/): " +"Rust Book の執筆後に導入された新しい非同期プログラミング モデルについて説明し" +"ています。" -#: src/concurrency/send-sync/examples.md -#, fuzzy +#: src/other-resources.md msgid "" -"`MutexGuard`: Uses OS level primitives which must be deallocated on " -"the thread which created them." +"[The Embedded Rust Book](https://doc.rust-lang.org/stable/embedded-book/): " +"an introduction to using Rust on embedded devices without an operating " +"system." msgstr "" -"`MutexGuard`: プリミティブを作成したスレッド自身により、割り当てを解除され" -"るべきであるようなOSレベルのプリミティブを利用。" +"[The Embedded Rust Book](https://doc.rust-lang.org/stable/embedded-book/): オ" +"ペレーティング システムのない組み込みデバイスで Rust を使用する方法を紹介して" +"います。" -#: src/concurrency/send-sync/examples.md -msgid "`!Send + !Sync`" -msgstr "`!Send + !Sync`" +#: src/other-resources.md +msgid "Unofficial Learning Material" +msgstr "非公式の学習教材" -#: src/concurrency/send-sync/examples.md -msgid "These types are not thread-safe and cannot be moved to other threads:" -msgstr "" -"このような型はスレッドセーフではないため、別のスレッドにムーブすることはでき" -"ません：" +#: src/other-resources.md +msgid "A small selection of other guides and tutorial for Rust:" +msgstr "Rust に関するその他のガイドとチュートリアル:" -#: src/concurrency/send-sync/examples.md +#: src/other-resources.md msgid "" -"`Rc`: each `Rc` has a reference to an `RcBox`, which contains a non-" -"atomic reference count." +"[Learn Rust the Dangerous Way](http://cliffle.com/p/dangerust/): covers Rust " +"from the perspective of low-level C programmers." msgstr "" -"`Rc`: それぞれの `Rc` は`RcBox`への参照を持っています。これは、アト" -"ミックでない参照カウントを持っています。" +"[Learn Rust the Dangerous Way](http://cliffle.com/p/dangerust/): 高度な知識を" +"持たない C プログラマーの視点で Rust を解説しています。" -#: src/concurrency/send-sync/examples.md +#: src/other-resources.md +#, fuzzy msgid "" -"`*const T`, `*mut T`: Rust assumes raw pointers may have special concurrency " -"considerations." +"[Rust for Embedded C Programmers](https://opentitan.org/book/doc/" +"rust_for_c_devs.html): covers Rust from the perspective of developers who " +"write firmware in C." msgstr "" -"`*const T`, `*mut T`: Rust は、生ポインターは同時実行性に関する特別な考慮事項" -"がある可能性があることを仮定しています。" +"[Rust for Embedded C Programmers](https://docs.opentitan.org/doc/ug/" +"rust_for_c/): ファームウェアを C で記述するデベロッパーの観点から Rust を解説" +"しています。" -#: src/concurrency/shared_state.md +#: src/other-resources.md msgid "" -"Rust uses the type system to enforce synchronization of shared data. This is " -"primarily done via two types:" +"[Rust for professionals](https://overexact.com/rust-for-professionals/): " +"covers the syntax of Rust using side-by-side comparisons with other " +"languages such as C, C++, Java, JavaScript, and Python." msgstr "" -"Rustは共有データを確実に同期するために型システムを利用します。これは主に2つの" -"型により行われます：" +"[Rust for professionals](https://overexact.com/rust-for-professionals/): 他の" +"言語（C、C++、Java、JavaScript、Python など）と並べて比較しながら、Rust の構" +"文について説明しています。" -#: src/concurrency/shared_state.md +#: src/other-resources.md msgid "" -"[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html), atomic " -"reference counted `T`: handles sharing between threads and takes care to " -"deallocate `T` when the last reference is dropped," +"[Rust on Exercism](https://exercism.org/tracks/rust): 100+ exercises to help " +"you learn Rust." msgstr "" -"[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html), atomic " -"reference counted `T` : スレッド間の共有を扱い、最後の参照がドロップされたと" -"き `T` をデアロケートすることを担当する、" +"[Rust on Exercism](https://exercism.org/tracks/rust): Rust の学習に役立つ " +"100 以上の演習が用意されています。" -#: src/concurrency/shared_state.md +#: src/other-resources.md msgid "" -"[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html): ensures " -"mutually exclusive access to the `T` value." +"[Ferrous Teaching Material](https://ferrous-systems.github.io/teaching-" +"material/index.html): a series of small presentations covering both basic " +"and advanced part of the Rust language. Other topics such as WebAssembly, " +"and async/await are also covered." msgstr "" -"[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html): `T`型の値" -"への相互排他的なアクセスを保証する。" +"[Ferrous Teaching Material](https://ferrous-systems.github.io/teaching-" +"material/index.html): Rust 言語の基本的な部分と高度な部分の両方をカバーした、" +"一連のコンパクトなプレゼンテーションです。WebAssembly、async / await などの他" +"のトピックも扱っています。" -#: src/concurrency/shared_state/arc.md +#: src/other-resources.md msgid "" -"[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html) allows shared " -"read-only access via `Arc::clone`:" +"[Advanced testing for Rust applications](https://rust-exercises.com/advanced-" +"testing/): a self-paced workshop that goes beyond Rust's built-in testing " +"framework. It covers `googletest`, snapshot testing, mocking as well as how " +"to write your own custom test harness." msgstr "" -"[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html) は読み取り専用" -"の共有アクセスを`Arc::clone`により可能にします：" -#: src/concurrency/shared_state/arc.md -msgid "\"{thread_id:?}: {v:?}\"" -msgstr "\"{thread_id:?}: {v:?}\"" - -#: src/concurrency/shared_state/arc.md src/concurrency/shared_state/example.md -msgid "\"v: {v:?}\"" -msgstr "\"v: {v:?}\"" - -#: src/concurrency/shared_state/arc.md +#: src/other-resources.md msgid "" -"`Arc` stands for \"Atomic Reference Counted\", a thread safe version of `Rc` " -"that uses atomic operations." +"[Beginner's Series to Rust](https://docs.microsoft.com/en-us/shows/beginners-" +"series-to-rust/) and [Take your first steps with Rust](https://docs." +"microsoft.com/en-us/learn/paths/rust-first-steps/): two Rust guides aimed at " +"new developers. The first is a set of 35 videos and the second is a set of " +"11 modules which covers Rust syntax and basic constructs." msgstr "" -"`Arc` は\"Atomic Reference Counted\"の略で、アトミック操作を利用するという点" -"で、`Rc`がスレッド安全になったバージョンのようなものです。" +"[Beginner's Series to Rust](https://docs.microsoft.com/ja-jp/shows/beginners-" +"series-to-rust/) および [Take your first steps with Rust](https://docs." +"microsoft. com/en-us/learn/paths/rust-first-steps/): 初心者のデベロッパーを対" +"象とした 2 つの Rust ガイドです。1 つ目は 35 個の動画で構成され、2 つ目は " +"Rust の構文と基本的な構造を説明する 11 のモジュールで構成されています。" -#: src/concurrency/shared_state/arc.md +#: src/other-resources.md msgid "" -"`Arc` implements `Clone` whether or not `T` does. It implements `Send` " -"and `Sync` if and only if `T` implements them both." +"[Learn Rust With Entirely Too Many Linked Lists](https://rust-unofficial." +"github.io/too-many-lists/): in-depth exploration of Rust's memory management " +"rules, through implementing a few different types of list structures." msgstr "" -"`Arc` は `Clone` を実装します。このことは`T`が`Clone`を実装するしないに関" -"係ありません。`T`が`Send`と`Sync`の両方を実装している場合で、かつその場合に限" -"り、`Arc` は両者を実装します。" +"[Learn Rust With Entirely Too Many Linked Lists](https://rust-unofficial." +"github.io/too-many-lists/): いくつかの異なるタイプのリスト構造の実装を通じ" +"て、Rust のメモリ管理ルールを深く掘り下げています。" -#: src/concurrency/shared_state/arc.md +#: src/other-resources.md msgid "" -"`Arc::clone()` has the cost of atomic operations that get executed, but " -"after that the use of the `T` is free." +"Please see the [Little Book of Rust Books](https://lborb.github.io/book/) " +"for even more Rust books." msgstr "" -"`Arc::clone()`にはアトミック操作のコストがかかります。ただ、その後は、`T`の利" -"用に関するコストはかかりません。" +"Rust に関するその他の書籍については、[Little Book of Rust Books](https://" +"lborb.github.io/book/) をご覧ください。" -#: src/concurrency/shared_state/arc.md +#: src/credits.md msgid "" -"Beware of reference cycles, `Arc` does not use a garbage collector to detect " -"them." +"The material here builds on top of the many great sources of Rust " +"documentation. See the page on [other resources](other-resources.md) for a " +"full list of useful resources." msgstr "" -"参照サイクルに気をつけてください。`Arc` には参照サイクルを検知するためのガ" -"ベージコレクタはありません。" - -#: src/concurrency/shared_state/arc.md -msgid "`std::sync::Weak` can help." -msgstr "`std::sync::Weak` が役立ちます。" +"ここで紹介する教材は、多くの優れた Rust ドキュメントのソースに基づいていま" +"す。役立つリソースの一覧については、[その他のリソース](other-resources.md) の" +"ページをご覧ください。" -#: src/concurrency/shared_state/mutex.md +#: src/credits.md msgid "" -"[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html) ensures " -"mutual exclusion _and_ allows mutable access to `T` behind a read-only " -"interface (another form of [interior mutability](../../borrowing/interior-" -"mutability)):" +"The material of Comprehensive Rust is licensed under the terms of the Apache " +"2.0 license, please see [`LICENSE`](https://github.com/google/comprehensive-" +"rust/blob/main/LICENSE) for details." msgstr "" -"[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html) は相互排他" -"を保証し、 _かつ_ 読み取り専用のインターフェースの裏側で `T` へのミュータブル" -"なアクセスを可能にします：" +"Comprehensive Rust の教材は、Apache 2.0 ライセンスの規約により使用が許諾され" +"ています。詳細については、[`LICENSE`](https://github.com/google/" +"comprehensive-rust/blob/main/LICENSE) をご覧ください。" -#: src/concurrency/shared_state/mutex.md -msgid "\"v: {:?}\"" -msgstr "\"v: {:?}\"" +#: src/credits.md +msgid "Rust by Example" +msgstr "Rust by Example" -#: src/concurrency/shared_state/mutex.md +#: src/credits.md msgid "" -"Notice how we have a [`impl Sync for Mutex`](https://doc.rust-" -"lang.org/std/sync/struct.Mutex.html#impl-Sync-for-Mutex%3CT%3E) blanket " -"implementation." +"Some examples and exercises have been copied and adapted from [Rust by " +"Example](https://doc.rust-lang.org/rust-by-example/). Please see the " +"`third_party/rust-by-example/` directory for details, including the license " +"terms." msgstr "" -"[`impl Sync for Mutex`](https://doc.rust-lang.org/std/sync/" -"struct.Mutex.html#impl-Sync-for-Mutex%3CT%3E) のブランケット実装があることに" -"注目してください。" +"一部の例と演習は、[Rust by Example](https://doc.rust-lang.org/rust-by-" +"example/) からコピーして編集したものです。ライセンス規約などの詳細について" +"は、`third_party/rust-by-example/` ディレクトリを参照してください。" -#: src/concurrency/shared_state/mutex.md -msgid "" -"`Mutex` in Rust looks like a collection with just one element --- the " -"protected data." -msgstr "" -"Rustにおける`Mutex`とは、保護されるデータである、たった一つの要素から構成され" -"たコレクションのようなものです。" +#: src/credits.md +msgid "Rust on Exercism" +msgstr "Rust on Exercism" -#: src/concurrency/shared_state/mutex.md +#: src/credits.md msgid "" -"It is not possible to forget to acquire the mutex before accessing the " -"protected data." +"Some exercises have been copied and adapted from [Rust on Exercism](https://" +"exercism.org/tracks/rust). Please see the `third_party/rust-on-exercism/` " +"directory for details, including the license terms." msgstr "" -"保護されたデータにアクセスする前に、ミューテックスを確保し忘れることはありま" -"せん。" +"一部の演習は、[Rust on Exercism](https://exercism.org/tracks/rust) をコピーし" +"て編集したものです。ライセンス規約などの詳細については、`third_party/rust-on-" +"exercism/` ディレクトリを参照してください。" -#: src/concurrency/shared_state/mutex.md -msgid "" -"You can get an `&mut T` from an `&Mutex` by taking the lock. The " -"`MutexGuard` ensures that the `&mut T` doesn't outlive the lock being held." -msgstr "" -"`&Mutex` からロックを取得することで、`&mut T`を得ることができます。この" -"`MutexGuard`は`&mut T`が保持されているロックよりも長く存続しないことを保証し" -"ます。" +#: src/credits.md +msgid "CXX" +msgstr "CXX" -#: src/concurrency/shared_state/mutex.md +#: src/credits.md msgid "" -"`Mutex` implements both `Send` and `Sync` iff (if and only if) `T` " -"implements `Send`." +"The [Interoperability with C++](android/interoperability/cpp.md) section " +"uses an image from [CXX](https://cxx.rs/). Please see the `third_party/cxx/` " +"directory for details, including the license terms." msgstr "" -"`T`が`Send`を実装している場合で、かつその場合に限り、`Mutex` は`Send`と" -"`Sync`の両方を実装します。" +"[C++ との相互運用性](android/interoperability/cpp.md) セクションでは、[CXX]" +"(https://cxx.rs/) の画像を使用しています。ライセンス規約などの詳細について" +"は、`third_party/cxx/` ディレクトリを参照してください。" -#: src/concurrency/shared_state/mutex.md -msgid "A read-write lock counterpart: `RwLock`." -msgstr "読み書きのロックの場合に対応するものがあります： `RwLock`。" +#~ msgid "Conditionals" +#~ msgstr "条件文" -#: src/concurrency/shared_state/mutex.md -msgid "Why does `lock()` return a `Result`?" -msgstr "なぜ`lock()`は`Result`を返すのでしょう？" +#, fuzzy +#~ msgid "Slices and Lifetimes" +#~ msgstr "ライフタイム" -#: src/concurrency/shared_state/mutex.md -msgid "" -"If the thread that held the `Mutex` panicked, the `Mutex` becomes " -"\"poisoned\" to signal that the data it protected might be in an " -"inconsistent state. Calling `lock()` on a poisoned mutex fails with a " -"[`PoisonError`](https://doc.rust-lang.org/std/sync/struct.PoisonError.html). " -"You can call `into_inner()` on the error to recover the data regardless." -msgstr "" -"Mutex`を保持したスレッドがパニックを起こした場合、保護すべきデータが整合性の" -"欠けた状態にある可能性を伝えるため、`Mutex`は「ポイゾンされた」" -"（\"poisoned\"）状態になります。ポイゾンされたMutexに対して `lock()` をコール" -"すると、[`PoisonError`](https://doc.rust-lang.org/std/sync/struct." -"PoisonError.html)とともに失敗します。`into_inner()` を用いることで、そのエ" -"ラーにおいて、とりあえずデータを回復することはできます。" +#~ msgid "String References" +#~ msgstr "Stringの参照" -#: src/concurrency/shared_state/example.md -msgid "Let us see `Arc` and `Mutex` in action:" -msgstr "`Arc` と `Mutex` の動作を見てみましょう：" +#~ msgid "Control Flow" +#~ msgstr "制御フロー" -#: src/concurrency/shared_state/example.md -msgid "// use std::sync::{Arc, Mutex};\n" -msgstr "// use std::sync::{Arc, Mutex};\n" +#~ msgid "Day 1 Morning (3 hours, including breaks)" +#~ msgstr "1 日目の午前（休憩を含めて 3 時間）" -#: src/concurrency/shared_state/example.md -msgid "Possible solution:" -msgstr "考えられる対処法：" +#~ msgid "[Welcome](../welcome-day-1.md) (5 minutes)" +#~ msgstr "[ようこそ](../welcome-day-1.md)（5 分）" -#: src/concurrency/shared_state/example.md -msgid "Notable parts:" -msgstr "注目するとよい箇所：" +#~ msgid "[Hello, World](../hello-world.md) (20 minutes)" +#~ msgstr "[Hello, World](../hello-world.md)（20 分）" -#: src/concurrency/shared_state/example.md -msgid "" -"`v` is wrapped in both `Arc` and `Mutex`, because their concerns are " -"orthogonal." -msgstr "" -"`v`は `Arc` と `Mutex`の両方でラップされています。なぜなら、それらの関心は互" -"いに独立なものであるからです。" +#~ msgid "[Types and Values](../types-and-values.md) (1 hour and 5 minutes)" +#~ msgstr "[型と値](../types-and-values.md)（1 時間 5 分）" -#: src/concurrency/shared_state/example.md -msgid "" -"Wrapping a `Mutex` in an `Arc` is a common pattern to share mutable state " -"between threads." -msgstr "" -"`Mutex`を`Arc`でラップすることは、スレッド間でミュータブルな状態を共有するた" -"めによく見られるパターンです。" +#~ msgid "[Control Flow Basics](../control-flow-basics.md) (1 hour)" +#~ msgstr "[制御フローの基本](../control-flow-basics.md)（1 時間）" -#: src/concurrency/shared_state/example.md -msgid "" -"`v: Arc<_>` needs to be cloned as `v2` before it can be moved into another " -"thread. Note `move` was added to the lambda signature." -msgstr "" -"`v: Arc<_>`は別のスレッドにムーブされる前に、`v2`としてクローンされる必要があ" -"ります。`move` がラムダ式に追加されたことに注意してください。" +#~ msgid "[Tuples and Arrays](../tuples-and-arrays.md) (1 hour)" +#~ msgstr "[タプルと配列](../tuples-and-arrays.md)（1 時間）" -#: src/concurrency/shared_state/example.md -msgid "" -"Blocks are introduced to narrow the scope of the `LockGuard` as much as " -"possible." -msgstr "" -"ブロックは`LockGuard`のスコープを可能な限り狭めるために導入されています。" +#~ msgid "[References](../references.md) (50 minutes)" +#~ msgstr "[参照](../references.md)（50 分）" -#: src/exercises/concurrency/morning.md -msgid "Let us practice our new concurrency skills with" -msgstr "次の演習を行い、並行性に関する新しいスキルを獲得しましょう。" +#~ msgid "[User-Defined Types](../user-defined-types.md) (50 minutes)" +#~ msgstr "[ユーザー定義型](../user-defined-types.md)（50 分）" -#: src/exercises/concurrency/morning.md -msgid "Dining philosophers: a classic problem in concurrency." -msgstr "食事する哲学者：並行性に関する古典的な問題。" +#~ msgid "[Welcome](../welcome-day-2.md) (3 minutes)" +#~ msgstr "[ようこそ](../welcome-day-2.md)（3 分）" -#: src/exercises/concurrency/morning.md -msgid "" -"Multi-threaded link checker: a larger project where you'll use Cargo to " -"download dependencies and then check links in parallel." -msgstr "" -"マルチスレッド リンク チェッカー: Cargo を使用して依存関係をダウンロードし、" -"リンクを同時にチェックする大規模なプロジェクト。" +#~ msgid "[Pattern Matching](../pattern-matching.md) (50 minutes)" +#~ msgstr "[パターン マッチング](../pattern-matching.md)（50 分）" -#: src/exercises/concurrency/dining-philosophers.md -msgid "The dining philosophers problem is a classic problem in concurrency:" -msgstr "食事する哲学者の問題は、並行性に関する古典的な問題です。" +#~ msgid "[Methods and Traits](../methods-and-traits.md) (55 minutes)" +#~ msgstr "[メソッドとトレイト](../methods-and-train.md)（55 分）" -#: src/exercises/concurrency/dining-philosophers.md -msgid "" -"Five philosophers dine together at the same table. Each philosopher has " -"their own place at the table. There is a fork between each plate. The dish " -"served is a kind of spaghetti which has to be eaten with two forks. Each " -"philosopher can only alternately think and eat. Moreover, a philosopher can " -"only eat their spaghetti when they have both a left and right fork. Thus two " -"forks will only be available when their two nearest neighbors are thinking, " -"not eating. After an individual philosopher finishes eating, they will put " -"down both forks." -msgstr "" -"5 人の哲学者が同じテーブルで食事をしています。それぞれの哲学者がテーブルの定" -"位置に座り、皿の間にはフォークが 1 本置かれています。提供される料理はスパゲッ" -"ティで、2 本のフォークで食べる必要があります。哲学者は思索と食事を交互に繰り" -"返すことしかできません。さらに、哲学者は左右両方のフォークを持っている場合に" -"のみ、スパゲッティを食べることができます。したがって、2 つのフォークは、両隣" -"の哲学者が食べるのではなく考えている場合にのみ使用できます。それぞれの哲学者" -"は、食べ終わった後、両方のフォークを置きます。" +#~ msgid "[Generics](../generics.md) (45 minutes)" +#~ msgstr "[ジェネリクス](../generics.md)（45 分）" -#: src/exercises/concurrency/dining-philosophers.md -msgid "" -"You will need a local [Cargo installation](../../cargo/running-locally.md) " -"for this exercise. Copy the code below to a file called `src/main.rs`, fill " -"out the blanks, and test that `cargo run` does not deadlock:" -msgstr "" -"この演習では、ローカルの [Cargo インストール](../../cargo/running-locally.md)" -"が必要です。以下のコードを `src/main.rs` というファイルにコピーし、空欄を埋め" -"て、`cargo run` がデッドロックしないことを確認します。" +#~ msgid "Day 2 Afternoon (3 hours, including breaks)" +#~ msgstr "2 日目の午後（休憩を含めて 3 時間）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/dining-philosophers-async.md -msgid "" -"// left_fork: ...\n" -" // right_fork: ...\n" -" // thoughts: ...\n" -msgstr "" -"// left_fork: ...\n" -" // right_fork: ...\n" -" // thoughts: ...\n" +#~ msgid "[Standard Library Types](../std-types.md) (1 hour and 10 minutes)" +#~ msgstr "[標準ライブラリ型](../std-types.md)（1 時間 10 分）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/solutions-morning.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"Eureka! {} has a new idea!\"" -msgstr "\"Eureka! {} has a new idea!\"" +#~ msgid "[Standard Library Traits](../std-traits.md) (1 hour and 40 minutes)" +#~ msgstr "[標準ライブラリ トレイト](../std-train.md)（1 時間 40 分）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Pick up forks...\n" -msgstr "// Pick up forks...\n" +#~ msgid "[Welcome](../welcome-day-3.md) (3 minutes)" +#~ msgstr "[ようこそ](../welcome-day-3.md)（3 分）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/solutions-morning.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"{} is eating...\"" -msgstr "\"{} is eating...\"" +#~ msgid "[Memory Management](../memory-management.md) (1 hour and 10 minutes)" +#~ msgstr "[メモリ管理](../memory-management.md)（1 時間 10 分）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/solutions-morning.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"Socrates\"" -msgstr "\"Socrates\"" +#~ msgid "[Smart Pointers](../smart-pointers.md) (45 minutes)" +#~ msgstr "[スマート ポインタ](../smart-pointers.md)（45 分）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/solutions-morning.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"Hypatia\"" -msgstr "\"Hypatia\"" +#~ msgid "[Borrowing](../borrowing.md) (1 hour)" +#~ msgstr "[借用](../borrowing.md)（1 時間）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/solutions-morning.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"Plato\"" -msgstr "\"Plato\"" +#~ msgid "" +#~ "[Slices and Lifetimes](../slices-and-lifetimes.md) (1 hour and 10 minutes)" +#~ msgstr "" +#~ "[スライスとライフタイム](../slices-and-lifetimes.md)（1 時間 10 分）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/solutions-morning.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"Aristotle\"" -msgstr "\"Aristotle\"" +#~ msgid "[Welcome](../welcome-day-4.md) (3 minutes)" +#~ msgstr "[ようこそ](../welcome-day-4.md)（3 分）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/solutions-morning.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"Pythagoras\"" -msgstr "\"Pythagoras\"" +#~ msgid "[Iterators](../iterators.md) (45 minutes)" +#~ msgstr "[イテレータ](../iterators.md)（45 分）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Create forks\n" -msgstr "// フォークを作成する\n" +#~ msgid "[Modules](../modules.md) (40 minutes)" +#~ msgstr "[モジュール](../modules.md)（40 分）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Create philosophers\n" -msgstr "// 哲学者を作成する\n" +#~ msgid "[Testing](../testing.md) (1 hour and 5 minutes)" +#~ msgstr "[テスト](../testing.md)（1 時間 5 分）" -#: src/exercises/concurrency/dining-philosophers.md -msgid "// Make each of them think and eat 100 times\n" -msgstr "// それぞれの哲学者が思索と食事を 100 回行うようにする\n" +#~ msgid "Day 4 Afternoon (2 hours, including breaks)" +#~ msgstr "4 日目の午後（休憩を含めて 2 時間）" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Output their thoughts\n" -msgstr "// 哲学者の思索を出力する\n" +#~ msgid "[Error Handling](../error-handling.md) (45 minutes)" +#~ msgstr "[エラー処理](../error-handling.md)（45 分）" -#: src/exercises/concurrency/dining-philosophers.md -msgid "You can use the following `Cargo.toml`:" -msgstr "次の `Cargo.toml` を使用できます。" +#~ msgid "[Unsafe Rust](../unsafe-rust.md) (1 hour and 5 minutes)" +#~ msgstr "[Unsafe Rust](../unsafe-rust.md)（1 時間 5 分）" -#: src/exercises/concurrency/dining-philosophers.md -msgid "" -"```toml\n" -"[package]\n" -"name = \"dining-philosophers\"\n" -"version = \"0.1.0\"\n" -"edition = \"2021\"\n" -"```" -msgstr "" -"```toml\n" -"[package]\n" -"name = \"dining-philosophers\"\n" -"version = \"0.1.0\"\n" -"edition = \"2021\"\n" -"```" +#~ msgid "Arrow-Left" +#~ msgstr "Arrow-Left" -#: src/exercises/concurrency/link-checker.md -msgid "" -"Let us use our new knowledge to create a multi-threaded link checker. It " -"should start at a webpage and check that links on the page are valid. It " -"should recursively check other pages on the same domain and keep doing this " -"until all pages have been validated." -msgstr "" -"新たに身に付けた知識を活かして、マルチスレッド リンク チェッカーを作成しま" -"しょう。まず、ウェブページ上のリンクが有効かどうかを確認する必要があります。" -"同じドメインの他のページを再帰的にチェックし、すべてのページの検証が完了する" -"までこの処理を繰り返します。" +#~ msgid "Arrow-Right" +#~ msgstr "Arrow-Right" -#: src/exercises/concurrency/link-checker.md -msgid "" -"For this, you will need an HTTP client such as [`reqwest`](https://docs.rs/" -"reqwest/). Create a new Cargo project and `reqwest` it as a dependency with:" -msgstr "" -"そのためには、[`reqwest`](https://docs.rs/reqwest/) などの HTTP クライアント" -"が必要です。次のコマンドで新しい Cargo プロジェクトを作成し、依存関係として " -"`reqwest` を追加します。" +#~ msgid "Ctrl + Enter" +#~ msgstr "Ctrl + Enter" -#: src/exercises/concurrency/link-checker.md -msgid "" -"If `cargo add` fails with `error: no such subcommand`, then please edit the " -"`Cargo.toml` file by hand. Add the dependencies listed below." -msgstr "" -"`cargo add` が `error: no such subcommand` で失敗する場合は、`Cargo.toml` " -"ファイルを手動で編集してください。下記の依存関係を追加します。" +#~ msgid "s" +#~ msgstr "s" -#: src/exercises/concurrency/link-checker.md -msgid "" -"You will also need a way to find links. We can use [`scraper`](https://docs." -"rs/scraper/) for that:" -msgstr "" -"また、リンクを見つける方法も必要です。これには [`scraper`](https://docs.rs/" -"scraper/) を使用します。" +#~ msgid "You can use " +#~ msgstr "ボックス内にフォーカスがある状態で" -#: src/exercises/concurrency/link-checker.md -msgid "" -"Finally, we'll need some way of handling errors. We use [`thiserror`]" -"(https://docs.rs/thiserror/) for that:" -msgstr "" -"最後に、エラーを処理する方法が必要になります。これには [`thiserror`](https://" -"docs.rs/thiserror/) を使用します。" +#~ msgid "In this session:" +#~ msgstr "このセッションの内容:" + +#~ msgid "[Welcome](./welcome-day-1.md) (5 minutes)" +#~ msgstr "[ようこそ](./welcome-day-1.md)（5 分）" + +#~ msgid "[Hello, World](./hello-world.md) (20 minutes)" +#~ msgstr "[Hello, World](./hello-world.md)（20 分）" + +#~ msgid "[Types and Values](./types-and-values.md) (1 hour and 5 minutes)" +#~ msgstr "[型と値](./types-and-values.md)（1 時間 5 分）" + +#~ msgid "[Control Flow Basics](./control-flow-basics.md) (1 hour)" +#~ msgstr "[制御フローの基本](./control-flow-basics.md)（1 時間）" + +#~ msgid "Including 10 minute breaks, this session should take about 3 hours" +#~ msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 3 時間です。" + +#~ msgid "In this segment:" +#~ msgstr "このセグメントの内容:" + +#~ msgid "[What is Rust?](./hello-world/what-is-rust.md) (10 minutes)" +#~ msgstr "[Rust とは](./hello-world/what-is-rust.md)（10 分）" -#: src/exercises/concurrency/link-checker.md -msgid "" -"The `cargo add` calls will update the `Cargo.toml` file to look like this:" -msgstr "" -"`cargo add` の呼び出しにより、`Cargo.toml` ファイルは次のように更新されます。" +#~ msgid "[Hello, World](./hello-world/hello-world.md) (5 minutes)" +#~ msgstr "[Hello, World](./hello-world/hello-world.md)（5 分）" -#: src/exercises/concurrency/link-checker.md -msgid "" -"```toml\n" -"[package]\n" -"name = \"link-checker\"\n" -"version = \"0.1.0\"\n" -"edition = \"2021\"\n" -"publish = false\n" -"\n" -"[dependencies]\n" -"reqwest = { version = \"0.11.12\", features = [\"blocking\", \"rustls-" -"tls\"] }\n" -"scraper = \"0.13.0\"\n" -"thiserror = \"1.0.37\"\n" -"```" -msgstr "" -"```toml\n" -"[package]\n" -"name = \"link-checker\"\n" -"version = \"0.1.0\"\n" -"edition = \"2021\"\n" -"publish = false\n" -"\n" -"[dependencies]\n" -"reqwest = { version = \"0.11.12\", features = [\"blocking\", \"rustls-" -"tls\"] }\n" -"scraper = \"0.13.0\"\n" -"thiserror = \"1.0.37\"\n" -"```" +#~ msgid "[Benefits of Rust](./hello-world/benefits.md) (3 minutes)" +#~ msgstr "[Rust のメリット](./hello-world/benefits.md)（3 分）" -#: src/exercises/concurrency/link-checker.md -msgid "" -"You can now download the start page. Try with a small site such as `https://" -"www.google.org/`." -msgstr "" -"これで、スタートページをダウンロードできるようになりました。`https://www." -"google.org/` のような小規模なサイトで試してみましょう。" +#~ msgid "[Playground](./hello-world/playground.md) (2 minutes)" +#~ msgstr "[プレイグラウンド](./hello-world/playground.md)（2 分）" -#: src/exercises/concurrency/link-checker.md -msgid "Your `src/main.rs` file should look something like this:" -msgstr "`src/main.rs` ファイルは次のようになります。" +#~ msgid "[Variables](./types-and-values/variables.md) (5 minutes)" +#~ msgstr "[変数](./types-and-values/variables.md)（5 分）" -#: src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"request error: {0}\"" -msgstr "\"request error: {0}\"" +#~ msgid "[Values](./types-and-values/values.md) (10 minutes)" +#~ msgstr "[値](./types-and-values/values.md)（10 分）" -#: src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"bad http response: {0}\"" -msgstr "\"bad http response: {0}\"" +#~ msgid "[Arithmetic](./types-and-values/arithmetic.md) (5 minutes)" +#~ msgstr "[算術](./types-and-values/arithmetic.md)（5 分）" -#: src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"Checking {:#}\"" -msgstr "\"Checking {:#}\"" +#~ msgid "[Strings](./types-and-values/strings.md) (10 minutes)" +#~ msgstr "[文字列](./types-and-values/strings.md)（10 分）" -#: src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"href\"" -msgstr "\"href\"" +#~ msgid "[Type Inference](./types-and-values/inference.md) (5 minutes)" +#~ msgstr "[型推論](./types-and-values/inference.md)（5 分）" -#: src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"On {base_url:#}: ignored unparsable {href:?}: {err}\"" -msgstr "\"On {base_url:#}: ignored unparsable {href:?}: {err}\"" +#~ msgid "[Exercise: Fibonacci](./types-and-values/exercise.md) (30 minutes)" +#~ msgstr "[演習: フィボナッチ](./types-and-values/exercise.md)（30 分）" -#: src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"https://www.google.org\"" -msgstr "\"https://www.google.org\"" +#~ msgid "" +#~ "Rust has two types to represent strings, both of which will be covered in " +#~ "more depth later. Both _always_ store UTF-8 encoded strings." +#~ msgstr "" +#~ "Rust には文字列を表す 2 つの型があります。どちらも後ほど詳しく説明します。" +#~ "両方とも、 _常に_ UTF-8 でエンコードされた文字列を格納します。" -#: src/exercises/concurrency/link-checker.md -msgid "\"Links: {links:#?}\"" -msgstr "\"Links: {links:#?}\"" +#~ msgid "`String` - a modifiable, owned string." +#~ msgstr "`String` - 変更可能で、所有権をもつ文字列。" -#: src/exercises/concurrency/link-checker.md -msgid "\"Could not extract links: {err:#}\"" -msgstr "\"Could not extract links: {err:#}\"" +#~ msgid "`&str` - a read-only string. String literals have this type." +#~ msgstr "`&str` - 読み取り専用の文字列。文字列リテラルはこの型です。" -#: src/exercises/concurrency/link-checker.md -msgid "Run the code in `src/main.rs` with" -msgstr "`src/main.rs` 内のコードを、次のコマンドで実行します。" +#~ msgid "\"🪐\"" +#~ msgstr "\"🪐\"" -#: src/exercises/concurrency/link-checker.md -msgid "" -"Use threads to check the links in parallel: send the URLs to be checked to a " -"channel and let a few threads check the URLs in parallel." -msgstr "" -"スレッドを使用してリンクを同時にチェックします。つまり、チェックする URL を" -"チャンネルに送信し、いくつかのスレッドで同時に URL を確認します。" +#~ msgid "\", \"" +#~ msgstr "\", \"" -#: src/exercises/concurrency/link-checker.md -msgid "" -"Extend this to recursively extract links from all pages on the `www.google." -"org` domain. Put an upper limit of 100 pages or so so that you don't end up " -"being blocked by the site." -msgstr "" -"これを拡張して、`www.google.org` ドメインのすべてのページからリンクを再帰的に" -"抽出します。サイトがブロックされないように、ページ数の上限を 100 程度に設定し" -"ます。" +#~ msgid "\"final sentence: {}\"" +#~ msgstr "\"final sentence: {}\"" -#: src/exercises/concurrency/solutions-morning.md -msgid "Concurrency Morning Exercise" -msgstr "並行性に関する午前のエクササイズ" +#~ msgid "//println!(\"{:?}\", &sentence[12..13]);\n" +#~ msgstr "//println!(\"{:?}\", &sentence[12..13]);\n" -#: src/exercises/concurrency/solutions-morning.md -msgid "([back to exercise](dining-philosophers.md))" -msgstr "（[演習に戻る](dining-philosophers.md)）" +#~ msgid "" +#~ "This slide introduces strings. Everything here will be covered in more " +#~ "depth later, but this is enough for subsequent slides and exercises to " +#~ "use strings." +#~ msgstr "" +#~ "このスライドでは文字列を紹介します。ここで取り上げた内容については後ほど詳" +#~ "しく説明しますが、以降のスライドや演習で文字列を使用するにはこれで十分で" +#~ "す。" -#: src/exercises/concurrency/solutions-morning.md -msgid "\"{} is trying to eat\"" -msgstr "\"{} is trying to eat\"" +#~ msgid "Invalid UTF-8 in a string is UB, and this not allowed in safe Rust." +#~ msgstr "文字列内の無効な UTF-8 は UB であり、Safe Rust では許可されません。" -#: src/exercises/concurrency/solutions-morning.md -msgid "" -"// To avoid a deadlock, we have to break the symmetry\n" -" // somewhere. This will swap the forks without deinitializing\n" -" // either of them.\n" -msgstr "" -"// デッドロックを避けるために、どこかで対称性を\n" -" // 崩す必要があります。下記のコードでは、\n" -" // 領域を開放することなく2つのフォークを交換します。\n" +#~ msgid "" +#~ "`String` is a user-defined type with a constructor (`::new()`) and " +#~ "methods like `s.push_str(..)`." +#~ msgstr "" +#~ "`String` は、コンストラクタ（`::new()` と `s.push_str(..)` などのメソッ" +#~ "ド）を持つユーザー定義型です。" -#: src/exercises/concurrency/solutions-morning.md -msgid "\"{thought}\"" -msgstr "\"{thought}\"" +#~ msgid "" +#~ "The `&` in `&str` indicates that this is a reference. We will cover " +#~ "references later, so for now just think of `&str` as a unit meaning \"a " +#~ "read-only string\"." +#~ msgstr "" +#~ "`&str` 内の `&` は、これが参照であることを示します。参照については後ほど説" +#~ "明しますので、ここでは `&str` を、「読み取り専用の文字列」を意味する単位と" +#~ "考えてください。" -#: src/exercises/concurrency/solutions-morning.md -#, fuzzy -msgid "Link Checker" -msgstr "マルチスレッド・リンクチェッカー" +#~ msgid "" +#~ "The commented-out line is indexing into the string by byte position. " +#~ "`12..13` does not end on a character boundary, so the program panics. " +#~ "Adjust it to a range that does, based on the error message." +#~ msgstr "" +#~ "コメントアウトされた行は、バイト位置で文字列をインデックス化しています。" +#~ "`12..13` は文字境界で終わっていないため、プログラムはパニックします。エ" +#~ "ラー メッセージに基づいて、適切な範囲に調整してください。" -#: src/exercises/concurrency/solutions-morning.md -msgid "([back to exercise](link-checker.md))" -msgstr "（[演習に戻る](link-checker.md)）" +#~ msgid "[Conditionals](./control-flow-basics/conditionals.md) (5 minutes)" +#~ msgstr "[条件文](./control-flow-basics/conditionals.md)（5 分）" -#: src/exercises/concurrency/solutions-morning.md -msgid "" -"/// Determine whether links within the given page should be extracted.\n" -msgstr "/// 指定されたページ内のリンクを抽出するかどうかを決定します。\n" +#~ msgid "[Loops](./control-flow-basics/loops.md) (5 minutes)" +#~ msgstr "[ループ](./control-flow-basics/loops.md)（5 分）" -#: src/exercises/concurrency/solutions-morning.md -msgid "" -"/// Mark the given page as visited, returning false if it had already\n" -" /// been visited.\n" -msgstr "" -"/// 指定されたページを訪問済みとしてマークし、すでに訪問済みであれば\n" -" /// false を返します。\n" +#~ msgid "" +#~ "[break and continue](./control-flow-basics/break-continue.md) (5 minutes)" +#~ msgstr "" +#~ "[break と continue](./control-flow-basics/break-continue.md)（5 分）" -#: src/exercises/concurrency/solutions-morning.md -msgid "// The sender got dropped. No more commands coming in.\n" -msgstr "// 送信者がドロップされました。今後コマンドは受信されません。\n" +#~ msgid "" +#~ "[Blocks and Scopes](./control-flow-basics/blocks-and-scopes.md) (10 " +#~ "minutes)" +#~ msgstr "" +#~ "[ブロックとスコープ](./control-flow-basics/blocks-and-scopes.md)（10 分）" -#: src/exercises/concurrency/solutions-morning.md -msgid "\"Got crawling error: {:#}\"" -msgstr "\"Got crawling error: {:#}\"" +#~ msgid "[Functions](./control-flow-basics/functions.md) (3 minutes)" +#~ msgstr "[関数](./control-flow-basics/functions.md)（3 分）" -#: src/exercises/concurrency/solutions-morning.md -msgid "\"Bad URLs: {:#?}\"" -msgstr "\"Bad URLs: {:#?}\"" +#~ msgid "[Macros](./control-flow-basics/macros.md) (2 minutes)" +#~ msgstr "[マクロ](./control-flow-basics/macros.md)（2 分）" -#: src/async.md -msgid "Async Rust" -msgstr "Asyncの基礎" +#~ msgid "" +#~ "[Exercise: Collatz Sequence](./control-flow-basics/exercise.md) (30 " +#~ "minutes)" +#~ msgstr "[演習: コラッツ数列](./control-flow-basics/exercise.md)（30 分）" -#: src/async.md -msgid "" -"\"Async\" is a concurrency model where multiple tasks are executed " -"concurrently by executing each task until it would block, then switching to " -"another task that is ready to make progress. The model allows running a " -"larger number of tasks on a limited number of threads. This is because the " -"per-task overhead is typically very low and operating systems provide " -"primitives for efficiently identifying I/O that is able to proceed." -msgstr "" -"「Async」は複数のタスクが並行処理される並行性モデルです。それぞれのタスクはブ" -"ロックされるまで実行され、そして次に進むことのできる他のタスクに切り替えるこ" -"とにより実現されます。このモデルは限られた数のスレッド上でより多くのタスクを" -"実行することを可能にします。なぜなら、タスクごとのオーバーヘッドは通常はとて" -"も低く、効率的に実行可能なI/Oを特定するために必要なプリミティブをOSが提供して" -"くれるからです。" +#~ msgid "Much of the Rust syntax will be familiar to you from C, C++ or Java:" +#~ msgstr "Rust の構文の多くは、C、C++、Java で見覚えがあるでしょう。" -#: src/async.md -msgid "" -"Rust's asynchronous operation is based on \"futures\", which represent work " -"that may be completed in the future. Futures are \"polled\" until they " -"signal that they are complete." -msgstr "" -"Rustの非同期的な操作は「future」に基づいていて、これは将来に完了するかもしれ" -"ない作業を表しています。Futureは、タスクが完了したことを知らせるシグナルが得" -"られるまでポーリングされます。" +#, fuzzy +#~ msgid "Blocks are delimited by curly braces." +#~ msgstr "CやC++と同様に、ブロックは波括弧で囲みます。" -#: src/async.md -msgid "" -"Futures are polled by an async runtime, and several different runtimes are " -"available." -msgstr "" -"Futureは非同期的なランタイムによりポーリングされます。ランタイムにはいくつか" -"の選択肢があります。" +#~ msgid "" +#~ "Line comments are started with `//`, block comments are delimited by `/" +#~ "* ... */`." +#~ msgstr "" +#~ "行コメントは `//` で始まり、ブロック コメントは `/* ... */` で区切られま" +#~ "す。" -#: src/async.md -msgid "" -"Python has a similar model in its `asyncio`. However, its `Future` type is " -"callback-based, and not polled. Async Python programs require a \"loop\", " -"similar to a runtime in Rust." -msgstr "" -"Pythonには似たようなモデルが`asyncio`として搭載されています。しかし、ここでの" -"`Future`型はコールバックに基づくものであって、ポーリングによるものではありま" -"せん。Pythonの非同期プログラムは「ループ」を必要とし、Rustのランタイムに似て" -"います。" +#~ msgid "Keywords like `if` and `while` work the same." +#~ msgstr "`if` や `while` などのキーワードの動作は同じです。" -#: src/async.md -msgid "" -"JavaScript's `Promise` is similar, but again callback-based. The language " -"runtime implements the event loop, so many of the details of Promise " -"resolution are hidden." -msgstr "" -"JavaScriptの`Promise`は似ているものの、これもまたもやコールバックに基づきま" -"す。 この言語のランタイムはイベントループにより実装されているため、多くの" -"Promise解決の詳細は隠されています。" +#~ msgid "Variable assignment is done with `=`, comparison is done with `==`." +#~ msgstr "変数の代入は `=` で行われ、比較は `==` で行われます。" -#: src/async/async-await.md -msgid "" -"At a high level, async Rust code looks very much like \"normal\" sequential " -"code:" -msgstr "" -"おおまかには、Rustの非同期コードはほとんど「通常の」逐次的なコードのように見" -"えます:" +#~ msgid "" +#~ "We will discuss iteration later; for now, just stick to range expressions." +#~ msgstr "" +#~ "反復処理については後で説明しますので、ここでは範囲式だけに注目してくださ" +#~ "い。" -#: src/async/async-await.md -msgid "\"Count is: {i}!\"" -msgstr "\"Count is: {i}!\"" +#~ msgid "\"{result}\"" +#~ msgstr "\"{result}\"" -#: src/async/async-await.md -msgid "" -"Note that this is a simplified example to show the syntax. There is no long " -"running operation or any real concurrency in it!" -msgstr "" -"これは構文を示すための単純化された例であることに注意してください。長く実行さ" -"れうる操作や本物の並行処理はここには含まれません。" +#~ msgid "\"x: {x}, i: {i}\"" +#~ msgstr "\"x: {x}, i: {i}\"" -#: src/async/async-await.md -msgid "What is the return type of an async call?" -msgstr "非同期の呼び出しの返り値の型は？" +#~ msgid "" +#~ "In this case we break the outer loop after 3 iterations of the inner loop." +#~ msgstr "" +#~ "上の例では、内側のループを 3 回イテレーションしたのちに外側のループを抜け" +#~ "ることになります。" -#: src/async/async-await.md -msgid "Use `let future: () = async_main(10);` in `main` to see the type." -msgstr "" -"型を知るために`main`で`let future: () = async_main(10);`を使ってみてくださ" -"い。" +#~ msgid "1" +#~ msgstr "1" -#: src/async/async-await.md -#, fuzzy -msgid "" -"The \"async\" keyword is syntactic sugar. The compiler replaces the return " -"type with a future." -msgstr "" -"「async」キーワードは糖衣構文です。コンパイラは返り値をfutureに置き換えます。" +#~ msgid " greater than zero:" +#~ msgstr " に対して、次のように定義されます。" -#: src/async/async-await.md -msgid "" -"You cannot make `main` async, without additional instructions to the " -"compiler on how to use the returned future." -msgstr "" -"コンパイラに対して、返されたfutureの値をその後どう扱うべきかという、追加の指" -"示を含めない限り、`main`をasyncにすることはできません。" +#~ msgid "If _n" +#~ msgstr "_n" -#: src/async/async-await.md -#, fuzzy -msgid "" -"You need an executor to run async code. `block_on` blocks the current thread " -"until the provided future has run to completion." -msgstr "" -"非同期のコードを実行するためには、エグゼキュータが必要です。`block_on`は、与" -"えられたfutureが最後まで実行されるまで、現在のスレッドをブロックします。" +#~ msgid "i" +#~ msgstr "i" -#: src/async/async-await.md -msgid "" -"`.await` asynchronously waits for the completion of another operation. " -"Unlike `block_on`, `.await` doesn't block the current thread." -msgstr "" -"`.await`は非同期的に他の操作の完了を待ちます。`block_on`とは異なり、`.await`" -"は現在のスレッドをブロックしません。" +#~ msgid "_." +#~ msgstr "_で終了します。" -#: src/async/async-await.md -#, fuzzy -msgid "" -"`.await` can only be used inside an `async` function (or block; these are " -"introduced later)." -msgstr "" -"`.await`はasync関数(またはasync ブロック)の中でのみ利用できます。(async関数・" -"ブロックについては後ほど紹介します。)" +#~ msgid "_ is even, then _n" +#~ msgstr "_ が偶数の場合、_n" -#: src/async/futures.md -msgid "" -"[`Future`](https://doc.rust-lang.org/std/future/trait.Future.html) is a " -"trait, implemented by objects that represent an operation that may not be " -"complete yet. A future can be polled, and `poll` returns a [`Poll`](https://" -"doc.rust-lang.org/std/task/enum.Poll.html)." -msgstr "" -"[`Future`](https://doc.rust-lang.org/std/future/trait.Future.html)はトレイト" -"であり、まだ完了してないかもしれない操作を表現するオブジェクトにより実装され" -"ます。Futureはポーリングされることがあり、`poll`は[`Poll`](https://doc.rust-" -"lang.org/std/task/enum.Poll.html)を返します。" +#~ msgid "i+1" +#~ msgstr "i+1" -#: src/async/futures.md -msgid "" -"An async function returns an `impl Future`. It's also possible (but " -"uncommon) to implement `Future` for your own types. For example, the " -"`JoinHandle` returned from `tokio::spawn` implements `Future` to allow " -"joining to it." -msgstr "" -"非同期の関数は`impl Future`を返します。自分で定義した型に対して`Future`を実装" -"することも（あまりないことですが）可能です。例えば、`tokio::spawn`から返され" -"る`JoinHandle`は`Future`を実装することにより、joinすることを可能にしていま" -"す。" +#~ msgid " = n" +#~ msgstr " = n" -#: src/async/futures.md -msgid "" -"The `.await` keyword, applied to a Future, causes the current async function " -"to pause until that Future is ready, and then evaluates to its output." -msgstr "" -"Futureに適用される`.await`キーワードは、そのFutureの準備ができるまで、現在の" -"非同期の関数の一時停止を起こし、そしてその出力を評価します。" +#~ msgid " / 2_." +#~ msgstr " / 2_ になります。" -#: src/async/futures.md -msgid "" -"The `Future` and `Poll` types are implemented exactly as shown; click the " -"links to show the implementations in the docs." -msgstr "" -"`Future`と`Poll`の型はまさに示されたように実装されます; ドキュメントの具体的" -"な実装を見るにはリンクをクリックしてください。" +#~ msgid "_ is odd, then _n" +#~ msgstr "_ が奇数の場合、_n" -#: src/async/futures.md -msgid "" -"We will not get to `Pin` and `Context`, as we will focus on writing async " -"code, rather than building new async primitives. Briefly:" -msgstr "" -"`Pin`と`Context`については詳しくは扱いません。なぜなら、新しく非同期のプリミ" -"ティブを作るよりも、非同期のコードを書くことに我々は重点を置くつもりだからで" -"す。簡潔には以下で説明されます：" +#~ msgid " = 3 * n" +#~ msgstr " = 3 * n" -#: src/async/futures.md -msgid "" -"`Context` allows a Future to schedule itself to be polled again when an " -"event occurs." -msgstr "" -"`Context`は、特定のイベントが発生した時に、Futureが自分自身を再びポーリングさ" -"れるようにスケジュールすることを可能にします。" +#~ msgid " + 1_." +#~ msgstr " + 1_ になります。" -#: src/async/futures.md -msgid "" -"`Pin` ensures that the Future isn't moved in memory, so that pointers into " -"that future remain valid. This is required to allow references to remain " -"valid after an `.await`." -msgstr "" -"`Pin`はfutureへのポインタが有効であり続けるために、Futureがメモリの中で移動さ" -"れないことを確実にします。これは、参照が`.await`の後に有効であり続けるために" -"必要です。" +#~ msgid "_ = 3:" +#~ msgstr "_ = 3 で始まる場合は以下のようになります。" -#: src/async/runtimes.md -msgid "" -"A _runtime_ provides support for performing operations asynchronously (a " -"_reactor_) and is responsible for executing futures (an _executor_). Rust " -"does not have a \"built-in\" runtime, but several options are available:" -msgstr "" -"\\_runtime_は非同期な演算（_reactor_）のサポートを提供し、また、futureを実行" -"すること（_executor_）を担当しています。Rustには「ビルトイン」のランタイムは" -"ありませんが、いくつかのランタイムの選択肢があります: " +#~ msgid "3 is odd, so _n" +#~ msgstr "3 は奇数なので、_n" -#: src/async/runtimes.md -#, fuzzy -msgid "" -"[Tokio](https://tokio.rs/): performant, with a well-developed ecosystem of " -"functionality like [Hyper](https://hyper.rs/) for HTTP or [Tonic](https://" -"github.com/hyperium/tonic) for gRPC." -msgstr "" -"[Tokio](https://tokio.rs/) - パフォーマンスが高い。HTTP向けの[Hyper](https://" -"hyper.rs/)やgRPC向けの[Tonic](https://github.com/hyperium/tonic)のような発達" -"したエコシステムも持っている" +#~ msgid "2" +#~ msgstr "2" -#: src/async/runtimes.md -#, fuzzy -msgid "" -"[async-std](https://async.rs/): aims to be a \"std for async\", and includes " -"a basic runtime in `async::task`." -msgstr "" -"[async-std](https://async.rs/) - 「async」のための「std」であることを目指した" -"もの。また、`async::task`に基本的なランタイムを含む。" +#~ msgid "_ = 3 * 3 + 1 = 10;" +#~ msgstr "_ = 3 * 3 + 1 = 10 になります。" -#: src/async/runtimes.md -#, fuzzy -msgid "[smol](https://docs.rs/smol/latest/smol/): simple and lightweight" -msgstr "[smol](https://docs.rs/smol/latest/smol/) - シンプルで軽量" +#~ msgid "10 is even, so _n" +#~ msgstr "10 は偶数なので、_n" -#: src/async/runtimes.md -msgid "" -"Several larger applications have their own runtimes. For example, [Fuchsia]" -"(https://fuchsia.googlesource.com/fuchsia/+/refs/heads/main/src/lib/fuchsia-" -"async/src/lib.rs) already has one." -msgstr "" -"いくつかのより巨大なアプリケーションは、独自のランタイムを備えています。例え" -"ば[Fuchsia](https://fuchsia.googlesource.com/fuchsia/+/refs/heads/main/src/" -"lib/fuchsia-async/src/lib.rs)はそのようなものをすでに備えています。" +#~ msgid "_ = 10 / 2 = 5;" +#~ msgstr "_ = 10 / 2 = 5 になります。" -#: src/async/runtimes.md -msgid "" -"Note that of the listed runtimes, only Tokio is supported in the Rust " -"playground. The playground also does not permit any I/O, so most interesting " -"async things can't run in the playground." -msgstr "" -"上で挙げられたランタイムのうち、TokioのみがRustプレイグラウンドでサポートされ" -"ています。このプレイグラウンドではいかなる入出力操作も許可されていないため、" -"大抵の興味深い非同期のあれこれは、プレイグラウンドで実行することはできませ" -"ん。" +#~ msgid "5 is odd, so _n" +#~ msgstr "5 は奇数なので、_n" -#: src/async/runtimes.md -msgid "" -"Futures are \"inert\" in that they do not do anything (not even start an I/O " -"operation) unless there is an executor polling them. This differs from JS " -"Promises, for example, which will run to completion even if they are never " -"used." -msgstr "" -"Futureは、ポーリングを行うエグゼキュータの存在なしには何も行わない（入出力操" -"作さえ始めない）という点で「怠惰」です。例えば、これは、エグゼキュータがなく" -"とも最後まで実行されるJavaScriptのPromiseとは異なります。" +#~ msgid "_ = 3 * 5 + 1 = 16;" +#~ msgstr "_ = 3 * 5 + 1 = 16 になります。" -#: src/async/runtimes/tokio.md -#, fuzzy -msgid "Tokio provides:" -msgstr "Tokioは以下を提供します: " +#~ msgid "16 is even, so _n" +#~ msgstr "16 は偶数なので、_n" -#: src/async/runtimes/tokio.md -msgid "A multi-threaded runtime for executing asynchronous code." -msgstr "非同期のコードを実行するためのマルチスレッドのランタイム。" +#~ msgid "5" +#~ msgstr "5" -#: src/async/runtimes/tokio.md -msgid "An asynchronous version of the standard library." -msgstr "標準ライブラリの非同期バージョン。" +#~ msgid "_ = 16 / 2 = 8;" +#~ msgstr "_ = 16 / 2 = 8 になります。" -#: src/async/runtimes/tokio.md -msgid "A large ecosystem of libraries." -msgstr "大きなライブラリのエコシステム。" +#~ msgid "8 is even, so _n" +#~ msgstr "8 は偶数なので、_n" -#: src/async/runtimes/tokio.md -msgid "\"Count in task: {i}!\"" -msgstr "\"Count in task: {i}!\"" +#~ msgid "_ = 8 / 2 = 4;" +#~ msgstr "_ = 8 / 2 = 4 になります。" -#: src/async/runtimes/tokio.md -msgid "\"Main task: {i}\"" -msgstr "\"Main task: {i}\"" +#~ msgid "4 is even, so _n" +#~ msgstr "4 は偶数なので、_n" -#: src/async/runtimes/tokio.md -msgid "With the `tokio::main` macro we can now make `main` async." -msgstr "`tokio::main`のマクロにより、`main`の非同期処理を作ることができます。" +#~ msgid "7" +#~ msgstr "7" -#: src/async/runtimes/tokio.md -msgid "The `spawn` function creates a new, concurrent \"task\"." -msgstr "`spawn`関数は新しい並行の「タスク」を作成します。" +#~ msgid "_ = 4 / 2 = 2;" +#~ msgstr "_ = 4 / 2 = 2 になります。" -#: src/async/runtimes/tokio.md -msgid "Note: `spawn` takes a `Future`, you don't call `.await` on `count_to`." -msgstr "" -"注意：`spawn`は`Future`を引数に取るため、`count_to`に対して`.await`を呼ぶこと" -"はありません。" +#~ msgid "2 is even, so _n" +#~ msgstr "2 は偶数なので、_n" -#: src/async/runtimes/tokio.md -msgid "**Further exploration:**" -msgstr "**さらなる探求:**" +#~ msgid "_ = 1; and" +#~ msgstr "_ = 1 になります。" -#: src/async/runtimes/tokio.md -msgid "" -"Why does `count_to` not (usually) get to 10? This is an example of async " -"cancellation. `tokio::spawn` returns a handle which can be awaited to wait " -"until it finishes." -msgstr "" -"どうして`count_to`は（通常は）10に辿り着かないのでしょうか？これは非同期処理" -"のキャンセルの例です。 `tokio::spawn`は完了まで待機するためのハンドラを返しま" -"す。" +#~ msgid "[Tuples and Arrays](./tuples-and-arrays.md) (1 hour)" +#~ msgstr "[タプルと配列](./tuples-and-arrays.md)（1 時間）" -#: src/async/runtimes/tokio.md -msgid "Try `count_to(10).await` instead of spawning." -msgstr "" -"プロセスを新しく作る代わりに、`count_to(10).await`を試してみてください。" +#~ msgid "[References](./references.md) (50 minutes)" +#~ msgstr "[参照](./references.md)（50 分）" -#: src/async/runtimes/tokio.md -msgid "Try awaiting the task returned from `tokio::spawn`." -msgstr "`tokio::spawn`から返されたタスクを待機してみてください。" +#~ msgid "[User-Defined Types](./user-defined-types.md) (50 minutes)" +#~ msgstr "[ユーザー定義型](./user-defined-types.md)（50 分）" -#: src/async/tasks.md -msgid "Rust has a task system, which is a form of lightweight threading." -msgstr "Rust には、軽量のスレッド形式の一種であるタスクシステムがあります。" +#~ msgid "" +#~ "[Tuples and Arrays](./tuples-and-arrays/tuples-and-arrays.md) (10 minutes)" +#~ msgstr "[タプルと配列](./tuples-and-arrays/tuples-and-arrays.md)（10 分）" -#: src/async/tasks.md -msgid "" -"A task has a single top-level future which the executor polls to make " -"progress. That future may have one or more nested futures that its `poll` " -"method polls, corresponding loosely to a call stack. Concurrency within a " -"task is possible by polling multiple child futures, such as racing a timer " -"and an I/O operation." -msgstr "" -"タスクには、単一のトップレベルのfutureがあり、これはエグゼキュータが先に進む" -"ためにポーリングする対象となります。そのfutureには一つまたは複数のfutureがネ" -"ストされていることもあり、トップレベルのfutureの`poll`メソッドがポーリングす" -"ることになり、大まかにはコールスタックに対応すると言えます。タスクにおける並" -"行処理は、例えば競合タイマーや入出力操作など、複数の子のfutureをポーリングす" -"ることにより可能になります。" +#~ msgid "[Array Iteration](./tuples-and-arrays/iteration.md) (3 minutes)" +#~ msgstr "[配列の反復処理](./tuples-and-arrays/iteration.md)（3 分）" -#: src/async/tasks.md -msgid "\"127.0.0.1:0\"" -msgstr "\"127.0.0.1:0\"" +#~ msgid "[Pattern Matching](./tuples-and-arrays/match.md) (10 minutes)" +#~ msgstr "[パターン マッチング](./tuples-and-arrays/match.md)（10 分）" -#: src/async/tasks.md -msgid "\"listening on port {}\"" -msgstr "\"listening on port {}\"" +#~ msgid "[Destructuring](./tuples-and-arrays/destructuring.md) (5 minutes)" +#~ msgstr "[分解](./tuples-and-arrays/destructuring.md)（5 分）" -#: src/async/tasks.md -msgid "\"connection from {addr:?}\"" -msgstr "\"connection from {addr:?}\"" +#~ msgid "" +#~ "[Exercise: Nested Arrays](./tuples-and-arrays/exercise.md) (30 minutes)" +#~ msgstr "[演習: ネストされた配列](./tuples-and-arrays/exercise.md)（30 分）" -#: src/async/tasks.md -msgid "b\"Who are you?\\n\"" -msgstr "b\"Who are you?\\n\"" +#~ msgid "" +#~ "Tuples and arrays are the first \"compound\" types we have seen. All " +#~ "elements of an array have the same type, while tuples can accommodate " +#~ "different types. Both types have a size fixed at compile time." +#~ msgstr "" +#~ "タプルと配列は、このコースで初めて扱う「複合」型です。配列のすべての要素の" +#~ "型は同じですが、タプルは異なる型に対応できます。どちらの型もコンパイル時に" +#~ "サイズが固定されます。" -#: src/async/tasks.md -msgid "\"socket error\"" -msgstr "\"socket error\"" +#~ msgid "`[T; N]`" +#~ msgstr "`[T; N]`" -#: src/async/tasks.md -msgid "\"Thanks for dialing in, {name}!\\n\"" -msgstr "\"Thanks for dialing in, {name}!\\n\"" +#~ msgid "`[20, 30, 40]`, `[0; 3]`" +#~ msgstr "`[20, 30, 40]`、`[0; 3]`" -#: src/async/tasks.md src/async/control-flow/join.md -msgid "" -"Copy this example into your prepared `src/main.rs` and run it from there." -msgstr "" -"この例を準備した`src/main.rs`にコピーして、そこから実行してみましょう。" +#~ msgid "`()`, `(T,)`, `(T1, T2)`, ..." +#~ msgstr "`()`、`(T,)`、`(T1, T2)`、..." -#: src/async/tasks.md -msgid "" -"Try connecting to it with a TCP connection tool like [nc](https://www.unix." -"com/man-page/linux/1/nc/) or [telnet](https://www.unix.com/man-page/linux/1/" -"telnet/)." -msgstr "" -"[nc](https://www.unix.com/man-page/linux/1/nc/) や [telnet](https://www.unix." -"com/man-page/linux/1/telnet/) などの TCP 接続ツールを使用して接続してみてくだ" -"さい。" +#~ msgid "`()`, `('x',)`, `('x', 1.2)`, ..." +#~ msgstr "`()`、`('x',)`、`('x', 1.2)`、..." -#: src/async/tasks.md -msgid "" -"Ask students to visualize what the state of the example server would be with " -"a few connected clients. What tasks exist? What are their Futures?" -msgstr "" -"例のサーバーがどのような状態の時に、いくつかのクライアントと接続された状態に" -"あるのかを、可視化するように受講者に指示してください。どんなタスクが存在して" -"いますか？それらのfutureは何ですか？" +#~ msgid "Array assignment and access:" +#~ msgstr "配列の代入とアクセス:" -#: src/async/tasks.md -#, fuzzy -msgid "" -"This is the first time we've seen an `async` block. This is similar to a " -"closure, but does not take any arguments. Its return value is a Future, " -"similar to an `async fn`." -msgstr "" -"私たちが`async`ブロックを見かけるのは初めてですね。これはクロージャと似ていま" -"すが、何も引数は取りません。この返り値はFutureであり、`async fn`と似ていま" -"す。" +#~ msgid "Tuple assignment and access:" +#~ msgstr "タプルの代入とアクセス:" -#: src/async/tasks.md -msgid "" -"Refactor the async block into a function, and improve the error handling " -"using `?`." -msgstr "" -"mainのasyncブロックを関数にリファクタして、`?`を使ったエラーハンドリングを改" -"善してみましょう。" +#~ msgid "Arrays:" +#~ msgstr "配列:" -#: src/async/channels.md -#, fuzzy -msgid "" -"Several crates have support for asynchronous channels. For instance `tokio`:" -msgstr "" -"いくつかのクレートは`async`/`await`をサポートしています。例えば、`tokio`チャ" -"ネルは:" +#~ msgid "Tuples:" +#~ msgstr "タプル:" -#: src/async/channels.md -msgid "\"Received {count} pings so far.\"" -msgstr "\"Received {count} pings so far.\"" +#~ msgid "" +#~ "The empty tuple `()` is also known as the \"unit type\". It is both a " +#~ "type, and the only valid value of that type --- that is to say both the " +#~ "type and its value are expressed as `()`. It is used to indicate, for " +#~ "example, that a function or expression has no return value, as we'll see " +#~ "in a future slide." +#~ msgstr "" +#~ "空のタプル `()` は、「ユニット型」とも呼ばれます。これは型であるとともに、" +#~ "その型で唯一の有効な値です。つまり、型とその値の両方が `()` として表現され" +#~ "ます。以降のスライドで説明するように、これは関数や式に戻り値がないことを示" +#~ "す場合などに使用されます。" -#: src/async/channels.md -msgid "\"ping_handler complete\"" -msgstr "\"ping_handler complete\"" +#~ msgid "" +#~ "You can think of it as `void` that can be familiar to you from other " +#~ "programming languages." +#~ msgstr "" +#~ "これは、他のプログラミング言語で馴染みのある `void` と考えることができま" +#~ "す。" -#: src/async/channels.md -msgid "\"Failed to send ping.\"" -msgstr "\"Failed to send ping.\"" +#~ msgid "" +#~ "Destructuring is a way of extracting data from a data structure by " +#~ "writing a pattern that is matched up to the data structure, binding " +#~ "variables to subcomponents of the data structure." +#~ msgstr "" +#~ "分解とは、データ構造に一致するパターンを記述し、変数をデータ構造のサブコン" +#~ "ポーネントにバインドすることで、データ構造からデータを抽出する方法です。" -#: src/async/channels.md -msgid "\"Sent {} pings so far.\"" -msgstr "\"Sent {} pings so far.\"" +#~ msgid "You can destructure tuples and arrays by matching on their elements:" +#~ msgstr "タプルと配列は、要素を照合することで分解できます。" -#: src/async/channels.md -msgid "\"Something went wrong in ping handler task.\"" -msgstr "\"Something went wrong in ping handler task.\"" +#~ msgid "\"on Y axis\"" +#~ msgstr "\"on Y axis\"" -#: src/async/channels.md -msgid "Change the channel size to `3` and see how it affects the execution." -msgstr "" -"チャネルサイズを `3`に変えてみて、これがどのように処理に影響するか確認してみ" -"ましょう。" +#~ msgid "\"on X axis\"" +#~ msgstr "\"on X axis\"" -#: src/async/channels.md -msgid "" -"Overall, the interface is similar to the `sync` channels as seen in the " -"[morning class](concurrency/channels.md)." -msgstr "" -"一般的に、このインターフェースは、[朝の講座](concurrency/channels.md)で見られ" -"たような`sync`チャネルに似ています。" +#~ msgid "\"left of Y axis\"" +#~ msgstr "\"left of Y axis\"" -#: src/async/channels.md -msgid "Try removing the `std::mem::drop` call. What happens? Why?" -msgstr "" -"`std::mem::drop`の呼び出しを除いてみましょう。何か起こるでしょうか？それはな" -"ぜでしょうか？" +#~ msgid "\"below X axis\"" +#~ msgstr "\"below X axis\"" -#: src/async/channels.md -msgid "" -"The [Flume](https://docs.rs/flume/latest/flume/) crate has channels that " -"implement both `sync` and `async` `send` and `recv`. This can be convenient " -"for complex applications with both IO and heavy CPU processing tasks." -msgstr "" -"[Flume](https://docs.rs/flume/latest/flume/)クレートには`sync`と`async`や" -"`send`と`recv`の両方を実装するチャネルがあります。 これは入出力と重いCPUの処" -"理のタスクの両方を含む、複雑なアプリケーションで便利です。" +#~ msgid "\"first quadrant\"" +#~ msgstr "\"first quadrant\"" -#: src/async/channels.md -msgid "" -"What makes working with `async` channels preferable is the ability to " -"combine them with other `future`s to combine them and create complex control " -"flow." -msgstr "" -"`async`チャネルを扱うことを好ましくするのは、チャネルと繋げるためにや、複雑な" -"コントロールフローを作るために、チャネルを他の`future`と繋げられることです。" +#~ msgid "\"Tell me about {triple:?}\"" +#~ msgstr "\"Tell me about {triple:?}\"" -#: src/async/control-flow.md -msgid "Futures Control Flow" -msgstr "Futureの制御フロー" +#~ msgid "\"First is 0, y = {y}, and z = {z}\"" +#~ msgstr "\"First is 0, y = {y}, and z = {z}\"" -#: src/async/control-flow.md -msgid "" -"Futures can be combined together to produce concurrent compute flow graphs. " -"We have already seen tasks, that function as independent threads of " -"execution." -msgstr "" -"並行計算フローグラフを生成するために、futureを組み合わせることができます。す" -"でに独立したスレッドとして機能するタスクを見てきました。" +#~ msgid "\"First is 1 and the rest were ignored\"" +#~ msgstr "\"First is 1 and the rest were ignored\"" -#: src/async/control-flow.md -msgid "[Join](control-flow/join.md)" -msgstr "[結合](control-flow/join.md)" +#~ msgid "\"All elements were ignored\"" +#~ msgstr "\"All elements were ignored\"" -#: src/async/control-flow.md -msgid "[Select](control-flow/select.md)" -msgstr "[選択](control-flow/select.md)" +#~ msgid "Create a new array pattern using `_` to represent an element." +#~ msgstr "`_` を使用して要素を表す新しい配列パターンを作成します。" -#: src/async/control-flow/join.md -msgid "" -"A join operation waits until all of a set of futures are ready, and returns " -"a collection of their results. This is similar to `Promise.all` in " -"JavaScript or `asyncio.gather` in Python." -msgstr "" -"Joinという操作では、futureの集合の準備が整うまで待機し、その後に結果をまとめ" -"て返します。これはJavaScriptにおける `Promise.all` やPythonにおける`asyncio." -"gather`に似ています。" +#~ msgid "Add more values to the array." +#~ msgstr "配列に値を追加します。" -#: src/async/control-flow/join.md -msgid "\"https://google.com\"" -msgstr "\"https://google.com\"" +#~ msgid "" +#~ "Point out that how `..` will expand to account for different number of " +#~ "elements." +#~ msgstr "要素数が異なる場合に `..` がどのように展開されるかを説明します。" -#: src/async/control-flow/join.md -msgid "\"https://httpbin.org/ip\"" -msgstr "\"https://httpbin.org/ip\"" +#~ msgid "" +#~ "Show matching against the tail with patterns `[.., b]` and `[a@..,b]`" +#~ msgstr "パターン `[.., b]` と `[a@..,b]` で末尾を照合します。" -#: src/async/control-flow/join.md -msgid "\"https://play.rust-lang.org/\"" -msgstr "\"https://play.rust-lang.org/\"" +#~ msgid "Hard-code both functions to operate on 3 × 3 matrices." +#~ msgstr "3 × 3 の行列で動作するように、両方の関数をハードコードします。" -#: src/async/control-flow/join.md -msgid "\"BAD_URL\"" -msgstr "\"BAD_URL\"" +#~ msgid "[Shared References](./references/shared.md) (10 minutes)" +#~ msgstr "[共有参照](./references/shared.md)（10 分）" -#: src/async/control-flow/join.md -msgid "" -"For multiple futures of disjoint types, you can use `std::future::join!` but " -"you must know how many futures you will have at compile time. This is " -"currently in the `futures` crate, soon to be stabilised in `std::future`." -msgstr "" -"複数の互いに素な型のfutureに対しては、`std::future::join!`を利用できます。し" -"かし、いくつのfutureがコンパイル時に存在しているのかを把握しておく必要があり" -"ます。これは現在`futures`クレートにありますが、近いうちに`std::future`に統合" -"される予定です。" +#~ msgid "[Exclusive References](./references/exclusive.md) (10 minutes)" +#~ msgstr "[排他参照](./references/except.md)（10 分）" -#: src/async/control-flow/join.md -#, fuzzy -msgid "" -"The risk of `join` is that one of the futures may never resolve, this would " -"cause your program to stall." -msgstr "" -"`join`のリスクは、複数のfutureのうちの１つでも解決されないとプログラムがス" -"トールしてしまうということです。 " +#~ msgid "[Exercise: Geometry](./references/exercise.md) (30 minutes)" +#~ msgstr "[演習: ジオメトリ](./references/exercise.md)（30 分）" -#: src/async/control-flow/join.md -msgid "" -"You can also combine `join_all` with `join!` for instance to join all " -"requests to an http service as well as a database query. Try adding a " -"`tokio::time::sleep` to the future, using `futures::join!`. This is not a " -"timeout (that requires `select!`, explained in the next chapter), but " -"demonstrates `join!`." -msgstr "" -"また、`join_all`と`join!`を組み合わせることもできます。それは、例えばデータ" -"ベースのクエリと一緒にhttpサービスへの全てのリクエストをjoinする場合です。" -"futureに`futures::join!`を用いて、`tokio::time::sleep`を追加してみてくださ" -"い。これは（次のチャプターで説明する、`select!`を必要とする）タイムアウトでは" -"ありませんが、`join!`の良い実演となっています。" +#~ msgid "[Named Structs](./user-defined-types/named-structs.md) (10 minutes)" +#~ msgstr "[名前付き構造体](./user-defined-types/named-structs.md)（10 分）" -#: src/async/control-flow/select.md -msgid "" -"A select operation waits until any of a set of futures is ready, and " -"responds to that future's result. In JavaScript, this is similar to `Promise." -"race`. In Python, it compares to `asyncio.wait(task_set, return_when=asyncio." -"FIRST_COMPLETED)`." -msgstr "" -"Selectという操作では、futureの集合のうち、いずれか１つの準備が整うまで待機" -"し、そのfutureが提供する結果に対して応答します。これはJavaScriptにおける" -"`Promise.race`に似ています。また、Pythonにおける `asyncio.wait(task_set, " -"return_when=asyncio.FIRST_COMPLETED)`と比べることができます。" +#~ msgid "[Tuple Structs](./user-defined-types/tuple-structs.md) (10 minutes)" +#~ msgstr "[タプル構造体](./user-defined-types/tuple-structs.md)（10 分）" -#: src/async/control-flow/select.md -#, fuzzy -msgid "" -"Similar to a match statement, the body of `select!` has a number of arms, " -"each of the form `pattern = future => statement`. When a `future` is ready, " -"its return value is destructured by the `pattern`. The `statement` is then " -"run with the resulting variables. The `statement` result becomes the result " -"of the `select!` macro." -msgstr "" -"Matchステートメントのように、`select!`の本体にはいくつかの 「腕」があり、それ" -"ぞれは`pattern = future => statement`の形をとっています。 `future`の準備が" -"整った時、その`statement`は`future`の結果に紐づく`pattern`の変数を用いて実行" -"されます。" +#~ msgid "[Enums](./user-defined-types/enums.md) (5 minutes)" +#~ msgstr "[列挙型](./user-defined-types/enums.md)（5 分）" -#: src/async/control-flow/select.md -msgid "\"Felix\"" -msgstr "\"Felix\"" +#~ msgid "" +#~ "[Static and Const](./user-defined-types/static-and-const.md) (5 minutes)" +#~ msgstr "[static と const](./user-defined-types/static-and-const.md)（5 分）" -#: src/async/control-flow/select.md -msgid "\"Failed to send cat.\"" -msgstr "\"Failed to send cat.\"" +#~ msgid "[Type Aliases](./user-defined-types/aliases.md) (2 minutes)" +#~ msgstr "[型エイリアス](./user-defined-types/aliases.md)（2 分）" -#: src/async/control-flow/select.md -msgid "\"Rex\"" -msgstr "\"Rex\"" +#~ msgid "" +#~ "[Exercise: Elevator Events](./user-defined-types/exercise.md) (15 minutes)" +#~ msgstr "" +#~ "[演習: エレベーター イベント](./user-defined-types/exercise.md)（15 分）" + +#~ msgid "" +#~ "Static and constant variables are two different ways to create globally-" +#~ "scoped values that cannot be moved or reallocated during the execution of " +#~ "the program." +#~ msgstr "" +#~ "静的変数と定数変数は、プログラムの実行中に移動または再割り当てできないグ" +#~ "ローバル スコープの値を作成するための、2 つの異なる方法です。" -#: src/async/control-flow/select.md -msgid "\"Failed to send dog.\"" -msgstr "\"Failed to send dog.\"" +#~ msgid "Properties table:" +#~ msgstr "プロパティの表:" -#: src/async/control-flow/select.md -msgid "\"Failed to receive winner\"" -msgstr "\"Failed to receive winner\"" +#~ msgid "Has an address in memory" +#~ msgstr "メモリ内にアドレスがある" -#: src/async/control-flow/select.md -msgid "\"Winner is {winner:?}\"" -msgstr "\"Winner is {winner:?}\"" +#~ msgid "No (inlined)" +#~ msgstr "いいえ（インライン化）" -#: src/async/control-flow/select.md #, fuzzy -msgid "" -"In this example, we have a race between a cat and a dog. " -"`first_animal_to_finish_race` listens to both channels and will pick " -"whichever arrives first. Since the dog takes 50ms, it wins against the cat " -"that take 500ms." -msgstr "" -"この例では、猫と犬のレースを扱っています。`first_animal_to_finish_race`は両方" -"のチャネルをリッスンし、先に到着した方を選びます。犬は到着まで50msかかるの" -"で、500msかかる猫に勝ちます。" - -#: src/async/control-flow/select.md -msgid "" -"You can use `oneshot` channels in this example as the channels are supposed " -"to receive only one `send`." -msgstr "" -"この例では`oneshot`チャネルを使うこともできます。なぜなら、チャネルは一回きり" -"の`send`を受け取ることになっているからです。" +#~ msgid "Lives for the entire duration of the program" +#~ msgstr "`main`関数はプログラムのエントリーポイントになります。" -#: src/async/control-flow/select.md -msgid "" -"Try adding a deadline to the race, demonstrating selecting different sorts " -"of futures." -msgstr "" -"レースに制限時間を追加することによって、違う種類のfutureをselectすることを実" -"演してみてください。" +#~ msgid "Can be mutable" +#~ msgstr "変更可能" -#: src/async/control-flow/select.md -msgid "" -"Note that `select!` drops unmatched branches, which cancels their futures. " -"It is easiest to use when every execution of `select!` creates new futures." -msgstr "" -"`select!`はマッチしなかったブランチをドロップすることに注意してください。これ" -"は、そうしたブランチのfutureがキャンセルされることにつながります。`select!`を" -"毎回実行する際に新たなfutureが作成されるときに、`select!`を使うのが最も簡単で" -"す。" +#~ msgid "Yes (unsafe)" +#~ msgstr "はい（安全でない）" -#: src/async/control-flow/select.md -msgid "" -"An alternative is to pass `&mut future` instead of the future itself, but " -"this can lead to issues, further discussed in the pinning slide." -msgstr "" -"Futureそのものでなく、`&mut future`を渡すという代替案もあります。しかし、これ" -"は問題につながることもあります。このことはPinに関するスライドで詳細に議論しま" -"す。" +#~ msgid "Evaluated at compile time" +#~ msgstr "コンパイル時に評価" -#: src/async/pitfalls.md -msgid "Pitfalls of async/await" -msgstr "async / await の注意点" +#~ msgid "Yes (initialised at compile time)" +#~ msgstr "はい（コンパイル時に初期化）" -#: src/async/pitfalls.md -msgid "" -"Async / await provides convenient and efficient abstraction for concurrent " -"asynchronous programming. However, the async/await model in Rust also comes " -"with its share of pitfalls and footguns. We illustrate some of them in this " -"chapter:" -msgstr "" -"async / await は、同時実行非同期プログラミングのための便利で効率的な抽象化を" -"提供します。しかし、Rust の async / await モデルには、注意点や誤用されやすい" -"機能もいくつかあるため、この章ではその点について説明します。" +#~ msgid "Inlined wherever it is used" +#~ msgstr "使用場所にかかわらずインライン化" -#: src/async/pitfalls.md -msgid "[Blocking the Executor](pitfalls/blocking-executor.md)" -msgstr "[エグゼキュータのブロック](pitfalls/blocking-executor.md)" +#~ msgid "[Welcome](./welcome-day-2.md) (3 minutes)" +#~ msgstr "[ようこそ](./welcome-day-2.md)（3 分）" -#: src/async/pitfalls.md -msgid "[Pin](pitfalls/pin.md)" -msgstr "[Pin](pitfalls/pin.md)" +#~ msgid "[Pattern Matching](./pattern-matching.md) (50 minutes)" +#~ msgstr "[パターン マッチング](./pattern-matching.md)（50 分）" -#: src/async/pitfalls.md -msgid "[Async Traits](pitfalls/async-traits.md)" -msgstr "[Async トレイト](pitfalls/async-traits.md)" +#, fuzzy +#~ msgid "[Methods and Traits](./methods-and-traits.md) (55 minutes)" +#~ msgstr "[メソッドとトレイト](./methods-and-train.md)（45 分）" -#: src/async/pitfalls.md -msgid "[Cancellation](pitfalls/cancellation.md)" -msgstr "[キャンセル](pitfalls/cancellation.md)" +#~ msgid "[Generics](./generics.md) (45 minutes)" +#~ msgstr "[ジェネリクス](./generics.md)（45 分）" -#: src/async/pitfalls/blocking-executor.md -msgid "Blocking the executor" -msgstr "エグゼキュータのブロック" +#~ msgid "[Destructuring](./pattern-matching/destructuring.md) (10 minutes)" +#~ msgstr "[デストラクト](./pattern-matching/destructuring.md)（10 分）" -#: src/async/pitfalls/blocking-executor.md -msgid "" -"Most async runtimes only allow IO tasks to run concurrently. This means that " -"CPU blocking tasks will block the executor and prevent other tasks from " -"being executed. An easy workaround is to use async equivalent methods where " -"possible." -msgstr "" -"ほとんどの非同期ランタイムは、IO タスクの同時実行のみを許可します。つまり、" -"CPU ブロックタスクはエグゼキュータをブロックし、他のタスクの実行を妨げます。" -"簡単な回避策は、可能であれば非同期の同等のメソッドを使用することです。" +#~ msgid "" +#~ "[Let Control Flow](./pattern-matching/let-control-flow.md) (10 minutes)" +#~ msgstr "" +#~ "[let による制御フロー](./pattern-matching/let-control-flow.md)（10 分）" -#: src/async/pitfalls/blocking-executor.md -msgid "\"future {id} slept for {duration_ms}ms, finished after {}ms\"" -msgstr "\"future {id} slept for {duration_ms}ms, finished after {}ms\"" +#~ msgid "" +#~ "[Exercise: Expression Evaluation](./pattern-matching/exercise.md) (30 " +#~ "minutes)" +#~ msgstr "[演習: 式の評価](./pattern-matching/exercise.md)（30 分）" -#: src/async/pitfalls/blocking-executor.md -msgid "\"current_thread\"" -msgstr "\"current_thread\"" +#~ msgid "`match` expressions" +#~ msgstr "`match` 式" -#: src/async/pitfalls/blocking-executor.md -msgid "" -"Run the code and see that the sleeps happen consecutively rather than " -"concurrently." -msgstr "" -"コードを続けて、スリープが同時ではなく連続して発生することを確認します。" +#~ msgid "[Methods](./methods-and-traits/methods.md) (10 minutes)" +#~ msgstr "[メソッド](./methods-and-train/methods.md)（10 分）" -#: src/async/pitfalls/blocking-executor.md -msgid "" -"The `\"current_thread\"` flavor puts all tasks on a single thread. This " -"makes the effect more obvious, but the bug is still present in the multi-" -"threaded flavor." -msgstr "" -"`\"current_thread\"` フレーバーは、すべてのタスクを 1 つのスレッドに配置しま" -"す。これにより、影響はより明確になりますが、バグはまだマルチスレッド フレー" -"バーに存在します。" +#~ msgid "[Traits](./methods-and-traits/traits.md) (10 minutes)" +#~ msgstr "[トレイト](./methods-and-features/train.md)（10 分）" -#: src/async/pitfalls/blocking-executor.md -msgid "" -"Switch the `std::thread::sleep` to `tokio::time::sleep` and await its result." -msgstr "" -"`std::thread::sleep` を `tokio::time::sleep` に切り替えて、その結果を待ちま" -"す。" +#~ msgid "[Deriving](./methods-and-traits/deriving.md) (5 minutes)" +#~ msgstr "[導出](./methods-and-train/deriving.md)（5 分）" -#: src/async/pitfalls/blocking-executor.md -msgid "" -"Another fix would be to `tokio::task::spawn_blocking` which spawns an actual " -"thread and transforms its handle into a future without blocking the executor." -msgstr "" -"もう 1 つの修正策は、`tokio::task::spawn_blocking` を使用することです。これ" -"は、実際のスレッドを生成し、エグゼキュータをブロックせずにそのハンドルを " -"Future に変換します。" +#~ msgid "[Trait Objects](./methods-and-traits/trait-objects.md) (10 minutes)" +#~ msgstr "[トレイトオブジェクト](./methods-and-features/train.md)（10 分）" -#: src/async/pitfalls/blocking-executor.md -msgid "" -"You should not think of tasks as OS threads. They do not map 1 to 1 and most " -"executors will allow many tasks to run on a single OS thread. This is " -"particularly problematic when interacting with other libraries via FFI, " -"where that library might depend on thread-local storage or map to specific " -"OS threads (e.g., CUDA). Prefer `tokio::task::spawn_blocking` in such " -"situations." -msgstr "" -"タスクは OS スレッドとはみなすべきではありません。これらは 1 対 1 に対応して" -"おらず、ほとんどのエグゼキュータは、単一の OS スレッドで多くのタスクを実行す" -"ることを許可します。これは、FFI を介して他のライブラリとやり取りする場合に特" -"に問題となります。FFI では、そのライブラリはスレッド ローカル ストレージに依" -"存しているか、特定の OS スレッド（CUDA など）にマッピングされている可能性があ" -"るためです。そのような場合は `tokio::task::spawn_blocking` を使用することをお" -"すすめします。" +#~ msgid "" +#~ "[Exercise: Generic Logger](./methods-and-traits/exercise.md) (20 minutes)" +#~ msgstr "" +#~ "[演習: ジェネリックなロガー](./methods-and-train/exercise.md)（20 分）" -#: src/async/pitfalls/blocking-executor.md -msgid "" -"Use sync mutexes with care. Holding a mutex over an `.await` may cause " -"another task to block, and that task may be running on the same thread." -msgstr "" -"同期ミューテックスは慎重に使用してください。`.await` でミューテックスを保持す" -"ると、別のタスクがブロックされ、そのタスクが同じスレッドで実行される可能性が" -"あります。" +#~ msgid "" +#~ "Trait objects allow for values of different types, for instance in a " +#~ "collection:" +#~ msgstr "" +#~ "トレイトオブジェクトは異なる型の値をひとつのコレクションにまとめることを可" +#~ "能にします：" -#: src/async/pitfalls/pin.md -msgid "" -"Async blocks and functions return types implementing the `Future` trait. The " -"type returned is the result of a compiler transformation which turns local " -"variables into data stored inside the future." -msgstr "" -"非同期ブロックと関数は、`Future` トレイトを実装する型を返します。返される型" -"は、ローカル変数を Future の内部に格納されるデータに変換するコンパイラ変換の" -"結果です。" +#~ msgid "[Generic Functions](./generics/generic-functions.md) (5 minutes)" +#~ msgstr "[ジェネリック関数](./generics/generic-functions.md)（5 分）" -#: src/async/pitfalls/pin.md -msgid "" -"Some of those variables can hold pointers to other local variables. Because " -"of that, the future should never be moved to a different memory location, as " -"it would invalidate those pointers." -msgstr "" -"これらの変数の一部は、他のローカル変数へのポインタを保持できます。これらのポ" -"インタが無効になるため、Futureを別のメモリ位置に移動しないでください。" +#~ msgid "[Generic Data Types](./generics/generic-data.md) (15 minutes)" +#~ msgstr "[ジェネリック データ型](./generics/generic-data.md)（15 分）" -#: src/async/pitfalls/pin.md -msgid "" -"To prevent moving the future type in memory, it can only be polled through a " -"pinned pointer. `Pin` is a wrapper around a reference that disallows all " -"operations that would move the instance it points to into a different memory " -"location." -msgstr "" -"メモリ内の Future 型が移動するのを防ぐには、固定されたポインタのみを介して" -"ポーリングするようにします。`Pin` は参照のラッパーで、参照先のインスタンスを" -"別のメモリ位置に移動するオペレーションをすべて禁止します。" +#~ msgid "[Trait Bounds](./generics/trait-bounds.md) (10 minutes)" +#~ msgstr "[トレイト境界](./generics/trait-bounds.md)（10 分）" -#: src/async/pitfalls/pin.md -msgid "" -"// A work item. In this case, just sleep for the given time and respond\n" -"// with a message on the `respond_on` channel.\n" -msgstr "" -"// 作業アイテム。この場合、指定された時間だけスリープし、\n" -"// `respond_on` チャンネルでメッセージを返します。\n" +#~ msgid "[impl Trait](./generics/impl-trait.md) (5 minutes)" +#~ msgstr "[impl トレイト](./generics/impl-trait.md)（5 分）" -#: src/async/pitfalls/pin.md -msgid "// A worker which listens for work on a queue and performs it.\n" -msgstr "// キュー上の処理をリッスンして実行するワーカー。\n" +#~ msgid "[Exercise: Generic min](./generics/exercise.md) (10 minutes)" +#~ msgstr "[演習: ジェネリックな min](./generics/exercise.md)（10 分）" -#: src/async/pitfalls/pin.md -msgid "// Pretend to work.\n" -msgstr "// Pretend to work.\n" +#~ msgid "// fn set_x(&mut self, x: T)\n" +#~ msgstr "// fn set_x(&mut self, x: T)\n" -#: src/async/pitfalls/pin.md -msgid "\"failed to send response\"" -msgstr "\"failed to send response\"" +#~ msgid "/// Return true if self is less than other.\n" +#~ msgstr "/// 自身がその他より小さい場合は true を返します。\n" -#: src/async/pitfalls/pin.md -msgid "// TODO: report number of iterations every 100ms\n" -msgstr "// TODO: 100 ミリ秒ごとの反復処理の回数をレポート\n" +#~ msgid "\"Shapiro\"" +#~ msgstr "\"Shapiro\"" -#: src/async/pitfalls/pin.md -msgid "// A requester which requests work and waits for it to complete.\n" -msgstr "// 処理をリクエストし、処理が完了するまで待機するリクエスト元。\n" +#~ msgid "\"Baumann\"" +#~ msgstr "\"Baumann\"" -#: src/async/pitfalls/pin.md -msgid "\"failed to send on work queue\"" -msgstr "\"failed to send on work queue\"" +#~ msgid "[Standard Library Types](./std-types.md) (1 hour and 10 minutes)" +#~ msgstr "[標準ライブラリ型](./std-types.md)（1 時間 10 分）" -#: src/async/pitfalls/pin.md -msgid "\"failed waiting for response\"" -msgstr "\"failed waiting for response\"" +#~ msgid "[Standard Library Traits](./std-traits.md) (1 hour and 40 minutes)" +#~ msgstr "[標準ライブラリ トレイト](./std-train.md)（1 時間 40 分）" -#: src/async/pitfalls/pin.md -msgid "\"work result for iteration {i}: {resp}\"" -msgstr "\"work result for iteration {i}: {resp}\"" +#~ msgid "[Standard Library](./std-types/std.md) (3 minutes)" +#~ msgstr "[標準ライブラリ](./std-types/std.md)（3 分）" -#: src/async/pitfalls/pin.md -msgid "" -"You may recognize this as an example of the actor pattern. Actors typically " -"call `select!` in a loop." -msgstr "" -"これはアクターのパターンの一例です。アクターは通常、ループ内で `select!` を呼" -"び出します。" +#~ msgid "[Documentation](./std-types/docs.md) (5 minutes)" +#~ msgstr "[ドキュメント](./std-types/docs.md)（5 分）" -#: src/async/pitfalls/pin.md -msgid "" -"This serves as a summation of a few of the previous lessons, so take your " -"time with it." -msgstr "" -"これはこれまでのレッスンの一部をまとめたものですので、時間をかけて復習してく" -"ださい。" +#~ msgid "[Option](./std-types/option.md) (10 minutes)" +#~ msgstr "[Option](./std-types/option.md)（10 分）" -#: src/async/pitfalls/pin.md -msgid "" -"Naively add a `_ = sleep(Duration::from_millis(100)) => { println!(..) }` to " -"the `select!`. This will never execute. Why?" -msgstr "" -"`_ = sleep(Duration::from_millis(100)) => { println!(..) }` を `select!` に追" -"加しただけでは、実行されません。なぜでしょうか？" +#~ msgid "[Result](./std-types/result.md) (10 minutes)" +#~ msgstr "[Result](./std-types/result.md)（10 分）" -#: src/async/pitfalls/pin.md -msgid "" -"Instead, add a `timeout_fut` containing that future outside of the `loop`:" -msgstr "" -"代わりに、`loop` の外側で、その Future を含む `timeout_fut` を追加します。" +#~ msgid "[String](./std-types/string.md) (10 minutes)" +#~ msgstr "[String](./std-types/string.md)（10 分）" -#: src/async/pitfalls/pin.md -msgid "" -"This still doesn't work. Follow the compiler errors, adding `&mut` to the " -"`timeout_fut` in the `select!` to work around the move, then using `Box::" -"pin`:" -msgstr "" -"これでもうまくいきません。コンパイルエラーにあるように、`select!` 内の " -"`timeout_fut` に `&mut` を追加して移動を回避してから、`Box::pin` を使用しま" -"す。" +#~ msgid "[Vec](./std-types/vec.md) (10 minutes)" +#~ msgstr "[Vec](./std-types/vec.md)（10 分）" -#: src/async/pitfalls/pin.md -msgid "" -"This compiles, but once the timeout expires it is `Poll::Ready` on every " -"iteration (a fused future would help with this). Update to reset " -"`timeout_fut` every time it expires." -msgstr "" -"これはコンパイルされますが、タイムアウトになると、すべての反復処理で `Poll::" -"Ready` になります（融合された Future がこれに役立ちます）。期限が切れるたび" -"に `timeout_fut` をリセットするように更新します。" +#~ msgid "[HashMap](./std-types/hashmap.md) (10 minutes)" +#~ msgstr "[HashMap](./std-types/hashmap.md)（10 分）" -#: src/async/pitfalls/pin.md -msgid "" -"Box allocates on the heap. In some cases, `std::pin::pin!` (only recently " -"stabilized, with older code often using `tokio::pin!`) is also an option, " -"but that is difficult to use for a future that is reassigned." -msgstr "" -"Box でヒープに割り当てます。場合によっては `std::pin::pin!`（最近安定化された" -"ばかりで、古いコードでは多くの場合に `tokio::pin!` を使用します）も使用できま" -"すが、再割り当てされる Future に使用することは困難です。" +#~ msgid "[Exercise: Counter](./std-types/exercise.md) (10 minutes)" +#~ msgstr "[演習: カウンタ](./std-types/exercise.md)（10 分）" -#: src/async/pitfalls/pin.md -msgid "" -"Another alternative is to not use `pin` at all but spawn another task that " -"will send to a `oneshot` channel every 100ms." -msgstr "" -"別の方法としては、`pin` をまったく使用せずに、100 ミリ秒ごとに `oneshot` チャ" -"ネルに送信する別のタスクを生成するという方法もあります。" +#~ msgid "[Comparisons](./std-traits/comparisons.md) (10 minutes)" +#~ msgstr "[比較](./std-lets/comparisons.md)（10 分）" -#: src/async/pitfalls/pin.md -msgid "" -"Data that contains pointers to itself is called self-referential. Normally, " -"the Rust borrow checker would prevent self-referential data from being " -"moved, as the references cannot outlive the data they point to. However, the " -"code transformation for async blocks and functions is not verified by the " -"borrow checker." -msgstr "" -"それ自体へのポインタを含むデータは、自己参照と呼ばれます。通常、Rust 借用" -"チェッカーは、参照が参照先のデータより長く存続できないため、自己参照データの" -"移動を防ぎます。ただし、非同期ブロックと関数のコード変換は、借用チェッカーに" -"よって検証されません。" +#~ msgid "[Operators](./std-traits/operators.md) (10 minutes)" +#~ msgstr "[演算子](./std-train/operators.md)（10 分）" -#: src/async/pitfalls/pin.md -msgid "" -"`Pin` is a wrapper around a reference. An object cannot be moved from its " -"place using a pinned pointer. However, it can still be moved through an " -"unpinned pointer." -msgstr "" -"`Pin` は参照のラッパーです。固定されたポインタを使用して、オブジェクトをその" -"場所から移動することはできません。ただし、固定されていないポインタを介して移" -"動することは可能です。" +#~ msgid "[From and Into](./std-traits/from-and-into.md) (10 minutes)" +#~ msgstr "[From と Into](./std-lets/from-and-into.md)（10 分）" -#: src/async/pitfalls/pin.md -msgid "" -"The `poll` method of the `Future` trait uses `Pin<&mut Self>` instead of " -"`&mut Self` to refer to the instance. That's why it can only be called on a " -"pinned pointer." -msgstr "" -"`Future` トレイトの `poll` メソッドは、`&mut Self` ではなく `Pin<&mut Self>` " -"を使用してインスタンスを参照します。固定されたポインタでのみ呼び出すことがで" -"きるのはこのためです。" +#~ msgid "[Casting](./std-traits/casting.md) (5 minutes)" +#~ msgstr "[キャスト](./std-train/casting.md)（5 分）" -#: src/async/pitfalls/async-traits.md -msgid "" -"Async methods in traits are not yet supported in the stable channel ([An " -"experimental feature exists in nightly and should be stabilized in the mid " -"term.](https://blog.rust-lang.org/inside-rust/2022/11/17/async-fn-in-trait-" -"nightly.html))" -msgstr "" -"トレイトの非同期メソッドは、Stable チャンネルではまだサポートされていません" -"（[試験運用版の機能はナイトリーに存在するため、中期的には安定するはずです。]" -"(https://blog.rust-lang.org/inside-rust/2022/11/17/async-fn-in-trait-nightly." -"html)）" +#~ msgid "[Read and Write](./std-traits/read-and-write.md) (10 minutes)" +#~ msgstr "[読み取りと書き込み](./std-train/read-and-write.md)（10 分）" -#: src/async/pitfalls/async-traits.md -msgid "" -"The crate [async_trait](https://docs.rs/async-trait/latest/async_trait/) " -"provides a workaround through a macro:" -msgstr "" -"クレート [async_trait](https://docs.rs/async-trait/latest/async_trait/) は、" -"マクロによる回避策を提供します。" +#~ msgid "[Default, struct update syntax](./std-traits/default.md) (5 minutes)" +#~ msgstr "[Default、構造体更新記法](./std-lets/default.md)（5 分）" -#: src/async/pitfalls/async-traits.md -msgid "\"running all sleepers..\"" -msgstr "\"running all sleepers..\"" +#~ msgid "[Closures](./std-traits/closures.md) (20 minutes)" +#~ msgstr "[クロージャ](./std-lets/closures.md)（20 分）" -#: src/async/pitfalls/async-traits.md -msgid "\"slept for {}ms\"" -msgstr "\"slept for {}ms\"" +#~ msgid "[Exercise: ROT13](./std-traits/exercise.md) (30 minutes)" +#~ msgstr "[演習: ROT13](./std-train/exercise.md)（30 分）" -#: src/async/pitfalls/async-traits.md -msgid "" -"`async_trait` is easy to use, but note that it's using heap allocations to " -"achieve this. This heap allocation has performance overhead." -msgstr "" -"`async_trait` は簡単に使用できますが、ヒープ割り当てを使用してこれを実現して" -"います。このヒープ割り当てには、パフォーマンス オーバーヘッドが伴います。" +#~ msgid "This segment should take about 1 hour and 40 minutes" +#~ msgstr "このセグメントの所要時間は約 1 時間 40 分です" -#: src/async/pitfalls/async-traits.md -msgid "" -"The challenges in language support for `async trait` are deep Rust and " -"probably not worth describing in-depth. Niko Matsakis did a good job of " -"explaining them in [this post](https://smallcultfollowing.com/babysteps/" -"blog/2019/10/26/async-fn-in-traits-are-hard/) if you are interested in " -"digging deeper." -msgstr "" -"`async trait` の言語サポートにおける課題は、Rust の中でも難解な部類に入るた" -"め、ここでは詳しく説明する必要はないでしょう。Niko Matsakis が [こちらの投稿]" -"(https://smallcultfollowing.com/babysteps/blog/2019/10/26/async-fn-in-traits-" -"are-hard/) で詳しく説明していますので、深く掘り下げたい方はご覧ください。" +#~ msgid "\"there\"" +#~ msgstr "\"there\"" -#: src/async/pitfalls/async-traits.md -msgid "" -"Try creating a new sleeper struct that will sleep for a random amount of " -"time and adding it to the Vec." -msgstr "" -"ランダムな時間スリープする新しいスリーパー構造体を作成し、Vec に追加してみま" -"しょう。" +#~ msgid "[Welcome](./welcome-day-3.md) (3 minutes)" +#~ msgstr "[ようこそ](./welcome-day-3.md)（3 分）" -#: src/async/pitfalls/cancellation.md -msgid "" -"Dropping a future implies it can never be polled again. This is called " -"_cancellation_ and it can occur at any `await` point. Care is needed to " -"ensure the system works correctly even when futures are cancelled. For " -"example, it shouldn't deadlock or lose data." -msgstr "" -"Future をドロップすると、その Future を再度ポーリングすることはできません。こ" -"れはキャンセルと呼ばれ、どの `await` ポイントでも発生する可能性があります。そ" -"のため、Future がキャンセルされた場合でも、システムが正常に動作するようにして" -"おく必要があります。たとえば、デッドロックやデータの消失があってはなりませ" -"ん。" +#~ msgid "[Memory Management](./memory-management.md) (1 hour and 10 minutes)" +#~ msgstr "[メモリ管理](./memory-management.md)（1 時間 10 分）" -#: src/async/pitfalls/cancellation.md -msgid "\"not UTF-8\"" -msgstr "\"not UTF-8\"" +#~ msgid "[Smart Pointers](./smart-pointers.md) (45 minutes)" +#~ msgstr "[スマート ポインタ](./smart-pointers.md)（45 分）" -#: src/async/pitfalls/cancellation.md -msgid "\"hi\\nthere\\n\"" -msgstr "\"hi\\nthere\\n\"" +#~ msgid "" +#~ "[Review of Program Memory](./memory-management/review.md) (5 minutes)" +#~ msgstr "[プログラム メモリの復習](./memory-management/review.md)（5 分）" -#: src/async/pitfalls/cancellation.md -msgid "\"tick!\"" -msgstr "\"tick!\"" +#~ msgid "" +#~ "[Approaches to Memory Management](./memory-management/approaches.md) (10 " +#~ "minutes)" +#~ msgstr "[メモリ管理の方法](./memory-management/approaches.md)（10 分）" -#: src/async/pitfalls/cancellation.md -msgid "" -"The compiler doesn't help with cancellation-safety. You need to read API " -"documentation and consider what state your `async fn` holds." -msgstr "" -"コンパイラではキャンセル安全性を確保できません。API ドキュメントを読み、" -"`async fn` が保持する状態を考慮する必要があります。" +#~ msgid "[Ownership](./memory-management/ownership.md) (5 minutes)" +#~ msgstr "[所有権](./memory-management/ownership.md)（5 分）" -#: src/async/pitfalls/cancellation.md -msgid "" -"Unlike `panic` and `?`, cancellation is part of normal control flow (vs " -"error-handling)." -msgstr "" -"`panic` や `?`とは異なり、キャンセルは（エラー処理ではなく）通常の制御フロー" -"の一部です。" +#~ msgid "[Move Semantics](./memory-management/move.md) (10 minutes)" +#~ msgstr "[ムーブ セマンティクス](./memory-management/move.md)（10 分）" -#: src/async/pitfalls/cancellation.md -msgid "The example loses parts of the string." -msgstr "この例では、文字列の一部が失われています。" +#~ msgid "[Clone](./memory-management/clone.md) (2 minutes)" +#~ msgstr "[Clone](./memory-management/clone.md)（2 分）" -#: src/async/pitfalls/cancellation.md -msgid "" -"Whenever the `tick()` branch finishes first, `next()` and its `buf` are " -"dropped." -msgstr "" -"`tick()` 分岐が先に終了するたびに、`next()` とその `buf` がドロップされます。" +#~ msgid "[Copy Types](./memory-management/copy-types.md) (5 minutes)" +#~ msgstr "[Copy 型](./memory-management/copy-types.md)（5 分）" -#: src/async/pitfalls/cancellation.md -msgid "" -"`LinesReader` can be made cancellation-safe by making `buf` part of the " -"struct:" -msgstr "" -"`buf` を構造体の一部にすることで、`LinesReader` にキャンセル安全性を持たせる" -"ことができます。" +#~ msgid "[Drop](./memory-management/drop.md) (10 minutes)" +#~ msgstr "[Drop](./memory-management/drop.md)（10 分）" -#: src/async/pitfalls/cancellation.md -msgid "// prefix buf and bytes with self.\n" -msgstr "// buf と bytes の先頭に self を付加します。\n" +#~ msgid "" +#~ "[Exercise: Builder Type](./memory-management/exercise.md) (20 minutes)" +#~ msgstr "[演習: ビルダー型](./memory-management/exercise.md)（20 分）" -#: src/async/pitfalls/cancellation.md -msgid "" -"[`Interval::tick`](https://docs.rs/tokio/latest/tokio/time/struct.Interval." -"html#method.tick) is cancellation-safe because it keeps track of whether a " -"tick has been 'delivered'." -msgstr "" -"[`Interval::tick`](https://docs.rs/tokio/latest/tokio/time/struct.Interval." -"html#method.tick) は、ティックが「配信済み」かどうかを追跡しているため、安全" -"にキャンセルできます。" +#~ msgid "\"ptr = {ptr:#x}, len = {len}, capacity = {capacity}\"" +#~ msgstr "\"ptr = {ptr:#x}, len = {len}, capacity = {capacity}\"" -#: src/async/pitfalls/cancellation.md -msgid "" -"[`AsyncReadExt::read`](https://docs.rs/tokio/latest/tokio/io/trait." -"AsyncReadExt.html#method.read) is cancellation-safe because it either " -"returns or doesn't read data." -msgstr "" -"[`AsyncReadExt::read`](https://docs.rs/tokio/latest/tokio/io/trait." -"AsyncReadExt.html#method.read) は、データを返すか、データを読み取らないかのい" -"ずれかであるため、安全にキャンセルできます。" +#~ msgid "[Box" +#~ msgstr "[Box" -#: src/async/pitfalls/cancellation.md -msgid "" -"[`AsyncBufReadExt::read_line`](https://docs.rs/tokio/latest/tokio/io/trait." -"AsyncBufReadExt.html#method.read_line) is similar to the example and _isn't_ " -"cancellation-safe. See its documentation for details and alternatives." -msgstr "" -"[`AsyncBufReadExt::read_line`](https://docs.rs/tokio/latest/tokio/io/trait." -"AsyncBufReadExt.html#method.read_line) はこの例と類似しており、安全にキャンセ" -"ルできません。詳細と代替方法については、ドキュメントをご覧ください。" +#~ msgid "](./smart-pointers/box.md) (10 minutes)" +#~ msgstr "](./smart-pointers/box.md)（10 分）" -#: src/exercises/concurrency/afternoon.md -msgid "" -"To practice your Async Rust skills, we have again two exercises for you:" -msgstr "非同期 Rust のスキルを磨くため、ここでも 2 つの演習を行います。" +#~ msgid "[Rc](./smart-pointers/rc.md) (5 minutes)" +#~ msgstr "[Rc](./smart-pointers/rc.md)（5 分）" -#: src/exercises/concurrency/afternoon.md -msgid "" -"Dining philosophers: we already saw this problem in the morning. This time " -"you are going to implement it with Async Rust." -msgstr "" -"食事する哲学者: この問題は午前の部ですでに取り上げましたが、今回は非同期 " -"Rust を使用してこれを実装します。" +#~ msgid "[Exercise: Binary Tree](./smart-pointers/exercise.md) (30 minutes)" +#~ msgstr "[演習: バイナリツリー](./smart-pointers/exercise.md)（30 分）" -#: src/exercises/concurrency/afternoon.md -msgid "" -"A Broadcast Chat Application: this is a larger project that allows you " -"experiment with more advanced Async Rust features." -msgstr "" -"ブロードキャスト チャット アプリ: より高度な非同期 Rust 機能をテストできる大" -"規模なプロジェクトです。" +#~ msgid "" +#~ "A `Box` cannot be empty, so the pointer is always valid and non-`null`. " +#~ "This allows the compiler to optimize the memory layout:" +#~ msgstr "" +#~ "`Box` を空にすることはできないため、ポインタは常に有効かつ非 `null` になり" +#~ "ます。これにより、コンパイラがメモリ レイアウトを最適化できます。" -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -#, fuzzy -msgid "Dining Philosophers --- Async" -msgstr "食事する哲学者" +#~ msgid "" +#~ "```bob\n" +#~ " Stack Heap\n" +#~ ".- - - - - - - - - - - - - - . .- - - - - - - - - - - - - -.\n" +#~ ": : : :\n" +#~ ": list : : :\n" +#~ ": +---------+----+----+ : : +---------+----+----+ :\n" +#~ ": | Element | 1 | o--+----+-----+--->| Element | 2 | // | :\n" +#~ ": +---------+----+----+ : : +---------+----+----+ :\n" +#~ ": : : :\n" +#~ ": : : :\n" +#~ "'- - - - - - - - - - - - - - ' '- - - - - - - - - - - - - -'\n" +#~ "```" +#~ msgstr "" +#~ "```bob\n" +#~ " Stack Heap\n" +#~ ".- - - - - - - - - - - - - - . .- - - - - - - - - - - - - -.\n" +#~ ": : : :\n" +#~ ": list : : :\n" +#~ ": +---------+----+----+ : : +---------+----+----+ :\n" +#~ ": | Element | 1 | o--+----+-----+--->| Element | 2 | // | :\n" +#~ ": +---------+----+----+ : : +---------+----+----+ :\n" +#~ ": : : :\n" +#~ ": : : :\n" +#~ "'- - - - - - - - - - - - - - ' '- - - - - - - - - - - - - -'\n" +#~ "```" + +#~ msgid "[Borrowing](./borrowing.md) (1 hour)" +#~ msgstr "[借用](./borrowing.md)（1 時間）" -#: src/exercises/concurrency/dining-philosophers-async.md -msgid "" -"See [dining philosophers](dining-philosophers.md) for a description of the " -"problem." -msgstr "" -"この問題の詳細については、[食事する哲学者](dining-philosophers.md) をご覧くだ" -"さい。" +#~ msgid "" +#~ "[Slices and Lifetimes](./slices-and-lifetimes.md) (1 hour and 10 minutes)" +#~ msgstr "[スライスとライフタイム](./slices-and-lifetimes.md)（1 時間 10 分）" -#: src/exercises/concurrency/dining-philosophers-async.md -msgid "" -"As before, you will need a local [Cargo installation](../../cargo/running-" -"locally.md) for this exercise. Copy the code below to a file called `src/" -"main.rs`, fill out the blanks, and test that `cargo run` does not deadlock:" -msgstr "" -"前と同様に、この演習でもローカルの [Cargo インストール](../../cargo/running-" -"locally.md) が必要です。以下のコードを `src/main.rs` というファイルにコピー" -"し、空欄を埋めて、`cargo run` がデッドロックしないことを確認します。" +#~ msgid "[Borrowing a Value](./borrowing/shared.md) (10 minutes)" +#~ msgstr "[値の借用](./borrowing/shared.md)（10 分）" -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Make them think and eat\n" -msgstr "// 哲学者が思索と食事を行うようにする\n" +#~ msgid "[Borrow Checking](./borrowing/borrowck.md) (10 minutes)" +#~ msgstr "[借用チェック](./borrowing/borrowck.md)（10 分）" -#: src/exercises/concurrency/dining-philosophers-async.md -msgid "" -"Since this time you are using Async Rust, you'll need a `tokio` dependency. " -"You can use the following `Cargo.toml`:" -msgstr "" -"今回は非同期 Rust を使用するため、`tokio` 依存関係が必要になります。次の " -"`Cargo.toml` を使用できます。" +#~ msgid "" +#~ "[Interior Mutability](./borrowing/interior-mutability.md) (10 minutes)" +#~ msgstr "[内部可変性](./borrowing/interior-mutability.md)（10 分）" -#: src/exercises/concurrency/dining-philosophers-async.md -msgid "" -"```toml\n" -"[package]\n" -"name = \"dining-philosophers-async-dine\"\n" -"version = \"0.1.0\"\n" -"edition = \"2021\"\n" -"\n" -"[dependencies]\n" -"tokio = { version = \"1.26.0\", features = [\"sync\", \"time\", \"macros\", " -"\"rt-multi-thread\"] }\n" -"```" -msgstr "" -"```toml\n" -"[package]\n" -"name = \"dining-philosophers-async-dine\"\n" -"version = \"0.1.0\"\n" -"edition = \"2021\"\n" -"\n" -"[dependencies]\n" -"tokio = { version = \"1.26.0\", features = [\"sync\", \"time\", \"macros\", " -"\"rt-multi-thread\"] }\n" -"```" +#~ msgid "[Exercise: Health Statistics](./borrowing/exercise.md) (30 minutes)" +#~ msgstr "[演習: 健康に関する統計情報](./borrowing/exercise.md)（30 分）" -#: src/exercises/concurrency/dining-philosophers-async.md -msgid "" -"Also note that this time you have to use the `Mutex` and the `mpsc` module " -"from the `tokio` crate." -msgstr "" -"また、今度は `tokio` クレートの `Mutex` モジュールと `mpsc` モジュールを使用" -"する必要があることにも注意してください。" +#~ msgid "The Rust compiler can do return value optimization (RVO)." +#~ msgstr "Rust コンパイラは戻り値の最適化（RVO）を行うことができます。" -#: src/exercises/concurrency/dining-philosophers-async.md -msgid "Can you make your implementation single-threaded?" -msgstr "実装をシングルスレッドにできますか？" +#~ msgid "" +#~ "In C++, copy elision has to be defined in the language specification " +#~ "because constructors can have side effects. In Rust, this is not an issue " +#~ "at all. If RVO did not happen, Rust will always perform a simple and " +#~ "efficient `memcpy` copy." +#~ msgstr "" +#~ "C++ では、コンストラクタが副作用をもたらす可能性があるため、言語仕様でコ" +#~ "ピー省略を定義する必要があります。Rust では、これはまったく問題になりませ" +#~ "ん。RVO が行われなかった場合でも、Rust は常にシンプルで効率的な `memcpy` " +#~ "コピーを実行します。" -#: src/exercises/concurrency/chat-app.md -msgid "" -"In this exercise, we want to use our new knowledge to implement a broadcast " -"chat application. We have a chat server that the clients connect to and " -"publish their messages. The client reads user messages from the standard " -"input, and sends them to the server. The chat server broadcasts each message " -"that it receives to all the clients." -msgstr "" -"この演習では、新たに身に付けた知識を活かしてブロードキャスト チャット アプリ" -"を実装します。クライアントが接続してメッセージを公開するチャット サーバーがあ" -"ります。クライアントは標準入力からユーザー メッセージを読み取り、サーバーに送" -"信します。チャット サーバーは受信した各メッセージをすべてのクライアントにブ" -"ロードキャストします。" +#~ msgid "\"graph: {root:#?}\"" +#~ msgstr "\"graph: {root:#?}\"" -#: src/exercises/concurrency/chat-app.md -msgid "" -"For this, we use [a broadcast channel](https://docs.rs/tokio/latest/tokio/" -"sync/broadcast/fn.channel.html) on the server, and [`tokio_websockets`]" -"(https://docs.rs/tokio-websockets/) for the communication between the client " -"and the server." -msgstr "" -"このために、サーバー上の [ブロードキャスト チャンネル](https://docs.rs/tokio/" -"latest/tokio/sync/broadcast/fn.channel.html) を使用し、クライアントとサーバー" -"間の通信には [`tokio_websockets`](https://docs.rs/tokio-websockets/) を使用し" -"ます。" +#~ msgid "\"graph sum: {}\"" +#~ msgstr "\"graph sum: {}\"" -#: src/exercises/concurrency/chat-app.md -msgid "Create a new Cargo project and add the following dependencies:" -msgstr "新しい Cargo プロジェクトを作成し、次の依存関係を追加します。" +#~ msgid "" +#~ "`Rc` only allows shared (read-only) access to its contents, since its " +#~ "purpose is to allow (and count) many references. But we want to modify " +#~ "the value, so we need interior mutability." +#~ msgstr "" +#~ "`Rc` は多くの参照を許可（およびカウント）することを目的としているため、コ" +#~ "ンテンツへの共有（読み取り専用）アクセスのみを許可します。しかし、ここでは" +#~ "値を変更したいので、内部可変性が必要です。" -#: src/exercises/concurrency/chat-app.md -msgid "_Cargo.toml_:" -msgstr "_Cargo.toml_:" +#~ msgid "" +#~ "Demonstrate that reference loops can be created by adding `root` to " +#~ "`subtree.children`." +#~ msgstr "" +#~ "`subtree.children` に `root` を追加して参照ループを作成できることを示しま" +#~ "す。" -#: src/exercises/concurrency/chat-app.md -msgid "" -"```toml\n" -"[package]\n" -"name = \"chat-async\"\n" -"version = \"0.1.0\"\n" -"edition = \"2021\"\n" -"\n" -"[dependencies]\n" -"futures-util = { version = \"0.3.30\", features = [\"sink\"] }\n" -"http = \"1.0.0\"\n" -"tokio = { version = \"1.28.1\", features = [\"full\"] }\n" -"tokio-websockets = { version = \"0.5.1\", features = [\"client\", " -"\"fastrand\", \"server\", \"sha1_smol\"] }\n" -"```" -msgstr "" -"```toml\n" -"[package]\n" -"name = \"chat-async\"\n" -"version = \"0.1.0\"\n" -"edition = \"2021\"\n" -"\n" -"[dependencies]\n" -"futures-util = { version = \"0.3.30\", features = [\"sink\"] }\n" -"http = \"1.0.0\"\n" -"tokio = { version = \"1.28.1\", features = [\"full\"] }\n" -"tokio-websockets = { version = \"0.5.1\", features = [\"client\", " -"\"fastrand\", \"server\", \"sha1_smol\"] }\n" -"```" +#~ msgid "" +#~ "To demonstrate a runtime panic, add a `fn inc(&mut self)` that increments " +#~ "`self.value` and calls the same method on its children. This will panic " +#~ "in the presence of the reference loop, with `thread 'main' panicked at " +#~ "'already borrowed: BorrowMutError'`." +#~ msgstr "" +#~ "実行時のパニックを示すため、`self.value` をインクリメントしてその子に対し" +#~ "て同じメソッドを呼び出す `fn inc(&mut self)` を追加します。これは、参照" +#~ "ループがあるとパニックとなり、`thread 'main' panicked at 'already " +#~ "borrowed: BorrowMutError'` というエラーが出力されます。" -#: src/exercises/concurrency/chat-app.md -msgid "The required APIs" -msgstr "必要な API" +#~ msgid "[Slices: &\\[T\\]](./slices-and-lifetimes/slices.md) (10 minutes)" +#~ msgstr "[Slices: &\\[T\\]](./slices-and-lifetimes/slices.md)（10 分）" -#: src/exercises/concurrency/chat-app.md -msgid "" -"You are going to need the following functions from `tokio` and " -"[`tokio_websockets`](https://docs.rs/tokio-websockets/). Spend a few minutes " -"to familiarize yourself with the API." -msgstr "" -"`tokio` と [`tokio_websockets`](https://docs.rs/tokio-websockets/) の以下の関" -"数が必要になります。少し時間をかけて API に対する理解を深めてください。" +#~ msgid "[String References](./slices-and-lifetimes/str.md) (10 minutes)" +#~ msgstr "[文字列参照](./slices-and-lifetimes/str.md)（10 分）" + +#~ msgid "" +#~ "[Lifetime Annotations](./slices-and-lifetimes/lifetime-annotations.md) " +#~ "(10 minutes)" +#~ msgstr "" +#~ "[ライフタイム アノテーション](./slices-and-lifetimes/lifetime-annotations." +#~ "md)（10 分）" + +#~ msgid "" +#~ "[Lifetime Elision](./slices-and-lifetimes/lifetime-elision.md) (5 minutes)" +#~ msgstr "" +#~ "[ライフタイムの省略](./slices-and-lifetimes/lifetime-elision.md)（5 分）" + +#~ msgid "" +#~ "[Struct Lifetimes](./slices-and-lifetimes/struct-lifetimes.md) (5 minutes)" +#~ msgstr "" +#~ "[構造体のライフタイム](./slices-and-lifetimes/struct-lifetimes.md)（5 分）" -#: src/exercises/concurrency/chat-app.md -msgid "" -"[StreamExt::next()](https://docs.rs/futures-util/0.3.28/futures_util/stream/" -"trait.StreamExt.html#method.next) implemented by `WebSocketStream`: for " -"asynchronously reading messages from a Websocket Stream." -msgstr "" -"`WebSocketStream` によって実装された [StreamExt::next()](https://docs.rs/" -"futures-util/0.3.28/futures_util/stream/trait.StreamExt.html#method.next): " -"Websocket Stream からのメッセージを非同期で読み取ります。" +#~ msgid "" +#~ "[Exercise: Protobuf Parsing](./slices-and-lifetimes/exercise.md) (30 " +#~ "minutes)" +#~ msgstr "" +#~ "[演習: Protobuf の解析](./slices-and-lifetimes/exercise.md)（30 分）" -#: src/exercises/concurrency/chat-app.md -msgid "" -"[SinkExt::send()](https://docs.rs/futures-util/0.3.28/futures_util/sink/" -"trait.SinkExt.html#method.send) implemented by `WebSocketStream`: for " -"asynchronously sending messages on a Websocket Stream." -msgstr "" -"`WebSocketStream` によって実装された [SinkExt::send()](https://docs.rs/" -"futures-util/0.3.28/futures_util/sink/trait.SinkExt.html#method.send): " -"Websocket Stream 上でメッセージを非同期で送信します。" +#~ msgid "" +#~ "We can now understand the two string types in Rust: `&str` is almost like " +#~ "`&[char]`, but with its data stored in a variable-length encoding (UTF-8)." +#~ msgstr "" +#~ "これで、Rust の 2 つの文字列型を理解できるようになりました。`&str` は " +#~ "`&[char]` とほぼ同じですが、そのデータは可変長エンコード（UTF-8）で保存さ" +#~ "れます。" -#: src/exercises/concurrency/chat-app.md -msgid "" -"[Lines::next_line()](https://docs.rs/tokio/latest/tokio/io/struct.Lines." -"html#method.next_line): for asynchronously reading user messages from the " -"standard input." -msgstr "" -"[Lines::next_line()](https://docs.rs/tokio/latest/tokio/io/struct.Lines." -"html#method.next_line): 標準入力からのユーザー メッセージを非同期で読み取りま" -"す。" +#~ msgid "Rust terminology:" +#~ msgstr "Rust の用語:" -#: src/exercises/concurrency/chat-app.md -msgid "" -"[Sender::subscribe()](https://docs.rs/tokio/latest/tokio/sync/broadcast/" -"struct.Sender.html#method.subscribe): for subscribing to a broadcast channel." -msgstr "" -"[Sender::subscribe()](https://docs.rs/tokio/latest/tokio/sync/broadcast/" -"struct.Sender.html#method.subscribe): ブロードキャスト チャンネルをサブスクラ" -"イブします。" +#~ msgid "`&str` an immutable reference to a string slice." +#~ msgstr "`&str`: 文字列スライスへの不変の参照。" -#: src/exercises/concurrency/chat-app.md -msgid "Two binaries" -msgstr "2 つのバイナリ" +#~ msgid "`String` a mutable string buffer." +#~ msgstr "`String`: 可変の文字列バッファ。" -#: src/exercises/concurrency/chat-app.md -msgid "" -"Normally in a Cargo project, you can have only one binary, and one `src/main." -"rs` file. In this project, we need two binaries. One for the client, and one " -"for the server. You could potentially make them two separate Cargo projects, " -"but we are going to put them in a single Cargo project with two binaries. " -"For this to work, the client and the server code should go under `src/bin` " -"(see the [documentation](https://doc.rust-lang.org/cargo/reference/cargo-" -"targets.html#binaries))." -msgstr "" -"通常、Cargo プロジェクトに含めることができるのは 1 つのバイナリと 1 つの " -"`src/main.rs` ファイルのみです。このプロジェクトには 2 つのバイナリが必要で" -"す。1 つはクライアント用、もう 1 つはサーバー用です。2 つの独立した Cargo プ" -"ロジェクトを作成することもできますが、ここでは 1 つの Cargo プロジェクトに 2 " -"つのバイナリを入れます。そのためには、クライアントとサーバーのコードを `src/" -"bin` に配置する必要があります（[ドキュメント](https://doc.rust-lang.org/" -"cargo/reference/cargo-targets.html#binaries) をご覧ください）。" +#~ msgid "\"Unexpected wire-type)\"" +#~ msgstr "\"Unexpected wire-type)\"" -#: src/exercises/concurrency/chat-app.md -msgid "" -"Copy the following server and client code into `src/bin/server.rs` and `src/" -"bin/client.rs`, respectively. Your task is to complete these files as " -"described below." -msgstr "" -"次のサーバーとクライアントのコードを、それぞれ`src/bin/server.rs` と `src/" -"bin/client.rs` にコピーします。ここでのタスクは、以下で説明するように、これら" -"のファイルを完成させることです。" +#~ msgid "\"Invalid string (not UTF-8)\"" +#~ msgstr "\"Invalid string (not UTF-8)\"" -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "_src/bin/server.rs_:" -msgstr "_src/bin/server.rs_:" +#~ msgid "// Unwrap error because `value` is definitely 4 bytes long.\n" +#~ msgstr "" +#~ "// `value` の長さは明らかに 4 バイトであるため、エラーをアンラップしま" +#~ "す。\n" -#: src/exercises/concurrency/chat-app.md -msgid "// TODO: For a hint, see the description of the task below.\n" -msgstr "// TODO: ヒントについては、以下のタスクの説明をご覧ください。\n" +#~ msgid "b\"hello\"" +#~ msgstr "b\"hello\"" -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"127.0.0.1:2000\"" -msgstr "\"127.0.0.1:2000\"" +#~ msgid "[Welcome](./welcome-day-4.md) (3 minutes)" +#~ msgstr "[ようこそ](./welcome-day-4.md)（3 分）" -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"listening on port 2000\"" -msgstr "\"listening on port 2000\"" +#~ msgid "[Iterators](./iterators.md) (45 minutes)" +#~ msgstr "[イテレータ](./iterators.md)（45 分）" -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"New connection from {addr:?}\"" -msgstr "\"New connection from {addr:?}\"" +#~ msgid "[Modules](./modules.md) (40 minutes)" +#~ msgstr "[モジュール](./modules.md)（40 分）" -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Wrap the raw TCP stream into a websocket.\n" -msgstr "// 未加工の TCP ストリームを WebSocket にラップします。\n" +#~ msgid "[Iterator](./iterators/iterator.md) (5 minutes)" +#~ msgstr "[Iterator](./iterators/iterator.md)（5 分）" -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "_src/bin/client.rs_:" -msgstr "_src/bin/client.rs_:" +#~ msgid "[IntoIterator](./iterators/intoiterator.md) (5 minutes)" +#~ msgstr "[IntoIterator](./iterators/intoiterator.md)（5 分）" -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"ws://127.0.0.1:2000\"" -msgstr "\"ws://127.0.0.1:2000\"" +#~ msgid "[FromIterator](./iterators/fromiterator.md) (5 minutes)" +#~ msgstr "[FromIterator](./iterators/fromiterator.md)（5 分）" -#: src/exercises/concurrency/chat-app.md -msgid "Running the binaries" -msgstr "バイナリの実行" +#~ msgid "" +#~ "[Exercise: Iterator Method Chaining](./iterators/exercise.md) (30 minutes)" +#~ msgstr "" +#~ "[演習: イテレータ メソッドのチェーン化](./iterators/exercise.md)（30 分）" -#: src/exercises/concurrency/chat-app.md -msgid "Run the server with:" -msgstr "次のコマンドでサーバーを実行します。" +#~ msgid "[Modules](./modules/modules.md) (5 minutes)" +#~ msgstr "[モジュール](./modules/modules.md)（5 分）" -#: src/exercises/concurrency/chat-app.md -msgid "and the client with:" -msgstr "次のコマンドでクライアントを実行します。" +#~ msgid "[Filesystem Hierarchy](./modules/filesystem.md) (5 minutes)" +#~ msgstr "[ファイル システム階層](./modules/filesystem.md)（5 分）" -#: src/exercises/concurrency/chat-app.md -msgid "Implement the `handle_connection` function in `src/bin/server.rs`." -msgstr "`src/bin/server.rs` に `handle_connection` 関数を実装します。" +#~ msgid "[Visibility](./modules/visibility.md) (5 minutes)" +#~ msgstr "[可視性](./modules/visibility.md)（5 分）" -#: src/exercises/concurrency/chat-app.md -msgid "" -"Hint: Use `tokio::select!` for concurrently performing two tasks in a " -"continuous loop. One task receives messages from the client and broadcasts " -"them. The other sends messages received by the server to the client." -msgstr "" -"ヒント: 2 つのタスクを連続ループで同時に実行するには、`tokio::select!` を使用" -"します。1 つのタスクは、クライアントからメッセージを受信してブロードキャスト" -"します。もう 1 つのタスクは、サーバーで受信したメッセージをクライアントに送信" -"します。" +#~ msgid "[use, super, self](./modules/paths.md) (10 minutes)" +#~ msgstr "[use、super、self](./modules/paths.md)（10 分）" -#: src/exercises/concurrency/chat-app.md -msgid "Complete the main function in `src/bin/client.rs`." -msgstr "`src/bin/client.rs` のメイン関数を完成させます。" +#~ msgid "" +#~ "[Exercise: Modules for a GUI Library](./modules/exercise.md) (15 minutes)" +#~ msgstr "[演習: GUI ライブラリのモジュール](./modules/exercise.md)（15 分）" -#: src/exercises/concurrency/chat-app.md -msgid "" -"Hint: As before, use `tokio::select!` in a continuous loop for concurrently " -"performing two tasks: (1) reading user messages from standard input and " -"sending them to the server, and (2) receiving messages from the server, and " -"displaying them for the user." -msgstr "" -"ヒント: 前の例と同様に、`tokio::select!` を連続ループで使用し、（1）標準入力" -"からユーザー メッセージを読み取ってサーバーに送信するタスクと、（2）サーバー" -"からメッセージを受信してユーザーに表示するタスクを同時に実行します。" +#~ msgid "[Test Modules](./testing/unit-tests.md) (5 minutes)" +#~ msgstr "[テスト] モジュール(./testing/unit-tests.md)（5 分）" -#: src/exercises/concurrency/chat-app.md -msgid "" -"Optional: Once you are done, change the code to broadcast messages to all " -"clients, but the sender of the message." -msgstr "" -"省略可: 完了したら、メッセージの送信者以外のすべてのクライアントにメッセージ" -"をブロードキャストするようにコードを変更します。" +#~ msgid "[Other Types of Tests](./testing/other.md) (10 minutes)" +#~ msgstr "[その他の種類のテスト](./testing/other.md)（10 分）" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "Concurrency Afternoon Exercise" -msgstr "午後の同時実行のエクササイズ" +#~ msgid "[Useful Crates](./testing/useful-crates.md) (3 minutes)" +#~ msgstr "[便利なクレート](./testing/useful-crates.md)（3 分）" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "([back to exercise](dining-philosophers-async.md))" -msgstr "（[演習に戻る](dining-philosophers-async.md)）" +#~ msgid "[GoogleTest](./testing/googletest.md) (5 minutes)" +#~ msgstr "[GoogleTest](./testing/googletest.md)（5 分）" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "" -"// Add a delay before picking the second fork to allow the execution\n" -" // to transfer to another task\n" -msgstr "" -"// 実行を別のタスクに転送できるよう、2 番目のフォークを選択する前に\n" -" // 遅延を追加します。\n" +#~ msgid "[Mocking](./testing/mocking.md) (5 minutes)" +#~ msgstr "[モック](./testing/mocking.md)（5 分）" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// The locks are dropped here\n" -msgstr "// ここでロックがドロップされます。\n" +#~ msgid "[Compiler Lints and Clippy](./testing/lints.md) (5 minutes)" +#~ msgstr "[コンパイラの リント と Clippy](./testing/lints.md)（5 分）" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "" -"// To avoid a deadlock, we have to break the symmetry\n" -" // somewhere. This will swap the forks without deinitializing\n" -" // either of them.\n" -msgstr "" -"// デッドロックを避けるために、どこかで対称性を\n" -" // 崩す必要があります。これにより、いずれのフォークも初期化解除す" -"ることなく、フォークが\n" -" // スワップされます。\n" +#~ msgid "[Exercise: Luhn Algorithm](./testing/exercise.md) (30 minutes)" +#~ msgstr "[演習: Luhn アルゴリズム](./testing/exercise.md)（30 分）" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// tx is dropped here, so we don't need to explicitly drop it later\n" -msgstr "" -"// tx はここでドロップされるので、後で明示的に削除する必要はありません。\n" +#~ msgid "Rust comes with only basic support for writing tests." +#~ msgstr "Rust は、テストを作成するための基本的なサポートのみを提供します。" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"Here is a thought: {thought}\"" -msgstr "\"Here is a thought: {thought}\"" +#~ msgid "" +#~ "Here are some additional crates which we recommend for writing tests:" +#~ msgstr "テストを作成する際に推奨されるその他のクレートを以下に示します。" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "([back to exercise](chat-app.md))" -msgstr "（[演習に戻る](chat-app.md)）" +#~ msgid "" +#~ "[googletest](https://docs.rs/googletest): Comprehensive test assertion " +#~ "library in the tradition of GoogleTest for C++." +#~ msgstr "" +#~ "[googletest](https://docs.rs/googletest): 従来の C++ 向け GoogleTestのよう" +#~ "な包括的なテスト アサーション ライブラリです。" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"Welcome to chat! Type a message\"" -msgstr "\"Welcome to chat! Type a message\"" +#~ msgid "" +#~ "[proptest](https://docs.rs/proptest): Property-based testing for Rust." +#~ msgstr "" +#~ "[proptest](https://docs.rs/proptest): Rust のプロパティ ベースのテストで" +#~ "す。" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "" -"// A continuous loop for concurrently performing two tasks: (1) receiving\n" -" // messages from `ws_stream` and broadcasting them, and (2) receiving\n" -" // messages on `bcast_rx` and sending them to the client.\n" -msgstr "" -"// (1) `ws_stream` からメッセージを受信してブロードキャストするタスクと、\n" -" // （2）`bcast_rx` でメッセージを受信してクライアントに送信しするタスク" -"を\n" -" // 同時に実行するための連続ループ。\n" +#~ msgid "" +#~ "[rstest](https://docs.rs/rstest): Support for fixtures and parameterised " +#~ "tests." +#~ msgstr "" +#~ "[rstest](https://docs.rs/rstest): フィクスチャとパラメータ化されたテストを" +#~ "サポートします。" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"From client {addr:?} {text:?}\"" -msgstr "\"From client {addr:?} {text:?}\"" +#~ msgid "This just scratches the surface, there are many builtin matchers." +#~ msgstr "" +#~ "ここで扱っているものはごく一部であり、他にも多くの組み込みマッチャーがあり" +#~ "ます。" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Continuous loop for concurrently sending and receiving messages.\n" -msgstr "// メッセージの同時送受信のための継続的なループ。\n" +#~ msgid "GoogleTest is available for use in AOSP." +#~ msgstr "GoogleTest は AOSP で使用できます。" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"From server: {}\"" -msgstr "\"From server: {}\"" +#~ msgid "[Error Handling](./error-handling.md) (45 minutes)" +#~ msgstr "[エラー処理](./error-handling.md)（45 分）" -#: src/thanks.md -msgid "" -"_Thank you for taking Comprehensive Rust 🦀!_ We hope you enjoyed it and " -"that it was useful." -msgstr "Comprehensive Rust 🦀! を受講いただきありがとうございました。" +#~ msgid "[Unsafe Rust](./unsafe-rust.md) (1 hour and 5 minutes)" +#~ msgstr "[アンセーフRust](./unsafe-rust.md)（1 時間 5 分）" -#: src/thanks.md -msgid "" -"We've had a lot of fun putting the course together. The course is not " -"perfect, so if you spotted any mistakes or have ideas for improvements, " -"please get in [contact with us on GitHub](https://github.com/google/" -"comprehensive-rust/discussions). We would love to hear from you." -msgstr "" -"ここまで多くのことを学んできましたが、このコースは完璧ではないため、間違いを" -"見つけた場合や改善のアイデアがある場合は [GitHub でお知らせください](https://" -"github.com/google/comprehensive-rust/discussions)。皆さんからのフィードバック" -"をお待ちしています。" +#~ msgid "Including 10 minute breaks, this session should take about 2 hours" +#~ msgstr "このセッションの所要時間は、10 分間の休憩を入れて約 2 時間です。" -#: src/glossary.md -msgid "" -"The following is a glossary which aims to give a short definition of many " -"Rust terms. For translations, this also serves to connect the term back to " -"the English original." -msgstr "" -"以下は、Rust の多くの用語を簡単に定義することを目的とした用語集です。翻訳時に" -"用語を英語の原文に関連付けるのにも役立ちます。" +#~ msgid "[Panics](./error-handling/panics.md) (3 minutes)" +#~ msgstr "[パニック](./error-handling/panics.md)（3 分）" -#: src/glossary.md -msgid "" -"allocate: \n" -"Dynamic memory allocation on [the heap](memory-management/stack-vs-heap.md)." -msgstr "" -"割り当て（allocate）: \n" -"[ヒープ](memory-management/stack-vs-heap.md) での動的メモリ割り当て。" +#~ msgid "[Try Operator](./error-handling/try.md) (5 minutes)" +#~ msgstr "[try 演算子](./error-handling/try.md)（5 分）" -#: src/glossary.md -msgid "" -"argument: \n" -"Information that is passed into a function or method." -msgstr "" -"引数（argument）: \n" -"関数またはメソッドに渡される情報。" +#~ msgid "[Try Conversions](./error-handling/try-conversions.md) (5 minutes)" +#~ msgstr "[try 変換](./error-handling/try-conversions.md)（5 分）" -#: src/glossary.md -msgid "" -"Bare-metal Rust: \n" -"Low-level Rust development, often deployed to a system without an operating " -"system. See [Bare-metal Rust](bare-metal.md)." -msgstr "" -"ベアメタル Rust（Bare-metal Rust）: \n" -"低レベルの Rust 開発。多くの場合、オペレーティング システムのないシステムにデ" -"プロイされます。[ベアメタル Rust](bare-metal.md) をご覧ください。" +#~ msgid "[Error Trait](./error-handling/error.md) (5 minutes)" +#~ msgstr "[エラートレイト](./error-handling/error.md)（5 分）" -#: src/glossary.md -msgid "" -"block: \n" -"See [Blocks](control-flow/blocks.md) and _scope_." -msgstr "" -"ブロック（block）: \n" -"[ブロック](control-flow/blocks.md) とスコープをご覧ください。" +#~ msgid "" +#~ "[thiserror and anyhow](./error-handling/thiserror-and-anyhow.md) (5 " +#~ "minutes)" +#~ msgstr "" +#~ "[thiserror と anyhow](./error-handling/thiserror-and-anyhow.md)（5 分）" -#: src/glossary.md -msgid "" -"borrow: \n" -"See [Borrowing](ownership/borrowing.md)." -msgstr "" -"借用（borrow）: \n" -"[借用](ownership/borrowing.md) をご覧ください。" +#~ msgid "" +#~ "[Exercise: Rewriting with Result](./error-handling/exercise.md) (20 " +#~ "minutes)" +#~ msgstr "" +#~ "[演習: Result を使用した書き換え](./error-handling/exercise.md)（20 分）" -#: src/glossary.md -msgid "" -"borrow checker: \n" -"The part of the Rust compiler which checks that all borrows are valid." -msgstr "" -"借用チェッカー（borrow checker）: \n" -"Rust コンパイラの一部。すべての借用が有効かどうかをチェックします。" +#~ msgid "[Unsafe](./unsafe-rust/unsafe.md) (5 minutes)" +#~ msgstr "[アンセーフRust](./unsafe-rust/unsafe.md)（5 分）" -#: src/glossary.md -msgid "" -"brace: \n" -"`{` and `}`. Also called _curly brace_, they delimit _blocks_." -msgstr "" -"中かっこ（brace）: \n" -"`{` and `}`。ブロックを区切ります。" +#~ msgid "" +#~ "[Dereferencing Raw Pointers](./unsafe-rust/dereferencing.md) (10 minutes)" +#~ msgstr "[未加工ポインタの参照外し](./unsafe-rust/dereferencing.md)（10 分）" -#: src/glossary.md -msgid "" -"build: \n" -"The process of converting source code into executable code or a usable " -"program." -msgstr "" -"ビルド（build）: \n" -"ソースコードを実行可能なコードまたは使用可能なプログラムに変換するプロセス。" +#~ msgid "" +#~ "[Mutable Static Variables](./unsafe-rust/mutable-static.md) (5 minutes)" +#~ msgstr "[可変の静的変数](./unsafe-rust/mutable-static.md)（5 分）" -#: src/glossary.md -msgid "" -"call: \n" -"To invoke or execute a function or method." -msgstr "" -"呼び出し（call）: \n" -"関数またはメソッドを呼び出します。" +#~ msgid "[Unions](./unsafe-rust/unions.md) (5 minutes)" +#~ msgstr "[共用体](./unsafe-rust/unions.md)（5 分）" -#: src/glossary.md -msgid "" -"channel: \n" -"Used to safely pass messages [between threads](concurrency/channels.md)." -msgstr "" -"チャンネル（channel）: \n" -"[スレッド間](concurrency/channels.md) でメッセージを安全に渡すために使用され" -"ます。" +#~ msgid "[Unsafe Functions](./unsafe-rust/unsafe-functions.md) (5 minutes)" +#~ msgstr "[アンセーフな関数](./unsafe-rust/unsafe-functions.md)（5 分）" -#: src/glossary.md -msgid "" -"Comprehensive Rust 🦀: \n" -"The courses here are jointly called Comprehensive Rust 🦀." -msgstr "" -"Comprehensive Rust 🦀: \n" -"このコースは、まとめて Comprehensive Rust 🦀 と呼びます。" +#~ msgid "[Unsafe Traits](./unsafe-rust/unsafe-traits.md) (5 minutes)" +#~ msgstr "[アンセーフなトレイト](./unsafe-rust/unsafe-traits.md)（5 分）" -#: src/glossary.md -msgid "" -"concurrency: \n" -"The execution of multiple tasks or processes at the same time." -msgstr "" -"同時実行（concurrency）: \n" -"複数のタスクまたはプロセスを同時に実行することを指します。" +#~ msgid "[Exercise: FFI Wrapper](./unsafe-rust/exercise.md) (30 minutes)" +#~ msgstr "[演習: FFI ラッパー](./unsafe-rust/exercise.md)（30 分）" -#: src/glossary.md -msgid "" -"Concurrency in Rust: \n" -"See [Concurrency in Rust](concurrency.md)." -msgstr "" -"Rust での同時実行（Concurrency in Rust）: \n" -"[Rust での同時実行](concurrency.md) をご覧ください。" +#~ msgid "// Undefined behavior if abs misbehaves.\n" +#~ msgstr "// abs 誤動作の場合の動作は未定義。\n" -#: src/glossary.md -msgid "" -"constant: \n" -"A value that does not change during the execution of a program." -msgstr "" -"定数（constant）: \n" -"プログラムの実行中に変更されない値。" +#~ msgid "// Safe because ...\n" +#~ msgstr "// 安全です。理由は...\n" -#: src/glossary.md -msgid "" -"control flow: \n" -"The order in which the individual statements or instructions are executed in " -"a program." -msgstr "" -"制御フロー（control flow）: \n" -"個々のステートメントまたは命令がプログラム内で実行される順序。" +#~ msgid "" +#~ "Add `vendor_available: true` if your AIDL file is used by a binary in the " +#~ "vendor partition." +#~ msgstr "" +#~ "AIDL ファイルがベンダー パーティション内のバイナリで使用されている場合は、" +#~ "`vendor_available: true` を追加します。" -#: src/glossary.md -msgid "" -"crash: \n" -"An unexpected and unhandled failure or termination of a program." -msgstr "" -"クラッシュ（crash）: \n" -"予期しない制御不能なエラーまたは終了。" +#~ msgid "/// Connect to the BirthdayService.\n" +#~ msgstr "/// BirthdayService に接続します。\n" -#: src/glossary.md -msgid "" -"enumeration: \n" -"A data type that holds one of several named constants, possibly with an " -"associated tuple or struct." -msgstr "" -"列挙型（enumeration）: \n" -"複数の名前付き定数のうちの 1 つを保持するデータ型。関連するタプルまたは構造体" -"を伴う場合があります。" +#~ msgid "" +#~ "// SAFETY: `print_card` is safe to call with a valid `card` pointer.\n" +#~ msgstr "" +#~ "// SAFETY: `print_card` は有効な `card` ポインタで安全に呼び出せます。\n" -#: src/glossary.md -msgid "" -"error: \n" -"An unexpected condition or result that deviates from the expected behavior." -msgstr "" -"エラー（error）: \n" -"想定された動作から逸脱した、予期しない条件または結果。" +#~ msgid "ADC" +#~ msgstr "ADC" -#: src/glossary.md -msgid "" -"error handling: \n" -"The process of managing and responding to errors that occur during program " -"execution." -msgstr "" -"エラー処理（error handling）: \n" -"プログラムの実行中に発生するエラーを管理し、それに対応するプロセス。" +#~ msgid "I2C, SPI, UART, CAN" +#~ msgstr "I2C、SPI、UART、CAN" -#: src/glossary.md -msgid "" -"exercise: \n" -"A task or problem designed to practice and test programming skills." -msgstr "" -"演習（exercise:）: \n" -"プログラミング スキルの向上とテストを目的としたタスクまたは問題。" +#~ msgid "RNG" +#~ msgstr "RNG" -#: src/glossary.md -msgid "" -"function: \n" -"A reusable block of code that performs a specific task." -msgstr "" -"関数（function）: \n" -"特定のタスクを実行する再利用可能なコードブロック。" +#~ msgid "Timers" +#~ msgstr "タイマー" -#: src/glossary.md -msgid "" -"garbage collector: \n" -"A mechanism that automatically frees up memory occupied by objects that are " -"no longer in use." -msgstr "" -"ガベージ コレクタ（garbage collector）: \n" -"使用されなくなったオブジェクトが占有していたメモリを自動的に解放するメカニズ" -"ム。" +#~ msgid "Watchdogs" +#~ msgstr "ウォッチドッグ" -#: src/glossary.md -msgid "" -"generics: \n" -"A feature that allows writing code with placeholders for types, enabling " -"code reuse with different data types." -msgstr "" -"ジェネリクス（generics）: \n" -"型のプレースホルダを使用してコードを記述し、さまざまなデータ型でコードを再利" -"用できるようにする機能。" +#~ msgid "" +#~ "There is work in progress on an `async` version of `embedded-hal`, but it " +#~ "isn't stable yet." +#~ msgstr "" +#~ "`embedded-hal`の`async`バージョンも開発中ですが、まだ安定してはいません。" -#: src/glossary.md -msgid "" -"immutable: \n" -"Unable to be changed after creation." -msgstr "" -"不変（immutable）: \n" -" 作成後に変更できないこと。" +#~ msgid "" +#~ "// Set up the I2C controller and Inertial Measurement Unit.\n" +#~ " // TODO\n" +#~ msgstr "" +#~ "// I2C コントローラと慣性測定ユニットをセットアップします。\n" +#~ " // TODO\n" -#: src/glossary.md -msgid "" -"integration test: \n" -"A type of test that verifies the interactions between different parts or " -"components of a system." -msgstr "" -"統合テスト（integration test）: \n" -"システムのさまざまな部分やコンポーネント間の相互作用を検証するテストの一種。" +#~ msgid "" +#~ "// Read compass data and log it to the serial port.\n" +#~ " // TODO\n" +#~ msgstr "" +#~ "// コンパスデータを読み取り、シリアルポートに記録します。\n" +#~ " // TODO\n" -#: src/glossary.md -msgid "" -"keyword: \n" -"A reserved word in a programming language that has a specific meaning and " -"cannot be used as an identifier." -msgstr "" -"キーワード（keyword）: \n" -"特定の意味を持ち、識別子として使用できない、プログラミング言語の予約語。" +#~ msgid "// TODO: Create instance of RTC driver and print current time.\n" +#~ msgstr "" +#~ "// TODO: RTC ドライバのインスタンスを作成し、現在の時刻を出力します。\n" -#: src/glossary.md -msgid "" -"library: \n" -"A collection of precompiled routines or code that can be used by programs." -msgstr "" -"ライブラリ（library）: \n" -"プログラムで使用できるプリコンパイル済みのルーチンまたはコードのコレクショ" -"ン。" +#~ msgid "// TODO: Wait for 3 seconds.\n" +#~ msgstr "// TODO: 3 秒間待機します。\n" -#: src/glossary.md -msgid "" -"macro: \n" -"Rust macros can be recognized by a `!` in the name. Macros are used when " -"normal functions are not enough. A typical example is `format!`, which takes " -"a variable number of arguments, which isn't supported by Rust functions." -msgstr "" -"マクロ（macro）: \n" -"Rust マクロは名前に `!` を含めることで認識できます。マクロは、通常の関数では" -"不十分な場合に使用されます。典型的な例が `format!` です。これは可変長引数を取" -"りますが、Rust 関数ではサポートされていません。" +#~ msgid "" +#~ "// Copyright 2023 Google LLC\n" +#~ "//\n" +#~ "// Licensed under the Apache License, Version 2.0 (the \"License\");\n" +#~ "// you may not use this file except in compliance with the License.\n" +#~ "// You may obtain a copy of the License at\n" +#~ "//\n" +#~ "// http://www.apache.org/licenses/LICENSE-2.0\n" +#~ "//\n" +#~ "// Unless required by applicable law or agreed to in writing, software\n" +#~ "// distributed under the License is distributed on an \"AS IS\" BASIS,\n" +#~ "// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or " +#~ "implied.\n" +#~ "// See the License for the specific language governing permissions and\n" +#~ "// limitations under the License.\n" +#~ msgstr "" +#~ "// Copyright 2023 Google LLC\n" +#~ "//\n" +#~ "// バージョン 2.0 の Apache ライセンス（以下「本ライセンス」）により使用が" +#~ "許諾されています。\n" +#~ "// このファイルを使用するには、本ライセンスに準拠する必要があります。\n" +#~ " // 本ライセンスのコピーは下記のリンクから入手できます。\n" +#~ "//\n" +#~ "// http://www.apache.org/licenses/LICENSE-2.0\n" +#~ "//\n" +#~ "// 本ライセンスで配布されるソフトウェアは、\n" +#~ "// 適用される法律によって要求される場合または書面で合意した場合を除き、\n" +#~ "// 明示されるか黙示されるかを問わず、いかなる種類の保証も条件もなく、「現" +#~ "状有姿」で提供されます。\n" +#~ "// 本ライセンスの下で適用される具体的な許可および制限については、\n" +#~ "// ライセンス本文をご覧ください。\n" -#: src/glossary.md -msgid "" -"`main` function: \n" -"Rust programs start executing with the `main` function." -msgstr "" -"`main` 関数（`main` function）: \n" -"Rust プログラムの実行は `main` 関数で開始されます。" +#~ msgid "\"sync_exception_current\"" +#~ msgstr "\"sync_exception_current\"" -#: src/glossary.md -msgid "" -"match: \n" -"A control flow construct in Rust that allows for pattern matching on the " -"value of an expression." -msgstr "" -"一致（match）: \n" -"式の値に対するパターン マッチングを可能にする、Rust の制御フロー構造。" +#~ msgid "\"irq_current\"" +#~ msgstr "\"irq_current\"" -#: src/glossary.md -msgid "" -"memory leak: \n" -"A situation where a program fails to release memory that is no longer " -"needed, leading to a gradual increase in memory usage." -msgstr "" -"メモリリーク（memory leak）: \n" -"プログラムで不要になったメモリの解放に失敗し、メモリ使用量が徐々に増加する状" -"況。" +#~ msgid "\"No pending interrupt\"" +#~ msgstr "\"No pending interrupt\"" -#: src/glossary.md -msgid "" -"method: \n" -"A function associated with an object or a type in Rust." -msgstr "" -"メソッド（method）: \n" -"Rust のオブジェクトまたは型に関連付けられた関数。" +#~ msgid "\"IRQ {intid:?}\"" +#~ msgstr "\"IRQ {intid:?}\"" -#: src/glossary.md -msgid "" -"module: \n" -"A namespace that contains definitions, such as functions, types, or traits, " -"to organize code in Rust." -msgstr "" -"モジュール（module）: \n" -"関数、型、トレイトなどの定義を含む名前空間。Rust でコードを整理するために使用" -"されます。" +#~ msgid "\"fiq_current\"" +#~ msgstr "\"fiq_current\"" -#: src/glossary.md -msgid "" -"move: \n" -"The transfer of ownership of a value from one variable to another in Rust." -msgstr "" -"移動（move）: \n" -"Rust である変数から別の変数に値の所有権を移動すること。" +#~ msgid "\"serr_current\"" +#~ msgstr "\"serr_current\"" -#: src/glossary.md -msgid "" -"mutable: \n" -"A property in Rust that allows variables to be modified after they have been " -"declared." -msgstr "" -"可変（mutable）: \n" -"宣言後の変数の変更を可能にする Rust のプロパティ。" +#~ msgid "\"sync_lower\"" +#~ msgstr "\"sync_lower\"" -#: src/glossary.md -msgid "" -"ownership: \n" -"The concept in Rust that defines which part of the code is responsible for " -"managing the memory associated with a value." -msgstr "" -"所有権（ownership）: \n" -"値に関連付けられたメモリの管理をコードのどの部分が担うかを定義する Rust の概" -"念。" +#~ msgid "\"irq_lower\"" +#~ msgstr "\"irq_lower\"" -#: src/glossary.md -msgid "" -"panic: \n" -"An unrecoverable error condition in Rust that results in the termination of " -"the program." -msgstr "" -"パニック（panic）: \n" -"プログラムの終了を引き起こす、Rust の回復不能なエラー状態。" +#~ msgid "\"fiq_lower\"" +#~ msgstr "\"fiq_lower\"" -#: src/glossary.md -msgid "" -"parameter: \n" -"A value that is passed into a function or method when it is called." -msgstr "" -"パラメータ（parameter）: \n" -"関数またはメソッドが呼び出されたときに渡される値。" +#~ msgid "\"serr_lower\"" +#~ msgstr "\"serr_lower\"" -#: src/glossary.md -msgid "" -"pattern: \n" -"A combination of values, literals, or structures that can be matched against " -"an expression in Rust." -msgstr "" -"パターン（pattern）: \n" -"Rust の式と照合できる値、リテラル、構造体の組み合わせ。" +#~ msgid "// ANCHOR: main\n" +#~ msgstr "// ANCHOR: main\n" -#: src/glossary.md -msgid "" -"payload: \n" -"The data or information carried by a message, event, or data structure." -msgstr "" -"ペイロード（payload）: \n" -"メッセージ、イベント、またはデータ構造体で保持されるデータまたは情報。" +#~ msgid "// ANCHOR: Flags\n" +#~ msgstr "// ANCHOR: Flags\n" -#: src/glossary.md -msgid "" -"program: \n" -"A set of instructions that a computer can execute to perform a specific task " -"or solve a particular problem." -msgstr "" -"プログラム（program）: \n" -"特定のタスクを実行したり、特定の問題を解決したりするためにコンピュータが実行" -"できる一連の命令。" +#~ msgid "// ANCHOR_END: Flags\n" +#~ msgstr "// ANCHOR_END: Flags\n" -#: src/glossary.md -msgid "" -"programming language: \n" -"A formal system used to communicate instructions to a computer, such as Rust." -msgstr "" -"プログラミング言語（programming language）: \n" -"コンピュータに命令を伝えるために使用される正式なシステム（Rust など）。" +#~ msgid "" +#~ "/// Flags from the UART Receive Status Register / Error Clear Register.\n" +#~ msgstr "" +#~ "/// UART 受信ステータス レジスタ / エラー クリア レジスタからのフラグ\n" -#: src/glossary.md -msgid "" -"receiver: \n" -"The first parameter in a Rust method that represents the instance on which " -"the method is called." -msgstr "" -"レシーバ（receiver）: \n" -"メソッドが呼び出されたインスタンスを表す Rust メソッドの最初のパラメータ。" +#~ msgid "/// Framing error.\n" +#~ msgstr "/// フレーム処理エラー。\n" -#: src/glossary.md -msgid "" -"reference counting: \n" -"A memory management technique in which the number of references to an object " -"is tracked, and the object is deallocated when the count reaches zero." -msgstr "" -"参照カウント（reference counting）: \n" -"オブジェクトへの参照の数をトラッキングし、カウントがゼロになるとオブジェクト" -"の割り当てを解除するメモリ管理技術。" +#~ msgid "/// Parity error.\n" +#~ msgstr "/// パリティエラー。\n" -#: src/glossary.md -msgid "" -"return: \n" -"A keyword in Rust used to indicate the value to be returned from a function." -msgstr "" -"戻り値（return）: \n" -"関数から返される値を示すために使用される Rust のキーワード。" +#~ msgid "/// Break error.\n" +#~ msgstr "/// ブレイクエラー。\n" -#: src/glossary.md -msgid "" -"Rust: \n" -"A systems programming language that focuses on safety, performance, and " -"concurrency." -msgstr "" -"Rust: \n" -"安全性、パフォーマンス、同時実行に重点を置いたシステム プログラミング言語。" +#~ msgid "/// Overrun error.\n" +#~ msgstr "/// オーバーラン エラー。\n" -#: src/glossary.md -msgid "" -"Rust Fundamentals: \n" -"Days 1 to 3 of this course." -msgstr "" -"Rust の基礎（Rust Fundamentals）: \n" -"このコースの 1～3 日目。" +#~ msgid "// ANCHOR: Registers\n" +#~ msgstr "// ANCHOR: Registers\n" -#: src/glossary.md -msgid "" -"Rust in Android: \n" -"See [Rust in Android](android.md)." -msgstr "" -"Android での Rust（Rust in Android）: \n" -"[Android での Rust](android.md) をご覧ください。" +#~ msgid "// ANCHOR_END: Registers\n" +#~ msgstr "// ANCHOR_END: Registers\n" -#: src/glossary.md -msgid "" -"Rust in Chromium: \n" -"See [Rust in Chromium](chromium.md)." -msgstr "" -"Chromium での Rust（Rust in Chromium）: \n" -"[Chromium での Rust](chromium.md) をご覧ください。" +#~ msgid "" +#~ "// ANCHOR: Uart\n" +#~ "/// Driver for a PL011 UART.\n" +#~ msgstr "" +#~ "// ANCHOR: Uart\n" +#~ "/// PL011 UART のドライバ。\n" -#: src/glossary.md -msgid "" -"safe: \n" -"Refers to code that adheres to Rust's ownership and borrowing rules, " -"preventing memory-related errors." -msgstr "" -"安全（safe）: \n" -"Rust の所有権と借用に関するルールに従って、メモリ関連のエラーを防止するコード" -"を指します。" +#~ msgid "" +#~ "/// Constructs a new instance of the UART driver for a PL011 device at " +#~ "the\n" +#~ " /// given base address.\n" +#~ " ///\n" +#~ " /// # Safety\n" +#~ " ///\n" +#~ " /// The given base address must point to the MMIO control registers " +#~ "of a\n" +#~ " /// PL011 device, which must be mapped into the address space of the " +#~ "process\n" +#~ " /// as device memory and not have any other aliases.\n" +#~ msgstr "" +#~ "/// 指定されたベースアドレスに存在する\n" +#~ " /// PL011 デバイス用の UART ドライバの新しいインスタンスを作成しま" +#~ "す。\n" +#~ " ///\n" +#~ " /// # 安全性\n" +#~ " ///\n" +#~ " /// 指定されたベースアドレスは PL011 デバイスの MMIO 制御レジスタを指" +#~ "している必要があります。\n" +#~ " /// これらはデバイスメモリとしてプロセスのアドレス空間に\n" +#~ " /// マッピングされ、他のエイリアスはありません。\n" -#: src/glossary.md -msgid "" -"scope: \n" -"The region of a program where a variable is valid and can be used." -msgstr "" -"スコープ（scope）: \n" -"変数が有効かつ使用可能なプログラムの領域。" +#~ msgid "// ANCHOR_END: Uart\n" +#~ msgstr "// ANCHOR_END: Uart\n" -#: src/glossary.md -msgid "" -"standard library: \n" -"A collection of modules providing essential functionality in Rust." -msgstr "" -"標準ライブラリ（standard library）: \n" -"Rust の必須機能を提供するモジュールのコレクション。" +#~ msgid "\"linux\"" +#~ msgstr "\"linux\"" -#: src/glossary.md -msgid "" -"static: \n" -"A keyword in Rust used to define static variables or items with a `'static` " -"lifetime." -msgstr "" -"静的（static）: \n" -"静的な変数や `'static` ライフタイムを持つアイテムを定義するために使用される " -"Rust のキーワード。" +#~ msgid "\"CROSS_COMPILE\"" +#~ msgstr "\"CROSS_COMPILE\"" -#: src/glossary.md -msgid "" -"string: \n" -"A data type storing textual data. See [`String` vs `str`](basic-syntax/" -"string-slices.html) for more." -msgstr "" -"文字列（string）: \n" -"テキストデータを格納するデータ型。詳しくは、[`String` と `str`](basic-syntax/" -"string-slices.html) をご覧ください。" +#~ msgid "\"aarch64-linux-gnu\"" +#~ msgstr "\"aarch64-linux-gnu\"" -#: src/glossary.md -msgid "" -"struct: \n" -"A composite data type in Rust that groups together variables of different " -"types under a single name." -msgstr "" -"構造体（struct）: \n" -"異なる型の変数を 1 つの名前でグループ化する Rust の複合データ型。" +#~ msgid "\"aarch64-none-elf\"" +#~ msgstr "\"aarch64-none-elf\"" -#: src/glossary.md -msgid "" -"test: \n" -"A Rust module containing functions that test the correctness of other " -"functions." -msgstr "" -"テスト（test）: \n" -"他の関数の正しさをテストする関数を含む Rust モジュール。" +#~ msgid "\"entry.S\"" +#~ msgstr "\"entry.S\"" -#: src/glossary.md -msgid "" -"thread: \n" -"A separate sequence of execution in a program, allowing concurrent execution." -msgstr "" -"スレッド（thread）: \n" -"同時実行を可能にする、プログラム内の独立した実行シーケンス。" +#~ msgid "\"exceptions.S\"" +#~ msgstr "\"exceptions.S\"" -#: src/glossary.md -msgid "" -"thread safety: \n" -"The property of a program that ensures correct behavior in a multithreaded " -"environment." -msgstr "" -"スレッドセーフ（thread safety）: \n" -"マルチスレッド環境で正しい動作を保証するプログラムの特性。" +#~ msgid "\"idmap.S\"" +#~ msgstr "\"idmap.S\"" -#: src/glossary.md -msgid "" -"trait: \n" -"A collection of methods defined for an unknown type, providing a way to " -"achieve polymorphism in Rust." -msgstr "" -"トレイト（trait）: \n" -"未知の型に対して定義されたメソッドのコレクション。Rust でポリモーフィズムを実" -"現する方法を提供します。" +#~ msgid "\"empty\"" +#~ msgstr "\"empty\"" -#: src/glossary.md -msgid "" -"trait bound: \n" -"An abstraction where you can require types to implement some traits of your " -"interest." -msgstr "" -"トレイト境界（trait bound）: \n" -"特定のトレイトを実装するために型を要求できる抽象化。" +#~ msgid "" +#~ "```armasm\n" +#~ "/*\n" +#~ " * Copyright 2023 Google LLC\n" +#~ " *\n" +#~ " * Licensed under the Apache License, Version 2.0 (the \"License\");\n" +#~ " * you may not use this file except in compliance with the License.\n" +#~ " * You may obtain a copy of the License at\n" +#~ " *\n" +#~ " * https://www.apache.org/licenses/LICENSE-2.0\n" +#~ " *\n" +#~ " * Unless required by applicable law or agreed to in writing, software\n" +#~ " * distributed under the License is distributed on an \"AS IS\" BASIS,\n" +#~ " * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or " +#~ "implied.\n" +#~ " * See the License for the specific language governing permissions and\n" +#~ " * limitations under the License.\n" +#~ " */\n" +#~ "\n" +#~ ".macro adr_l, reg:req, sym:req\n" +#~ "\tadrp \\reg, \\sym\n" +#~ "\tadd \\reg, \\reg, :lo12:\\sym\n" +#~ ".endm\n" +#~ "\n" +#~ ".macro mov_i, reg:req, imm:req\n" +#~ "\tmovz \\reg, :abs_g3:\\imm\n" +#~ "\tmovk \\reg, :abs_g2_nc:\\imm\n" +#~ "\tmovk \\reg, :abs_g1_nc:\\imm\n" +#~ "\tmovk \\reg, :abs_g0_nc:\\imm\n" +#~ ".endm\n" +#~ "\n" +#~ ".set .L_MAIR_DEV_nGnRE,\t0x04\n" +#~ ".set .L_MAIR_MEM_WBWA,\t0xff\n" +#~ ".set .Lmairval, .L_MAIR_DEV_nGnRE | (.L_MAIR_MEM_WBWA << 8)\n" +#~ "\n" +#~ "/* 4 KiB granule size for TTBR0_EL1. */\n" +#~ ".set .L_TCR_TG0_4KB, 0x0 << 14\n" +#~ "/* 4 KiB granule size for TTBR1_EL1. */\n" +#~ ".set .L_TCR_TG1_4KB, 0x2 << 30\n" +#~ "/* Disable translation table walk for TTBR1_EL1, generating a translation " +#~ "fault instead. */\n" +#~ ".set .L_TCR_EPD1, 0x1 << 23\n" +#~ "/* Translation table walks for TTBR0_EL1 are inner sharable. */\n" +#~ ".set .L_TCR_SH_INNER, 0x3 << 12\n" +#~ "/*\n" +#~ " * Translation table walks for TTBR0_EL1 are outer write-back read-" +#~ "allocate write-allocate\n" +#~ " * cacheable.\n" +#~ " */\n" +#~ ".set .L_TCR_RGN_OWB, 0x1 << 10\n" +#~ "/*\n" +#~ " * Translation table walks for TTBR0_EL1 are inner write-back read-" +#~ "allocate write-allocate\n" +#~ " * cacheable.\n" +#~ " */\n" +#~ ".set .L_TCR_RGN_IWB, 0x1 << 8\n" +#~ "/* Size offset for TTBR0_EL1 is 2**39 bytes (512 GiB). */\n" +#~ ".set .L_TCR_T0SZ_512, 64 - 39\n" +#~ ".set .Ltcrval, .L_TCR_TG0_4KB | .L_TCR_TG1_4KB | .L_TCR_EPD1 | ." +#~ "L_TCR_RGN_OWB\n" +#~ ".set .Ltcrval, .Ltcrval | .L_TCR_RGN_IWB | .L_TCR_SH_INNER | ." +#~ "L_TCR_T0SZ_512\n" +#~ "\n" +#~ "/* Stage 1 instruction access cacheability is unaffected. */\n" +#~ ".set .L_SCTLR_ELx_I, 0x1 << 12\n" +#~ "/* SP alignment fault if SP is not aligned to a 16 byte boundary. */\n" +#~ ".set .L_SCTLR_ELx_SA, 0x1 << 3\n" +#~ "/* Stage 1 data access cacheability is unaffected. */\n" +#~ ".set .L_SCTLR_ELx_C, 0x1 << 2\n" +#~ "/* EL0 and EL1 stage 1 MMU enabled. */\n" +#~ ".set .L_SCTLR_ELx_M, 0x1 << 0\n" +#~ "/* Privileged Access Never is unchanged on taking an exception to EL1. " +#~ "*/\n" +#~ ".set .L_SCTLR_EL1_SPAN, 0x1 << 23\n" +#~ "/* SETEND instruction disabled at EL0 in aarch32 mode. */\n" +#~ ".set .L_SCTLR_EL1_SED, 0x1 << 8\n" +#~ "/* Various IT instructions are disabled at EL0 in aarch32 mode. */\n" +#~ ".set .L_SCTLR_EL1_ITD, 0x1 << 7\n" +#~ ".set .L_SCTLR_EL1_RES1, (0x1 << 11) | (0x1 << 20) | (0x1 << 22) | (0x1 << " +#~ "28) | (0x1 << 29)\n" +#~ ".set .Lsctlrval, .L_SCTLR_ELx_M | .L_SCTLR_ELx_C | .L_SCTLR_ELx_SA | ." +#~ "L_SCTLR_EL1_ITD | .L_SCTLR_EL1_SED\n" +#~ ".set .Lsctlrval, .Lsctlrval | .L_SCTLR_ELx_I | .L_SCTLR_EL1_SPAN | ." +#~ "L_SCTLR_EL1_RES1\n" +#~ "\n" +#~ "/**\n" +#~ " * This is a generic entry point for an image. It carries out the " +#~ "operations required to prepare the\n" +#~ " * loaded image to be run. Specifically, it zeroes the bss section using " +#~ "registers x25 and above,\n" +#~ " * prepares the stack, enables floating point, and sets up the exception " +#~ "vector. It preserves x0-x3\n" +#~ " * for the Rust entry point, as these may contain boot parameters.\n" +#~ " */\n" +#~ ".section .init.entry, \"ax\"\n" +#~ ".global entry\n" +#~ "entry:\n" +#~ "\t/* Load and apply the memory management configuration, ready to enable " +#~ "MMU and caches. */\n" +#~ "\tadrp x30, idmap\n" +#~ "\tmsr ttbr0_el1, x30\n" +#~ "\n" +#~ "\tmov_i x30, .Lmairval\n" +#~ "\tmsr mair_el1, x30\n" +#~ "\n" +#~ "\tmov_i x30, .Ltcrval\n" +#~ "\t/* Copy the supported PA range into TCR_EL1.IPS. */\n" +#~ "\tmrs x29, id_aa64mmfr0_el1\n" +#~ "\tbfi x30, x29, #32, #4\n" +#~ "\n" +#~ "\tmsr tcr_el1, x30\n" +#~ "\n" +#~ "\tmov_i x30, .Lsctlrval\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * Ensure everything before this point has completed, then invalidate " +#~ "any potentially stale\n" +#~ "\t * local TLB entries before they start being used.\n" +#~ "\t */\n" +#~ "\tisb\n" +#~ "\ttlbi vmalle1\n" +#~ "\tic iallu\n" +#~ "\tdsb nsh\n" +#~ "\tisb\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * Configure sctlr_el1 to enable MMU and cache and don't proceed until " +#~ "this has completed.\n" +#~ "\t */\n" +#~ "\tmsr sctlr_el1, x30\n" +#~ "\tisb\n" +#~ "\n" +#~ "\t/* Disable trapping floating point access in EL1. */\n" +#~ "\tmrs x30, cpacr_el1\n" +#~ "\torr x30, x30, #(0x3 << 20)\n" +#~ "\tmsr cpacr_el1, x30\n" +#~ "\tisb\n" +#~ "\n" +#~ "\t/* Zero out the bss section. */\n" +#~ "\tadr_l x29, bss_begin\n" +#~ "\tadr_l x30, bss_end\n" +#~ "0:\tcmp x29, x30\n" +#~ "\tb.hs 1f\n" +#~ "\tstp xzr, xzr, [x29], #16\n" +#~ "\tb 0b\n" +#~ "\n" +#~ "1:\t/* Prepare the stack. */\n" +#~ "\tadr_l x30, boot_stack_end\n" +#~ "\tmov sp, x30\n" +#~ "\n" +#~ "\t/* Set up exception vector. */\n" +#~ "\tadr x30, vector_table_el1\n" +#~ "\tmsr vbar_el1, x30\n" +#~ "\n" +#~ "\t/* Call into Rust code. */\n" +#~ "\tbl main\n" +#~ "\n" +#~ "\t/* Loop forever waiting for interrupts. */\n" +#~ "2:\twfi\n" +#~ "\tb 2b\n" +#~ "```" +#~ msgstr "" +#~ "```armasm\n" +#~ "/*\n" +#~ " * Copyright 2023 Google LLC\n" +#~ " *\n" +#~ " * バージョン 2.0 の Apache ライセンス（以下「本ライセンス」）により使用が" +#~ "許諾されています。\n" +#~ " * このファイルを使用するには、本ライセンスに準拠する必要があります。\n" +#~ " * 本ライセンスのコピーは下記のリンクから入手できます。\n" +#~ " *\n" +#~ " * https://www.apache.org/licenses/LICENSE-2.0\n" +#~ " *\n" +#~ " * 本ライセンスで配布されるソフトウェアは、\n" +#~ " * 適用される法律によって要求される場合または書面で合意した場合を除き、\n" +#~ " * 明示されるか黙示されるかを問わず、いかなる種類の保証も条件もなく、「現" +#~ "状有姿」で提供されます。\n" +#~ " * 本ライセンスの下で適用される具体的な許可および制限については、\n" +#~ " * ライセンス本文をご覧ください。\n" +#~ " */\n" +#~ "\n" +#~ ".macro adr_l, reg:req, sym:req\n" +#~ "\tadrp \\reg, \\sym\n" +#~ "\tadd \\reg, \\reg, :lo12:\\sym\n" +#~ ".endm\n" +#~ "\n" +#~ ".macro mov_i, reg:req, imm:req\n" +#~ "\tmovz \\reg, :abs_g3:\\imm\n" +#~ "\tmovk \\reg, :abs_g2_nc:\\imm\n" +#~ "\tmovk \\reg, :abs_g1_nc:\\imm\n" +#~ "\tmovk \\reg, :abs_g0_nc:\\imm\n" +#~ ".endm\n" +#~ "\n" +#~ ".set .L_MAIR_DEV_nGnRE,\t0x04\n" +#~ ".set .L_MAIR_MEM_WBWA,\t0xff\n" +#~ ".set .Lmairval, .L_MAIR_DEV_nGnRE | (.L_MAIR_MEM_WBWA << 8)\n" +#~ "\n" +#~ "/* TTBR0_EL1におけるページサイズを4KiB単位に設定。*/\n" +#~ ".set .L_TCR_TG0_4KB, 0x0 << 14\n" +#~ "/* TTBR1_EL1におけるページサイズを4KiB単位に設定。*/\n" +#~ ".set .L_TCR_TG1_4KB, 0x2 << 30\n" +#~ "/* TTBR1_EL1 の変換テーブル ウォークを無効にして、代わりに変換エラーを生成" +#~ "します。*/\n" +#~ ".set .L_TCR_EPD1, 0x1 << 23\n" +#~ "/* TTBR0_EL1 の変換テーブル ウォークは内部共有可能です。*/\n" +#~ ".set .L_TCR_SH_INNER, 0x3 << 12\n" +#~ "/*\n" +#~ " * TTBR0_EL1 の変換テーブル ウォークは、外部書き戻し、読み取り割り当て、書" +#~ "き込み割り当ての\n" +#~ " * キャッシュが可能です。\n" +#~ " */\n" +#~ ".set . L_TCR_RGN_OWB, 0x1 << 10\n" +#~ "/*\n" +#~ " * TTBR0_EL1 の変換テーブル ウォークは、内部書き戻し、読み取り割り当て、書" +#~ "き込み割り当ての\n" +#~ " * キャッシュが可能です。\n" +#~ " */\n" +#~ ".set .L_TCR_RGN_IWB, 0x1 << 8\n" +#~ "/* TTBR0_EL1 のサイズ オフセットは 2**39 バイト（512 GiB）です。*/\n" +#~ ".set .L_TCR_T0SZ_512, 64 - 39\n" +#~ ".set .Ltcrval, .L_TCR_TG0_4KB | .L_TCR_TG1_4KB | .L_TCR_EPD1 | ." +#~ "L_TCR_RGN_OWB\n" +#~ ".set .Ltcrval, .Ltcrval | .L_TCR_RGN_IWB | .L_TCR_SH_INNER | ." +#~ "L_TCR_T0SZ_512\n" +#~ "\n" +#~ "/* ステージ 1 の命令アクセスのキャッシュ可能設定は影響を受けません。*/\n" +#~ ".set .L_SCTLR_ELx_I, 0x1 << 12\n" +#~ "/* SP が 16 バイト境界にアライメントされていない場合の SP アライメント " +#~ "フォールト。*/\n" +#~ ".set .L_SCTLR_ELx_SA, 0x1 << 3\n" +#~ "/* ステージ 1 のデータアクセスのキャッシュ可能性設定は影響を受けません。" +#~ "*/\n" +#~ ".set .L_SCTLR_ELx_C, 0x1 << 2\n" +#~ "/* EL0 および EL1 ステージ 1 MMU が有効になっています。*/\n" +#~ ".set .L_SCTLR_ELx_M, 0x1 << 0\n" +#~ "/* EL1 の例外を受け取っても、特権アクセスは変更されません。*/\n" +#~ ".set .L_SCTLR_EL1_SPAN, 0x1 << 23\n" +#~ "/* aarch32 モードの EL0 で SETEND 命令が無効になっています。*/\n" +#~ ".set .L_SCTLR_EL1_SED, 0x1 << 8\n" +#~ "/* さまざまな IT 命令が aarch32 モードの EL0 で無効になっています。*/\n" +#~ ".set .L_SCTLR_EL1_ITD, 0x1 << 7\n" +#~ ".set .L_SCTLR_EL1_RES1, (0x1 << 11) | (0x1 << 20) | (0x1 << 22) | (0x1 << " +#~ "28) | (0x1 << 29)\n" +#~ ".set .Lsctlrval, .L_SCTLR_ELx_M | .L_SCTLR_ELx_C | .L_SCTLR_ELx_SA | ." +#~ "L_SCTLR_EL1_ITD | .L_SCTLR_EL1_SED\n" +#~ ".set .Lsctlrval, .Lsctlrval | .L_SCTLR_ELx_I | .L_SCTLR_EL1_SPAN | ." +#~ "L_SCTLR_EL1_RES1\n" +#~ "\n" +#~ "/**\n" +#~ " * これはイメージの一般的なエントリ ポイントです。読み込まれたイメージの実" +#~ "行を\n" +#~ " * 準備するために必要なオペレーションを実行します。具体的には、x25 以上の" +#~ "レジスタを使用して bss セクションをゼロにし、\n" +#~ " * スタックを準備し、浮動小数点数を有効にして、例外ベクターを設定します。" +#~ "Rust エントリ ポイントのために x0-x3\n" +#~ " * には下の値を保持します。これは起動パラメータを含む可能性があるためで" +#~ "す。\n" +#~ " */\n" +#~ ".section .init.entry, \"ax\"\n" +#~ ".global entry\n" +#~ "entry:\n" +#~ "\t/* メモリ管理に関する設定を読み込んで適用し、MMU とキャッシュを有効にす" +#~ "る準備をします。*/\n" +#~ "\tadrp x30, idmap\n" +#~ "\tmsr ttbr0_el1, x30\n" +#~ "\n" +#~ "\tmov_i x30, .Lmairval\n" +#~ "\tmsr mair_el1, x30\n" +#~ "\n" +#~ "\tmov_i x30, .Ltcrval\n" +#~ "\t/* サポートしている PA 範囲を TCR_EL1.IPS にコピーします。*/\n" +#~ "\tmrs x29, id_aa64mmfr0_el1\n" +#~ "\tbfi x30, x29, #32, #4\n" +#~ "\n" +#~ "\tmsr tcr_el1, x30\n" +#~ "\n" +#~ "\tmov_i x30, .Lsctlrval\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * ここより前のすべての処理が完了していることを確認してから、\n" +#~ "\t * 古くなった可能性のあるローカル TLB エントリを使用開始前に無効にしま" +#~ "す。\n" +#~ "\t */\n" +#~ "\tisb\n" +#~ "\ttlbi vmalle1\n" +#~ "\tic iallu\n" +#~ "\tdsb nsh\n" +#~ "\tisb\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * MMU とキャッシュを有効にするように sctlr_el1 を構成し、これが完了する" +#~ "までは先に進みません。\n" +#~ "\t */\n" +#~ "\tmsr sctlr_el1, x30\n" +#~ "\tisb\n" +#~ "\n" +#~ "\t/* EL1 の浮動小数点アクセスのトラップを無効にします。*/\n" +#~ "\tmrs x30, cpacr_el1\n" +#~ "\torr x30, x30, #(0x3 << 20)\n" +#~ "\tmsr cpacr_el1, x30\n" +#~ "\tisb\n" +#~ "\n" +#~ "\t/* bss セクションをゼロにします。*/\n" +#~ "\tadr_l x29, bss_begin\n" +#~ "\tadr_l x30, bss_end\n" +#~ "0:\tcmp x29, x30\n" +#~ "\tb.hs 1f\n" +#~ "\tstp xzr, xzr, [x29], #16\n" +#~ "\tb 0b\n" +#~ "\n" +#~ "1:\t/* スタックを準備します。*/\n" +#~ "\tadr_l x30, boot_stack_end\n" +#~ "\tmov sp, x30\n" +#~ "\n" +#~ "\t/* 例外ベクターを設定します。*/\n" +#~ "\tadr x30, vector_table_el1\n" +#~ "\tmsr vbar_el1, x30\n" +#~ "\n" +#~ "\t/* Rust コードを呼び出します。*/\n" +#~ "\tbl main\n" +#~ "\n" +#~ "\t/* 割り込みを待機して永久にループします。*/\n" +#~ "2:\twfi\n" +#~ "\tb 2b\n" +#~ "```" -#: src/glossary.md -msgid "" -"tuple: \n" -"A composite data type that contains variables of different types. Tuple " -"fields have no names, and are accessed by their ordinal numbers." -msgstr "" -"タプル（tuple）: \n" -"さまざまな型の変数を含む複合データ型。タプル フィールドには名前がなく、序数で" -"アクセスします。" +#~ msgid "" +#~ "```armasm\n" +#~ "/*\n" +#~ " * Copyright 2023 Google LLC\n" +#~ " *\n" +#~ " * Licensed under the Apache License, Version 2.0 (the \"License\");\n" +#~ " * you may not use this file except in compliance with the License.\n" +#~ " * You may obtain a copy of the License at\n" +#~ " *\n" +#~ " * https://www.apache.org/licenses/LICENSE-2.0\n" +#~ " *\n" +#~ " * Unless required by applicable law or agreed to in writing, software\n" +#~ " * distributed under the License is distributed on an \"AS IS\" BASIS,\n" +#~ " * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or " +#~ "implied.\n" +#~ " * See the License for the specific language governing permissions and\n" +#~ " * limitations under the License.\n" +#~ " */\n" +#~ "\n" +#~ "/**\n" +#~ " * Saves the volatile registers onto the stack. This currently takes 14\n" +#~ " * instructions, so it can be used in exception handlers with 18 " +#~ "instructions\n" +#~ " * left.\n" +#~ " *\n" +#~ " * On return, x0 and x1 are initialised to elr_el2 and spsr_el2 " +#~ "respectively,\n" +#~ " * which can be used as the first and second arguments of a subsequent " +#~ "call.\n" +#~ " */\n" +#~ ".macro save_volatile_to_stack\n" +#~ "\t/* Reserve stack space and save registers x0-x18, x29 & x30. */\n" +#~ "\tstp x0, x1, [sp, #-(8 * 24)]!\n" +#~ "\tstp x2, x3, [sp, #8 * 2]\n" +#~ "\tstp x4, x5, [sp, #8 * 4]\n" +#~ "\tstp x6, x7, [sp, #8 * 6]\n" +#~ "\tstp x8, x9, [sp, #8 * 8]\n" +#~ "\tstp x10, x11, [sp, #8 * 10]\n" +#~ "\tstp x12, x13, [sp, #8 * 12]\n" +#~ "\tstp x14, x15, [sp, #8 * 14]\n" +#~ "\tstp x16, x17, [sp, #8 * 16]\n" +#~ "\tstr x18, [sp, #8 * 18]\n" +#~ "\tstp x29, x30, [sp, #8 * 20]\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * Save elr_el1 & spsr_el1. This such that we can take nested " +#~ "exception\n" +#~ "\t * and still be able to unwind.\n" +#~ "\t */\n" +#~ "\tmrs x0, elr_el1\n" +#~ "\tmrs x1, spsr_el1\n" +#~ "\tstp x0, x1, [sp, #8 * 22]\n" +#~ ".endm\n" +#~ "\n" +#~ "/**\n" +#~ " * Restores the volatile registers from the stack. This currently takes " +#~ "14\n" +#~ " * instructions, so it can be used in exception handlers while still " +#~ "leaving 18\n" +#~ " * instructions left; if paired with save_volatile_to_stack, there are 4\n" +#~ " * instructions to spare.\n" +#~ " */\n" +#~ ".macro restore_volatile_from_stack\n" +#~ "\t/* Restore registers x2-x18, x29 & x30. */\n" +#~ "\tldp x2, x3, [sp, #8 * 2]\n" +#~ "\tldp x4, x5, [sp, #8 * 4]\n" +#~ "\tldp x6, x7, [sp, #8 * 6]\n" +#~ "\tldp x8, x9, [sp, #8 * 8]\n" +#~ "\tldp x10, x11, [sp, #8 * 10]\n" +#~ "\tldp x12, x13, [sp, #8 * 12]\n" +#~ "\tldp x14, x15, [sp, #8 * 14]\n" +#~ "\tldp x16, x17, [sp, #8 * 16]\n" +#~ "\tldr x18, [sp, #8 * 18]\n" +#~ "\tldp x29, x30, [sp, #8 * 20]\n" +#~ "\n" +#~ "\t/* Restore registers elr_el1 & spsr_el1, using x0 & x1 as scratch. */\n" +#~ "\tldp x0, x1, [sp, #8 * 22]\n" +#~ "\tmsr elr_el1, x0\n" +#~ "\tmsr spsr_el1, x1\n" +#~ "\n" +#~ "\t/* Restore x0 & x1, and release stack space. */\n" +#~ "\tldp x0, x1, [sp], #8 * 24\n" +#~ ".endm\n" +#~ "\n" +#~ "/**\n" +#~ " * This is a generic handler for exceptions taken at the current EL while " +#~ "using\n" +#~ " * SP0. It behaves similarly to the SPx case by first switching to SPx, " +#~ "doing\n" +#~ " * the work, then switching back to SP0 before returning.\n" +#~ " *\n" +#~ " * Switching to SPx and calling the Rust handler takes 16 instructions. " +#~ "To\n" +#~ " * restore and return we need an additional 16 instructions, so we can " +#~ "implement\n" +#~ " * the whole handler within the allotted 32 instructions.\n" +#~ " */\n" +#~ ".macro current_exception_sp0 handler:req\n" +#~ "\tmsr spsel, #1\n" +#~ "\tsave_volatile_to_stack\n" +#~ "\tbl \\handler\n" +#~ "\trestore_volatile_from_stack\n" +#~ "\tmsr spsel, #0\n" +#~ "\teret\n" +#~ ".endm\n" +#~ "\n" +#~ "/**\n" +#~ " * This is a generic handler for exceptions taken at the current EL while " +#~ "using\n" +#~ " * SPx. It saves volatile registers, calls the Rust handler, restores " +#~ "volatile\n" +#~ " * registers, then returns.\n" +#~ " *\n" +#~ " * This also works for exceptions taken from EL0, if we don't care about\n" +#~ " * non-volatile registers.\n" +#~ " *\n" +#~ " * Saving state and jumping to the Rust handler takes 15 instructions, " +#~ "and\n" +#~ " * restoring and returning also takes 15 instructions, so we can fit the " +#~ "whole\n" +#~ " * handler in 30 instructions, under the limit of 32.\n" +#~ " */\n" +#~ ".macro current_exception_spx handler:req\n" +#~ "\tsave_volatile_to_stack\n" +#~ "\tbl \\handler\n" +#~ "\trestore_volatile_from_stack\n" +#~ "\teret\n" +#~ ".endm\n" +#~ "\n" +#~ ".section .text.vector_table_el1, \"ax\"\n" +#~ ".global vector_table_el1\n" +#~ ".balign 0x800\n" +#~ "vector_table_el1:\n" +#~ "sync_cur_sp0:\n" +#~ "\tcurrent_exception_sp0 sync_exception_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "irq_cur_sp0:\n" +#~ "\tcurrent_exception_sp0 irq_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "fiq_cur_sp0:\n" +#~ "\tcurrent_exception_sp0 fiq_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "serr_cur_sp0:\n" +#~ "\tcurrent_exception_sp0 serr_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "sync_cur_spx:\n" +#~ "\tcurrent_exception_spx sync_exception_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "irq_cur_spx:\n" +#~ "\tcurrent_exception_spx irq_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "fiq_cur_spx:\n" +#~ "\tcurrent_exception_spx fiq_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "serr_cur_spx:\n" +#~ "\tcurrent_exception_spx serr_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "sync_lower_64:\n" +#~ "\tcurrent_exception_spx sync_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "irq_lower_64:\n" +#~ "\tcurrent_exception_spx irq_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "fiq_lower_64:\n" +#~ "\tcurrent_exception_spx fiq_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "serr_lower_64:\n" +#~ "\tcurrent_exception_spx serr_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "sync_lower_32:\n" +#~ "\tcurrent_exception_spx sync_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "irq_lower_32:\n" +#~ "\tcurrent_exception_spx irq_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "fiq_lower_32:\n" +#~ "\tcurrent_exception_spx fiq_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "serr_lower_32:\n" +#~ "\tcurrent_exception_spx serr_lower\n" +#~ "```" +#~ msgstr "" +#~ "```armasm\n" +#~ "/*\n" +#~ " * Copyright 2023 Google LLC\n" +#~ " *\n" +#~ " * バージョン 2.0 の Apache ライセンス（以下「本ライセンス」）により使用が" +#~ "許諾されています。\n" +#~ " * このファイルを使用するには、本ライセンスに準拠する必要があります。\n" +#~ " * 本ライセンスのコピーは下記のリンクから入手できます。\n" +#~ " *\n" +#~ " * https://www.apache.org/licenses/LICENSE-2.0\n" +#~ " *\n" +#~ " * 本ライセンスで配布されるソフトウェアは、\n" +#~ " * 適用される法律によって要求される場合または書面で合意した場合を除き、\n" +#~ " * 明示されるか黙示されるかを問わず、いかなる種類の保証も条件もなく、「現" +#~ "状有姿」で提供されます。\n" +#~ " * 本ライセンスの下で適用される具体的な許可および制限については、\n" +#~ " * ライセンス本文をご覧ください。\n" +#~ " */\n" +#~ "\n" +#~ "/**\n" +#~ " * 揮発性レジスタをスタックに保存します。この部分は現在 14 個の\n" +#~ " * 命令で構成されているので、例外ハンドラで\n" +#~ " * 使用できます。その場合、残りは18命令分になります。\n" +#~ " *\n" +#~ " * 戻った際に、x0 と x1 はそれぞれ elr_el2 と spsr_el2 に初期化され、\n" +#~ " * これらは後続の呼び出しの 1 つ目と 2 つ目の引数として使用できます。\n" +#~ " */\n" +#~ ".macro save_volatile_to_stack\n" +#~ "\t/* スタック空間を予約し、レジスタ x0～x18、x29、x30 を保存します。*/\n" +#~ "\tstp x0, x1, [sp, #-(8 * 24)]!\n" +#~ "\tstp x2, x3, [sp, #8 * 2]\n" +#~ "\tstp x4, x5, [sp, #8 * 4]\n" +#~ "\tstp x6, x7, [sp, #8 * 6]\n" +#~ "\tstp x8, x9, [sp, #8 * 8]\n" +#~ "\tstp x10, x11, [sp, #8 * 10]\n" +#~ "\tstp x12, x13, [sp, #8 * 12]\n" +#~ "\tstp x14, x15, [sp, #8 * 14]\n" +#~ "\tstp x16, x17, [sp, #8 * 16]\n" +#~ "\tstr x18, [sp, #8 * 18]\n" +#~ "\tstp x29, x30, [sp, #8 * 20]\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * elr_el1 と spsr_el1 を保存します。これにより、ネストされた例外を受付" +#~ "可能になり、\n" +#~ "\t * また、アンワインドできるようになります。\n" +#~ "\t */\n" +#~ "\tmrs x0, elr_el1\n" +#~ "\tmrs x1, spsr_el1\n" +#~ "\tstp x0, x1, [sp, #8 * 22]\n" +#~ ".endm\n" +#~ "\n" +#~ "/**\n" +#~ " * スタックから揮発性レジスタを復元します。この部分は現在14 個の\n" +#~ " * 命令で構成されているので、\n" +#~ " * 例外ハンドラで使用できます。また、その場合18命令分の領域が残ります。" +#~ "save_volatile_to_stack と組み合わせた場合、\n" +#~ " * 4 個の命令が残ります。\n" +#~ " */\n" +#~ ".macro restore_volatile_from_stack\n" +#~ "\t/* レジスタ x2～x18、x29、x30 を復元します。*/\n" +#~ "\tldp x2, x3, [sp, #8 * 2]\n" +#~ "\tldp x4, x5, [sp, #8 * 4]\n" +#~ "\tldp x6, x7, [sp, #8 * 6]\n" +#~ "\tldp x8, x9, [sp, #8 * 8]\n" +#~ "\tldp x10, x11, [sp, #8 * 10]\n" +#~ "\tldp x12, x13, [sp, #8 * 12]\n" +#~ "\tldp x14, x15, [sp, #8 * 14]\n" +#~ "\tldp x16, x17, [sp, #8 * 16]\n" +#~ "\tldr x18, [sp, #8 * 18]\n" +#~ "\tldp x29, x30, [sp, #8 * 20]\n" +#~ "\n" +#~ "\t/* x0 と x1 をスクラッチとして使用して、レジスタ elr_el1 および " +#~ "spsr_el1 を復元します。*/\n" +#~ "\tldp x0, x1, [sp, #8 * 22]\n" +#~ "\tmsr elr_el1, x0\n" +#~ "\tmsr spsr_el1, x1\n" +#~ "\n" +#~ "\t/* x0 と x1 を復元し、スタック空間を解放します。*/\n" +#~ "\tldp x0, x1, [sp], #8 * 24\n" +#~ ".endm\n" +#~ "\n" +#~ "/**\n" +#~ " * これは、SP0 の使用中に現在の EL で取得される例外の\n" +#~ " * 汎用ハンドラです。SPx の場合と同様に、最初に SPx に切り替えて処理を実行" +#~ "し、\n" +#~ " * 戻る前に再度 SP0 に切り替えます。\n" +#~ " *\n" +#~ " * SPx に切り替えて Rust ハンドラを呼び出すには、16 個の命令が必要です。復" +#~ "元して戻るには、\n" +#~ " * さらに 16 個の命令が必要であるため、割り当てられた 32 個の命令の中で\n" +#~ " * ハンドラ全体を実装できます。\n" +#~ " */\n" +#~ ".macro current_exception_sp0 handler:req\n" +#~ "\tmsr spsel, #1\n" +#~ "\tsave_volatile_to_stack\n" +#~ "\tbl \\handler\n" +#~ "\trestore_volatile_from_stack\n" +#~ "\tmsr spsel, #0\n" +#~ "\teret\n" +#~ ".endm\n" +#~ "\n" +#~ "/**\n" +#~ " * これは、\n" +#~ " * SPx の使用中に現在の EL で受け付けた例外の汎用ハンドラです。揮発性レジ" +#~ "スタを保存し、Rust ハンドラを呼び出し、揮発性レジスタを\n" +#~ " * してから戻ります。\n" +#~ " *\n" +#~ " * 不揮発性レジスタを考慮しなければ、EL0 から取得した例外に対しても\n" +#~ " * 機能します。\n" +#~ " *\n" +#~ " * 状態の保存と Rust ハンドラへのジャンプには 15 個の命令が必要で、\n" +#~ " * 復元して戻るのにも 15 個の命令が必要であるため、\n" +#~ " * ハンドラ全体を 32 個の制限内である 30 個の命令に収めることができま" +#~ "す。\n" +#~ " */\n" +#~ ".macro current_exception_spx handler:req\n" +#~ "\tsave_volatile_to_stack\n" +#~ "\tbl \\handler\n" +#~ "\trestore_volatile_from_stack\n" +#~ "\teret\n" +#~ ".endm\n" +#~ "\n" +#~ ".section .text.vector_table_el1, \"ax\"\n" +#~ ".global vector_table_el1\n" +#~ ".balign 0x800\n" +#~ "vector_table_el1:\n" +#~ "sync_cur_sp0:\n" +#~ "\tcurrent_exception_sp0 sync_exception_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "irq_cur_sp0:\n" +#~ "\tcurrent_exception_sp0 irq_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "fiq_cur_sp0:\n" +#~ "\tcurrent_exception_sp0 fiq_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "serr_cur_sp0:\n" +#~ "\tcurrent_exception_sp0 serr_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "sync_cur_spx:\n" +#~ "\tcurrent_exception_spx sync_exception_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "irq_cur_spx:\n" +#~ "\tcurrent_exception_spx irq_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "fiq_cur_spx:\n" +#~ "\tcurrent_exception_spx fiq_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "serr_cur_spx:\n" +#~ "\tcurrent_exception_spx serr_current\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "sync_lower_64:\n" +#~ "\tcurrent_exception_spx sync_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "irq_lower_64:\n" +#~ "\tcurrent_exception_spx irq_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "fiq_lower_64:\n" +#~ "\tcurrent_exception_spx fiq_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "serr_lower_64:\n" +#~ "\tcurrent_exception_spx serr_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "sync_lower_32:\n" +#~ "\tcurrent_exception_spx sync_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "irq_lower_32:\n" +#~ "\tcurrent_exception_spx irq_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "fiq_lower_32:\n" +#~ "\tcurrent_exception_spx fiq_lower\n" +#~ "\n" +#~ ".balign 0x80\n" +#~ "serr_lower_32:\n" +#~ "\tcurrent_exception_spx serr_lower\n" +#~ "```" -#: src/glossary.md -msgid "" -"type: \n" -"A classification that specifies which operations can be performed on values " -"of a particular kind in Rust." -msgstr "" -"型（type）: \n" -"Rust の特定の種類の値に対してどのオペレーションを実行できるかを指定する分類。" +#~ msgid "" +#~ "```armasm\n" +#~ "/*\n" +#~ " * Copyright 2023 Google LLC\n" +#~ " *\n" +#~ " * Licensed under the Apache License, Version 2.0 (the \"License\");\n" +#~ " * you may not use this file except in compliance with the License.\n" +#~ " * You may obtain a copy of the License at\n" +#~ " *\n" +#~ " * https://www.apache.org/licenses/LICENSE-2.0\n" +#~ " *\n" +#~ " * Unless required by applicable law or agreed to in writing, software\n" +#~ " * distributed under the License is distributed on an \"AS IS\" BASIS,\n" +#~ " * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or " +#~ "implied.\n" +#~ " * See the License for the specific language governing permissions and\n" +#~ " * limitations under the License.\n" +#~ " */\n" +#~ "\n" +#~ ".set .L_TT_TYPE_BLOCK, 0x1\n" +#~ ".set .L_TT_TYPE_PAGE, 0x3\n" +#~ ".set .L_TT_TYPE_TABLE, 0x3\n" +#~ "\n" +#~ "/* Access flag. */\n" +#~ ".set .L_TT_AF, 0x1 << 10\n" +#~ "/* Not global. */\n" +#~ ".set .L_TT_NG, 0x1 << 11\n" +#~ ".set .L_TT_XN, 0x3 << 53\n" +#~ "\n" +#~ ".set .L_TT_MT_DEV, 0x0 << 2\t\t\t// MAIR #0 (DEV_nGnRE)\n" +#~ ".set .L_TT_MT_MEM, (0x1 << 2) | (0x3 << 8)\t// MAIR #1 (MEM_WBWA), inner " +#~ "shareable\n" +#~ "\n" +#~ ".set .L_BLOCK_DEV, .L_TT_TYPE_BLOCK | .L_TT_MT_DEV | .L_TT_AF | .L_TT_XN\n" +#~ ".set .L_BLOCK_MEM, .L_TT_TYPE_BLOCK | .L_TT_MT_MEM | .L_TT_AF | .L_TT_NG\n" +#~ "\n" +#~ ".section \".rodata.idmap\", \"a\", %progbits\n" +#~ ".global idmap\n" +#~ ".align 12\n" +#~ "idmap:\n" +#~ "\t/* level 1 */\n" +#~ "\t.quad\t\t.L_BLOCK_DEV | 0x0\t\t // 1 GiB of device mappings\n" +#~ "\t.quad\t\t.L_BLOCK_MEM | 0x40000000\t// 1 GiB of DRAM\n" +#~ "\t.fill\t\t254, 8, 0x0\t\t\t// 254 GiB of unmapped VA space\n" +#~ "\t.quad\t\t.L_BLOCK_DEV | 0x4000000000 // 1 GiB of device mappings\n" +#~ "\t.fill\t\t255, 8, 0x0\t\t\t// 255 GiB of remaining VA space\n" +#~ "```" +#~ msgstr "" +#~ "```armasm\n" +#~ "/*\n" +#~ " * Copyright 2023 Google LLC\n" +#~ " *\n" +#~ " * バージョン 2.0 の Apache ライセンス（以下「本ライセンス」）により使用が" +#~ "許諾されています。\n" +#~ " * このファイルを使用するには、本ライセンスに準拠する必要があります。\n" +#~ " * 本ライセンスのコピーは下記のリンクから入手できます。\n" +#~ " *\n" +#~ " * https://www.apache.org/licenses/LICENSE-2.0\n" +#~ " *\n" +#~ " * 本ライセンスで配布されるソフトウェアは、\n" +#~ " * 適用される法律によって要求される場合または書面で合意した場合を除き、\n" +#~ " * 明示されるか黙示されるかを問わず、いかなる種類の保証も条件もなく、「現" +#~ "状有姿」で提供されます。\n" +#~ " * 本ライセンスの下で適用される具体的な許可および制限については、\n" +#~ " * ライセンス本文をご覧ください。\n" +#~ " */\n" +#~ "\n" +#~ ".set .L_TT_TYPE_BLOCK, 0x1\n" +#~ ".set .L_TT_TYPE_PAGE, 0x3\n" +#~ ".set .L_TT_TYPE_TABLE, 0x3\n" +#~ "\n" +#~ "/* アクセスフラグ。*/\n" +#~ ".set .L_TT_AF, 0x1 << 10\n" +#~ "/* グローバルではありません。*/\n" +#~ ".set .L_TT_NG, 0x1 << 11\n" +#~ ".set .L_TT_XN, 0x3 << 53\n" +#~ "\n" +#~ ".set .L_TT_MT_DEV, 0x0 << 2\t\t\t// MAIR #0 (DEV_nGnRE)\n" +#~ ".set .L_TT_MT_MEM, (0x1 << 2) | (0x3 << 8)\t// MAIR #1 (MEM_WBWA)、内部共" +#~ "有可能\n" +#~ "\n" +#~ ".set .L_BLOCK_DEV, .L_TT_TYPE_BLOCK | .L_TT_MT_DEV | .L_TT_AF | .L_TT_XN\n" +#~ ".set .L_BLOCK_MEM, .L_TT_TYPE_BLOCK | .L_TT_MT_MEM | .L_TT_AF | .L_TT_NG\n" +#~ "\n" +#~ ".section \".rodata.idmap\", \"a\", %progbits\n" +#~ ".global idmap\n" +#~ ".align 12\n" +#~ "idmap:\n" +#~ "\t/* レベル 1 */\n" +#~ "\t.quad\t\t.L_BLOCK_DEV | 0x0\t\t // 1 GiB のデバイス マッピング\n" +#~ "\t.quad\t\t.L_BLOCK_MEM | 0x40000000\t// 1 GiB の DRAM\n" +#~ "\t.fill\t\t254, 8, 0x0\t\t\t// 254 GiB のマッピングされていない VA 空間\n" +#~ "\t.quad\t\t.L_BLOCK_DEV | 0x4000000000 // 1 GiB のデバイス マッピング\n" +#~ "\t.fill\t\t255, 8, 0x0\t\t\t// 255 GiB の残りの VA 空間\n" +#~ "```" -#: src/glossary.md -msgid "" -"type inference: \n" -"The ability of the Rust compiler to deduce the type of a variable or " -"expression." -msgstr "" -"型推論（type inference）: \n" -"変数または式の型を推測する Rust コンパイラの機能。" +#~ msgid "" +#~ "```ld\n" +#~ "/*\n" +#~ " * Copyright 2023 Google LLC\n" +#~ " *\n" +#~ " * Licensed under the Apache License, Version 2.0 (the \"License\");\n" +#~ " * you may not use this file except in compliance with the License.\n" +#~ " * You may obtain a copy of the License at\n" +#~ " *\n" +#~ " * https://www.apache.org/licenses/LICENSE-2.0\n" +#~ " *\n" +#~ " * Unless required by applicable law or agreed to in writing, software\n" +#~ " * distributed under the License is distributed on an \"AS IS\" BASIS,\n" +#~ " * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or " +#~ "implied.\n" +#~ " * See the License for the specific language governing permissions and\n" +#~ " * limitations under the License.\n" +#~ " */\n" +#~ "\n" +#~ "/*\n" +#~ " * Code will start running at this symbol which is placed at the start of " +#~ "the\n" +#~ " * image.\n" +#~ " */\n" +#~ "ENTRY(entry)\n" +#~ "\n" +#~ "MEMORY\n" +#~ "{\n" +#~ "\timage : ORIGIN = 0x40080000, LENGTH = 2M\n" +#~ "}\n" +#~ "\n" +#~ "SECTIONS\n" +#~ "{\n" +#~ "\t/*\n" +#~ "\t * Collect together the code.\n" +#~ "\t */\n" +#~ "\t.init : ALIGN(4096) {\n" +#~ "\t\ttext_begin = .;\n" +#~ "\t\t*(.init.entry)\n" +#~ "\t\t*(.init.*)\n" +#~ "\t} >image\n" +#~ "\t.text : {\n" +#~ "\t\t*(.text.*)\n" +#~ "\t} >image\n" +#~ "\ttext_end = .;\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * Collect together read-only data.\n" +#~ "\t */\n" +#~ "\t.rodata : ALIGN(4096) {\n" +#~ "\t\trodata_begin = .;\n" +#~ "\t\t*(.rodata.*)\n" +#~ "\t} >image\n" +#~ "\t.got : {\n" +#~ "\t\t*(.got)\n" +#~ "\t} >image\n" +#~ "\trodata_end = .;\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * Collect together the read-write data including .bss at the end " +#~ "which\n" +#~ "\t * will be zero'd by the entry code.\n" +#~ "\t */\n" +#~ "\t.data : ALIGN(4096) {\n" +#~ "\t\tdata_begin = .;\n" +#~ "\t\t*(.data.*)\n" +#~ "\t\t/*\n" +#~ "\t\t * The entry point code assumes that .data is a multiple of 32\n" +#~ "\t\t * bytes long.\n" +#~ "\t\t */\n" +#~ "\t\t. = ALIGN(32);\n" +#~ "\t\tdata_end = .;\n" +#~ "\t} >image\n" +#~ "\n" +#~ "\t/* Everything beyond this point will not be included in the binary. */\n" +#~ "\tbin_end = .;\n" +#~ "\n" +#~ "\t/* The entry point code assumes that .bss is 16-byte aligned. */\n" +#~ "\t.bss : ALIGN(16) {\n" +#~ "\t\tbss_begin = .;\n" +#~ "\t\t*(.bss.*)\n" +#~ "\t\t*(COMMON)\n" +#~ "\t\t. = ALIGN(16);\n" +#~ "\t\tbss_end = .;\n" +#~ "\t} >image\n" +#~ "\n" +#~ "\t.stack (NOLOAD) : ALIGN(4096) {\n" +#~ "\t\tboot_stack_begin = .;\n" +#~ "\t\t. += 40 * 4096;\n" +#~ "\t\t. = ALIGN(4096);\n" +#~ "\t\tboot_stack_end = .;\n" +#~ "\t} >image\n" +#~ "\n" +#~ "\t. = ALIGN(4K);\n" +#~ "\tPROVIDE(dma_region = .);\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * Remove unused sections from the image.\n" +#~ "\t */\n" +#~ "\t/DISCARD/ : {\n" +#~ "\t\t/* The image loads itself so doesn't need these sections. */\n" +#~ "\t\t*(.gnu.hash)\n" +#~ "\t\t*(.hash)\n" +#~ "\t\t*(.interp)\n" +#~ "\t\t*(.eh_frame_hdr)\n" +#~ "\t\t*(.eh_frame)\n" +#~ "\t\t*(.note.gnu.build-id)\n" +#~ "\t}\n" +#~ "}\n" +#~ "```" +#~ msgstr "" +#~ "```ld\n" +#~ "/*\n" +#~ " * Copyright 2023 Google LLC\n" +#~ " *\n" +#~ " * バージョン 2.0 の Apache ライセンス（以下「本ライセンス」）により使用が" +#~ "許諾されています。\n" +#~ " * このファイルを使用するには、本ライセンスに準拠する必要があります。\n" +#~ " * 本ライセンスのコピーは下記のリンクから入手できます。\n" +#~ " *\n" +#~ " * https://www.apache.org/licenses/LICENSE-2.0\n" +#~ " *\n" +#~ " * 本ライセンスで配布されるソフトウェアは、\n" +#~ " * 適用される法律によって要求される場合または書面で合意した場合を除き、\n" +#~ " * 明示されるか黙示されるかを問わず、いかなる種類の保証も条件もなく、「現" +#~ "状有姿」で提供されます。\n" +#~ " * 本ライセンスの下で適用される具体的な許可および制限については、\n" +#~ " * ライセンス本文をご覧ください。\n" +#~ " */\n" +#~ "\n" +#~ "/*\n" +#~ " * コードの実行は、イメージの先頭にあるこのシンボルから\n" +#~ " * 開始されます。\n" +#~ " */\n" +#~ "ENTRY(entry)\n" +#~ "\n" +#~ "MEMORY\n" +#~ "{\n" +#~ "\timage : ORIGIN = 0x40080000, LENGTH = 2M\n" +#~ "}\n" +#~ "\n" +#~ "SECTIONS\n" +#~ "{\n" +#~ "\t/*\n" +#~ "\t * コードを集約します\n" +#~ "\t */\n" +#~ "\t.init : ALIGN(4096) {\n" +#~ "\t\ttext_begin = .;\n" +#~ "\t\t*(.init.entry)\n" +#~ "\t\t*(.init.*)\n" +#~ "\t} >image\n" +#~ "\t.text : {\n" +#~ "\t\t*(.text.*)\n" +#~ "\t} >image\n" +#~ "\ttext_end = .;\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * 読み取り専用データを集約します。\n" +#~ "\t */\n" +#~ "\t.rodata : ALIGN(4096) {\n" +#~ "\t\trodata_begin = .;\n" +#~ "\t\t*(.rodata.*)\n" +#~ "\t} >image\n" +#~ "\t.got : {\n" +#~ "\t\t*(.got)\n" +#~ "\t} >image\n" +#~ "\trodata_end = .;\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * エントリコードによってゼロ初期化される.bssを末尾に含む、書き込み可能" +#~ "データを集約します。\n" +#~ "\t */\n" +#~ "\t.data : ALIGN(4096) {\n" +#~ "\t\tdata_begin = .;\n" +#~ "\t\t*(.data.*)\n" +#~ "\t\t/*\n" +#~ "\t\t * このエントリポイントは.dataの大きさが32バイトの倍数になっていること" +#~ "を前提としています。\n" +#~ "\t\t */\n" +#~ "\t\t. = ALIGN(32);\n" +#~ "\t\tdata_end = .;\n" +#~ "\t} >image\n" +#~ "\n" +#~ "\t/* これ以降はすべてバイナリに含まれません。*/\n" +#~ "\tbin_end = .;\n" +#~ "\n" +#~ "\t/* このエントリ ポイント コードは、.bss が 16 バイトでアラインされている" +#~ "ことを前提としています。*/\n" +#~ "\t.bss : ALIGN(16) {\n" +#~ "\t\tbss_begin = .;\n" +#~ "\t\t*(.bss.*)\n" +#~ "\t\t*(COMMON)\n" +#~ "\t\t. = ALIGN(16);\n" +#~ "\t\tbss_end = .;\n" +#~ "\t} >image\n" +#~ "\n" +#~ "\t.stack (NOLOAD) : ALIGN(4096) {\n" +#~ "\t\tboot_stack_begin = .;\n" +#~ "\t\t. += 40 * 4096;\n" +#~ "\t\t. = ALIGN(4096);\n" +#~ "\t\tboot_stack_end = .;\n" +#~ "\t} >image\n" +#~ "\n" +#~ "\t. = ALIGN(4K);\n" +#~ "\tPROVIDE(dma_region = .);\n" +#~ "\n" +#~ "\t/*\n" +#~ "\t * 使用されていないセクションをイメージから削除します。\n" +#~ "\t */\n" +#~ "\t/DISCARD/ : {\n" +#~ "\t\t/* イメージは自分自身によりロードされるのでこれらのセクションは不要で" +#~ "す。*/\n" +#~ "\t\t*(.gnu.hash)\n" +#~ "\t\t*(.hash)\n" +#~ "\t\t*(.interp)\n" +#~ "\t\t*(.eh_frame_hdr)\n" +#~ "\t\t*(.eh_frame)\n" +#~ "\t\t*(.note.gnu.build-id)\n" +#~ "\t}\n" +#~ "}\n" +#~ "```" + +#~ msgid "# Copyright 2023 Google LLC" +#~ msgstr "# Copyright 2023 Google LLC" + +#~ msgid "$(shell uname -s)" +#~ msgstr "$(shell uname -s)" + +#~ msgid "aarch64-linux-gnu" +#~ msgstr "aarch64-linux-gnu" + +#~ msgid "stdio -display none -kernel $< -s" +#~ msgstr "stdio -display none -kernel $< -s" + +#~ msgid "cargo clean" +#~ msgstr "cargo clean" -#: src/glossary.md -msgid "" -"undefined behavior: \n" -"Actions or conditions in Rust that have no specified result, often leading " -"to unpredictable program behavior." -msgstr "" -"未定義の動作（undefined behavior）: \n" -"結果が指定されていない Rust のアクションまたは条件。多くの場合、プログラムの" -"予測不能な動作を引き起こします。" +#~ msgid "" +#~ "Threads are all daemon threads, the main thread does not wait for them." +#~ msgstr "" +#~ "スレッドはすべてデーモンスレッドで、メインスレッドはそれらを待ちません。" -#: src/glossary.md -msgid "" -"union: \n" -"A data type that can hold values of different types but only one at a time." -msgstr "" -"共用体（union）: \n" -"異なる型の値を一度に 1 つだけ保持できるデータ型。" +#, fuzzy +#~ msgid "" +#~ "Notice that the thread is stopped before it reaches 10 --- the main " +#~ "thread is not waiting." +#~ msgstr "" +#~ "スレッドはカウントが10に到達するまでに止められます。メインのスレッドは待機" +#~ "しません。" -#: src/glossary.md -msgid "" -"unit test: \n" -"Rust comes with built-in support for running small unit tests and larger " -"integration tests. See [Unit Tests](testing/unit-tests.html)." -msgstr "" -"単体テスト（unit test）: \n" -"Rust には、小規模な単体テストと大規模な統合テストを実行するための組み込みサ" -"ポートが付属しています。[単体テスト](testing/unit-tests.html) をご覧くださ" -"い。" +#~ msgid "" +#~ "Rust uses the type system to enforce synchronization of shared data. This " +#~ "is primarily done via two types:" +#~ msgstr "" +#~ "Rustは共有データを確実に同期するために型システムを利用します。これは主に2" +#~ "つの型により行われます：" -#: src/glossary.md -msgid "" -"unit type: \n" -"Type that holds no data, written as a tuple with no members." -msgstr "" -"ユニット型（unit type）: \n" -"データを保持しない型。メンバーのないタプルとして記述されます。" +#~ msgid "" +#~ "[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html), atomic " +#~ "reference counted `T`: handles sharing between threads and takes care to " +#~ "deallocate `T` when the last reference is dropped," +#~ msgstr "" +#~ "[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html), atomic " +#~ "reference counted `T` : スレッド間の共有を扱い、最後の参照がドロップされた" +#~ "とき `T` をデアロケートすることを担当する、" -#: src/glossary.md -msgid "" -"unsafe: \n" -"The subset of Rust which allows you to trigger _undefined behavior_. See " -"[Unsafe Rust](unsafe.html)." -msgstr "" -"安全でない（unsafe）: \n" -"未定義の動作をトリガーできる Rust のサブセット。[安全でない Rust](unsafe." -"html) をご覧ください。" +#~ msgid "" +#~ "[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html): " +#~ "ensures mutually exclusive access to the `T` value." +#~ msgstr "" +#~ "[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html): `T`型" +#~ "の値への相互排他的なアクセスを保証する。" -#: src/glossary.md -msgid "" -"variable: \n" -"A memory location storing data. Variables are valid in a _scope_." -msgstr "" -"変数（variable）: \n" -"データを格納するメモリの場所。変数はスコープ内で有効です。" +#~ msgid "Let us practice our new concurrency skills with" +#~ msgstr "次の演習を行い、並行性に関する新しいスキルを獲得しましょう。" + +#~ msgid "Dining philosophers: a classic problem in concurrency." +#~ msgstr "食事する哲学者：並行性に関する古典的な問題。" + +#~ msgid "" +#~ "Multi-threaded link checker: a larger project where you'll use Cargo to " +#~ "download dependencies and then check links in parallel." +#~ msgstr "" +#~ "マルチスレッド リンク チェッカー: Cargo を使用して依存関係をダウンロード" +#~ "し、リンクを同時にチェックする大規模なプロジェクト。" + +#~ msgid "" +#~ "For this, you will need an HTTP client such as [`reqwest`](https://docs." +#~ "rs/reqwest/). Create a new Cargo project and `reqwest` it as a dependency " +#~ "with:" +#~ msgstr "" +#~ "そのためには、[`reqwest`](https://docs.rs/reqwest/) などの HTTP クライアン" +#~ "トが必要です。次のコマンドで新しい Cargo プロジェクトを作成し、依存関係と" +#~ "して `reqwest` を追加します。" + +#~ msgid "" +#~ "You will also need a way to find links. We can use [`scraper`](https://" +#~ "docs.rs/scraper/) for that:" +#~ msgstr "" +#~ "また、リンクを見つける方法も必要です。これには [`scraper`](https://docs." +#~ "rs/scraper/) を使用します。" + +#~ msgid "" +#~ "Finally, we'll need some way of handling errors. We use [`thiserror`]" +#~ "(https://docs.rs/thiserror/) for that:" +#~ msgstr "" +#~ "最後に、エラーを処理する方法が必要になります。これには [`thiserror`]" +#~ "(https://docs.rs/thiserror/) を使用します。" -#: src/other-resources.md -msgid "Other Rust Resources" -msgstr "Rust のその他のリソース" +#~ msgid "Concurrency Morning Exercise" +#~ msgstr "並行性に関する午前のエクササイズ" -#: src/other-resources.md -msgid "" -"The Rust community has created a wealth of high-quality and free resources " -"online." -msgstr "" -"Rust コミュニティは、高品質な無料のリソースをオンラインで多数提供しています。" +#~ msgid "([back to exercise](dining-philosophers.md))" +#~ msgstr "（[演習に戻る](dining-philosophers.md)）" -#: src/other-resources.md -msgid "Official Documentation" -msgstr "正式なドキュメント" +#~ msgid "([back to exercise](link-checker.md))" +#~ msgstr "（[演習に戻る](link-checker.md)）" -#: src/other-resources.md -msgid "The Rust project hosts many resources. These cover Rust in general:" -msgstr "" -"Rust プロジェクトは多くのリソースをホストしており、これらは Rust 全般に対応し" -"ています。" +#~ msgid "Async Rust" +#~ msgstr "Asyncの基礎" -#: src/other-resources.md -msgid "" -"[The Rust Programming Language](https://doc.rust-lang.org/book/): the " -"canonical free book about Rust. Covers the language in detail and includes a " -"few projects for people to build." -msgstr "" -"[The Rust Programming Language](https://doc.rust-lang.org/book/): Rust の標準" -"的な書籍で、無料で利用できます。Rust について詳しく説明されているほか、ビルド" -"できるプロジェクトがいくつか含まれています。" +#~ msgid "Futures Control Flow" +#~ msgstr "Futureの制御フロー" -#: src/other-resources.md -msgid "" -"[Rust By Example](https://doc.rust-lang.org/rust-by-example/): covers the " -"Rust syntax via a series of examples which showcase different constructs. " -"Sometimes includes small exercises where you are asked to expand on the code " -"in the examples." -msgstr "" -"[Rust By Example](https://doc.rust-lang.org/rust-by-example/): さまざまな構造" -"を示す一連のサンプルを使用して、Rust の構文を解説しています。小規模な演習がい" -"くつか用意されており、そこでサンプルのコードを拡張するよう求められます。" +#~ msgid "" +#~ "Futures can be combined together to produce concurrent compute flow " +#~ "graphs. We have already seen tasks, that function as independent threads " +#~ "of execution." +#~ msgstr "" +#~ "並行計算フローグラフを生成するために、futureを組み合わせることができます。" +#~ "すでに独立したスレッドとして機能するタスクを見てきました。" -#: src/other-resources.md -msgid "" -"[Rust Standard Library](https://doc.rust-lang.org/std/): full documentation " -"of the standard library for Rust." -msgstr "" -"[Rust Standard Library](https://doc.rust-lang.org/std/): Rust の標準ライブラ" -"リの完全なドキュメントです。" +#~ msgid "[Join](control-flow/join.md)" +#~ msgstr "[結合](control-flow/join.md)" -#: src/other-resources.md -msgid "" -"[The Rust Reference](https://doc.rust-lang.org/reference/): an incomplete " -"book which describes the Rust grammar and memory model." -msgstr "" -"[The Rust Reference](https://doc.rust-lang.org/reference/): Rust の文法とメモ" -"リモデルについて説明している未完成の書籍です。" +#~ msgid "[Select](control-flow/select.md)" +#~ msgstr "[選択](control-flow/select.md)" -#: src/other-resources.md -msgid "More specialized guides hosted on the official Rust site:" -msgstr "Rust の公式サイトでホストされている、より専門的なガイド:" +#~ msgid "\"Felix\"" +#~ msgstr "\"Felix\"" -#: src/other-resources.md -msgid "" -"[The Rustonomicon](https://doc.rust-lang.org/nomicon/): covers unsafe Rust, " -"including working with raw pointers and interfacing with other languages " -"(FFI)." -msgstr "" -"[The Rustonomicon](https://doc.rust-lang.org/nomicon/): 未加工のポインタの操" -"作や、他の言語（FFI）とのやり取りなど、安全でない Rust について説明していま" -"す。" +#~ msgid "\"Failed to send cat.\"" +#~ msgstr "\"Failed to send cat.\"" -#: src/other-resources.md -msgid "" -"[Asynchronous Programming in Rust](https://rust-lang.github.io/async-book/): " -"covers the new asynchronous programming model which was introduced after the " -"Rust Book was written." -msgstr "" -"[Asynchronous Programming in Rust](https://rust-lang.github.io/async-book/): " -"Rust Book の執筆後に導入された新しい非同期プログラミング モデルについて説明し" -"ています。" +#~ msgid "\"Failed to send dog.\"" +#~ msgstr "\"Failed to send dog.\"" -#: src/other-resources.md -msgid "" -"[The Embedded Rust Book](https://doc.rust-lang.org/stable/embedded-book/): " -"an introduction to using Rust on embedded devices without an operating " -"system." -msgstr "" -"[The Embedded Rust Book](https://doc.rust-lang.org/stable/embedded-book/): オ" -"ペレーティング システムのない組み込みデバイスで Rust を使用する方法を紹介して" -"います。" +#~ msgid "\"Failed to receive winner\"" +#~ msgstr "\"Failed to receive winner\"" -#: src/other-resources.md -msgid "Unofficial Learning Material" -msgstr "非公式の学習教材" +#~ msgid "\"Winner is {winner:?}\"" +#~ msgstr "\"Winner is {winner:?}\"" -#: src/other-resources.md -msgid "A small selection of other guides and tutorial for Rust:" -msgstr "Rust に関するその他のガイドとチュートリアル:" +#, fuzzy +#~ msgid "" +#~ "In this example, we have a race between a cat and a dog. " +#~ "`first_animal_to_finish_race` listens to both channels and will pick " +#~ "whichever arrives first. Since the dog takes 50ms, it wins against the " +#~ "cat that take 500ms." +#~ msgstr "" +#~ "この例では、猫と犬のレースを扱っています。`first_animal_to_finish_race`は" +#~ "両方のチャネルをリッスンし、先に到着した方を選びます。犬は到着まで50msかか" +#~ "るので、500msかかる猫に勝ちます。" -#: src/other-resources.md -msgid "" -"[Learn Rust the Dangerous Way](http://cliffle.com/p/dangerust/): covers Rust " -"from the perspective of low-level C programmers." -msgstr "" -"[Learn Rust the Dangerous Way](http://cliffle.com/p/dangerust/): 高度な知識を" -"持たない C プログラマーの視点で Rust を解説しています。" +#~ msgid "" +#~ "You can use `oneshot` channels in this example as the channels are " +#~ "supposed to receive only one `send`." +#~ msgstr "" +#~ "この例では`oneshot`チャネルを使うこともできます。なぜなら、チャネルは一回" +#~ "きりの`send`を受け取ることになっているからです。" -#: src/other-resources.md -msgid "" -"[Rust for Embedded C Programmers](https://docs.opentitan.org/doc/ug/" -"rust_for_c/): covers Rust from the perspective of developers who write " -"firmware in C." -msgstr "" -"[Rust for Embedded C Programmers](https://docs.opentitan.org/doc/ug/" -"rust_for_c/): ファームウェアを C で記述するデベロッパーの観点から Rust を解説" -"しています。" +#~ msgid "" +#~ "Try adding a deadline to the race, demonstrating selecting different " +#~ "sorts of futures." +#~ msgstr "" +#~ "レースに制限時間を追加することによって、違う種類のfutureをselectすることを" +#~ "実演してみてください。" -#: src/other-resources.md -msgid "" -"[Rust for professionals](https://overexact.com/rust-for-professionals/): " -"covers the syntax of Rust using side-by-side comparisons with other " -"languages such as C, C++, Java, JavaScript, and Python." -msgstr "" -"[Rust for professionals](https://overexact.com/rust-for-professionals/): 他の" -"言語（C、C++、Java、JavaScript、Python など）と並べて比較しながら、Rust の構" -"文について説明しています。" +#~ msgid "" +#~ "Note that `select!` drops unmatched branches, which cancels their " +#~ "futures. It is easiest to use when every execution of `select!` creates " +#~ "new futures." +#~ msgstr "" +#~ "`select!`はマッチしなかったブランチをドロップすることに注意してください。" +#~ "これは、そうしたブランチのfutureがキャンセルされることにつながります。" +#~ "`select!`を毎回実行する際に新たなfutureが作成されるときに、`select!`を使う" +#~ "のが最も簡単です。" -#: src/other-resources.md -msgid "" -"[Rust on Exercism](https://exercism.org/tracks/rust): 100+ exercises to help " -"you learn Rust." -msgstr "" -"[Rust on Exercism](https://exercism.org/tracks/rust): Rust の学習に役立つ " -"100 以上の演習が用意されています。" +#~ msgid "" +#~ "An alternative is to pass `&mut future` instead of the future itself, but " +#~ "this can lead to issues, further discussed in the pinning slide." +#~ msgstr "" +#~ "Futureそのものでなく、`&mut future`を渡すという代替案もあります。しかし、" +#~ "これは問題につながることもあります。このことはPinに関するスライドで詳細に" +#~ "議論します。" -#: src/other-resources.md -msgid "" -"[Ferrous Teaching Material](https://ferrous-systems.github.io/teaching-" -"material/index.html): a series of small presentations covering both basic " -"and advanced part of the Rust language. Other topics such as WebAssembly, " -"and async/await are also covered." -msgstr "" -"[Ferrous Teaching Material](https://ferrous-systems.github.io/teaching-" -"material/index.html): Rust 言語の基本的な部分と高度な部分の両方をカバーした、" -"一連のコンパクトなプレゼンテーションです。WebAssembly、async / await などの他" -"のトピックも扱っています。" +#~ msgid "Pitfalls of async/await" +#~ msgstr "async / await の注意点" -#: src/other-resources.md -msgid "" -"[Beginner's Series to Rust](https://docs.microsoft.com/en-us/shows/beginners-" -"series-to-rust/) and [Take your first steps with Rust](https://docs." -"microsoft.com/en-us/learn/paths/rust-first-steps/): two Rust guides aimed at " -"new developers. The first is a set of 35 videos and the second is a set of " -"11 modules which covers Rust syntax and basic constructs." -msgstr "" -"[Beginner's Series to Rust](https://docs.microsoft.com/ja-jp/shows/beginners-" -"series-to-rust/) および [Take your first steps with Rust](https://docs." -"microsoft. com/en-us/learn/paths/rust-first-steps/): 初心者のデベロッパーを対" -"象とした 2 つの Rust ガイドです。1 つ目は 35 個の動画で構成され、2 つ目は " -"Rust の構文と基本的な構造を説明する 11 のモジュールで構成されています。" +#~ msgid "[Blocking the Executor](pitfalls/blocking-executor.md)" +#~ msgstr "[エグゼキュータのブロック](pitfalls/blocking-executor.md)" -#: src/other-resources.md -msgid "" -"[Learn Rust With Entirely Too Many Linked Lists](https://rust-unofficial." -"github.io/too-many-lists/): in-depth exploration of Rust's memory management " -"rules, through implementing a few different types of list structures." -msgstr "" -"[Learn Rust With Entirely Too Many Linked Lists](https://rust-unofficial." -"github.io/too-many-lists/): いくつかの異なるタイプのリスト構造の実装を通じ" -"て、Rust のメモリ管理ルールを深く掘り下げています。" +#~ msgid "[Pin](pitfalls/pin.md)" +#~ msgstr "[Pin](pitfalls/pin.md)" -#: src/other-resources.md -msgid "" -"Please see the [Little Book of Rust Books](https://lborb.github.io/book/) " -"for even more Rust books." -msgstr "" -"Rust に関するその他の書籍については、[Little Book of Rust Books](https://" -"lborb.github.io/book/) をご覧ください。" +#~ msgid "[Async Traits](pitfalls/async-traits.md)" +#~ msgstr "[Async トレイト](pitfalls/async-traits.md)" -#: src/credits.md -msgid "" -"The material here builds on top of the many great sources of Rust " -"documentation. See the page on [other resources](other-resources.md) for a " -"full list of useful resources." -msgstr "" -"ここで紹介する教材は、多くの優れた Rust ドキュメントのソースに基づいていま" -"す。役立つリソースの一覧については、[その他のリソース](other-resources.md) の" -"ページをご覧ください。" +#~ msgid "[Cancellation](pitfalls/cancellation.md)" +#~ msgstr "[キャンセル](pitfalls/cancellation.md)" -#: src/credits.md -msgid "" -"The material of Comprehensive Rust is licensed under the terms of the Apache " -"2.0 license, please see [`LICENSE`](https://github.com/google/comprehensive-" -"rust/blob/main/LICENSE) for details." -msgstr "" -"Comprehensive Rust の教材は、Apache 2.0 ライセンスの規約により使用が許諾され" -"ています。詳細については、[`LICENSE`](https://github.com/google/" -"comprehensive-rust/blob/main/LICENSE) をご覧ください。" +#~ msgid "" +#~ "Async methods in traits are not yet supported in the stable channel ([An " +#~ "experimental feature exists in nightly and should be stabilized in the " +#~ "mid term.](https://blog.rust-lang.org/inside-rust/2022/11/17/async-fn-in-" +#~ "trait-nightly.html))" +#~ msgstr "" +#~ "トレイトの非同期メソッドは、Stable チャンネルではまだサポートされていませ" +#~ "ん（[試験運用版の機能はナイトリーに存在するため、中期的には安定するはずで" +#~ "す。](https://blog.rust-lang.org/inside-rust/2022/11/17/async-fn-in-trait-" +#~ "nightly.html)）" -#: src/credits.md -msgid "Rust by Example" -msgstr "Rust by Example" +#~ msgid "" +#~ "To practice your Async Rust skills, we have again two exercises for you:" +#~ msgstr "非同期 Rust のスキルを磨くため、ここでも 2 つの演習を行います。" -#: src/credits.md -msgid "" -"Some examples and exercises have been copied and adapted from [Rust by " -"Example](https://doc.rust-lang.org/rust-by-example/). Please see the " -"`third_party/rust-by-example/` directory for details, including the license " -"terms." -msgstr "" -"一部の例と演習は、[Rust by Example](https://doc.rust-lang.org/rust-by-" -"example/) からコピーして編集したものです。ライセンス規約などの詳細について" -"は、`third_party/rust-by-example/` ディレクトリを参照してください。" +#~ msgid "" +#~ "Dining philosophers: we already saw this problem in the morning. This " +#~ "time you are going to implement it with Async Rust." +#~ msgstr "" +#~ "食事する哲学者: この問題は午前の部ですでに取り上げましたが、今回は非同期 " +#~ "Rust を使用してこれを実装します。" -#: src/credits.md -msgid "Rust on Exercism" -msgstr "Rust on Exercism" +#~ msgid "" +#~ "A Broadcast Chat Application: this is a larger project that allows you " +#~ "experiment with more advanced Async Rust features." +#~ msgstr "" +#~ "ブロードキャスト チャット アプリ: より高度な非同期 Rust 機能をテストできる" +#~ "大規模なプロジェクトです。" -#: src/credits.md -msgid "" -"Some exercises have been copied and adapted from [Rust on Exercism](https://" -"exercism.org/tracks/rust). Please see the `third_party/rust-on-exercism/` " -"directory for details, including the license terms." -msgstr "" -"一部の演習は、[Rust on Exercism](https://exercism.org/tracks/rust) をコピーし" -"て編集したものです。ライセンス規約などの詳細については、`third_party/rust-on-" -"exercism/` ディレクトリを参照してください。" +#~ msgid "Concurrency Afternoon Exercise" +#~ msgstr "午後の同時実行のエクササイズ" -#: src/credits.md -msgid "CXX" -msgstr "CXX" +#~ msgid "([back to exercise](dining-philosophers-async.md))" +#~ msgstr "（[演習に戻る](dining-philosophers-async.md)）" -#: src/credits.md -msgid "" -"The [Interoperability with C++](android/interoperability/cpp.md) section " -"uses an image from [CXX](https://cxx.rs/). Please see the `third_party/cxx/` " -"directory for details, including the license terms." -msgstr "" -"[C++ との相互運用性](android/interoperability/cpp.md) セクションでは、[CXX]" -"(https://cxx.rs/) の画像を使用しています。ライセンス規約などの詳細について" -"は、`third_party/cxx/` ディレクトリを参照してください。" +#~ msgid "" +#~ "// Add a delay before picking the second fork to allow the execution\n" +#~ " // to transfer to another task\n" +#~ msgstr "" +#~ "// 実行を別のタスクに転送できるよう、2 番目のフォークを選択する前に\n" +#~ " // 遅延を追加します。\n" + +#~ msgid "" +#~ "// To avoid a deadlock, we have to break the symmetry\n" +#~ " // somewhere. This will swap the forks without " +#~ "deinitializing\n" +#~ " // either of them.\n" +#~ msgstr "" +#~ "// デッドロックを避けるために、どこかで対称性を\n" +#~ " // 崩す必要があります。これにより、いずれのフォークも初期化解" +#~ "除することなく、フォークが\n" +#~ " // スワップされます。\n" + +#~ msgid "([back to exercise](chat-app.md))" +#~ msgstr "（[演習に戻る](chat-app.md)）" #, fuzzy #~ msgid "With C++)" @@ -24289,9 +26197,6 @@ msgstr "" #~ msgid "Arrays and for Loops" #~ msgstr "配列とforループ" -#~ msgid "if expressions" -#~ msgstr "if式" - #~ msgid "for expressions" #~ msgstr "for式" @@ -24310,10 +26215,6 @@ msgstr "" #~ msgid "Enum Sizes" #~ msgstr "列挙型のサイズ" -#, fuzzy -#~ msgid "Novel Control Flow" -#~ msgstr "制御フロー" - #~ msgid "if let expressions" #~ msgstr "if let式" @@ -24323,9 +26224,6 @@ msgstr "" #~ msgid "match expressions" #~ msgstr "match式" -#~ msgid "Destructuring Structs" -#~ msgstr "構造体編" - #~ msgid "Destructuring Arrays" #~ msgstr "配列編" @@ -24365,9 +26263,6 @@ msgstr "" #~ msgid "Field Shorthand Syntax" #~ msgstr "フィールドの省略" -#~ msgid "Method Receiver" -#~ msgstr "メソッドレシーバ" - #, fuzzy #~ msgid "Storing Books" #~ msgstr "文字列（String）" @@ -24375,18 +26270,9 @@ msgstr "" #~ msgid "Option and Result" #~ msgstr "OptionとResult" -#~ msgid "Vec" -#~ msgstr "ベクタ（Vec）" - -#~ msgid "HashMap" -#~ msgstr "ハッシュマップ（HashMap）" - #~ msgid "Box" #~ msgstr "ボックス（Box）" -#~ msgid "Rc" -#~ msgstr "Rc" - #~ msgid "Iterators and Ownership" #~ msgstr "イテレータと所有権" @@ -24402,15 +26288,9 @@ msgstr "" #~ msgid "Default Methods" #~ msgstr "デフォルトメソッド" -#~ msgid "impl Trait" -#~ msgstr "impl Trait" - #~ msgid "Important Traits" #~ msgstr "重要なトレイト" -#~ msgid "From and Into" -#~ msgstr "FromとInto" - #~ msgid "Default" #~ msgstr "Default" @@ -24465,27 +26345,6 @@ msgstr "" #~ msgid "spin" #~ msgstr "spin" -#~ msgid "Send and Sync" -#~ msgstr "SendとSync" - -#~ msgid "Send" -#~ msgstr "Send" - -#~ msgid "Sync" -#~ msgstr "Sync" - -#~ msgid "Arc" -#~ msgstr "Arc" - -#~ msgid "Mutex" -#~ msgstr "Mutex" - -#~ msgid "async/await" -#~ msgstr "async/await" - -#~ msgid "Pin" -#~ msgstr "Pin" - #~ msgid "Day 1 Morning" #~ msgstr "Day 1 AM" diff --git a/src/std-traits/closures.md b/src/std-traits/closures.md index cd7c013f68a..cdd315d251c 100644 --- a/src/std-traits/closures.md +++ b/src/std-traits/closures.md @@ -10,39 +10,41 @@ implement special [`Fn`](https://doc.rust-lang.org/std/ops/trait.Fn.html), [`FnOnce`](https://doc.rust-lang.org/std/ops/trait.FnOnce.html) traits: ```rust,editable -fn apply_with_log(func: impl FnOnce(i32) -> i32, input: i32) -> i32 { - println!("Calling function on {input}"); - func(input) +fn apply_and_log(func: impl FnOnce(i32) -> i32, func_name: &str, input: i32) { + println!("Calling {func_name}({input}): {}", func(input)) } fn main() { - let add_3 = |x| x + 3; - println!("add_3: {}", apply_with_log(add_3, 10)); - println!("add_3: {}", apply_with_log(add_3, 20)); + let n = 3; + let add_3 = |x| x + n; + apply_and_log(&add_3, "add_3", 10); + apply_and_log(&add_3, "add_3", 20); let mut v = Vec::new(); let mut accumulate = |x: i32| { v.push(x); v.iter().sum::() }; - println!("accumulate: {}", apply_with_log(&mut accumulate, 4)); - println!("accumulate: {}", apply_with_log(&mut accumulate, 5)); + apply_and_log(&mut accumulate, "accumulate", 4); + apply_and_log(&mut accumulate, "accumulate", 5); let multiply_sum = |x| x * v.into_iter().sum::(); - println!("multiply_sum: {}", apply_with_log(multiply_sum, 3)); + apply_and_log(multiply_sum, "multiply_sum", 3); } ```
-An `Fn` (e.g. `add_3`) neither consumes nor mutates captured values, or perhaps -captures nothing at all. It can be called multiple times concurrently. +An `Fn` (e.g. `add_3`) neither consumes nor mutates captured values. It can be +called needing only a shared reference to the closure, which means the closure +can be executed repeatedly and even concurrently. -An `FnMut` (e.g. `accumulate`) might mutate captured values. You can call it -multiple times, but not concurrently. +An `FnMut` (e.g. `accumulate`) might mutate captured values. The closure object +is accessed via exclusive reference, so it can be called repeatedly but not +concurrently. -If you have an `FnOnce` (e.g. `multiply_sum`), you may only call it once. It -might consume captured values. +If you have an `FnOnce` (e.g. `multiply_sum`), you may only call it once. Doing +so consumes the closure and any values captured by move. `FnMut` is a subtype of `FnOnce`. `Fn` is a subtype of `FnMut` and `FnOnce`. I.e. you can use an `FnMut` wherever an `FnOnce` is called for, and you can use @@ -52,14 +54,17 @@ When you define a function that takes a closure, you should take `FnOnce` if you can (i.e. you call it once), or `FnMut` else, and last `Fn`. This allows the most flexibility for the caller. -In contrast, when you have a closure, the most flexible you can have is `Fn` (it -can be passed everywhere), then `FnMut`, and lastly `FnOnce`. +In contrast, when you have a closure, the most flexible you can have is `Fn` +(which can be passed to a consumer of any of the 3 closure traits), then +`FnMut`, and lastly `FnOnce`. The compiler also infers `Copy` (e.g. for `add_3`) and `Clone` (e.g. -`multiply_sum`), depending on what the closure captures. +`multiply_sum`), depending on what the closure captures. Function pointers +(references to `fn` items) implement `Copy` and `Fn`. -By default, closures will capture by reference if they can. The `move` keyword -makes them capture by value. +By default, closures will capture each variable from an outer scope by the least +demanding form of access they can (by shared reference if possible, then +exclusive reference, then by move). The `move` keyword forces capture by value. ```rust,editable fn make_greeter(prefix: String) -> impl Fn(&str) {