From 5aa08d489fc0266ad17d7e52eb0670e1415fc946 Mon Sep 17 00:00:00 2001 From: Danny Khosravi Date: Thu, 12 Sep 2024 10:33:11 +0330 Subject: [PATCH 1/3] fa: refreshed Translation For Farsi (#2363) fa: refreshed Translation For Farsi I follow [Refreshing an Existing Translation](https://github.com/google/comprehensive-rust/blob/main/TRANSLATIONS.md#refreshing-an-existing-translation) --------- Co-authored-by: javad-jafari Co-authored-by: javad-jafari <65780584+javad-jafari@users.noreply.github.com> --- po/fa.po | 7121 +++++++++++++++++++++++++++--------------------------- 1 file changed, 3547 insertions(+), 3574 deletions(-) diff --git a/po/fa.po b/po/fa.po index 1b21db68a21..e9b1d3ddff6 100644 --- a/po/fa.po +++ b/po/fa.po @@ -1,7 +1,7 @@ msgid "" msgstr "" "Project-Id-Version: Comprehensive Rust 🦀\n" -"POT-Creation-Date: 2024-07-24T09:42:45+03:30\n" +"POT-Creation-Date: 2024-09-11T22:10:46Z\n" "PO-Revision-Date: 2024-09-08 20:39+0330\n" "Last-Translator: alix1383 \n" "Language-Team: Persian\n" @@ -20,15 +20,15 @@ msgstr "به Comprehensive Rust خوش آمدید 🦀" msgid "Running the Course" msgstr "اجرای دوره" -#: src/SUMMARY.md src/running-the-course/course-structure.md:1 +#: src/SUMMARY.md src/running-the-course/course-structure.md msgid "Course Structure" msgstr "مباحث دوره" -#: src/SUMMARY.md src/running-the-course/keyboard-shortcuts.md:1 +#: src/SUMMARY.md src/running-the-course/keyboard-shortcuts.md msgid "Keyboard Shortcuts" msgstr "میان‌برهای صفحه کلید" -#: src/SUMMARY.md src/running-the-course/translations.md:1 +#: src/SUMMARY.md src/running-the-course/translations.md msgid "Translations" msgstr "ترجمه" @@ -52,72 +52,69 @@ msgstr "اجرای کد به صورت لوکال با cargo" msgid "Day 1: Morning" msgstr "روز ۱: صبح" -#: src/SUMMARY.md src/running-the-course/course-structure.md:15 -#: src/running-the-course/course-structure.md:34 -#: src/running-the-course/course-structure.md:52 -#: src/running-the-course/course-structure.md:69 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 +#: 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/running-the-course/course-structure.md:16 +#: 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:1 +#: src/types-and-values/hello-world.md msgid "Hello, World" msgstr "سلام, دنیا" -#: src/SUMMARY.md src/hello-world.md src/hello-world/what-is-rust.md:1 +#: 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.md src/hello-world/benefits.md:1 +#: src/SUMMARY.md src/hello-world.md src/hello-world/benefits.md msgid "Benefits of Rust" msgstr "مزیت‌های زبان Rust" -#: src/SUMMARY.md src/hello-world.md src/hello-world/playground.md:1 +#: src/SUMMARY.md src/hello-world.md src/hello-world/playground.md msgid "Playground" msgstr "Playground" -#: src/SUMMARY.md src/running-the-course/course-structure.md:17 +#: 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.md src/types-and-values/variables.md:1 +#: src/SUMMARY.md src/types-and-values.md src/types-and-values/variables.md msgid "Variables" msgstr "متغیرها" -#: src/SUMMARY.md src/types-and-values.md src/types-and-values/values.md:1 +#: src/SUMMARY.md src/types-and-values.md src/types-and-values/values.md msgid "Values" msgstr "مقادیر" -#: src/SUMMARY.md src/types-and-values.md src/types-and-values/arithmetic.md:1 +#: src/SUMMARY.md src/types-and-values.md src/types-and-values/arithmetic.md msgid "Arithmetic" msgstr "عملگرهای ریاضی" -#: src/SUMMARY.md src/types-and-values.md src/types-and-values/inference.md:1 +#: 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.md src/types-and-values/exercise.md:1 +#: src/SUMMARY.md src/types-and-values.md src/types-and-values/exercise.md msgid "Exercise: Fibonacci" msgstr "تمرین: دنباله فیبوناچی" -#: src/SUMMARY.md src/types-and-values/solution.md:1 -#: src/control-flow-basics/solution.md:1 src/tuples-and-arrays/solution.md:1 -#: src/references/solution.md:1 src/user-defined-types/solution.md:1 -#: src/pattern-matching/solution.md:1 src/methods-and-traits/solution.md:1 -#: src/generics/solution.md:1 src/std-types/solution.md:1 -#: src/std-traits/solution.md:1 src/memory-management/solution.md:1 -#: src/smart-pointers/solution.md:1 src/borrowing/solution.md:1 -#: src/lifetimes/solution.md:1 src/iterators/solution.md:1 -#: src/modules/solution.md:1 src/testing/solution.md:1 -#: src/error-handling/solution.md:1 src/unsafe-rust/solution.md:1 +#: src/SUMMARY.md src/types-and-values/solution.md +#: src/control-flow-basics/solution.md src/tuples-and-arrays/solution.md +#: src/references/solution.md src/user-defined-types/solution.md +#: src/pattern-matching/solution.md src/methods-and-traits/solution.md +#: 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/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/running-the-course/course-structure.md:18 +#: 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 "مبانی پایه کنترل جریان" @@ -126,47 +123,46 @@ msgstr "مبانی پایه کنترل جریان" msgid "`if` Expressions" msgstr "عبارات `if`" -#: src/SUMMARY.md src/control-flow-basics.md src/control-flow-basics/loops.md:1 +#: 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:1 +#: src/SUMMARY.md src/control-flow-basics/loops/for.md msgid "`for`" msgstr "`for`" -#: src/SUMMARY.md src/control-flow-basics/loops/loop.md:1 +#: src/SUMMARY.md src/control-flow-basics/loops/loop.md msgid "`loop`" msgstr "`loop`" -#: src/SUMMARY.md src/control-flow-basics/break-continue.md:1 +#: src/SUMMARY.md src/control-flow-basics/break-continue.md msgid "`break` and `continue`" msgstr "`break` و `continue`" -#: src/SUMMARY.md src/control-flow-basics/break-continue/labels.md:1 +#: 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:1 +#: src/control-flow-basics/blocks-and-scopes.md msgid "Blocks and Scopes" msgstr "بلوک‌ها و محدوده‌ها" -#: src/SUMMARY.md src/control-flow-basics/blocks-and-scopes/scopes.md:1 +#: 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:1 +#: src/control-flow-basics/functions.md msgid "Functions" msgstr "توابع" -#: src/SUMMARY.md src/control-flow-basics.md -#: src/control-flow-basics/macros.md:1 +#: src/SUMMARY.md src/control-flow-basics.md src/control-flow-basics/macros.md msgid "Macros" msgstr "ماکروها" #: src/SUMMARY.md src/control-flow-basics.md -#: src/control-flow-basics/exercise.md:1 +#: src/control-flow-basics/exercise.md msgid "Exercise: Collatz Sequence" msgstr "تمرین: دنباله Collatz" @@ -174,91 +170,90 @@ msgstr "تمرین: دنباله Collatz" msgid "Day 1: Afternoon" msgstr "روز ۱: بعد از ظهر" -#: src/SUMMARY.md src/running-the-course/course-structure.md:25 +#: 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.md src/tuples-and-arrays/arrays.md:1 +#: 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:1 +#: 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:1 +#: 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.md -#: src/tuples-and-arrays/destructuring.md:1 +#: src/tuples-and-arrays/destructuring.md msgid "Patterns and Destructuring" msgstr "الگو‌ها و ضدِ ساختارها" -#: src/SUMMARY.md src/tuples-and-arrays.md src/tuples-and-arrays/exercise.md:1 +#: src/SUMMARY.md src/tuples-and-arrays.md src/tuples-and-arrays/exercise.md msgid "Exercise: Nested Arrays" msgstr "تمرین: آرایه‌های تو در تو" -#: src/SUMMARY.md src/running-the-course/course-structure.md:26 +#: 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.md src/references/shared.md:1 +#: src/SUMMARY.md src/references.md src/references/shared.md msgid "Shared References" msgstr "مراجع اشتراکی" -#: src/SUMMARY.md src/references.md src/references/exclusive.md:1 +#: src/SUMMARY.md src/references.md src/references/exclusive.md msgid "Exclusive References" msgstr "مراجع انحصاری " -#: src/SUMMARY.md -msgid "Slices: `&[T]`" -msgstr "برش ها: `&[T]`" +#: src/SUMMARY.md src/references.md src/references/slices.md +msgid "Slices" +msgstr "برش‌ها" -#: src/SUMMARY.md src/references.md src/references/strings.md:5 +#: src/SUMMARY.md src/references.md src/references/strings.md msgid "Strings" msgstr "رشته‌ها" -#: src/SUMMARY.md src/references.md src/references/exercise.md:1 +#: src/SUMMARY.md src/references.md src/references/exercise.md msgid "Exercise: Geometry" msgstr "تمرین: هندسه" -#: src/SUMMARY.md src/running-the-course/course-structure.md:27 +#: 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.md -#: src/user-defined-types/named-structs.md:1 +#: src/user-defined-types/named-structs.md msgid "Named Structs" msgstr "ساختارهای نام‌دار" #: src/SUMMARY.md src/user-defined-types.md -#: src/user-defined-types/tuple-structs.md:5 +#: src/user-defined-types/tuple-structs.md msgid "Tuple Structs" msgstr "ساختار‌ تاپل‌ها" -#: src/SUMMARY.md src/user-defined-types.md src/user-defined-types/enums.md:1 -#: src/pattern-matching/destructuring-enums.md:1 +#: 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.md -msgid "Static" -msgstr "Static" - #: src/SUMMARY.md msgid "Const" msgstr "Const" -#: src/SUMMARY.md src/user-defined-types.md src/user-defined-types/aliases.md:1 +#: src/SUMMARY.md src/user-defined-types.md +msgid "Static" +msgstr "Static" + +#: 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.md -#: src/user-defined-types/exercise.md:1 +#: src/SUMMARY.md src/user-defined-types.md src/user-defined-types/exercise.md msgid "Exercise: Elevator Events" msgstr "تمرین: رویدادهای آسانسور" @@ -266,12 +261,12 @@ msgstr "تمرین: رویدادهای آسانسور" msgid "Day 2: Morning" msgstr "روز ۲: صبح" -#: src/SUMMARY.md src/running-the-course/course-structure.md:35 +#: 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:1 +#: src/SUMMARY.md src/pattern-matching.md src/pattern-matching/match.md msgid "Matching Values" msgstr "تطابق مقادیر" @@ -285,41 +280,40 @@ msgid "Destructuring Enums" msgstr "Enum‌ های تفکیک‌‌پذیر" #: src/SUMMARY.md src/pattern-matching.md -#: src/pattern-matching/let-control-flow.md:1 +#: src/pattern-matching/let-control-flow.md msgid "Let Control Flow" msgstr "کنترل جریان Let" -#: src/SUMMARY.md src/pattern-matching.md src/pattern-matching/exercise.md:1 +#: src/SUMMARY.md src/pattern-matching.md src/pattern-matching/exercise.md msgid "Exercise: Expression Evaluation" msgstr "تمرین: ارزیابی عبارت" -#: src/SUMMARY.md src/running-the-course/course-structure.md:36 +#: 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.md src/methods-and-traits/methods.md:1 +#: src/SUMMARY.md src/methods-and-traits.md src/methods-and-traits/methods.md msgid "Methods" msgstr "متدها" -#: src/SUMMARY.md src/methods-and-traits.md src/methods-and-traits/traits.md:1 +#: src/SUMMARY.md src/methods-and-traits.md src/methods-and-traits/traits.md msgid "Traits" msgstr "Traits" -#: src/SUMMARY.md src/methods-and-traits/traits/implementing.md:1 +#: src/SUMMARY.md src/methods-and-traits/traits/implementing.md msgid "Implementing Traits" msgstr "پیاده سازی Traits" -#: src/SUMMARY.md src/methods-and-traits/traits/supertraits.md:1 +#: src/SUMMARY.md src/methods-and-traits/traits/supertraits.md msgid "Supertraits" msgstr "Supertraits" -#: src/SUMMARY.md src/methods-and-traits/traits/associated-types.md:1 +#: src/SUMMARY.md src/methods-and-traits/traits/associated-types.md msgid "Associated Types" msgstr "تایپ‌های وابسته" -#: src/SUMMARY.md src/methods-and-traits.md -#: src/methods-and-traits/deriving.md:1 +#: src/SUMMARY.md src/methods-and-traits.md src/methods-and-traits/deriving.md msgid "Deriving" msgstr "Deriving" @@ -331,49 +325,49 @@ msgstr "تمرین: توابع Generic" msgid "Day 2: Afternoon" msgstr "روز دوم: عصر" -#: src/SUMMARY.md src/running-the-course/course-structure.md:43 +#: 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.md src/generics/generic-functions.md:1 +#: src/SUMMARY.md src/generics.md src/generics/generic-functions.md msgid "Generic Functions" msgstr "توابع Generic" -#: src/SUMMARY.md src/generics.md src/generics/generic-data.md:1 +#: src/SUMMARY.md src/generics.md src/generics/generic-data.md msgid "Generic Data Types" msgstr "دیتا تایپ‌های Generic" -#: src/SUMMARY.md src/generics/generic-traits.md:1 +#: src/SUMMARY.md src/generics/generic-traits.md msgid "Generic Traits" msgstr "Generic Traits" -#: src/SUMMARY.md src/generics.md src/generics/trait-bounds.md:1 +#: src/SUMMARY.md src/generics.md src/generics/trait-bounds.md msgid "Trait Bounds" msgstr "Trait Bounds" -#: src/SUMMARY.md src/generics/impl-trait.md:1 +#: src/SUMMARY.md src/generics/impl-trait.md msgid "`impl Trait`" msgstr "`impl Trait`" -#: src/SUMMARY.md src/generics/dyn-trait.md:1 +#: src/SUMMARY.md src/generics/dyn-trait.md msgid "`dyn Trait`" msgstr "`dyn Trait`" -#: src/SUMMARY.md src/generics/exercise.md:1 +#: src/SUMMARY.md src/generics/exercise.md msgid "Exercise: Generic `min`" msgstr "تمرین: Generic `min`" -#: src/SUMMARY.md src/running-the-course/course-structure.md:44 +#: src/SUMMARY.md src/running-the-course/course-structure.md #: src/welcome-day-2-afternoon.md src/std-types.md msgid "Standard Library Types" msgstr "کتابخانه‌ استاندارد تایپ‌ها" -#: src/SUMMARY.md src/std-types.md src/std-types/std.md:1 +#: src/SUMMARY.md src/std-types.md src/std-types/std.md msgid "Standard Library" msgstr "کتابخانه‌ استاندارد" -#: src/SUMMARY.md src/std-types.md src/std-types/docs.md:1 +#: src/SUMMARY.md src/std-types.md src/std-types/docs.md msgid "Documentation" msgstr "مستندات" @@ -381,50 +375,50 @@ msgstr "مستندات" msgid "`Option`" msgstr "`Option`" -#: src/SUMMARY.md src/error-handling/result.md:1 +#: src/SUMMARY.md src/error-handling/result.md msgid "`Result`" msgstr "`Result`" -#: src/SUMMARY.md src/android/aidl/types/primitives.md:14 -#: src/android/interoperability/cpp/type-mapping.md:5 +#: src/SUMMARY.md src/android/aidl/types/primitives.md +#: src/android/interoperability/cpp/type-mapping.md msgid "`String`" msgstr "`String`" -#: src/SUMMARY.md src/std-types/vec.md:1 +#: src/SUMMARY.md src/std-types/vec.md msgid "`Vec`" msgstr "`Vec`" -#: src/SUMMARY.md src/std-types/hashmap.md:1 src/bare-metal/no_std.md +#: src/SUMMARY.md src/std-types/hashmap.md src/bare-metal/no_std.md msgid "`HashMap`" msgstr "`HashMap`" -#: src/SUMMARY.md src/std-types.md src/std-types/exercise.md:1 +#: src/SUMMARY.md src/std-types.md src/std-types/exercise.md msgid "Exercise: Counter" msgstr "تمرین: شمارنده" -#: src/SUMMARY.md src/running-the-course/course-structure.md:45 +#: src/SUMMARY.md src/running-the-course/course-structure.md #: src/welcome-day-2-afternoon.md src/std-traits.md msgid "Standard Library Traits" msgstr "کتابخانه استاندارد Traits" -#: src/SUMMARY.md src/std-traits.md src/std-traits/comparisons.md:1 +#: 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.md src/std-traits/operators.md:1 +#: src/SUMMARY.md src/std-traits.md src/std-traits/operators.md msgid "Operators" msgstr "اپراتورها" -#: src/SUMMARY.md src/std-traits/from-and-into.md:1 +#: src/SUMMARY.md src/std-traits/from-and-into.md msgid "`From` and `Into`" msgstr "`From` and `Into`" -#: src/SUMMARY.md src/std-traits.md src/std-traits/casting.md:1 +#: src/SUMMARY.md src/std-traits.md src/std-traits/casting.md msgid "Casting" msgstr "Casting" -#: src/SUMMARY.md src/std-traits/read-and-write.md:1 +#: src/SUMMARY.md src/std-traits/read-and-write.md msgid "`Read` and `Write`" msgstr "`Read` and `Write`" @@ -432,11 +426,11 @@ msgstr "`Read` and `Write`" msgid "`Default`, struct update syntax" msgstr "`Default`, struct update syntax" -#: src/SUMMARY.md src/std-traits.md src/std-traits/closures.md:1 +#: src/SUMMARY.md src/std-traits.md src/std-traits/closures.md msgid "Closures" msgstr "Closures" -#: src/SUMMARY.md src/std-traits.md src/std-traits/exercise.md:1 +#: src/SUMMARY.md src/std-traits.md src/std-traits/exercise.md msgid "Exercise: ROT13" msgstr "تمرین: ROT13" @@ -444,25 +438,24 @@ msgstr "تمرین: ROT13" msgid "Day 3: Morning" msgstr "روز ۳: صبح" -#: src/SUMMARY.md src/running-the-course/course-structure.md:53 +#: 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.md src/memory-management/review.md:1 +#: src/SUMMARY.md src/memory-management.md src/memory-management/review.md msgid "Review of Program Memory" msgstr "بررسی حافظه برنامه" -#: src/SUMMARY.md src/memory-management.md -#: src/memory-management/approaches.md:1 +#: src/SUMMARY.md src/memory-management.md src/memory-management/approaches.md msgid "Approaches to Memory Management" msgstr "رویکردهای مدیریت حافظه" -#: src/SUMMARY.md src/memory-management.md src/memory-management/ownership.md:1 +#: src/SUMMARY.md src/memory-management.md src/memory-management/ownership.md msgid "Ownership" msgstr "مالکیت" -#: src/SUMMARY.md src/memory-management.md src/memory-management/move.md:1 +#: src/SUMMARY.md src/memory-management.md src/memory-management/move.md msgid "Move Semantics" msgstr "مفاهیم جابه‌جایی" @@ -470,8 +463,7 @@ msgstr "مفاهیم جابه‌جایی" msgid "`Clone`" msgstr "`Clone`" -#: src/SUMMARY.md src/memory-management.md -#: src/memory-management/copy-types.md:1 +#: src/SUMMARY.md src/memory-management.md src/memory-management/copy-types.md msgid "Copy Types" msgstr "کپی کردن تایپ‌ها" @@ -479,29 +471,29 @@ msgstr "کپی کردن تایپ‌ها" msgid "`Drop`" msgstr "`Drop`" -#: src/SUMMARY.md src/memory-management.md src/memory-management/exercise.md:1 +#: src/SUMMARY.md src/memory-management.md src/memory-management/exercise.md msgid "Exercise: Builder Type" msgstr "تمرین: تایپ‌های سازنده" -#: src/SUMMARY.md src/running-the-course/course-structure.md:54 +#: src/SUMMARY.md src/running-the-course/course-structure.md #: src/welcome-day-3.md src/smart-pointers.md msgid "Smart Pointers" msgstr "اشاره‌گرهای هوشمند" -#: src/SUMMARY.md src/smart-pointers/box.md:1 -#: src/android/interoperability/cpp/type-mapping.md:9 +#: src/SUMMARY.md src/smart-pointers/box.md +#: src/android/interoperability/cpp/type-mapping.md msgid "`Box`" msgstr "`C++" -#: src/SUMMARY.md src/android/interoperability/cpp/bridge.md:1 +#: src/SUMMARY.md src/android/interoperability/cpp/bridge.md msgid "The Bridge Module" msgstr "" @@ -819,7 +810,7 @@ msgstr "" msgid "Rust Bridge" msgstr "" -#: src/SUMMARY.md src/android/interoperability/cpp/generated-cpp.md:1 +#: src/SUMMARY.md src/android/interoperability/cpp/generated-cpp.md msgid "Generated C++" msgstr "" @@ -827,23 +818,23 @@ msgstr "" msgid "C++ Bridge" msgstr "" -#: src/SUMMARY.md src/android/interoperability/cpp/shared-types.md:1 +#: src/SUMMARY.md src/android/interoperability/cpp/shared-types.md msgid "Shared Types" msgstr "" -#: src/SUMMARY.md src/android/interoperability/cpp/shared-enums.md:1 +#: src/SUMMARY.md src/android/interoperability/cpp/shared-enums.md msgid "Shared Enums" msgstr "" -#: src/SUMMARY.md src/android/interoperability/cpp/rust-result.md:1 +#: src/SUMMARY.md src/android/interoperability/cpp/rust-result.md msgid "Rust Error Handling" msgstr "مدیریت خطا Rust" -#: src/SUMMARY.md src/android/interoperability/cpp/cpp-exception.md:1 +#: src/SUMMARY.md src/android/interoperability/cpp/cpp-exception.md msgid "C++ Error Handling" msgstr "مدیریت خطا C++" -#: src/SUMMARY.md src/android/interoperability/cpp/type-mapping.md:1 +#: src/SUMMARY.md src/android/interoperability/cpp/type-mapping.md msgid "Additional Types" msgstr "" @@ -863,8 +854,7 @@ msgstr "" msgid "With Java" msgstr "با جاوا" -#: src/SUMMARY.md src/running-the-course/course-structure.md:155 -#: src/running-the-course/course-structure.md:165 +#: 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 @@ -889,27 +879,27 @@ msgstr "" msgid "Unsafe Code" msgstr "Rust ناایمن" -#: src/SUMMARY.md src/chromium/build-rules/depending.md:1 +#: src/SUMMARY.md src/chromium/build-rules/depending.md msgid "Depending on Rust Code from Chromium C++" msgstr "" -#: src/SUMMARY.md src/chromium/build-rules/vscode.md:1 +#: src/SUMMARY.md src/chromium/build-rules/vscode.md msgid "Visual Studio Code" msgstr "" -#: src/SUMMARY.md src/exercises/chromium/third-party.md:1 +#: src/SUMMARY.md src/exercises/chromium/third-party.md msgid "Exercise" msgstr "تمرین‌ها" -#: src/SUMMARY.md src/chromium/testing/rust-gtest-interop.md:1 +#: src/SUMMARY.md src/chromium/testing/rust-gtest-interop.md msgid "`rust_gtest_interop` Library" msgstr "" -#: src/SUMMARY.md src/chromium/testing/build-gn.md:1 +#: src/SUMMARY.md src/chromium/testing/build-gn.md msgid "GN Rules for Rust Tests" msgstr "" -#: src/SUMMARY.md src/chromium/testing/chromium-import-macro.md:1 +#: src/SUMMARY.md src/chromium/testing/chromium-import-macro.md msgid "`chromium::import!` Macro" msgstr "" @@ -918,17 +908,16 @@ msgstr "" msgid "Interoperability with C++" msgstr "قابلیت همکاری" -#: src/SUMMARY.md src/chromium/interoperability-with-cpp/example-bindings.md:1 +#: src/SUMMARY.md src/chromium/interoperability-with-cpp/example-bindings.md #, fuzzy msgid "Example Bindings" msgstr "مثال‌ها" -#: src/SUMMARY.md -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md:1 +#: src/SUMMARY.md src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "Limitations of CXX" msgstr "" -#: src/SUMMARY.md src/chromium/interoperability-with-cpp/error-handling.md:1 +#: src/SUMMARY.md src/chromium/interoperability-with-cpp/error-handling.md msgid "CXX Error Handling" msgstr "مدیریت خطا CXX" @@ -953,37 +942,35 @@ msgid "Configuring Cargo.toml" msgstr "" #: src/SUMMARY.md -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md:1 +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md msgid "Configuring `gnrt_config.toml`" msgstr "" -#: src/SUMMARY.md -#: src/chromium/adding-third-party-crates/downloading-crates.md:1 +#: src/SUMMARY.md src/chromium/adding-third-party-crates/downloading-crates.md msgid "Downloading Crates" msgstr "" #: src/SUMMARY.md -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md:1 +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "Generating `gn` Build Rules" msgstr "" -#: src/SUMMARY.md -#: src/chromium/adding-third-party-crates/resolving-problems.md:1 +#: src/SUMMARY.md src/chromium/adding-third-party-crates/resolving-problems.md msgid "Resolving Problems" msgstr "" #: src/SUMMARY.md -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md:1 +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md msgid "Build Scripts Which Generate Code" msgstr "" #: src/SUMMARY.md -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md:1 +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md msgid "Build Scripts Which Build C++ or Take Arbitrary Actions" msgstr "" #: src/SUMMARY.md -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md:1 +#: src/chromium/adding-third-party-crates/depending-on-a-crate.md msgid "Depending on a Crate" msgstr "" @@ -995,8 +982,7 @@ msgstr "" msgid "Checking into Chromium Source Code" msgstr "" -#: src/SUMMARY.md -#: src/chromium/adding-third-party-crates/keeping-up-to-date.md:1 +#: src/SUMMARY.md src/chromium/adding-third-party-crates/keeping-up-to-date.md msgid "Keeping Crates Up to Date" msgstr "" @@ -1021,7 +1007,7 @@ msgstr "" msgid "A Minimal Example" msgstr "یک مثال ساده" -#: src/SUMMARY.md src/bare-metal/no_std.md src/bare-metal/alloc.md:1 +#: src/SUMMARY.md src/bare-metal/no_std.md src/bare-metal/alloc.md msgid "`alloc`" msgstr "" @@ -1029,7 +1015,7 @@ msgstr "" msgid "Microcontrollers" msgstr "میکروکنترلرها" -#: src/SUMMARY.md src/bare-metal/microcontrollers/mmio.md:1 +#: src/SUMMARY.md src/bare-metal/microcontrollers/mmio.md msgid "Raw MMIO" msgstr "Raw MMIO" @@ -1049,16 +1035,16 @@ msgstr "Board Support Crates" msgid "The Type State Pattern" msgstr "انواع State Pattern" -#: src/SUMMARY.md src/bare-metal/microcontrollers/embedded-hal.md:1 +#: src/SUMMARY.md src/bare-metal/microcontrollers/embedded-hal.md msgid "`embedded-hal`" msgstr "" -#: src/SUMMARY.md src/bare-metal/microcontrollers/probe-rs.md:1 +#: src/SUMMARY.md src/bare-metal/microcontrollers/probe-rs.md #, fuzzy msgid "`probe-rs` and `cargo-embed`" msgstr "probe-rs, cargo-embed" -#: src/SUMMARY.md src/bare-metal/microcontrollers/debugging.md:1 +#: src/SUMMARY.md src/bare-metal/microcontrollers/debugging.md msgid "Debugging" msgstr "اشکال یابی (Debugging)" @@ -1066,15 +1052,15 @@ msgstr "اشکال یابی (Debugging)" msgid "Other Projects" msgstr "باقی پروژه‌ها" -#: src/SUMMARY.md src/exercises/bare-metal/compass.md:1 -#: src/exercises/bare-metal/solutions-morning.md:3 +#: src/SUMMARY.md src/exercises/bare-metal/compass.md +#: src/exercises/bare-metal/solutions-morning.md msgid "Compass" msgstr "قطب‌نما" #: src/SUMMARY.md src/concurrency/sync-exercises.md -#: src/concurrency/sync-exercises/solutions.md:1 +#: src/concurrency/sync-exercises/solutions.md #: src/concurrency/async-exercises.md -#: src/concurrency/async-exercises/solutions.md:1 +#: src/concurrency/async-exercises/solutions.md msgid "Solutions" msgstr "راه حل‌ها" @@ -1086,7 +1072,7 @@ msgstr "با Bare Metal: عصر" msgid "Application Processors" msgstr "پردازنده‌های برنامه" -#: src/SUMMARY.md src/bare-metal/aps/entry-point.md:1 +#: src/SUMMARY.md src/bare-metal/aps/entry-point.md msgid "Getting Ready to Rust" msgstr "آماده شدن برای Rust" @@ -1110,7 +1096,7 @@ msgstr "صفت‌های بیشتر" msgid "A Better UART Driver" msgstr "یک درایور بهتر UART" -#: src/SUMMARY.md src/bare-metal/aps/better-uart/bitflags.md:1 +#: src/SUMMARY.md src/bare-metal/aps/better-uart/bitflags.md msgid "Bitflags" msgstr "پرچم‌های بیتی (Bitflags)" @@ -1118,7 +1104,7 @@ msgstr "پرچم‌های بیتی (Bitflags)" msgid "Multiple Registers" msgstr "رجیستر‌های چندگانه" -#: src/SUMMARY.md src/bare-metal/aps/better-uart/driver.md:1 +#: src/SUMMARY.md src/bare-metal/aps/better-uart/driver.md msgid "Driver" msgstr "درایور" @@ -1126,8 +1112,7 @@ msgstr "درایور" msgid "Using It" msgstr "استفاده از آن" -#: src/SUMMARY.md src/error-handling/result.md:51 -#: src/bare-metal/aps/exceptions.md:1 +#: src/SUMMARY.md src/error-handling/result.md src/bare-metal/aps/exceptions.md msgid "Exceptions" msgstr "استثناها" @@ -1135,23 +1120,23 @@ msgstr "استثناها" msgid "Useful Crates" msgstr "جعبه‌های (Crates) کاربردی" -#: src/SUMMARY.md src/bare-metal/useful-crates/zerocopy.md:1 +#: src/SUMMARY.md src/bare-metal/useful-crates/zerocopy.md msgid "`zerocopy`" msgstr "" -#: src/SUMMARY.md src/bare-metal/useful-crates/aarch64-paging.md:1 +#: src/SUMMARY.md src/bare-metal/useful-crates/aarch64-paging.md msgid "`aarch64-paging`" msgstr "" -#: src/SUMMARY.md src/bare-metal/useful-crates/buddy_system_allocator.md:1 +#: src/SUMMARY.md src/bare-metal/useful-crates/buddy_system_allocator.md msgid "`buddy_system_allocator`" msgstr "" -#: src/SUMMARY.md src/bare-metal/useful-crates/tinyvec.md:1 +#: src/SUMMARY.md src/bare-metal/useful-crates/tinyvec.md msgid "`tinyvec`" msgstr "" -#: src/SUMMARY.md src/bare-metal/useful-crates/spin.md:1 +#: src/SUMMARY.md src/bare-metal/useful-crates/spin.md msgid "`spin`" msgstr "" @@ -1168,39 +1153,38 @@ msgstr "درایور RTC" msgid "Concurrency: Morning" msgstr "همزمانی: صبح" -#: src/SUMMARY.md src/running-the-course/course-structure.md:151 +#: 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/threads.md src/concurrency/threads/plain.md:1 +#: 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:1 +#: src/SUMMARY.md src/concurrency/threads.md src/concurrency/threads/scoped.md msgid "Scoped Threads" msgstr "محدوده تردها" -#: src/SUMMARY.md src/running-the-course/course-structure.md:152 +#: 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.md -#: src/concurrency/channels/senders-receivers.md:1 +#: src/concurrency/channels/senders-receivers.md #, fuzzy msgid "Senders and Receivers" msgstr "متد دریافتی" #: src/SUMMARY.md src/concurrency/channels.md -#: src/concurrency/channels/unbounded.md:1 +#: src/concurrency/channels/unbounded.md msgid "Unbounded Channels" msgstr "کانال‌های نامحدود" #: src/SUMMARY.md src/concurrency/channels.md -#: src/concurrency/channels/bounded.md:1 +#: src/concurrency/channels/bounded.md msgid "Bounded Channels" msgstr "کانال‌های محدود" @@ -1209,52 +1193,52 @@ msgid "`Send` and `Sync`" msgstr "" #: src/SUMMARY.md src/concurrency/send-sync.md -#: src/concurrency/send-sync/marker-traits.md:1 +#: src/concurrency/send-sync/marker-traits.md #, fuzzy msgid "Marker Traits" msgstr "صفت‌های بیشتر" -#: src/SUMMARY.md src/concurrency/send-sync/send.md:1 +#: src/SUMMARY.md src/concurrency/send-sync/send.md msgid "`Send`" msgstr "" -#: src/SUMMARY.md src/concurrency/send-sync/sync.md:1 +#: src/SUMMARY.md src/concurrency/send-sync/sync.md msgid "`Sync`" msgstr "" #: src/SUMMARY.md src/concurrency/send-sync.md -#: src/concurrency/send-sync/examples.md:1 +#: src/concurrency/send-sync/examples.md msgid "Examples" msgstr "مثال‌ها" -#: src/SUMMARY.md src/running-the-course/course-structure.md:154 +#: 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:1 +#: src/SUMMARY.md src/concurrency/shared-state/arc.md msgid "`Arc`" msgstr "" -#: src/SUMMARY.md src/concurrency/shared-state/mutex.md:1 +#: src/SUMMARY.md src/concurrency/shared-state/mutex.md msgid "`Mutex`" msgstr "" -#: src/SUMMARY.md src/memory-management/review.md:16 -#: src/error-handling/try-conversions.md:23 src/concurrency/shared-state.md -#: src/concurrency/shared-state/example.md:1 +#: src/SUMMARY.md src/memory-management/review.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/concurrency/sync-exercises.md -#: src/concurrency/sync-exercises/dining-philosophers.md:1 -#: src/concurrency/sync-exercises/solutions.md:3 +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/sync-exercises/solutions.md #: src/concurrency/async-exercises.md msgid "Dining Philosophers" msgstr "فلسفه Dining" #: src/SUMMARY.md src/concurrency/sync-exercises.md -#: src/concurrency/sync-exercises/link-checker.md:1 +#: src/concurrency/sync-exercises/link-checker.md msgid "Multi-threaded Link Checker" msgstr "جستجوگر پیوند چند تِردی" @@ -1262,55 +1246,55 @@ msgstr "جستجوگر پیوند چند تِردی" msgid "Concurrency: Afternoon" msgstr "همزمانی: عصر" -#: src/SUMMARY.md src/running-the-course/course-structure.md:162 +#: 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/concurrency/async/async-await.md:1 +#: src/SUMMARY.md src/concurrency/async/async-await.md msgid "`async`/`await`" msgstr "" -#: src/SUMMARY.md src/concurrency/async.md src/concurrency/async/futures.md:1 +#: src/SUMMARY.md src/concurrency/async.md src/concurrency/async/futures.md msgid "Futures" msgstr "Futures" -#: src/SUMMARY.md src/concurrency/async.md src/concurrency/async/runtimes.md:1 +#: src/SUMMARY.md src/concurrency/async.md src/concurrency/async/runtimes.md msgid "Runtimes" msgstr "Runtimes" -#: src/SUMMARY.md src/concurrency/async/runtimes/tokio.md:1 +#: src/SUMMARY.md src/concurrency/async/runtimes/tokio.md msgid "Tokio" msgstr "Tokio" -#: src/SUMMARY.md src/concurrency/sync-exercises/link-checker.md:119 -#: src/concurrency/async.md src/concurrency/async/tasks.md:1 -#: src/concurrency/async-exercises/chat-app.md:143 +#: 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 "Task" -#: src/SUMMARY.md src/running-the-course/course-structure.md:163 +#: 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:1 +#: src/concurrency/async-control-flow/channels.md msgid "Async Channels" msgstr "کانال‌های Async" #: src/SUMMARY.md src/concurrency/async-control-flow.md -#: src/concurrency/async-control-flow/join.md:1 +#: src/concurrency/async-control-flow/join.md msgid "Join" msgstr "Join" #: src/SUMMARY.md src/concurrency/async-control-flow.md -#: src/concurrency/async-control-flow/select.md:1 +#: src/concurrency/async-control-flow/select.md msgid "Select" msgstr "Select" -#: src/SUMMARY.md src/running-the-course/course-structure.md:164 +#: src/SUMMARY.md src/running-the-course/course-structure.md #: src/concurrency/welcome-async.md src/concurrency/async-pitfalls.md msgid "Pitfalls" msgstr "Pitfallها" @@ -1319,23 +1303,23 @@ msgstr "Pitfallها" msgid "Blocking the Executor" msgstr "مسدود کردن Executor" -#: src/SUMMARY.md src/concurrency/async-pitfalls/pin.md:1 +#: src/SUMMARY.md src/concurrency/async-pitfalls/pin.md msgid "`Pin`" msgstr "" #: src/SUMMARY.md src/concurrency/async-pitfalls.md -#: src/concurrency/async-pitfalls/async-traits.md:1 +#: src/concurrency/async-pitfalls/async-traits.md msgid "Async Traits" msgstr "صفات Async" #: src/SUMMARY.md src/concurrency/async-pitfalls.md -#: src/concurrency/async-pitfalls/cancellation.md:1 +#: src/concurrency/async-pitfalls/cancellation.md msgid "Cancellation" msgstr "لغو" #: src/SUMMARY.md src/concurrency/async-exercises.md -#: src/concurrency/async-exercises/chat-app.md:1 -#: src/concurrency/async-exercises/solutions.md:102 +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md msgid "Broadcast Chat Application" msgstr "پخش برنامه چت" @@ -1534,7 +1518,7 @@ msgstr "" "اطلاعات بیشتری را ارائه دهیم.. این می تواند نکات کلیدی باشد که مدرس باید " "پوشش دهد و همچنین پاسخ به سوالات رایجی که در کلاس مطرح می شود." -#: src/running-the-course.md src/running-the-course/course-structure.md:3 +#: src/running-the-course.md src/running-the-course/course-structure.md msgid "This page is for the course instructor." msgstr "این صفحه برای مدرس دوره است." @@ -1663,11 +1647,11 @@ msgstr "" "شما دانش‌آموزان نیز بسیار خوش آمدید [برای ما بازخورد ارسال کنید](https://" "github.com/google/comprehensive-rust/discussions/100) !" -#: src/running-the-course/course-structure.md:5 +#: src/running-the-course/course-structure.md msgid "Rust Fundamentals" msgstr "مبانی Rust" -#: src/running-the-course/course-structure.md:7 +#: src/running-the-course/course-structure.md msgid "" "The first four days make up [Rust Fundamentals](../welcome-day-1.md). The " "days are fast paced and we cover a lot of ground!" @@ -1675,25 +1659,15 @@ msgstr "" "سه روز اول دوره را [مبانی Rust ](../welcome-day-1.md)تشکیل میدهند. این این " "سه روز با سرعت بالایی پیش می‌روند و ما موارد زیادی را پوشش می‌دهیم!" -#: src/running-the-course/course-structure.md:10 -#: src/running-the-course/course-structure.md:146 +#: src/running-the-course/course-structure.md msgid "Course schedule:" msgstr "مباحث دوره:" -#: src/running-the-course/course-structure.md:11 +#: src/running-the-course/course-structure.md msgid "Day 1 Morning (2 hours and 5 minutes, including breaks)" msgstr "روز ۱ صبح (۲ ساعت و ۵ دقیقه با احتساب استراحت)" -#: src/running-the-course/course-structure.md:13 -#: src/running-the-course/course-structure.md:23 -#: src/running-the-course/course-structure.md:32 -#: src/running-the-course/course-structure.md:41 -#: src/running-the-course/course-structure.md:50 -#: src/running-the-course/course-structure.md:59 -#: src/running-the-course/course-structure.md:67 -#: src/running-the-course/course-structure.md:77 -#: src/running-the-course/course-structure.md:149 -#: src/running-the-course/course-structure.md:160 src/welcome-day-1.md +#: 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 @@ -1702,16 +1676,7 @@ msgstr "روز ۱ صبح (۲ ساعت و ۵ دقیقه با احتساب است msgid "Segment" msgstr "بخش" -#: src/running-the-course/course-structure.md:13 -#: src/running-the-course/course-structure.md:23 -#: src/running-the-course/course-structure.md:32 -#: src/running-the-course/course-structure.md:41 -#: src/running-the-course/course-structure.md:50 -#: src/running-the-course/course-structure.md:59 -#: src/running-the-course/course-structure.md:67 -#: src/running-the-course/course-structure.md:77 -#: src/running-the-course/course-structure.md:149 -#: src/running-the-course/course-structure.md:160 src/welcome-day-1.md +#: 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 @@ -1730,7 +1695,7 @@ msgstr "بخش" msgid "Duration" msgstr "مدت زمان" -#: src/running-the-course/course-structure.md:15 src/welcome-day-1.md +#: 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 @@ -1740,8 +1705,7 @@ msgstr "مدت زمان" msgid "5 minutes" msgstr "۵ دقیقه" -#: src/running-the-course/course-structure.md:16 -#: src/running-the-course/course-structure.md:153 src/welcome-day-1.md +#: 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 @@ -1749,44 +1713,35 @@ msgstr "۵ دقیقه" msgid "15 minutes" msgstr "۱۵ دقیقه" -#: src/running-the-course/course-structure.md:17 -#: src/running-the-course/course-structure.md:18 -#: src/running-the-course/course-structure.md:71 src/welcome-day-1.md +#: 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:21 +#: src/running-the-course/course-structure.md msgid "Day 1 Afternoon (2 hours and 35 minutes, including breaks)" msgstr "روز ۱ بعد از ظهر (۲ ساعت و ۳۵ دقیقه،شامل وقت استراحت)" -#: src/running-the-course/course-structure.md:25 src/welcome-day-1-afternoon.md +#: src/running-the-course/course-structure.md src/welcome-day-1-afternoon.md msgid "35 minutes" msgstr "۳۵ دقیقه" -#: src/running-the-course/course-structure.md:26 -#: src/running-the-course/course-structure.md:54 -#: src/running-the-course/course-structure.md:61 -#: src/running-the-course/course-structure.md:164 -#: src/welcome-day-1-afternoon.md src/welcome-day-3.md -#: src/welcome-day-3-afternoon.md src/concurrency/welcome-async.md +#: 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:27 -#: src/running-the-course/course-structure.md:36 -#: src/running-the-course/course-structure.md:62 src/welcome-day-1-afternoon.md +#: 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:30 +#: src/running-the-course/course-structure.md msgid "Day 2 Morning (2 hours and 10 minutes, including breaks)" msgstr "روز ۲ صبح (۲ ساعت و ۱۰ دقیقه، شامل وقت استراحت)" -#: src/running-the-course/course-structure.md:34 -#: src/running-the-course/course-structure.md:52 -#: src/running-the-course/course-structure.md:69 src/hello-world.md +#: 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 @@ -1794,59 +1749,51 @@ msgstr "روز ۲ صبح (۲ ساعت و ۱۰ دقیقه، شامل وقت اس msgid "3 minutes" msgstr "۳ دقیقه" -#: src/running-the-course/course-structure.md:35 -#: src/running-the-course/course-structure.md:44 -#: src/running-the-course/course-structure.md:53 -#: src/running-the-course/course-structure.md:79 src/welcome-day-2.md +#: 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:39 +#: src/running-the-course/course-structure.md msgid "Day 2 Afternoon (3 hours and 15 minutes, including breaks)" msgstr "روز ۲ بعد از ظهر (۴ ساعت و ۵ دقیقه، شامل وقت استراحت)" -#: src/running-the-course/course-structure.md:43 -#: src/running-the-course/course-structure.md:70 -#: src/running-the-course/course-structure.md:72 src/welcome-day-2-afternoon.md +#: 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:45 -#: src/running-the-course/course-structure.md:155 -#: src/running-the-course/course-structure.md:165 -#: src/welcome-day-2-afternoon.md src/concurrency/welcome.md -#: src/concurrency/welcome-async.md +#: 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:48 +#: src/running-the-course/course-structure.md msgid "Day 3 Morning (2 hours and 20 minutes, including breaks)" msgstr "روز ۳ صبح (۲ ساعت و ۲۰ دقیقه، شامل وقت استراحت)" -#: src/running-the-course/course-structure.md:57 +#: src/running-the-course/course-structure.md msgid "Day 3 Afternoon (1 hour and 55 minutes, including breaks)" msgstr "روز ۳ بعدازظهر(۱ ساعت و ۵۵ دقیقه، شامل وقت اسراحت)" -#: src/running-the-course/course-structure.md:65 +#: src/running-the-course/course-structure.md msgid "Day 4 Morning (2 hours and 40 minutes, including breaks)" msgstr "روز ۴ صبح (۲ ساعت و ۴۰ دقیقه، شامل وقت استراحت)" -#: src/running-the-course/course-structure.md:75 +#: src/running-the-course/course-structure.md msgid "Day 4 Afternoon (2 hours and 15 minutes, including breaks)" msgstr "روز ۴ بعدازظهر (۲ ساعت و ۱۰ دقیقه، شامل وقت استراحت)" -#: src/running-the-course/course-structure.md:80 src/welcome-day-4-afternoon.md +#: src/running-the-course/course-structure.md src/welcome-day-4-afternoon.md msgid "1 hour and 5 minutes" msgstr "ساعت و ۵ دقیقه" -#: src/running-the-course/course-structure.md:85 +#: src/running-the-course/course-structure.md msgid "Deep Dives" msgstr "عمیق تر شدن" -#: src/running-the-course/course-structure.md:87 +#: src/running-the-course/course-structure.md msgid "" "In addition to the 4-day class on Rust Fundamentals, we cover some more " "specialized topics:" @@ -1854,11 +1801,11 @@ msgstr "" "علاوه بر کلاس 4 روزه Rust Fundamentals، موضوعات تخصصی تری را نیز پوشش می " "دهیم:" -#: src/running-the-course/course-structure.md:90 +#: src/running-the-course/course-structure.md msgid "Rust in Android" msgstr "Rust در اندروید" -#: src/running-the-course/course-structure.md:92 +#: src/running-the-course/course-structure.md msgid "" "The [Rust in Android](../android.md) deep dive is a half-day course on using " "Rust for Android platform development. This includes interoperability with " @@ -1868,7 +1815,7 @@ msgstr "" "استفاده از Rust برای توسعه پلتفرم اندروید عمیق می‌شیم. این شامل قابلیت تعامل " "با C، C++ و جاوا می‌شود." -#: src/running-the-course/course-structure.md:96 +#: src/running-the-course/course-structure.md msgid "" "You will need an [AOSP checkout](https://source.android.com/docs/setup/" "download/downloading). Make a checkout of the [course repository](https://" @@ -1882,7 +1829,7 @@ msgstr "" "android/`مخزن ASOP قرار دهید. با این کار طمینان حاصل می‌کنید که سیستم build " "اندروید فایل های `Android.bp` را در `src/android/` می‌بینید." -#: src/running-the-course/course-structure.md:101 +#: src/running-the-course/course-structure.md msgid "" "Ensure that `adb sync` works with your emulator or real device and pre-build " "all Android examples using `src/android/build_all.sh`. Read the script to " @@ -1893,11 +1840,11 @@ msgstr "" "بسازید. اسکریپت را بخوانید تا دستوراتی را که اجرا می‌کند ببینید و مطمئن شوید " "که وقتی آنها را اجرا می‌کنید به درستی کار می‌کنند." -#: src/running-the-course/course-structure.md:108 +#: src/running-the-course/course-structure.md msgid "Rust in Chromium" msgstr "Rust در اندروید" -#: src/running-the-course/course-structure.md:110 +#: src/running-the-course/course-structure.md msgid "" "The [Rust in Chromium](../chromium.md) deep dive is a half-day course on " "using Rust as part of the Chromium browser. It includes using Rust in " @@ -1909,7 +1856,7 @@ msgstr "" "ساخت `gn‍` Chromium، آوردن کتابخانه‌های شخص ثالث (\"crates\") و قابلیت همکاری +" "+C است." -#: src/running-the-course/course-structure.md:115 +#: src/running-the-course/course-structure.md msgid "" "You will need to be able to build Chromium --- a debug, component build is " "[recommended](../chromium/setup.md) for speed but any build will work. " @@ -1919,11 +1866,11 @@ msgstr "" "سرعت [توصیه می شود] (../chromium/setup.md) است، اما هر ساختی کار می کند. " "مطمئن شوید که می‌توانید مرورگر Chromium را که ساخته‌اید اجرا کنید." -#: src/running-the-course/course-structure.md:119 +#: src/running-the-course/course-structure.md msgid "Bare-Metal Rust" msgstr "Rust بر روی سخت افزار بدون سیستم عامل" -#: src/running-the-course/course-structure.md:121 +#: src/running-the-course/course-structure.md msgid "" "The [Bare-Metal Rust](../bare-metal.md) deep dive is a full day class on " "using Rust for bare-metal (embedded) development. Both microcontrollers and " @@ -1934,7 +1881,7 @@ msgstr "" "سیستم عامل (embedded) است. این دوره هم میکروکنترلرها و هم پردازشگر هایی با " "کارایی خاص را پوشش می دهد." -#: src/running-the-course/course-structure.md:125 +#: src/running-the-course/course-structure.md msgid "" "For the microcontroller part, you will need to buy the [BBC micro:bit]" "(https://microbit.org/) v2 development board ahead of time. Everybody will " @@ -1945,11 +1892,11 @@ msgstr "" "v2 را خریداری کنید. همه باید تعدادی بسته را همانطور که در [welcome page]" "(../bare-metal.md) توضیح داده شده نصب کنند." -#: src/running-the-course/course-structure.md:130 +#: src/running-the-course/course-structure.md msgid "Concurrency in Rust" msgstr "همزمانی در Rust" -#: src/running-the-course/course-structure.md:132 +#: src/running-the-course/course-structure.md #, fuzzy msgid "" "The [Concurrency in Rust](../concurrency/welcome.md) deep dive is a full day " @@ -1958,7 +1905,7 @@ msgstr "" "دوره [همزمانی در Rust ](../concurrency.md) یک روزه با تمرکز بر همزمانی که " "شامل همزمانی کلاسیک و `async`/`await` است." -#: src/running-the-course/course-structure.md:135 +#: src/running-the-course/course-structure.md msgid "" "You will need a fresh crate set up and the dependencies downloaded and ready " "to go. You can then copy/paste the examples into `src/main.rs` to experiment " @@ -1968,13 +1915,11 @@ msgstr "" "باشند. سپس می‌توانید نمونه‌ها را در `src/main.rs‍` کپی/پیست کنید تا با آنها " "آزمایش کنید:" -#: src/running-the-course/course-structure.md:147 +#: src/running-the-course/course-structure.md msgid "Morning (3 hours and 20 minutes, including breaks)" msgstr "صبح (۳ ساعت و ۲۰ دقیقه، شامل وقت اسراحت)" -#: src/running-the-course/course-structure.md:151 -#: src/running-the-course/course-structure.md:154 -#: src/running-the-course/course-structure.md:162 src/pattern-matching.md +#: 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 @@ -1982,8 +1927,7 @@ msgstr "صبح (۳ ساعت و ۲۰ دقیقه، شامل وقت اسراحت)" msgid "30 minutes" msgstr "۳۰ دقیقه" -#: src/running-the-course/course-structure.md:152 -#: src/running-the-course/course-structure.md:163 src/methods-and-traits.md +#: 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 @@ -1991,19 +1935,19 @@ msgstr "۳۰ دقیقه" msgid "20 minutes" msgstr "۲۰ دقیقه" -#: src/running-the-course/course-structure.md:153 src/concurrency/welcome.md +#: src/running-the-course/course-structure.md src/concurrency/welcome.md msgid "Send and Sync" msgstr "ارسال و همگام‌سازی" -#: src/running-the-course/course-structure.md:158 +#: src/running-the-course/course-structure.md msgid "Afternoon (3 hours and 20 minutes, including breaks)" msgstr "بعدازظهر (۳ ساعت و ۲۰ دقیقه، شامل وقت استراحت)" -#: src/running-the-course/course-structure.md:170 +#: src/running-the-course/course-structure.md msgid "Format" msgstr "فرمت" -#: src/running-the-course/course-structure.md:172 +#: src/running-the-course/course-structure.md msgid "" "The course is meant to be very interactive and we recommend letting the " "questions drive the exploration of Rust!" @@ -2011,31 +1955,31 @@ msgstr "" "این دوره قرار است بسیار تعاملی باشد و توصیه می کنیم اجازه دهید حس کنجکاوی " "Rust را هدایت کنند!" -#: src/running-the-course/keyboard-shortcuts.md:3 +#: src/running-the-course/keyboard-shortcuts.md msgid "There are several useful keyboard shortcuts in mdBook:" msgstr "چندین میانبر صفحه کلید مفید در mdBook وجود دارد:" -#: src/running-the-course/keyboard-shortcuts.md:5 +#: src/running-the-course/keyboard-shortcuts.md #, fuzzy msgid "Arrow-Left: Navigate to the previous page." msgstr "Arrow-Left: به صفحه قبلی هدایت می کند." -#: src/running-the-course/keyboard-shortcuts.md:6 +#: src/running-the-course/keyboard-shortcuts.md #, fuzzy msgid "Arrow-Right: Navigate to the next page." msgstr "Arrow-Right: به صفحه بعدی هدایت می کند." -#: src/running-the-course/keyboard-shortcuts.md:7 +#: src/running-the-course/keyboard-shortcuts.md #, fuzzy msgid "Ctrl + Enter: Execute the code sample that has focus." msgstr "Ctrl + Enter: اجرای نمونه کدی که بر روی آن تمرکز شده است." -#: src/running-the-course/keyboard-shortcuts.md:8 +#: src/running-the-course/keyboard-shortcuts.md #, fuzzy msgid "s: Activate the search bar." msgstr "s: نوار جستجو را فعال می کند." -#: src/running-the-course/translations.md:3 +#: src/running-the-course/translations.md msgid "" "The course has been translated into other languages by a set of wonderful " "volunteers:" @@ -2043,7 +1987,7 @@ msgstr "" "این دوره توسط مجموعه ای از داوطلبان فوق العاده به زبان های دیگر ترجمه شده " "است:" -#: src/running-the-course/translations.md:6 +#: src/running-the-course/translations.md msgid "" "[Brazilian Portuguese](https://google.github.io/comprehensive-rust/pt-BR/) " "by [@rastringer](https://github.com/rastringer), [@hugojacob](https://github." @@ -2055,7 +1999,7 @@ msgstr "" "com/hugojacob), [@joaovicmendes](https://github.com/joaovicmendes) و " "[@henrif75](https://github.com/henrif75)." -#: src/running-the-course/translations.md:8 +#: src/running-the-course/translations.md #, fuzzy msgid "" "[Chinese (Simplified)](https://google.github.io/comprehensive-rust/zh-CN/) " @@ -2071,7 +2015,7 @@ msgstr "" "superwhd), [@SketchK](https://github.com/SketchK) و [@nodmp](https://github." "com/nodmp)." -#: src/running-the-course/translations.md:10 +#: src/running-the-course/translations.md msgid "" "[Chinese (Traditional)](https://google.github.io/comprehensive-rust/zh-TW/) " "by [@hueich](https://github.com/hueich), [@victorhsieh](https://github.com/" @@ -2085,7 +2029,7 @@ msgstr "" "github.com/kuanhungchen) و [@johnathan79717](https://github.com/" "johnathan79717)." -#: src/running-the-course/translations.md:12 +#: src/running-the-course/translations.md #, fuzzy msgid "" "[Japanese](https://google.github.io/comprehensive-rust/ja/) by [@CoinEZ-JPN]" @@ -2097,7 +2041,7 @@ msgstr "" "(https://github.com/CoinEZ) و [@momotaro1105](https://github.com/" "momotaro1105)." -#: src/running-the-course/translations.md:14 +#: src/running-the-course/translations.md msgid "" "[Korean](https://google.github.io/comprehensive-rust/ko/) by [@keispace]" "(https://github.com/keispace), [@jiyongp](https://github.com/jiyongp), " @@ -2108,7 +2052,7 @@ msgstr "" "(https://github.com/keispace), [@jiyongp](https://github.com/jiyongp) و " "[@jooyunghan](https://github.com/jooyunghan)." -#: src/running-the-course/translations.md:15 +#: src/running-the-course/translations.md msgid "" "[Spanish](https://google.github.io/comprehensive-rust/es/) by [@deavid]" "(https://github.com/deavid)." @@ -2116,7 +2060,7 @@ msgstr "" "[اسپانیایی](https://google.github.io/comprehensive-rust/es/) توسط [@deavid]" "(https://github.com/deavid)." -#: src/running-the-course/translations.md:16 +#: src/running-the-course/translations.md #, fuzzy msgid "" "[Ukrainian](https://google.github.io/comprehensive-rust/uk/) by [@git-user-" @@ -2126,17 +2070,17 @@ msgstr "" "[فرانسویی](https://google.github.io/comprehensive-rust/fr/) توسط [@KookaS]" "(https://github.com/KookaS) و [@vcaen](https://github.com/vcaen)." -#: src/running-the-course/translations.md:18 +#: src/running-the-course/translations.md msgid "" "Use the language picker in the top-right corner to switch between languages." msgstr "" "از انتخابگر زبان در گوشه بالا سمت راست برای جابه‌جایی بین زبان‌ها استفاده کنید." -#: src/running-the-course/translations.md:20 +#: src/running-the-course/translations.md msgid "Incomplete Translations" msgstr "ترجمه‌های ناقص" -#: src/running-the-course/translations.md:22 +#: src/running-the-course/translations.md msgid "" "There is a large number of in-progress translations. We link to the most " "recently updated translations:" @@ -2144,7 +2088,7 @@ msgstr "" "تعداد زیادی ترجمه در حال انجام وجود دارد. ما به آخرین ترجمه های به روز شده " "پیوند می دهیم:" -#: src/running-the-course/translations.md:25 +#: src/running-the-course/translations.md #, fuzzy msgid "" "[Arabic](https://google.github.io/comprehensive-rust/ar/) by [@younies]" @@ -2153,7 +2097,7 @@ msgstr "" "[اسپانیایی](https://google.github.io/comprehensive-rust/es/) توسط [@deavid]" "(https://github.com/deavid)." -#: src/running-the-course/translations.md:26 +#: src/running-the-course/translations.md msgid "" "[Bengali](https://google.github.io/comprehensive-rust/bn/) by [@raselmandol]" "(https://github.com/raselmandol)." @@ -2161,7 +2105,22 @@ msgstr "" "[بنگالی](https://google.github.io/comprehensive-rust/bn/) توسط [@raselmandol]" "(https://github.com/raselmandol)." -#: src/running-the-course/translations.md:27 +#: 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 msgid "" "[French](https://google.github.io/comprehensive-rust/fr/) by [@KookaS]" "(https://github.com/KookaS), [@vcaen](https://github.com/vcaen) and " @@ -2170,7 +2129,7 @@ msgstr "" "[فرانسویی](https://google.github.io/comprehensive-rust/fr/) توسط [@KookaS]" "(https://github.com/KookaS) و [@vcaen](https://github.com/vcaen)." -#: src/running-the-course/translations.md:28 +#: src/running-the-course/translations.md msgid "" "[German](https://google.github.io/comprehensive-rust/de/) by [@Throvn]" "(https://github.com/Throvn) and [@ronaldfw](https://github.com/ronaldfw)." @@ -2178,7 +2137,7 @@ msgstr "" "[آلمانی](https://google.github.io/comprehensive-rust/de/) توسط [@Throvn]" "(https://github.com/Throvn) و [@ronaldfw](https://github.com/ronaldfw)." -#: src/running-the-course/translations.md:29 +#: src/running-the-course/translations.md msgid "" "[Italian](https://google.github.io/comprehensive-rust/it/) by " "[@henrythebuilder](https://github.com/henrythebuilder) and [@detro](https://" @@ -2187,7 +2146,7 @@ msgstr "" "[ایتالیایی](https://google.github.io/comprehensive-rust/de/) توسط [@Throvn]" "(https://github.com/Throvn) و [@ronaldfw](https://github.com/ronaldfw)." -#: src/running-the-course/translations.md:31 +#: 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/" @@ -2195,7 +2154,7 @@ msgid "" "(https://google.github.io/comprehensive-rust/synced-translation-report.html)." msgstr "" -#: src/running-the-course/translations.md:35 +#: src/running-the-course/translations.md msgid "" "If you want to help with this effort, please see [our instructions](https://" "github.com/google/comprehensive-rust/blob/main/TRANSLATIONS.md) for how to " @@ -2276,17 +2235,17 @@ msgid "" "Rust from the official site." msgstr "" -#: src/cargo/rust-ecosystem.md:1 +#: src/cargo/rust-ecosystem.md msgid "The Rust Ecosystem" msgstr "اکوسیستم Rust" -#: src/cargo/rust-ecosystem.md:3 +#: src/cargo/rust-ecosystem.md msgid "" "The Rust ecosystem consists of a number of tools, of which the main ones are:" msgstr "" "اکوسیستم Rust از تعدادی ابزار تشکیل شده است که مهمترین آنها عبارتند از:" -#: src/cargo/rust-ecosystem.md:5 +#: src/cargo/rust-ecosystem.md msgid "" "`rustc`: the Rust compiler which turns `.rs` files into binaries and other " "intermediate formats." @@ -2294,7 +2253,7 @@ msgstr "" "`rustc`: کامپایلر Rust که فایل‌های `.rs` را به باینری و سایر فرمت‌های میانی " "تبدیل می‌کند." -#: src/cargo/rust-ecosystem.md:8 +#: src/cargo/rust-ecosystem.md msgid "" "`cargo`: the Rust dependency manager and build tool. Cargo knows how to " "download dependencies, usually hosted on , and it will " @@ -2306,7 +2265,7 @@ msgstr "" "هنگام ساخت پروژه آنها را به `rustc` منتقل می‌کند. Cargo همچنین دارای یک " "دستگاه تست داخلی است که برای اجرای unit test استفاده می شود." -#: src/cargo/rust-ecosystem.md:13 +#: src/cargo/rust-ecosystem.md msgid "" "`rustup`: the Rust toolchain installer and updater. This tool is used to " "install and update `rustc` and `cargo` when new versions of Rust are " @@ -2320,14 +2279,14 @@ msgstr "" "استاندارد دانلود کند. شما می توانید چندین نسخه از Rust را در یک زمان نصب " "کنید و \"rustup\" به شما اجازه می دهد تا در صورت نیاز بین انها تغییر دهید." -#: src/cargo/rust-ecosystem.md:21 src/types-and-values/hello-world.md:26 -#: src/references/exclusive.md:20 src/memory-management/move.md:153 -#: src/error-handling/try.md:53 src/android/setup.md -#: src/concurrency/async/async-await.md:26 +#: 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 "نکات کلیدی:" -#: src/cargo/rust-ecosystem.md:23 +#: src/cargo/rust-ecosystem.md msgid "" "Rust has a rapid release schedule with a new release coming out every six " "weeks. New releases maintain backwards compatibility with old releases --- " @@ -2337,12 +2296,12 @@ msgstr "" "منتشر می شود. نسخه‌های جدید سازگاری با نسخه‌های قدیمی را حفظ می‌کنند --- به " "علاوه قابلیت‌های جدید را فعال می‌کنند." -#: src/cargo/rust-ecosystem.md:27 +#: src/cargo/rust-ecosystem.md msgid "" "There are three release channels: \"stable\", \"beta\", and \"nightly\"." msgstr "سه کانال انتشار وجود دارد: \"stable\"، \"beta\"، و \"nightly\"." -#: src/cargo/rust-ecosystem.md:29 +#: src/cargo/rust-ecosystem.md msgid "" "New features are being tested on \"nightly\", \"beta\" is what becomes " "\"stable\" every six weeks." @@ -2350,7 +2309,7 @@ msgstr "" "ویژگی های جدید در \"nightly\" آزمایش می شوند ، \"beta\" چیزی است که هر شش " "هفته \"stable\" می شود." -#: src/cargo/rust-ecosystem.md:32 +#: src/cargo/rust-ecosystem.md msgid "" "Dependencies can also be resolved from alternative [registries](https://doc." "rust-lang.org/cargo/reference/registries.html), git, folders, and more." @@ -2358,7 +2317,7 @@ msgstr "" "همچنین می‌توان وابستگی‌ها را از [registries](https://doc.rust-lang.org/cargo/" "reference/registries.html)، پوشه‌ها و git و موارد دیگر برطرف کرد." -#: src/cargo/rust-ecosystem.md:35 +#: src/cargo/rust-ecosystem.md msgid "" "Rust also has [editions](https://doc.rust-lang.org/edition-guide/): the " "current edition is Rust 2021. Previous editions were Rust 2015 and Rust 2018." @@ -2366,13 +2325,13 @@ msgstr "" "Rust همچنین نسخه [editions](https://doc.rust-lang.org/edition-guide/) دارد: " "نسخه فعلی Rust 2021 است. نسخه های قبلی Rust 2015 و Rust 2018 بودند." -#: src/cargo/rust-ecosystem.md:38 +#: src/cargo/rust-ecosystem.md msgid "" "The editions are allowed to make backwards incompatible changes to the " "language." msgstr "نسخه ها مجاز به ایجاد تغییرات backwards incompatible در زبان هستند." -#: src/cargo/rust-ecosystem.md:41 +#: src/cargo/rust-ecosystem.md msgid "" "To prevent breaking code, editions are opt-in: you select the edition for " "your crate via the `Cargo.toml` file." @@ -2380,7 +2339,7 @@ msgstr "" "برای جلوگیری از breaking code، نسخه‌ها اختیاری انتخاب می‌شوند که: شما نسخه‌ " "مورد نظر برای crate خود از طریق فایل `Cargo.toml` انتخاب می‌کنید." -#: src/cargo/rust-ecosystem.md:44 +#: src/cargo/rust-ecosystem.md msgid "" "To avoid splitting the ecosystem, Rust compilers can mix code written for " "different editions." @@ -2388,7 +2347,7 @@ msgstr "" "برای جلوگیری از شکاف در اکوسیستم، کامپایلرهای Rust می توانند کدهای نوشته شده " "برای نسخه های مختلف را ترکیب کنند." -#: src/cargo/rust-ecosystem.md:47 +#: src/cargo/rust-ecosystem.md msgid "" "Mention that it is quite rare to ever use the compiler directly not through " "`cargo` (most users never do)." @@ -2396,7 +2355,7 @@ msgstr "" "لازم به ذکر است که استفاده از کامپایلر به طور مستقیم(rustc) و نه از طریق " "`cargo` بسیار غیرمعمول است (اکثر کاربران هرگز این کار را نمی کنند)." -#: src/cargo/rust-ecosystem.md:50 +#: src/cargo/rust-ecosystem.md msgid "" "It might be worth alluding that Cargo itself is an extremely powerful and " "comprehensive tool. It is capable of many advanced features including but " @@ -2405,20 +2364,20 @@ msgstr "" "ممکن است لازم به ذکر باشد که Cargo خود یک ابزار بسیار قدرتمند و جامع است. " "این است که قادر به بسیاری از ویژگی های پیشرفته از جمله اما نه محدود به:" -#: src/cargo/rust-ecosystem.md:53 +#: src/cargo/rust-ecosystem.md msgid "Project/package structure" msgstr "ساختار پروژه/بسته" -#: src/cargo/rust-ecosystem.md:54 +#: src/cargo/rust-ecosystem.md msgid "[workspaces](https://doc.rust-lang.org/cargo/reference/workspaces.html)" msgstr "" "[workspaces](https://doc.rust-lang.org/cargo/reference/workspaces.html)" -#: src/cargo/rust-ecosystem.md:55 +#: src/cargo/rust-ecosystem.md msgid "Dev Dependencies and Runtime Dependency management/caching" msgstr "وابستگی های Dev و وابستگی‌های Runtime Management/Caching" -#: src/cargo/rust-ecosystem.md:56 +#: src/cargo/rust-ecosystem.md msgid "" "[build scripting](https://doc.rust-lang.org/cargo/reference/build-scripts." "html)" @@ -2426,7 +2385,7 @@ msgstr "" "[build scripting](https://doc.rust-lang.org/cargo/reference/build-scripts." "html)" -#: src/cargo/rust-ecosystem.md:57 +#: src/cargo/rust-ecosystem.md msgid "" "[global installation](https://doc.rust-lang.org/cargo/commands/cargo-install." "html)" @@ -2434,7 +2393,7 @@ msgstr "" "[global installation](https://doc.rust-lang.org/cargo/commands/cargo-install." "html)" -#: src/cargo/rust-ecosystem.md:58 +#: src/cargo/rust-ecosystem.md msgid "" "It is also extensible with sub command plugins as well (such as [cargo " "clippy](https://github.com/rust-lang/rust-clippy))." @@ -2442,17 +2401,17 @@ msgstr "" "همچنین با command plugin فرعی (مانند [cargo clippy](https://github.com/rust-" "lang/rust-clippy)) قابل توسعه است." -#: src/cargo/rust-ecosystem.md:60 +#: src/cargo/rust-ecosystem.md msgid "" "Read more from the [official Cargo Book](https://doc.rust-lang.org/cargo/)" msgstr "" "در [official Cargo Book](https://doc.rust-lang.org/cargo/) بیشتر بخوانید." -#: src/cargo/code-samples.md:1 +#: src/cargo/code-samples.md msgid "Code Samples in This Training" msgstr "نمونه کد در این آموزش" -#: src/cargo/code-samples.md:3 +#: src/cargo/code-samples.md msgid "" "For this training, we will mostly explore the Rust language through examples " "which can be executed through your browser. This makes the setup much easier " @@ -2462,7 +2421,7 @@ msgstr "" "مرورگر شما اجرا کرد، بررسی می کنیم. این کار راه اندازی را بسیار ساده تر می " "کند و تجربه ای ثابت را برای همه تضمین می کند." -#: src/cargo/code-samples.md:7 +#: src/cargo/code-samples.md msgid "" "Installing Cargo is still encouraged: it will make it easier for you to do " "the exercises. On the last day, we will do a larger exercise which shows you " @@ -2472,22 +2431,22 @@ msgstr "" "کند. در روز آخر، تمرین بزرگتری را انجام خواهیم داد که به شما نشان می دهد " "چگونه با وابستگی ها کار کنید و برای این کار شما به Cargo نیاز دارید." -#: src/cargo/code-samples.md:11 +#: src/cargo/code-samples.md msgid "The code blocks in this course are fully interactive:" msgstr "بلوک های کد در این دوره کاملاً تعاملی(interactive) هستند:" -#: src/cargo/code-samples.md:15 src/cargo/running-locally.md:46 +#: src/cargo/code-samples.md src/cargo/running-locally.md msgid "\"Edit me!\"" msgstr "" -#: src/cargo/code-samples.md:19 +#: src/cargo/code-samples.md #, fuzzy msgid "" "You can use Ctrl + Enter to execute the code when focus is in the " "text box." msgstr "برای اجرای کد زمانی که focus در text box است." -#: src/cargo/code-samples.md:24 +#: src/cargo/code-samples.md msgid "" "Most code samples are editable like shown above. A few code samples are not " "editable for various reasons:" @@ -2495,7 +2454,7 @@ msgstr "" "اکثر نمونه های کد مانند نشان داده شده در بالا قابل ویرایش هستند. چند نمونه " "کد به دلایل مختلف قابل ویرایش نیستند:" -#: src/cargo/code-samples.md:27 +#: src/cargo/code-samples.md msgid "" "The embedded playgrounds cannot execute unit tests. Copy-paste the code and " "open it in the real Playground to demonstrate unit tests." @@ -2503,7 +2462,7 @@ msgstr "" "همینطورembedded playground نمی توانند unit tests را اجرا کنند. کد را کپی " "کنید و آن را در Playground واقعی باز کنید تا unit tests د را نشان دهید." -#: src/cargo/code-samples.md:30 +#: src/cargo/code-samples.md msgid "" "The embedded playgrounds lose their state the moment you navigate away from " "the page! This is the reason that the students should solve the exercises " @@ -2513,11 +2472,11 @@ msgstr "" "خود را از دست می دهند! به همین دلیل است که دانش آموزان باید تمرینات را با " "استفاده از local Rust installation یا از طریق Playground حل کنند." -#: src/cargo/running-locally.md:1 +#: src/cargo/running-locally.md msgid "Running Code Locally with Cargo" msgstr "اجرای کد به صورت لوکال با Cargo" -#: src/cargo/running-locally.md:3 +#: src/cargo/running-locally.md msgid "" "If you want to experiment with the code on your own system, then you will " "need to first install Rust. Do this by following the [instructions in the " @@ -2531,7 +2490,7 @@ msgstr "" "`rustc` و `cargo` کاربردی بدهد. در زمان نگارش، آخرین نسخه پایدار Rust دارای " "این version numberها است:" -#: src/cargo/running-locally.md:16 +#: src/cargo/running-locally.md msgid "" "You can use any later version too since Rust maintains backwards " "compatibility." @@ -2539,7 +2498,7 @@ msgstr "" "شما همچنین می توانید از هر نسخه بعدی استفاده کنید، زیرا Rust سازگاری با نسخه " "های قبلی را حفظ می‌کند." -#: src/cargo/running-locally.md:18 +#: src/cargo/running-locally.md msgid "" "With this in place, follow these steps to build a Rust binary from one of " "the examples in this training:" @@ -2547,26 +2506,26 @@ msgstr "" "با این کار، این مراحل را دنبال کنید تا از یکی از مثال‌های این آموزش، یک " "باینری Rust بسازید:" -#: src/cargo/running-locally.md:21 +#: src/cargo/running-locally.md msgid "Click the \"Copy to clipboard\" button on the example you want to copy." msgstr "" "روی دکمه \"کپی در کلیپ بورد\" در نمونه ای که می خواهید کپی کنید؛ کلیک کنید." -#: src/cargo/running-locally.md:23 +#: src/cargo/running-locally.md msgid "" "Use `cargo new exercise` to create a new `exercise/` directory for your code:" msgstr "" "از `cargo new exercise` برای ایجاد دایرکتوری `excerise/` جدید برای کد خود " "استفاده کنید:" -#: src/cargo/running-locally.md:30 +#: src/cargo/running-locally.md msgid "" "Navigate into `exercise/` and use `cargo run` to build and run your binary:" msgstr "" "به `exercise/` بروید و از `cargo run` برای ساخت و اجرای باینری خود استفاده " "کنید:" -#: src/cargo/running-locally.md:41 +#: src/cargo/running-locally.md msgid "" "Replace the boiler-plate code in `src/main.rs` with your own code. For " "example, using the example on the previous page, make `src/main.rs` look like" @@ -2574,11 +2533,11 @@ msgstr "" "کد صفحه دیگر را در `src/main.rs` با کد خود جایگزین کنید. برای مثال، با " "استفاده از مثال در صفحه قبل، `src/main.rs` را شبیه به آن کنید." -#: src/cargo/running-locally.md:50 +#: src/cargo/running-locally.md msgid "Use `cargo run` to build and run your updated binary:" msgstr "برای ساختن و اجرای باینری به روز شده خود از `cargo run` استفاده کنید:" -#: src/cargo/running-locally.md:60 +#: src/cargo/running-locally.md msgid "" "Use `cargo check` to quickly check your project for errors, use `cargo " "build` to compile it without running it. You will find the output in `target/" @@ -2590,7 +2549,7 @@ msgstr "" "debug/` برای ساخت اشکال زدایی معمولی خواهید یافت. برای تولید نسخه بهینه سازی " "شده در `target/release/` از `cargo build --release` استفاده کنید." -#: src/cargo/running-locally.md:65 +#: src/cargo/running-locally.md msgid "" "You can add dependencies for your project by editing `Cargo.toml`. When you " "run `cargo` commands, it will automatically download and compile missing " @@ -2600,7 +2559,7 @@ msgstr "" "هنگامی که دستورات `cargo` را اجرا می کنید، به طور خودکار وابستگی های مورد " "نیاز را برای شما دانلود و کامپایل می‌کند." -#: src/cargo/running-locally.md:73 +#: src/cargo/running-locally.md msgid "" "Try to encourage the class participants to install Cargo and use a local " "editor. It will make their life easier since they will have a normal " @@ -2763,7 +2722,7 @@ msgstr "۱۰ دقیقه" msgid "2 minutes" msgstr "۲ دقیقه" -#: src/hello-world/what-is-rust.md:3 +#: src/hello-world/what-is-rust.md msgid "" "Rust is a new programming language which had its [1.0 release in 2015]" "(https://blog.rust-lang.org/2015/05/15/Rust-1.0.html):" @@ -2771,17 +2730,17 @@ msgstr "" "‏Rust یک زبان برنامه‌نویسی جدید است که [نسخه 1.0 آن در سال 2015 منتشر شد]" "(https://blog.rust-lang.org/2015/05/15/Rust-1.0.html):" -#: src/hello-world/what-is-rust.md:5 +#: src/hello-world/what-is-rust.md msgid "Rust is a statically compiled language in a similar role as C++" msgstr "" "زبان Rust, یک زبان کامپایل شده ایستا است که نقشی مشابه C++ دارد." -#: src/hello-world/what-is-rust.md:6 +#: src/hello-world/what-is-rust.md msgid "`rustc` uses LLVM as its backend." msgstr "`rustc` از `LLVM` به عنوان بک‌اند خود استفاده می‌کند." -#: src/hello-world/what-is-rust.md:7 +#: src/hello-world/what-is-rust.md msgid "" "Rust supports many [platforms and architectures](https://doc.rust-lang.org/" "nightly/rustc/platform-support.html):" @@ -2789,68 +2748,68 @@ msgstr "" " راست از بسیاری از [بسترها و معماری‌ها](https://doc.rust-lang.org/nightly/" "rustc/platform-support.html) پشتیبانی می کند :" -#: src/hello-world/what-is-rust.md:9 +#: src/hello-world/what-is-rust.md msgid "x86, ARM, WebAssembly, ..." msgstr "x86, ARM, WebAssembly, ..." -#: src/hello-world/what-is-rust.md:10 +#: src/hello-world/what-is-rust.md msgid "Linux, Mac, Windows, ..." msgstr "Linux, Mac, Windows, ..." -#: src/hello-world/what-is-rust.md:11 +#: src/hello-world/what-is-rust.md msgid "Rust is used for a wide range of devices:" msgstr ":راست برای طیف گسترده‌ای از دستگاه‌ها استفاده می‌شود" -#: src/hello-world/what-is-rust.md:12 +#: src/hello-world/what-is-rust.md msgid "firmware and boot loaders," msgstr "میان‌افزار (firmware) و بوت‌لودرها (boot loaders)" -#: src/hello-world/what-is-rust.md:13 +#: src/hello-world/what-is-rust.md msgid "smart displays," msgstr "نمایشگر‌های هوشمند" -#: src/hello-world/what-is-rust.md:14 +#: src/hello-world/what-is-rust.md msgid "mobile phones," msgstr "تلفن‌های همراه" -#: src/hello-world/what-is-rust.md:15 +#: src/hello-world/what-is-rust.md msgid "desktops," msgstr "رایانه‌های رومیزی" -#: src/hello-world/what-is-rust.md:16 +#: src/hello-world/what-is-rust.md msgid "servers." msgstr "سرورها" -#: src/hello-world/what-is-rust.md:21 +#: src/hello-world/what-is-rust.md msgid "Rust fits in the same area as C++:" msgstr "Rust در همان حوزه C++ قرار می‌گیرد:" -#: src/hello-world/what-is-rust.md:23 +#: src/hello-world/what-is-rust.md msgid "High flexibility." msgstr "انعطاف پذیری بالا." -#: src/hello-world/what-is-rust.md:24 +#: src/hello-world/what-is-rust.md msgid "High level of control." msgstr "سطح کنترل بالا." -#: src/hello-world/what-is-rust.md:25 +#: src/hello-world/what-is-rust.md msgid "" "Can be scaled down to very constrained devices such as microcontrollers." msgstr "می‌تواند به دستگاه‌های بسیار محدود مانند میکروکنترلرها مقیاس‌بندی شود." -#: src/hello-world/what-is-rust.md:26 +#: src/hello-world/what-is-rust.md msgid "Has no runtime or garbage collection." msgstr "فاقد ران‌تایم (runtime) یا جمع‌آوری زباله (garbage collection) است." -#: src/hello-world/what-is-rust.md:27 +#: src/hello-world/what-is-rust.md msgid "Focuses on reliability and safety without sacrificing performance." msgstr "بر قابلیت اطمینان و ایمنی بدون قربانی کردن عملکرد تمرکز دارد." -#: src/hello-world/benefits.md:3 +#: src/hello-world/benefits.md msgid "Some unique selling points of Rust:" msgstr "برخی از نقاط قوت منحصر به فرد زبان Rust:" -#: src/hello-world/benefits.md:5 +#: src/hello-world/benefits.md msgid "" "_Compile time memory safety_ - whole classes of memory bugs are prevented at " "compile time" @@ -2858,35 +2817,35 @@ msgstr "" "_ایمنی حافظه زمان کامپایل_ - کل کلاس های باگ حافظه در زمان کامپایل جلوگیری " "می شود" -#: src/hello-world/benefits.md:7 +#: src/hello-world/benefits.md msgid "No uninitialized variables." msgstr "هیچ متغیر مقدار‌دهی نشده‌ای (`uninitialized`) وجود ندارد." -#: src/hello-world/benefits.md:8 +#: src/hello-world/benefits.md msgid "No double-frees." msgstr "هیچ آزادسازی دوباره‌ای وجود ندارد." -#: src/hello-world/benefits.md:9 +#: src/hello-world/benefits.md msgid "No use-after-free." msgstr "هیچ استفاده‌ای پس از آزادسازی وجود ندارد." -#: src/hello-world/benefits.md:10 +#: src/hello-world/benefits.md msgid "No `NULL` pointers." msgstr "هیچ اشاره‌گر `NULL` وجود ندارد." -#: src/hello-world/benefits.md:11 +#: src/hello-world/benefits.md msgid "No forgotten locked mutexes." msgstr "هیچ موتکس قفل شدهِ فراموش شده‌ای وجود ندارد." -#: src/hello-world/benefits.md:12 +#: src/hello-world/benefits.md msgid "No data races between threads." msgstr "هیچ وضعیت رقابتی (`data races`) بین رشته‌ها وجود ندارد." -#: src/hello-world/benefits.md:13 +#: src/hello-world/benefits.md msgid "No iterator invalidation." msgstr "تکرارکننده‌ها (`iterators`) هیچگاه نامعتبر نمی‌شوند.." -#: src/hello-world/benefits.md:15 +#: src/hello-world/benefits.md msgid "" "_No undefined runtime behavior_ - what a Rust statement does is never left " "unspecified" @@ -2894,54 +2853,54 @@ msgstr "" "_بدون رفتار زمان اجرا تعریف نشده_ - کاری که دستور Rust انجام می دهد هرگز " "نامشخص باقی نمی ماند" -#: src/hello-world/benefits.md:17 +#: src/hello-world/benefits.md msgid "Array access is bounds checked." msgstr "دسترسی به آرایه با بررسی محدوده چک می‌شود." -#: src/hello-world/benefits.md:18 +#: src/hello-world/benefits.md msgid "Integer overflow is defined (panic or wrap-around)." msgstr "سرریز عدد صحیح تعریف شده است (پانیک یا `wrap-around`)." -#: src/hello-world/benefits.md:20 +#: src/hello-world/benefits.md msgid "" "_Modern language features_ - as expressive and ergonomic as higher-level " "languages" msgstr "" "_ویژگی های زبان مدرن_ - به اندازه زبان های سطح بالاتر گویا و ارگونومیک است" -#: src/hello-world/benefits.md:22 +#: src/hello-world/benefits.md msgid "Enums and pattern matching." msgstr "Enumها و تطابق الگوها." -#: src/hello-world/benefits.md:23 +#: src/hello-world/benefits.md msgid "Generics." msgstr "جنریک‌ها." -#: src/hello-world/benefits.md:24 +#: src/hello-world/benefits.md msgid "No overhead FFI." msgstr "FFI بدون سربار." -#: src/hello-world/benefits.md:25 +#: src/hello-world/benefits.md msgid "Zero-cost abstractions." msgstr "انتزاع‌هایی بدون هزینه." -#: src/hello-world/benefits.md:26 +#: src/hello-world/benefits.md msgid "Great compiler errors." msgstr "خطاهای کامپایل عالیست." -#: src/hello-world/benefits.md:27 +#: src/hello-world/benefits.md msgid "Built-in dependency manager." msgstr "مدیر وابستگی درون-ساختی." -#: src/hello-world/benefits.md:28 +#: src/hello-world/benefits.md msgid "Built-in support for testing." msgstr "پشتیبانی درون-ساختی از تست نویسی." -#: src/hello-world/benefits.md:29 +#: src/hello-world/benefits.md msgid "Excellent Language Server Protocol support." msgstr "پشتیبانی عالی از LSP‌." -#: src/hello-world/benefits.md:34 +#: src/hello-world/benefits.md msgid "" "Do not spend much time here. All of these points will be covered in more " "depth later." @@ -2949,7 +2908,7 @@ msgstr "" "وقت زیادی را اینجا صرف نکنید. تمام این نکات بعداً با عمق بیشتری پوشش داده " "خواهد شد." -#: src/hello-world/benefits.md:37 +#: src/hello-world/benefits.md msgid "" "Make sure to ask the class which languages they have experience with. " "Depending on the answer you can highlight different features of Rust:" @@ -2957,7 +2916,7 @@ msgstr "" "حتما از کلاس بپرسید که با چه زبان‌هایی تجربه دارند. بسته به پاسخ، می توانید " "ویژگی‌های مختلف Rust را برجسته کنید::" -#: src/hello-world/benefits.md:40 +#: src/hello-world/benefits.md msgid "" "Experience with C or C++: Rust eliminates a whole class of _runtime errors_ " "via the borrow checker. You get performance like in C and C++, but you don't " @@ -2970,7 +2929,7 @@ msgstr "" "دارید اما مشکلات عدم ایمنی حافظه را ندارید. علاوه بر این، شما یک زبان مدرن " "با ساختارهایی مانند تطابق الگو و مدیریت وابستگی داخلی دریافت می‌کنید." -#: src/hello-world/benefits.md:45 +#: src/hello-world/benefits.md #, fuzzy msgid "" "Experience with Java, Go, Python, JavaScript...: You get the same memory " @@ -2984,7 +2943,7 @@ msgstr "" "جمع‌آوری زباله) و همچنین دسترسی به سخت‌افزار سطح پایین (در صورت نیاز) دریافت " "می‌کنید." -#: src/hello-world/playground.md:3 +#: src/hello-world/playground.md msgid "" "The [Rust Playground](https://play.rust-lang.org/) provides an easy way to " "run short Rust programs, and is the basis for the examples and exercises in " @@ -2996,7 +2955,7 @@ msgstr "" "برنامه \"Hello-world\" را که با آن شروع می شود اجرا کنید. دارای چند ویژگی " "مفید است:" -#: src/hello-world/playground.md:8 +#: src/hello-world/playground.md msgid "" "Under \"Tools\", use the `rustfmt` option to format your code in the " "\"standard\" way." @@ -3004,7 +2963,7 @@ msgstr "" "در زیر \"ابزارها\"، از گزینه \"rustfmt\" برای قالب بندی کد خود به روش " "\"استاندارد\" استفاده کنید." -#: src/hello-world/playground.md:11 +#: src/hello-world/playground.md msgid "" "Rust has two main \"profiles\" for generating code: Debug (extra runtime " "checks, less optimization) and Release (fewer runtime checks, lots of " @@ -3014,7 +2973,7 @@ msgstr "" "اضافی، بهینه سازی کمتر) و Release (بررسی های زمان اجرا کمتر، بهینه سازی " "زیاد). اینها در قسمت «اشکال‌زدایی» در بالا قابل دسترسی هستند." -#: src/hello-world/playground.md:15 +#: src/hello-world/playground.md msgid "" "If you're interested, use \"ASM\" under \"...\" to see the generated " "assembly code." @@ -3022,7 +2981,7 @@ msgstr "" "اگر علاقه مند هستید، از \"ASM\" در زیر \"...\" برای دیدن کد اسمبلی تولید شده " "استفاده کنید." -#: src/hello-world/playground.md:21 +#: src/hello-world/playground.md msgid "" "As students head into the break, encourage them to open up the playground " "and experiment a little. Encourage them to keep the tab open and try things " @@ -3040,7 +2999,7 @@ msgstr "" msgid "This segment should take about 40 minutes. It contains:" msgstr "این بخش باید حدود ۴۰ دقیقه طول بکشد. آن شامل:" -#: src/types-and-values/hello-world.md:3 +#: src/types-and-values/hello-world.md msgid "" "Let us jump into the simplest possible Rust program, a classic Hello World " "program:" @@ -3048,41 +3007,41 @@ msgstr "" "بیایید به ساده ترین برنامه Rust ممکن یعنی یک برنامه Hello World کلاسیک " "بپردازیم:" -#: src/types-and-values/hello-world.md:8 +#: src/types-and-values/hello-world.md msgid "\"Hello 🌍!\"" msgstr "\"Hello 🌍!\"" -#: src/types-and-values/hello-world.md:12 +#: src/types-and-values/hello-world.md msgid "What you see:" msgstr "آنچه شما می‌بینید:" -#: src/types-and-values/hello-world.md:14 +#: src/types-and-values/hello-world.md msgid "Functions are introduced with `fn`." msgstr "توابع با `fn` معرفی می‌شوند." -#: src/types-and-values/hello-world.md:15 +#: 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/hello-world.md:16 +#: 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:17 +#: src/types-and-values/hello-world.md msgid "Rust has hygienic macros, `println!` is an example of this." msgstr "" "زبان Rust دارای ماکروهای hygienic است، `println!` یک " "نمونه از این است." -#: src/types-and-values/hello-world.md:18 +#: src/types-and-values/hello-world.md msgid "Rust strings are UTF-8 encoded and can contain any Unicode character." msgstr "" "رشته‌های Rust دارای انکودینگ UTF-8 هستند و می‌توانند شامل هر کاراکتر یونیکد " "باشند." -#: src/types-and-values/hello-world.md:23 +#: src/types-and-values/hello-world.md 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 " @@ -3091,7 +3050,7 @@ msgstr "" "این اسلاید سعی می کند دانشجویان با کد Rust احساس راحتی کنند. آنها در سه روز " "آینده خیلی از این کدها خواهند دید، بنابراین با یک چیز آشنا شروع می کنیم.." -#: src/types-and-values/hello-world.md:28 +#: src/types-and-values/hello-world.md 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." @@ -3100,11 +3059,11 @@ msgstr "" "span>/Java است.یک زبان امری است (imperative) و سعی نمی‌کند چیزی را مگر اینکه " "کاملاً ضروری باشد، دوباره اختراع کند." -#: src/types-and-values/hello-world.md:31 +#: src/types-and-values/hello-world.md msgid "Rust is modern with full support for things like Unicode." msgstr "زبان Rust, یک زبان مدرن با پشتیبانی کامل از چیزهایی مانند یونیکد است." -#: src/types-and-values/hello-world.md:33 +#: src/types-and-values/hello-world.md msgid "" "Rust uses macros for situations where you want to have a variable number of " "arguments (no function [overloading](../control-flow-basics/functions.md))." @@ -3113,7 +3072,7 @@ msgstr "" "آرگومان‌ها داشته باشید (بدون [اورلودینگ](../control-flow-basics/functions.md) " "تابع)." -#: src/types-and-values/hello-world.md:36 +#: src/types-and-values/hello-world.md #, fuzzy msgid "" "Macros being 'hygienic' means they don't accidentally capture identifiers " @@ -3126,7 +3085,7 @@ msgstr "" "واقع فقط [تا حدی هاجنیک](https://veykril.github.io/tlborm/decl-macros/" "minutiae/hygiene.html هستند." -#: src/types-and-values/hello-world.md:40 +#: 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, " @@ -3139,7 +3098,7 @@ msgstr "" "فانکشنال](https://doc.rust-lang.org/book/ch13-00-functional-features.html) " "است." -#: src/types-and-values/variables.md:3 +#: src/types-and-values/variables.md msgid "" "Rust provides type safety via static typing. Variable bindings are made with " "`let`:" @@ -3147,12 +3106,12 @@ msgstr "" "زبان Rust از طریق سیستم تایپ استاتیک, ایمینی نوع را فراهم می‌کند. به صورت " "پیشفرض تعریف متغییر ها از نوع «غیر قابل تغییر» (immutable) است:" -#: src/types-and-values/variables.md:9 src/control-flow-basics/loops/for.md:9 -#: src/control-flow-basics/blocks-and-scopes.md:17 +#: 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}\"" -#: src/types-and-values/variables.md:10 +#: src/types-and-values/variables.md msgid "" "// x = 20;\n" " // println!(\"x: {x}\");\n" @@ -3160,7 +3119,7 @@ msgstr "" "// x = 20;\n" " // println!(\"x: {x}\");\n" -#: src/types-and-values/variables.md:18 +#: src/types-and-values/variables.md msgid "" "Uncomment the `x = 20` to demonstrate that variables are immutable by " "default. Add the `mut` keyword to allow changes." @@ -3168,7 +3127,7 @@ msgstr "" "برای نشان دادن اینکه متغیرها به طور پیش‌فرض تغییرناپذیر هستند، کامنت \"x = " "20\" را حذف کنید. برای اجازه دادن به تغییرات، کلمه کلیدی «mut» را اضافه کنید." -#: src/types-and-values/variables.md:21 +#: src/types-and-values/variables.md msgid "" "The `i32` here is the type of the variable. This must be known at compile " "time, but type inference (covered later) allows the programmer to omit it in " @@ -3178,7 +3137,7 @@ msgstr "" "استنتاج نوع (که بعداً پوشش داده می شود) به برنامه نویس اجازه می دهد تا در " "بسیاری از موارد آن را حذف کند." -#: src/types-and-values/values.md:3 +#: src/types-and-values/values.md msgid "" "Here are some basic built-in types, and the syntax for literal values of " "each type." @@ -3186,105 +3145,105 @@ msgstr "" "در اینجا چند نوع پایه داخلی و نحو برای مقادیر تحت اللفظی هر نوع آورده شده " "است." -#: src/types-and-values/values.md:6 src/unsafe-rust/exercise.md:16 +#: src/types-and-values/values.md src/unsafe-rust/exercise.md msgid "Types" msgstr "انواع" -#: src/types-and-values/values.md:6 +#: src/types-and-values/values.md msgid "Literals" msgstr "مقادیر ثابت" -#: src/types-and-values/values.md:8 +#: src/types-and-values/values.md msgid "Signed integers" msgstr "اعداد صحیح علامت‌دار" -#: src/types-and-values/values.md:8 +#: src/types-and-values/values.md msgid "`i8`, `i16`, `i32`, `i64`, `i128`, `isize`" msgstr "`i8`, `i16`, `i32`, `i64`, `i128`, `isize`" -#: src/types-and-values/values.md:8 +#: src/types-and-values/values.md msgid "`-10`, `0`, `1_000`, `123_i64`" msgstr "" "-10, 0, 1_000, 123_i64" -#: src/types-and-values/values.md:9 +#: src/types-and-values/values.md msgid "Unsigned integers" msgstr "اعداد صحیح مثبت" -#: src/types-and-values/values.md:9 +#: src/types-and-values/values.md msgid "`u8`, `u16`, `u32`, `u64`, `u128`, `usize`" msgstr "`u8`, `u16`, `u32`, `u64`, `u128`, `usize`" -#: src/types-and-values/values.md:9 +#: src/types-and-values/values.md msgid "`0`, `123`, `10_u16`" msgstr "" "0, 123, 10_u16" -#: src/types-and-values/values.md:10 +#: src/types-and-values/values.md msgid "Floating point numbers" msgstr "اعداد با ممیز شناور" -#: src/types-and-values/values.md:10 +#: src/types-and-values/values.md msgid "`f32`, `f64`" msgstr "`f32`, `f64`" -#: src/types-and-values/values.md:10 +#: src/types-and-values/values.md msgid "`3.14`, `-10.0e20`, `2_f32`" msgstr "" "3.14, -10.0e20, 2_f32" -#: src/types-and-values/values.md:11 +#: src/types-and-values/values.md msgid "Unicode scalar values" msgstr "مقادیر عددی یونیکد" -#: src/types-and-values/values.md:11 src/android/aidl/types/primitives.md:9 +#: src/types-and-values/values.md src/android/aidl/types/primitives.md msgid "`char`" msgstr "`char`" -#: src/types-and-values/values.md:11 +#: src/types-and-values/values.md msgid "`'a'`, `'α'`, `'∞'`" msgstr "`'a'`, `'α'`, `'∞'`" -#: src/types-and-values/values.md:12 +#: src/types-and-values/values.md msgid "Booleans" msgstr "بولین‌ها" -#: src/types-and-values/values.md:12 src/android/aidl/types/primitives.md:7 +#: src/types-and-values/values.md src/android/aidl/types/primitives.md msgid "`bool`" msgstr "`bool`" -#: src/types-and-values/values.md:12 +#: src/types-and-values/values.md msgid "`true`, `false`" msgstr "`true`, `false`" -#: src/types-and-values/values.md:14 +#: src/types-and-values/values.md msgid "The types have widths as follows:" msgstr "اندازه تایپ‌ها به شرح زیر است:" -#: src/types-and-values/values.md:16 +#: src/types-and-values/values.md msgid "`iN`, `uN`, and `fN` are _N_ bits wide," msgstr "`iN`, `uN`و `fN` به اندازه _N_ حافظه اشغال می‌کنند.," -#: src/types-and-values/values.md:17 +#: src/types-and-values/values.md msgid "`isize` and `usize` are the width of a pointer," msgstr "`isize` و `usize` به اندازه یک اشاره‌گر حافظه اشغال می‌کنند," -#: src/types-and-values/values.md:18 +#: src/types-and-values/values.md msgid "`char` is 32 bits wide," msgstr "`char` به اندازه 32 بیت حافظه اشغال می‌کنند.," -#: src/types-and-values/values.md:19 +#: src/types-and-values/values.md msgid "`bool` is 8 bits wide." msgstr "`bool` به اندازه 8 بیت حافظه اشغال می‌کنند." -#: src/types-and-values/values.md:24 +#: src/types-and-values/values.md msgid "There are a few syntaxes which are not shown above:" msgstr "موارد اندکی وجود دارند که در بالا نشان داده نشده است:" -#: src/types-and-values/values.md:26 +#: src/types-and-values/values.md msgid "" "All underscores in numbers can be left out, they are for legibility only. So " "`1_000` can be written as `1000` (or `10_00`), and `123_i64` can be written " @@ -3295,11 +3254,11 @@ msgstr "" "(یا `10_00`) نوشته شود و `123_i64` " "می‌تواند به صورت `123i64` نوشته شود»." -#: src/types-and-values/arithmetic.md:9 +#: src/types-and-values/arithmetic.md msgid "\"result: {}\"" msgstr "\"result: {}\"" -#: src/types-and-values/arithmetic.md:16 +#: src/types-and-values/arithmetic.md msgid "" "This is the first time we've seen a function other than `main`, but the " "meaning should be clear: it takes three integers, and returns an integer. " @@ -3309,11 +3268,11 @@ msgstr "" "باشد: سه عدد صحیح می گیرد و یک عدد صحیح برمی گرداند. توابع بعداً با جزئیات " "بیشتر پوشش داده خواهد شد." -#: src/types-and-values/arithmetic.md:20 +#: src/types-and-values/arithmetic.md msgid "Arithmetic is very similar to other languages, with similar precedence." msgstr "حسابی بسیار شبیه به زبان های دیگر است، با تقدم مشابه." -#: src/types-and-values/arithmetic.md:22 +#: src/types-and-values/arithmetic.md #, fuzzy msgid "" "What about integer overflow? In C and C++ overflow of _signed_ integers is " @@ -3324,7 +3283,7 @@ msgstr "" "تعریف نشده است و ممکن است کارهای متفاوتی را در پلتفرم ها یا کامپایلرهای " "مختلف انجام دهد. در Rust تعریف شده است." -#: src/types-and-values/arithmetic.md:26 +#: src/types-and-values/arithmetic.md msgid "" "Change the `i32`'s to `i16` to see an integer overflow, which panics " "(checked) in a debug build and wraps in a release build. There are other " @@ -3337,7 +3296,7 @@ msgstr "" "دیگری مانند سرریز، اشباع و حمل وجود دارد. اینها با نحو متد قابل دسترسی " "هستند، به عنوان مثال، `(a * b).saturating_add(b * c).saturating_add(c *a)`." -#: src/types-and-values/arithmetic.md:31 +#: src/types-and-values/arithmetic.md msgid "" "In fact, the compiler will detect overflow of constant expressions, which is " "why the example requires a separate function." @@ -3345,11 +3304,11 @@ msgstr "" "در واقع، کامپایلر سرریز عبارات ثابت را تشخیص می دهد، به همین دلیل است که " "مثال به یک تابع جداگانه نیاز دارد." -#: src/types-and-values/inference.md:3 +#: src/types-and-values/inference.md msgid "Rust will look at how the variable is _used_ to determine the type:" msgstr "زبان Rust برای تعیین نوع متغیر به نحوه استفاده از آن نگاه می‌کند:" -#: src/types-and-values/inference.md:29 +#: src/types-and-values/inference.md msgid "" "This slide demonstrates how the Rust compiler infers types based on " "constraints given by variable declarations and usages." @@ -3357,7 +3316,7 @@ msgstr "" "این اسلاید نشان می‌دهد که چگونه کامپایلر Rust با توجه به اعلان‌ها و استفاده‌های " "متغیر، انواع را استنتاج می‌کند. " -#: src/types-and-values/inference.md:32 +#: src/types-and-values/inference.md msgid "" "It is very important to emphasize that variables declared like this are not " "of some sort of dynamic \"any type\" that can hold any data. The machine " @@ -3371,7 +3330,7 @@ msgstr "" "اعلام میکنیم و کد های ماشین آنها دقیقا یکسان هستند. فقط با استفاده از تعیین " "تایپ ضمنی میتوانید کد ها رو به صورت مختصرتر بنویسیم. " -#: src/types-and-values/inference.md:37 +#: src/types-and-values/inference.md msgid "" "When nothing constrains the type of an integer literal, Rust defaults to " "`i32`. This sometimes appears as `{integer}` in error messages. Similarly, " @@ -3381,11 +3340,11 @@ msgstr "" "«i32» قرار می گیرد. گاهی اوقات در پیام های خطا به صورت «{integer}» نشان داده " "می شود. به طور مشابه، تایپ ممیز شناور پیش‌فرض «f64» است." -#: src/types-and-values/inference.md:46 +#: src/types-and-values/inference.md msgid "// ERROR: no implementation for `{float} == {integer}`\n" msgstr "// ERROR: no implementation for `{float} == {integer}`\n" -#: src/types-and-values/exercise.md:3 +#: src/types-and-values/exercise.md msgid "" "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 " @@ -3394,7 +3353,7 @@ msgstr "" "دنباله فیبوناچی با «[0،1]» شروع می شود. برای n>1، عدد فیبوناچی n به صورت " "بازگشتی به عنوان مجموع اعداد فیبوناچی n-1 و n-2 محاسبه می شود." -#: src/types-and-values/exercise.md:6 +#: src/types-and-values/exercise.md msgid "" "Write a function `fib(n)` that calculates the n'th Fibonacci number. When " "will this function panic?" @@ -3402,22 +3361,20 @@ msgstr "" "یک تابع fib(n) بنویسید که عدد فیبوناچی n را محاسبه کند. چه زمانی این عملکرد " "panic می شود؟" -#: src/types-and-values/exercise.md:12 +#: src/types-and-values/exercise.md msgid "// The base case.\n" msgstr "//حالت پایه\n" -#: src/types-and-values/exercise.md:13 src/types-and-values/exercise.md:16 -#: src/control-flow-basics/exercise.md:27 -#: src/control-flow-basics/exercise.md:31 +#: src/types-and-values/exercise.md src/control-flow-basics/exercise.md #, fuzzy msgid "\"Implement this\"" msgstr "پیاده سازی" -#: src/types-and-values/exercise.md:15 +#: src/types-and-values/exercise.md msgid "// The recursive case.\n" msgstr "// حالت بازگشتی\n" -#: src/types-and-values/exercise.md:22 src/types-and-values/solution.md:14 +#: src/types-and-values/exercise.md src/types-and-values/solution.md msgid "\"fib({n}) = {}\"" msgstr "\"fib({n}) = {}\"" @@ -3434,11 +3391,11 @@ msgstr "۴ دقیقه" msgid "break and continue" msgstr "`break` و `continue`" -#: src/control-flow-basics/if.md:1 +#: src/control-flow-basics/if.md msgid "`if` expressions" msgstr "عبارات `if`" -#: src/control-flow-basics/if.md:3 +#: 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:" @@ -3446,19 +3403,19 @@ msgstr "" "شما [عبارت `if`](https://doc.rust-lang.org/reference/expressions/if-expr." "html#if-expressions) رو به مانند دیگر زبان‌ها استفاده می‌کنید:" -#: src/control-flow-basics/if.md:11 +#: src/control-flow-basics/if.md msgid "\"zero!\"" msgstr "\"zero!\"" -#: src/control-flow-basics/if.md:13 +#: src/control-flow-basics/if.md msgid "\"biggish\"" msgstr "\"biggish\"" -#: src/control-flow-basics/if.md:15 +#: src/control-flow-basics/if.md msgid "\"huge\"" msgstr "\"huge\"" -#: src/control-flow-basics/if.md:20 +#: 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:" @@ -3466,19 +3423,19 @@ msgstr "" "در کنار این موضوع, می‌توانید از if به عنوان یک عبارت با قابلیت بازگشت مقدار " "هم استفاده کنید. آخرین عبارت توی هر بلاک if اون مقدار و نوع بازگشتی است:" -#: src/control-flow-basics/if.md:26 +#: src/control-flow-basics/if.md msgid "\"small\"" msgstr "\"کوچک\"" -#: src/control-flow-basics/if.md:26 +#: src/control-flow-basics/if.md msgid "\"large\"" msgstr "\"بزرگ\"" -#: src/control-flow-basics/if.md:27 +#: src/control-flow-basics/if.md msgid "\"number size: {}\"" msgstr "\"اندازه عدد: {}\"" -#: src/control-flow-basics/if.md:34 +#: src/control-flow-basics/if.md msgid "" "Because `if` is an expression and must have a particular type, both of its " "branch blocks must have the same type. Show what happens if you add `;` " @@ -3488,26 +3445,28 @@ msgstr "" "و `else`) باید از نوع یکسانی را باز گردانند. در نظر بگیرید که اگر بعد از " "`x / 2` در مثال دوم `;` اضافه کنید، چه اتفاقی می افتد." -#: src/control-flow-basics/if.md:38 +#: 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!\" حذف کنید تا خطای " "کامپایلر را ببینید." -#: src/control-flow-basics/loops.md:3 +#: src/control-flow-basics/loops.md msgid "There are three looping keywords in Rust: `while`, `loop`, and `for`:" msgstr "" "سه کلمه کلیدی حلقه ای در Rust وجود دارد: \"while\"، \"loop\" و \"for\":" -#: src/control-flow-basics/loops.md:5 +#: src/control-flow-basics/loops.md msgid "`while`" msgstr "حلقه‌های `while`" -#: src/control-flow-basics/loops.md:7 +#: src/control-flow-basics/loops.md msgid "" "The [`while` keyword](https://doc.rust-lang.org/reference/expressions/loop-" "expr.html#predicate-loops) works much like in other languages, executing the " @@ -3516,11 +3475,11 @@ msgstr "" "[کلمه‌کلیدی`while` ](https://doc.rust-lang.org/reference/expressions/loop-" "expr.html#predicate-loops) بسیار شبیه به سایر زبان‌ها عمل می‌کند." -#: src/control-flow-basics/loops.md:18 +#: src/control-flow-basics/loops.md msgid "\"Final x: {x}\"" msgstr "\"خروجی x: {x}\"" -#: src/control-flow-basics/loops/for.md:3 +#: src/control-flow-basics/loops/for.md msgid "" "The [`for` loop](https://doc.rust-lang.org/std/keyword.for.html) iterates " "over ranges of values or the items in a collection:" @@ -3528,11 +3487,11 @@ msgstr "" "حلقه [`for`](https://doc.rust-lang.org/std/keyword.for.html) در محدوده‌ای از " "مقادیر یا موارد موجود در یک مجموعه تکرار می‌شود:" -#: src/control-flow-basics/loops/for.md:13 +#: src/control-flow-basics/loops/for.md msgid "\"elem: {elem}\"" msgstr "\"elem: {elem}\"" -#: src/control-flow-basics/loops/for.md:20 +#: 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 " @@ -3542,7 +3501,7 @@ msgstr "" "مختلف محدوده/مجموعه استفاده می‌کنند. Iterators بعداً با جزئیات بیشتر مورد بحث " "قرار خواهند گرفت." -#: src/control-flow-basics/loops/for.md:23 +#: src/control-flow-basics/loops/for.md #, fuzzy msgid "" "Note that the first `for` loop only iterates to `4`. Show the `1..=5` syntax " @@ -3551,7 +3510,7 @@ msgstr "" "توجه داشته باشید که حلقه `for` فقط تا `4` تکرار می شود. نحو `1..=5` را برای " "یک محدوده فراگیر نشان دهید." -#: src/control-flow-basics/loops/loop.md:3 +#: 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`." @@ -3559,11 +3518,11 @@ msgstr "" "[`loop`](https://doc.rust-lang.org/std/keyword.loop.html) برای همیشه، تا " "زمانی که یک «break» ایجاد شود، حلقه می‌شود." -#: src/control-flow-basics/loops/loop.md:11 +#: src/control-flow-basics/loops/loop.md msgid "\"{i}\"" msgstr "\"{i}\"" -#: src/control-flow-basics/break-continue.md:3 +#: src/control-flow-basics/break-continue.md msgid "" "If you want to immediately start the next iteration use [`continue`](https://" "doc.rust-lang.org/reference/expressions/loop-expr.html#continue-expressions)." @@ -3572,27 +3531,39 @@ msgstr "" "rust-lang.org/reference/expressions/loop-expr.html#continue-expressions) " "استفاده کنید." -#: src/control-flow-basics/break-continue.md:6 +#: 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:22 src/std-traits/exercise.md:23 -#: src/std-traits/solution.md:29 src/smart-pointers/trait-objects.md:95 -#: src/smart-pointers/trait-objects.md:96 -#: src/borrowing/interior-mutability.md:47 src/modules/exercise.md:136 -#: src/modules/solution.md:78 src/android/build-rules/library.md:44 -#: src/android/interoperability/cpp/rust-bridge.md:17 -#: src/concurrency/async-pitfalls/cancellation.md:59 +#: 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/labels.md:3 +#: src/control-flow-basics/break-continue.md +#, fuzzy +msgid "" +"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 "" +"توجه داشته باشید که loop تنها ساختار حلقه‌ای است که یک مقدار **non-trivial** " +"را برمی‌گرداند. این به دلیل این است که تضمین می‌شود حداقل یک بار وارد آن شود " +"(برخلاف حلقه‌های `while` و `for`)." + +#: 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:" @@ -3600,25 +3571,15 @@ msgstr "" "کلیدواژه‌های `continue` و `break` هر دو می‌توانند به صورت اختیاری یک آرگومان " "برچسب (label) بگیرند که میتوان برای خروج از حلقه‌های تو در تو استفاده می‌کرد:" -#: src/control-flow-basics/break-continue/labels.md:19 +#: src/control-flow-basics/break-continue/labels.md msgid "\"elements searched: {elements_searched}\"" msgstr "\"elements searched: {elements_searched}\"" -#: src/control-flow-basics/break-continue/labels.md:25 -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)." -msgstr "" -"توجه داشته باشید که loop تنها ساختار حلقه‌ای است که یک مقدار **non-trivial** " -"را برمی‌گرداند. این به دلیل این است که تضمین می‌شود حداقل یک بار وارد آن شود " -"(برخلاف حلقه‌های `while` و `for`)." - -#: src/control-flow-basics/blocks-and-scopes.md:3 +#: src/control-flow-basics/blocks-and-scopes.md msgid "Blocks" msgstr "بلوک‌ها" -#: src/control-flow-basics/blocks-and-scopes.md:5 +#: src/control-flow-basics/blocks-and-scopes.md msgid "" "A block in Rust contains a sequence of expressions, enclosed by braces `{}`. " "Each block has a value and a type, which are those of the last expression of " @@ -3627,17 +3588,17 @@ msgstr "" "یک بلوک در Rust حاوی دنباله ای از عبارات است که با پرانتزهای «{}» محصور شده " "است. هر بلوک دارای یک مقدار و یک نوع است که آخرین عبارت بلوک است:" -#: src/control-flow-basics/blocks-and-scopes.md:14 +#: src/control-flow-basics/blocks-and-scopes.md msgid "\"y: {y}\"" msgstr "\"y: {y}\"" -#: src/control-flow-basics/blocks-and-scopes.md:21 +#: src/control-flow-basics/blocks-and-scopes.md msgid "" "If the last expression ends with `;`, then the resulting value and type is " "`()`." msgstr "اگر آخرین عبارت با `;` پایان یابد، مقدار و نوع بازگشتی `()` است." -#: src/control-flow-basics/blocks-and-scopes.md:26 +#: 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`." @@ -3646,11 +3607,11 @@ msgstr "" "می‌کند. به عنوان مثال با اضافه کردن یا حذف کردن یک `;` یا با استفاده از کلید " "واژه `return` تغییرات را اعمال کنید." -#: src/control-flow-basics/blocks-and-scopes/scopes.md:3 +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "A variable's scope is limited to the enclosing block." msgstr "‏محدوده (scope) یک متغیر محدود به بلاک محاصره‌کننده آن است." -#: src/control-flow-basics/blocks-and-scopes/scopes.md:5 +#: 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:" @@ -3658,29 +3619,28 @@ msgstr "" "شما می توانید متغیرها را سایه بزنید، هم آنهایی که از اسکوپ‌های بیرونی هستند و " "هم متغیرهایی که از اسکوپ یکسان هستند:" -#: src/control-flow-basics/blocks-and-scopes/scopes.md:11 +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "\"before: {a}\"" msgstr "\"before: {a}\"" -#: src/control-flow-basics/blocks-and-scopes/scopes.md:13 -#: src/generics/exercise.md:18 src/generics/solution.md:20 -#: src/std-traits/from-and-into.md:7 src/std-traits/from-and-into.md:19 +#: 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/scopes.md:14 +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "\"inner scope: {a}\"" msgstr "\"inner scope: {a}\"" -#: src/control-flow-basics/blocks-and-scopes/scopes.md:17 +#: 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/scopes.md:20 +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "\"after: {a}\"" msgstr "\"after: {a}\"" -#: src/control-flow-basics/blocks-and-scopes/scopes.md:26 +#: 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." @@ -3688,21 +3648,22 @@ msgstr "" "با افزودن یک «b» در بلوک داخلی در آخرین مثال، و سپس تلاش برای دسترسی به آن " "در خارج از بلوک، نشان دهید که دامنه یک متغیر محدود است." -#: src/control-flow-basics/blocks-and-scopes/scopes.md:28 +#: 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/scopes.md:31 +#: 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/scopes.md:32 +#: 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()`." @@ -3710,7 +3671,7 @@ msgstr "" "سایه زدن در ابتدا مبهم به نظر می رسد، اما برای نگه داشتن مقادیر پس از `.unwrap()` مناسب است." -#: src/control-flow-basics/functions.md:22 +#: src/control-flow-basics/functions.md msgid "" "Declaration parameters are followed by a type (the reverse of some " "programming languages), then a return type." @@ -3718,7 +3679,7 @@ msgstr "" "بعد اعلان تابع پارامترهای ورودی و نوع آن و سپس یک نوع برگشتی هستند (برخلاف " "برخی از زبان‌های برنامه‌نویسی)." -#: src/control-flow-basics/functions.md:24 +#: src/control-flow-basics/functions.md msgid "" "The last expression in a function body (or any block) becomes the return " "value. Simply omit the `;` at the end of the expression. The `return` " @@ -3729,22 +3690,23 @@ msgstr "" "گرفته می‌شود. به همین سادگی `;` را میتوان در انتهای " "عبارت حذف کنید." -#: src/control-flow-basics/functions.md:28 +#: 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 "" "برخی از توابع هیچ مقدار برگشتی ندارند و «نوع یکه» `()` " "را برمی‌گردانند. اگر `-> ()` از بخش نوع برگشتی حذف شود، " "کامپایلر این را استنتاج خواهد کرد که هیچ نوع برگشتی وجود ندارد." -#: src/control-flow-basics/functions.md:30 +#: src/control-flow-basics/functions.md msgid "" "Overloading is not supported -- each function has a single implementation." msgstr "" "بارگذاری مجدد (overloading) پشتیبانی نمی‌شود -- هر تابع فقط یک پیاده‌سازی دارد." -#: src/control-flow-basics/functions.md:31 +#: src/control-flow-basics/functions.md msgid "" "Always takes a fixed number of parameters. Default arguments are not " "supported. Macros can be used to support variadic functions." @@ -3752,13 +3714,13 @@ msgstr "" "همیشه تعداد ثابتی از پارامترها را می گیرد. آرگومان های پیش فرض پشتیبانی نمی " "شوند. ماکروها را می توان برای پشتیبانی از توابع متغیر استفاده کرد." -#: src/control-flow-basics/functions.md:33 +#: src/control-flow-basics/functions.md msgid "" "Always takes a single set of parameter types. These types can be generic, " "which will be covered later." msgstr "همیشه یک مجموعه واحد از انواع آرگومان‌ها را می‌گیرد." -#: src/control-flow-basics/macros.md:3 +#: src/control-flow-basics/macros.md msgid "" "Macros are expanded into Rust code during compilation, and can take a " "variable number of arguments. They are distinguished by a `!` at the end. " @@ -3768,7 +3730,7 @@ msgstr "" "آرگومان‌ها را بگیرند. آنها در پایان با یک «!» متمایز می شوند. کتابخانه " "استاندارد Rust شامل مجموعه ای از ماکروهای مفید است." -#: src/control-flow-basics/macros.md:7 +#: src/control-flow-basics/macros.md msgid "" "`println!(format, ..)` prints a line to standard output, applying formatting " "described in [`std::fmt`](https://doc.rust-lang.org/std/fmt/index.html)." @@ -3777,7 +3739,7 @@ msgstr "" "شرح داده شده در [`std::fmt`] (https://doc.rust-lang.org/std/fmt/index.html) " "را اعمال می کند. ." -#: src/control-flow-basics/macros.md:9 +#: src/control-flow-basics/macros.md msgid "" "`format!(format, ..)` works just like `println!` but returns the result as a " "string." @@ -3785,11 +3747,11 @@ msgstr "" "`format!(format, ..)` درست مانند `println!` کار می کند، اما نتیجه را به صورت " "یک رشته برمی گرداند." -#: src/control-flow-basics/macros.md:11 +#: src/control-flow-basics/macros.md msgid "`dbg!(expression)` logs the value of the expression and returns it." msgstr "`dbg!(expression)` مقدار عبارت را ثبت کرده و آن را برمی گرداند." -#: src/control-flow-basics/macros.md:12 +#: src/control-flow-basics/macros.md msgid "" "`todo!()` marks a bit of code as not-yet-implemented. If executed, it will " "panic." @@ -3797,7 +3759,7 @@ msgstr "" "`todo!()` مقداری از کد را به عنوان هنوز پیاده‌سازی نشده علامت‌گذاری می‌کند. " "panic می کند." -#: src/control-flow-basics/macros.md:14 +#: src/control-flow-basics/macros.md msgid "" "`unreachable!()` marks a bit of code as unreachable. If executed, it will " "panic." @@ -3805,11 +3767,11 @@ msgstr "" "`unreachable!()` مقداری از کد را غیرقابل دسترسی علامت گذاری می کند. اگر " "اعدام شود وحشت می کند." -#: src/control-flow-basics/macros.md:32 +#: src/control-flow-basics/macros.md msgid "\"{n}! = {}\"" msgstr "\"{n}! = {}\"" -#: src/control-flow-basics/macros.md:39 +#: src/control-flow-basics/macros.md msgid "" "The takeaway from this section is that these common conveniences exist, and " "how to use them. Why they are defined as macros, and what they expand to, is " @@ -3819,7 +3781,7 @@ msgstr "" "دارد. اینکه چرا آنها به عنوان ماکرو تعریف می شوند و به چه چیزی گسترش می " "یابند، بسیار مهم نیست." -#: src/control-flow-basics/macros.md:43 +#: src/control-flow-basics/macros.md msgid "" "The course does not cover defining macros, but a later section will describe " "use of derive macros." @@ -3827,7 +3789,7 @@ msgstr "" "این دوره شامل تعریف ماکروها نمی شود، اما در بخش بعدی استفاده از ماکروهای " "مشتق شده توضیح داده خواهد شد." -#: src/control-flow-basics/exercise.md:3 +#: src/control-flow-basics/exercise.md #, fuzzy msgid "" "The [Collatz Sequence](https://en.wikipedia.org/wiki/Collatz_conjecture) is " @@ -3836,74 +3798,73 @@ msgstr "" "‏[Collatz Sequence](https://en.wikipedia.org/wiki/Collatz_conjecture) به شرح " "زیر تعریف می‌شود، برای هر n۱ دلخواه بزرگتر از صفر:" -#: src/control-flow-basics/exercise.md:6 +#: src/control-flow-basics/exercise.md msgid "" "If _ni_ is 1, then the sequence terminates at _ni_." msgstr "" "اگر _ni_ = ۱ باشد، دنباله (sequence) در _ni_ پایان " "می‌یابد." -#: src/control-flow-basics/exercise.md:7 +#: src/control-flow-basics/exercise.md msgid "If _ni_ is even, then _ni+1 = ni / 2_." msgstr "" "اگر _ni_ زوج باشد، آنگاه _ni+۱_ = _ni_/۲." -#: src/control-flow-basics/exercise.md:8 +#: src/control-flow-basics/exercise.md msgid "" "If _ni_ is odd, then _ni+1 = 3 * ni + 1_." msgstr "" "اگر _ni_ فرد باشد، آنگاه _ni+۱_ = ۳ * _ni_ " "+ ۱." -#: src/control-flow-basics/exercise.md:10 +#: src/control-flow-basics/exercise.md msgid "For example, beginning with _n1_ = 3:" msgstr "به عنوان مثال، با شروع از _ni_ = ۳:" -#: src/control-flow-basics/exercise.md:12 +#: src/control-flow-basics/exercise.md msgid "3 is odd, so _n2_ = 3 * 3 + 1 = 10;" msgstr "۳ فرد است، پس _n2_ = ۳ * ۳ + ۱ = 10;" -#: src/control-flow-basics/exercise.md:13 +#: src/control-flow-basics/exercise.md msgid "10 is even, so _n3_ = 10 / 2 = 5;" msgstr "۱۰ زوج است، پس _n3_ = ۱۰ / ۲ = ۵;" -#: src/control-flow-basics/exercise.md:14 +#: src/control-flow-basics/exercise.md msgid "5 is odd, so _n4_ = 3 * 5 + 1 = 16;" msgstr "۵ فرد است، پس _n4_ = ۳ * ۵ + ۱ = 16;" -#: src/control-flow-basics/exercise.md:15 +#: src/control-flow-basics/exercise.md msgid "16 is even, so _n5_ = 16 / 2 = 8;" msgstr "۱۶ زوج است، پس _n5_ = ۱۶ / ۲ = 8;" -#: src/control-flow-basics/exercise.md:16 +#: src/control-flow-basics/exercise.md msgid "8 is even, so _n6_ = 8 / 2 = 4;" msgstr "۸ زوج است، پس _n6_ = ۸ / ۲ = 4;" -#: src/control-flow-basics/exercise.md:17 +#: src/control-flow-basics/exercise.md msgid "4 is even, so _n7_ = 4 / 2 = 2;" msgstr "۴ زوج است، پس _n7_ = ۴ / ۲ = ۲;" -#: src/control-flow-basics/exercise.md:18 +#: src/control-flow-basics/exercise.md msgid "2 is even, so _n8_ = 1; and" msgstr "۲ زوج است، پس _n۸_ = ۱; و" -#: src/control-flow-basics/exercise.md:19 +#: src/control-flow-basics/exercise.md msgid "the sequence terminates." msgstr "دنباله به پایان می‌رسد." -#: src/control-flow-basics/exercise.md:21 +#: src/control-flow-basics/exercise.md msgid "" "Write a function to calculate the length of the collatz sequence for a given " "initial `n`." msgstr "" "یک تابع بنویسید تا طول دنباله Collatz برای یک n اولیه داده شده را محاسبه کند." -#: src/control-flow-basics/exercise.md:25 src/control-flow-basics/solution.md:4 +#: src/control-flow-basics/exercise.md src/control-flow-basics/solution.md msgid "/// Determine the length of the collatz sequence beginning at `n`.\n" msgstr "/// Determine the length of the collatz sequence beginning at `n`.\n" -#: src/control-flow-basics/solution.md:20 src/concurrency/threads/scoped.md:11 -#: src/concurrency/threads/scoped.md:30 +#: src/control-flow-basics/solution.md src/concurrency/threads/scoped.md msgid "\"Length: {}\"" msgstr "" @@ -3924,7 +3885,7 @@ msgstr "" msgid "This segment should take about 35 minutes. It contains:" msgstr "این بخش باید حدود 35 دقیقه طول بکشد. این شامل:" -#: src/tuples-and-arrays/arrays.md:16 +#: 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 " @@ -3938,7 +3899,7 @@ msgstr "" "dir=ltr>`[u8; 3]` و `[u8; 4]` دو نوع متفاوت در " "نظر گرفته می‌شوند." -#: src/tuples-and-arrays/arrays.md:22 +#: 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 " @@ -3948,11 +3909,11 @@ msgstr "" "آرایه در زمان اجرا بررسی می شود. زنگ معمولاً می‌تواند این بررسی‌ها را از بین " "ببرد و با استفاده از Rust ناایمن از آنها جلوگیری کرد." -#: src/tuples-and-arrays/arrays.md:26 +#: src/tuples-and-arrays/arrays.md msgid "We can use literals to assign values to arrays." msgstr "ما می‌توانیم از مقادیر ثابت برای انتساب مقادیر به آرایه‌ها استفاده کنیم." -#: src/tuples-and-arrays/arrays.md:28 +#: 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. " @@ -3967,7 +3928,7 @@ msgstr "" "فقط خروجی دیباگ را پیاده سازی می‌کنند. این بدان معناست که ما باید در اینجا از " "خروجی دیباگ استفاده کنیم." -#: src/tuples-and-arrays/arrays.md:33 +#: src/tuples-and-arrays/arrays.md msgid "" "Adding `#`, eg `{a:#?}`, invokes a \"pretty printing\" format, which can be " "easier to read." @@ -3975,15 +3936,15 @@ msgstr "" "اضافه کردن `#`، مانند `{a:#?}`، یک " "فرمت «چاپ زیبا» را فراخوانی می‌کند که می‌تواند خواندن آن را آسان تر کند." -#: src/tuples-and-arrays/tuples.md:16 +#: src/tuples-and-arrays/tuples.md msgid "Like arrays, tuples have a fixed length." msgstr "مانند آرایه‌ها، تاپل‌ها نیز دارای طول ثابت هستند." -#: src/tuples-and-arrays/tuples.md:18 +#: src/tuples-and-arrays/tuples.md msgid "Tuples group together values of different types into a compound type." msgstr "تاپل‌ها مقادیر انواع مختلف را در یک نوع مرکب کنار هم قرار می‌دهند." -#: src/tuples-and-arrays/tuples.md:20 +#: 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`." @@ -3991,7 +3952,7 @@ msgstr "" "می‌توان به فیلدهای یک تاپل با استفاده از نقطه و شماره اندیس مقدار، مانند " "`t.0`، `t.1` دسترسی پیدا کرد." -#: src/tuples-and-arrays/tuples.md:23 +#: src/tuples-and-arrays/tuples.md msgid "" "The empty tuple `()` is referred to as the \"unit type\" and signifies " "absence of a return value, akin to `void` in other languages." @@ -3999,11 +3960,11 @@ msgstr "" "تاپل خالی `()` به عنوان `unit type` نامیده می‌شود و نشان‌دهنده عدم وجود مقدار " "بازگشتی است، مشابه `void` در زبان‌های دیگر." -#: src/tuples-and-arrays/iteration.md:3 +#: src/tuples-and-arrays/iteration.md msgid "The `for` statement supports iterating over arrays (but not tuples)." msgstr "عبارت `for` از تکرار روی آرایه ها (اما نه تاپل ها) پشتیبانی می کند." -#: src/tuples-and-arrays/iteration.md:19 +#: src/tuples-and-arrays/iteration.md msgid "" "This functionality uses the `IntoIterator` trait, but we haven't covered " "that yet." @@ -4011,7 +3972,7 @@ msgstr "" "این قابلیت از ویژگی `IntoIterator` استفاده می‌کند، اما ما هنوز به آن " "پرداخته‌ایم." -#: src/tuples-and-arrays/iteration.md:22 +#: src/tuples-and-arrays/iteration.md #, fuzzy msgid "" "The `assert_ne!` macro is new here. There are also `assert_eq!` and `assert!" @@ -4022,7 +3983,7 @@ msgstr "" "` وجود دارد. این‌ها همیشه بررسی می‌شوند، در حالی که، گونه‌های فقط اشکال‌زدایی " "مانند `debug_assert!` در نسخه‌های ریلیز کامپایل نمی‌شوند." -#: src/tuples-and-arrays/destructuring.md:3 +#: src/tuples-and-arrays/destructuring.md msgid "" "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 " @@ -4032,12 +3993,11 @@ msgstr "" "داخلی را در متغیرهای محلی استخراج کنید. این را می توان به صورت دستی با " "دسترسی مستقیم به مقادیر داخلی انجام داد:" -#: src/tuples-and-arrays/destructuring.md:11 -#: src/tuples-and-arrays/destructuring.md:21 +#: src/tuples-and-arrays/destructuring.md msgid "\"left: {left}, right: {right}\"" msgstr "\"left: {left}, right: {right}\"" -#: src/tuples-and-arrays/destructuring.md:15 +#: src/tuples-and-arrays/destructuring.md msgid "" "However, Rust also supports using pattern matching to destructure a larger " "value into its constituent parts:" @@ -4045,7 +4005,7 @@ msgstr "" "با این حال، Rust همچنین از استفاده از تطبیق الگو برای تخریب یک مقدار بزرگتر " "در بخش های تشکیل دهنده آن پشتیبانی می کند:" -#: src/tuples-and-arrays/destructuring.md:28 +#: src/tuples-and-arrays/destructuring.md msgid "" "The patterns used here are \"irrefutable\", meaning that the compiler can " "statically verify that the value on the right of `=` has the same structure " @@ -4055,7 +4015,7 @@ msgstr "" "می تواند به طور ایستا تأیید کند که مقدار سمت راست `=` ساختاری مشابه الگو " "دارد." -#: src/tuples-and-arrays/destructuring.md:31 +#: src/tuples-and-arrays/destructuring.md msgid "" "A variable name is an irrefutable pattern that always matches any value, " "hence why we can also use `let` to declare a single variable." @@ -4063,7 +4023,7 @@ msgstr "" "نام متغیر یک الگوی انکارناپذیر است که همیشه با هر مقداری مطابقت دارد، از این " "رو می‌توانیم از «let» برای اعلام یک متغیر استفاده کنیم." -#: src/tuples-and-arrays/destructuring.md:33 +#: src/tuples-and-arrays/destructuring.md msgid "" "Rust also supports using patterns in conditionals, allowing for equality " "comparison and destructuring to happen at the same time. This form of " @@ -4073,7 +4033,7 @@ msgstr "" "برابری و تخریب ساختار را در همان زمان فراهم می‌کند. این شکل از تطبیق الگو " "بعداً با جزئیات بیشتری مورد بحث قرار خواهد گرفت." -#: src/tuples-and-arrays/destructuring.md:36 +#: src/tuples-and-arrays/destructuring.md msgid "" "Edit the examples above to show the compiler error when the pattern doesn't " "match the value being matched on." @@ -4081,15 +4041,15 @@ msgstr "" "مثال‌های بالا را ویرایش کنید تا خطای کامپایلر در زمانی که الگو با مقدار " "مطابقت‌شده مطابقت ندارد نشان داده شود." -#: src/tuples-and-arrays/exercise.md:3 +#: src/tuples-and-arrays/exercise.md msgid "Arrays can contain other arrays:" msgstr "آرایه ها می توانند آرایه های دیگری نیز داشته باشند:" -#: src/tuples-and-arrays/exercise.md:9 +#: src/tuples-and-arrays/exercise.md msgid "What is the type of this variable?" msgstr "نوع این متغیر چیست؟" -#: src/tuples-and-arrays/exercise.md:11 +#: src/tuples-and-arrays/exercise.md msgid "" "Use an array such as the above to write a function `transpose` which will " "transpose a matrix (turn rows into columns):" @@ -4097,7 +4057,7 @@ msgstr "" "از آرایه‌ای مشابه مثال بالا برای نوشتن تابع `transpose` " "استفاده کنید که یک ماتریس را جابجا می‌کند (ردیف‌ها را به ستون‌ها تبدیل می‌کند):" -#: src/tuples-and-arrays/exercise.md:22 +#: src/tuples-and-arrays/exercise.md msgid "" "Copy the code below to and implement the " "function. This function only operates on 3x3 matrices." @@ -4105,25 +4065,24 @@ msgstr "" "کد زیر را در کپی کرده و " "توابع را پیاده‌سازی کنید:" -#: src/tuples-and-arrays/exercise.md:26 src/borrowing/exercise.md:14 -#: src/unsafe-rust/exercise.md:51 +#: src/tuples-and-arrays/exercise.md src/borrowing/exercise.md +#: src/unsafe-rust/exercise.md msgid "// TODO: remove this when you're done with your implementation.\n" msgstr "// TODO: این را زمانی که پیاده‌سازی‌تان تمام شد حذف کنید.\n" -#: src/tuples-and-arrays/exercise.md:36 src/tuples-and-arrays/exercise.md:44 -#: src/tuples-and-arrays/solution.md:17 src/tuples-and-arrays/solution.md:25 +#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md msgid "//\n" msgstr "//\n" -#: src/tuples-and-arrays/exercise.md:53 src/tuples-and-arrays/solution.md:34 +#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md msgid "// <-- the comment makes rustfmt add a newline\n" msgstr "‏// <-- این کامنت باعث می‌شود rustfmt یک خط جدید اضافه کند.\n" -#: src/tuples-and-arrays/exercise.md:58 src/tuples-and-arrays/solution.md:39 +#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md msgid "\"matrix: {:#?}\"" msgstr "\"matrix: {:#?}\"" -#: src/tuples-and-arrays/exercise.md:60 src/tuples-and-arrays/solution.md:41 +#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md msgid "\"transposed: {:#?}\"" msgstr "\"transposed: {:#?}\"" @@ -4132,21 +4091,18 @@ msgstr "\"transposed: {:#?}\"" msgid "This segment should take about 55 minutes. It contains:" msgstr "این بخش باید حدود ۵۵ دقیقه طول بکشد. آن شامل:" -#: src/references.md -msgid "Slices: &\\[T\\]" -msgstr "برش‌ها: `[T]&`" - -#: src/references/shared.md:3 +#: 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 "" "یک مرجع راهی برای دسترسی به مقدار دیگری بدون مسئولیت ارزش فراهم می کند و به " "آن «قرض» نیز می گویند. مراجع مشترک فقط خواندنی هستند و داده های ارجاع شده " "نمی توانند تغییر کنند." -#: src/references/shared.md:20 +#: src/references/shared.md msgid "" "A shared reference to a type `T` has type `&T`. A reference value is made " "with the `&` operator. The `*` operator \"dereferences\" a reference, " @@ -4156,11 +4112,11 @@ msgstr "" "ساخته می شود. عملگر `*` یک مرجع را \"ارجاع مجدد\" می کند و مقدار آن را به " "دست می دهد." -#: src/references/shared.md:24 +#: src/references/shared.md msgid "Rust will statically forbid dangling references:" msgstr "راست بطور استاتیک مراجع تعلیق شده (dangling) را ممنوع می‌کند:" -#: src/references/shared.md:38 +#: src/references/shared.md msgid "" "A reference is said to \"borrow\" the value it refers to, and this is a good " "model for students not familiar with pointers: code can use the reference to " @@ -4172,7 +4128,7 @@ msgstr "" "از مرجع برای دسترسی به مقدار استفاده کند، اما همچنان متعلق به متغیر اصلی " "است. این دوره در روز 3 به جزئیات بیشتری در مورد مالکیت خواهد پرداخت." -#: src/references/shared.md:43 +#: src/references/shared.md msgid "" "References are implemented as pointers, and a key advantage is that they can " "be much smaller than the thing they point to. Students familiar with C or C+" @@ -4186,14 +4142,14 @@ msgstr "" "دوره به این موضوع می‌پردازد که چگونه Rust از اشکالات ایمنی حافظه ناشی از " "استفاده از نشانگرهای خام جلوگیری می‌کند." -#: src/references/shared.md:48 +#: src/references/shared.md msgid "" "Rust does not automatically create references for you - the `&` is always " "required." msgstr "" "Rust به طور خودکار برای شما مراجع ایجاد نمی کند - `&` همیشه مورد نیاز است." -#: src/references/shared.md:51 +#: src/references/shared.md msgid "" "Rust will auto-dereference in some cases, in particular when invoking " "methods (try `r.is_ascii()`). There is no need for an `->` operator like in " @@ -4202,7 +4158,7 @@ msgstr "" "راست در برخی موارد به‌طور خودکار از Dereference می‌کند، به‌ویژه هنگام فراخوانی " "متدها (`ref_x.count_ones()` را امتحان کنید)." -#: src/references/shared.md:54 +#: src/references/shared.md msgid "" "In this example, `r` is mutable so that it can be reassigned (`r = &b`). " "Note that this re-binds `r`, so that it refers to something else. This is " @@ -4214,7 +4170,7 @@ msgstr "" "اشاره می کند. این با C++ متفاوت است، جایی که انتساب به یک مرجع مقدار مرجع را " "تغییر می دهد." -#: src/references/shared.md:58 +#: src/references/shared.md msgid "" "A shared reference does not allow modifying the value it refers to, even if " "that value was mutable. Try `*r = 'X'`." @@ -4222,7 +4178,7 @@ msgstr "" "یک مرجع مشترک اجازه تغییر مقداری را که به آن ارجاع می دهد را نمی دهد، حتی " "اگر آن مقدار قابل تغییر باشد. \"*r = \"X\" را امتحان کنید." -#: src/references/shared.md:61 +#: src/references/shared.md msgid "" "Rust is tracking the lifetimes of all references to ensure they live long " "enough. Dangling references cannot occur in safe Rust. `x_axis` would return " @@ -4234,13 +4190,13 @@ msgstr "" "`x_axis` یک ارجاع به `point` برمی‌گرداند، اما «نقطه» زمانی که تابع برمی‌گردد، " "تخصیص داده می‌شود، بنابراین کامپایل نمی‌شود." -#: src/references/shared.md:66 +#: src/references/shared.md msgid "We will talk more about borrowing when we get to ownership." msgstr "" "هنگامی که به مالکیت در زبان راست رسیدیم، بیشتر در مورد «قرض دادن» صحبت " "خواهیم کرد." -#: src/references/exclusive.md:3 +#: src/references/exclusive.md msgid "" "Exclusive references, also known as mutable references, allow changing the " "value they refer to. They have type `&mut T`." @@ -4248,7 +4204,7 @@ msgstr "" "مراجع انحصاری، همچنین به عنوان مراجع قابل تغییر شناخته می شوند، اجازه می " "دهند مقداری را که به آن ارجاع می دهند تغییر دهند. آنها نوع `mut &T` دارند." -#: src/references/exclusive.md:22 +#: src/references/exclusive.md msgid "" "\"Exclusive\" means that only this reference can be used to access the " "value. No other references (shared or exclusive) can exist at the same time, " @@ -4262,7 +4218,7 @@ msgstr "" "ارجاع‌شده دسترسی داشت. زمانی که `x_coord` زنده است، `&point.0` بسازید یا " "`point.0` را تغییر دهید." -#: src/references/exclusive.md:27 +#: src/references/exclusive.md msgid "" "Be sure to note the difference between `let mut x_coord: &i32` and `let " "x_coord: &mut i32`. The first one represents a shared reference which can be " @@ -4273,25 +4229,21 @@ msgstr "" "کنید. مورد اول یک مرجع مشترک را نشان می دهد که می تواند به مقادیر مختلف متصل " "شود، در حالی که دومی نشان دهنده یک مرجع انحصاری به یک مقدار قابل تغییر است." -#: src/references/slices.md:1 -msgid "Slices" -msgstr "برش‌ها" - -#: src/references/slices.md:3 +#: src/references/slices.md msgid "A slice gives you a view into a larger collection:" msgstr "یک برش به شما امکان می‌دهد نما (view) از یک مجموعه بزرگتر داشته باشید:" -#: src/references/slices.md:18 +#: src/references/slices.md msgid "Slices borrow data from the sliced type." msgstr "برش‌ها داده‌ها را از نوع برش‌شده قرض می‌گیرند." -#: src/references/slices.md:19 +#: src/references/slices.md msgid "Question: What happens if you modify `a[3]` right before printing `s`?" msgstr "" "پرسش: اگر `a[3]` را درست قبل از چاپ `s` تغییر دهید چه اتفاقی می‌افتد؟" -#: src/references/slices.md:24 +#: src/references/slices.md msgid "" "We create a slice by borrowing `a` and specifying the starting and ending " "indexes in brackets." @@ -4299,7 +4251,7 @@ msgstr "" "ما با قرض گرفتن `a` و مشخص کردن شاخص‌های شروع و پایان در " "براکت‌ها، برش (slice) ایجاد می‌کنیم." -#: src/references/slices.md:27 +#: 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 " @@ -4309,7 +4261,7 @@ msgstr "" "کنیم (یعنی عدد صفر را ننویسیم)، به این معنی که `&a[0..a." "len()]` و `&a[..a.len()]` یکسان هستند." -#: src/references/slices.md:31 +#: src/references/slices.md msgid "" "The same is true for the last index, so `&a[2..a.len()]` and `&a[2..]` are " "identical." @@ -4317,14 +4269,14 @@ msgstr "" "در مورد شاخص آخر نیز همینطور است، بنابراین `&a[2..a.len()]` و `&a[2..]` یکسان هستند." -#: src/references/slices.md:34 +#: 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:36 +#: 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 " @@ -4335,7 +4287,7 @@ msgstr "" "ذکر نمی‌شود. این به ما امکان می‌دهد محاسباتی را روی برش‌هایی با اندازه‌های مختلف " "انجام دهیم." -#: src/references/slices.md:40 +#: 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." @@ -4343,7 +4295,7 @@ msgstr "" "برش‌ها همیشه از یک شیء دیگر قرض می‌گیرند. در این مثال، `a` باید حداقل به اندازه طول‌عمر برش ما، زنده (در محدوده) باقی بماند. " -#: src/references/slices.md:43 +#: 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 " @@ -4359,42 +4311,41 @@ msgstr "" "dir=ltr>`println!` کار میکند، زمانی که برش دیگر استفاده نمی شود. " "جزئیات بیشتری در بخش بررسی‌کننده‌قرض (the borrow checker) توضیح خواهیم داد." -#: src/references/strings.md:7 +#: src/references/strings.md msgid "We can now understand the two string types in Rust:" msgstr "حالا می‌توانیم دو نوع رشته‌ای را در راست درک کنیم:" -#: src/references/strings.md:9 +#: src/references/strings.md msgid "`&str` is a slice of UTF-8 encoded bytes, similar to `&[u8]`." msgstr "`str&` تکه‌ای از بایت‌های رمزگذاری‌شده UTF-8، شبیه به `[u8]&` است." -#: src/references/strings.md:10 +#: src/references/strings.md #, fuzzy msgid "" "`String` is an owned buffer of UTF-8 encoded bytes, similar to `Vec`." msgstr "`str&` تکه‌ای از بایت‌های رمزگذاری‌شده UTF-8، شبیه به `[u8]&` است." -#: src/references/strings.md:17 src/std-traits/read-and-write.md:36 +#: src/references/strings.md src/std-traits/read-and-write.md msgid "\"World\"" msgstr "\"World\"" -#: src/references/strings.md:18 +#: src/references/strings.md msgid "\"s1: {s1}\"" msgstr "\"s1: {s1}\"" -#: src/references/strings.md:20 +#: src/references/strings.md msgid "\"Hello \"" msgstr "\"Hello \"" -#: src/references/strings.md:21 src/references/strings.md:23 -#: src/memory-management/move.md:9 +#: src/references/strings.md src/memory-management/move.md msgid "\"s2: {s2}\"" msgstr "\"s2: {s2}\"" -#: src/references/strings.md:26 +#: src/references/strings.md msgid "\"s3: {s3}\"" msgstr "\"s3: {s3}\"" -#: src/references/strings.md:33 +#: src/references/strings.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 " @@ -4405,7 +4356,7 @@ msgstr "" "شده است. لیترال های رشته‌ای `String` (`”Hello”`) در " "باینری برنامه ذخیره می‌شوند." -#: src/references/strings.md:37 +#: src/references/strings.md msgid "" "Rust's `String` type is a wrapper around a vector of bytes. As with a " "`Vec`, it is owned." @@ -4413,7 +4364,7 @@ msgstr "" "در راست نوع ‍`String` یک wrapper بر روی یک بردار از " "بایت‌هاست. مانند `Vec`، یک نوع Owned است." -#: src/references/strings.md:40 +#: 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 " @@ -4424,7 +4375,7 @@ msgstr "" "خالی جدید ایجاد می‌کند که داده های رشته‌ای می‌توانند با استفاده از متدهای `push()` و `push_str()` به آن اضافه شوند." -#: src/references/strings.md:44 +#: 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!()`." @@ -4433,7 +4384,7 @@ msgstr "" "از مقادیر پویا است. مثل فرمت قابل پذیرش توسط ماکرو `println!" "()` است." -#: src/references/strings.md:47 +#: 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 " @@ -4445,7 +4396,7 @@ msgstr "" "وحشت می کند. تکرار کننده `chars` روی کاراکترها تکرار می شود و بر تلاش برای " "درست کردن مرزهای کاراکتر ترجیح داده می شود." -#: src/references/strings.md:52 +#: 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 " @@ -4460,13 +4411,13 @@ msgstr "" "که فقط می‌تواند حاوی بایت‌های رمزشده UTF-8 باشد و هرگز از بهینه‌سازی Small-" "String استفاده نمی کند)." -#: src/references/strings.md:57 +#: src/references/strings.md msgid "Byte strings literals allow you to create a `&[u8]` value directly:" msgstr "" "رشته‌های بایت به شما امکان می‌دهند مستقیماً یک مقدار `&[u8]` ایجاد کنید:" -#: src/references/strings.md:67 +#: 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 " @@ -4477,7 +4428,7 @@ msgstr "" "== \"\\\\n\"`.شما می‌توانید با استفاده از تعداد برابر `#` در دو طرف دابل‌کوت " "دابل‌کوت‌ها، دابل‌کوت‌ها را جاسازی کنید:" -#: src/references/exercise.md:3 +#: 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 " @@ -4486,7 +4437,7 @@ msgstr "" "ما چند توابع کاربردی برای هندسه سه بعدی ایجاد خواهیم کرد که نقطه ای را به " "عنوان `[f64;3]` نشان می دهد. تعیین امضاهای عملکرد به عهده شماست." -#: src/references/exercise.md:7 +#: src/references/exercise.md msgid "" "// Calculate the magnitude of a vector by summing the squares of its " "coordinates\n" @@ -4498,7 +4449,7 @@ msgstr "" "// و سپس جذر آن را بگیرید. از متد `sqrt()` برای محاسبه جذر استفاده کنید، مثل " "`v.sqrt()`.\n" -#: src/references/exercise.md:15 +#: src/references/exercise.md msgid "" "// Normalize a vector by calculating its magnitude and dividing all of its\n" "// coordinates by that magnitude.\n" @@ -4506,27 +4457,27 @@ msgstr "" "// یک بردار را با محاسبه اندازه‌ی آن و تقسیم تمام مختصات آن\n" "// بر آن اندازه، نرمال‌سازی کنید.\n" -#: src/references/exercise.md:23 +#: src/references/exercise.md msgid "// Use the following `main` to test your work.\n" msgstr "// از `main` زیر برای تست کار خود استفاده کنید.\n" -#: src/references/exercise.md:27 src/references/solution.md:22 +#: src/references/exercise.md src/references/solution.md msgid "\"Magnitude of a unit vector: {}\"" msgstr "\"اندازه‌ی یک بردار واحد: {}\"" -#: src/references/exercise.md:30 src/references/solution.md:25 +#: src/references/exercise.md src/references/solution.md msgid "\"Magnitude of {v:?}: {}\"" msgstr "\"اندازه‌ی {v:?}: {}\"" -#: src/references/exercise.md:32 src/references/solution.md:27 +#: src/references/exercise.md src/references/solution.md msgid "\"Magnitude of {v:?} after normalization: {}\"" msgstr "\"اندازه‌ی {v:?} پس از نرمال‌سازی: {}\"" -#: src/references/solution.md:4 +#: src/references/solution.md msgid "/// Calculate the magnitude of the given vector.\n" msgstr "/// اندازه‌ی بردار داده شده را محاسبه کنید.\n" -#: src/references/solution.md:12 +#: src/references/solution.md msgid "" "/// Change the magnitude of the vector to 1.0 without changing its " "direction.\n" @@ -4536,46 +4487,45 @@ msgstr "/// اندازه‌ی بردار را به 1.0 تغییر دهید بد msgid "This segment should take about 50 minutes. It contains:" msgstr "این بخش حدود ۵۰ دقیقه طول خواهد کشید. شامل موارد زیر است:" -#: src/user-defined-types/named-structs.md:3 +#: src/user-defined-types/named-structs.md msgid "Like C and C++, Rust has support for custom structs:" msgstr "‏مانند C و C++، زبان Rust از ساختارهای سفارشی پشتیبانی می‌کند:" -#: src/user-defined-types/named-structs.md:12 +#: src/user-defined-types/named-structs.md msgid "\"{} is {} years old\"" msgstr "‏\"{} {} ساله است\"" -#: src/user-defined-types/named-structs.md:16 -#: src/android/interoperability/with-c/bindgen.md:87 +#: src/user-defined-types/named-structs.md +#: src/android/interoperability/with-c/bindgen.md msgid "\"Peter\"" msgstr "\"پیتر\"" -#: src/user-defined-types/named-structs.md:22 +#: src/user-defined-types/named-structs.md msgid "\"Avery\"" msgstr "\"ایوری\"" -#: src/user-defined-types/named-structs.md:27 +#: src/user-defined-types/named-structs.md msgid "\"Jackie\"" msgstr "\"جکی\"" -#: src/user-defined-types/named-structs.md:35 -#: src/user-defined-types/enums.md:29 src/pattern-matching/match.md:38 -#: src/methods-and-traits/methods.md:69 +#: 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:37 +#: src/user-defined-types/named-structs.md msgid "Structs work like in C or C++." msgstr "‏ساختارها (Structs) در Rust مانند C یا C++ عمل می‌کنند." -#: src/user-defined-types/named-structs.md:38 +#: src/user-defined-types/named-structs.md msgid "Like in C++, and unlike in C, no typedef is needed to define a type." msgstr "‏مانند C++ و برخلاف C، برای تعریف یک نوع نیازی به `typedef` نیست." -#: src/user-defined-types/named-structs.md:39 +#: src/user-defined-types/named-structs.md msgid "Unlike in C++, there is no inheritance between structs." msgstr "‏برخلاف C++، در Rust بین ساختارها ارث‌بری وجود ندارد." -#: src/user-defined-types/named-structs.md:40 +#: src/user-defined-types/named-structs.md msgid "" "This may be a good time to let people know there are different types of " "structs." @@ -4583,7 +4533,7 @@ msgstr "" "این زمان مناسبی است تا به مردمان اطلاع دهیم که انواع مختلفی از ساختارها وجود " "دارد." -#: src/user-defined-types/named-structs.md:42 +#: src/user-defined-types/named-structs.md msgid "" "Zero-sized structs (e.g. `struct Foo;`) might be used when implementing a " "trait on some type but don’t have any data that you want to store in the " @@ -4593,7 +4543,7 @@ msgstr "" "می‌خواهید یک صفت (trait) را بر روی یک نوع پیاده‌سازی کنید، اما داده‌ای ندارید " "که بخواهید در خود مقدار ذخیره کنید." -#: src/user-defined-types/named-structs.md:45 +#: src/user-defined-types/named-structs.md msgid "" "The next slide will introduce Tuple structs, used when the field names are " "not important." @@ -4601,7 +4551,7 @@ msgstr "" "اسلاید بعدی ساختارهای تاپل (Tuple structs) را معرفی خواهد کرد، که زمانی " "استفاده می‌شوند که نام فیلدها مهم نیستند." -#: src/user-defined-types/named-structs.md:47 +#: src/user-defined-types/named-structs.md msgid "" "If you already have variables with the right names, then you can create the " "struct using a shorthand." @@ -4609,7 +4559,7 @@ msgstr "" "اگر از قبل متغیرهایی با نام‌های مناسب دارید، می‌توانید ساختار را با استفاده از " "یک روش میانبر ایجاد کنید." -#: src/user-defined-types/named-structs.md:49 +#: src/user-defined-types/named-structs.md msgid "" "The syntax `..avery` allows us to copy the majority of the fields from the " "old struct without having to explicitly type it all out. It must always be " @@ -4618,69 +4568,68 @@ msgstr "" "سینتکس `..avery` به ما اجازه می‌دهد که اکثر فیلدها را از ساختار قدیمی کپی " "کنیم بدون اینکه همه آن‌ها را صریحاً تایپ کنیم. این باید همیشه آخرین عنصر باشد." -#: src/user-defined-types/tuple-structs.md:7 +#: src/user-defined-types/tuple-structs.md msgid "If the field names are unimportant, you can use a tuple struct:" msgstr "" -#: src/user-defined-types/tuple-structs.md:14 +#: src/user-defined-types/tuple-structs.md msgid "\"({}, {})\"" msgstr "" -#: src/user-defined-types/tuple-structs.md:18 +#: src/user-defined-types/tuple-structs.md msgid "This is often used for single-field wrappers (called newtypes):" msgstr "" -#: src/user-defined-types/tuple-structs.md:25 +#: src/user-defined-types/tuple-structs.md msgid "\"Ask a rocket scientist at NASA\"" msgstr "" -#: src/user-defined-types/tuple-structs.md:29 -#: src/android/interoperability/cpp/cpp-bridge.md:50 -#: src/bare-metal/microcontrollers/type-state.md:14 -#: src/concurrency/async-pitfalls/cancellation.md:99 -#: src/concurrency/async-pitfalls/cancellation.md:103 +#: src/user-defined-types/tuple-structs.md +#: src/android/interoperability/cpp/cpp-bridge.md +#: src/bare-metal/microcontrollers/type-state.md +#: src/concurrency/async-pitfalls/cancellation.md msgid "// ...\n" msgstr "" -#: src/user-defined-types/tuple-structs.md:41 +#: src/user-defined-types/tuple-structs.md msgid "" "Newtypes are a great way to encode additional information about the value in " "a primitive type, for example:" msgstr "" -#: src/user-defined-types/tuple-structs.md:43 +#: src/user-defined-types/tuple-structs.md msgid "The number is measured in some units: `Newtons` in the example above." msgstr "" -#: src/user-defined-types/tuple-structs.md:44 +#: src/user-defined-types/tuple-structs.md msgid "" "The value passed some validation when it was created, so you no longer have " "to validate it again at every use: `PhoneNumber(String)` or `OddNumber(u32)`." msgstr "" -#: src/user-defined-types/tuple-structs.md:47 +#: src/user-defined-types/tuple-structs.md msgid "" "Demonstrate how to add a `f64` value to a `Newtons` type by accessing the " "single field in the newtype." msgstr "" -#: src/user-defined-types/tuple-structs.md:49 +#: src/user-defined-types/tuple-structs.md msgid "" "Rust generally doesn’t like inexplicit things, like automatic unwrapping or " "for instance using booleans as integers." msgstr "" -#: src/user-defined-types/tuple-structs.md:51 +#: src/user-defined-types/tuple-structs.md msgid "Operator overloading is discussed on Day 3 (generics)." msgstr "" -#: src/user-defined-types/tuple-structs.md:52 +#: src/user-defined-types/tuple-structs.md msgid "" "The example is a subtle reference to the [Mars Climate Orbiter](https://en." "wikipedia.org/wiki/Mars_Climate_Orbiter) failure." msgstr "" -#: src/user-defined-types/enums.md:3 +#: src/user-defined-types/enums.md msgid "" "The `enum` keyword allows the creation of a type which has a few different " "variants:" @@ -4688,46 +4637,46 @@ msgstr "" "کلمه کلیدی `enum` اجازه ایجاد نوع داده‌ای را می دهد که دارای چندین گونه مختلف " "است:" -#: src/user-defined-types/enums.md:15 +#: src/user-defined-types/enums.md msgid "// Simple variant\n" msgstr "" -#: src/user-defined-types/enums.md:16 +#: src/user-defined-types/enums.md msgid "// Tuple variant\n" msgstr "" -#: src/user-defined-types/enums.md:17 +#: src/user-defined-types/enums.md msgid "// Struct variant\n" msgstr "" -#: src/user-defined-types/enums.md:22 +#: src/user-defined-types/enums.md msgid "\"On this turn: {:?}\"" msgstr "" -#: src/user-defined-types/enums.md:31 +#: src/user-defined-types/enums.md msgid "Enumerations allow you to collect a set of values under one type." msgstr "" "`Enum`ها به شما امکان می دهند مجموعه‌ای از مقادیر مختلف با نوع‌های مختلف را " "تحت یک نوع جمع آوری کنید." -#: src/user-defined-types/enums.md:32 +#: src/user-defined-types/enums.md msgid "" "`Direction` is a type with variants. There are two values of `Direction`: " "`Direction::Left` and `Direction::Right`." msgstr "" -#: src/user-defined-types/enums.md:34 +#: src/user-defined-types/enums.md msgid "" "`PlayerMove` is a type with three variants. In addition to the payloads, " "Rust will store a discriminant so that it knows at runtime which variant is " "in a `PlayerMove` value." msgstr "" -#: src/user-defined-types/enums.md:37 +#: src/user-defined-types/enums.md msgid "This might be a good time to compare structs and enums:" msgstr "الان زمان خوبی برای مقایسه ساختارها و `Enum`هاست:" -#: src/user-defined-types/enums.md:38 +#: src/user-defined-types/enums.md msgid "" "In both, you can have a simple version without fields (unit struct) or one " "with different types of fields (variant payloads)." @@ -4735,7 +4684,7 @@ msgstr "" "در هر دو، می توانید یک نسخه ساده بدون فیلد (unit struct) یا یکی با انواع " "مختلف فیلد (variant payloads) داشته باشید." -#: src/user-defined-types/enums.md:40 +#: src/user-defined-types/enums.md msgid "" "You could even implement the different variants of an enum with separate " "structs but then they wouldn’t be the same type as they would if they were " @@ -4745,15 +4694,15 @@ msgstr "" "کنید، اما در آن صورت آنها از همان نوعی که در ابتدا تعریف کردید یعنی `Enum` " "نخواهند بود." -#: src/user-defined-types/enums.md:43 +#: src/user-defined-types/enums.md msgid "Rust uses minimal space to store the discriminant." msgstr "" -#: src/user-defined-types/enums.md:44 +#: src/user-defined-types/enums.md msgid "If necessary, it stores an integer of the smallest required size" msgstr "" -#: src/user-defined-types/enums.md:45 +#: src/user-defined-types/enums.md msgid "" "If the allowed variant values do not cover all bit patterns, it will use " "invalid bit patterns to encode the discriminant (the \"niche " @@ -4761,14 +4710,14 @@ msgid "" "integer or `NULL` for the `None` variant." msgstr "" -#: src/user-defined-types/enums.md:49 +#: src/user-defined-types/enums.md msgid "" "You can control the discriminant if needed (e.g., for compatibility with C):" msgstr "" "شما می توانید در صورت نیاز (به عنوان مثال، برای سازگاری با C) discriminant " "را کنترل کنید:" -#: src/user-defined-types/enums.md:67 +#: src/user-defined-types/enums.md msgid "" "Without `repr`, the discriminant type takes 2 bytes, because 10001 fits 2 " "bytes." @@ -4776,14 +4725,14 @@ msgstr "" "بدون `repr`، نوع discriminant دو بایت حافظه اشغال میکند، زیرا 10001 در 2 " "بایت جا می‌شود." -#: src/user-defined-types/enums.md:70 src/user-defined-types/static.md:27 -#: src/memory-management/review.md:51 src/memory-management/move.md:100 -#: src/memory-management/copy-types.md:57 src/smart-pointers/box.md:85 -#: src/borrowing/shared.md:33 src/error-handling/result.md:46 +#: src/user-defined-types/enums.md src/user-defined-types/static.md +#: src/memory-management/review.md src/memory-management/move.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 "برای کاوش بیشتر" -#: src/user-defined-types/enums.md:72 +#: src/user-defined-types/enums.md msgid "" "Rust has several optimizations it can employ to make enums take up less " "space." @@ -4791,7 +4740,7 @@ msgstr "" "زبان Rust دارای چندین بهینه‌سازی دارد که می‌تواند برای کاهش فضای اشغال شده " "توسط`Enum`ها استفاده کند." -#: src/user-defined-types/enums.md:74 +#: src/user-defined-types/enums.md msgid "" "Null pointer optimization: For [some types](https://doc.rust-lang.org/std/" "option/#representation), Rust guarantees that `size_of::()` equals " @@ -4801,7 +4750,7 @@ msgstr "" "dir=ltr>`size_of::()` برابر با `size_of::" ">()` است." -#: src/user-defined-types/enums.md:78 +#: src/user-defined-types/enums.md msgid "" "Example code if you want to show how the bitwise representation _may_ look " "like in practice. It's important to note that the compiler provides no " @@ -4811,11 +4760,57 @@ msgstr "" "به نظر برسد. مهم است توجه داشته باشید که کامپایلر هیچ تضمینی در مورد این " "نمایش نمی‌دهد، بنابراین این کاملاً ناایمن است." -#: src/user-defined-types/static.md:1 +#: src/user-defined-types/const.md +msgid "`const`" +msgstr "" + +#: src/user-defined-types/const.md +#, fuzzy +msgid "" +"Constants are evaluated at compile time and their values are inlined " +"wherever they are used:" +msgstr "" +"متغیرهای ثابت در زمان کامپایل ارزیابی می شوند و مقادیر آنها در هر جایی که " +"استفاده می شوند، درج می شوند:" + +#: 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." +msgstr "" +"طبق [کتاب Rust RFC](https://rust-lang.github.io/rfcs/0246-const-vs-static." +"html)، این موارد هنگام استفاده درج می شوند." + +#: 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." +msgstr "" +"فقط توابعی که با `const` علامت گذاری شده اند می توانند در زمان کامپایل برای " +"تولید مقادیر `const` فراخوانی شوند. با این حال، توابع `const` را می توان در " +"زمان اجرا فراخوانی کرد (بر خلاف تعریف متغییری ثابت)" + +#: src/user-defined-types/const.md +#, fuzzy +msgid "Mention that `const` behaves semantically similar to C++'s `constexpr`" +msgstr "" +"به این نکته اشاره کنید که `const` شبیه `constexpr` در `C++` عمل می کند." + +#: 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 "" +"با اینکه خیلی رایج نیست که اگر کسی به یک یک مقدار ثابت که در زمان اجرا " +"ارزیابی می‌شود از `const` استفاده کند اما مفید تر و ایمن تر از استفاده " +"`static`ها هستند." + +#: src/user-defined-types/static.md msgid "`static`" msgstr "" -#: src/user-defined-types/static.md:3 +#: src/user-defined-types/static.md msgid "" "Static variables will live during the whole execution of the program, and " "therefore will not move:" @@ -4823,16 +4818,16 @@ msgstr "" "متغیرهای ایستا در طول عمر کل اجرای برنامه خواهند ماند و بنابراین منتقل " "نمی‌شوند:" -#: src/user-defined-types/static.md:7 +#: src/user-defined-types/static.md #, fuzzy msgid "\"Welcome to RustOS 3.14\"" msgstr "به روز ۱ خوش آمدید" -#: src/user-defined-types/static.md:10 +#: src/user-defined-types/static.md msgid "\"{BANNER}\"" msgstr "" -#: src/user-defined-types/static.md:14 +#: src/user-defined-types/static.md #, fuzzy msgid "" "As noted in the [Rust RFC Book](https://rust-lang.github.io/rfcs/0246-const-" @@ -4848,14 +4843,14 @@ msgstr "" "اجرای برنامه زنده می ماند. هنگامی که یک مقدار با اسکوپ گلوبال نیاز نیست, " "استفاده از `const` ترجیح داده می‌شود." -#: src/user-defined-types/static.md:23 +#: src/user-defined-types/static.md #, fuzzy msgid "`static` is similar to mutable global variables in C++." msgstr "" "از سوی دیگر، `static` بسیار شبیه به یک متغیر سراسری `const` یا `mutable` در " "`C++` هستند." -#: src/user-defined-types/static.md:24 +#: 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`." @@ -4863,7 +4858,7 @@ msgstr "" "`static` هویت شی را فراهم می‌کند: آدرسی در حافظه و حالتی که توسط انواع با " "تغییرپذیری داخلی مانند `Mutex` را نیاز دارد." -#: src/user-defined-types/static.md:29 +#: src/user-defined-types/static.md #, fuzzy msgid "" "Because `static` variables are accessible from any thread, they must be " @@ -4878,74 +4873,28 @@ msgstr "" "دارد. ما در فصل Unsafe Rust به استاتیک های قابل تغییر [mutable statics](../" "unsafe/mutable-static-variables.md) نگاه خواهیم کرد." -#: src/user-defined-types/static.md:34 +#: src/user-defined-types/static.md #, fuzzy msgid "Thread-local data can be created with the macro `std::thread_local`." msgstr "" "داده‌های `thread_local` را با ماکروی `std::thread_local` " "می‌توان ایجاد کرد." -#: src/user-defined-types/const.md:1 -msgid "`const`" -msgstr "" - -#: src/user-defined-types/const.md:3 -#, fuzzy -msgid "" -"Constants are evaluated at compile time and their values are inlined " -"wherever they are used:" -msgstr "" -"متغیرهای ثابت در زمان کامپایل ارزیابی می شوند و مقادیر آنها در هر جایی که " -"استفاده می شوند، درج می شوند:" - -#: src/user-defined-types/const.md:26 -msgid "" -"According to the [Rust RFC Book](https://rust-lang.github.io/rfcs/0246-const-" -"vs-static.html) these are inlined upon use." -msgstr "" -"طبق [کتاب Rust RFC](https://rust-lang.github.io/rfcs/0246-const-vs-static." -"html)، این موارد هنگام استفاده درج می شوند." - -#: src/user-defined-types/const.md:28 -msgid "" -"Only functions marked `const` can be called at compile time to generate " -"`const` values. `const` functions can however be called at runtime." -msgstr "" -"فقط توابعی که با `const` علامت گذاری شده اند می توانند در زمان کامپایل برای " -"تولید مقادیر `const` فراخوانی شوند. با این حال، توابع `const` را می توان در " -"زمان اجرا فراخوانی کرد (بر خلاف تعریف متغییری ثابت)" - -#: src/user-defined-types/const.md:33 -#, fuzzy -msgid "Mention that `const` behaves semantically similar to C++'s `constexpr`" -msgstr "" -"به این نکته اشاره کنید که `const` شبیه `constexpr` در `C++` عمل می کند." - -#: src/user-defined-types/const.md:34 -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 "" -"با اینکه خیلی رایج نیست که اگر کسی به یک یک مقدار ثابت که در زمان اجرا " -"ارزیابی می‌شود از `const` استفاده کند اما مفید تر و ایمن تر از استفاده " -"`static`ها هستند." - -#: src/user-defined-types/aliases.md:3 +#: src/user-defined-types/aliases.md msgid "" "A type alias creates a name for another type. The two types can be used " "interchangeably." msgstr "" -#: src/user-defined-types/aliases.md:13 +#: src/user-defined-types/aliases.md msgid "// Aliases are more useful with long, complex types:\n" msgstr "" -#: src/user-defined-types/aliases.md:23 +#: src/user-defined-types/aliases.md msgid "C programmers will recognize this as similar to a `typedef`." msgstr "" -#: src/user-defined-types/exercise.md:3 +#: src/user-defined-types/exercise.md msgid "" "We will create a data structure to represent an event in an elevator control " "system. It is up to you to define the types and functions to construct " @@ -4953,101 +4902,101 @@ msgid "" "with `{:?}`." msgstr "" -#: src/user-defined-types/exercise.md:7 +#: src/user-defined-types/exercise.md msgid "" "This exercise only requires creating and populating data structures so that " "`main` runs without errors. The next part of the course will cover getting " "data out of these structures." msgstr "" -#: src/user-defined-types/exercise.md:12 src/user-defined-types/solution.md:4 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "" "/// An event in the elevator system that the controller must react to.\n" msgstr "" -#: src/user-defined-types/exercise.md:15 +#: src/user-defined-types/exercise.md msgid "// TODO: add required variants\n" msgstr "" -#: src/user-defined-types/exercise.md:17 src/user-defined-types/solution.md:22 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "/// A direction of travel.\n" msgstr "" -#: src/user-defined-types/exercise.md:24 src/user-defined-types/solution.md:39 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "/// The car has arrived on the given floor.\n" msgstr "" -#: src/user-defined-types/exercise.md:29 src/user-defined-types/solution.md:44 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "/// The car doors have opened.\n" msgstr "" -#: src/user-defined-types/exercise.md:34 src/user-defined-types/solution.md:49 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "/// The car doors have closed.\n" msgstr "" -#: src/user-defined-types/exercise.md:39 src/user-defined-types/solution.md:54 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "" "/// A directional button was pressed in an elevator lobby on the given " "floor.\n" msgstr "" -#: src/user-defined-types/exercise.md:44 src/user-defined-types/solution.md:59 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "/// A floor button was pressed in the elevator car.\n" msgstr "" -#: src/user-defined-types/exercise.md:52 src/user-defined-types/solution.md:67 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "\"A ground floor passenger has pressed the up button: {:?}\"" msgstr "" -#: src/user-defined-types/exercise.md:55 src/user-defined-types/solution.md:70 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "\"The car has arrived on the ground floor: {:?}\"" msgstr "" -#: src/user-defined-types/exercise.md:56 src/user-defined-types/solution.md:71 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "\"The car door opened: {:?}\"" msgstr "" -#: src/user-defined-types/exercise.md:58 src/user-defined-types/solution.md:73 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "\"A passenger has pressed the 3rd floor button: {:?}\"" msgstr "" -#: src/user-defined-types/exercise.md:61 src/user-defined-types/solution.md:76 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "\"The car door closed: {:?}\"" msgstr "" -#: src/user-defined-types/exercise.md:62 src/user-defined-types/solution.md:77 +#: src/user-defined-types/exercise.md src/user-defined-types/solution.md msgid "\"The car has arrived on the 3rd floor: {:?}\"" msgstr "" -#: src/user-defined-types/solution.md:7 +#: src/user-defined-types/solution.md msgid "/// A button was pressed.\n" msgstr "" -#: src/user-defined-types/solution.md:10 +#: src/user-defined-types/solution.md msgid "/// The car has arrived at the given floor.\n" msgstr "" -#: src/user-defined-types/solution.md:13 +#: src/user-defined-types/solution.md msgid "/// The car's doors have opened.\n" msgstr "" -#: src/user-defined-types/solution.md:16 +#: src/user-defined-types/solution.md msgid "/// The car's doors have closed.\n" msgstr "" -#: src/user-defined-types/solution.md:19 +#: src/user-defined-types/solution.md msgid "/// A floor is represented as an integer.\n" msgstr "" -#: src/user-defined-types/solution.md:29 +#: src/user-defined-types/solution.md msgid "/// A user-accessible button.\n" msgstr "" -#: src/user-defined-types/solution.md:33 +#: src/user-defined-types/solution.md msgid "/// A button in the elevator lobby on the given floor.\n" msgstr "" -#: src/user-defined-types/solution.md:36 +#: src/user-defined-types/solution.md msgid "/// A floor button within the car.\n" msgstr "" @@ -5098,7 +5047,7 @@ msgstr "" msgid "This segment should take about 1 hour. It contains:" msgstr "این بخش باید حدود ۱ ساعت طول بکشد. این شامل:" -#: src/pattern-matching/match.md:3 +#: src/pattern-matching/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." @@ -5106,72 +5055,67 @@ msgstr "" "کلمه کلیدی `match` به شما اجازه می‌دهد یک مقدار را با یک یا چند _الگو_ مطابقت " "دهید. مقایسه‌ها از بالا به پایین انجام می‌شوند و اولین تطابق انتخاب می‌شود." -#: src/pattern-matching/match.md:6 +#: src/pattern-matching/match.md msgid "The patterns can be simple values, similarly to `switch` in C and C++:" msgstr "الگوها می توانند مقادیر ساده ای باشند، شبیه به `switch` در C و ++C:" -#: src/pattern-matching/match.md:11 +#: src/pattern-matching/match.md msgid "'x'" msgstr "" -#: src/pattern-matching/match.md:13 +#: src/pattern-matching/match.md msgid "'q'" msgstr "" -#: src/pattern-matching/match.md:13 +#: src/pattern-matching/match.md msgid "\"Quitting\"" msgstr "" -#: src/pattern-matching/match.md:14 src/generics/exercise.md:15 -#: src/generics/solution.md:17 src/std-traits/solution.md:16 -#: src/error-handling/exercise.md:60 src/error-handling/exercise.md:75 -#: src/error-handling/solution.md:60 src/error-handling/solution.md:75 +#: 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 "" -#: src/pattern-matching/match.md:14 +#: src/pattern-matching/match.md msgid "'s'" msgstr "" -#: src/pattern-matching/match.md:14 +#: src/pattern-matching/match.md msgid "'w'" msgstr "" -#: src/pattern-matching/match.md:14 +#: src/pattern-matching/match.md msgid "'d'" msgstr "" -#: src/pattern-matching/match.md:14 +#: src/pattern-matching/match.md msgid "\"Moving around\"" msgstr "" -#: src/pattern-matching/match.md:15 src/error-handling/exercise.md:51 -#: src/error-handling/exercise.md:60 src/error-handling/exercise.md:74 -#: src/error-handling/solution.md:51 src/error-handling/solution.md:60 -#: src/error-handling/solution.md:74 +#: src/pattern-matching/match.md src/error-handling/exercise.md +#: src/error-handling/solution.md msgid "'0'" msgstr "" -#: src/pattern-matching/match.md:15 src/error-handling/exercise.md:51 -#: src/error-handling/exercise.md:60 src/error-handling/exercise.md:74 -#: src/error-handling/solution.md:51 src/error-handling/solution.md:60 -#: src/error-handling/solution.md:74 +#: src/pattern-matching/match.md src/error-handling/exercise.md +#: src/error-handling/solution.md msgid "'9'" msgstr "" -#: src/pattern-matching/match.md:15 +#: src/pattern-matching/match.md msgid "\"Number input\"" msgstr "" -#: src/pattern-matching/match.md:16 +#: src/pattern-matching/match.md msgid "\"Lowercase: {key}\"" msgstr "" -#: src/pattern-matching/match.md:17 +#: src/pattern-matching/match.md msgid "\"Something else\"" msgstr "" -#: src/pattern-matching/match.md:22 +#: src/pattern-matching/match.md msgid "" "The `_` pattern is a wildcard pattern which matches any value. The " "expressions _must_ be exhaustive, meaning that it covers every possibility, " @@ -5181,7 +5125,7 @@ msgstr "" "باید جامع باشند، به این معنی که همه احتمالات را پوشش دهند، بنابراین `_` اغلب " "به عنوان آخرین حالت برای پوشش تمامی موارد استفاده می‌شود." -#: src/pattern-matching/match.md:26 +#: 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 " @@ -5191,7 +5135,7 @@ msgstr "" "match باید از یک تایپ باشد. تایپ بازگشتی، تایپ آخرین عبارت در بلاک است، اگر " "وجود داشته باشد. در مثال بالا، تایپ بازگشتی `()` است." -#: src/pattern-matching/match.md:30 +#: 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." @@ -5199,37 +5143,37 @@ msgstr "" "یک متغیر در الگو (`key` در این مثال) یک اتصال ایجاد می‌کند که می‌توان از آن در " "بخش مطابقت استفاده کرد." -#: src/pattern-matching/match.md:33 +#: src/pattern-matching/match.md msgid "A match guard causes the arm to match only if the condition is true." msgstr "" "یک guard در عبارت `match` باعث می‌شود که آن شاخه تنها در صورتی مطابقت داشته " "باشد که شرط برقرار باشد." -#: src/pattern-matching/match.md:40 +#: 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:42 +#: src/pattern-matching/match.md msgid "`|` as an `or`" msgstr "`|` به عنوان `or`" -#: src/pattern-matching/match.md:43 +#: src/pattern-matching/match.md msgid "`..` can expand as much as it needs to be" msgstr "`..` برای تعیین همه محدوده یا تا جایی که میتوان گسترش یابد" -#: src/pattern-matching/match.md:44 +#: src/pattern-matching/match.md msgid "`1..=5` represents an inclusive range" msgstr "" "1..=5 نمایانگر یک محدوده خاص است" -#: src/pattern-matching/match.md:45 +#: src/pattern-matching/match.md msgid "`_` is a wild card" msgstr "`_` نمایانگر هر حالتی است" -#: src/pattern-matching/match.md:47 +#: 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 " @@ -5238,7 +5182,7 @@ msgstr "" "guard های تطبیق به عنوان یک ویژگی سینتکس جداگانه دسته بندی می‌شوند, زمانی مهم " "و ضروری هستند که بخواهیم ایده های پیچیده تر از الگوهای ساده بیان کنیم." -#: src/pattern-matching/match.md:49 +#: 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 " @@ -5250,41 +5194,41 @@ msgstr "" "اون شاخه خاص صدا زده میشود. اگر شرط `if` برقرار نباشد کاری به سایر شاخه های " "عبارت `match` اصلی ندارد." -#: src/pattern-matching/match.md:53 +#: src/pattern-matching/match.md msgid "" "The condition defined in the guard applies to every expression in a pattern " "with an `|`." msgstr "شرط تعریف شده در guard با کمک `|` به شرط های تطبیق الگو اضافه می‌شود." -#: src/pattern-matching/destructuring-structs.md:1 +#: src/pattern-matching/destructuring-structs.md msgid "Structs" msgstr "ساختارها" -#: src/pattern-matching/destructuring-structs.md:3 +#: src/pattern-matching/destructuring-structs.md msgid "Like tuples, Struct can also be destructured by matching:" msgstr "مانند tuple ها، ساختار را نیز می توان با تطبیق تخریب کرد:" -#: src/pattern-matching/destructuring-structs.md:15 +#: src/pattern-matching/destructuring-structs.md msgid "\"x.0 = 1, b = {b}, y = {y}\"" msgstr "" -#: src/pattern-matching/destructuring-structs.md:16 +#: src/pattern-matching/destructuring-structs.md msgid "\"y = 2, x = {i:?}\"" msgstr "" -#: src/pattern-matching/destructuring-structs.md:17 +#: src/pattern-matching/destructuring-structs.md msgid "\"y = {y}, other fields were ignored\"" msgstr "" -#: src/pattern-matching/destructuring-structs.md:25 +#: 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:26 +#: 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:27 +#: 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 " @@ -5294,11 +5238,11 @@ msgstr "" "‍`2` را در شاخه دوم به یک متغیر تغییر دهید و خواهید دید که کار نمی‌کند. آن را " "به یک `const` تغییر دهید و خواهید دید که دوباره کار می‌کند." -#: src/pattern-matching/destructuring-enums.md:3 +#: src/pattern-matching/destructuring-enums.md msgid "Like tuples, enums can also be destructured by matching:" msgstr "مانند tuple ها، enum ها را نیز می توان با تطبیق تخریب کرد:" -#: src/pattern-matching/destructuring-enums.md:5 +#: 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 " @@ -5308,19 +5252,19 @@ msgstr "" "استفاده شوند. این روش به شما اجازه می‌دهد ساختار انواع خود را بررسی کنید. " "بیایید با یک نوع ساده `enum` شروع کنیم:" -#: src/pattern-matching/destructuring-enums.md:18 +#: src/pattern-matching/destructuring-enums.md msgid "\"cannot divide {n} into two equal parts\"" msgstr "" -#: src/pattern-matching/destructuring-enums.md:25 +#: src/pattern-matching/destructuring-enums.md msgid "\"{n} divided in two is {half}\"" msgstr "" -#: src/pattern-matching/destructuring-enums.md:26 +#: src/pattern-matching/destructuring-enums.md msgid "\"sorry, an error happened: {msg}\"" msgstr "" -#: src/pattern-matching/destructuring-enums.md:31 +#: 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 " @@ -5330,7 +5274,7 @@ msgstr "" "`half` به مقداری که درون حالت `Ok` قرار دارد متصل شده است. در شاخه‌ی دوم، " "`msg` به پیام خطا متصل شده است." -#: src/pattern-matching/destructuring-enums.md:38 +#: src/pattern-matching/destructuring-enums.md msgid "" "The `if`/`else` expression is returning an enum that is later unpacked with " "a `match`." @@ -5338,7 +5282,7 @@ msgstr "" "عبارت `if`/`else` یک نوع enum بازمی‌گرداند که بعداً با استفاده از `match` از " "هم باز می‌شود." -#: src/pattern-matching/destructuring-enums.md:40 +#: 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 " @@ -5348,13 +5292,13 @@ msgstr "" "خطاها هنگام اجرای کد، را تست کنید. مکان هایی را که کد شما اکنون ناقص است و " "نحوه تلاش کامپایلر برای ارائه نکاتی به شما را نشان دهید." -#: src/pattern-matching/destructuring-enums.md:43 +#: src/pattern-matching/destructuring-enums.md msgid "" "The values in the enum variants can only be accessed after being pattern " "matched." msgstr "مقادیر در حالات enum تنها پس از تطبیق الگو قابل دسترسی هستند." -#: src/pattern-matching/destructuring-enums.md:45 +#: 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." @@ -5363,7 +5307,7 @@ msgstr "" "کامپایلر Rust فراهم می‌کند، اشاره کنید که تأیید می‌کند همه حالات پوشش داده " "شده‌اند." -#: src/pattern-matching/destructuring-enums.md:47 +#: 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 " @@ -5381,7 +5325,7 @@ msgstr "" "اگر می‌خواهید از نسخه‌های قدیمی‌تر Rust پشتیبانی کنید، به جای `msg` از `ref " "msg` در الگو استفاده کنید." -#: src/pattern-matching/let-control-flow.md:3 +#: src/pattern-matching/let-control-flow.md msgid "" "Rust has a few control flow constructs which differ from other languages. " "They are used for pattern matching:" @@ -5389,21 +5333,19 @@ msgstr "" "زبان Rust چند ساختار کنترل جریان دارد که با سایر زبان‌ها متفاوت است. این " "ساختارها برای مطابقت الگو استفاده می‌شوند:" -#: src/pattern-matching/let-control-flow.md:6 -#: src/pattern-matching/let-control-flow.md:10 +#: src/pattern-matching/let-control-flow.md msgid "`if let` expressions" msgstr "عبارت `if let`" -#: src/pattern-matching/let-control-flow.md:7 -#: src/pattern-matching/let-control-flow.md:32 +#: src/pattern-matching/let-control-flow.md msgid "`let else` expressions" msgstr "عبارت `let else`" -#: src/pattern-matching/let-control-flow.md:8 +#: src/pattern-matching/let-control-flow.md msgid "`while let` expressions" msgstr "عبارت `while let`" -#: src/pattern-matching/let-control-flow.md:12 +#: src/pattern-matching/let-control-flow.md msgid "" "The [`if let` expression](https://doc.rust-lang.org/reference/expressions/if-" "expr.html#if-let-expressions) lets you execute different code depending on " @@ -5413,11 +5355,11 @@ msgstr "" "html#if-let-expressions) به شما امکان می‌دهد بسته به اینکه آیا یک مقدار با " "یک الگو مطابقت دارد، کدهای مختلفی را اجرا کنید:" -#: src/pattern-matching/let-control-flow.md:22 +#: src/pattern-matching/let-control-flow.md msgid "\"slept for {:?}\"" msgstr "" -#: src/pattern-matching/let-control-flow.md:34 +#: src/pattern-matching/let-control-flow.md msgid "" "For the common case of matching a pattern and returning from the function, " "use [`let else`](https://doc.rust-lang.org/rust-by-example/flow_control/" @@ -5429,34 +5371,29 @@ msgstr "" "در اینجا، حالت \"else\" باید منحرف شود (مانند `return`، `break`، یا `panic` " "- به غیر از اینکه از انتهای بلوک خارج شود)." -#: src/pattern-matching/let-control-flow.md:44 -#: src/pattern-matching/let-control-flow.md:107 -msgid "\"got None\"" +#: src/pattern-matching/let-control-flow.md +msgid "\"not a hex digit\"" msgstr "" -#: src/pattern-matching/let-control-flow.md:50 -#: src/pattern-matching/let-control-flow.md:111 +#: src/pattern-matching/let-control-flow.md msgid "\"got empty string\"" msgstr "" -#: src/pattern-matching/let-control-flow.md:56 -#: src/pattern-matching/let-control-flow.md:115 -msgid "\"not a hex digit\"" +#: src/pattern-matching/let-control-flow.md +msgid "\"got None\"" msgstr "" -#: src/pattern-matching/let-control-flow.md:61 -#: src/pattern-matching/solution.md:113 +#: src/pattern-matching/let-control-flow.md src/pattern-matching/solution.md msgid "\"result: {:?}\"" msgstr "" -#: src/pattern-matching/let-control-flow.md:61 src/generics/trait-bounds.md:16 -#: src/smart-pointers/solution.md:87 src/smart-pointers/solution.md:90 -#: src/testing/solution.md:83 src/android/testing.md -#: src/android/testing/googletest.md:11 src/android/testing/googletest.md:12 +#: src/pattern-matching/let-control-flow.md src/generics/trait-bounds.md +#: src/smart-pointers/solution.md src/testing/solution.md +#: src/android/testing.md src/android/testing/googletest.md msgid "\"foo\"" msgstr "" -#: src/pattern-matching/let-control-flow.md:65 +#: src/pattern-matching/let-control-flow.md msgid "" "Like with `if let`, there is a [`while let`](https://doc.rust-lang.org/" "reference/expressions/loop-expr.html#predicate-pattern-loops) variant which " @@ -5466,7 +5403,7 @@ msgstr "" "expressions/loop-expr.html#predicate-pattern-loops) وجود دارد که مقادیر " "مقابل الگو به طور مکرر (تکرار شونده‌ای) بررسی می‌کند:" -#: src/pattern-matching/let-control-flow.md:81 +#: src/pattern-matching/let-control-flow.md msgid "" "Here [`String::pop`](https://doc.rust-lang.org/stable/std/string/struct." "String.html#method.pop) returns `Some(c)` until the string is empty, after " @@ -5478,11 +5415,11 @@ msgstr "" "برمی‌گرداند و پس از آن `None` را باز می‌گرداند. استفاده از `while let` به ما " "این امکان را می‌دهد که به طور مداوم از میان همه موارد عبور کنیم." -#: src/pattern-matching/let-control-flow.md:89 +#: src/pattern-matching/let-control-flow.md msgid "if-let" msgstr "if-let" -#: src/pattern-matching/let-control-flow.md:91 +#: src/pattern-matching/let-control-flow.md msgid "" "Unlike `match`, `if let` does not have to cover all branches. This can make " "it more concise than `match`." @@ -5491,24 +5428,24 @@ msgstr "" "پشتیبانی نمیکند. اگر می‌خواهید همه حالت را پوشش دهید از دستور `match` استفاده " "کنید." -#: src/pattern-matching/let-control-flow.md:93 +#: src/pattern-matching/let-control-flow.md msgid "A common usage is handling `Some` values when working with `Option`." msgstr "" "یک استفاده رایج از دستور `if let`، رسیدگی به مقادیر `Some` هنگام کار با " "`Option` است:" -#: src/pattern-matching/let-control-flow.md:94 +#: src/pattern-matching/let-control-flow.md msgid "" "Unlike `match`, `if let` does not support guard clauses for pattern matching." msgstr "" "برخلاف دستور `match` دستور `if let` از `=>` برای تطبیق " "الگو استفاده نمیکند." -#: src/pattern-matching/let-control-flow.md:96 +#: src/pattern-matching/let-control-flow.md msgid "let-else" msgstr "let-else" -#: src/pattern-matching/let-control-flow.md:98 +#: src/pattern-matching/let-control-flow.md msgid "" "`if-let`s can pile up, as shown. The `let-else` construct supports " "flattening this nested code. Rewrite the awkward version for students, so " @@ -5519,15 +5456,15 @@ msgstr "" "می‌کند. نسخه‌ی پیچیده را برای دانش‌آموزان بازنویسی کنید تا بتوانند تبدیل آن را " "مشاهده کنند." -#: src/pattern-matching/let-control-flow.md:102 +#: src/pattern-matching/let-control-flow.md msgid "The rewritten version is:" msgstr "نسخه‌ی بازنویسی شده به صورت زیر است:" -#: src/pattern-matching/let-control-flow.md:122 +#: src/pattern-matching/let-control-flow.md msgid "while-let" msgstr "while-let" -#: src/pattern-matching/let-control-flow.md:124 +#: src/pattern-matching/let-control-flow.md msgid "" "Point out that the `while let` loop will keep going as long as the value " "matches the pattern." @@ -5535,7 +5472,7 @@ msgstr "" "توجه داشته باشید که حلقه `while let` تا زمانی که مقادیر مقابل الگو طبیق " "داشته باشد (شرط برقرار باشد)، ادامه خواهد داشت." -#: src/pattern-matching/let-control-flow.md:126 +#: src/pattern-matching/let-control-flow.md msgid "" "You could rewrite the `while let` loop as an infinite loop with an if " "statement that breaks when there is no value to unwrap for `name.pop()`. The " @@ -5546,11 +5483,11 @@ msgstr "" "pop`، شکسته می‌شود. `while let` یک Syntactic sugar برای این سناریو ارائه " "می‌دهد." -#: src/pattern-matching/exercise.md:3 +#: src/pattern-matching/exercise.md msgid "Let's write a simple recursive evaluator for arithmetic expressions." msgstr "بیایید یک ارزیاب ساده بازگشتی برای عبارات حسابی بنویسیم." -#: src/pattern-matching/exercise.md:5 +#: src/pattern-matching/exercise.md msgid "" "The `Box` type here is a smart pointer, and will be covered in detail later " "in the course. An expression can be \"boxed\" with `Box::new` as seen in the " @@ -5562,7 +5499,7 @@ msgstr "" "شود، همان‌طور که در تست‌ها مشاهده می‌شود. برای ارزیابی یک عبارت باکس‌شده، از " "عملگر deref (`*`) برای \"باز کردن باکس\" استفاده کنید: `eval(*boxed_expr)`." -#: src/pattern-matching/exercise.md:10 +#: src/pattern-matching/exercise.md msgid "" "Some expressions cannot be evaluated and will return an error. The standard " "[`Result`](https://doc.rust-lang.org/std/result/enum.Result." @@ -5575,7 +5512,7 @@ msgstr "" "html) یک enum است که یا نمایانگر یک مقدار موفقیت‌آمیز (`Ok(Value)`) یا یک خطا " "(`Err(String)`) است. ما این نوع را به‌طور مفصل‌تر در آینده پوشش خواهیم داد." -#: src/pattern-matching/exercise.md:15 +#: src/pattern-matching/exercise.md msgid "" "Copy and paste the code into the Rust playground, and begin implementing " "`eval`. The final product should pass the tests. It may be helpful to use " @@ -5587,7 +5524,7 @@ msgstr "" "گذراندن تست‌ها به صورت تک به تک مفید باشد. همچنین می‌توانید به طور موقت یک تست " "را با استفاده از `[ignore]#` نادیده بگیرید:" -#: src/pattern-matching/exercise.md:26 +#: src/pattern-matching/exercise.md msgid "" "If you finish early, try writing a test that results in division by zero or " "integer overflow. How could you handle this with `Result` instead of a panic?" @@ -5596,32 +5533,31 @@ msgstr "" "سرریز عدد صحیح شود. چگونه می‌توانید این را با استفاده از `Result` به جای " "panic مدیریت کنید؟" -#: src/pattern-matching/exercise.md:30 src/pattern-matching/solution.md:4 +#: src/pattern-matching/exercise.md src/pattern-matching/solution.md msgid "/// An operation to perform on two subexpressions.\n" msgstr "" -#: src/pattern-matching/exercise.md:38 src/pattern-matching/solution.md:12 +#: src/pattern-matching/exercise.md src/pattern-matching/solution.md msgid "/// An expression, in tree form.\n" msgstr "" -#: src/pattern-matching/exercise.md:42 src/pattern-matching/solution.md:16 +#: src/pattern-matching/exercise.md src/pattern-matching/solution.md msgid "/// An operation on two subexpressions.\n" msgstr "" -#: src/pattern-matching/exercise.md:45 src/pattern-matching/solution.md:19 +#: src/pattern-matching/exercise.md src/pattern-matching/solution.md msgid "/// A literal value\n" msgstr "" -#: src/pattern-matching/exercise.md:104 src/pattern-matching/solution.md:40 -#: src/pattern-matching/solution.md:102 +#: src/pattern-matching/exercise.md src/pattern-matching/solution.md msgid "\"division by zero\"" msgstr "" -#: src/pattern-matching/solution.md:112 +#: src/pattern-matching/solution.md msgid "\"expr: {:?}\"" msgstr "" -#: src/methods-and-traits/methods.md:3 +#: src/methods-and-traits/methods.md msgid "" "Rust allows you to associate functions with your new types. You do this with " "an `impl` block:" @@ -5629,43 +5565,43 @@ msgstr "" "Rust به شما این امکان را می‌دهد که توابعی را با تایپ جدید خود مرتبط کنید. این " "کار را با استفاده از بلوک `impl` انجام می‌دهید:" -#: src/methods-and-traits/methods.md:14 +#: src/methods-and-traits/methods.md msgid "// No receiver, a static method\n" msgstr "" -#: src/methods-and-traits/methods.md:19 +#: src/methods-and-traits/methods.md msgid "// Exclusive borrowed read-write access to self\n" msgstr "" -#: src/methods-and-traits/methods.md:24 +#: src/methods-and-traits/methods.md msgid "// Shared and read-only borrowed access to self\n" msgstr "" -#: src/methods-and-traits/methods.md:26 +#: src/methods-and-traits/methods.md msgid "\"Recorded {} laps for {}:\"" msgstr "" -#: src/methods-and-traits/methods.md:28 +#: src/methods-and-traits/methods.md msgid "\"Lap {idx}: {lap} sec\"" msgstr "" -#: src/methods-and-traits/methods.md:32 +#: src/methods-and-traits/methods.md msgid "// Exclusive ownership of self\n" msgstr "" -#: src/methods-and-traits/methods.md:35 +#: src/methods-and-traits/methods.md msgid "\"Race {} is finished, total lap time: {}\"" msgstr "" -#: src/methods-and-traits/methods.md:40 +#: src/methods-and-traits/methods.md msgid "\"Monaco Grand Prix\"" msgstr "" -#: src/methods-and-traits/methods.md:47 +#: src/methods-and-traits/methods.md msgid "// race.add_lap(42);\n" msgstr "" -#: src/methods-and-traits/methods.md:51 +#: src/methods-and-traits/methods.md msgid "" "The `self` arguments specify the \"receiver\" - the object the method acts " "on. There are several common receivers for a method:" @@ -5673,7 +5609,7 @@ msgstr "" "آرگومان‌های `self` \"گیرنده\" را مشخص می‌کنند - شیئی که متد بر روی آن عمل " "می‌کند. چندین گیرنده رایج برای یک متد وجود دارد:" -#: src/methods-and-traits/methods.md:54 +#: src/methods-and-traits/methods.md msgid "" "`&self`: borrows the object from the caller using a shared and immutable " "reference. The object can be used again afterwards." @@ -5681,7 +5617,7 @@ msgstr "" "`self&`: شیئی را از فراخواننده با استفاده از یک مرجع مشترک و غیرقابل تغییر " "قرض می‌گیرد. شیء می‌تواند بعداً دوباره استفاده شود." -#: src/methods-and-traits/methods.md:56 +#: src/methods-and-traits/methods.md msgid "" "`&mut self`: borrows the object from the caller using a unique and mutable " "reference. The object can be used again afterwards." @@ -5690,7 +5626,7 @@ msgstr "" "تغییر قرض می‌گیرد. شی پس از آن نمی‌تواند دوباره استفاده شود تا زمانی که مرجع " "به پایان برسد." -#: src/methods-and-traits/methods.md:58 +#: src/methods-and-traits/methods.md msgid "" "`self`: takes ownership of the object and moves it away from the caller. The " "method becomes the owner of the object. The object will be dropped " @@ -5701,11 +5637,11 @@ msgstr "" "مالک شیء می‌شود. شیء هنگامی که متد باز می‌گردد حذف خواهد شد، مگر اینکه مالکیت " "آن به‌طور صریح منتقل شود. مالکیت کامل به‌طور خودکار به معنای قابلیت تغییر نیست." -#: src/methods-and-traits/methods.md:62 +#: src/methods-and-traits/methods.md msgid "`mut self`: same as above, but the method can mutate the object." msgstr "`mut self`: مشابه مورد بالا، اما متد می‌تواند شیء را تغییر دهد." -#: src/methods-and-traits/methods.md:63 +#: src/methods-and-traits/methods.md msgid "" "No receiver: this becomes a static method on the struct. Typically used to " "create constructors which are called `new` by convention." @@ -5713,11 +5649,11 @@ msgstr "" "بدون گیرنده: این تبدیل به یک متد استاتیک در ساختار می‌شود. معمولاً برای ایجاد " "سازنده‌ها استفاده می‌شود که به‌طور معمول `new` نامیده می‌شوند." -#: src/methods-and-traits/methods.md:71 +#: src/methods-and-traits/methods.md msgid "It can be helpful to introduce methods by comparing them to functions." msgstr "مفید است که متدها را با مقایسه آنها با توابع معرفی کنیم." -#: src/methods-and-traits/methods.md:72 +#: src/methods-and-traits/methods.md msgid "" "Methods are called on an instance of a type (such as a struct or enum), the " "first parameter represents the instance as `self`." @@ -5725,7 +5661,7 @@ msgstr "" "متدها بر روی یک نمونه از تایپی (مانند struct یا enum) فراخوانی می‌شوند، و " "پارامتر اول نمونه را به‌عنوان نمونه `self`." -#: src/methods-and-traits/methods.md:74 +#: src/methods-and-traits/methods.md msgid "" "Developers may choose to use methods to take advantage of method receiver " "syntax and to help keep them more organized. By using methods we can keep " @@ -5735,12 +5671,12 @@ msgstr "" "متد بهره‌برداری کنند و به سازمان‌دهی بهتر کد کمک کنند. با استفاده از متدها، " "می‌توانیم تمامی کدهای پیاده‌سازی را در یک مکان قابل پیش‌بینی نگه داریم." -#: src/methods-and-traits/methods.md:77 +#: src/methods-and-traits/methods.md msgid "Point out the use of the keyword `self`, a method receiver." msgstr "" "استفاده از کلمه کلیدی `self`، که به‌عنوان گیرنده متد عمل می‌کند، را مشخص کنید." -#: src/methods-and-traits/methods.md:78 +#: src/methods-and-traits/methods.md msgid "" "Show that it is an abbreviated term for `self: Self` and perhaps show how " "the struct name could also be used." @@ -5748,7 +5684,7 @@ msgstr "" "نشان دهید که `self` یک اصطلاح کوتاه‌شده برای `self: Self` است و شاید نشان " "دهید که چگونه نام struct نیز می‌تواند استفاده شود." -#: src/methods-and-traits/methods.md:80 +#: src/methods-and-traits/methods.md msgid "" "Explain that `Self` is a type alias for the type the `impl` block is in and " "can be used elsewhere in the block." @@ -5756,7 +5692,7 @@ msgstr "" "توضیح دهید که `Self` یک نام مستعار نوع برای تایپ است که بلوک `impl` در آن " "قرار دارد و می‌تواند در سایر بخش‌های بلوک استفاده شود." -#: src/methods-and-traits/methods.md:82 +#: src/methods-and-traits/methods.md #, fuzzy msgid "" "Note how `self` is used like other structs and dot notation can be used to " @@ -5765,7 +5701,7 @@ msgstr "" "توجه کنید که چگونه `self` مانند سایر ساختارها استفاده می‌شود و dot notation " "می‌تواند برای ارجاع به فیلدهای فردی به کار رود." -#: src/methods-and-traits/methods.md:84 +#: src/methods-and-traits/methods.md msgid "" "This might be a good time to demonstrate how the `&self` differs from `self` " "by trying to run `finish` twice." @@ -5773,7 +5709,7 @@ msgstr "" "این ممکن است زمان مناسبی باشد برای نشان دادن تفاوت بین `self&` و `self` با " "تلاش برای اجرای متد `finish` دو بار." -#: src/methods-and-traits/methods.md:86 +#: src/methods-and-traits/methods.md msgid "" "Beyond variants on `self`, there are also [special wrapper types](https://" "doc.rust-lang.org/reference/special-types-and-traits.html) allowed to be " @@ -5783,22 +5719,22 @@ msgstr "" "rust-lang.org/reference/special-types-and-traits.html) نیز وجود دارند که " "به‌عنوان تایپ‌های گیرنده مجاز هستند، مانند ` Point {}`? Isn't that " "redundant?" @@ -6117,7 +6052,7 @@ msgstr "" "_سوال:_ چرا `T` در عبارت `{} Point { .. }`." msgstr "این امکان وجود دارد که `{ .. }`, but methods in this " "block will only be available for `Point`." @@ -6141,7 +6076,7 @@ msgstr "" "`Point` هنوز هم generic است و می‌توانید از ``." @@ -6267,7 +6203,7 @@ msgstr "" "اگر کسی بپرسد، ویژگی اضافی این است که تایپ در سمت چپ `:` می‌تواند دلخواه " "باشد، مانند `>(x: T) -> i32 {\n" msgstr "" -#: src/generics/impl-trait.md:19 +#: src/generics/impl-trait.md msgid "\"{many}\"" msgstr "" -#: src/generics/impl-trait.md:21 +#: src/generics/impl-trait.md msgid "\"{many_more}\"" msgstr "" -#: src/generics/impl-trait.md:23 +#: src/generics/impl-trait.md msgid "\"debuggable: {debuggable:?}\"" msgstr "" -#: src/generics/impl-trait.md:30 +#: src/generics/impl-trait.md msgid "" "`impl Trait` allows you to work with types which you cannot name. The " "meaning of `impl Trait` is a bit different in the different positions." @@ -6310,7 +6246,7 @@ msgstr "" "`impl Trait` به شما اجازه می‌دهد با تایپ‌هایی کار کنید که نمی‌توانید نام ببرید. " "معنی `impl Trait` در موقعیت‌های مختلف کمی متفاوت است." -#: src/generics/impl-trait.md:33 +#: src/generics/impl-trait.md msgid "" "For a parameter, `impl Trait` is like an anonymous generic parameter with a " "trait bound." @@ -6318,7 +6254,7 @@ msgstr "" "برای یک پارامتر، `impl Trait` شبیه به یک پارامتر generic ناشناخته با یک " "محدودیت trait است." -#: src/generics/impl-trait.md:36 +#: src/generics/impl-trait.md msgid "" "For a return type, it means that the return type is some concrete type that " "implements the trait, without naming the type. This can be useful when you " @@ -6328,7 +6264,7 @@ msgstr "" "پیاده‌سازی می‌کند، بدون اینکه تایپ را نام ببرید. این می‌تواند زمانی مفید باشد " "که نمی‌خواهید تایپ مشخص را در یک API عمومی افشا کنید." -#: src/generics/impl-trait.md:40 +#: src/generics/impl-trait.md msgid "" "Inference is hard in return position. A function returning `impl Foo` picks " "the concrete type it returns, without writing it out in the source. A " @@ -6344,7 +6280,7 @@ msgstr "" "نیاز به انتخاب یکی از آن‌ها داشته باشد، مانند `let x: Vec<_> = foo.collect()` " "یا با استفاده از ()`." -#: src/generics/impl-trait.md:47 +#: src/generics/impl-trait.md msgid "" "What is the type of `debuggable`? Try `let debuggable: () = ..` to see what " "the error message shows." @@ -6352,7 +6288,7 @@ msgstr "" "نوع `debuggable` چیست؟ سعی کنید .. = () :let debuggable` را امتحان کنید تا " "ببینید پیام خطا چه چیزی را نشان می‌دهد." -#: src/generics/dyn-trait.md:3 +#: src/generics/dyn-trait.md msgid "" "In addition to using traits for static dispatch via generics, Rust also " "supports using them for type-erased, dynamic dispatch via trait objects:" @@ -6361,24 +6297,23 @@ msgstr "" "همچنین از استفاده از آن‌ها برای فراخوانی داینامیک با تایپ‌های حذف‌شده از طریق " "اشیاء trait پشتیبانی می‌کند:" -#: src/generics/dyn-trait.md:27 src/smart-pointers/trait-objects.md:28 +#: src/generics/dyn-trait.md src/smart-pointers/trait-objects.md msgid "\"Miau!\"" msgstr "" -#: src/generics/dyn-trait.md:30 +#: src/generics/dyn-trait.md msgid "// Uses generics and static dispatch.\n" msgstr "" -#: src/generics/dyn-trait.md:33 src/generics/dyn-trait.md:38 -#: src/smart-pointers/trait-objects.md:38 +#: src/generics/dyn-trait.md src/smart-pointers/trait-objects.md msgid "\"Hello, who are you? {}\"" msgstr "" -#: src/generics/dyn-trait.md:35 +#: src/generics/dyn-trait.md msgid "// Uses type-erasure and dynamic dispatch.\n" msgstr "" -#: src/generics/dyn-trait.md:56 +#: 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 " @@ -6393,7 +6328,7 @@ msgstr "" "فراخوانی استاتیک استفاده می‌کند، زیرا کامپایلر اطلاعات کامل تایپ را دارد و " "می‌تواند پیاده‌سازی trait مربوط به تایپ را مشخص کند." -#: src/generics/dyn-trait.md:62 +#: 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). " @@ -6406,7 +6341,7 @@ msgstr "" "واحد از `fn dynamic` وجود دارد که بدون توجه به تایپ `Pet` که وارد می‌شود، " "استفاده می‌شود." -#: src/generics/dyn-trait.md:67 +#: 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 " @@ -6417,7 +6352,7 @@ msgstr "" "اشاره‌گرهای هوشمند مانند `Box` نیز می‌توانند استفاده شوند (این موضوع در روز " "سوم نشان داده خواهد شد)." -#: src/generics/dyn-trait.md:71 +#: 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 " @@ -6436,7 +6371,7 @@ msgstr "" "`Dog` یا `Cat` را به آن تابع پاس می‌دهد. کامپایلر نیازی به دانستن تایپ مشخص " "`Pet` برای انجام این کار ندارد." -#: src/generics/dyn-trait.md:79 +#: 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." @@ -6444,7 +6379,7 @@ msgstr "" "یک `dyn Trait` به‌عنوان \"تایپ ‌حذف‌ شده\" (type-erased) در نظر گرفته می‌شود، " "زیرا دیگر در زمان کامپایل اطلاعاتی درباره تایپ مشخص نداریم." -#: src/generics/exercise.md:3 +#: src/generics/exercise.md 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-" @@ -6454,37 +6389,36 @@ msgstr "" "حداقل از دو مقدار را تعیین می‌کند، با استفاده از trait [`Ord`](https://doc." "rust-lang.org/stable/std/cmp/trait.Ord.html)." -#: src/generics/exercise.md:8 +#: src/generics/exercise.md msgid "// TODO: implement the `min` function used in `main`.\n" msgstr "" -#: src/generics/exercise.md:15 src/generics/solution.md:17 -#: src/error-handling/exercise.md:60 src/error-handling/exercise.md:75 -#: src/error-handling/solution.md:60 src/error-handling/solution.md:75 +#: src/generics/exercise.md src/generics/solution.md +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "'z'" msgstr "" -#: src/generics/exercise.md:16 src/generics/solution.md:18 +#: src/generics/exercise.md src/generics/solution.md msgid "'7'" msgstr "" -#: src/generics/exercise.md:16 src/generics/solution.md:18 +#: src/generics/exercise.md src/generics/solution.md msgid "'1'" msgstr "" -#: src/generics/exercise.md:18 src/generics/solution.md:20 +#: src/generics/exercise.md src/generics/solution.md msgid "\"goodbye\"" msgstr "" -#: src/generics/exercise.md:19 src/generics/solution.md:21 +#: src/generics/exercise.md src/generics/solution.md msgid "\"bat\"" msgstr "" -#: src/generics/exercise.md:19 src/generics/solution.md:21 +#: src/generics/exercise.md src/generics/solution.md msgid "\"armadillo\"" msgstr "" -#: src/generics/exercise.md:26 +#: src/generics/exercise.md 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." @@ -6494,15 +6428,15 @@ msgstr "" "[`Ordering`](https://doc.rust-lang.org/stable/std/cmp/enum.Ordering.html) " "enum را به دانش‌آموزان نشان دهید." -#: src/std-types.md src/std-types/option.md:1 +#: src/std-types.md src/std-types/option.md msgid "Option" msgstr "Option" -#: src/std-types.md src/std-types/result.md:1 src/error-handling.md +#: 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:1 +#: src/std-types.md src/std-types/string.md msgid "String" msgstr "String" @@ -6522,7 +6456,7 @@ msgstr "" "برای هر یک از اسلایدهای این بخش، کمی زمان صرف مرور صفحات مستندات کنید و برخی " "از متدهای رایج‌تر را برجسته کنید." -#: src/std-types/std.md:3 +#: src/std-types/std.md msgid "" "Rust comes with a standard library which helps establish a set of common " "types used by Rust libraries and programs. This way, two libraries can work " @@ -6533,7 +6467,7 @@ msgstr "" "کتابخانه می‌توانند به‌راحتی با هم کار کنند زیرا هر دو از تایپ `String` یکسانی " "استفاده می‌کنند." -#: src/std-types/std.md:7 +#: src/std-types/std.md msgid "" "In fact, Rust contains several layers of the Standard Library: `core`, " "`alloc` and `std`." @@ -6541,7 +6475,7 @@ msgstr "" "در واقع، Rust شامل چندین لایه از کتابخانه استاندارد است: `core`، `alloc` و " "`std`." -#: src/std-types/std.md:10 +#: src/std-types/std.md msgid "" "`core` includes the most basic types and functions that don't depend on " "`libc`, allocator or even the presence of an operating system." @@ -6549,7 +6483,7 @@ msgstr "" "`core` شامل ابتدایی‌ترین تایپ‌ها و توابع است که به `libc`، تخصیص‌دهنده حافظه یا " "حتی وجود یک سیستم‌عامل وابسته نیستند." -#: src/std-types/std.md:12 +#: src/std-types/std.md msgid "" "`alloc` includes types which require a global heap allocator, such as `Vec`, " "`Box` and `Arc`." @@ -6557,18 +6491,18 @@ msgstr "" "`alloc` شامل تایپ‌هایی است که به یک تخصیص‌دهنده حافظه سراسری نیاز دارند، مانند " "`Vec`، `Box` و `Arc`." -#: src/std-types/std.md:14 +#: src/std-types/std.md msgid "" "Embedded Rust applications often only use `core`, and sometimes `alloc`." msgstr "" "برنامه‌های Rust تعبیه‌شده اغلب تنها از `core` و گاهی اوقات از `alloc` استفاده " "می‌کنند." -#: src/std-types/docs.md:3 +#: src/std-types/docs.md msgid "Rust comes with extensive documentation. For example:" msgstr "Rust دارای مستندات گسترده‌ای است. به عنوان مثال:" -#: src/std-types/docs.md:5 +#: src/std-types/docs.md msgid "" "All of the details about [loops](https://doc.rust-lang.org/stable/reference/" "expressions/loop-expr.html)." @@ -6576,7 +6510,7 @@ msgstr "" "تمام جزئیات مربوط به [حلقه‌ها](https://doc.rust-lang.org/stable/reference/" "expressions/loop-expr.html)." -#: src/std-types/docs.md:7 +#: src/std-types/docs.md msgid "" "Primitive types like [`u8`](https://doc.rust-lang.org/stable/std/primitive." "u8.html)." @@ -6584,7 +6518,7 @@ msgstr "" "تایپ‌های ابتدایی مانند [`u8`](https://doc.rust-lang.org/stable/std/primitive." "u8.html)." -#: src/std-types/docs.md:9 +#: src/std-types/docs.md msgid "" "Standard library types like [`Option`](https://doc.rust-lang.org/stable/std/" "option/enum.Option.html) or [`BinaryHeap`](https://doc.rust-lang.org/stable/" @@ -6594,11 +6528,11 @@ msgstr "" "std/option/enum.Option.html) یا [`BinaryHeap`](https://doc.rust-lang.org/" "stable/std/collections/struct.BinaryHeap.html)." -#: src/std-types/docs.md:13 +#: src/std-types/docs.md msgid "In fact, you can document your own code:" msgstr "در واقع، شما می‌توانید کد خود را مستند کنید:" -#: src/std-types/docs.md:16 +#: src/std-types/docs.md msgid "" "/// Determine whether the first argument is divisible by the second " "argument.\n" @@ -6606,7 +6540,7 @@ msgid "" "/// If the second argument is zero, the result is false.\n" msgstr "" -#: src/std-types/docs.md:27 +#: src/std-types/docs.md msgid "" "The contents are treated as Markdown. All published Rust library crates are " "automatically documented at [`docs.rs`](https://docs.rs) using the [rustdoc]" @@ -6619,7 +6553,7 @@ msgstr "" "می‌شوند. مستند کردن تمام آیتم‌های عمومی در یک API با استفاده از این الگو به‌طور " "رایج مرسوم است." -#: src/std-types/docs.md:32 +#: src/std-types/docs.md msgid "" "To document an item from inside the item (such as inside a module), use `//!" "` or `/*! .. */`, called \"inner doc comments\":" @@ -6627,13 +6561,13 @@ msgstr "" "برای مستند کردن یک آیتم از درون خود آیتم (مانند درون یک ماژول)، از `!//` یا " "`/* .. !*/` استفاده کنید که به آن \"کامنت‌های مستندات داخلی\" می‌گویند:" -#: src/std-types/docs.md:36 +#: src/std-types/docs.md msgid "" "//! This module contains functionality relating to divisibility of " "integers.\n" msgstr "" -#: src/std-types/docs.md:42 +#: src/std-types/docs.md msgid "" "Show students the generated docs for the `rand` crate at ." @@ -6641,7 +6575,7 @@ msgstr "" "مستندات تولیدشده برای `rand` crate را در به " "دانش‌آموزان نشان دهید." -#: src/std-types/option.md:3 +#: src/std-types/option.md msgid "" "We have already seen some use of `Option`. It stores either a value of " "type `T` or nothing. For example, [`String::find`](https://doc.rust-lang.org/" @@ -6652,33 +6586,33 @@ msgstr "" "[`String::find`](https://doc.rust-lang.org/stable/std/string/struct.String." "html#method.find) یک `` often has the same size in " "memory as `T`." @@ -6710,7 +6644,7 @@ msgstr "" "بهینه‌سازی niche به این معناست که `` " @@ -6720,23 +6654,23 @@ msgstr "" "هرکدام با یک نوع متغیر enum متفاوت. این نوع جنریک است: ``](https://doc.rust-lang.org/std/" "string/struct.String.html#deref-methods-str), which means that you can call " @@ -6811,7 +6744,7 @@ msgstr "" "std/string/struct.String.html#deref-methods-str) است، که به این معناست که " "می‌توانید تمام متدهای `str` را بر روی `String` فراخوانی کنید." -#: src/std-types/string.md:30 +#: src/std-types/string.md msgid "" "`String::new` returns a new empty string, use `String::with_capacity` when " "you know how much data you want to push to the string." @@ -6819,7 +6752,7 @@ msgstr "" "`String::new` یک رشته جدید خالی برمی‌گرداند. از `String::with_capacity` " "استفاده کنید زمانی که می‌دانید چقدر داده می‌خواهید به رشته اضافه کنید." -#: src/std-types/string.md:32 +#: src/std-types/string.md msgid "" "`String::len` returns the size of the `String` in bytes (which can be " "different from its length in characters)." @@ -6827,7 +6760,7 @@ msgstr "" "`String::len` اندازه رشته `String` را به‌صورت بایت برمی‌گرداند (که ممکن است با " "طول آن به‌صورت کاراکتر متفاوت باشد)." -#: src/std-types/string.md:34 +#: src/std-types/string.md msgid "" "`String::chars` returns an iterator over the actual characters. Note that a " "`char` can be different from what a human will consider a \"character\" due " @@ -6840,7 +6773,7 @@ msgstr "" "docs.rs/unicode-segmentation/latest/unicode_segmentation/struct.Graphemes." "html)." -#: src/std-types/string.md:37 +#: src/std-types/string.md msgid "" "When people refer to strings they could either be talking about `&str` or " "`String`." @@ -6848,7 +6781,7 @@ msgstr "" "زمانی که مردم به رشته‌ها اشاره می‌کنند، ممکن است منظورشان `str&` یا `String` " "باشد." -#: src/std-types/string.md:39 +#: src/std-types/string.md msgid "" "When a type implements `Deref`, the compiler will let you " "transparently call methods from `T`." @@ -6856,7 +6789,7 @@ msgstr "" "زمانی که یک تایپ، `` which transparently gives it " "access to `str`'s methods." @@ -6872,22 +6805,22 @@ msgstr "" "`String` پیاده‌سازی‌کننده ``](https://doc.rust-lang.org/std/vec/" "struct.Vec.html#deref-methods-%5BT%5D), which means that you can call slice " @@ -6959,7 +6892,7 @@ msgstr "" "vec/struct.Vec.html#deref-methods-%5BT%5D) است، به این معنی که می‌توانید " "متدهای برش را بر روی یک `Vec` فراخوانی کنید." -#: src/std-types/vec.md:38 +#: src/std-types/vec.md msgid "" "`Vec` is a type of collection, along with `String` and `HashMap`. The data " "it contains is stored on the heap. This means the amount of data doesn't " @@ -6969,7 +6902,7 @@ msgstr "" "heap ذخیره می‌شود. به این معنی که مقدار داده‌ها نیازی به دانستن در زمان " "کامپایل ندارد و می‌تواند در زمان اجرا رشد یا کوچک شود." -#: src/std-types/vec.md:41 +#: src/std-types/vec.md msgid "" "Notice how `Vec` is a generic type too, but you don't have to specify `T` " "explicitly. As always with Rust type inference, the `T` was established " @@ -6979,7 +6912,7 @@ msgstr "" "صریح `T` ندارید. همان‌طور که همیشه با استنتاج تایپ در Rust ، `T` در زمان " "اولین فراخوانی `push` مشخص شده است." -#: src/std-types/vec.md:44 +#: src/std-types/vec.md msgid "" "`vec![...]` is a canonical macro to use instead of `Vec::new()` and it " "supports adding initial elements to the vector." @@ -6987,7 +6920,7 @@ msgstr "" "`[...]!vec` یک ماکرو استاندارد برای استفاده به‌جای `()Vec::new` است و از " "افزودن عناصر اولیه به vector پشتیبانی می‌کند." -#: src/std-types/vec.md:46 +#: src/std-types/vec.md msgid "" "To index the vector you use `[` `]`, but they will panic if out of bounds. " "Alternatively, using `get` will return an `Option`. The `pop` function will " @@ -6997,7 +6930,7 @@ msgstr "" "شود، باعث panic می‌شود. به‌طور جایگزین، استفاده از `get` یک `Option` را " "برمی‌گرداند. تابع `pop` آخرین عنصر را حذف می‌کند." -#: src/std-types/vec.md:49 +#: src/std-types/vec.md msgid "" "Slices are covered on day 3. For now, students only need to know that a " "value of type `Vec` gives access to all of the documented slice methods, too." @@ -7005,57 +6938,56 @@ msgstr "" "برش‌ها در روز سوم پوشش داده می‌شوند. در حال حاضر، دانش‌آموزان تنها باید بدانند " "که یک مقدار از تایپ `Vec` به تمام متدهای مستند شده برش‌ها نیز دسترسی دارد." -#: src/std-types/hashmap.md:3 +#: src/std-types/hashmap.md msgid "Standard hash map with protection against HashDoS attacks:" msgstr "نقشه hash استاندارد با حفاظت در برابر حملات HashDoS:" -#: src/std-types/hashmap.md:10 +#: src/std-types/hashmap.md msgid "\"Adventures of Huckleberry Finn\"" msgstr "" -#: src/std-types/hashmap.md:11 +#: src/std-types/hashmap.md msgid "\"Grimms' Fairy Tales\"" msgstr "" -#: src/std-types/hashmap.md:12 src/std-types/hashmap.md:21 -#: src/std-types/hashmap.md:29 +#: src/std-types/hashmap.md msgid "\"Pride and Prejudice\"" msgstr "" -#: src/std-types/hashmap.md:14 +#: src/std-types/hashmap.md msgid "\"Les Misérables\"" msgstr "" -#: src/std-types/hashmap.md:16 +#: src/std-types/hashmap.md msgid "\"We know about {} books, but not Les Misérables.\"" msgstr "" -#: src/std-types/hashmap.md:21 src/std-types/hashmap.md:29 +#: src/std-types/hashmap.md msgid "\"Alice's Adventure in Wonderland\"" msgstr "" -#: src/std-types/hashmap.md:23 +#: src/std-types/hashmap.md msgid "\"{book}: {count} pages\"" msgstr "" -#: src/std-types/hashmap.md:24 +#: src/std-types/hashmap.md msgid "\"{book} is unknown.\"" msgstr "" -#: src/std-types/hashmap.md:28 +#: src/std-types/hashmap.md msgid "// Use the .entry() method to insert a value if nothing is found.\n" msgstr "" -#: src/std-types/hashmap.md:34 +#: src/std-types/hashmap.md msgid "\"{page_counts:#?}\"" msgstr "" -#: src/std-types/hashmap.md:41 +#: src/std-types/hashmap.md msgid "" "`HashMap` is not defined in the prelude and needs to be brought into scope." msgstr "`HashMap` در prelude تعریف نشده و باید به scope وارد شود." -#: src/std-types/hashmap.md:42 +#: src/std-types/hashmap.md msgid "" "Try the following lines of code. The first line will see if a book is in the " "hashmap and if not return an alternative value. The second line will insert " @@ -7065,19 +6997,19 @@ msgstr "" "`HashMap` وجود دارد یا خیر و اگر وجود نداشت، یک مقدار جایگزین برمی‌گرداند. " "سطر دوم مقدار جایگزین را در `HashMap` وارد می‌کند اگر کتاب پیدا نشد." -#: src/std-types/hashmap.md:48 src/std-types/hashmap.md:60 +#: src/std-types/hashmap.md msgid "\"Harry Potter and the Sorcerer's Stone\"" msgstr "" -#: src/std-types/hashmap.md:51 src/std-types/hashmap.md:61 +#: src/std-types/hashmap.md msgid "\"The Hunger Games\"" msgstr "" -#: src/std-types/hashmap.md:54 +#: src/std-types/hashmap.md msgid "Unlike `vec!`, there is unfortunately no standard `hashmap!` macro." msgstr "برخلاف `!vec`، متأسفانه ماکروی استاندارد `!hashmap` وجود ندارد." -#: src/std-types/hashmap.md:55 +#: src/std-types/hashmap.md msgid "" "Although, since Rust 1.56, HashMap implements [`From<[(K, V); N]>`](https://" "doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#impl-" @@ -7089,7 +7021,7 @@ msgstr "" "From%3C%5B(K,+V);+N%5D%3E-for-HashMap%3CK,+V,+RandomState%3E) است که به ما " "اجازه می‌دهد به‌راحتی یک `HashMap` را از یک آرایه مقداردهی اولیه کنیم:" -#: src/std-types/hashmap.md:65 +#: src/std-types/hashmap.md msgid "" "Alternatively HashMap can be built from any `Iterator` which yields key-" "value tuples." @@ -7097,7 +7029,7 @@ msgstr "" "به‌طور جایگزین، `HashMap` می‌تواند از هر `Iterator` که جفت‌های key-value را " "تولید می‌کند، ساخته شود." -#: src/std-types/hashmap.md:67 +#: src/std-types/hashmap.md msgid "" "We are showing `HashMap`, and avoid using `&str` as key to make " "examples easier. Using references in collections can, of course, be done, " @@ -7107,7 +7039,7 @@ msgstr "" "کلید اجتناب می‌کنیم تا مثال‌ها ساده‌تر شوند. استفاده از ارجاعات در مجموعه‌ها " "البته ممکن است، اما می‌تواند به مشکلاتی با borrow checker منجر شود." -#: src/std-types/hashmap.md:70 +#: src/std-types/hashmap.md msgid "" "Try removing `to_string()` from the example above and see if it still " "compiles. Where do you think we might run into issues?" @@ -7115,7 +7047,7 @@ msgstr "" "حذف `()to_string` از مثال بالا را امتحان کنید و ببینید آیا هنوز کامپایل " "می‌شود یا خیر. فکر می‌کنید ممکن است با چه مشکلاتی مواجه شویم؟" -#: src/std-types/hashmap.md:73 +#: src/std-types/hashmap.md msgid "" "This type has several \"method-specific\" return types, such as `std::" "collections::hash_map::Keys`. These types often appear in searches of the " @@ -7127,7 +7059,7 @@ msgstr "" "مستندات این تایپ را به دانش‌آموزان نشان دهید و پیوند مفید بازگشتی به متد " "`keys` را نیز نمایش دهید." -#: src/std-types/exercise.md:3 +#: src/std-types/exercise.md msgid "" "In this exercise you will take a very simple data structure and make it " "generic. It uses a [`std::collections::HashMap`](https://doc.rust-lang.org/" @@ -7139,7 +7071,7 @@ msgstr "" "std/collections/struct.HashMap.html) برای پیگیری اینکه چه مقادیری مشاهده " "شده‌اند و هرکدام چند بار ظاهر شده‌اند، استفاده می‌کند." -#: src/std-types/exercise.md:9 +#: src/std-types/exercise.md msgid "" "The initial version of `Counter` is hard coded to only work for `u32` " "values. Make the struct and its methods generic over the type of value being " @@ -7149,7 +7081,7 @@ msgstr "" "ساختار و متدهای آن را به‌صورت generic بر اساس تایپ مقداری که در حال پیگیری " "است، تغییر دهید، به‌طوری که `Counter` بتواند هر تایپ مقداری را پیگیری کند." -#: src/std-types/exercise.md:13 +#: src/std-types/exercise.md msgid "" "If you finish early, try using the [`entry`](https://doc.rust-lang.org/" "stable/std/collections/struct.HashMap.html#method.entry) method to halve the " @@ -7159,38 +7091,36 @@ msgstr "" "stable/std/collections/struct.HashMap.html#method.entry) استفاده کنید تا " "تعداد جستجوهای هش مورد نیاز برای پیاده‌سازی متد `count` را به نصف کاهش دهید." -#: src/std-types/exercise.md:20 src/std-types/solution.md:6 +#: src/std-types/exercise.md src/std-types/solution.md msgid "" "/// Counter counts the number of times each value of type T has been seen.\n" msgstr "" -#: src/std-types/exercise.md:27 src/std-types/solution.md:13 +#: src/std-types/exercise.md src/std-types/solution.md msgid "/// Create a new Counter.\n" msgstr "" -#: src/std-types/exercise.md:34 src/std-types/solution.md:18 +#: src/std-types/exercise.md src/std-types/solution.md msgid "/// Count an occurrence of the given value.\n" msgstr "" -#: src/std-types/exercise.md:43 src/std-types/solution.md:23 +#: src/std-types/exercise.md src/std-types/solution.md msgid "/// Return the number of times the given value has been seen.\n" msgstr "" -#: src/std-types/exercise.md:59 src/std-types/solution.md:39 +#: src/std-types/exercise.md src/std-types/solution.md msgid "\"saw {} values equal to {}\"" msgstr "" -#: src/std-types/exercise.md:63 src/std-types/exercise.md:65 -#: src/std-types/exercise.md:66 src/std-types/solution.md:43 -#: src/std-types/solution.md:45 src/std-types/solution.md:46 +#: src/std-types/exercise.md src/std-types/solution.md msgid "\"apple\"" msgstr "" -#: src/std-types/exercise.md:64 src/std-types/solution.md:44 +#: src/std-types/exercise.md src/std-types/solution.md msgid "\"orange\"" msgstr "" -#: src/std-types/exercise.md:66 src/std-types/solution.md:46 +#: src/std-types/exercise.md src/std-types/solution.md msgid "\"got {} apples\"" msgstr "" @@ -7224,7 +7154,7 @@ msgstr "" msgid "This section is long. Take a break midway through." msgstr "این بخش طولانی است. در میانه‌ی آن یک استراحت کنید." -#: src/std-traits/comparisons.md:3 +#: src/std-traits/comparisons.md msgid "" "These traits support comparisons between values. All traits can be derived " "for types containing fields that implement these traits." @@ -7233,11 +7163,11 @@ msgstr "" "برای تایپ‌هایی که شامل فیلدهایی هستند که این trait‌ها را پیاده‌سازی می‌کنند، " "به‌دست آورد." -#: src/std-traits/comparisons.md:6 +#: src/std-traits/comparisons.md msgid "`PartialEq` and `Eq`" msgstr "`PartialEq` and `Eq`" -#: src/std-traits/comparisons.md:8 +#: src/std-traits/comparisons.md msgid "" "`PartialEq` is a partial equivalence relation, with required method `eq` and " "provided method `ne`. The `==` and `!=` operators will call these methods." @@ -7245,7 +7175,7 @@ msgstr "" "`PartialEq` یک رابطه هم‌ارزی جزئی است که دارای متد الزامی `eq` و متد ارائه‌شده " "`ne` می‌باشد. عملگرهای `==` و `=!` این متدها را فراخوانی می‌کنند." -#: src/std-traits/comparisons.md:23 +#: src/std-traits/comparisons.md msgid "" "`Eq` is a full equivalence relation (reflexive, symmetric, and transitive) " "and implies `PartialEq`. Functions that require full equivalence will use " @@ -7255,11 +7185,11 @@ msgstr "" "`PartialEq` می‌شود. توابعی که به هم‌ارزی کامل نیاز دارند، از `Eq` به‌عنوان یک " "trait bound استفاده می‌کنند." -#: src/std-traits/comparisons.md:27 +#: src/std-traits/comparisons.md msgid "`PartialOrd` and `Ord`" msgstr "`PartialOrd` and `Ord`" -#: src/std-traits/comparisons.md:29 +#: src/std-traits/comparisons.md msgid "" "`PartialOrd` defines a partial ordering, with a `partial_cmp` method. It is " "used to implement the `<`, `<=`, `>=`, and `>` operators." @@ -7267,12 +7197,12 @@ msgstr "" "`PartialOrd` یک ترتیب جزئی را تعریف می‌کند و دارای متد `partial_cmp` است. این " "ویژگی برای پیاده‌سازی عملگرهای `<`، `<=`، `>=` و `>` استفاده می‌شود." -#: src/std-traits/comparisons.md:49 +#: src/std-traits/comparisons.md msgid "`Ord` is a total ordering, with `cmp` returning `Ordering`." msgstr "" "`Ord` یک ترتیب کامل است که در آن متد `cmp` مقدار `Ordering` را برمی‌گرداند." -#: src/std-traits/comparisons.md:54 +#: src/std-traits/comparisons.md msgid "" "`PartialEq` can be implemented between different types, but `Eq` cannot, " "because it is reflexive:" @@ -7280,7 +7210,7 @@ msgstr "" "`PartialEq` می‌تواند بین تایپ‌های مختلف پیاده‌سازی شود، اما `Eq` نمی‌تواند، زیرا " "بازتابی است:" -#: src/std-traits/comparisons.md:69 +#: src/std-traits/comparisons.md msgid "" "In practice, it's common to derive these traits, but uncommon to implement " "them." @@ -7288,7 +7218,7 @@ msgstr "" "در عمل، معمولاً این trait‌ها به‌طور خودکار به‌دست می‌آیند، اما کمتر پیش می‌آید که " "آن‌ها به‌طور دستی پیاده‌سازی شوند." -#: src/std-traits/operators.md:3 +#: src/std-traits/operators.md msgid "" "Operator overloading is implemented via traits in [`std::ops`](https://doc." "rust-lang.org/std/ops/index.html):" @@ -7296,22 +7226,22 @@ msgstr "" "بارگذاری مجدد عملگرها از طریق traits در [`std::ops`](https://doc.rust-lang." "org/std/ops/index.html) پیاده‌سازی شده است:" -#: src/std-traits/operators.md:23 +#: src/std-traits/operators.md msgid "\"{:?} + {:?} = {:?}\"" msgstr "\"{:?} + {:?} = {:?}\"" -#: src/std-traits/operators.md:30 src/memory-management/drop.md:48 +#: src/std-traits/operators.md src/memory-management/drop.md msgid "Discussion points:" msgstr "نکات بحث:" -#: src/std-traits/operators.md:32 +#: src/std-traits/operators.md msgid "" "You could implement `Add` for `&Point`. In which situations is that useful?" msgstr "" "می‌توانید `Add` را برای `Point&` پیاده‌سازی کنید. در چه موقعیت‌هایی این کار " "مفید است؟" -#: src/std-traits/operators.md:33 +#: src/std-traits/operators.md msgid "" "Answer: `Add:add` consumes `self`. If type `T` for which you are overloading " "the operator is not `Copy`, you should consider overloading the operator for " @@ -7321,7 +7251,7 @@ msgstr "" "بارگذاری می‌کنید، `Copy` نباشد، باید پیاده‌سازی عملگر را برای `T&` نیز در نظر " "بگیرید. این کار از ایجاد کپی‌های غیرضروری در محل فراخوانی جلوگیری می‌کند." -#: src/std-traits/operators.md:36 +#: src/std-traits/operators.md msgid "" "Why is `Output` an associated type? Could it be made a type parameter of the " "method?" @@ -7329,7 +7259,7 @@ msgstr "" "چرا `Output` یک تایپ مرتبط است؟ آیا می‌توان آن را به‌عنوان یک پارامترتایپ برای " "متد تعریف کرد؟" -#: src/std-traits/operators.md:38 +#: src/std-traits/operators.md msgid "" "Short answer: Function type parameters are controlled by the caller, but " "associated types (like `Output`) are controlled by the implementer of a " @@ -7338,7 +7268,7 @@ msgstr "" "پاسخ کوتاه: پارامترهای تایپ تابع توسط فراخوانی‌کننده کنترل می‌شوند، اما " "تایپ‌های مرتبط (مانند `Output`) توسط پیاده‌ساز trait کنترل می‌شوند." -#: src/std-traits/operators.md:41 +#: src/std-traits/operators.md msgid "" "You could implement `Add` for two different types, e.g. `impl Add<(i32, " "i32)> for Point` would add a tuple to a `Point`." @@ -7346,21 +7276,31 @@ msgstr "" "شما می‌توانید `Add` را برای دو تایپ مختلف پیاده‌سازی کنید، به‌عنوان مثال `impl " "Add<(i32, i32)> for Point` می‌تواند یک tuple را به یک `Point` اضافه کند." -#: src/std-traits/from-and-into.md:3 +#: 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.Into.html) " "را برای تسهیل تبدیل تایپ پیاده‌سازی می‌کنند:" -#: src/std-traits/from-and-into.md:11 src/std-traits/from-and-into.md:23 +#: src/std-traits/from-and-into.md msgid "\"{s}, {addr}, {one}, {bigger}\"" msgstr "\"{s}, {addr}, {one}, {bigger}\"" -#: src/std-traits/from-and-into.md:15 +#: src/std-traits/from-and-into.md msgid "" "[`Into`](https://doc.rust-lang.org/std/convert/trait.Into.html) is " "automatically implemented when [`From`](https://doc.rust-lang.org/std/" @@ -7370,7 +7310,7 @@ msgstr "" "زمانی پیاده‌سازی می‌شود که [`From`](https://doc.rust-lang.org/std/convert/" "trait.From.html) پیاده‌سازی شده باشد:" -#: src/std-traits/from-and-into.md:30 +#: src/std-traits/from-and-into.md msgid "" "That's why it is common to only implement `From`, as your type will get " "`Into` implementation too." @@ -7378,7 +7318,7 @@ msgstr "" "به همین دلیل معمولاً تنها `From` پیاده‌سازی می‌شود، زیرا تایپ شما به‌طور خودکار " "پیاده‌سازی `Into` را نیز دریافت می‌کند." -#: src/std-traits/from-and-into.md:32 +#: src/std-traits/from-and-into.md msgid "" "When declaring a function argument input type like \"anything that can be " "converted into a `String`\", the rule is opposite, you should use `Into`. " @@ -7390,7 +7330,7 @@ msgstr "" "قبول می‌کند که پیاده‌سازی `From` دارند و همچنین تاید‌هایی که فقط `Into` را " "پیاده‌سازی کرده‌اند." -#: src/std-traits/casting.md:3 +#: src/std-traits/casting.md msgid "" "Rust has no _implicit_ type conversions, but does support explicit casts " "with `as`. These generally follow C semantics where those are defined." @@ -7398,19 +7338,19 @@ msgstr "" "Rust هیچ _implicit_ ندارد، اما از تبدیل‌های صریح با استفاده از `as` پشتیبانی " "می‌کند. این تبدیل‌ها معمولاً پیرو معنای C هستند که در آنجا تعریف شده‌اند." -#: src/std-traits/casting.md:9 +#: src/std-traits/casting.md msgid "\"as u16: {}\"" msgstr "\"as u16: {}\"" -#: src/std-traits/casting.md:10 +#: src/std-traits/casting.md msgid "\"as i16: {}\"" msgstr "\"as i16: {}\"" -#: src/std-traits/casting.md:11 +#: src/std-traits/casting.md msgid "\"as u8: {}\"" msgstr "\"as u8: {}\"" -#: src/std-traits/casting.md:15 +#: src/std-traits/casting.md msgid "" "The results of `as` are _always_ defined in Rust and consistent across " "platforms. This might not match your intuition for changing sign or casting " @@ -7420,7 +7360,7 @@ msgstr "" "هستند. این ممکن است با شهود شما برای تغییر علامت یا تبدیل به تایپ کوچکتر " "مطابقت نداشته باشد -- مستندات را بررسی کنید و برای وضوح بیشتر نظر دهید." -#: src/std-traits/casting.md:19 +#: src/std-traits/casting.md msgid "" "Casting with `as` is a relatively sharp tool that is easy to use " "incorrectly, and can be a source of subtle bugs as future maintenance work " @@ -7436,7 +7376,7 @@ msgstr "" "باشد (مثلاً انتخاب 32 بیت پایین از یک `u64` با `as u32`، بدون توجه به آنچه در " "بیت‌های بالا وجود دارد)." -#: src/std-traits/casting.md:25 +#: src/std-traits/casting.md msgid "" "For infallible casts (e.g. `u32` to `u64`), prefer using `From` or `Into` " "over `as` to confirm that the cast is in fact infallible. For fallible " @@ -7449,11 +7389,11 @@ msgstr "" "می‌خواهید تبدیل‌هایی را که به شیوه‌ای متفاوت از آن‌هایی که مطابقت ندارند، مدیریت " "کنید." -#: src/std-traits/casting.md:33 +#: src/std-traits/casting.md msgid "Consider taking a break after this slide." msgstr "در نظر داشته باشید که پس از این اسلاید استراحت کنید." -#: src/std-traits/casting.md:35 +#: src/std-traits/casting.md msgid "" "`as` is similar to a C++ static cast. Use of `as` in cases where data might " "be lost is generally discouraged, or at least deserves an explanatory " @@ -7463,13 +7403,13 @@ msgstr "" "است داده‌ها از دست برود، معمولاً توصیه نمی‌شود یا حداقل نیاز به توضیحی کامنتی " "دارد." -#: src/std-traits/casting.md:38 +#: src/std-traits/casting.md msgid "This is common in casting integers to `usize` for use as an index." msgstr "" "این موضوع در تبدیل اعداد صحیح به `usize` برای استفاده به عنوان ایندکس رایج " "است." -#: src/std-traits/read-and-write.md:3 +#: src/std-traits/read-and-write.md msgid "" "Using [`Read`](https://doc.rust-lang.org/std/io/trait.Read.html) and " "[`BufRead`](https://doc.rust-lang.org/std/io/trait.BufRead.html), you can " @@ -7479,19 +7419,19 @@ msgstr "" "[`BufRead`](https://doc.rust-lang.org/std/io/trait.BufRead.html)، می‌توانید " "بر روی منابع `u8` انتزاع کنید:" -#: src/std-traits/read-and-write.md:14 +#: src/std-traits/read-and-write.md msgid "b\"foo\\nbar\\nbaz\\n\"" msgstr "b\"foo\\nbar\\nbaz\\n\"" -#: src/std-traits/read-and-write.md:15 +#: src/std-traits/read-and-write.md msgid "\"lines in slice: {}\"" msgstr "\"lines in slice: {}\"" -#: src/std-traits/read-and-write.md:18 +#: src/std-traits/read-and-write.md msgid "\"lines in file: {}\"" msgstr "\"lines in file: {}\"" -#: src/std-traits/read-and-write.md:23 +#: src/std-traits/read-and-write.md msgid "" "Similarly, [`Write`](https://doc.rust-lang.org/std/io/trait.Write.html) lets " "you abstract over `u8` sinks:" @@ -7499,19 +7439,19 @@ msgstr "" "به طور مشابه، [`Write`](https://doc.rust-lang.org/std/io/trait.Write.html) " "به شما امکان می‌دهد که بر روی منابع `u8` انتزاع کنید:" -#: src/std-traits/read-and-write.md:30 +#: src/std-traits/read-and-write.md msgid "\"\\n\"" msgstr "\"\\n\"" -#: src/std-traits/read-and-write.md:37 +#: src/std-traits/read-and-write.md msgid "\"Logged: {:?}\"" msgstr "\"Logged: {:?}\"" -#: src/std-traits/default.md:1 +#: src/std-traits/default.md msgid "The `Default` Trait" msgstr "The `Default` Trait" -#: src/std-traits/default.md:3 +#: src/std-traits/default.md msgid "" "[`Default`](https://doc.rust-lang.org/std/default/trait.Default.html) trait " "produces a default value for a type." @@ -7519,35 +7459,35 @@ msgstr "" "ویژگی [`Default`](https://doc.rust-lang.org/std/default/trait.Default.html) " "یک مقدار پیش‌فرض برای یک تایپ تولید می‌کند." -#: src/std-traits/default.md:18 +#: src/std-traits/default.md msgid "\"John Smith\"" msgstr "\"John Smith\"" -#: src/std-traits/default.md:24 +#: src/std-traits/default.md msgid "\"{default_struct:#?}\"" msgstr "\"{default_struct:#?}\"" -#: src/std-traits/default.md:27 +#: src/std-traits/default.md msgid "\"Y is set!\"" msgstr "\"Y is set!\"" -#: src/std-traits/default.md:28 +#: src/std-traits/default.md msgid "\"{almost_default_struct:#?}\"" msgstr "\"{almost_default_struct:#?}\"" -#: src/std-traits/default.md:31 src/lifetimes/exercise.md:197 -#: src/lifetimes/solution.md:196 +#: src/std-traits/default.md src/lifetimes/exercise.md +#: src/lifetimes/solution.md msgid "\"{:#?}\"" msgstr "\"{:#?}\"" -#: src/std-traits/default.md:38 +#: src/std-traits/default.md msgid "" "It can be implemented directly or it can be derived via `#[derive(Default)]`." msgstr "" "این ویژگی می‌تواند به طور مستقیم پیاده‌سازی شود یا می‌تواند از طریق " "`[derive(Default)]#` به صورت خودکار تولید شود." -#: src/std-traits/default.md:39 +#: src/std-traits/default.md msgid "" "A derived implementation will produce a value where all fields are set to " "their default values." @@ -7555,13 +7495,13 @@ msgstr "" "یک پیاده‌سازی خودکار، مقداری تولید می‌کند که در آن تمامی فیلدها به مقادیر " "پیش‌فرض خود تنظیم شده‌اند." -#: src/std-traits/default.md:41 +#: src/std-traits/default.md msgid "This means all types in the struct must implement `Default` too." msgstr "" "این بدان معناست که تمام تایپ‌های موجود در ساختار نیز باید `Default` را " "پیاده‌سازی کنند." -#: src/std-traits/default.md:42 +#: src/std-traits/default.md msgid "" "Standard Rust types often implement `Default` with reasonable values (e.g. " "`0`, `\"\"`, etc)." @@ -7569,11 +7509,11 @@ msgstr "" "نوع‌های استاندارد Rust اغلب `Default` را با مقادیر معقول پیاده‌سازی می‌کنند " "(مثل `0`، `\"\"` و غیره)." -#: src/std-traits/default.md:44 +#: src/std-traits/default.md msgid "The partial struct initialization works nicely with default." msgstr "مقداردهی جزئی ساختارها با `Default` به خوبی کار می‌کند." -#: src/std-traits/default.md:45 +#: src/std-traits/default.md msgid "" "The Rust standard library is aware that types can implement `Default` and " "provides convenience methods that use it." @@ -7581,7 +7521,7 @@ msgstr "" "کتابخانه استاندارد Rust آگاه است که تایپ‌های مختلف می‌توانند `Default` را " "پیاده‌سازی کنند و روش‌های کمکی را فراهم می‌کند که از آن استفاده می‌کنند." -#: src/std-traits/default.md:47 +#: src/std-traits/default.md msgid "" "The `..` syntax is called [struct update syntax](https://doc.rust-lang.org/" "book/ch05-01-defining-structs.html#creating-instances-from-other-instances-" @@ -7591,7 +7531,7 @@ msgstr "" "ch05-01-defining-structs.html#creating-instances-from-other-instances-with-" "struct-update-syntax) شناخته می‌شود." -#: src/std-traits/closures.md:3 +#: src/std-traits/closures.md msgid "" "Closures or lambda expressions have types which cannot be named. However, " "they implement special [`Fn`](https://doc.rust-lang.org/std/ops/trait.Fn." @@ -7604,49 +7544,57 @@ msgstr "" "html) و [`FnOnce`](https://doc.rust-lang.org/std/ops/trait.FnOnce.html) " "هستند:" -#: src/std-traits/closures.md:10 -msgid "\"Calling function on {input}\"" +#: src/std-traits/closures.md +#, fuzzy +msgid "\"Calling {func_name}({input}): {}\"" msgstr "\"Calling function on {input}\"" -#: src/std-traits/closures.md:16 src/std-traits/closures.md:17 -msgid "\"add_3: {}\"" +#: src/std-traits/closures.md +#, fuzzy +msgid "\"add_3\"" msgstr "\"add_3: {}\"" -#: src/std-traits/closures.md:24 src/std-traits/closures.md:25 -msgid "\"accumulate: {}\"" +#: src/std-traits/closures.md +#, fuzzy +msgid "\"accumulate\"" msgstr "\"accumulate: {}\"" -#: src/std-traits/closures.md:28 -msgid "\"multiply_sum: {}\"" +#: src/std-traits/closures.md +#, fuzzy +msgid "\"multiply_sum\"" msgstr "\"multiply_sum: {}\"" -#: src/std-traits/closures.md:35 +#: src/std-traits/closures.md +#, fuzzy msgid "" -"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." msgstr "" "یک `Fn` (برای مثال `add_3`) نه مقادیر گرفته شده را مصرف می‌کند و نه آن‌ها را " "تغییر می‌دهد، یا شاید اصلاً چیزی را نمی‌گیرد. این تایپ می‌تواند به‌طور همزمان " "چندین بار فراخوانی شود." -#: src/std-traits/closures.md:38 +#: src/std-traits/closures.md +#, fuzzy msgid "" -"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." msgstr "" "یک `FnMut` (برای مثال `accumulate`) ممکن است مقادیر گرفته شده را تغییر دهد. " "شما می‌توانید آن را چندین بار فراخوانی کنید، اما نه به‌طور همزمان." -#: src/std-traits/closures.md:41 +#: src/std-traits/closures.md +#, fuzzy msgid "" -"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." msgstr "" "اگر یک `FnOnce` (برای مثال `multiply_sum`) داشته باشید، تنها می‌توانید آن را " "یک‌بار فراخوانی کنید. ممکن است مقادیر گرفته شده را مصرف کند." -#: src/std-traits/closures.md:44 +#: src/std-traits/closures.md msgid "" "`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 " @@ -7657,7 +7605,7 @@ msgstr "" "است استفاده کنید و از `Fn` در جایی که `FnMut` یا `FnOnce` نیاز است استفاده " "کنید." -#: src/std-traits/closures.md:48 +#: src/std-traits/closures.md msgid "" "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 " @@ -7668,46 +7616,48 @@ msgstr "" "می‌شود)، یا از `FnMut` در غیر این صورت، و در نهایت از `Fn`. این کار بیشترین " "انعطاف‌پذیری را برای فراخوانی‌کننده فراهم می‌کند." -#: src/std-traits/closures.md:52 +#: src/std-traits/closures.md +#, fuzzy msgid "" "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`." +"(which can be passed to a consumer of any of the 3 closure traits), then " +"`FnMut`, and lastly `FnOnce`." msgstr "" "در مقابل، زمانی که یک closure دارید، بیشترین انعطاف‌پذیری که می‌توانید داشته " "باشید `Fn` است (که می‌تواند در هر جایی استفاده شود)، سپس `FnMut` و در نهایت " "`FnOnce`." -#: src/std-traits/closures.md:55 +#: src/std-traits/closures.md +#, fuzzy msgid "" "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`." msgstr "" "کامپایلر همچنین `Copy` (برای مثال برای `add_3`) و `Clone` (برای مثال " "`multiply_sum`) را بر اساس آنچه که closure به دست می‌آورد، استنتاج می‌کند." -#: src/std-traits/closures.md:58 +#: src/std-traits/closures.md msgid "" -"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." msgstr "" -"به‌طور پیش‌فرض، closure ها اگر بتوانند، با ارجاع (reference) مقادیر را " -"می‌گیرند. کلمه کلیدی `move` باعث می‌شود که آنها مقادیر را به‌صورت مالکیت (by " -"value) بگیرند." -#: src/std-traits/closures.md:63 src/smart-pointers/trait-objects.md:93 -#: src/smart-pointers/trait-objects.md:94 +#: src/std-traits/closures.md src/smart-pointers/trait-objects.md msgid "\"{} {}\"" msgstr "\"{} {}\"" -#: src/std-traits/closures.md:67 +#: src/std-traits/closures.md msgid "\"Hi\"" msgstr "\"Hi\"" -#: src/std-traits/closures.md:68 +#: src/std-traits/closures.md msgid "\"Greg\"" msgstr "\"Greg\"" -#: src/std-traits/exercise.md:3 +#: src/std-traits/exercise.md msgid "" "In this example, you will implement the classic [\"ROT13\" cipher](https://" "en.wikipedia.org/wiki/ROT13). Copy this code to the playground, and " @@ -7719,20 +7669,19 @@ msgstr "" "کرده و بخش‌های ناقص آن را پیاده‌سازی کنید. تنها حروف الفبای ASCII را بچرخانید " "تا نتیجه همچنان UTF-8 معتبر باقی بماند." -#: src/std-traits/exercise.md:15 +#: src/std-traits/exercise.md msgid "// Implement the `Read` trait for `RotDecoder`.\n" msgstr "// Implement the `Read` trait for `RotDecoder`.\n" -#: src/std-traits/exercise.md:20 src/std-traits/exercise.md:33 -#: src/std-traits/solution.md:26 src/std-traits/solution.md:39 +#: src/std-traits/exercise.md src/std-traits/solution.md msgid "\"Gb trg gb gur bgure fvqr!\"" msgstr "\"Gb trg gb gur bgure fvqr!\"" -#: src/std-traits/exercise.md:36 src/std-traits/solution.md:42 +#: src/std-traits/exercise.md src/std-traits/solution.md msgid "\"To get to the other side!\"" msgstr "\"To get to the other side!\"" -#: src/std-traits/exercise.md:55 +#: src/std-traits/exercise.md msgid "" "What happens if you chain two `RotDecoder` instances together, each rotating " "by 13 characters?" @@ -7740,7 +7689,7 @@ msgstr "" "چه اتفاقی می‌افتد اگر دو نمونه از `RotDecoder` را به‌هم متصل کنید که هر کدام " "۱۳ کاراکتر را بچرخانند؟" -#: src/std-traits/solution.md:16 +#: src/std-traits/solution.md msgid "'A'" msgstr "'A'" @@ -7772,7 +7721,7 @@ msgstr "" "با احتساب استراحت‌های ۱۰ دقیقه‌ای، این جلسه باید حدود ۲ ساعت و ۲۰ دقیقه طول " "بکشد. این جلسه شامل:" -#: src/memory-management.md src/memory-management/clone.md:1 +#: src/memory-management.md src/memory-management/clone.md msgid "Clone" msgstr "Clone" @@ -7780,49 +7729,49 @@ msgstr "Clone" msgid "Drop" msgstr "Drop" -#: src/memory-management/review.md:3 +#: src/memory-management/review.md msgid "Programs allocate memory in two ways:" msgstr "برنامه‌ها حافظه را به دو روش تخصیص می‌دهند:" -#: src/memory-management/review.md:5 +#: src/memory-management/review.md msgid "Stack: Continuous area of memory for local variables." msgstr "" "Stack: بلوک پیوسته‌ای از حافظه که برای متغیرهای محلی (داخل یک تابع) استفاده " "می‌شود." -#: src/memory-management/review.md:6 +#: src/memory-management/review.md msgid "Values have fixed sizes known at compile time." msgstr "مقادیر دارای اندازه‌های ثابتی هستند که در زمان کامپایل شناخته می‌شوند." -#: src/memory-management/review.md:7 +#: src/memory-management/review.md msgid "Extremely fast: just move a stack pointer." msgstr "بسیار سریع: فقط یک اشاره‌گر stack را جابجا کنید." -#: src/memory-management/review.md:8 +#: src/memory-management/review.md msgid "Easy to manage: follows function calls." msgstr "مدیریت آسان: پیرو فراخوانی‌های تابع است." -#: src/memory-management/review.md:9 +#: src/memory-management/review.md msgid "Great memory locality." msgstr "بهره‌وری عالی از حافظه" -#: src/memory-management/review.md:11 +#: src/memory-management/review.md msgid "Heap: Storage of values outside of function calls." msgstr "Heap: ذخیره‌سازی مقادیر خارج از فراخوانی‌های تابع." -#: src/memory-management/review.md:12 +#: src/memory-management/review.md msgid "Values have dynamic sizes determined at runtime." msgstr "مقادیر دارای اندازه‌های پویا هستند که در زمان اجرا تعیین می‌شوند." -#: src/memory-management/review.md:13 +#: src/memory-management/review.md msgid "Slightly slower than the stack: some book-keeping needed." msgstr "کمی کندتر از stack: نیاز به برخی از عملیات‌های مدیریتی دارد." -#: src/memory-management/review.md:14 +#: src/memory-management/review.md msgid "No guarantee of memory locality." msgstr "هیچ تضمینی برای بهره‌وری بالا از حافظه ندارد" -#: src/memory-management/review.md:18 +#: src/memory-management/review.md msgid "" "Creating a `String` puts fixed-sized metadata on the stack and dynamically " "sized data, the actual string, on the heap:" @@ -7830,7 +7779,7 @@ msgstr "" "ساختن یک `String` metadata با اندازه ثابت را روی stack و داده با اندازه " "پویا، یعنی رشته واقعی، را روی heap قرار می‌دهد:" -#: src/memory-management/review.md:44 +#: src/memory-management/review.md msgid "" "Mention that a `String` is backed by a `Vec`, so it has a capacity and " "length and can grow if mutable via reallocation on the heap." @@ -7839,7 +7788,7 @@ msgstr "" "طول است و در صورت تغییرپذیری، می‌تواند از طریق اختصاص مجدد حافظه روی heap رشد " "کند." -#: src/memory-management/review.md:47 +#: src/memory-management/review.md msgid "" "If students ask about it, you can mention that the underlying memory is heap " "allocated using the [System Allocator](https://doc.rust-lang.org/std/alloc/" @@ -7852,7 +7801,7 @@ msgstr "" "استفاده از [Allocator API](https://doc.rust-lang.org/std/alloc/index.html) " "پیاده‌سازی شوند" -#: src/memory-management/review.md:53 +#: src/memory-management/review.md msgid "" "We can inspect the memory layout with `unsafe` Rust. However, you should " "point out that this is rightfully unsafe!" @@ -7860,15 +7809,15 @@ msgstr "" "می‌توانیم با استفاده از Rust ناامن (unsafe) نحوه چیدمان حافظه را بررسی کنیم. " "با این حال، باید اشاره کنید که این کار به درستی ناامن است!" -#: src/memory-management/review.md:59 src/testing/unit-tests.md:15 +#: src/memory-management/review.md src/testing/unit-tests.md msgid "' '" msgstr "' '" -#: src/memory-management/review.md:60 +#: src/memory-management/review.md msgid "\"world\"" msgstr "\"دنیا\"" -#: src/memory-management/review.md:61 +#: src/memory-management/review.md msgid "" "// DON'T DO THIS AT HOME! For educational purposes only.\n" " // String provides no guarantees about its layout, so this could lead " @@ -7880,34 +7829,34 @@ msgstr "" "to\n" " // undefined behavior.\n" -#: src/memory-management/review.md:66 +#: src/memory-management/review.md msgid "\"capacity = {capacity}, ptr = {ptr:#x}, len = {len}\"" msgstr "\"capacity = {capacity}, ptr = {ptr:#x}, len = {len}\"" -#: src/memory-management/approaches.md:3 +#: src/memory-management/approaches.md msgid "Traditionally, languages have fallen into two broad categories:" msgstr "به طور سنتی، زبان‌ها به دو دسته گسترده تقسیم شده‌اند:" -#: src/memory-management/approaches.md:5 +#: src/memory-management/approaches.md msgid "Full control via manual memory management: C, C++, Pascal, ..." msgstr "کنترل کامل از طریق مدیریت دستی حافظه: C++، C، پاسکال، ..." -#: src/memory-management/approaches.md:6 +#: src/memory-management/approaches.md msgid "Programmer decides when to allocate or free heap memory." msgstr "برنامه‌نویس تصمیم می‌گیرد که چه زمانی حافظه heap را تخصیص یا آزاد کند." -#: src/memory-management/approaches.md:7 +#: src/memory-management/approaches.md msgid "" "Programmer must determine whether a pointer still points to valid memory." msgstr "" "برنامه‌نویس باید تعیین کند که آیا یک اشاره‌گر هنوز به حافظه معتبر اشاره می‌کند " "یا نه." -#: src/memory-management/approaches.md:8 +#: src/memory-management/approaches.md msgid "Studies show, programmers make mistakes." msgstr "مطالعات نشان می‌دهد که برنامه‌نویسان اشتباهاتی مرتکب می‌شوند." -#: src/memory-management/approaches.md:9 +#: src/memory-management/approaches.md msgid "" "Full safety via automatic memory management at runtime: Java, Python, Go, " "Haskell, ..." @@ -7915,7 +7864,7 @@ msgstr "" "ایمنی کامل از طریق مدیریت خودکار حافظه در زمان اجرا: جاوا، پایتون، گو، " "هسکل، ..." -#: src/memory-management/approaches.md:11 +#: src/memory-management/approaches.md msgid "" "A runtime system ensures that memory is not freed until it can no longer be " "referenced." @@ -7923,27 +7872,27 @@ msgstr "" "یک سیستم زمان اجرا اطمینان می‌یابد که حافظه تا زمانی که دیگر نتواند به آن " "ارجاع داده شود، آزاد نمی‌شود." -#: src/memory-management/approaches.md:13 -msgid "" -"Typically implemented with reference counting, garbage collection, or RAII." +#: src/memory-management/approaches.md +#, fuzzy +msgid "Typically implemented with reference counting or garbage collection." msgstr "" "معمولاً با استفاده از شمارش ارجاع، جمع‌آوری زباله، یا RAII پیاده‌سازی می‌شود." -#: src/memory-management/approaches.md:15 +#: src/memory-management/approaches.md msgid "Rust offers a new mix:" msgstr "Rust یک ترکیب جدید ارائه می‌دهد:" -#: src/memory-management/approaches.md:17 +#: src/memory-management/approaches.md msgid "" "Full control _and_ safety via compile time enforcement of correct memory " "management." msgstr "کنترل کامل و ایمنی از طریق اجرای صحیح مدیریت حافظه در زمان کامپایل." -#: src/memory-management/approaches.md:20 +#: src/memory-management/approaches.md msgid "It does this with an explicit ownership concept." msgstr "این کار را با استفاده از مفهوم مالکیت صریح انجام می‌دهد." -#: src/memory-management/approaches.md:25 +#: src/memory-management/approaches.md msgid "" "This slide is intended to help students coming from other languages to put " "Rust in context." @@ -7951,7 +7900,7 @@ msgstr "" "این اسلاید به منظور کمک به دانش‌آموزانی است که از زبان‌های دیگر می‌آیند تا Rust " "را در زمینه مناسب قرار دهند." -#: src/memory-management/approaches.md:28 +#: src/memory-management/approaches.md msgid "" "C must manage heap manually with `malloc` and `free`. Common errors include " "forgetting to call `free`, calling it multiple times for the same pointer, " @@ -7962,7 +7911,7 @@ msgstr "" "اشاره‌گر، یا dereference کردن یک اشاره‌گر پس از آزاد شدن حافظه‌ای است که به آن " "اشاره می‌کند." -#: src/memory-management/approaches.md:32 +#: src/memory-management/approaches.md msgid "" "C++ has tools like smart pointers (`unique_ptr`, `shared_ptr`) that take " "advantage of language guarantees about calling destructors to ensure memory " @@ -7975,7 +7924,7 @@ msgstr "" "بسیار آسان است که از این ابزارها به اشتباه استفاده کرده و باگ‌هایی مشابه به C " "ایجاد کرد." -#: src/memory-management/approaches.md:37 +#: src/memory-management/approaches.md msgid "" "Java, Go, and Python rely on the garbage collector to identify memory that " "is no longer reachable and discard it. This guarantees that any pointer can " @@ -7988,7 +7937,7 @@ msgstr "" "آزادسازی (use-after-free) و سایر دسته‌های باگ جلوگیری می‌کند. اما، GC هزینه‌ای " "در زمان اجرا دارد و تنظیم مناسب آن دشوار است." -#: src/memory-management/approaches.md:42 +#: src/memory-management/approaches.md msgid "" "Rust's ownership and borrowing model can, in many cases, get the performance " "of C, with alloc and free operations precisely where they are required -- " @@ -8004,7 +7953,7 @@ msgstr "" "دسترس هستند و حتی crates شخص ثالثی برای پشتیبانی از جمع‌آوری زباله در زمان " "اجرا موجود است (که در این کلاس پوشش داده نمی‌شود)." -#: src/memory-management/ownership.md:3 +#: src/memory-management/ownership.md msgid "" "All variable bindings have a _scope_ where they are valid and it is an error " "to use a variable outside its scope:" @@ -8012,7 +7961,7 @@ msgstr "" "تمام پیوندهای متغیر دارای یک **دامنه** هستند که در آن معتبر هستند و استفاده " "از متغیر خارج از دامنه‌اش یک خطاست:" -#: src/memory-management/ownership.md:20 +#: src/memory-management/ownership.md msgid "" "We say that the variable _owns_ the value. Every Rust value has precisely " "one owner at all times." @@ -8020,7 +7969,7 @@ msgstr "" "می‌گوییم که متغیر _مالک_ مقدار است. هر مقدار در Rust در هر لحظه دقیقاً یک مالک " "دارد." -#: src/memory-management/ownership.md:23 +#: src/memory-management/ownership.md 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." @@ -8028,7 +7977,7 @@ msgstr "" "در پایان دامنه، متغیر **حذف** می‌شود و داده‌ها آزاد می‌شوند. یک ویرایشگر " "(destructor) می‌تواند در اینجا اجرا شود تا منابع را آزاد کند." -#: src/memory-management/ownership.md:29 +#: src/memory-management/ownership.md msgid "" "Students familiar with garbage-collection implementations will know that a " "garbage collector starts with a set of \"roots\" to find all reachable " @@ -8038,41 +7987,41 @@ msgstr "" "جمع‌آوری‌کننده زباله با مجموعه‌ای از \"ریشه‌ها\" برای یافتن تمام حافظه‌های قابل " "دسترسی شروع می‌کند. اصول \"مالکیت تک‌گانه\" Rust ایده مشابهی است." -#: src/memory-management/move.md:3 +#: src/memory-management/move.md msgid "An assignment will transfer _ownership_ between variables:" msgstr "انتساب, *مالکیت* را بین متغیرها منتقل می‌کند:" -#: src/memory-management/move.md:7 +#: src/memory-management/move.md src/concurrency/async-control-flow/select.md msgid "\"Hello!\"" msgstr "\"سلام!\"" -#: src/memory-management/move.md:10 +#: src/memory-management/move.md msgid "// println!(\"s1: {s1}\");\n" msgstr "// println!(\"s1: {s1}\");\n" -#: src/memory-management/move.md:14 +#: src/memory-management/move.md msgid "The assignment of `s1` to `s2` transfers ownership." msgstr "انتساب `s1`به `s2` مالکیت را منتقل می‌کند." -#: src/memory-management/move.md:15 +#: src/memory-management/move.md msgid "When `s1` goes out of scope, nothing happens: it does not own anything." msgstr "" "زمانی که دیگر در اسکوپ `s1` نیستیم, هیچ اتفاقی نمی‌افتد: چون `s1` مالک چیزی " "نیست." -#: src/memory-management/move.md:16 +#: src/memory-management/move.md msgid "When `s2` goes out of scope, the string data is freed." msgstr "زمانی که دیگر در اسکوپ `s2` نیستیم, داده‌های رشته آزاد می‌شوند." -#: src/memory-management/move.md:18 +#: src/memory-management/move.md msgid "Before move to `s2`:" msgstr "قبل از انتقال به `s2` :" -#: src/memory-management/move.md:35 +#: src/memory-management/move.md msgid "After move to `s2`:" msgstr "بعد از انتقال به `s2` :" -#: src/memory-management/move.md:37 +#: src/memory-management/move.md msgid "" "```bob\n" " Stack Heap\n" @@ -8096,7 +8045,7 @@ msgid "" "```" msgstr "" -#: src/memory-management/move.md:58 +#: src/memory-management/move.md msgid "" "When you pass a value to a function, the value is assigned to the function " "parameter. This transfers ownership:" @@ -8104,20 +8053,20 @@ msgstr "" "هنگامی که یک مقدار را به یک تابع منتقل می‌کنید، مقدار به آرگمان تابع اختصاص " "داده می‌شود. به این شکل مالکیت را منتقل می‌کند:" -#: src/memory-management/move.md:63 src/memory-management/clone.md:8 +#: src/memory-management/move.md src/memory-management/clone.md msgid "\"Hello {name}\"" msgstr "\"سلام {name}\"" -#: src/memory-management/move.md:67 src/memory-management/clone.md:12 -#: src/android/interoperability/java.md:57 +#: src/memory-management/move.md src/memory-management/clone.md +#: src/android/interoperability/java.md msgid "\"Alice\"" msgstr "\"الیس\"" -#: src/memory-management/move.md:69 +#: src/memory-management/move.md msgid "// say_hello(name);\n" msgstr "// say_hello(name);\n" -#: src/memory-management/move.md:76 +#: src/memory-management/move.md msgid "" "Mention that this is the opposite of the defaults in C++, which copies by " "value unless you use `std::move` (and the move constructor is defined!)." @@ -8126,7 +8075,7 @@ msgstr "" "است که در ان مقدار کپی میشود مگر که از `std::move` " "استفاده کنیم ( تا یک مقدار را جا به جا کنیم!)" -#: src/memory-management/move.md:79 +#: src/memory-management/move.md msgid "" "It is only the ownership that moves. Whether any machine code is generated " "to manipulate the data itself is a matter of optimization, and such copies " @@ -8136,22 +8085,22 @@ msgstr "" "خود داده‌ها تولید می‌شود یا خیر، موضوعی برای بهینه‌سازی است و چنین کپی‌هایی " "به‌طور تهاجمی (aggressively) بهینه‌سازی می‌شوند." -#: src/memory-management/move.md:83 +#: src/memory-management/move.md msgid "" "Simple values (such as integers) can be marked `Copy` (see later slides)." msgstr "" "مقادیر ساده (مانند اعداد صحیح) را می‌توان `Copy` کرد (اسلایدهای بعدی را " "ببینید)." -#: src/memory-management/move.md:85 +#: src/memory-management/move.md msgid "In Rust, clones are explicit (by using `clone`)." msgstr "در Rust، کلون‌ها واضح بیان می‌شوند (با استفاده از `clone`)." -#: src/memory-management/move.md:87 +#: src/memory-management/move.md msgid "In the `say_hello` example:" msgstr "در مثال `say_hello`:" -#: src/memory-management/move.md:89 +#: src/memory-management/move.md msgid "" "With the first call to `say_hello`, `main` gives up ownership of `name`. " "Afterwards, `name` cannot be used anymore within `main`." @@ -8159,7 +8108,7 @@ msgstr "" "با اولین فراخوانی `say_hello`، تابع `main` مالکیت `name` را انتقال می‌دهد. پس " "از آن، `name` دیگر نمی‌تواند در `main` استفاده شود." -#: src/memory-management/move.md:91 +#: src/memory-management/move.md msgid "" "The heap memory allocated for `name` will be freed at the end of the " "`say_hello` function." @@ -8167,7 +8116,7 @@ msgstr "" "حافظه انباشت اختصاص داده شده برای `name` در انتهای تابع `say_hello` آزاد " "خواهد شد." -#: src/memory-management/move.md:93 +#: src/memory-management/move.md msgid "" "`main` can retain ownership if it passes `name` as a reference (`&name`) and " "if `say_hello` accepts a reference as a parameter." @@ -8176,7 +8125,7 @@ msgstr "" "(`&name`) منتقل کند و صد البته که `say_hello` یک مرجع " "را به عنوان پارامتر باید بپذیرد." -#: src/memory-management/move.md:95 +#: src/memory-management/move.md msgid "" "Alternatively, `main` can pass a clone of `name` in the first call (`name." "clone()`)." @@ -8184,7 +8133,7 @@ msgstr "" "به عنوان گزینه دیگر، `main` می‌تواند یک کلون از `name` را در فراخوانی اولیه " "تابع ای که در نظر داریم (`name.clone()`) منتقل کند." -#: src/memory-management/move.md:97 +#: src/memory-management/move.md msgid "" "Rust makes it harder than C++ to inadvertently create copies by making move " "semantics the default, and by forcing programmers to make clones explicit." @@ -8193,44 +8142,44 @@ msgstr "" "زیر به صورت پیش‌فرض از مفهوم «انتقال» استفاده میکنیم و برنامه نویس مجبور است " "هر جا که لازم هست به صورت صریح کلون را ایجاد کند." -#: src/memory-management/move.md:102 +#: src/memory-management/move.md msgid "Defensive Copies in Modern C++" msgstr "کپی‌های تدافعی در C++ مدرن" -#: src/memory-management/move.md:104 +#: src/memory-management/move.md msgid "Modern C++ solves this differently:" msgstr "C++ مدرن این مشکل را به شیوه متفاوتی حل می‌کند:" -#: src/memory-management/move.md:107 +#: src/memory-management/move.md msgid "\"Cpp\"" msgstr "\"Cpp\"" -#: src/memory-management/move.md:108 +#: src/memory-management/move.md msgid "// Duplicate the data in s1.\n" msgstr "// Duplicate the data in s1.\n" -#: src/memory-management/move.md:111 +#: src/memory-management/move.md msgid "" "The heap data from `s1` is duplicated and `s2` gets its own independent copy." msgstr "" "داده‌های انباشت از داده‌های `s1` یک کپی برابر اصل برای `s2` گرفته می‌شود که " "این کپی به صورت مستقل است." -#: src/memory-management/move.md:112 +#: src/memory-management/move.md msgid "When `s1` and `s2` go out of scope, they each free their own memory." msgstr "" "حالا هر موقع `s1` یا `s2` از اسکوپ موردنظرشون خارج شوند هر کدام به صورت " "جداگانه‌ای حافظه خود را آزاد میکنند." -#: src/memory-management/move.md:114 +#: src/memory-management/move.md msgid "Before copy-assignment:" msgstr "قبل از انتساب همراه کپی:" -#: src/memory-management/move.md:130 +#: src/memory-management/move.md msgid "After copy-assignment:" msgstr "بعد از انتساب همراه کپی:" -#: src/memory-management/move.md:155 +#: src/memory-management/move.md msgid "" "C++ has made a slightly different choice than Rust. Because `=` copies data, " "the string data has to be cloned. Otherwise we would get a double-free when " @@ -8241,7 +8190,7 @@ msgstr "" "این صورت، هر موقع از اسکوپ یکی از آنها خارج شویم امکان به وجود آمدن اشتباه " "آزادسازی مجدد حافظه رخ دهد." -#: src/memory-management/move.md:159 +#: src/memory-management/move.md msgid "" "C++ also has [`std::move`](https://en.cppreference.com/w/cpp/utility/move), " "which is used to indicate when a value may be moved from. If the example had " @@ -8256,7 +8205,7 @@ msgstr "" "نامشخص قرار میگرفت و برخلاف زبان Rust, توی زبان C++ " "برنامه‌نویس مجاز است که دوباره از `s1` استفاده کند." -#: src/memory-management/move.md:164 +#: src/memory-management/move.md msgid "" "Unlike Rust, `=` in C++ can run arbitrary code as determined by the type " "which is being copied or moved." @@ -8264,7 +8213,7 @@ msgstr "" "بر خلاف Rust، `=` در C++ می‌تواند برای کپی کردن و هم " "انتقال دادن استفاده شود." -#: src/memory-management/clone.md:3 +#: src/memory-management/clone.md msgid "" "Sometimes you _want_ to make a copy of a value. The `Clone` trait " "accomplishes this." @@ -8272,7 +8221,7 @@ msgstr "" "گاهی اوقات شما _می‌خواهید_ یک نسخه از مقدار بسازید. ویژگی `Clone` این کار را " "انجام می‌دهد." -#: src/memory-management/clone.md:21 +#: src/memory-management/clone.md 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`." @@ -8280,7 +8229,7 @@ msgstr "" "ایده‌ی `Clone` این است که شناسایی مکان‌های تخصیص حافظه heap آسان‌تر شود. به " "دنبال `()clone.` و چند مورد دیگر مانند `!vec` یا `Box::new` بگردید." -#: src/memory-management/clone.md:24 +#: src/memory-management/clone.md 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." @@ -8288,7 +8237,7 @@ msgstr "" "معمولاً برای حل مشکلات مربوط به بررسی‌کننده قرض‌گیری (borrow checker) از کپی " "کردن استفاده می‌شود و سپس در آینده تلاش می‌شود تا آن کپی‌ها بهینه‌سازی شوند." -#: src/memory-management/clone.md:27 +#: 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." @@ -8296,7 +8245,7 @@ msgstr "" "`clone` معمولاً یک کپی عمیق از مقدار را انجام می‌دهد، به این معنی که اگر به " "عنوان مثال یک آرایه را کپی کنید، تمام عناصر آن آرایه نیز کپی خواهند شد." -#: src/memory-management/clone.md:30 +#: src/memory-management/clone.md msgid "" "The behavior for `clone` is user-defined, so it can perform custom cloning " "logic if needed." @@ -8304,36 +8253,36 @@ msgstr "" "رفتار `clone` توسط کاربر تعریف می‌شود، بنابراین می‌تواند در صورت نیاز، منطق " "کپی‌برداری سفارشی را اجرا کند." -#: src/memory-management/copy-types.md:3 +#: src/memory-management/copy-types.md msgid "" "While move semantics are the default, certain types are copied by default:" msgstr "" "در حالی که مفهوم انتقال به صورت پیش‌فرض است، در زبان راست چند نوع خاص به " "صورت پیش‌فرض کپی می‌شوند:" -#: src/memory-management/copy-types.md:16 +#: src/memory-management/copy-types.md msgid "These types implement the `Copy` trait." msgstr "این انواع‌داده ویژگی `Copy` را پیاده‌سازی کرده‌اند." -#: src/memory-management/copy-types.md:18 +#: src/memory-management/copy-types.md msgid "You can opt-in your own types to use copy semantics:" msgstr "البته که میتوان برای نوع‌هایی که میسازید هم مفهوم کپی را داشته باشید:" -#: src/memory-management/copy-types.md:34 +#: src/memory-management/copy-types.md msgid "After the assignment, both `p1` and `p2` own their own data." msgstr "پس از انتساب، هر دو `p1` و `p2` داده‌های خود مستقل خود را دارند." -#: src/memory-management/copy-types.md:35 +#: src/memory-management/copy-types.md msgid "We can also use `p1.clone()` to explicitly copy the data." msgstr "" "همچنین می‌توانیم از `p1.clone()` برای کپی صریح داده‌ها " "استفاده کنیم." -#: src/memory-management/copy-types.md:40 +#: src/memory-management/copy-types.md msgid "Copying and cloning are not the same thing:" msgstr "کپی‌برداری و کلون‌سازی یکسان نیستند:" -#: src/memory-management/copy-types.md:42 +#: src/memory-management/copy-types.md msgid "" "Copying refers to bitwise copies of memory regions and does not work on " "arbitrary objects." @@ -8341,14 +8290,14 @@ msgstr "" "کپی‌برداری به کپی‌های بیت به بیت از مناطق حافظه اشاره دارد و روی همه انواع " "تعریف شده توسط شما کار نمی‌کند." -#: src/memory-management/copy-types.md:44 +#: src/memory-management/copy-types.md msgid "" "Copying does not allow for custom logic (unlike copy constructors in C++)." msgstr "" "کپی‌برداری اجازه منطق سفارشی را نمی‌دهد (بر خلاف کپی constructors در C++)." -#: src/memory-management/copy-types.md:45 +#: src/memory-management/copy-types.md msgid "" "Cloning is a more general operation and also allows for custom behavior by " "implementing the `Clone` trait." @@ -8356,16 +8305,16 @@ msgstr "" "کلون‌سازی یک عملیات عمومی‌تر است و همچنین با پیاده‌سازی ویژگی `Clone` امکان " "رفتار سفارشی را فراهم می‌کند." -#: src/memory-management/copy-types.md:47 +#: src/memory-management/copy-types.md msgid "Copying does not work on types that implement the `Drop` trait." msgstr "" "کپی‌برداری روی انواع داده‌ای که ویژگی Drop را پیاده سازی کرده اند کار نمی‌کند." -#: src/memory-management/copy-types.md:49 +#: src/memory-management/copy-types.md msgid "In the above example, try the following:" msgstr "در مثال بالا، موارد زیر را امتحان کنید:" -#: src/memory-management/copy-types.md:51 +#: src/memory-management/copy-types.md msgid "" "Add a `String` field to `struct Point`. It will not compile because `String` " "is not a `Copy` type." @@ -8373,7 +8322,7 @@ msgstr "" "یک فیلد `String` به `struct Point` اضافه کنید. کامپایل نمی‌شود زیرا `String` " "یک نوع `Copy` نیست." -#: src/memory-management/copy-types.md:53 +#: src/memory-management/copy-types.md msgid "" "Remove `Copy` from the `derive` attribute. The compiler error is now in the " "`println!` for `p1`." @@ -8381,11 +8330,11 @@ msgstr "" "ویژگی `Copy` را از صفت `derive` حذف کنید. اکنون خطای کامپایلر در `!println` " "برای `p1` قرار دارد." -#: src/memory-management/copy-types.md:55 +#: src/memory-management/copy-types.md msgid "Show that it works if you clone `p1` instead." msgstr "نشان دهید که اگر `p1` را به جای کپی آن کلون کنید، کار می‌کند." -#: src/memory-management/copy-types.md:59 +#: 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 " @@ -8398,11 +8347,11 @@ msgstr "" "که کپی کردن یک ارجاع مشترک معتبر است، ایجاد یک کپی از یک ارجاع قابل تغییر " "قوانین قرض‌گیری Rust را نقض می‌کند." -#: src/memory-management/drop.md:1 +#: src/memory-management/drop.md msgid "The `Drop` Trait" msgstr "ویژگی `Drop`" -#: src/memory-management/drop.md:3 +#: src/memory-management/drop.md 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:" @@ -8411,50 +8360,49 @@ msgstr "" "را پیاده‌سازی می‌کنند می‌توانند کدی را مشخص کنند که هنگام خروج از دامنه اجرا " "شود:" -#: src/memory-management/drop.md:13 +#: src/memory-management/drop.md msgid "\"Dropping {}\"" msgstr "\"Dropping {}\"" -#: src/memory-management/drop.md:18 -#: src/concurrency/sync-exercises/link-checker.md:85 -#: src/concurrency/sync-exercises/solutions.md:121 +#: 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:20 src/android/testing/googletest.md:12 +#: src/memory-management/drop.md src/android/testing/googletest.md msgid "\"b\"" msgstr "\"a\"" -#: src/memory-management/drop.md:22 +#: src/memory-management/drop.md msgid "\"c\"" msgstr "\"a\"" -#: src/memory-management/drop.md:23 +#: src/memory-management/drop.md msgid "\"d\"" msgstr "\"a\"" -#: src/memory-management/drop.md:24 +#: src/memory-management/drop.md msgid "\"Exiting block B\"" msgstr "\"Exiting block B\"" -#: src/memory-management/drop.md:26 +#: src/memory-management/drop.md msgid "\"Exiting block A\"" msgstr "\"Exiting block A\"" -#: src/memory-management/drop.md:29 +#: src/memory-management/drop.md msgid "\"Exiting main\"" msgstr "\"Exiting main\"" -#: src/memory-management/drop.md:36 +#: src/memory-management/drop.md 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 +#: src/memory-management/drop.md msgid "Values are automatically dropped when they go out of scope." msgstr "مقادیر به طور خودکار زمانی که از دامنه خارج می‌شوند، حذف می‌شوند." -#: src/memory-management/drop.md:38 +#: src/memory-management/drop.md msgid "" "When a value is dropped, if it implements `std::ops::Drop` then its `Drop::" "drop` implementation will be called." @@ -8462,14 +8410,14 @@ msgstr "" "زمانی که یک مقدار حذف می‌شود، اگر آن مقدار ویژگی `std::ops::Drop` را " "پیاده‌سازی کرده باشد، پیاده‌سازی `Drop::drop` آن فراخوانی خواهد شد." -#: src/memory-management/drop.md:40 +#: src/memory-management/drop.md msgid "" "All its fields will then be dropped too, whether or not it implements `Drop`." msgstr "" "تمام فیلدهای آن نیز سپس حذف خواهند شد، چه آن مقدار ویژگی `Drop` را پیاده‌سازی " "کرده باشد یا نه." -#: src/memory-management/drop.md:41 +#: src/memory-management/drop.md msgid "" "`std::mem::drop` is just an empty function that takes any value. The " "significance is that it takes ownership of the value, so at the end of its " @@ -8481,7 +8429,7 @@ msgstr "" "این ویژگی آن را به روشی مناسب برای حذف صریح مقادیر پیش از آنچه که معمولاً از " "دامنه خارج می‌شوند، تبدیل می‌کند." -#: src/memory-management/drop.md:45 +#: src/memory-management/drop.md msgid "" "This can be useful for objects that do some work on `drop`: releasing locks, " "closing files, etc." @@ -8489,11 +8437,11 @@ msgstr "" "این می‌تواند برای اشیائی که در هنگام `drop` کاری انجام می‌دهند مفید باشد: آزاد " "کردن قفل‌ها، بستن فایل‌ها و غیره." -#: src/memory-management/drop.md:50 +#: src/memory-management/drop.md msgid "Why doesn't `Drop::drop` take `self`?" msgstr "چرا `Drop::drop` `self` را نمی‌گیرد؟" -#: src/memory-management/drop.md:51 +#: src/memory-management/drop.md 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!" @@ -8502,11 +8450,11 @@ msgstr "" "منجر به فراخوانی مجدد `Drop::drop` و ایجاد خطای سرریز (stack overflow) stack " "می‌شد!" -#: src/memory-management/drop.md:53 +#: src/memory-management/drop.md msgid "Try replacing `drop(a)` with `a.drop()`." msgstr "سعی کنید `drop(a)` را با `()a.drop` جایگزین کنید." -#: src/memory-management/exercise.md:3 +#: src/memory-management/exercise.md msgid "" "In this example, we will implement a complex data type that owns all of its " "data. We will use the \"builder pattern\" to support building a new value " @@ -8516,102 +8464,102 @@ msgstr "" "داده‌های خود است. ما از \"الگوی سازنده\" برای پشتیبانی از ساخت یک مقدار جدید " "به صورت قطعه‌قطعه، با استفاده از توابع کمکی، استفاده خواهیم کرد." -#: src/memory-management/exercise.md:7 +#: src/memory-management/exercise.md msgid "Fill in the missing pieces." msgstr "جا‌های خالی را پر کنید." -#: src/memory-management/exercise.md:22 src/memory-management/solution.md:16 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "/// A representation of a software package.\n" msgstr "" -#: src/memory-management/exercise.md:34 src/memory-management/solution.md:28 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "" "/// Return a representation of this package as a dependency, for use in\n" " /// building other packages.\n" msgstr "" -#: src/memory-management/exercise.md:37 +#: src/memory-management/exercise.md msgid "\"1\"" msgstr "" -#: src/memory-management/exercise.md:40 src/memory-management/solution.md:37 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "" "/// A builder for a Package. Use `build()` to create the `Package` itself.\n" msgstr "" -#: src/memory-management/exercise.md:46 +#: src/memory-management/exercise.md msgid "\"2\"" msgstr "" -#: src/memory-management/exercise.md:49 src/memory-management/solution.md:52 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "/// Set the package version.\n" msgstr "" -#: src/memory-management/exercise.md:55 src/memory-management/solution.md:58 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "/// Set the package authors.\n" msgstr "" -#: src/memory-management/exercise.md:57 +#: src/memory-management/exercise.md msgid "\"3\"" msgstr "" -#: src/memory-management/exercise.md:60 src/memory-management/solution.md:64 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "/// Add an additional dependency.\n" msgstr "" -#: src/memory-management/exercise.md:62 +#: src/memory-management/exercise.md msgid "\"4\"" msgstr "" -#: src/memory-management/exercise.md:65 src/memory-management/solution.md:70 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "/// Set the language. If not set, language defaults to None.\n" msgstr "" -#: src/memory-management/exercise.md:67 +#: src/memory-management/exercise.md msgid "\"5\"" msgstr "" -#: src/memory-management/exercise.md:76 src/memory-management/solution.md:82 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "\"base64\"" msgstr "" -#: src/memory-management/exercise.md:76 src/memory-management/solution.md:82 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "\"0.13\"" msgstr "" -#: src/memory-management/exercise.md:77 src/memory-management/solution.md:83 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "\"base64: {base64:?}\"" msgstr "" -#: src/memory-management/exercise.md:79 src/memory-management/solution.md:85 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "\"log\"" msgstr "" -#: src/memory-management/exercise.md:79 src/memory-management/solution.md:85 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "\"0.4\"" msgstr "" -#: src/memory-management/exercise.md:80 src/memory-management/solution.md:86 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "\"log: {log:?}\"" msgstr "" -#: src/memory-management/exercise.md:81 src/memory-management/solution.md:87 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "\"serde\"" msgstr "" -#: src/memory-management/exercise.md:82 src/memory-management/solution.md:88 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "\"djmitche\"" msgstr "" -#: src/memory-management/exercise.md:83 src/memory-management/solution.md:89 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "\"4.0\"" msgstr "" -#: src/memory-management/exercise.md:87 src/memory-management/solution.md:93 +#: src/memory-management/exercise.md src/memory-management/solution.md msgid "\"serde: {serde:?}\"" msgstr "" -#: src/memory-management/solution.md:45 +#: src/memory-management/solution.md msgid "\"0.1\"" msgstr "" @@ -8623,7 +8571,7 @@ msgstr "Box" msgid "Rc" msgstr "Rc" -#: src/smart-pointers/box.md:3 +#: src/smart-pointers/box.md msgid "" "[`Box`](https://doc.rust-lang.org/std/boxed/struct.Box.html) is an owned " "pointer to data on the heap:" @@ -8631,11 +8579,11 @@ msgstr "" "[`Box`](https://doc.rust-lang.org/std/boxed/struct.Box.html) یک اشاره‌گر مالک " "به داده‌های روی heap است:" -#: src/smart-pointers/box.md:9 +#: src/smart-pointers/box.md msgid "\"five: {}\"" msgstr "" -#: src/smart-pointers/box.md:26 +#: src/smart-pointers/box.md msgid "" "`Box` implements `Deref`, which means that you can [call " "methods from `T` directly on a `Box`](https://doc.rust-lang.org/std/ops/" @@ -8645,26 +8593,28 @@ msgstr "" "می‌توانید [مستقیم روش‌های `T` را روی `>` has the same size, as just `Box`, because " "compiler uses NULL-value to discriminate variants instead of using explicit " @@ -8772,27 +8722,27 @@ msgstr "" "می‌کند ([\"بهینه‌سازی اشاره‌گر خالی\"](https://doc.rust-lang.org/std/option/" "#representation)):" -#: src/smart-pointers/box.md:103 +#: src/smart-pointers/box.md msgid "\"Just box\"" msgstr "\"Just box\"" -#: src/smart-pointers/box.md:105 +#: src/smart-pointers/box.md msgid "\"Optional box\"" msgstr "\"Optional box\"" -#: src/smart-pointers/box.md:111 +#: src/smart-pointers/box.md msgid "\"Size of just_box: {}\"" msgstr "\"Size of just_box: {}\"" -#: src/smart-pointers/box.md:112 +#: src/smart-pointers/box.md msgid "\"Size of optional_box: {}\"" msgstr "\"Size of optional_box: {}\"" -#: src/smart-pointers/box.md:113 +#: src/smart-pointers/box.md msgid "\"Size of none: {}\"" msgstr "\"Size of none: {}\"" -#: src/smart-pointers/rc.md:3 +#: src/smart-pointers/rc.md msgid "" "[`Rc`](https://doc.rust-lang.org/std/rc/struct.Rc.html) is a reference-" "counted shared pointer. Use this when you need to refer to the same data " @@ -8802,15 +8752,15 @@ msgstr "" "شمارش ارجاع است. از این هنگام استفاده کنید که نیاز دارید به داده‌های یکسان از " "مکان‌های متعدد اشاره کنید:" -#: src/smart-pointers/rc.md:13 +#: src/smart-pointers/rc.md msgid "\"a: {a}\"" msgstr "\"a: {a}\"" -#: src/smart-pointers/rc.md:14 +#: src/smart-pointers/rc.md msgid "\"b: {b}\"" msgstr "\"b: {b}\"" -#: src/smart-pointers/rc.md:18 +#: src/smart-pointers/rc.md msgid "" "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 " @@ -8820,7 +8770,7 @@ msgstr "" "shared-state/arc.md) و [`Mutex`](https://doc.rust-lang.org/std/sync/struct." "Mutex.html) نگاه کنید." -#: src/smart-pointers/rc.md:19 +#: src/smart-pointers/rc.md msgid "" "You can _downgrade_ a shared pointer into a [`Weak`](https://doc.rust-lang." "org/std/rc/struct.Weak.html) pointer to create cycles that will get dropped." @@ -8829,7 +8779,7 @@ msgstr "" "lang.org/std/rc/struct.Weak.html) تغییر دهید تا دوره‌هایی ایجاد کنید که در " "نهایت حذف خواهند شد." -#: src/smart-pointers/rc.md:30 +#: src/smart-pointers/rc.md msgid "" "`Rc`'s count ensures that its contained value is valid for as long as there " "are references." @@ -8837,11 +8787,11 @@ msgstr "" "شمارش `Rc` تضمین می‌کند که مقدار درون آن به مدت زمانی که ارجاع‌هایی وجود دارد، " "معتبر خواهد بود." -#: src/smart-pointers/rc.md:32 +#: src/smart-pointers/rc.md msgid "`Rc` in Rust is like `std::shared_ptr` in C++." msgstr "`Rc` در Rust مشابه `std::shared_ptr` در ++C است." -#: src/smart-pointers/rc.md:33 +#: src/smart-pointers/rc.md msgid "" "`Rc::clone` is cheap: it creates a pointer to the same allocation and " "increases the reference count. Does not make a deep clone and can generally " @@ -8852,7 +8802,7 @@ msgstr "" "نمی‌دهد و به طور کلی هنگام جستجو برای مسائل عملکردی در کد می‌توان آن را نادیده " "گرفت." -#: src/smart-pointers/rc.md:36 +#: src/smart-pointers/rc.md msgid "" "`make_mut` actually clones the inner value if necessary (\"clone-on-write\") " "and returns a mutable reference." @@ -8860,11 +8810,11 @@ msgstr "" "`make_mut` در واقع در صورت نیاز مقدار درونی را کپی می‌کند (\"clone-on-" "write\") و یک ارجاع قابل تغییر (mutable reference) برمی‌گرداند." -#: src/smart-pointers/rc.md:38 +#: src/smart-pointers/rc.md msgid "Use `Rc::strong_count` to check the reference count." msgstr "از `Rc::strong_count` برای بررسی شمارش ارجاع‌ها استفاده کنید." -#: src/smart-pointers/rc.md:39 +#: src/smart-pointers/rc.md msgid "" "`Rc::downgrade` gives you a _weakly reference-counted_ object to create " "cycles that will be dropped properly (likely in combination with `RefCell`)." @@ -8872,7 +8822,7 @@ msgstr "" "`Rc::downgrade` یک شیء _با شمارش ارجاع ضعیف_ به شما می‌دهد تا دوره‌هایی ایجاد " "کنید که به درستی حذف خواهند شد (احتمالاً به همراه `RefCell`)." -#: src/smart-pointers/trait-objects.md:3 +#: src/smart-pointers/trait-objects.md msgid "" "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` " @@ -8883,11 +8833,11 @@ msgstr "" "هوشمند مانند `Box` نیز استفاده کنیم تا یک شیء ویژگی مالک (owned trait " "object) ایجاد کنیم: `` in the example above." @@ -8956,7 +8906,7 @@ msgstr "" "باشند. این موضوع باعث می‌شود که داشتن مواردی مانند ` and fill in the missing " "method:" @@ -9362,25 +9332,23 @@ msgstr "" "کد زیر را به کپی کنید و متد‌های ناقص را تکمیل " "کنید:" -#: src/borrowing/exercise.md:45 +#: src/borrowing/exercise.md msgid "" "\"Update a user's statistics based on measurements from a visit to the " "doctor\"" msgstr "" -#: src/borrowing/exercise.md:50 src/borrowing/exercise.md:56 -#: src/borrowing/exercise.md:60 src/borrowing/solution.md:52 -#: src/borrowing/solution.md:58 src/borrowing/solution.md:62 -#: src/android/build-rules/library.md:44 -#: src/android/aidl/example-service/client.md:15 +#: src/borrowing/exercise.md src/borrowing/solution.md +#: src/android/build-rules/library.md +#: src/android/aidl/example-service/client.md msgid "\"Bob\"" msgstr "" -#: src/borrowing/exercise.md:51 src/borrowing/solution.md:53 +#: src/borrowing/exercise.md src/borrowing/solution.md msgid "\"I'm {} and my age is {}\"" msgstr "" -#: src/lifetimes/lifetime-annotations.md:3 +#: src/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." @@ -9388,7 +9356,7 @@ msgstr "" "یک مرجع دارای _طول عمر_ است که نباید از ارزش مورد اشاره بیشتر باشد. این " "موضوع توسط بررسی‌کننده قرض‌ها تایید می‌شود." -#: src/lifetimes/lifetime-annotations.md:6 +#: src/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 " @@ -9400,7 +9368,7 @@ msgstr "" "`'` شروع می‌شوند و `'a` نام پیش‌فرض معمولی است. `&'a Point` را به عنوان \"یک " "`Point` قرضی که برای حداقل طول عمر `a` معتبر است\" بخوانید." -#: src/lifetimes/lifetime-annotations.md:11 +#: src/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 " @@ -9410,7 +9378,7 @@ msgstr "" "عمر را اختصاص دهید. انتساب‌های صریح طول عمر محدودیت‌هایی ایجاد می‌کنند که در " "صورت وجود ابهام است؛ کامپایلر تأیید می‌کند که یک راه‌حل معتبر وجود دارد." -#: src/lifetimes/lifetime-annotations.md:15 +#: src/lifetimes/lifetime-annotations.md msgid "" "Lifetimes become more complicated when considering passing values to and " "returning values from functions." @@ -9418,15 +9386,15 @@ msgstr "" "طول عمرها وقتی که به عبور مقادیر به توابع و بازگشت مقادیر از توابع می‌پردازیم " "پیچیده‌تر می‌شوند." -#: src/lifetimes/lifetime-annotations.md:36 +#: src/lifetimes/lifetime-annotations.md msgid "// What is the lifetime of p3?\n" msgstr "" -#: src/lifetimes/lifetime-annotations.md:37 +#: src/lifetimes/lifetime-annotations.md msgid "\"p3: {p3:?}\"" msgstr "" -#: src/lifetimes/lifetime-annotations.md:44 +#: 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 " @@ -9439,11 +9407,11 @@ msgstr "" "`p3` کوتاه‌تر از `p1` و `p2` است. اما مانند تایپ‌ها، راست نیاز به توضیحات صریح " "طول عمرها در آرگومان‌های تابع و مقادیر بازگشتی دارد." -#: src/lifetimes/lifetime-annotations.md:50 +#: src/lifetimes/lifetime-annotations.md msgid "Add `'a` appropriately to `left_most`:" msgstr "به تابع `left_most` به صورت مناسب `'a` را اضافه کنید:" -#: src/lifetimes/lifetime-annotations.md:56 +#: src/lifetimes/lifetime-annotations.md msgid "" "This says, \"given p1 and p2 which both outlive `'a`, the return value lives " "for at least `'a`." @@ -9451,18 +9419,18 @@ msgstr "" "این به این معناست که \"با توجه به اینکه `p1` و `p2` هر دو از `'a` بیشتر عمر " "می‌کنند، مقدار بازگشتی برای مدت `'a` معتبر خواهد بود.\"" -#: src/lifetimes/lifetime-annotations.md:59 +#: src/lifetimes/lifetime-annotations.md msgid "" "In common cases, lifetimes can be elided, as described on the next slide." msgstr "" "در موارد معمول، عمر متغیرها می‌تواند نادیده گرفته شود، همانطور که در اسلاید " "بعدی توضیح داده شده است." -#: src/lifetimes/lifetime-elision.md:1 +#: src/lifetimes/lifetime-elision.md msgid "Lifetimes in Function Calls" msgstr "طول عمر در فراخوانی‌ توابع" -#: src/lifetimes/lifetime-elision.md:3 +#: 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 " @@ -9474,13 +9442,13 @@ msgstr "" "rust-lang.org/nomicon/lifetime-elision.html) نادیده گرفته شوند. این مسئله " "استنتاج نیست -- بلکه تنها یک اصطلاح نوشتاری کوتاه است." -#: src/lifetimes/lifetime-elision.md:8 +#: src/lifetimes/lifetime-elision.md msgid "Each argument which does not have a lifetime annotation is given one." msgstr "" "هر آرگومان که فاقد یک lifetime annotation است، یک عمر به آن اختصاص داده " "می‌شود." -#: src/lifetimes/lifetime-elision.md:9 +#: src/lifetimes/lifetime-elision.md msgid "" "If there is only one argument lifetime, it is given to all un-annotated " "return values." @@ -9488,7 +9456,7 @@ msgstr "" "اگر تنها یک عمر برای آرگومان وجود داشته باشد، به تمام مقادیر بازگشتی که " "حاشیه‌نویسی نشده‌اند، اختصاص داده می‌شود." -#: src/lifetimes/lifetime-elision.md:11 +#: 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." @@ -9496,11 +9464,11 @@ msgstr "" "اگر چندین عمر آرگومان وجود داشته باشد و اولین آن برای `self` باشد، آن عمر به " "تمام مقادیر بازگشتی که حاشیه‌نویسی نشده‌اند، اختصاص داده می‌شود." -#: src/lifetimes/lifetime-elision.md:53 +#: src/lifetimes/lifetime-elision.md msgid "In this example, `cab_distance` is trivially elided." msgstr "در این مثال، `cab_distance` به طور خودکار حذف می‌شود." -#: src/lifetimes/lifetime-elision.md:55 +#: 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." @@ -9508,13 +9476,13 @@ msgstr "" "تابع `nearest` مثال دیگری از تابعی است که با ارجاعات متعدد در آرگومان‌هایش " "نیاز به حاشیه‌نویسی صریح دارد." -#: src/lifetimes/lifetime-elision.md:58 +#: src/lifetimes/lifetime-elision.md msgid "Try adjusting the signature to \"lie\" about the lifetimes returned:" msgstr "" "امضا را طوری تنظیم کنید که \"دروغ\" بگوید درباره طول عمر مقادیری که برگشت " "داده می‌شوند:" -#: src/lifetimes/lifetime-elision.md:64 +#: 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 " @@ -9525,7 +9493,7 @@ msgstr "" "اشاره‌گرهای خام (ناامن) صدق نمی‌کند و این یکی از منابع رایج خطاها در Rust " "ناامن است." -#: src/lifetimes/lifetime-elision.md:68 +#: 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 " @@ -9540,37 +9508,37 @@ msgstr "" "پروتوتایپ‌سازی، راحت‌تر است که با داده‌های مالکیت‌شده کار کنید و مقادیر را در " "صورت لزوم کلون کنید." -#: src/lifetimes/struct-lifetimes.md:1 +#: src/lifetimes/struct-lifetimes.md msgid "Lifetimes in Data Structures" msgstr "طول عمر در ساختمان داده" -#: src/lifetimes/struct-lifetimes.md:3 +#: src/lifetimes/struct-lifetimes.md msgid "" "If a data type stores borrowed data, it must be annotated with a lifetime:" msgstr "" "اگر یک تایپ داده داده‌های قرضی را ذخیره کند، باید با یک طول عمر مشخص شود:" -#: src/lifetimes/struct-lifetimes.md:10 +#: src/lifetimes/struct-lifetimes.md msgid "\"Bye {text}!\"" msgstr "" -#: src/lifetimes/struct-lifetimes.md:14 +#: src/lifetimes/struct-lifetimes.md msgid "\"The quick brown fox jumps over the lazy dog.\"" msgstr "" -#: src/lifetimes/struct-lifetimes.md:17 +#: src/lifetimes/struct-lifetimes.md msgid "// erase(text);\n" msgstr "" -#: src/lifetimes/struct-lifetimes.md:18 +#: src/lifetimes/struct-lifetimes.md msgid "\"{fox:?}\"" msgstr "" -#: src/lifetimes/struct-lifetimes.md:19 +#: src/lifetimes/struct-lifetimes.md msgid "\"{dog:?}\"" msgstr "" -#: src/lifetimes/struct-lifetimes.md:26 +#: 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 " @@ -9580,7 +9548,7 @@ msgstr "" "`str&` به مدت حداقل برابر با هر نمونه از `Highlight` که از آن داده استفاده " "می‌کند، زنده بماند." -#: src/lifetimes/struct-lifetimes.md:29 +#: 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." @@ -9588,7 +9556,7 @@ msgstr "" "اگر `text` قبل از پایان عمر `fox` (یا `dog`) مصرف شود، بررسی‌کننده‌ی قرض " "(borrow checker) خطا می‌دهد." -#: src/lifetimes/struct-lifetimes.md:31 +#: 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 " @@ -9598,11 +9566,11 @@ msgstr "" "داده‌های اصلی را نگه دارند. این می‌تواند برای ایجاد نمایه‌های سبک مفید باشد، " "اما معمولاً استفاده از آنها را تا حدی دشوارتر می‌کند." -#: src/lifetimes/struct-lifetimes.md:34 +#: src/lifetimes/struct-lifetimes.md msgid "When possible, make data structures own their data directly." msgstr "در صورت امکان، داده‌های ساختارها را به طور مستقیم مالکیت کنید." -#: src/lifetimes/struct-lifetimes.md:35 +#: 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 " @@ -9614,7 +9582,7 @@ msgstr "" "عمری بین ارجاعات مختلف را به علاوه عمر ساختار خود توصیف کنید. این موارد " "بسیار پیشرفته هستند." -#: src/lifetimes/exercise.md:3 +#: 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 " @@ -9626,7 +9594,7 @@ msgstr "" "کار ساده‌تر از آن است که به نظر می‌رسد! این الگو نشان‌دهنده یک الگوی رایج در " "تجزیه داده‌ها است که شامل عبور برش‌های داده است. داده‌های اصلی هرگز کپی نمی‌شوند." -#: src/lifetimes/exercise.md:8 +#: 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` " @@ -9638,11 +9606,11 @@ msgstr "" "ارائه می‌شود. در این تمرین، ما این اطلاعات را به صورت عبارات `match` در " "توابعی که برای هر فیلد فراخوانی می‌شوند، کدگذاری خواهیم کرد." -#: src/lifetimes/exercise.md:13 +#: src/lifetimes/exercise.md msgid "We'll use the following proto:" msgstr "ما از پروتوباف زیر استفاده خواهیم کرد:" -#: src/lifetimes/exercise.md:28 +#: 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 " @@ -9654,7 +9622,7 @@ msgstr "" "شامل شماره فیلد (مانند `2` برای فیلد `id` در پیام `Person`) و wire type است " "که نحوه تعیین بار را از جریان بایت مشخص می‌کند." -#: src/lifetimes/exercise.md:33 +#: 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 " @@ -9666,7 +9634,7 @@ msgstr "" "همچنین بازخوانی‌هایی برای مدیریت فیلدهای `Person` و `PhoneNumber` و تجزیه یک " "پیام به مجموعه‌ای از فراخوانی‌ها به آن بازخوانی‌ها را تعریف می‌کند." -#: src/lifetimes/exercise.md:38 +#: src/lifetimes/exercise.md msgid "" "What remains for you is to implement the `parse_field` function and the " "`ProtoMessage` trait for `Person` and `PhoneNumber`." @@ -9674,111 +9642,120 @@ msgstr "" "برای شما باقی‌مانده است که تابع `parse_field` و ویژگی `ProtoMessage` را برای " "`Person` و `PhoneNumber` پیاده‌سازی کنید." -#: src/lifetimes/exercise.md:44 src/lifetimes/solution.md:4 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// A wire type as seen on the wire.\n" msgstr "" -#: src/lifetimes/exercise.md:46 src/lifetimes/solution.md:6 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// The Varint WireType indicates the value is a single VARINT.\n" msgstr "" -#: src/lifetimes/exercise.md:48 src/lifetimes/solution.md:8 +#: src/lifetimes/exercise.md src/lifetimes/solution.md 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" msgstr "" -#: src/lifetimes/exercise.md:52 src/lifetimes/solution.md:12 +#: src/lifetimes/exercise.md src/lifetimes/solution.md 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 "" -#: src/lifetimes/exercise.md:57 src/lifetimes/solution.md:17 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// A field's value, typed based on the wire type.\n" msgstr "" -#: src/lifetimes/exercise.md:61 src/lifetimes/solution.md:21 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "//I64(i64), -- not needed for this exercise\n" msgstr "" -#: src/lifetimes/exercise.md:66 src/lifetimes/solution.md:26 +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "//I32(i32), -- not needed for this exercise\n" +msgstr "" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// A field, containing the field number and its value.\n" msgstr "" -#: src/lifetimes/exercise.md:81 src/lifetimes/solution.md:41 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "//1 => WireType::I64, -- not needed for this exercise\n" msgstr "" -#: src/lifetimes/exercise.md:84 src/lifetimes/solution.md:44 +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "//5 => WireType::I32, -- not needed for this exercise\n" +msgstr "" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "\"Invalid wire type: {value}\"" msgstr "" -#: src/lifetimes/exercise.md:92 src/lifetimes/solution.md:52 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "\"Expected string to be a `Len` field\"" msgstr "" -#: src/lifetimes/exercise.md:94 src/lifetimes/solution.md:54 +#: src/lifetimes/exercise.md src/lifetimes/solution.md #, fuzzy msgid "\"Invalid string\"" msgstr "String" -#: src/lifetimes/exercise.md:99 src/lifetimes/solution.md:59 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "\"Expected bytes to be a `Len` field\"" msgstr "" -#: src/lifetimes/exercise.md:106 src/lifetimes/solution.md:66 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "\"Expected `u64` to be a `Varint` field\"" msgstr "" -#: src/lifetimes/exercise.md:114 src/lifetimes/solution.md:74 -msgid "\"Expected `i32` to be an `I32` field\"" -msgstr "" - -#: src/lifetimes/exercise.md:119 src/lifetimes/solution.md:79 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "" "/// Parse a VARINT, returning the parsed value and the remaining bytes.\n" msgstr "" -#: src/lifetimes/exercise.md:124 src/lifetimes/solution.md:84 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "\"Not enough bytes for varint\"" msgstr "" -#: src/lifetimes/exercise.md:127 src/lifetimes/solution.md:87 +#: 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" msgstr "" -#: src/lifetimes/exercise.md:137 src/lifetimes/solution.md:97 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "// More than 7 bytes is invalid.\n" msgstr "" -#: src/lifetimes/exercise.md:138 src/lifetimes/solution.md:98 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "\"Too many bytes for varint\"" msgstr "" -#: src/lifetimes/exercise.md:140 src/lifetimes/solution.md:100 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// Convert a tag into a field number and a WireType.\n" msgstr "" -#: src/lifetimes/exercise.md:148 src/lifetimes/solution.md:107 +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// Parse a field, returning the remaining bytes\n" msgstr "" -#: src/lifetimes/exercise.md:154 +#: src/lifetimes/exercise.md msgid "" "\"Based on the wire type, build a Field, consuming as many bytes as " "necessary.\"" msgstr "" -#: src/lifetimes/exercise.md:156 +#: src/lifetimes/exercise.md msgid "\"Return the field, and any un-consumed bytes.\"" msgstr "" -#: src/lifetimes/exercise.md:158 src/lifetimes/solution.md:138 +#: 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" @@ -9787,11 +9764,11 @@ msgid "" "/// The entire input is consumed.\n" msgstr "" -#: src/lifetimes/exercise.md:185 +#: src/lifetimes/exercise.md msgid "// TODO: Implement ProtoMessage for Person and PhoneNumber.\n" msgstr "" -#: src/lifetimes/exercise.md:204 +#: 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 " @@ -9806,20 +9783,38 @@ msgstr "" "جای آن که با `Result` برخورد کنیم، برنامه را متوقف خواهیم کرد. در روز چهارم، " "به بررسی دقیق‌تر مدیریت خطا در Rust خواهیم پرداخت." -#: src/lifetimes/solution.md:119 +#: src/lifetimes/solution.md msgid "\"len not a valid `usize`\"" msgstr "" -#: src/lifetimes/solution.md:121 src/lifetimes/solution.md:128 +#: src/lifetimes/solution.md msgid "\"Unexpected EOF\"" msgstr "" -#: src/lifetimes/solution.md:131 -msgid "// Unwrap error because `value` is definitely 4 bytes long.\n" +#: src/lifetimes/solution.md +msgid "// skip everything else\n" msgstr "" -#: src/lifetimes/solution.md:172 src/lifetimes/solution.md:182 -msgid "// skip everything else\n" +#: 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 "\"سلام {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 @@ -9870,11 +9865,11 @@ msgstr "FromIterator" msgid "IntoIterator" msgstr "FromIterator" -#: src/iterators.md src/iterators/fromiterator.md:1 +#: src/iterators.md src/iterators/fromiterator.md msgid "FromIterator" msgstr "FromIterator" -#: src/iterators/iterator.md:3 +#: src/iterators/iterator.md msgid "" "The [`Iterator`](https://doc.rust-lang.org/std/iter/trait.Iterator.html) " "trait supports iterating over values in a collection. It requires a `next` " @@ -9882,11 +9877,11 @@ msgid "" "`Iterator`, and you can implement it yourself, too:" msgstr "" -#: src/iterators/iterator.md:27 +#: src/iterators/iterator.md msgid "\"fib({i}): {n}\"" msgstr "" -#: src/iterators/iterator.md:35 +#: src/iterators/iterator.md msgid "" "The `Iterator` trait implements many common functional programming " "operations over collections (e.g. `map`, `filter`, `reduce`, etc). This is " @@ -9895,7 +9890,7 @@ msgid "" "implementations." msgstr "" -#: src/iterators/iterator.md:40 +#: src/iterators/iterator.md msgid "" "`IntoIterator` is the trait that makes for loops work. It is implemented by " "collection types such as `Vec` and references to them such as `&Vec` " @@ -9903,7 +9898,7 @@ msgid "" "vector with `for i in some_vec { .. }` but `some_vec.next()` doesn't exist." msgstr "" -#: src/iterators/intoiterator.md:3 +#: src/iterators/intoiterator.md msgid "" "The `Iterator` trait tells you how to _iterate_ once you have created an " "iterator. The related trait [`IntoIterator`](https://doc.rust-lang.org/std/" @@ -9911,47 +9906,47 @@ msgid "" "It is used automatically by the `for` loop." msgstr "" -#: src/iterators/intoiterator.md:49 +#: src/iterators/intoiterator.md msgid "\"point = {x}, {y}\"" msgstr "" -#: src/iterators/intoiterator.md:57 +#: src/iterators/intoiterator.md msgid "" "Click through to the docs for `IntoIterator`. Every implementation of " "`IntoIterator` must declare two types:" msgstr "" -#: src/iterators/intoiterator.md:60 +#: src/iterators/intoiterator.md msgid "`Item`: the type to iterate over, such as `i8`," msgstr "" -#: src/iterators/intoiterator.md:61 +#: src/iterators/intoiterator.md msgid "`IntoIter`: the `Iterator` type returned by the `into_iter` method." msgstr "" -#: src/iterators/intoiterator.md:63 +#: src/iterators/intoiterator.md msgid "" "Note that `IntoIter` and `Item` are linked: the iterator must have the same " "`Item` type, which means that it returns `Option`" msgstr "" -#: src/iterators/intoiterator.md:66 +#: src/iterators/intoiterator.md msgid "The example iterates over all combinations of x and y coordinates." msgstr "" -#: src/iterators/intoiterator.md:68 +#: src/iterators/intoiterator.md msgid "" "Try iterating over the grid twice in `main`. Why does this fail? Note that " "`IntoIterator::into_iter` takes ownership of `self`." msgstr "" -#: src/iterators/intoiterator.md:71 +#: src/iterators/intoiterator.md msgid "" "Fix this issue by implementing `IntoIterator` for `&Grid` and storing a " "reference to the `Grid` in `GridIter`." msgstr "" -#: src/iterators/intoiterator.md:74 +#: src/iterators/intoiterator.md msgid "" "The same problem can occur for standard library types: `for e in " "some_vector` will take ownership of `some_vector` and iterate over owned " @@ -9959,60 +9954,60 @@ msgid "" "over references to elements of `some_vector`." msgstr "" -#: src/iterators/fromiterator.md:3 +#: src/iterators/fromiterator.md msgid "" "[`FromIterator`](https://doc.rust-lang.org/std/iter/trait.FromIterator.html) " "lets you build a collection from an [`Iterator`](https://doc.rust-lang.org/" "std/iter/trait.Iterator.html)." msgstr "" -#: src/iterators/fromiterator.md:9 +#: src/iterators/fromiterator.md msgid "\"prime_squares: {prime_squares:?}\"" msgstr "" -#: src/iterators/fromiterator.md:16 +#: src/iterators/fromiterator.md msgid "`Iterator` implements" msgstr "" -#: src/iterators/fromiterator.md:25 +#: src/iterators/fromiterator.md msgid "There are two ways to specify `B` for this method:" msgstr "" -#: src/iterators/fromiterator.md:27 +#: src/iterators/fromiterator.md msgid "" "With the \"turbofish\": `some_iterator.collect::()`, as " "shown. The `_` shorthand used here lets Rust infer the type of the `Vec` " "elements." msgstr "" -#: src/iterators/fromiterator.md:29 +#: src/iterators/fromiterator.md msgid "" "With type inference: `let prime_squares: Vec<_> = some_iterator.collect()`. " "Rewrite the example to use this form." msgstr "" -#: src/iterators/fromiterator.md:32 +#: src/iterators/fromiterator.md msgid "" "There are basic implementations of `FromIterator` for `Vec`, `HashMap`, etc. " "There are also more specialized implementations which let you do cool things " "like convert an `Iterator>` into a `Result, E>`." msgstr "" -#: src/iterators/exercise.md:3 +#: src/iterators/exercise.md msgid "" "In this exercise, you will need to find and use some of the provided methods " "in the [`Iterator`](https://doc.rust-lang.org/std/iter/trait.Iterator.html) " "trait to implement a complex calculation." msgstr "" -#: src/iterators/exercise.md:6 +#: src/iterators/exercise.md msgid "" "Copy the following code to and make the tests " "pass. Use an iterator expression and `collect` the result to construct the " "return value." msgstr "" -#: src/iterators/exercise.md:11 src/iterators/solution.md:4 +#: src/iterators/exercise.md src/iterators/solution.md msgid "" "/// Calculate the differences between elements of `values` offset by " "`offset`,\n" @@ -10021,239 +10016,239 @@ msgid "" "/// Element `n` of the result is `values[(n+offset)%len] - values[n]`.\n" msgstr "" -#: src/modules.md src/modules/paths.md:1 +#: src/modules.md src/modules/paths.md msgid "use, super, self" msgstr "" -#: src/modules/modules.md:3 +#: src/modules/modules.md msgid "We have seen how `impl` blocks let us namespace functions to a type." msgstr "" -#: src/modules/modules.md:5 +#: src/modules/modules.md msgid "Similarly, `mod` lets us namespace types and functions:" msgstr "" -#: src/modules/modules.md:10 +#: src/modules/modules.md msgid "\"In the foo module\"" msgstr "" -#: src/modules/modules.md:16 +#: src/modules/modules.md msgid "\"In the bar module\"" msgstr "" -#: src/modules/modules.md:29 +#: src/modules/modules.md msgid "" "Packages provide functionality and include a `Cargo.toml` file that " "describes how to build a bundle of 1+ crates." msgstr "" -#: src/modules/modules.md:31 +#: src/modules/modules.md msgid "" "Crates are a tree of modules, where a binary crate creates an executable and " "a library crate compiles to a library." msgstr "" -#: src/modules/modules.md:33 +#: src/modules/modules.md msgid "Modules define organization, scope, and are the focus of this section." msgstr "" -#: src/modules/filesystem.md:3 +#: src/modules/filesystem.md msgid "" "Omitting the module content will tell Rust to look for it in another file:" msgstr "" -#: src/modules/filesystem.md:9 +#: src/modules/filesystem.md msgid "" "This tells rust that the `garden` module content is found at `src/garden." "rs`. Similarly, a `garden::vegetables` module can be found at `src/garden/" "vegetables.rs`." msgstr "" -#: src/modules/filesystem.md:13 +#: src/modules/filesystem.md msgid "The `crate` root is in:" msgstr "" -#: src/modules/filesystem.md:15 +#: src/modules/filesystem.md msgid "`src/lib.rs` (for a library crate)" msgstr "" -#: src/modules/filesystem.md:16 +#: src/modules/filesystem.md msgid "`src/main.rs` (for a binary crate)" msgstr "" -#: src/modules/filesystem.md:18 +#: src/modules/filesystem.md msgid "" "Modules defined in files can be documented, too, using \"inner doc " "comments\". These document the item that contains them -- in this case, a " "module." msgstr "" -#: src/modules/filesystem.md:22 +#: src/modules/filesystem.md msgid "" "//! This module implements the garden, including a highly performant " "germination\n" "//! implementation.\n" msgstr "" -#: src/modules/filesystem.md:24 +#: src/modules/filesystem.md msgid "// Re-export types from this module.\n" msgstr "" -#: src/modules/filesystem.md:28 +#: src/modules/filesystem.md msgid "/// Sow the given seed packets.\n" msgstr "" -#: src/modules/filesystem.md:33 +#: src/modules/filesystem.md msgid "/// Harvest the produce in the garden that is ready.\n" msgstr "" -#: src/modules/filesystem.md:43 +#: src/modules/filesystem.md msgid "" "Before Rust 2018, modules needed to be located at `module/mod.rs` instead of " "`module.rs`, and this is still a working alternative for editions after 2018." msgstr "" -#: src/modules/filesystem.md:46 +#: src/modules/filesystem.md msgid "" "The main reason to introduce `filename.rs` as alternative to `filename/mod." "rs` was because many files named `mod.rs` can be hard to distinguish in IDEs." msgstr "" -#: src/modules/filesystem.md:49 +#: src/modules/filesystem.md msgid "Deeper nesting can use folders, even if the main module is a file:" msgstr "" -#: src/modules/filesystem.md:59 +#: src/modules/filesystem.md msgid "" "The place rust will look for modules can be changed with a compiler " "directive:" msgstr "" -#: src/modules/filesystem.md:62 +#: src/modules/filesystem.md msgid "\"some/path.rs\"" msgstr "" -#: src/modules/filesystem.md:66 +#: src/modules/filesystem.md msgid "" "This is useful, for example, if you would like to place tests for a module " "in a file named `some_module_test.rs`, similar to the convention in Go." msgstr "" -#: src/modules/visibility.md:3 +#: src/modules/visibility.md msgid "Modules are a privacy boundary:" msgstr "" -#: src/modules/visibility.md:5 +#: src/modules/visibility.md msgid "Module items are private by default (hides implementation details)." msgstr "" -#: src/modules/visibility.md:6 +#: src/modules/visibility.md msgid "Parent and sibling items are always visible." msgstr "" -#: src/modules/visibility.md:7 +#: src/modules/visibility.md msgid "" "In other words, if an item is visible in module `foo`, it's visible in all " "the descendants of `foo`." msgstr "" -#: src/modules/visibility.md:13 +#: src/modules/visibility.md msgid "\"outer::private\"" msgstr "" -#: src/modules/visibility.md:17 +#: src/modules/visibility.md msgid "\"outer::public\"" msgstr "" -#: src/modules/visibility.md:22 +#: src/modules/visibility.md msgid "\"outer::inner::private\"" msgstr "" -#: src/modules/visibility.md:26 +#: src/modules/visibility.md msgid "\"outer::inner::public\"" msgstr "" -#: src/modules/visibility.md:40 +#: src/modules/visibility.md msgid "Use the `pub` keyword to make modules public." msgstr "" -#: src/modules/visibility.md:42 +#: src/modules/visibility.md msgid "" "Additionally, there are advanced `pub(...)` specifiers to restrict the scope " "of public visibility." msgstr "" -#: src/modules/visibility.md:45 +#: src/modules/visibility.md msgid "" "See the [Rust Reference](https://doc.rust-lang.org/reference/visibility-and-" "privacy.html#pubin-path-pubcrate-pubsuper-and-pubself)." msgstr "" -#: src/modules/visibility.md:47 +#: src/modules/visibility.md msgid "Configuring `pub(crate)` visibility is a common pattern." msgstr "" -#: src/modules/visibility.md:48 +#: src/modules/visibility.md msgid "Less commonly, you can give visibility to a specific path." msgstr "" -#: src/modules/visibility.md:49 +#: src/modules/visibility.md msgid "" "In any case, visibility must be granted to an ancestor module (and all of " "its descendants)." msgstr "" -#: src/modules/paths.md:3 +#: src/modules/paths.md msgid "" "A module can bring symbols from another module into scope with `use`. You " "will typically see something like this at the top of each module:" msgstr "" -#: src/modules/paths.md:11 +#: src/modules/paths.md msgid "Paths" msgstr "مسیر" -#: src/modules/paths.md:13 +#: src/modules/paths.md msgid "Paths are resolved as follows:" msgstr "" -#: src/modules/paths.md:15 +#: src/modules/paths.md msgid "As a relative path:" msgstr "" -#: src/modules/paths.md:16 +#: src/modules/paths.md msgid "`foo` or `self::foo` refers to `foo` in the current module," msgstr "" -#: src/modules/paths.md:17 +#: src/modules/paths.md msgid "`super::foo` refers to `foo` in the parent module." msgstr "" -#: src/modules/paths.md:19 +#: src/modules/paths.md msgid "As an absolute path:" msgstr "" -#: src/modules/paths.md:20 +#: src/modules/paths.md msgid "`crate::foo` refers to `foo` in the root of the current crate," msgstr "" -#: src/modules/paths.md:21 +#: src/modules/paths.md msgid "`bar::foo` refers to `foo` in the `bar` crate." msgstr "" -#: src/modules/paths.md:26 +#: src/modules/paths.md msgid "" "It is common to \"re-export\" symbols at a shorter path. For example, the " "top-level `lib.rs` in a crate might have" msgstr "" -#: src/modules/paths.md:36 +#: src/modules/paths.md msgid "" "making `DiskStorage` and `NetworkStorage` available to other crates with a " "convenient, short path." msgstr "" -#: src/modules/paths.md:39 +#: src/modules/paths.md msgid "" "For the most part, only items that appear in a module need to be `use`'d. " "However, a trait must be in scope to call any methods on that trait, even if " @@ -10262,270 +10257,259 @@ msgid "" "`use std::io::Read`." msgstr "" -#: src/modules/paths.md:45 +#: src/modules/paths.md msgid "" "The `use` statement can have a wildcard: `use std::io::*`. This is " "discouraged because it is not clear which items are imported, and those " "might change over time." msgstr "" -#: src/modules/exercise.md:3 +#: src/modules/exercise.md msgid "" "In this exercise, you will reorganize a small GUI Library implementation. " "This library defines a `Widget` trait and a few implementations of that " "trait, as well as a `main` function." msgstr "" -#: src/modules/exercise.md:7 +#: src/modules/exercise.md msgid "" "It is typical to put each type or set of closely-related types into its own " "module, so each widget type should get its own module." msgstr "" -#: src/modules/exercise.md:10 +#: src/modules/exercise.md #, fuzzy msgid "Cargo Setup" msgstr "تنظیم" -#: src/modules/exercise.md:12 +#: src/modules/exercise.md msgid "" "The Rust playground only supports one file, so you will need to make a Cargo " "project on your local filesystem:" msgstr "" -#: src/modules/exercise.md:21 +#: src/modules/exercise.md msgid "" "Edit the resulting `src/main.rs` to add `mod` statements, and add additional " "files in the `src` directory." msgstr "" -#: src/modules/exercise.md:24 +#: src/modules/exercise.md msgid "Source" msgstr "" -#: src/modules/exercise.md:26 +#: src/modules/exercise.md msgid "Here's the single-module implementation of the GUI library:" msgstr "" -#: src/modules/exercise.md:30 src/modules/solution.md:36 +#: src/modules/exercise.md src/modules/solution.md msgid "/// Natural width of `self`.\n" msgstr "" -#: src/modules/exercise.md:33 src/modules/solution.md:39 +#: src/modules/exercise.md src/modules/solution.md msgid "/// Draw the widget into a buffer.\n" msgstr "" -#: src/modules/exercise.md:36 src/modules/solution.md:42 +#: src/modules/exercise.md src/modules/solution.md msgid "/// Draw the widget on standard output.\n" msgstr "" -#: src/modules/exercise.md:40 src/modules/solution.md:46 +#: src/modules/exercise.md src/modules/solution.md msgid "\"{buffer}\"" msgstr "" -#: src/modules/exercise.md:88 +#: src/modules/exercise.md msgid "// Add 4 paddings for borders\n" msgstr "" -#: src/modules/exercise.md:100 +#: src/modules/exercise.md msgid "" "// TODO: Change draw_into to return Result<(), std::fmt::Error>. Then use " "the\n" " // ?-operator here instead of .unwrap().\n" msgstr "" -#: src/modules/exercise.md:102 src/modules/exercise.md:108 -#: src/modules/solution.md:165 src/modules/solution.md:171 +#: src/modules/exercise.md src/modules/solution.md msgid "\"+-{:-. Then use\n" " // the ?-operator here instead of .unwrap().\n" msgstr "" -#: src/modules/solution.md:177 +#: src/modules/solution.md msgid "// ---- src/main.rs ----\n" msgstr "" -#: src/testing/unit-tests.md:1 +#: src/testing/unit-tests.md msgid "Unit Tests" msgstr "تست‌های واحد (Unit Tests)" -#: src/testing/unit-tests.md:3 +#: src/testing/unit-tests.md msgid "Rust and Cargo come with a simple unit test framework:" msgstr "" -#: src/testing/unit-tests.md:5 +#: src/testing/unit-tests.md msgid "Unit tests are supported throughout your code." msgstr "" -#: src/testing/unit-tests.md:7 +#: src/testing/unit-tests.md msgid "Integration tests are supported via the `tests/` directory." msgstr "" -#: src/testing/unit-tests.md:9 +#: src/testing/unit-tests.md msgid "" "Tests are marked with `#[test]`. Unit tests are often put in a nested " "`tests` module, using `#[cfg(test)]` to conditionally compile them only when " "building tests." msgstr "" -#: src/testing/unit-tests.md:37 +#: src/testing/unit-tests.md #, fuzzy msgid "\"Hello World\"" msgstr "سلام دنیا" -#: src/testing/unit-tests.md:42 +#: src/testing/unit-tests.md msgid "This lets you unit test private helpers." msgstr "" -#: src/testing/unit-tests.md:43 +#: src/testing/unit-tests.md msgid "The `#[cfg(test)]` attribute is only active when you run `cargo test`." msgstr "" -#: src/testing/unit-tests.md:48 +#: src/testing/unit-tests.md msgid "Run the tests in the playground in order to show their results." msgstr "" -#: src/testing/other.md:3 +#: src/testing/other.md msgid "Integration Tests" msgstr "Integration Tests" -#: src/testing/other.md:5 +#: src/testing/other.md msgid "If you want to test your library as a client, use an integration test." msgstr "" -#: src/testing/other.md:7 +#: src/testing/other.md msgid "Create a `.rs` file under `tests/`:" msgstr "" -#: src/testing/other.md:10 +#: src/testing/other.md msgid "// tests/my_library.rs\n" msgstr "" -#: src/testing/other.md:19 +#: src/testing/other.md msgid "These tests only have access to the public API of your crate." msgstr "" -#: src/testing/other.md:21 +#: src/testing/other.md msgid "Documentation Tests" msgstr "تست‌ سندها" -#: src/testing/other.md:23 +#: src/testing/other.md msgid "Rust has built-in support for documentation tests:" msgstr "" -#: src/testing/other.md:26 +#: src/testing/other.md msgid "" "/// Shortens a string to the given length.\n" "///\n" @@ -10536,62 +10520,62 @@ msgid "" "/// ```\n" msgstr "" -#: src/testing/other.md:38 +#: src/testing/other.md msgid "Code blocks in `///` comments are automatically seen as Rust code." msgstr "" -#: src/testing/other.md:39 +#: src/testing/other.md msgid "The code will be compiled and executed as part of `cargo test`." msgstr "" -#: src/testing/other.md:40 +#: src/testing/other.md msgid "" "Adding `#` in the code will hide it from the docs, but will still compile/" "run it." msgstr "" -#: src/testing/other.md:42 +#: src/testing/other.md msgid "" "Test the above code on the [Rust Playground](https://play.rust-lang.org/?" "version=stable&mode=debug&edition=2021&gist=3ce2ad13ea1302f6572cb15cd96becf0)." msgstr "" -#: src/testing/lints.md:3 +#: src/testing/lints.md msgid "" "The Rust compiler produces fantastic error messages, as well as helpful " "built-in lints. [Clippy](https://doc.rust-lang.org/clippy/) provides even " "more lints, organized into groups that can be enabled per-project." msgstr "" -#: src/testing/lints.md:14 +#: src/testing/lints.md msgid "\"X probably fits in a u16, right? {}\"" msgstr "" -#: src/testing/lints.md:21 +#: src/testing/lints.md msgid "" "Run the code sample and examine the error message. There are also lints " "visible here, but those will not be shown once the code compiles. Switch to " "the Playground site to show those lints." msgstr "" -#: src/testing/lints.md:25 +#: src/testing/lints.md msgid "" "After resolving the lints, run `clippy` on the playground site to show " "clippy warnings. Clippy has extensive documentation of its lints, and adds " "new lints (including default-deny lints) all the time." msgstr "" -#: src/testing/lints.md:29 +#: src/testing/lints.md msgid "" "Note that errors or warnings with `help: ...` can be fixed with `cargo fix` " "or via your editor." msgstr "" -#: src/testing/exercise.md:3 +#: src/testing/exercise.md msgid "Luhn Algorithm" msgstr "الگوریتم Luhn" -#: src/testing/exercise.md:5 +#: src/testing/exercise.md msgid "" "The [Luhn algorithm](https://en.wikipedia.org/wiki/Luhn_algorithm) is used " "to validate credit card numbers. The algorithm takes a string as input and " @@ -10602,12 +10586,12 @@ msgstr "" "عنوان ورودی دریافت می‌کند و برای اعتبارسنجی شماره کارت اعتباری مراحل زیر را " "انجام می‌دهد:" -#: src/testing/exercise.md:9 +#: src/testing/exercise.md #, fuzzy msgid "Ignore all spaces. Reject numbers with fewer than two digits." msgstr "تمام فضاها را نادیده بگیرید.شماره‌هایی با کمتر از دو رقم را رد کنید." -#: src/testing/exercise.md:11 +#: src/testing/exercise.md msgid "" "Moving from **right to left**, double every second digit: for the number " "`1234`, we double `3` and `1`. For the number `98765`, we double `6` and `8`." @@ -10616,7 +10600,7 @@ msgstr "" "`1234`، `3` و `1` را دوبل می‌کنیم. برای شماره `98765`، `6` و `8` را دوبل " "می‌کنیم." -#: src/testing/exercise.md:14 +#: src/testing/exercise.md msgid "" "After doubling a digit, sum the digits if the result is greater than 9. So " "doubling `7` becomes `14` which becomes `1 + 4 = 5`." @@ -10625,22 +10609,22 @@ msgstr "" "بنابراین، دوبل کردن `7` به `14` تبدیل می‌شود که به `1 + 4 = 5` تبدیل می‌شود." -#: src/testing/exercise.md:17 +#: src/testing/exercise.md msgid "Sum all the undoubled and doubled digits." msgstr "تمام ارقام دو برابر نشده و دو برابر شده را جمع کنید." -#: src/testing/exercise.md:19 +#: src/testing/exercise.md msgid "The credit card number is valid if the sum ends with `0`." msgstr "اگر مجموع با ‍`0` خاتمه یابد، شماره کارت اعتباری معتبر است." -#: src/testing/exercise.md:21 +#: src/testing/exercise.md msgid "" "The provided code provides a buggy implementation of the luhn algorithm, " "along with two basic unit tests that confirm that most of the algorithm is " "implemented correctly." msgstr "" -#: src/testing/exercise.md:25 +#: src/testing/exercise.md #, fuzzy msgid "" "Copy the code below to and write additional " @@ -10650,75 +10634,75 @@ msgstr "" "کد زیر را به کپی کنید و " "تابع را پیاده‌سازی کنید." -#: src/testing/exercise.md:57 src/testing/solution.md:69 +#: src/testing/exercise.md src/testing/solution.md msgid "\"4263 9826 4026 9299\"" msgstr "" -#: src/testing/exercise.md:58 src/testing/solution.md:70 +#: src/testing/exercise.md src/testing/solution.md msgid "\"4539 3195 0343 6467\"" msgstr "" -#: src/testing/exercise.md:59 src/testing/solution.md:71 +#: src/testing/exercise.md src/testing/solution.md msgid "\"7992 7398 713\"" msgstr "" -#: src/testing/exercise.md:64 src/testing/solution.md:76 +#: src/testing/exercise.md src/testing/solution.md msgid "\"4223 9826 4026 9299\"" msgstr "" -#: src/testing/exercise.md:65 src/testing/solution.md:77 +#: src/testing/exercise.md src/testing/solution.md msgid "\"4539 3195 0343 6476\"" msgstr "" -#: src/testing/exercise.md:66 src/testing/solution.md:78 +#: src/testing/exercise.md src/testing/solution.md msgid "\"8273 1232 7352 0569\"" msgstr "" -#: src/testing/solution.md:4 +#: src/testing/solution.md msgid "// This is the buggy version that appears in the problem.\n" msgstr "" -#: src/testing/solution.md:27 +#: src/testing/solution.md msgid "// This is the solution and passes all of the tests below.\n" msgstr "" -#: src/testing/solution.md:56 +#: src/testing/solution.md msgid "\"1234 5678 1234 5670\"" msgstr "" -#: src/testing/solution.md:58 +#: src/testing/solution.md msgid "\"Is {cc_number} a valid credit card number? {}\"" msgstr "" -#: src/testing/solution.md:59 +#: src/testing/solution.md msgid "\"yes\"" msgstr "" -#: src/testing/solution.md:59 +#: src/testing/solution.md msgid "\"no\"" msgstr "" -#: src/testing/solution.md:84 +#: src/testing/solution.md msgid "\"foo 0 0\"" msgstr "" -#: src/testing/solution.md:90 +#: src/testing/solution.md msgid "\" \"" msgstr "" -#: src/testing/solution.md:91 +#: src/testing/solution.md msgid "\" \"" msgstr "" -#: src/testing/solution.md:92 +#: src/testing/solution.md msgid "\" \"" msgstr "" -#: src/testing/solution.md:97 +#: src/testing/solution.md msgid "\"0\"" msgstr "" -#: src/testing/solution.md:102 +#: src/testing/solution.md msgid "\" 0 0 \"" msgstr "" @@ -10740,107 +10724,107 @@ msgstr "صفت‌های بیشتر" msgid "thiserror and anyhow" msgstr "" -#: src/error-handling.md src/error-handling/exercise.md:1 +#: src/error-handling.md src/error-handling/exercise.md msgid "Exercise: Rewriting with Result" msgstr "" -#: src/error-handling/panics.md:3 +#: src/error-handling/panics.md msgid "Rust handles fatal errors with a \"panic\"." msgstr "" -#: src/error-handling/panics.md:5 +#: src/error-handling/panics.md msgid "Rust will trigger a panic if a fatal error happens at runtime:" msgstr "" -#: src/error-handling/panics.md:10 +#: src/error-handling/panics.md msgid "\"v[100]: {}\"" msgstr "" -#: src/error-handling/panics.md:14 +#: src/error-handling/panics.md msgid "Panics are for unrecoverable and unexpected errors." msgstr "" -#: src/error-handling/panics.md:15 +#: src/error-handling/panics.md msgid "Panics are symptoms of bugs in the program." msgstr "" -#: src/error-handling/panics.md:16 +#: src/error-handling/panics.md msgid "Runtime failures like failed bounds checks can panic" msgstr "" -#: src/error-handling/panics.md:17 +#: src/error-handling/panics.md msgid "Assertions (such as `assert!`) panic on failure" msgstr "" -#: src/error-handling/panics.md:18 +#: src/error-handling/panics.md msgid "Purpose-specific panics can use the `panic!` macro." msgstr "" -#: src/error-handling/panics.md:19 +#: src/error-handling/panics.md msgid "" "A panic will \"unwind\" the stack, dropping values just as if the functions " "had returned." msgstr "" -#: src/error-handling/panics.md:21 +#: src/error-handling/panics.md msgid "" "Use non-panicking APIs (such as `Vec::get`) if crashing is not acceptable." msgstr "" -#: src/error-handling/panics.md:26 +#: src/error-handling/panics.md msgid "" "By default, a panic will cause the stack to unwind. The unwinding can be " "caught:" msgstr "" -#: src/error-handling/panics.md:32 +#: src/error-handling/panics.md msgid "\"No problem here!\"" msgstr "" -#: src/error-handling/panics.md:33 src/error-handling/panics.md:38 +#: src/error-handling/panics.md msgid "\"{result:?}\"" msgstr "" -#: src/error-handling/panics.md:36 +#: src/error-handling/panics.md msgid "\"oh no!\"" msgstr "" -#: src/error-handling/panics.md:42 +#: src/error-handling/panics.md msgid "" "Catching is unusual; do not attempt to implement exceptions with " "`catch_unwind`!" msgstr "" -#: src/error-handling/panics.md:44 +#: src/error-handling/panics.md msgid "" "This can be useful in servers which should keep running even if a single " "request crashes." msgstr "" -#: src/error-handling/panics.md:46 +#: src/error-handling/panics.md msgid "This does not work if `panic = 'abort'` is set in your `Cargo.toml`." msgstr "" -#: src/error-handling/result.md:3 +#: src/error-handling/result.md msgid "" "Our primary mechanism for error handling in Rust is the [`Result`](https://" "doc.rust-lang.org/stable/std/result/enum.Result.html) enum, which we briefly " "saw when discussing standard library types." msgstr "" -#: src/error-handling/result.md:33 +#: src/error-handling/result.md msgid "" "`Result` has two variants: `Ok` which contains the success value, and `Err` " "which contains an error value of some kind." msgstr "" -#: src/error-handling/result.md:36 +#: src/error-handling/result.md msgid "" "Whether or not a function can produce an error is encoded in the function's " "type signature by having the function return a `Result` value." msgstr "" -#: src/error-handling/result.md:39 +#: src/error-handling/result.md msgid "" "Like with `Option`, there is no way to forget to handle an error: You cannot " "access either the success value or the error value without first pattern " @@ -10850,18 +10834,18 @@ msgid "" "proper error handling is being skipped." msgstr "" -#: src/error-handling/result.md:48 +#: src/error-handling/result.md msgid "" "It may be helpful to compare error handling in Rust to error handling " "conventions that students may be familiar with from other programming " "languages." msgstr "" -#: src/error-handling/result.md:53 +#: src/error-handling/result.md msgid "Many languages use exceptions, e.g. C++, Java, Python." msgstr "" -#: src/error-handling/result.md:55 +#: src/error-handling/result.md msgid "" "In most languages with exceptions, whether or not a function can throw an " "exception is not visible as part of its type signature. This generally means " @@ -10869,32 +10853,32 @@ msgid "" "not." msgstr "" -#: src/error-handling/result.md:60 +#: src/error-handling/result.md msgid "" "Exceptions generally unwind the call stack, propagating upward until a `try` " "block is reached. An error originating deep in the call stack may impact an " "unrelated function further up." msgstr "" -#: src/error-handling/result.md:64 +#: src/error-handling/result.md msgid "Error Numbers" msgstr "" -#: src/error-handling/result.md:66 +#: src/error-handling/result.md msgid "" "Some languages have functions return an error number (or some other error " "value) separately from the successful return value of the function. Examples " "include C and Go." msgstr "" -#: src/error-handling/result.md:70 +#: src/error-handling/result.md msgid "" "Depending on the language it may be possible to forget to check the error " "value, in which case you may be accessing an uninitialized or otherwise " "invalid success value." msgstr "" -#: src/error-handling/try.md:3 +#: src/error-handling/try.md msgid "" "Runtime errors like connection-refused or file-not-found are handled with " "the `Result` type, but matching this type on every call can be cumbersome. " @@ -10902,42 +10886,42 @@ msgid "" "turn the common" msgstr "" -#: src/error-handling/try.md:15 +#: src/error-handling/try.md msgid "into the much simpler" msgstr "" -#: src/error-handling/try.md:21 +#: src/error-handling/try.md msgid "We can use this to simplify our error handling code:" msgstr "" -#: src/error-handling/try.md:42 +#: src/error-handling/try.md msgid "//fs::write(\"config.dat\", \"alice\").unwrap();\n" msgstr "" -#: src/error-handling/try.md:43 src/error-handling/try-conversions.md:65 -#: src/error-handling/thiserror-and-anyhow.md:36 +#: src/error-handling/try.md src/error-handling/try-conversions.md +#: src/error-handling/thiserror-and-anyhow.md msgid "\"config.dat\"" msgstr "" -#: src/error-handling/try.md:44 src/error-handling/try-conversions.md:66 +#: src/error-handling/try.md src/error-handling/try-conversions.md msgid "\"username or error: {username:?}\"" msgstr "" -#: src/error-handling/try.md:51 +#: src/error-handling/try.md msgid "Simplify the `read_username` function to use `?`." msgstr "" -#: src/error-handling/try.md:55 +#: src/error-handling/try.md msgid "The `username` variable can be either `Ok(string)` or `Err(error)`." msgstr "" -#: src/error-handling/try.md:56 +#: src/error-handling/try.md msgid "" "Use the `fs::write` call to test out the different scenarios: no file, empty " "file, file with username." msgstr "" -#: src/error-handling/try.md:58 +#: src/error-handling/try.md msgid "" "Note that `main` can return a `Result<(), E>` as long as it implements `std::" "process::Termination`. In practice, this means that `E` implements `Debug`. " @@ -10945,36 +10929,36 @@ msgid "" "on error." msgstr "" -#: src/error-handling/try-conversions.md:3 +#: src/error-handling/try-conversions.md msgid "" "The effective expansion of `?` is a little more complicated than previously " "indicated:" msgstr "" -#: src/error-handling/try-conversions.md:10 +#: src/error-handling/try-conversions.md msgid "works the same as" msgstr "" -#: src/error-handling/try-conversions.md:19 +#: src/error-handling/try-conversions.md msgid "" "The `From::from` call here means we attempt to convert the error type to the " "type returned by the function. This makes it easy to encapsulate errors into " "higher-level errors." msgstr "" -#: src/error-handling/try-conversions.md:42 +#: src/error-handling/try-conversions.md msgid "\"IO error: {e}\"" msgstr "" -#: src/error-handling/try-conversions.md:43 +#: src/error-handling/try-conversions.md msgid "\"Found no username in {path}\"" msgstr "" -#: src/error-handling/try-conversions.md:64 +#: src/error-handling/try-conversions.md msgid "//std::fs::write(\"config.dat\", \"\").unwrap();\n" msgstr "" -#: src/error-handling/try-conversions.md:73 +#: src/error-handling/try-conversions.md msgid "" "The `?` operator must return a value compatible with the return type of the " "function. For `Result`, it means that the error types have to be compatible. " @@ -10983,31 +10967,31 @@ msgid "" "same type or if `ErrorOuter` implements `From`." msgstr "" -#: src/error-handling/try-conversions.md:79 +#: src/error-handling/try-conversions.md msgid "" "A common alternative to a `From` implementation is `Result::map_err`, " "especially when the conversion only happens in one place." msgstr "" -#: src/error-handling/try-conversions.md:82 +#: src/error-handling/try-conversions.md msgid "" "There is no compatibility requirement for `Option`. A function returning " "`Option` can use the `?` operator on `Option` for arbitrary `T` and " "`U` types." msgstr "" -#: src/error-handling/try-conversions.md:86 +#: src/error-handling/try-conversions.md msgid "" "A function that returns `Result` cannot use `?` on `Option` and vice versa. " "However, `Option::ok_or` converts `Option` to `Result` whereas `Result::ok` " "turns `Result` into `Option`." msgstr "" -#: src/error-handling/error.md:1 +#: src/error-handling/error.md msgid "Dynamic Error Types" msgstr "انواع خطاهای Dynamic" -#: src/error-handling/error.md:3 +#: src/error-handling/error.md msgid "" "Sometimes we want to allow any type of error to be returned without writing " "our own enum covering all the different possibilities. The `std::error::" @@ -11015,29 +10999,29 @@ msgid "" "error." msgstr "" -#: src/error-handling/error.md:20 src/error-handling/error.md:21 +#: src/error-handling/error.md msgid "\"count.dat\"" msgstr "" -#: src/error-handling/error.md:20 +#: src/error-handling/error.md msgid "\"1i3\"" msgstr "" -#: src/error-handling/error.md:22 +#: src/error-handling/error.md msgid "\"Count: {count}\"" msgstr "" -#: src/error-handling/error.md:23 +#: src/error-handling/error.md msgid "\"Error: {err}\"" msgstr "" -#: src/error-handling/error.md:31 +#: src/error-handling/error.md msgid "" "The `read_count` function can return `std::io::Error` (from file operations) " "or `std::num::ParseIntError` (from `String::parse`)." msgstr "" -#: src/error-handling/error.md:34 +#: src/error-handling/error.md msgid "" "Boxing errors saves on code, but gives up the ability to cleanly handle " "different error cases differently in the program. As such it's generally not " @@ -11046,7 +11030,7 @@ msgid "" "message somewhere." msgstr "" -#: src/error-handling/error.md:40 +#: src/error-handling/error.md msgid "" "Make sure to implement the `std::error::Error` trait when defining a custom " "error type so it can be boxed. But if you need to support the `no_std` " @@ -11055,101 +11039,101 @@ msgid "" "issues/103765) only." msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:3 +#: src/error-handling/thiserror-and-anyhow.md msgid "" "The [`thiserror`](https://docs.rs/thiserror/) and [`anyhow`](https://docs.rs/" "anyhow/) crates are widely used to simplify error handling." msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:7 +#: src/error-handling/thiserror-and-anyhow.md msgid "" "`thiserror` is often used in libraries to create custom error types that " "implement `From`." msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:9 +#: src/error-handling/thiserror-and-anyhow.md msgid "" "`anyhow` is often used by applications to help with error handling in " "functions, including adding contextual information to your errors." msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:19 +#: src/error-handling/thiserror-and-anyhow.md msgid "\"Found no username in {0}\"" msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:25 +#: src/error-handling/thiserror-and-anyhow.md msgid "\"Failed to open {path}\"" msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:27 +#: src/error-handling/thiserror-and-anyhow.md msgid "\"Failed to read\"" msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:35 +#: src/error-handling/thiserror-and-anyhow.md msgid "//fs::write(\"config.dat\", \"\").unwrap();\n" msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:37 +#: src/error-handling/thiserror-and-anyhow.md msgid "\"Username: {username}\"" msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:38 +#: src/error-handling/thiserror-and-anyhow.md msgid "\"Error: {err:?}\"" msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:46 +#: src/error-handling/thiserror-and-anyhow.md msgid "`thiserror`" msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:48 +#: src/error-handling/thiserror-and-anyhow.md msgid "" "The `Error` derive macro is provided by `thiserror`, and has lots of useful " "attributes to help define error types in a compact way." msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:50 +#: src/error-handling/thiserror-and-anyhow.md msgid "The `std::error::Error` trait is derived automatically." msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:51 +#: src/error-handling/thiserror-and-anyhow.md msgid "The message from `#[error]` is used to derive the `Display` trait." msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:53 +#: src/error-handling/thiserror-and-anyhow.md msgid "`anyhow`" msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:55 +#: src/error-handling/thiserror-and-anyhow.md msgid "" "`anyhow::Error` is essentially a wrapper around `Box`. As such " "it's again generally not a good choice for the public API of a library, but " "is widely used in applications." msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:58 +#: src/error-handling/thiserror-and-anyhow.md msgid "`anyhow::Result` is a type alias for `Result`." msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:59 +#: src/error-handling/thiserror-and-anyhow.md msgid "" "Actual error type inside of it can be extracted for examination if necessary." msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:60 +#: src/error-handling/thiserror-and-anyhow.md msgid "" "Functionality provided by `anyhow::Result` may be familiar to Go " "developers, as it provides similar usage patterns and ergonomics to `(T, " "error)` from Go." msgstr "" -#: src/error-handling/thiserror-and-anyhow.md:63 +#: src/error-handling/thiserror-and-anyhow.md msgid "" "`anyhow::Context` is a trait implemented for the standard `Result` and " "`Option` types. `use anyhow::Context` is necessary to enable `.context()` " "and `.with_context()` on those types." msgstr "" -#: src/error-handling/exercise.md:3 +#: src/error-handling/exercise.md msgid "" "The following implements a very simple parser for an expression language. " "However, it handles errors by panicking. Rewrite it to instead use idiomatic " @@ -11157,91 +11141,90 @@ msgid "" "use `thiserror` and `anyhow`." msgstr "" -#: src/error-handling/exercise.md:8 +#: src/error-handling/exercise.md msgid "" "HINT: start by fixing error handling in the `parse` function. Once that is " "working correctly, update `Tokenizer` to implement " "`Iterator>` and handle that in the parser." msgstr "" -#: src/error-handling/exercise.md:15 src/error-handling/solution.md:9 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "/// An arithmetic operator.\n" msgstr "" -#: src/error-handling/exercise.md:22 src/error-handling/solution.md:16 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "/// A token in the expression language.\n" msgstr "" -#: src/error-handling/exercise.md:30 src/error-handling/solution.md:24 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "/// An expression in the expression language.\n" msgstr "" -#: src/error-handling/exercise.md:34 src/error-handling/solution.md:28 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "/// A reference to a variable.\n" msgstr "" -#: src/error-handling/exercise.md:36 src/error-handling/solution.md:30 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "/// A literal number.\n" msgstr "" -#: src/error-handling/exercise.md:38 src/error-handling/solution.md:32 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "/// A binary operation.\n" msgstr "" -#: src/error-handling/exercise.md:60 src/error-handling/solution.md:60 -#: src/error-handling/solution.md:75 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "'_'" msgstr "" -#: src/error-handling/exercise.md:76 src/error-handling/solution.md:76 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "'+'" msgstr "" -#: src/error-handling/exercise.md:77 src/error-handling/solution.md:77 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "'-'" msgstr "" -#: src/error-handling/exercise.md:78 +#: src/error-handling/exercise.md msgid "\"Unexpected character {c}\"" msgstr "" -#: src/error-handling/exercise.md:88 src/error-handling/solution.md:87 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "\"Unexpected end of input\"" msgstr "" -#: src/error-handling/exercise.md:92 +#: src/error-handling/exercise.md msgid "\"Invalid 32-bit integer'\"" msgstr "" -#: src/error-handling/exercise.md:96 src/error-handling/exercise.md:106 +#: src/error-handling/exercise.md msgid "\"Unexpected token {tok:?}\"" msgstr "" -#: src/error-handling/exercise.md:98 src/error-handling/solution.md:110 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "// Look ahead to parse a binary operation if present.\n" msgstr "" -#: src/error-handling/exercise.md:114 src/error-handling/solution.md:127 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "\"10+foo+20-30\"" msgstr "" -#: src/error-handling/exercise.md:115 src/error-handling/solution.md:128 +#: src/error-handling/exercise.md src/error-handling/solution.md msgid "\"{expr:?}\"" msgstr "" -#: src/error-handling/solution.md:42 +#: src/error-handling/solution.md msgid "\"Unexpected character '{0}' in input\"" msgstr "" -#: src/error-handling/solution.md:85 +#: src/error-handling/solution.md msgid "\"Tokenizer error: {0}\"" msgstr "" -#: src/error-handling/solution.md:89 +#: src/error-handling/solution.md msgid "\"Unexpected token {0:?}\"" msgstr "" -#: src/error-handling/solution.md:91 +#: src/error-handling/solution.md msgid "\"Invalid number\"" msgstr "" @@ -11249,64 +11232,64 @@ msgstr "" msgid "This segment should take about 1 hour and 5 minutes. It contains:" msgstr "" -#: src/unsafe-rust/unsafe.md:3 +#: src/unsafe-rust/unsafe.md msgid "The Rust language has two parts:" msgstr "" -#: src/unsafe-rust/unsafe.md:5 +#: src/unsafe-rust/unsafe.md msgid "**Safe Rust:** memory safe, no undefined behavior possible." msgstr "" -#: src/unsafe-rust/unsafe.md:6 +#: src/unsafe-rust/unsafe.md msgid "" "**Unsafe Rust:** can trigger undefined behavior if preconditions are " "violated." msgstr "" -#: src/unsafe-rust/unsafe.md:8 +#: src/unsafe-rust/unsafe.md msgid "" "We saw mostly safe Rust in this course, but it's important to know what " "Unsafe Rust is." msgstr "" -#: src/unsafe-rust/unsafe.md:11 +#: src/unsafe-rust/unsafe.md msgid "" "Unsafe code is usually small and isolated, and its correctness should be " "carefully documented. It is usually wrapped in a safe abstraction layer." msgstr "" -#: src/unsafe-rust/unsafe.md:14 +#: src/unsafe-rust/unsafe.md msgid "Unsafe Rust gives you access to five new capabilities:" msgstr "" -#: src/unsafe-rust/unsafe.md:16 +#: src/unsafe-rust/unsafe.md msgid "Dereference raw pointers." msgstr "" -#: src/unsafe-rust/unsafe.md:17 +#: src/unsafe-rust/unsafe.md msgid "Access or modify mutable static variables." msgstr "" -#: src/unsafe-rust/unsafe.md:18 +#: src/unsafe-rust/unsafe.md msgid "Access `union` fields." msgstr "" -#: src/unsafe-rust/unsafe.md:19 +#: src/unsafe-rust/unsafe.md msgid "Call `unsafe` functions, including `extern` functions." msgstr "" -#: src/unsafe-rust/unsafe.md:20 +#: src/unsafe-rust/unsafe.md msgid "Implement `unsafe` traits." msgstr "" -#: src/unsafe-rust/unsafe.md:22 +#: src/unsafe-rust/unsafe.md msgid "" "We will briefly cover unsafe capabilities next. For full details, please see " "[Chapter 19.1 in the Rust Book](https://doc.rust-lang.org/book/ch19-01-" "unsafe-rust.html) and the [Rustonomicon](https://doc.rust-lang.org/nomicon/)." msgstr "" -#: src/unsafe-rust/unsafe.md:29 +#: src/unsafe-rust/unsafe.md msgid "" "Unsafe Rust does not mean the code is incorrect. It means that developers " "have turned off some compiler safety features and have to write correct code " @@ -11314,15 +11297,15 @@ msgid "" "rules." msgstr "" -#: src/unsafe-rust/dereferencing.md:3 +#: src/unsafe-rust/dereferencing.md msgid "Creating pointers is safe, but dereferencing them requires `unsafe`:" msgstr "" -#: src/unsafe-rust/dereferencing.md:7 +#: src/unsafe-rust/dereferencing.md msgid "\"careful!\"" msgstr "" -#: src/unsafe-rust/dereferencing.md:12 +#: src/unsafe-rust/dereferencing.md msgid "" "// SAFETY: r1 and r2 were obtained from references and so are guaranteed to\n" " // be non-null and properly aligned, the objects underlying the " @@ -11332,19 +11315,19 @@ msgid "" " // concurrently through any other pointers.\n" msgstr "" -#: src/unsafe-rust/dereferencing.md:18 +#: src/unsafe-rust/dereferencing.md msgid "\"r1 is: {}\"" msgstr "" -#: src/unsafe-rust/dereferencing.md:19 +#: src/unsafe-rust/dereferencing.md msgid "\"uhoh\"" msgstr "" -#: src/unsafe-rust/dereferencing.md:20 +#: src/unsafe-rust/dereferencing.md msgid "\"r2 is: {}\"" msgstr "" -#: src/unsafe-rust/dereferencing.md:23 +#: src/unsafe-rust/dereferencing.md msgid "" "// NOT SAFE. DO NOT DO THIS.\n" " /*\n" @@ -11354,83 +11337,83 @@ msgid "" " */" msgstr "" -#: src/unsafe-rust/dereferencing.md:35 +#: src/unsafe-rust/dereferencing.md msgid "" "It is good practice (and required by the Android Rust style guide) to write " "a comment for each `unsafe` block explaining how the code inside it " "satisfies the safety requirements of the unsafe operations it is doing." msgstr "" -#: src/unsafe-rust/dereferencing.md:39 +#: src/unsafe-rust/dereferencing.md msgid "" "In the case of pointer dereferences, this means that the pointers must be " "[_valid_](https://doc.rust-lang.org/std/ptr/index.html#safety), i.e.:" msgstr "" -#: src/unsafe-rust/dereferencing.md:42 +#: src/unsafe-rust/dereferencing.md msgid "The pointer must be non-null." msgstr "" -#: src/unsafe-rust/dereferencing.md:43 +#: src/unsafe-rust/dereferencing.md msgid "" "The pointer must be _dereferenceable_ (within the bounds of a single " "allocated object)." msgstr "" -#: src/unsafe-rust/dereferencing.md:45 +#: src/unsafe-rust/dereferencing.md msgid "The object must not have been deallocated." msgstr "" -#: src/unsafe-rust/dereferencing.md:46 +#: src/unsafe-rust/dereferencing.md msgid "There must not be concurrent accesses to the same location." msgstr "" -#: src/unsafe-rust/dereferencing.md:47 +#: src/unsafe-rust/dereferencing.md msgid "" "If the pointer was obtained by casting a reference, the underlying object " "must be live and no reference may be used to access the memory." msgstr "" -#: src/unsafe-rust/dereferencing.md:50 +#: src/unsafe-rust/dereferencing.md msgid "In most cases the pointer must also be properly aligned." msgstr "" -#: src/unsafe-rust/dereferencing.md:52 +#: src/unsafe-rust/dereferencing.md msgid "" "The \"NOT SAFE\" section gives an example of a common kind of UB bug: `*r1` " "has the `'static` lifetime, so `r3` has type `&'static String`, and thus " "outlives `s`. Creating a reference from a pointer requires _great care_." msgstr "" -#: src/unsafe-rust/mutable-static.md:3 +#: src/unsafe-rust/mutable-static.md msgid "It is safe to read an immutable static variable:" msgstr "" -#: src/unsafe-rust/mutable-static.md:6 +#: src/unsafe-rust/mutable-static.md #, fuzzy msgid "\"Hello, world!\"" msgstr "سلام دنیا" -#: src/unsafe-rust/mutable-static.md:9 +#: src/unsafe-rust/mutable-static.md msgid "\"HELLO_WORLD: {HELLO_WORLD}\"" msgstr "" -#: src/unsafe-rust/mutable-static.md:13 +#: src/unsafe-rust/mutable-static.md msgid "" "However, since data races can occur, it is unsafe to read and write mutable " "static variables:" msgstr "" -#: src/unsafe-rust/mutable-static.md:20 src/unsafe-rust/mutable-static.md:29 +#: 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:31 +#: src/unsafe-rust/mutable-static.md msgid "\"COUNTER: {COUNTER}\"" msgstr "" -#: src/unsafe-rust/mutable-static.md:39 +#: src/unsafe-rust/mutable-static.md msgid "" "The program here is safe because it is single-threaded. However, the Rust " "compiler is conservative and will assume the worst. Try removing the " @@ -11438,37 +11421,37 @@ msgid "" "mutate a static from multiple threads." msgstr "" -#: src/unsafe-rust/mutable-static.md:44 +#: src/unsafe-rust/mutable-static.md msgid "" "Using a mutable static is generally a bad idea, but there are some cases " "where it might make sense in low-level `no_std` code, such as implementing a " "heap allocator or working with some C APIs." msgstr "" -#: src/unsafe-rust/unions.md:3 +#: src/unsafe-rust/unions.md msgid "Unions are like enums, but you need to track the active field yourself:" msgstr "" -#: src/unsafe-rust/unions.md:14 +#: src/unsafe-rust/unions.md msgid "\"int: {}\"" msgstr "" -#: src/unsafe-rust/unions.md:15 +#: src/unsafe-rust/unions.md msgid "\"bool: {}\"" msgstr "" -#: src/unsafe-rust/unions.md:15 +#: src/unsafe-rust/unions.md #, fuzzy msgid "// Undefined behavior!\n" msgstr "هیچ رفتار تعریف نشده‌ای در زمان اجرا:" -#: src/unsafe-rust/unions.md:22 +#: src/unsafe-rust/unions.md msgid "" "Unions are very rarely needed in Rust as you can usually use an enum. They " "are occasionally needed for interacting with C library APIs." msgstr "" -#: src/unsafe-rust/unions.md:25 +#: src/unsafe-rust/unions.md msgid "" "If you just want to reinterpret bytes as a different type, you probably want " "[`std::mem::transmute`](https://doc.rust-lang.org/stable/std/mem/fn." @@ -11476,62 +11459,55 @@ msgid "" "crates/zerocopy) crate." msgstr "" -#: src/unsafe-rust/unsafe-functions.md:3 src/unsafe-rust/unsafe-functions.md:76 +#: src/unsafe-rust/unsafe-functions.md msgid "Calling Unsafe Functions" msgstr "فراخوانی متدهای ناامن" -#: src/unsafe-rust/unsafe-functions.md:5 +#: src/unsafe-rust/unsafe-functions.md msgid "" "A function or method can be marked `unsafe` if it has extra preconditions " "you must uphold to avoid undefined behaviour:" msgstr "" -#: src/unsafe-rust/unsafe-functions.md:9 src/unsafe-rust/exercise.md:91 -#: src/unsafe-rust/solution.md:41 src/android/interoperability/with-c.md:9 -#: src/android/interoperability/with-c/rust.md:15 -#: src/android/interoperability/with-c/rust.md:30 -#: src/android/interoperability/cpp/cpp-bridge.md:29 -#: src/android/interoperability/cpp/cpp-bridge.md:38 -#: src/exercises/chromium/build-rules.md:8 -#: src/exercises/chromium/build-rules.md:21 -#: src/bare-metal/aps/inline-assembly.md:19 -#: src/bare-metal/aps/better-uart/using.md:24 -#: src/bare-metal/aps/logging/using.md:23 -#: src/exercises/bare-metal/solutions-afternoon.md:43 +#: src/unsafe-rust/unsafe-functions.md src/unsafe-rust/exercise.md +#: src/unsafe-rust/solution.md src/android/interoperability/with-c.md +#: src/android/interoperability/with-c/rust.md +#: 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/solutions-afternoon.md msgid "\"C\"" msgstr "" -#: src/unsafe-rust/unsafe-functions.md:14 +#: src/unsafe-rust/unsafe-functions.md msgid "\"🗻∈🌏\"" msgstr "" -#: src/unsafe-rust/unsafe-functions.md:16 +#: src/unsafe-rust/unsafe-functions.md msgid "" "// 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 "" -#: src/unsafe-rust/unsafe-functions.md:19 -#: src/unsafe-rust/unsafe-functions.md:20 -#: src/unsafe-rust/unsafe-functions.md:21 +#: src/unsafe-rust/unsafe-functions.md msgid "\"emoji: {}\"" msgstr "" -#: src/unsafe-rust/unsafe-functions.md:24 +#: src/unsafe-rust/unsafe-functions.md msgid "\"char count: {}\"" msgstr "" -#: src/unsafe-rust/unsafe-functions.md:26 +#: src/unsafe-rust/unsafe-functions.md msgid "" "// SAFETY: `abs` doesn't deal with pointers and doesn't have any safety\n" " // requirements.\n" msgstr "" -#: src/unsafe-rust/unsafe-functions.md:29 +#: src/unsafe-rust/unsafe-functions.md msgid "\"Absolute value of -3 according to C: {}\"" msgstr "" -#: src/unsafe-rust/unsafe-functions.md:32 +#: src/unsafe-rust/unsafe-functions.md msgid "" "// Not upholding the UTF-8 encoding requirement breaks memory safety!\n" " // println!(\"emoji: {}\", unsafe { emojis.get_unchecked(0..3) });\n" @@ -11539,18 +11515,17 @@ msgid "" " // emojis.get_unchecked(0..3) }));\n" msgstr "" -#: src/unsafe-rust/unsafe-functions.md:43 -#: src/unsafe-rust/unsafe-functions.md:88 +#: src/unsafe-rust/unsafe-functions.md msgid "Writing Unsafe Functions" msgstr "نوشتن متدهای ناامن" -#: src/unsafe-rust/unsafe-functions.md:45 +#: src/unsafe-rust/unsafe-functions.md msgid "" "You can mark your own functions as `unsafe` if they require particular " "conditions to avoid undefined behaviour." msgstr "" -#: src/unsafe-rust/unsafe-functions.md:49 +#: src/unsafe-rust/unsafe-functions.md msgid "" "/// Swaps the values pointed to by the given pointers.\n" "///\n" @@ -11559,15 +11534,15 @@ msgid "" "/// The pointers must be valid and properly aligned.\n" msgstr "" -#: src/unsafe-rust/unsafe-functions.md:64 +#: src/unsafe-rust/unsafe-functions.md msgid "// SAFETY: ...\n" msgstr "" -#: src/unsafe-rust/unsafe-functions.md:69 +#: src/unsafe-rust/unsafe-functions.md msgid "\"a = {}, b = {}\"" msgstr "" -#: src/unsafe-rust/unsafe-functions.md:78 +#: src/unsafe-rust/unsafe-functions.md msgid "" "`get_unchecked`, like most `_unchecked` functions, is unsafe, because it can " "create UB if the range is incorrect. `abs` is incorrect for a different " @@ -11577,19 +11552,19 @@ msgid "" "undefined behaviour under any arbitrary circumstances." msgstr "" -#: src/unsafe-rust/unsafe-functions.md:85 +#: src/unsafe-rust/unsafe-functions.md msgid "" "The `\"C\"` in this example is the ABI; [other ABIs are available too]" "(https://doc.rust-lang.org/reference/items/external-blocks.html)." msgstr "" -#: src/unsafe-rust/unsafe-functions.md:90 +#: src/unsafe-rust/unsafe-functions.md msgid "" "We wouldn't actually use pointers for a `swap` function - it can be done " "safely with references." msgstr "" -#: src/unsafe-rust/unsafe-functions.md:93 +#: src/unsafe-rust/unsafe-functions.md msgid "" "Note that unsafe code is allowed within an unsafe function without an " "`unsafe` block. We can prohibit this with `#[deny(unsafe_op_in_unsafe_fn)]`. " @@ -11597,212 +11572,207 @@ msgid "" "edition." msgstr "" -#: src/unsafe-rust/unsafe-traits.md:1 +#: src/unsafe-rust/unsafe-traits.md msgid "Implementing Unsafe Traits" msgstr "پیاده سازی صفات (Traits) ناامن" -#: src/unsafe-rust/unsafe-traits.md:3 +#: src/unsafe-rust/unsafe-traits.md msgid "" "Like with functions, you can mark a trait as `unsafe` if the implementation " "must guarantee particular conditions to avoid undefined behaviour." msgstr "" -#: src/unsafe-rust/unsafe-traits.md:6 +#: src/unsafe-rust/unsafe-traits.md msgid "" "For example, the `zerocopy` crate has an unsafe trait that looks [something " "like this](https://docs.rs/zerocopy/latest/zerocopy/trait.AsBytes.html):" msgstr "" -#: src/unsafe-rust/unsafe-traits.md:12 +#: src/unsafe-rust/unsafe-traits.md msgid "" "/// ...\n" "/// # Safety\n" "/// The type must have a defined representation and no padding.\n" msgstr "" -#: src/unsafe-rust/unsafe-traits.md:26 +#: src/unsafe-rust/unsafe-traits.md msgid "// SAFETY: `u32` has a defined representation and no padding.\n" msgstr "" -#: src/unsafe-rust/unsafe-traits.md:34 +#: src/unsafe-rust/unsafe-traits.md msgid "" "There should be a `# Safety` section on the Rustdoc for the trait explaining " "the requirements for the trait to be safely implemented." msgstr "" -#: src/unsafe-rust/unsafe-traits.md:37 +#: src/unsafe-rust/unsafe-traits.md msgid "" "The actual safety section for `AsBytes` is rather longer and more " "complicated." msgstr "" -#: src/unsafe-rust/unsafe-traits.md:39 +#: src/unsafe-rust/unsafe-traits.md msgid "The built-in `Send` and `Sync` traits are unsafe." msgstr "" -#: src/unsafe-rust/exercise.md:1 +#: src/unsafe-rust/exercise.md msgid "Safe FFI Wrapper" msgstr "امن بودن FFI Wrapper" -#: src/unsafe-rust/exercise.md:3 +#: src/unsafe-rust/exercise.md msgid "" "Rust has great support for calling functions through a _foreign function " "interface_ (FFI). We will use this to build a safe wrapper for the `libc` " "functions you would use from C to read the names of files in a directory." msgstr "" -#: src/unsafe-rust/exercise.md:7 +#: src/unsafe-rust/exercise.md msgid "You will want to consult the manual pages:" msgstr "" -#: src/unsafe-rust/exercise.md:9 +#: src/unsafe-rust/exercise.md msgid "[`opendir(3)`](https://man7.org/linux/man-pages/man3/opendir.3.html)" msgstr "" -#: src/unsafe-rust/exercise.md:10 +#: src/unsafe-rust/exercise.md msgid "[`readdir(3)`](https://man7.org/linux/man-pages/man3/readdir.3.html)" msgstr "" -#: src/unsafe-rust/exercise.md:11 +#: src/unsafe-rust/exercise.md msgid "[`closedir(3)`](https://man7.org/linux/man-pages/man3/closedir.3.html)" msgstr "" -#: src/unsafe-rust/exercise.md:13 +#: src/unsafe-rust/exercise.md msgid "" "You will also want to browse the [`std::ffi`](https://doc.rust-lang.org/std/" "ffi/) module. There you find a number of string types which you need for the " "exercise:" msgstr "" -#: src/unsafe-rust/exercise.md:16 +#: src/unsafe-rust/exercise.md msgid "Encoding" msgstr "" -#: src/unsafe-rust/exercise.md:16 +#: src/unsafe-rust/exercise.md msgid "Use" msgstr "" -#: src/unsafe-rust/exercise.md:18 +#: src/unsafe-rust/exercise.md msgid "" "[`str`](https://doc.rust-lang.org/std/primitive.str.html) and [`String`]" "(https://doc.rust-lang.org/std/string/struct.String.html)" msgstr "" -#: src/unsafe-rust/exercise.md:18 +#: src/unsafe-rust/exercise.md msgid "UTF-8" msgstr "" -#: src/unsafe-rust/exercise.md:18 +#: src/unsafe-rust/exercise.md msgid "Text processing in Rust" msgstr "" -#: src/unsafe-rust/exercise.md:19 +#: src/unsafe-rust/exercise.md msgid "" "[`CStr`](https://doc.rust-lang.org/std/ffi/struct.CStr.html) and [`CString`]" "(https://doc.rust-lang.org/std/ffi/struct.CString.html)" msgstr "" -#: src/unsafe-rust/exercise.md:19 +#: src/unsafe-rust/exercise.md msgid "NUL-terminated" msgstr "" -#: src/unsafe-rust/exercise.md:19 +#: src/unsafe-rust/exercise.md msgid "Communicating with C functions" msgstr "" -#: src/unsafe-rust/exercise.md:20 +#: src/unsafe-rust/exercise.md msgid "" "[`OsStr`](https://doc.rust-lang.org/std/ffi/struct.OsStr.html) and " "[`OsString`](https://doc.rust-lang.org/std/ffi/struct.OsString.html)" msgstr "" -#: src/unsafe-rust/exercise.md:20 +#: src/unsafe-rust/exercise.md msgid "OS-specific" msgstr "" -#: src/unsafe-rust/exercise.md:20 +#: src/unsafe-rust/exercise.md msgid "Communicating with the OS" msgstr "" -#: src/unsafe-rust/exercise.md:22 +#: src/unsafe-rust/exercise.md msgid "You will convert between all these types:" msgstr "" -#: src/unsafe-rust/exercise.md:24 +#: src/unsafe-rust/exercise.md msgid "" "`&str` to `CString`: you need to allocate space for a trailing `\\0` " "character," msgstr "" -#: src/unsafe-rust/exercise.md:25 +#: src/unsafe-rust/exercise.md msgid "`CString` to `*const i8`: you need a pointer to call C functions," msgstr "" -#: src/unsafe-rust/exercise.md:26 +#: src/unsafe-rust/exercise.md msgid "" "`*const i8` to `&CStr`: you need something which can find the trailing `\\0` " "character," msgstr "" -#: src/unsafe-rust/exercise.md:28 +#: src/unsafe-rust/exercise.md msgid "" "`&CStr` to `&[u8]`: a slice of bytes is the universal interface for \"some " "unknown data\"," msgstr "" -#: src/unsafe-rust/exercise.md:30 +#: src/unsafe-rust/exercise.md msgid "" "`&[u8]` to `&OsStr`: `&OsStr` is a step towards `OsString`, use [`OsStrExt`]" "(https://doc.rust-lang.org/std/os/unix/ffi/trait.OsStrExt.html) to create it," msgstr "" -#: src/unsafe-rust/exercise.md:33 +#: src/unsafe-rust/exercise.md msgid "" "`&OsStr` to `OsString`: you need to clone the data in `&OsStr` to be able to " "return it and call `readdir` again." msgstr "" -#: src/unsafe-rust/exercise.md:36 +#: src/unsafe-rust/exercise.md msgid "" "The [Nomicon](https://doc.rust-lang.org/nomicon/ffi.html) also has a very " "useful chapter about FFI." msgstr "" -#: src/unsafe-rust/exercise.md:47 +#: src/unsafe-rust/exercise.md msgid "" "Copy the code below to and fill in the missing " "functions and methods:" msgstr "" -#: src/unsafe-rust/exercise.md:56 src/unsafe-rust/exercise.md:69 -#: src/unsafe-rust/exercise.md:80 src/unsafe-rust/exercise.md:94 -#: src/unsafe-rust/exercise.md:102 src/unsafe-rust/solution.md:6 -#: src/unsafe-rust/solution.md:19 src/unsafe-rust/solution.md:30 -#: src/unsafe-rust/solution.md:44 src/unsafe-rust/solution.md:52 +#: src/unsafe-rust/exercise.md src/unsafe-rust/solution.md msgid "\"macos\"" msgstr "" -#: src/unsafe-rust/exercise.md:59 src/unsafe-rust/solution.md:9 +#: src/unsafe-rust/exercise.md src/unsafe-rust/solution.md msgid "// Opaque type. See https://doc.rust-lang.org/nomicon/ffi.html.\n" msgstr "" -#: src/unsafe-rust/exercise.md:66 src/unsafe-rust/solution.md:16 +#: src/unsafe-rust/exercise.md src/unsafe-rust/solution.md msgid "" "// Layout according to the Linux man page for readdir(3), where ino_t and\n" " // off_t are resolved according to the definitions in\n" " // /usr/include/x86_64-linux-gnu/{sys/types.h, bits/typesizes.h}.\n" msgstr "" -#: src/unsafe-rust/exercise.md:79 src/unsafe-rust/solution.md:29 +#: src/unsafe-rust/exercise.md src/unsafe-rust/solution.md msgid "// Layout according to the macOS man page for dir(5).\n" msgstr "" -#: src/unsafe-rust/exercise.md:94 src/unsafe-rust/exercise.md:102 -#: src/unsafe-rust/solution.md:44 src/unsafe-rust/solution.md:52 +#: src/unsafe-rust/exercise.md src/unsafe-rust/solution.md msgid "\"x86_64\"" msgstr "" -#: src/unsafe-rust/exercise.md:97 src/unsafe-rust/solution.md:47 +#: src/unsafe-rust/exercise.md src/unsafe-rust/solution.md msgid "" "// See https://github.com/rust-lang/libc/issues/414 and the section on\n" " // _DARWIN_FEATURE_64_BIT_INODE in the macOS man page for stat(2).\n" @@ -11813,103 +11783,102 @@ msgid "" "PowerPC.\n" msgstr "" -#: src/unsafe-rust/exercise.md:103 src/unsafe-rust/solution.md:53 +#: src/unsafe-rust/exercise.md src/unsafe-rust/solution.md msgid "\"readdir$INODE64\"" msgstr "" -#: src/unsafe-rust/exercise.md:121 src/unsafe-rust/solution.md:71 +#: src/unsafe-rust/exercise.md src/unsafe-rust/solution.md msgid "" "// Call opendir and return a Ok value if that worked,\n" " // otherwise return Err with a message.\n" msgstr "" -#: src/unsafe-rust/exercise.md:130 +#: src/unsafe-rust/exercise.md msgid "// Keep calling readdir until we get a NULL pointer back.\n" msgstr "" -#: src/unsafe-rust/exercise.md:137 src/unsafe-rust/solution.md:105 +#: src/unsafe-rust/exercise.md src/unsafe-rust/solution.md msgid "// Call closedir as needed.\n" msgstr "" -#: src/unsafe-rust/exercise.md:143 src/unsafe-rust/solution.md:116 -#: src/unsafe-rust/solution.md:140 src/unsafe-rust/solution.md:155 -#: src/android/interoperability/with-c/rust.md:44 +#: src/unsafe-rust/exercise.md src/unsafe-rust/solution.md +#: src/android/interoperability/with-c/rust.md msgid "\".\"" msgstr "" -#: src/unsafe-rust/exercise.md:144 src/unsafe-rust/solution.md:117 +#: src/unsafe-rust/exercise.md src/unsafe-rust/solution.md msgid "\"files: {:#?}\"" msgstr "" -#: src/unsafe-rust/solution.md:74 +#: src/unsafe-rust/solution.md msgid "\"Invalid path: {err}\"" msgstr "" -#: src/unsafe-rust/solution.md:75 +#: src/unsafe-rust/solution.md msgid "// SAFETY: path.as_ptr() cannot be NULL.\n" msgstr "" -#: src/unsafe-rust/solution.md:78 +#: src/unsafe-rust/solution.md msgid "\"Could not open {:?}\"" msgstr "" -#: src/unsafe-rust/solution.md:88 +#: src/unsafe-rust/solution.md msgid "" "// Keep calling readdir until we get a NULL pointer back.\n" " // SAFETY: self.dir is never NULL.\n" msgstr "" -#: src/unsafe-rust/solution.md:92 +#: src/unsafe-rust/solution.md msgid "// We have reached the end of the directory.\n" msgstr "" -#: src/unsafe-rust/solution.md:95 +#: src/unsafe-rust/solution.md msgid "" "// SAFETY: dirent is not NULL and dirent.d_name is NUL\n" " // terminated.\n" msgstr "" -#: src/unsafe-rust/solution.md:107 +#: src/unsafe-rust/solution.md msgid "// SAFETY: self.dir is not NULL.\n" msgstr "" -#: src/unsafe-rust/solution.md:109 +#: src/unsafe-rust/solution.md msgid "\"Could not close {:?}\"" msgstr "" -#: src/unsafe-rust/solution.md:128 +#: src/unsafe-rust/solution.md msgid "\"no-such-directory\"" msgstr "" -#: src/unsafe-rust/solution.md:136 src/unsafe-rust/solution.md:151 +#: src/unsafe-rust/solution.md msgid "\"Non UTF-8 character in path\"" msgstr "" -#: src/unsafe-rust/solution.md:140 src/unsafe-rust/solution.md:155 +#: src/unsafe-rust/solution.md msgid "\"..\"" msgstr "" -#: src/unsafe-rust/solution.md:147 src/unsafe-rust/solution.md:155 +#: src/unsafe-rust/solution.md msgid "\"foo.txt\"" msgstr "" -#: src/unsafe-rust/solution.md:147 +#: src/unsafe-rust/solution.md msgid "\"The Foo Diaries\\n\"" msgstr "" -#: src/unsafe-rust/solution.md:148 src/unsafe-rust/solution.md:155 +#: src/unsafe-rust/solution.md msgid "\"bar.png\"" msgstr "" -#: src/unsafe-rust/solution.md:148 +#: src/unsafe-rust/solution.md msgid "\"\\n\"" msgstr "" -#: src/unsafe-rust/solution.md:149 src/unsafe-rust/solution.md:155 +#: src/unsafe-rust/solution.md msgid "\"crab.rs\"" msgstr "" -#: src/unsafe-rust/solution.md:149 +#: src/unsafe-rust/solution.md msgid "\"//! Crab\\n\"" msgstr "" @@ -12131,39 +12100,24 @@ msgstr "" "کد C/C++/Java همکاری داشته باشد. Soong این شکاف را پر می کند." #: src/android/build-rules.md +#, fuzzy msgid "" -"Soong has many similarities to Bazel, which is the open-source variant of " -"Blaze (used in google3)." +"Soong has many similarities to [Bazel](https://bazel.build/), which is the " +"open-source variant of Blaze (used in google3)." msgstr "" "‏ Soong شباهت‌های زیادی به Bazel دارد که نوع open-source از Blaze است (مورد " "استفاده در google3)." -#: src/android/build-rules.md -msgid "" -"There is a plan to transition [Android](https://source.android.com/docs/" -"setup/build/bazel/introduction), [ChromeOS](https://chromium.googlesource." -"com/chromiumos/bazel/), and [Fuchsia](https://source.android.com/docs/setup/" -"build/bazel/introduction) to Bazel." -msgstr "" -"برنامه‌ای برای انتقال [Android](https://source.android.com/docs/setup/build/" -"bazel/introduction)، [ChromeOS](https://chromium.googlesource.com/chromiumos/" -"bazel/) وجود دارد و انتقال [Fuchsia](https://source.android.com/docs/setup/" -"build/bazel/introduction) به Bazel." - -#: src/android/build-rules.md -msgid "Learning Bazel-like build rules is useful for all Rust OS developers." -msgstr "یادگیری قوانین ساخت Bazel-like برای همه توسعه‌دهندگان Rust OS مفید است." - #: src/android/build-rules.md #, fuzzy msgid "Fun fact: Data from Star Trek is a Soong-type Android." msgstr "واقعیت جالب: داده‌های Star Trek یک اندروید از نوع Soong است." -#: src/android/build-rules/binary.md:1 +#: src/android/build-rules/binary.md msgid "Rust Binaries" msgstr "Rust Binaries" -#: src/android/build-rules/binary.md:3 +#: src/android/build-rules/binary.md msgid "" "Let us start with a simple application. At the root of an AOSP checkout, " "create the following files:" @@ -12171,42 +12125,42 @@ msgstr "" "اجازه دهید با یک برنامه ساده شروع کنیم. در ریشه یک AOSP، فایل های زیر را " "ایجاد کنید:" -#: src/android/build-rules/binary.md:6 src/android/build-rules/library.md:13 +#: src/android/build-rules/binary.md src/android/build-rules/library.md msgid "_hello_rust/Android.bp_:" msgstr "_hello_rust/Android.bp_:" -#: src/android/build-rules/binary.md:10 src/android/build-rules/binary.md:11 +#: src/android/build-rules/binary.md #, fuzzy msgid "\"hello_rust\"" msgstr "\"hello_rust\"" -#: src/android/build-rules/binary.md:12 src/android/build-rules/library.md:19 +#: src/android/build-rules/binary.md src/android/build-rules/library.md #: src/android/logging.md msgid "\"src/main.rs\"" msgstr "\"src/main.rs\"" -#: src/android/build-rules/binary.md:16 src/android/build-rules/library.md:34 +#: src/android/build-rules/binary.md src/android/build-rules/library.md msgid "_hello_rust/src/main.rs_:" msgstr "_hello_rust/src/main.rs_:" -#: src/android/build-rules/binary.md:19 src/android/build-rules/library.md:37 +#: src/android/build-rules/binary.md src/android/build-rules/library.md msgid "//! Rust demo.\n" msgstr "//! Rust demo.\n" -#: src/android/build-rules/binary.md:20 src/android/build-rules/library.md:41 +#: src/android/build-rules/binary.md src/android/build-rules/library.md msgid "/// Prints a greeting to standard output.\n" msgstr "/// Prints a greeting to standard output.\n" -#: src/android/build-rules/binary.md:23 src/exercises/chromium/build-rules.md:9 +#: src/android/build-rules/binary.md src/exercises/chromium/build-rules.md #, fuzzy msgid "\"Hello from Rust!\"" msgstr "\"Hello from Rust!\"" -#: src/android/build-rules/binary.md:27 +#: src/android/build-rules/binary.md msgid "You can now build, push, and run the binary:" msgstr "اکنون می‌توانید باینری را بسازید، push و اجرا کنید:" -#: src/android/build-rules/binary.md:29 +#: src/android/build-rules/binary.md msgid "" "```shell\n" "m hello_rust\n" @@ -12220,25 +12174,25 @@ msgstr "" "adb shell /data/local/tmp/hello_rust\n" "```" -#: src/android/build-rules/library.md:1 +#: src/android/build-rules/library.md msgid "Rust Libraries" msgstr "کتابخانه‌های Rust" -#: src/android/build-rules/library.md:3 +#: src/android/build-rules/library.md msgid "You use `rust_library` to create a new Rust library for Android." msgstr "" "شما از `rust_library` برای ایجاد یک کتابخانه Rust جدید برای Android استفاده " "می‌کنید." -#: src/android/build-rules/library.md:5 +#: src/android/build-rules/library.md msgid "Here we declare a dependency on two libraries:" msgstr "در اینجا ما یک وابستگی به دو کتابخانه را اعلام می‌کنیم:" -#: src/android/build-rules/library.md:7 +#: src/android/build-rules/library.md msgid "`libgreeting`, which we define below," msgstr "‏ `libgreeting`, چیزی که در زیر تعریف می‌کنیم," -#: src/android/build-rules/library.md:8 +#: src/android/build-rules/library.md #, fuzzy msgid "" "`libtextwrap`, which is a crate already vendored in [`external/rust/crates/`]" @@ -12249,56 +12203,56 @@ msgstr "" "(https://cs.android.com/android/platform/superproject/+/master:external/rust/" "crates/) عرضه شده است." -#: src/android/build-rules/library.md:17 src/android/build-rules/library.md:18 +#: src/android/build-rules/library.md #, fuzzy msgid "\"hello_rust_with_dep\"" msgstr "\"hello_rust_with_dep\"" -#: src/android/build-rules/library.md:21 src/android/build-rules/library.md:28 +#: src/android/build-rules/library.md msgid "\"libgreetings\"" msgstr "\"libgreetings\"" -#: src/android/build-rules/library.md:22 +#: src/android/build-rules/library.md msgid "\"libtextwrap\"" msgstr "\"libtextwrap\"" -#: src/android/build-rules/library.md:24 +#: src/android/build-rules/library.md msgid "// Need this to avoid dynamic link error.\n" msgstr "// Need this to avoid dynamic link error.\n" -#: src/android/build-rules/library.md:29 +#: src/android/build-rules/library.md #, fuzzy msgid "\"greetings\"" msgstr "\"greetings\"" -#: src/android/build-rules/library.md:30 -#: src/android/aidl/example-service/service.md:28 src/android/testing.md -#: src/android/interoperability/java.md:39 +#: 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\"" -#: src/android/build-rules/library.md:48 +#: src/android/build-rules/library.md msgid "_hello_rust/src/lib.rs_:" msgstr "_hello_rust/src/lib.rs_:" -#: src/android/build-rules/library.md:51 +#: src/android/build-rules/library.md msgid "//! Greeting library.\n" msgstr "//! Greeting library.\n" -#: src/android/build-rules/library.md:52 +#: src/android/build-rules/library.md msgid "/// Greet `name`.\n" msgstr "/// Greet `name`.\n" -#: src/android/build-rules/library.md:55 +#: src/android/build-rules/library.md #, fuzzy msgid "\"Hello {name}, it is very nice to meet you!\"" msgstr "\"Hello {name}, it is very nice to meet you!\"" -#: src/android/build-rules/library.md:59 +#: src/android/build-rules/library.md msgid "You build, push, and run the binary like before:" msgstr "باینری را مانند قبل می سازید، push و اجرا می‌کنید:" -#: src/android/build-rules/library.md:61 +#: src/android/build-rules/library.md msgid "" "```shell\n" "m hello_rust_with_dep\n" @@ -12330,7 +12284,7 @@ msgstr "کد Rust می تواند سرورهای AIDL موجود را فراخو msgid "You can create new AIDL servers in Rust." msgstr "می‌توانید سرورهای جدید AIDL را در Rust ایجاد کنید." -#: src/android/aidl/birthday-service.md:3 +#: 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 " @@ -12340,50 +12294,50 @@ msgstr "" "Binder را بررسی کنیم. سپس هم سرویس توصیف‌شده را پیاده‌سازی می‌کنیم و هم کد " "کلاینت را می‌نویسیم که با آن سرویس صحبت می‌کند." -#: src/android/aidl/example-service/interface.md:1 +#: src/android/aidl/example-service/interface.md msgid "AIDL Interfaces" msgstr "AIDL Interfaces" -#: src/android/aidl/example-service/interface.md:3 +#: src/android/aidl/example-service/interface.md msgid "You declare the API of your service using an AIDL interface:" msgstr "شما API سرویس خود را با استفاده از یک AIDL interface اعلام می‌کنید:" -#: src/android/aidl/example-service/interface.md:5 -#: src/android/aidl/example-service/service-bindings.md:6 +#: 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/example-service/interface.md:8 -#: src/android/aidl/example-service/service-bindings.md:9 -#: src/android/aidl/example-service/changing-definition.md:8 +#: 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 "/** Birthday service interface. */" -#: src/android/aidl/example-service/interface.md:10 -#: src/android/aidl/example-service/service-bindings.md:11 -#: src/android/aidl/example-service/changing-definition.md:11 +#: 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 "/** Generate a Happy Birthday message. */" -#: src/android/aidl/example-service/interface.md:15 +#: src/android/aidl/example-service/interface.md msgid "_birthday_service/aidl/Android.bp_:" msgstr "_birthday_service/aidl/Android.bp_:" -#: src/android/aidl/example-service/interface.md:19 +#: src/android/aidl/example-service/interface.md msgid "\"com.example.birthdayservice\"" msgstr "\"com.example.birthdayservice\"" -#: src/android/aidl/example-service/interface.md:20 +#: src/android/aidl/example-service/interface.md msgid "\"com/example/birthdayservice/*.aidl\"" msgstr "\"com/example/birthdayservice/*.aidl\"" -#: src/android/aidl/example-service/interface.md:23 +#: src/android/aidl/example-service/interface.md msgid "// Rust is not enabled by default\n" msgstr "// Rust is not enabled by default\n" -#: src/android/aidl/example-service/interface.md:32 +#: src/android/aidl/example-service/interface.md #, fuzzy msgid "" "Note that the directory structure under the `aidl/` directory needs to match " @@ -12395,11 +12349,11 @@ msgstr "" "example.birthdayservice` و این فایل در `aidl/com/example/IBirthdayService." "aidl` است. `." -#: src/android/aidl/example-service/service-bindings.md:1 +#: src/android/aidl/example-service/service-bindings.md msgid "Generated Service API" msgstr "Generated Service API" -#: src/android/aidl/example-service/service-bindings.md:3 +#: src/android/aidl/example-service/service-bindings.md msgid "" "Binder generates a trait corresponding to the interface definition. trait to " "talk to the service." @@ -12407,11 +12361,11 @@ msgstr "" "‏ Binder یک trait مطابق با تعریف interface تولید می‌کند. trait برای صحبت کردن " "با سرویس" -#: src/android/aidl/example-service/service-bindings.md:16 +#: src/android/aidl/example-service/service-bindings.md msgid "_Generated trait_:" msgstr "_Generated trait_:" -#: src/android/aidl/example-service/service-bindings.md:24 +#: 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." @@ -12419,7 +12373,7 @@ msgstr "" "سرویس شما باید این trait را پیاده‌سازی کند و کلاینت شما از این ویژگی برای " "صحبت با سرویس‌ها استفاده خواهد کرد." -#: src/android/aidl/example-service/service-bindings.md:29 +#: src/android/aidl/example-service/service-bindings.md msgid "" "The generated bindings can be found at `out/soong/.intermediates//`." @@ -12427,7 +12381,7 @@ msgstr "" "پیوندهای تولید شده را می توان در `out/soong/.intermediates//" "` یافت." -#: src/android/aidl/example-service/service-bindings.md:31 +#: 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." @@ -12435,7 +12389,7 @@ msgstr "" "اشاره کنید که چگونه function signature تولید شده، به ویژه typeهای آرگومان و " "بازگشتی، با تعریف interface مطابقت دارد." -#: src/android/aidl/example-service/service-bindings.md:33 +#: 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." @@ -12443,61 +12397,61 @@ msgstr "" "‏ `String` برای آرگومان منجر به type متفاوتی Rust نسبت به `String` به عنوان " "type برگشتی می‌شود." -#: src/android/aidl/example-service/service.md:1 +#: src/android/aidl/example-service/service.md msgid "Service Implementation" msgstr "پیاده‌سازی سرویس‌ها" -#: src/android/aidl/example-service/service.md:3 +#: src/android/aidl/example-service/service.md msgid "We can now implement the AIDL service:" msgstr "اکنون می‌توانیم سرویس AIDL را پیاده‌سازی کنیم:" -#: src/android/aidl/example-service/service.md:5 -#: src/android/aidl/example-service/changing-implementation.md:5 +#: 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/example-service/service.md:10 +#: src/android/aidl/example-service/service.md msgid "/// The `IBirthdayService` implementation.\n" msgstr "/// The `IBirthdayService` implementation.\n" -#: src/android/aidl/example-service/service.md:18 -#: src/android/aidl/example-service/changing-implementation.md:16 -#: src/android/aidl/types/file-descriptor.md:57 +#: src/android/aidl/example-service/service.md +#: src/android/aidl/example-service/changing-implementation.md +#: src/android/aidl/types/file-descriptor.md #, fuzzy msgid "\"Happy Birthday {name}, congratulations with the {years} years!\"" msgstr "\"Happy Birthday {name}, congratulations with the {years} years!\"" -#: src/android/aidl/example-service/service.md:23 -#: src/android/aidl/example-service/server.md:28 -#: src/android/aidl/example-service/client.md:31 +#: 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/example-service/service.md:27 -#: src/android/aidl/example-service/server.md:38 +#: src/android/aidl/example-service/service.md +#: src/android/aidl/example-service/server.md msgid "\"libbirthdayservice\"" msgstr "\"libbirthdayservice\"" -#: src/android/aidl/example-service/service.md:29 -#: src/android/aidl/example-service/server.md:13 -#: src/android/aidl/example-service/client.md:11 +#: src/android/aidl/example-service/service.md +#: src/android/aidl/example-service/server.md +#: src/android/aidl/example-service/client.md #, fuzzy msgid "\"birthdayservice\"" msgstr "\"birthdayservice\"" -#: src/android/aidl/example-service/service.md:31 -#: src/android/aidl/example-service/server.md:36 -#: src/android/aidl/example-service/client.md:39 +#: 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/example-service/service.md:32 -#: src/android/aidl/example-service/server.md:37 -#: src/android/aidl/example-service/client.md:40 +#: 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/example-service/service.md:39 +#: 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." @@ -12505,7 +12459,7 @@ msgstr "" "به مسیر ایجاد `IBirthdayService` trait اشاره کنید و توضیح‌دهید که چرا هر یک " "از بخش‌ها ضروری است." -#: src/android/aidl/example-service/service.md:41 +#: src/android/aidl/example-service/service.md msgid "" "TODO: What does the `binder::Interface` trait do? Are there methods to " "override? Where source?" @@ -12513,48 +12467,47 @@ msgstr "" "‏ TODO: trait وویژگی `binder::Interface` چه کاری انجام می‌دهد؟ آیا متد‌هایی " "برای override وجود دارد؟ source کجاست؟" -#: src/android/aidl/example-service/server.md:1 +#: src/android/aidl/example-service/server.md msgid "AIDL Server" msgstr "AIDL Server" -#: src/android/aidl/example-service/server.md:3 +#: src/android/aidl/example-service/server.md msgid "Finally, we can create a server which exposes the service:" msgstr "در نهایت، می توانیم سروری ایجاد کنیم که سرویس را expose می‌کند:" -#: src/android/aidl/example-service/server.md:5 +#: src/android/aidl/example-service/server.md msgid "_birthday_service/src/server.rs_:" msgstr "_birthday_service/src/server.rs_:" -#: src/android/aidl/example-service/server.md:8 +#: src/android/aidl/example-service/server.md msgid "//! Birthday service.\n" msgstr "//! Birthday service.\n" -#: src/android/aidl/example-service/server.md:14 +#: src/android/aidl/example-service/server.md msgid "/// Entry point for birthday service.\n" msgstr "/// Entry point for birthday service.\n" -#: src/android/aidl/example-service/server.md:23 +#: src/android/aidl/example-service/server.md #, fuzzy msgid "\"Failed to register service\"" msgstr "\"Failed to register service\"" -#: src/android/aidl/example-service/server.md:32 -#: src/android/aidl/example-service/server.md:33 +#: src/android/aidl/example-service/server.md #, fuzzy msgid "\"birthday_server\"" msgstr "\"birthday_server\"" -#: src/android/aidl/example-service/server.md:34 +#: src/android/aidl/example-service/server.md #, fuzzy msgid "\"src/server.rs\"" msgstr "سرورها" -#: src/android/aidl/example-service/server.md:40 -#: src/android/aidl/example-service/client.md:42 +#: src/android/aidl/example-service/server.md +#: src/android/aidl/example-service/client.md msgid "// To avoid dynamic link error.\n" msgstr "// To avoid dynamic link error.\n" -#: src/android/aidl/example-service/server.md:46 +#: 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 " @@ -12568,11 +12521,11 @@ msgstr "" "نظر برسد. اگر آن‌ها از Binder برای C++ یا زبان دیگری استفاده کردند. به " "دانش‌آموزان توضیح دهید که چرا هر مرحله لازم است." -#: src/android/aidl/example-service/server.md:52 +#: src/android/aidl/example-service/server.md msgid "Create an instance of your service type (`BirthdayService`)." msgstr "نمونه‌ای از نوع سرویس خود (`BirthdayService`) ایجاد کنید." -#: src/android/aidl/example-service/server.md:53 +#: 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 " @@ -12586,7 +12539,7 @@ msgstr "" "ارث‌بری یا inheritance نداریم، بنابراین در عوض از ترکیب composition می‌کنیم و " "`BirthdayService` خود را در `BnBinderService` تولید شده قرار می‌دهیم." -#: src/android/aidl/example-service/server.md:58 +#: 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)." @@ -12594,7 +12547,7 @@ msgstr "" "‏ `add_service` را فراخوانی کنید و به آن یک شناسه سرویس و شی‏ سرویس خود بدهید " "(شی‏ «BnBirthdayService» در مثال)." -#: src/android/aidl/example-service/server.md:60 +#: 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." @@ -12602,11 +12555,11 @@ msgstr "" "‏ `join_thread_pool` را فراخوانی کنید تا thread فعلی را به Binder thread " "اضافه کنید و شروع به گوش دادن برای connectionها کنید." -#: src/android/aidl/example-service/deploy.md:3 +#: src/android/aidl/example-service/deploy.md msgid "We can now build, push, and start the service:" msgstr "اکنون می‌توانیم سرویس را بسازیم، push کنیم و شروع کنیم:" -#: src/android/aidl/example-service/deploy.md:5 +#: src/android/aidl/example-service/deploy.md msgid "" "```shell\n" "m birthday_server\n" @@ -12624,67 +12577,65 @@ msgstr "" "adb shell /data/local/tmp/birthday_server\n" "```" -#: src/android/aidl/example-service/deploy.md:12 +#: src/android/aidl/example-service/deploy.md msgid "In another terminal, check that the service runs:" msgstr "در ترمینال دیگر، بررسی کنید که آیا سرویسی اجرا شود:" -#: src/android/aidl/example-service/deploy.md:22 +#: src/android/aidl/example-service/deploy.md msgid "You can also call the service with `service call`:" msgstr "همچنین می‌توانید با `service call` با سرویس تماس بگیرید:" -#: src/android/aidl/example-service/client.md:1 +#: src/android/aidl/example-service/client.md msgid "AIDL Client" msgstr "AIDL Client" -#: src/android/aidl/example-service/client.md:3 +#: src/android/aidl/example-service/client.md msgid "Finally, we can create a Rust client for our new service." msgstr "در‌نهایت، ما می‌توانیم یک Rust client برای سرویس جدید خود ایجاد کنیم." -#: src/android/aidl/example-service/client.md:5 -#: src/android/aidl/example-service/changing-implementation.md:29 +#: 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/example-service/client.md:12 +#: src/android/aidl/example-service/client.md msgid "/// Call the birthday service.\n" msgstr "/// Call the birthday service.\n" -#: src/android/aidl/example-service/client.md:23 -#: src/android/aidl/types/objects.md:54 -#: src/android/aidl/types/parcelables.md:32 -#: src/android/aidl/types/file-descriptor.md:20 +#: 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 #, fuzzy msgid "\"Failed to connect to BirthdayService\"" msgstr "\"Failed to connect to BirthdayService\"" -#: src/android/aidl/example-service/client.md:25 +#: src/android/aidl/example-service/client.md msgid "// Call the service.\n" msgstr "// Call the service.\n" -#: src/android/aidl/example-service/client.md:27 +#: src/android/aidl/example-service/client.md msgid "\"{msg}\"" msgstr "\"{msg}\"" -#: src/android/aidl/example-service/client.md:35 -#: src/android/aidl/example-service/client.md:36 +#: src/android/aidl/example-service/client.md #, fuzzy msgid "\"birthday_client\"" msgstr "\"birthday_client\"" -#: src/android/aidl/example-service/client.md:37 +#: src/android/aidl/example-service/client.md #, fuzzy msgid "\"src/client.rs\"" msgstr "\"src/client.rs\"" -#: src/android/aidl/example-service/client.md:46 +#: src/android/aidl/example-service/client.md msgid "Notice that the client does not depend on `libbirthdayservice`." msgstr "توجه داشته باشید که client به `libbirthdayservice` وابسته نیست." -#: src/android/aidl/example-service/client.md:48 +#: src/android/aidl/example-service/client.md msgid "Build, push, and run the client on your device:" msgstr "کلاینت را در دستگاه خود بسازید، push کرده و اجرا کنید:" -#: src/android/aidl/example-service/client.md:50 +#: src/android/aidl/example-service/client.md msgid "" "```shell\n" "m birthday_client\n" @@ -12700,7 +12651,7 @@ msgstr "" "adb shell /data/local/tmp/birthday_client Charlie 60\n" "```" -#: src/android/aidl/example-service/client.md:62 +#: src/android/aidl/example-service/client.md msgid "" "`Strong` is the trait object representing the service " "that the client has connected to." @@ -12708,7 +12659,7 @@ msgstr "" "‏`Strong` یک trait object است که نشان‌دهنده سرویسی است " "که کلاینت به آن متصل شده است." -#: src/android/aidl/example-service/client.md:64 +#: 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 " @@ -12719,7 +12670,7 @@ msgstr "" "شمارنده global Binder را که تعداد فرآیندهایی را که به object ارجاع دارند را " "ردیابی می‌کند." -#: src/android/aidl/example-service/client.md:67 +#: src/android/aidl/example-service/client.md #, fuzzy msgid "" "Note that the trait object that the client uses to talk to the service uses " @@ -12732,7 +12683,7 @@ msgstr "" "interface معین، یک trait یا ویژگی Rust ایجاد شده است که هم کلاینت و هم سرور " "از آن استفاده می کنند." -#: src/android/aidl/example-service/client.md:71 +#: 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 " @@ -12742,7 +12693,7 @@ msgstr "" "ایده‌آل باید در یک crate مشترک تعریف شود که هم کلاینت و هم سرور می توانند به " "آن وابسته باشند." -#: src/android/aidl/example-service/changing-definition.md:3 +#: 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:" @@ -12750,11 +12701,11 @@ msgstr "" "اجازه دهید API را با عملکرد بیشتری گسترش دهیم: می‌خواهیم به مشتریان اجازه " "دهیم لیستی از خطوط را برای کارت تولد مشخص کنند:" -#: src/android/aidl/example-service/changing-definition.md:16 +#: src/android/aidl/example-service/changing-definition.md msgid "This results in an updated trait definition for `IBirthdayService`:" msgstr "این منجر به یک تعریف ویژگی به روز شده برای `IBirthdayService` می‌شود:" -#: src/android/aidl/example-service/changing-definition.md:31 +#: src/android/aidl/example-service/changing-definition.md msgid "" "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 " @@ -12764,66 +12715,66 @@ msgstr "" "Rust ترجمه می‌شود، به‌عنوان مثال از idiomatic Rust type در bindingهای تولید " "شده تا جایی که ممکن است استفاده می‌شود:" -#: src/android/aidl/example-service/changing-definition.md:34 +#: src/android/aidl/example-service/changing-definition.md msgid "`in` array arguments are translated to slices." msgstr "آرگومان های آرایه `in` به sliceها ترجمه می‌شوند." -#: src/android/aidl/example-service/changing-definition.md:35 +#: src/android/aidl/example-service/changing-definition.md msgid "`out` and `inout` args are translated to `&mut Vec`." msgstr "آرگومان‌های`out` و `inout` به `&mut Vec` ترجمه می‌شوند." -#: src/android/aidl/example-service/changing-definition.md:36 +#: src/android/aidl/example-service/changing-definition.md msgid "Return values are translated to returning a `Vec`." msgstr "مقادیر بازگشتی به بازگرداندن `Vec` ترجمه می‌شوند." -#: src/android/aidl/example-service/changing-implementation.md:1 +#: src/android/aidl/example-service/changing-implementation.md msgid "Updating Client and Service" msgstr "به‌روزرسانی کلاینت و سرویس‌ها" -#: src/android/aidl/example-service/changing-implementation.md:3 +#: src/android/aidl/example-service/changing-implementation.md msgid "Update the client and server code to account for the new API." msgstr "کد سرویس کلاینت و سرور را برای حساب کردن API جدید به‌روز کنید." -#: src/android/aidl/example-service/changing-implementation.md:20 +#: src/android/aidl/example-service/changing-implementation.md msgid "'\\n'" msgstr "'\\n'" -#: src/android/aidl/example-service/changing-implementation.md:36 +#: src/android/aidl/example-service/changing-implementation.md #, fuzzy msgid "\"Habby birfday to yuuuuu\"" msgstr "\"Habby birfday to yuuuuu\"" -#: src/android/aidl/example-service/changing-implementation.md:37 +#: src/android/aidl/example-service/changing-implementation.md #, fuzzy msgid "\"And also: many more\"" msgstr "\"And also: many more\"" -#: src/android/aidl/example-service/changing-implementation.md:44 +#: src/android/aidl/example-service/changing-implementation.md #, fuzzy msgid "" "TODO: Move code snippets into project files where they'll actually be built?" msgstr "" "‏TODO: قطعات کد را به فایل‌های پروژه منتقل کنید، جایی که واقعاً ساخته می‌شوند؟" -#: src/android/aidl/types.md:1 +#: src/android/aidl/types.md msgid "Working With AIDL Types" msgstr "کار با انواع AIDL" -#: src/android/aidl/types.md:3 +#: src/android/aidl/types.md msgid "AIDL types translate into the appropriate idiomatic Rust type:" msgstr "انواع AIDL به نوع اصطلاحی Rust مناسب ترجمه می‌شوند:" -#: src/android/aidl/types.md:5 +#: src/android/aidl/types.md msgid "Primitive types map (mostly) to idiomatic Rust types." msgstr "" "انواع اولیه یا Primitive types (بیشتر) به idiomatic Rust type نگاشت می‌شوند." -#: src/android/aidl/types.md:6 +#: src/android/aidl/types.md msgid "Collection types like slices, `Vec`s and string types are supported." msgstr "" "انواع Collectionها مانند sliceها،`Vec` و string typeها پشتیبانی می‌شوند." -#: src/android/aidl/types.md:7 +#: src/android/aidl/types.md msgid "" "References to AIDL objects and file handles can be sent between clients and " "services." @@ -12831,88 +12782,88 @@ msgstr "" "ارجاع به AIDL objects و دسته فایل‌ها را می‌توان بین clientها و سرویس‌ها ارسال " "کرد." -#: src/android/aidl/types.md:9 +#: src/android/aidl/types.md msgid "File handles and parcelables are fully supported." msgstr "دسته‌های فایل و بسته‌بندی‌ها به طور کامل پشتیبانی می‌شوند." -#: src/android/aidl/types/primitives.md:3 +#: src/android/aidl/types/primitives.md #, fuzzy msgid "Primitive types map (mostly) idiomatically:" msgstr "" "انواع ابتدایی یا Primitive type (عمدتا) به صورت idiomatically نگاشت می‌شوند:" -#: src/android/aidl/types/primitives.md:5 +#: src/android/aidl/types/primitives.md #, fuzzy msgid "AIDL Type" msgstr "AIDL" -#: src/android/aidl/types/primitives.md:5 src/android/aidl/types/arrays.md:7 -#: src/android/interoperability/cpp/type-mapping.md:3 +#: src/android/aidl/types/primitives.md src/android/aidl/types/arrays.md +#: src/android/interoperability/cpp/type-mapping.md #, fuzzy msgid "Rust Type" msgstr "انواع داده‌های بازگشتی" -#: src/android/aidl/types/primitives.md:5 +#: src/android/aidl/types/primitives.md msgid "Note" msgstr "نکته" -#: src/android/aidl/types/primitives.md:7 +#: src/android/aidl/types/primitives.md msgid "`boolean`" msgstr "بولین‌ها`boolean`" -#: src/android/aidl/types/primitives.md:8 +#: src/android/aidl/types/primitives.md msgid "`byte`" msgstr "" -#: src/android/aidl/types/primitives.md:8 +#: src/android/aidl/types/primitives.md msgid "`i8`" msgstr "`i8`" -#: src/android/aidl/types/primitives.md:8 +#: src/android/aidl/types/primitives.md msgid "Note that bytes are signed." msgstr "توجه داشته باشید که بایت‌ها امضا شده‌اند." -#: src/android/aidl/types/primitives.md:9 +#: src/android/aidl/types/primitives.md msgid "`u16`" msgstr "`u16`" -#: src/android/aidl/types/primitives.md:9 +#: src/android/aidl/types/primitives.md msgid "Note the usage of `u16`, NOT `u32`." msgstr "به استفاده از `u16` توجه کنید، نه `u32`." -#: src/android/aidl/types/primitives.md:10 +#: src/android/aidl/types/primitives.md msgid "`int`" msgstr "`int`" -#: src/android/aidl/types/primitives.md:10 +#: src/android/aidl/types/primitives.md msgid "`i32`" msgstr "`i32`" -#: src/android/aidl/types/primitives.md:11 +#: src/android/aidl/types/primitives.md msgid "`long`" msgstr "`long`" -#: src/android/aidl/types/primitives.md:11 +#: src/android/aidl/types/primitives.md msgid "`i64`" msgstr "`i64`" -#: src/android/aidl/types/primitives.md:12 +#: src/android/aidl/types/primitives.md msgid "`float`" msgstr "`float`" -#: src/android/aidl/types/primitives.md:12 +#: src/android/aidl/types/primitives.md msgid "`f32`" msgstr "`f32`" -#: src/android/aidl/types/primitives.md:13 +#: src/android/aidl/types/primitives.md msgid "`double`" msgstr "`double`" -#: src/android/aidl/types/primitives.md:13 +#: src/android/aidl/types/primitives.md msgid "`f64`" msgstr "`f64`" -#: src/android/aidl/types/arrays.md:3 +#: 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 " @@ -12921,37 +12872,37 @@ msgstr "" "انواع آرایه (`T[]`, `byte[]`, و `List`) بسته به نحوه استفاده از آنها در " "function signature، به Rust array type مناسب ترجمه می‌شوند:" -#: src/android/aidl/types/arrays.md:7 +#: src/android/aidl/types/arrays.md #, fuzzy msgid "Position" msgstr "راه حل" -#: src/android/aidl/types/arrays.md:9 +#: src/android/aidl/types/arrays.md msgid "`in` argument" msgstr "`in` argument" -#: src/android/aidl/types/arrays.md:9 +#: src/android/aidl/types/arrays.md msgid "`&[T]`" msgstr "`&[T]`" -#: src/android/aidl/types/arrays.md:10 +#: src/android/aidl/types/arrays.md msgid "`out`/`inout` argument" msgstr "`out`/`inout` argument" -#: src/android/aidl/types/arrays.md:10 +#: src/android/aidl/types/arrays.md msgid "`&mut Vec`" msgstr "`&mut Vec`" -#: src/android/aidl/types/arrays.md:11 +#: src/android/aidl/types/arrays.md msgid "Return" msgstr "Return" -#: src/android/aidl/types/arrays.md:11 -#: src/android/interoperability/cpp/type-mapping.md:11 +#: src/android/aidl/types/arrays.md +#: src/android/interoperability/cpp/type-mapping.md msgid "`Vec`" msgstr "`Vec`" -#: src/android/aidl/types/arrays.md:15 +#: src/android/aidl/types/arrays.md msgid "" "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. " @@ -12963,11 +12914,11 @@ msgstr "" "(مانند ‌`int[3][4]`. در Java backend، آرایه‌های با اندازه ثابت به عنوان array " "type نمایش داده می‌شوند." -#: src/android/aidl/types/arrays.md:18 +#: src/android/aidl/types/arrays.md msgid "Arrays in parcelable fields always get translated to `Vec`." msgstr "آرایه‌های موجود در فیلدهای parcelable همیشه به `Vec` ترجمه می‌شوند." -#: src/android/aidl/types/objects.md:3 +#: 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:" @@ -12975,7 +12926,7 @@ msgstr "" "‏ AIDL objects را می‌توان به‌عنوان یک نوع AIDL مشخص یا به عنوان `IBinder` " "interface پاک‌شده ارسال کرد:" -#: src/android/aidl/types/objects.md:6 +#: src/android/aidl/types/objects.md msgid "" "**birthday_service/aidl/com/example/birthdayservice/IBirthdayInfoProvider." "aidl**:" @@ -12983,49 +12934,47 @@ msgstr "" "**birthday_service/aidl/com/example/birthdayservice/IBirthdayInfoProvider." "aidl**:" -#: src/android/aidl/types/objects.md:17 -#: src/android/aidl/types/parcelables.md:16 -#: src/android/aidl/types/file-descriptor.md:6 +#: src/android/aidl/types/objects.md src/android/aidl/types/parcelables.md +#: src/android/aidl/types/file-descriptor.md msgid "" "**birthday_service/aidl/com/example/birthdayservice/IBirthdayService.aidl**:" msgstr "" "**birthday_service/aidl/com/example/birthdayservice/IBirthdayService.aidl**:" -#: src/android/aidl/types/objects.md:23 +#: src/android/aidl/types/objects.md msgid "/** The same thing, but using a binder object. */" msgstr "/** The same thing, but using a binder object. */" -#: src/android/aidl/types/objects.md:26 +#: src/android/aidl/types/objects.md msgid "/** The same thing, but using `IBinder`. */" msgstr "/** The same thing, but using `IBinder`. */" -#: src/android/aidl/types/objects.md:31 -#: src/android/aidl/types/parcelables.md:27 -#: src/android/aidl/types/file-descriptor.md:15 +#: src/android/aidl/types/objects.md src/android/aidl/types/parcelables.md +#: src/android/aidl/types/file-descriptor.md msgid "**birthday_service/src/client.rs**:" msgstr "**birthday_service/src/client.rs**:" -#: src/android/aidl/types/objects.md:34 +#: src/android/aidl/types/objects.md msgid "/// Rust struct implementing the `IBirthdayInfoProvider` interface.\n" msgstr "/// Rust struct implementing the `IBirthdayInfoProvider` interface.\n" -#: src/android/aidl/types/objects.md:56 +#: src/android/aidl/types/objects.md msgid "// Create a binder object for the `IBirthdayInfoProvider` interface.\n" msgstr "// Create a binder object for the `IBirthdayInfoProvider` interface.\n" -#: src/android/aidl/types/objects.md:62 +#: src/android/aidl/types/objects.md #, fuzzy msgid "// Send the binder object to the service.\n" msgstr "// SAFETY: `abs` doesn't have any safety requirements.\n" -#: src/android/aidl/types/objects.md:65 +#: src/android/aidl/types/objects.md #, fuzzy msgid "" "// Perform the same operation but passing the provider as an `SpIBinder`.\n" msgstr "" "// Perform the same operation but passing the provider as an `SpIBinder`.\n" -#: src/android/aidl/types/objects.md:72 +#: src/android/aidl/types/objects.md msgid "" "Note the usage of `BnBirthdayInfoProvider`. This serves the same purpose as " "`BnBirthdayService` that we saw previously." @@ -13033,23 +12982,23 @@ msgstr "" "به استفاده از `BnBirthdayInfoProvider` توجه کنید. این همان هدف " "`BnBirthdayService` است که قبلاً دیدیم." -#: src/android/aidl/types/parcelables.md:3 +#: src/android/aidl/types/parcelables.md #, fuzzy msgid "Binder for Rust supports sending parcelables directly:" msgstr "‏ Binder برای Rust از ارسال مستقیم بسته‌بندی‌ها پشتیبانی می‌کند:" -#: src/android/aidl/types/parcelables.md:5 +#: src/android/aidl/types/parcelables.md msgid "" "**birthday_service/aidl/com/example/birthdayservice/BirthdayInfo.aidl**:" msgstr "" "**birthday_service/aidl/com/example/birthdayservice/BirthdayInfo.aidl**:" -#: src/android/aidl/types/parcelables.md:22 +#: src/android/aidl/types/parcelables.md #, fuzzy msgid "/** The same thing, but with a parcelable. */" msgstr "/** The same thing, but with a parcelable. */" -#: src/android/aidl/types/file-descriptor.md:3 +#: src/android/aidl/types/file-descriptor.md msgid "" "Files can be sent between Binder clients/servers using the " "`ParcelFileDescriptor` type:" @@ -13057,38 +13006,38 @@ msgstr "" "فایل‌ها را می‌توان با استفاده از نوع `ParcelFileDescriptor` بین کلاینت‌ها/" "سرورهای Binder ارسال کرد:" -#: src/android/aidl/types/file-descriptor.md:10 +#: src/android/aidl/types/file-descriptor.md #, fuzzy msgid "/** The same thing, but loads info from a file. */" msgstr "/** The same thing, but loads info from a file. */" -#: src/android/aidl/types/file-descriptor.md:22 +#: src/android/aidl/types/file-descriptor.md #, fuzzy msgid "// Open a file and put the birthday info in it.\n" msgstr "// Open a file and put the birthday info in it.\n" -#: src/android/aidl/types/file-descriptor.md:23 +#: src/android/aidl/types/file-descriptor.md msgid "\"/data/local/tmp/birthday.info\"" msgstr "\"/data/local/tmp/birthday.info\"" -#: src/android/aidl/types/file-descriptor.md:24 +#: src/android/aidl/types/file-descriptor.md msgid "\"{name}\"" msgstr "\"{name}\"" -#: src/android/aidl/types/file-descriptor.md:25 +#: src/android/aidl/types/file-descriptor.md msgid "\"{years}\"" msgstr "\"{years}\"" -#: src/android/aidl/types/file-descriptor.md:27 +#: src/android/aidl/types/file-descriptor.md #, fuzzy msgid "// Create a `ParcelFileDescriptor` from the file and send it.\n" msgstr "// Create a `ParcelFileDescriptor` from the file and send it.\n" -#: src/android/aidl/types/file-descriptor.md:33 +#: src/android/aidl/types/file-descriptor.md msgid "**birthday_service/src/lib.rs**:" msgstr "**birthday_service/src/lib.rs**:" -#: src/android/aidl/types/file-descriptor.md:41 +#: src/android/aidl/types/file-descriptor.md #, fuzzy msgid "" "// Convert the file descriptor to a `File`. `ParcelFileDescriptor` wraps\n" @@ -13101,12 +13050,12 @@ msgstr "" "`File`\n" " // object.\n" -#: src/android/aidl/types/file-descriptor.md:48 +#: src/android/aidl/types/file-descriptor.md #, fuzzy msgid "\"Invalid file handle\"" msgstr "\"Invalid file handle\"" -#: src/android/aidl/types/file-descriptor.md:64 +#: 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 " @@ -13116,7 +13065,7 @@ msgstr "" "`File` (یا هر نوع دیگری که یک `OwnedFd` را احاطه می‌کند) ایجاد کند و می‌تواند " "برای ایجاد یک دسته `File` جدید در طرف دیگر استفاده شود." -#: src/android/aidl/types/file-descriptor.md:67 +#: 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." @@ -13158,7 +13107,7 @@ msgstr "\"libleftpad_test\"" msgid "\"leftpad_test\"" msgstr "\"leftpad_test\"" -#: src/android/testing.md src/android/interoperability/with-c/bindgen.md:116 +#: src/android/testing.md src/android/interoperability/with-c/bindgen.md msgid "\"general-tests\"" msgstr "\"general-tests\"" @@ -13228,7 +13177,7 @@ msgstr "" "توجه کنید که چگونه فقط ریشه crate کتابخانه را ذکر می‌کنید. تست‌ها به صورت " "بازگشتی در ماژول‌های تودرتو یافت می‌شوند." -#: src/android/testing/googletest.md:3 +#: src/android/testing/googletest.md msgid "" "The [GoogleTest](https://docs.rs/googletest/) crate allows for flexible test " "assertions using _matchers_:" @@ -13236,15 +13185,15 @@ msgstr "" "جعبه [GoogleTest](https://docs.rs/googletest/) با استفاده از _matchers_ " "اجازه می‌دهد تا assertهای آزمایشی انعطاف‌پذیر را انجام دهید:" -#: src/android/testing/googletest.md:11 +#: src/android/testing/googletest.md msgid "\"baz\"" msgstr "\"baz\"" -#: src/android/testing/googletest.md:12 +#: src/android/testing/googletest.md msgid "\"xyz\"" msgstr "\"xyz\"" -#: src/android/testing/googletest.md:16 +#: src/android/testing/googletest.md msgid "" "If we change the last element to `\"!\"`, the test fails with a structured " "error message pin-pointing the error:" @@ -13252,7 +13201,7 @@ msgstr "" "اگر آخرین عنصر را به`\"!\"`تغییر دهیم، آزمایش با یک پیغام خطای ساختار یافته " "که خطا را pin-pointing می‌کند، شکست می خورد:" -#: src/android/testing/googletest.md:37 +#: src/android/testing/googletest.md msgid "" "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 " @@ -13262,7 +13211,7 @@ msgstr "" "محیط local اجرا کنید. برای افزودن سریع آن به پروژه Cargo موجود، از `cargo " "add googletest` استفاده کنید." -#: src/android/testing/googletest.md:41 +#: src/android/testing/googletest.md msgid "" "The `use googletest::prelude::*;` line imports a number of [commonly used " "macros and types](https://docs.rs/googletest/latest/googletest/prelude/index." @@ -13272,14 +13221,15 @@ msgstr "" "(https://docs.rs/googletest/latest/googletest/prelude/index.html) را وارد " "می‌کند." -#: src/android/testing/googletest.md:44 +#: src/android/testing/googletest.md +#, fuzzy msgid "" "This just scratches the surface, there are many builtin matchers. Consider " "going through the first chapter of [\"Advanced testing for Rust " -"applications\"](https://github.com/mainmatter/rust-advanced-testing-" -"workshop), 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." +"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 "" "این فقط سطح را نشان می‌دهد، تطبیق‌های داخلی زیادی وجود دارد. فصل اول [‌آزمایش " "پیشرفته برای برنامه های Rust]‌(https://github.com/mainmatter/rust-advanced-" @@ -13287,7 +13237,7 @@ msgstr "" "راهنمایی برای کتابخانه با تمرین‌هایی که به شما کمک می‌کند با ماکروهای " "`googletest` و مطابقت‌های آن و فلسفه کلی آن راحت باشید." -#: src/android/testing/googletest.md:51 +#: src/android/testing/googletest.md msgid "" "A particularly nice feature is that mismatches in multi-line strings are " "shown as a diff:" @@ -13295,7 +13245,7 @@ msgstr "" "یک ویژگی خاص خوب این است که عدم تطابق در string‌های چند خطی به صورت یک تفاوت " "نشان داده می شود:" -#: src/android/testing/googletest.md:57 +#: src/android/testing/googletest.md msgid "" "\"Memory safety found,\\n\\\n" " Rust's strong typing guides the way,\\n\\\n" @@ -13305,7 +13255,7 @@ msgstr "" " Rust's strong typing guides the way,\\n\\\n" " Secure code you'll write.\"" -#: src/android/testing/googletest.md:62 +#: src/android/testing/googletest.md msgid "" "\"Memory safety found,\\n\\\n" " Rust's silly humor guides the way,\\n\\\n" @@ -13315,11 +13265,11 @@ msgstr "" " Rust's silly humor guides the way,\\n\\\n" " Secure code you'll write.\"" -#: src/android/testing/googletest.md:69 +#: src/android/testing/googletest.md msgid "shows a color-coded diff (colors not shown here):" msgstr "تفاوت رنگی را نشان می‌دهد (رنگ ها در اینجا نشان‌داده نمی‌شوند):" -#: src/android/testing/googletest.md:86 +#: src/android/testing/googletest.md msgid "" "The crate is a Rust port of [GoogleTest for C++](https://google.github.io/" "googletest/)." @@ -13327,7 +13277,7 @@ msgstr "" "این crate یک پورت [GoogleTest for C++]‌(https://google.github.io/googletest/) " "در Rust است." -#: src/android/testing/mocking.md:3 +#: src/android/testing/mocking.md msgid "" "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 " @@ -13337,7 +13287,7 @@ msgstr "" "بوده استفاده شده است. برای استفاده از traitها، باید کد خود را مجدداً تغییر " "دهید، سپس می‌توانید به سرعت آنها را mock کنید:" -#: src/android/testing/mocking.md:27 +#: src/android/testing/mocking.md msgid "" "Mockall is the recommended mocking library in Android (AOSP). There are " "other [mocking libraries available on crates.io](https://crates.io/keywords/" @@ -13351,7 +13301,7 @@ msgstr "" "مشابه Mockall کار می‌کنند، به این معنی که اجرای ساختگی یا mock یک ویژگی خاص " "را آسان می‌کنند." -#: src/android/testing/mocking.md:33 +#: src/android/testing/mocking.md msgid "" "Note that mocking is somewhat _controversial_: mocks allow you to completely " "isolate a test from its dependencies. The immediate result is faster and " @@ -13364,7 +13314,7 @@ msgstr "" "پیکربندی کرد و خروجی متفاوتی با آنچه وابستگی های واقعی انجام می دادند را " "برگرداند." -#: src/android/testing/mocking.md:38 +#: src/android/testing/mocking.md #, fuzzy msgid "" "If at all possible, it is recommended that you use the real dependencies. As " @@ -13378,7 +13328,7 @@ msgstr "" "دریافت می کنید، به علاوه آنها سریع هستند و به طور خودکار پس از اجرای عملیات " "مخصوص به خود پاک می شوند." -#: src/android/testing/mocking.md:43 +#: src/android/testing/mocking.md msgid "" "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 " @@ -13389,7 +13339,7 @@ msgstr "" "همیشه این را به mock کردن framework ترجیح دهید زیرا به شما کمک می‌کند کد خود " "را در محیط واقعی آزمایش کنید." -#: src/android/testing/mocking.md:47 +#: src/android/testing/mocking.md msgid "" "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 " @@ -13399,7 +13349,7 @@ msgstr "" "local اجرا کنید. از `cargo add mockall` برای اضافه کردن سریع Mockall به " "پروژه Cargo موجود استفاده کنید." -#: src/android/testing/mocking.md:51 +#: 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 " @@ -13410,7 +13360,7 @@ msgstr "" "عملکرد cat استفاده می‌کنیم که 3 ساعت پس از آخرین باری که به آن غذا داده شده " "گرسنه می‌شود:" -#: src/android/testing/mocking.md:69 +#: src/android/testing/mocking.md msgid "" "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 " @@ -13477,8 +13427,8 @@ msgstr "\"Things are going fine.\"" msgid "\"Something went wrong!\"" msgstr "\"Something went wrong!\"" -#: src/android/logging.md src/android/interoperability/with-c/bindgen.md:99 -#: src/android/interoperability/with-c/rust.md:72 +#: 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 و اجرای باینری‌ها روی یک ماشین." @@ -13527,11 +13477,11 @@ msgstr "" "خارج( _foreign function interface_) که به نام FFI نیز شناخته می‌شود، استفاده " "می‌کنید." -#: src/android/interoperability/with-c.md:1 +#: src/android/interoperability/with-c.md msgid "Interoperability with C" msgstr "قابلیت همکاری با C" -#: src/android/interoperability/with-c.md:3 +#: 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." @@ -13540,20 +13490,20 @@ msgstr "" "به طور مشابه، می توانید توابع Rust را export کرده و آنها را از C فراخوانی " "کنید." -#: src/android/interoperability/with-c.md:6 +#: src/android/interoperability/with-c.md msgid "You can do it by hand if you want:" msgstr "در صورت تمایل می‌توانید این کار را دستی انجام دهید:" -#: src/android/interoperability/with-c.md:15 +#: src/android/interoperability/with-c.md #, fuzzy msgid "// SAFETY: `abs` doesn't have any safety requirements.\n" msgstr "// SAFETY: `abs` doesn't have any safety requirements.\n" -#: src/android/interoperability/with-c.md:17 +#: src/android/interoperability/with-c.md msgid "\"{x}, {abs_x}\"" msgstr "\"{x}, {abs_x}\"" -#: src/android/interoperability/with-c.md:21 +#: src/android/interoperability/with-c.md msgid "" "We already saw this in the [Safe FFI Wrapper exercise](../../unsafe-rust/" "exercise.md)." @@ -13561,22 +13511,22 @@ msgstr "" "ما قبلاً این را در [تمرین Safe FFI Wrapper](../../unsafe-rust/exercise.md) " "دیدیم." -#: src/android/interoperability/with-c.md:24 +#: src/android/interoperability/with-c.md msgid "" "This assumes full knowledge of the target platform. Not recommended for " "production." msgstr "" "این مستلزم آگاهی کامل از پلتفرم هدف است و برای production توصیه نمی‌شود." -#: src/android/interoperability/with-c.md:27 +#: src/android/interoperability/with-c.md msgid "We will look at better options next." msgstr "در ادامه گزینه‌های بهتر را بررسی خواهیم کرد." -#: src/android/interoperability/with-c/bindgen.md:1 +#: src/android/interoperability/with-c/bindgen.md msgid "Using Bindgen" msgstr "با استفاده از Bindgen" -#: src/android/interoperability/with-c/bindgen.md:3 +#: 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." @@ -13584,61 +13534,55 @@ msgstr "" "ابزار [bindgen](https://rust-lang.github.io/rust-bindgen/introduction.html) " "می‌تواند اتصالات را از یک فایل هدر C به طور خودکار ایجاد کند." -#: src/android/interoperability/with-c/bindgen.md:6 +#: src/android/interoperability/with-c/bindgen.md msgid "First create a small C library:" msgstr "ابتدا یک کتابخانه کوچک C ایجاد کنید:" -#: src/android/interoperability/with-c/bindgen.md:8 +#: src/android/interoperability/with-c/bindgen.md msgid "_interoperability/bindgen/libbirthday.h_:" msgstr "_interoperability/bindgen/libbirthday.h_:" -#: src/android/interoperability/with-c/bindgen.md:19 +#: src/android/interoperability/with-c/bindgen.md msgid "_interoperability/bindgen/libbirthday.c_:" msgstr "_interoperability/bindgen/libbirthday.c_:" -#: src/android/interoperability/with-c/bindgen.md:22 +#: src/android/interoperability/with-c/bindgen.md msgid "" msgstr "" -#: src/android/interoperability/with-c/bindgen.md:23 -#: src/android/interoperability/with-c/bindgen.md:50 +#: src/android/interoperability/with-c/bindgen.md msgid "\"libbirthday.h\"" msgstr "\"libbirthday.h\"" -#: src/android/interoperability/with-c/bindgen.md:26 -#: src/android/interoperability/with-c/bindgen.md:29 +#: src/android/interoperability/with-c/bindgen.md msgid "\"+--------------\\n\"" msgstr "\"+--------------\\n\"" -#: src/android/interoperability/with-c/bindgen.md:27 +#: src/android/interoperability/with-c/bindgen.md msgid "\"| Happy Birthday %s!\\n\"" msgstr "\"| Happy Birthday %s!\\n\"" -#: src/android/interoperability/with-c/bindgen.md:28 +#: src/android/interoperability/with-c/bindgen.md msgid "\"| Congratulations with the %i years!\\n\"" msgstr "\"| Congratulations with the %i years!\\n\"" -#: src/android/interoperability/with-c/bindgen.md:33 +#: src/android/interoperability/with-c/bindgen.md msgid "Add this to your `Android.bp` file:" msgstr "این را به فایل `Android.bp` خود اضافه کنید:" -#: src/android/interoperability/with-c/bindgen.md:35 -#: src/android/interoperability/with-c/bindgen.md:55 -#: src/android/interoperability/with-c/bindgen.md:69 -#: src/android/interoperability/with-c/bindgen.md:109 +#: src/android/interoperability/with-c/bindgen.md msgid "_interoperability/bindgen/Android.bp_:" msgstr "_interoperability/bindgen/Android.bp_:" -#: src/android/interoperability/with-c/bindgen.md:39 -#: src/android/interoperability/with-c/bindgen.md:63 +#: src/android/interoperability/with-c/bindgen.md msgid "\"libbirthday\"" msgstr "\"libbirthday\"" -#: src/android/interoperability/with-c/bindgen.md:40 +#: src/android/interoperability/with-c/bindgen.md msgid "\"libbirthday.c\"" msgstr "\"libbirthday.c\"" -#: src/android/interoperability/with-c/bindgen.md:44 +#: src/android/interoperability/with-c/bindgen.md msgid "" "Create a wrapper header file for the library (not strictly needed in this " "example):" @@ -13646,53 +13590,52 @@ msgstr "" "یک فایل هدر wrapper برای کتابخانه ایجاد کنید (در این مثال به شدت مورد نیاز " "نیست):" -#: src/android/interoperability/with-c/bindgen.md:47 +#: src/android/interoperability/with-c/bindgen.md msgid "_interoperability/bindgen/libbirthday_wrapper.h_:" msgstr "_interoperability/bindgen/libbirthday_wrapper.h_:" -#: src/android/interoperability/with-c/bindgen.md:53 +#: src/android/interoperability/with-c/bindgen.md msgid "You can now auto-generate the bindings:" msgstr "اکنون می توانید اتصالات (bindings) را به طور خودکار ایجاد کنید:" -#: src/android/interoperability/with-c/bindgen.md:59 -#: src/android/interoperability/with-c/bindgen.md:75 +#: src/android/interoperability/with-c/bindgen.md msgid "\"libbirthday_bindgen\"" msgstr "\"libbirthday_bindgen\"" -#: src/android/interoperability/with-c/bindgen.md:60 +#: src/android/interoperability/with-c/bindgen.md msgid "\"birthday_bindgen\"" msgstr "\"birthday_bindgen\"" -#: src/android/interoperability/with-c/bindgen.md:61 +#: src/android/interoperability/with-c/bindgen.md msgid "\"libbirthday_wrapper.h\"" msgstr "\"libbirthday_wrapper.h\"" -#: src/android/interoperability/with-c/bindgen.md:62 +#: src/android/interoperability/with-c/bindgen.md msgid "\"bindings\"" msgstr "\"bindings\"" -#: src/android/interoperability/with-c/bindgen.md:67 +#: src/android/interoperability/with-c/bindgen.md msgid "Finally, we can use the bindings in our Rust program:" msgstr "در نهایت، می‌توانیم از bindingها در برنامه Rust خود استفاده کنیم:" -#: src/android/interoperability/with-c/bindgen.md:73 +#: src/android/interoperability/with-c/bindgen.md #, fuzzy msgid "\"print_birthday_card\"" msgstr "\"print_birthday_card\"" -#: src/android/interoperability/with-c/bindgen.md:74 +#: src/android/interoperability/with-c/bindgen.md msgid "\"main.rs\"" msgstr "\"main.rs\"" -#: src/android/interoperability/with-c/bindgen.md:79 +#: src/android/interoperability/with-c/bindgen.md msgid "_interoperability/bindgen/main.rs_:" msgstr "_interoperability/bindgen/main.rs_:" -#: src/android/interoperability/with-c/bindgen.md:82 +#: src/android/interoperability/with-c/bindgen.md msgid "//! Bindgen demo.\n" msgstr "//! Bindgen demo.\n" -#: src/android/interoperability/with-c/bindgen.md:89 +#: 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 " @@ -13708,7 +13651,7 @@ msgstr "" "later\n" " // after it returns.\n" -#: src/android/interoperability/with-c/bindgen.md:101 +#: src/android/interoperability/with-c/bindgen.md msgid "" "```shell\n" "m print_birthday_card\n" @@ -13724,106 +13667,103 @@ msgstr "" "adb shell /data/local/tmp/print_birthday_card\n" "```" -#: src/android/interoperability/with-c/bindgen.md:107 +#: src/android/interoperability/with-c/bindgen.md msgid "Finally, we can run auto-generated tests to ensure the bindings work:" msgstr "" "در نهایت، ما می‌توانیم تست‌های تولید شده خودکار را برای اطمینان از کارکرد " "اتصالات (bindings) اجرا کنیم:" -#: src/android/interoperability/with-c/bindgen.md:113 -#: src/android/interoperability/with-c/bindgen.md:115 +#: src/android/interoperability/with-c/bindgen.md msgid "\"libbirthday_bindgen_test\"" msgstr "\"libbirthday_bindgen_test\"" -#: src/android/interoperability/with-c/bindgen.md:114 +#: src/android/interoperability/with-c/bindgen.md msgid "\":libbirthday_bindgen\"" msgstr "\":libbirthday_bindgen\"" -#: src/android/interoperability/with-c/bindgen.md:118 -#: src/android/interoperability/with-c/bindgen.md:119 +#: src/android/interoperability/with-c/bindgen.md msgid "\"none\"" msgstr "\"none\"" -#: src/android/interoperability/with-c/bindgen.md:118 +#: src/android/interoperability/with-c/bindgen.md msgid "// Generated file, skip linting\n" msgstr "// Generated file, skip linting\n" -#: src/android/interoperability/with-c/rust.md:1 +#: src/android/interoperability/with-c/rust.md msgid "Calling Rust" msgstr "فراخوانی Rust" -#: src/android/interoperability/with-c/rust.md:3 +#: src/android/interoperability/with-c/rust.md msgid "Exporting Rust functions and types to C is easy:" msgstr "صدور یا Exporting توابع و تایپ‌ها از Rust به C آسان است:" -#: src/android/interoperability/with-c/rust.md:5 +#: src/android/interoperability/with-c/rust.md msgid "_interoperability/rust/libanalyze/analyze.rs_" msgstr "_interoperability/rust/libanalyze/analyze.rs_" -#: src/android/interoperability/with-c/rust.md:8 +#: src/android/interoperability/with-c/rust.md msgid "//! Rust FFI demo.\n" msgstr "//! Rust FFI demo.\n" -#: src/android/interoperability/with-c/rust.md:12 +#: src/android/interoperability/with-c/rust.md msgid "/// Analyze the numbers.\n" msgstr "/// Analyze the numbers.\n" -#: src/android/interoperability/with-c/rust.md:17 +#: src/android/interoperability/with-c/rust.md #, fuzzy msgid "\"x ({x}) is smallest!\"" msgstr "\"x ({x}) is smallest!\"" -#: src/android/interoperability/with-c/rust.md:19 +#: src/android/interoperability/with-c/rust.md #, fuzzy msgid "\"y ({y}) is probably larger than x ({x})\"" msgstr "\"y ({y}) is probably larger than x ({x})\"" -#: src/android/interoperability/with-c/rust.md:24 +#: src/android/interoperability/with-c/rust.md msgid "_interoperability/rust/libanalyze/analyze.h_" msgstr "_interoperability/rust/libanalyze/analyze.h_" -#: src/android/interoperability/with-c/rust.md:37 +#: src/android/interoperability/with-c/rust.md msgid "_interoperability/rust/libanalyze/Android.bp_" msgstr "_interoperability/rust/libanalyze/Android.bp_" -#: src/android/interoperability/with-c/rust.md:41 -#: src/android/interoperability/with-c/rust.md:68 +#: src/android/interoperability/with-c/rust.md msgid "\"libanalyze_ffi\"" msgstr "\"libanalyze_ffi\"" -#: src/android/interoperability/with-c/rust.md:42 +#: src/android/interoperability/with-c/rust.md msgid "\"analyze_ffi\"" msgstr "\"analyze_ffi\"" -#: src/android/interoperability/with-c/rust.md:43 +#: src/android/interoperability/with-c/rust.md msgid "\"analyze.rs\"" msgstr "\"analyze.rs\"" -#: src/android/interoperability/with-c/rust.md:48 +#: src/android/interoperability/with-c/rust.md msgid "We can now call this from a C binary:" msgstr "اکنون می توانیم این را از یک باینری C فراخوانی کنیم:" -#: src/android/interoperability/with-c/rust.md:50 +#: src/android/interoperability/with-c/rust.md msgid "_interoperability/rust/analyze/main.c_" msgstr "_interoperability/rust/analyze/Android.bp_" -#: src/android/interoperability/with-c/rust.md:53 +#: src/android/interoperability/with-c/rust.md msgid "\"analyze.h\"" msgstr "\"analyze.h\"" -#: src/android/interoperability/with-c/rust.md:62 +#: src/android/interoperability/with-c/rust.md msgid "_interoperability/rust/analyze/Android.bp_" msgstr "_interoperability/rust/analyze/Android.bp_" -#: src/android/interoperability/with-c/rust.md:66 +#: src/android/interoperability/with-c/rust.md msgid "\"analyze_numbers\"" msgstr "\"analyze_numbers\"" -#: src/android/interoperability/with-c/rust.md:67 +#: src/android/interoperability/with-c/rust.md msgid "\"main.c\"" msgstr "\"main.c\"" -#: src/android/interoperability/with-c/rust.md:74 +#: src/android/interoperability/with-c/rust.md msgid "" "```shell\n" "m analyze_numbers\n" @@ -13839,7 +13779,7 @@ msgstr "" "adb shell /data/local/tmp/analyze_numbers\n" "```" -#: src/android/interoperability/with-c/rust.md:82 +#: src/android/interoperability/with-c/rust.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 = " @@ -13849,7 +13789,7 @@ msgstr "" "فقط نام تابع خواهد بود. همچنین می‌توانید از `#[export_name = \"some_name\"]` " "برای تعیین هر نامی استفاده کنید" -#: src/android/interoperability/cpp.md:3 +#: src/android/interoperability/cpp.md msgid "" "The [CXX crate](https://cxx.rs/) makes it possible to do safe " "interoperability between Rust and C++." @@ -13857,11 +13797,11 @@ msgstr "" "این [CXX crate](https://cxx.rs/) امکان همکاری امن بین Rust و C++ را فراهم " "می‌کند." -#: src/android/interoperability/cpp.md:6 +#: src/android/interoperability/cpp.md msgid "The overall approach looks like this:" msgstr "رویکرد کلی به این صورت است:" -#: src/android/interoperability/cpp/bridge.md:3 +#: src/android/interoperability/cpp/bridge.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 " @@ -13872,51 +13812,51 @@ msgstr "" "ماژول Rust ارائه می‌کنید که با attribute ماکروها `#[cxx::bridge]` شرح داده " "شده است." -#: src/android/interoperability/cpp/bridge.md:9 +#: src/android/interoperability/cpp/bridge.md msgid "\"org::blobstore\"" msgstr "\"org::blobstore\"" -#: src/android/interoperability/cpp/bridge.md:11 +#: src/android/interoperability/cpp/bridge.md msgid "// Shared structs with fields visible to both languages.\n" msgstr "// Shared structs with fields visible to both languages.\n" -#: src/android/interoperability/cpp/bridge.md:17 -#: src/android/interoperability/cpp/generated-cpp.md:6 +#: src/android/interoperability/cpp/bridge.md +#: src/android/interoperability/cpp/generated-cpp.md msgid "// Rust types and signatures exposed to C++.\n" msgstr "// Rust types and signatures exposed to C++.\n" -#: src/android/interoperability/cpp/bridge.md:18 -#: src/android/interoperability/cpp/rust-bridge.md:6 -#: src/android/interoperability/cpp/generated-cpp.md:7 -#: src/android/interoperability/cpp/rust-result.md:6 -#: src/chromium/interoperability-with-cpp/example-bindings.md:9 -#: src/chromium/interoperability-with-cpp/error-handling-qr.md:10 -#: src/chromium/interoperability-with-cpp/error-handling-png.md:9 +#: 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:24 -#: src/android/interoperability/cpp/cpp-bridge.md:6 +#: src/android/interoperability/cpp/bridge.md +#: src/android/interoperability/cpp/cpp-bridge.md msgid "// C++ types and signatures exposed to Rust.\n" msgstr "" -#: src/android/interoperability/cpp/bridge.md:25 -#: src/android/interoperability/cpp/cpp-bridge.md:7 -#: src/android/interoperability/cpp/cpp-exception.md:6 -#: src/chromium/interoperability-with-cpp/example-bindings.md:15 +#: 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:26 -#: src/android/interoperability/cpp/cpp-bridge.md:8 +#: 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:40 +#: src/android/interoperability/cpp/bridge.md msgid "The bridge is generally declared in an `ffi` module within your crate." msgstr "پل به طور کلی در یک ماژول `ffi`در crate شما اعلام می‌شود." -#: src/android/interoperability/cpp/bridge.md:41 +#: src/android/interoperability/cpp/bridge.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 " @@ -13926,7 +13866,7 @@ msgstr "" "function در Rust و ++C را ایجاد می‌کند تا آن موارد را در معرض هر دو زبان قرار " "دهد." -#: src/android/interoperability/cpp/bridge.md:44 +#: src/android/interoperability/cpp/bridge.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 " @@ -13938,28 +13878,28 @@ msgstr "" "نمونه‌ها از `cargo expand ::ffi` فقط برای گسترش ماژول `ffi` استفاده کنید " "(اگرچه این برای پروژه‌های Android کاربرد ندارد)." -#: src/android/interoperability/cpp/bridge.md:47 +#: 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:1 +#: src/android/interoperability/cpp/rust-bridge.md msgid "Rust Bridge Declarations" msgstr "تعریف پل در Rust" -#: src/android/interoperability/cpp/rust-bridge.md:7 +#: src/android/interoperability/cpp/rust-bridge.md msgid "// Opaque type\n" msgstr "// Opaque type\n" -#: src/android/interoperability/cpp/rust-bridge.md:8 +#: src/android/interoperability/cpp/rust-bridge.md msgid "// Method on `MyType`\n" msgstr "// Method on `MyType`\n" -#: src/android/interoperability/cpp/rust-bridge.md:9 +#: src/android/interoperability/cpp/rust-bridge.md #, fuzzy msgid "// Free function\n" msgstr "توابع" -#: src/android/interoperability/cpp/rust-bridge.md:28 +#: src/android/interoperability/cpp/rust-bridge.md msgid "" "Items declared in the `extern \"Rust\"` reference items that are in scope in " "the parent module." @@ -13967,7 +13907,7 @@ msgstr "" "موارد اعلام شده در موارد `extern \"Rust\"` reference که در محدوده ماژول " "والد قرار دارند." -#: src/android/interoperability/cpp/rust-bridge.md:30 +#: src/android/interoperability/cpp/rust-bridge.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 " @@ -13979,28 +13919,28 @@ msgstr "" "دارد که فایل منبع Rust حاوی پل دارای آن است، به جز استفاده از پسوند فایل rs." "h." -#: src/android/interoperability/cpp/generated-cpp.md:15 +#: src/android/interoperability/cpp/generated-cpp.md msgid "Results in (roughly) the following C++:" msgstr "نتیجه (تقریبی) ++C در زیر است:" -#: src/android/interoperability/cpp/cpp-bridge.md:1 +#: src/android/interoperability/cpp/cpp-bridge.md #, fuzzy msgid "C++ Bridge Declarations" msgstr "C++ Bridge Declarations" -#: src/android/interoperability/cpp/cpp-bridge.md:20 +#: src/android/interoperability/cpp/cpp-bridge.md msgid "Results in (roughly) the following Rust:" msgstr "نتیجه (تقریبی) Rust در زیر است:" -#: src/android/interoperability/cpp/cpp-bridge.md:30 +#: src/android/interoperability/cpp/cpp-bridge.md msgid "\"org$blobstore$cxxbridge1$new_blobstore_client\"" msgstr "\"org$blobstore$cxxbridge1$new_blobstore_client\"" -#: src/android/interoperability/cpp/cpp-bridge.md:39 +#: src/android/interoperability/cpp/cpp-bridge.md msgid "\"org$blobstore$cxxbridge1$BlobstoreClient$put\"" msgstr "\"org$blobstore$cxxbridge1$BlobstoreClient$put\"" -#: src/android/interoperability/cpp/cpp-bridge.md:56 +#: src/android/interoperability/cpp/cpp-bridge.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 " @@ -14010,7 +13950,7 @@ msgstr "" "ندارد. CXX اظهارات ثابتی را انجام می دهد که signatureها دقیقاً با آنچه در ++C " "اعلام شده مطابقت دارند." -#: src/android/interoperability/cpp/cpp-bridge.md:59 +#: src/android/interoperability/cpp/cpp-bridge.md msgid "" "`unsafe extern` blocks allow you to declare C++ functions that are safe to " "call from Rust." @@ -14018,15 +13958,15 @@ msgstr "" "بلوک‌های `unsafe extern` به شما امکان می‌دهند توابع ++C را که برای فراخوانی از " "Rust امن هستند را اعلام کنید." -#: src/android/interoperability/cpp/shared-types.md:9 +#: 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:23 +#: src/android/interoperability/cpp/shared-types.md msgid "Only C-like (unit) enums are supported." msgstr "فقط C-like (unit) enums پشتیبانی می‌شود." -#: src/android/interoperability/cpp/shared-types.md:24 +#: src/android/interoperability/cpp/shared-types.md 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 " @@ -14037,15 +13977,15 @@ msgstr "" "عملکرد مربوطه نیز برای کد ++C ایجاد می شود، به عنوان مثال. اگر `Hash` را " "استخراج کنید، پیاده‌سازی `std::hash` برای نوع ++C مربوطه نیز ایجاد می‌کند." -#: src/android/interoperability/cpp/shared-enums.md:15 +#: src/android/interoperability/cpp/shared-enums.md msgid "Generated Rust:" msgstr "Generated Rust:" -#: src/android/interoperability/cpp/shared-enums.md:33 +#: src/android/interoperability/cpp/shared-enums.md msgid "Generated C++:" msgstr "Generated C++:" -#: src/android/interoperability/cpp/shared-enums.md:46 +#: src/android/interoperability/cpp/shared-enums.md #, fuzzy msgid "" "On the Rust side, the code generated for shared enums is actually a struct " @@ -14058,22 +13998,22 @@ msgstr "" "متفاوت از همه انواع فهرست شده داشته باشد و نمایش‌دهنده Rust مورد نظر ما باید " "رفتار مشابهی داشته باشد." -#: src/android/interoperability/cpp/rust-result.md:13 +#: src/android/interoperability/cpp/rust-result.md msgid "\"fallible1 requires depth > 0\"" msgstr "\"fallible1 requires depth > 0\"" -#: src/android/interoperability/cpp/rust-result.md:16 +#: src/android/interoperability/cpp/rust-result.md msgid "\"Success!\"" msgstr "\"Success!\"" -#: src/android/interoperability/cpp/rust-result.md:22 +#: src/android/interoperability/cpp/rust-result.md msgid "" "Rust functions that return `Result` are translated to exceptions on the C++ " "side." msgstr "" "توابع Rust که «نتیجه» را برمی‌گردانند به exceptionهای سمت ++C ترجمه می‌شوند." -#: src/android/interoperability/cpp/rust-result.md:24 +#: src/android/interoperability/cpp/rust-result.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 " @@ -14083,22 +14023,22 @@ msgstr "" "اول راهی برای دریافت string پیام خطا نشان می‌دهد. پیغام خطا از نوع " "خطای`Display` می‌آید." -#: src/android/interoperability/cpp/rust-result.md:27 +#: src/android/interoperability/cpp/rust-result.md msgid "" "A panic unwinding from Rust to C++ will always cause the process to " "immediately terminate." msgstr "" "باز شدن panic از Rust به ++C همیشه باعث می‌شود که فرآیند بلافاصله خاتمه یابد." -#: src/android/interoperability/cpp/cpp-exception.md:7 +#: src/android/interoperability/cpp/cpp-exception.md msgid "\"example/include/example.h\"" msgstr "\"example/include/example.h\"" -#: src/android/interoperability/cpp/cpp-exception.md:14 +#: src/android/interoperability/cpp/cpp-exception.md msgid "\"Error: {}\"" msgstr "\"Error: {}\"" -#: src/android/interoperability/cpp/cpp-exception.md:22 +#: src/android/interoperability/cpp/cpp-exception.md #, fuzzy msgid "" "C++ functions declared to return a `Result` will catch any thrown exception " @@ -14108,7 +14048,7 @@ msgstr "" "سمت ++C را می‌گیرند و آن را به عنوان مقدار `Err` به تابع فراخوانی Rust " "برمی‌گردانند." -#: src/android/interoperability/cpp/cpp-exception.md:24 +#: src/android/interoperability/cpp/cpp-exception.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::" @@ -14120,63 +14060,63 @@ msgstr "" "فراخوانی می‌کند. این رفتار معادل همان exception است که از طریق یک `noexcept` " "C++ function فعال می‌شود." -#: src/android/interoperability/cpp/type-mapping.md:3 +#: src/android/interoperability/cpp/type-mapping.md msgid "C++ Type" msgstr "C++ Type" -#: src/android/interoperability/cpp/type-mapping.md:5 +#: src/android/interoperability/cpp/type-mapping.md msgid "`rust::String`" msgstr "`rust::String`" -#: src/android/interoperability/cpp/type-mapping.md:6 +#: src/android/interoperability/cpp/type-mapping.md msgid "`&str`" msgstr "`&str`" -#: src/android/interoperability/cpp/type-mapping.md:6 +#: src/android/interoperability/cpp/type-mapping.md msgid "`rust::Str`" msgstr "`rust::Str`" -#: src/android/interoperability/cpp/type-mapping.md:7 +#: src/android/interoperability/cpp/type-mapping.md msgid "`CxxString`" msgstr "`CxxString`" -#: src/android/interoperability/cpp/type-mapping.md:7 +#: src/android/interoperability/cpp/type-mapping.md msgid "`std::string`" msgstr "`std::string`" -#: src/android/interoperability/cpp/type-mapping.md:8 +#: src/android/interoperability/cpp/type-mapping.md msgid "`&[T]`/`&mut [T]`" msgstr "`&[T]`/`&mut [T]`" -#: src/android/interoperability/cpp/type-mapping.md:8 +#: src/android/interoperability/cpp/type-mapping.md msgid "`rust::Slice`" msgstr "`rust::Slice`" -#: src/android/interoperability/cpp/type-mapping.md:9 +#: src/android/interoperability/cpp/type-mapping.md msgid "`rust::Box`" msgstr "`rust::Box`" -#: src/android/interoperability/cpp/type-mapping.md:10 +#: src/android/interoperability/cpp/type-mapping.md msgid "`UniquePtr`" msgstr "`UniquePtr`" -#: src/android/interoperability/cpp/type-mapping.md:10 +#: src/android/interoperability/cpp/type-mapping.md msgid "`std::unique_ptr`" msgstr "`std::unique_ptr`" -#: src/android/interoperability/cpp/type-mapping.md:11 +#: src/android/interoperability/cpp/type-mapping.md msgid "`rust::Vec`" msgstr "`rust::Vec`" -#: src/android/interoperability/cpp/type-mapping.md:12 +#: src/android/interoperability/cpp/type-mapping.md msgid "`CxxVector`" msgstr "`CxxVector`" -#: src/android/interoperability/cpp/type-mapping.md:12 +#: src/android/interoperability/cpp/type-mapping.md msgid "`std::vector`" msgstr "`std::vector`" -#: src/android/interoperability/cpp/type-mapping.md:16 +#: 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." @@ -14184,7 +14124,7 @@ msgstr "" "این typeها را می‌توان در فیلدهای ساختارهای مشترک و آرگومان‌ها و extern " "functionها استفاده کرد." -#: src/android/interoperability/cpp/type-mapping.md:18 +#: src/android/interoperability/cpp/type-mapping.md msgid "" "Note that Rust's `String` does not map directly to `std::string`. There are " "a few reasons for this:" @@ -14192,13 +14132,13 @@ msgstr "" "توجه داشته باشید که `String` در Rust مستقیماً به `std::string` نگاشت نمی‌شود. " "چند دلیل برای این وجود دارد:" -#: src/android/interoperability/cpp/type-mapping.md:20 +#: src/android/interoperability/cpp/type-mapping.md msgid "" "`std::string` does not uphold the UTF-8 invariant that `String` requires." msgstr "" "‏`std::string` ثابت UTF-8 را که `String` به آن نیاز دارد را پشتیبانی نمی‌کند." -#: src/android/interoperability/cpp/type-mapping.md:21 +#: src/android/interoperability/cpp/type-mapping.md msgid "" "The two types have different layouts in memory and so can't be passed " "directly between languages." @@ -14206,7 +14146,7 @@ msgstr "" "این دو نوع طرح‌بندی‌های متفاوتی در حافظه دارند و بنابراین نمی‌توان آنها را " "مستقیماً بین زبان‌ها منتقل کرد." -#: src/android/interoperability/cpp/type-mapping.md:23 +#: src/android/interoperability/cpp/type-mapping.md #, fuzzy msgid "" "`std::string` requires move constructors that don't match Rust's move " @@ -14215,13 +14155,13 @@ msgstr "" "‏ `std::string` به سازنده‌های حرکتی نیاز دارد که با معنای حرکت Rust مطابقت " "ندارند، بنابراین `std::string` نمی‌تواند با مقدار به Rust منتقل شود." -#: src/android/interoperability/cpp/android-build-cpp.md:1 -#: src/android/interoperability/cpp/android-cpp-genrules.md:1 -#: src/android/interoperability/cpp/android-build-rust.md:1 +#: src/android/interoperability/cpp/android-build-cpp.md +#: src/android/interoperability/cpp/android-cpp-genrules.md +#: src/android/interoperability/cpp/android-build-rust.md msgid "Building in Android" msgstr "ساخت در اندروید" -#: src/android/interoperability/cpp/android-build-cpp.md:3 +#: src/android/interoperability/cpp/android-build-cpp.md msgid "" "Create a `cc_library_static` to build the C++ library, including the CXX " "generated header and source file." @@ -14229,30 +14169,30 @@ msgstr "" "یک `cc_library_static` برای ساخت کتابخانه ++C از جمله هدر و فایل منبع تولید " "شده CXX ایجاد کنید." -#: src/android/interoperability/cpp/android-build-cpp.md:8 -#: src/android/interoperability/cpp/android-build-rust.md:10 +#: 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/cpp/android-build-cpp.md:9 +#: src/android/interoperability/cpp/android-build-cpp.md msgid "\"cxx_test.cpp\"" msgstr "\"cxx_test.cpp\"" -#: src/android/interoperability/cpp/android-build-cpp.md:11 +#: src/android/interoperability/cpp/android-build-cpp.md msgid "\"cxx-bridge-header\"" msgstr "\"cxx-bridge-header\"" -#: src/android/interoperability/cpp/android-build-cpp.md:12 -#: src/android/interoperability/cpp/android-cpp-genrules.md:10 +#: 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:14 -#: src/android/interoperability/cpp/android-cpp-genrules.md:19 +#: 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:20 +#: src/android/interoperability/cpp/android-build-cpp.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 " @@ -14262,7 +14202,7 @@ msgstr "" "`libcxx_test_bridge_code` وابستگی‌هایی برای پیوندهای ++C تولید شده توسط CXX ​​" "هستند. نحوه تنظیم اینها را در اسلاید بعدی نشان خواهیم داد." -#: src/android/interoperability/cpp/android-build-cpp.md:23 +#: 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." @@ -14270,7 +14210,7 @@ msgstr "" "توجه داشته باشید که برای ایجاد تعاریف رایج CXX باید به کتابخانه `cxx-bridge-" "header` وابسته باشید." -#: src/android/interoperability/cpp/android-build-cpp.md:25 +#: 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/" @@ -14284,7 +14224,7 @@ msgstr "" "ممکن است بخواهید آن پیوند را با کلاس به اشتراک بگذارید تا دانش‌آموزان بدانند " "که در آینده می‌توانند این دستورالعمل‌ها را دوباره پیدا کنند." -#: src/android/interoperability/cpp/android-cpp-genrules.md:3 +#: 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`." @@ -14292,7 +14232,7 @@ msgstr "" "دو نوع ژانر ایجاد کنید: یکی برای تولید هدر CXX و دیگری برای تولید فایل منبع " "CXX. سپس از اینها به عنوان ورودی `cc_library_static` استفاده می‌شود." -#: src/android/interoperability/cpp/android-cpp-genrules.md:7 +#: src/android/interoperability/cpp/android-cpp-genrules.md #, fuzzy msgid "" "// Generate a C++ header containing the C++ bindings\n" @@ -14301,39 +14241,37 @@ msgstr "" "// Generate a C++ header containing the C++ bindings\n" "// to the Rust exported functions in lib.rs.\n" -#: src/android/interoperability/cpp/android-cpp-genrules.md:11 -#: src/android/interoperability/cpp/android-cpp-genrules.md:20 +#: src/android/interoperability/cpp/android-cpp-genrules.md msgid "\"cxxbridge\"" msgstr "\"cxxbridge\"" -#: src/android/interoperability/cpp/android-cpp-genrules.md:12 +#: src/android/interoperability/cpp/android-cpp-genrules.md msgid "\"$(location cxxbridge) $(in) --header > $(out)\"" msgstr "\"$(location cxxbridge) $(in) --header > $(out)\"" -#: src/android/interoperability/cpp/android-cpp-genrules.md:13 -#: src/android/interoperability/cpp/android-cpp-genrules.md:22 -#: src/android/interoperability/cpp/android-build-rust.md:8 +#: 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/cpp/android-cpp-genrules.md:14 +#: src/android/interoperability/cpp/android-cpp-genrules.md msgid "\"lib.rs.h\"" msgstr "\"lib.rs.h\"" -#: src/android/interoperability/cpp/android-cpp-genrules.md:16 +#: src/android/interoperability/cpp/android-cpp-genrules.md #, fuzzy msgid "// Generate the C++ code that Rust calls into.\n" msgstr "// Generate the C++ code that Rust calls into.\n" -#: src/android/interoperability/cpp/android-cpp-genrules.md:21 +#: 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:23 +#: src/android/interoperability/cpp/android-cpp-genrules.md msgid "\"lib.rs.cc\"" msgstr "\"lib.rs.cc\"" -#: src/android/interoperability/cpp/android-cpp-genrules.md:29 +#: 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." @@ -14341,7 +14279,7 @@ msgstr "" "ابزار`cxxbridge` یک ابزار مستقل است که سمت ++C ماژول پل را تولید می‌کند. در " "Android گنجانده شده و به عنوان ابزار Soong در دسترس است." -#: src/android/interoperability/cpp/android-cpp-genrules.md:31 +#: src/android/interoperability/cpp/android-cpp-genrules.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 " @@ -14351,26 +14289,26 @@ msgstr "" "h` و فایل منبع شما `lib.rs.cc` نام خواهد داشت. اگرچه این قرارداد نامگذاری " "اجرا نمی‌شود." -#: src/android/interoperability/cpp/android-build-rust.md:3 +#: src/android/interoperability/cpp/android-build-rust.md msgid "" "Create a `rust_binary` that depends on `libcxx` and your `cc_library_static`." msgstr "" "یک`rust_binary` ایجاد کنید که به `libcxx` و `cc_library_static` شما بستگی " "دارد." -#: src/android/interoperability/cpp/android-build-rust.md:7 +#: src/android/interoperability/cpp/android-build-rust.md msgid "\"cxx_test\"" msgstr "\"cxx_test\"" -#: src/android/interoperability/cpp/android-build-rust.md:9 +#: src/android/interoperability/cpp/android-build-rust.md msgid "\"libcxx\"" msgstr "\"libcxx\"" -#: src/android/interoperability/java.md:1 +#: src/android/interoperability/java.md msgid "Interoperability with Java" msgstr "قابلیت همکاری با جاوا" -#: src/android/interoperability/java.md:3 +#: 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/" @@ -14381,72 +14319,69 @@ msgstr "" "بارگیری کند. [`jni` crate](https://docs.rs/jni/) به شما امکان می دهد یک " "کتابخانه سازگار ایجاد کنید." -#: src/android/interoperability/java.md:8 +#: src/android/interoperability/java.md msgid "First, we create a Rust function to export to Java:" msgstr "ابتدا یک تابع Rust برای export به Java ایجاد می‌کنیم:" -#: src/android/interoperability/java.md:10 +#: src/android/interoperability/java.md msgid "_interoperability/java/src/lib.rs_:" msgstr "_interoperability/java/src/lib.rs_:" -#: src/android/interoperability/java.md:13 +#: src/android/interoperability/java.md #, fuzzy msgid "//! Rust <-> Java FFI demo.\n" msgstr "//! Rust <-> Java FFI demo.\n" -#: src/android/interoperability/java.md:18 +#: src/android/interoperability/java.md #, fuzzy msgid "/// HelloWorld::hello method implementation.\n" msgstr "/// HelloWorld::hello method implementation.\n" -#: src/android/interoperability/java.md:21 +#: src/android/interoperability/java.md msgid "\"system\"" msgstr "\"system\"" -#: src/android/interoperability/java.md:27 +#: src/android/interoperability/java.md msgid "\"Hello, {input}!\"" msgstr "\"Hello, {input}!\"" -#: src/android/interoperability/java.md:33 -#: src/android/interoperability/java.md:63 +#: src/android/interoperability/java.md msgid "_interoperability/java/Android.bp_:" msgstr "_interoperability/java/Android.bp_:" -#: src/android/interoperability/java.md:37 -#: src/android/interoperability/java.md:70 +#: src/android/interoperability/java.md msgid "\"libhello_jni\"" msgstr "\"libhello_jni\"" -#: src/android/interoperability/java.md:38 -#: src/android/interoperability/java.md:53 +#: src/android/interoperability/java.md msgid "\"hello_jni\"" msgstr "\"hello_jni\"" -#: src/android/interoperability/java.md:40 +#: src/android/interoperability/java.md msgid "\"libjni\"" msgstr "\"libjni\"" -#: src/android/interoperability/java.md:44 +#: src/android/interoperability/java.md msgid "We then call this function from Java:" msgstr "سپس این تابع را از جاوا فراخوانی می کنیم:" -#: src/android/interoperability/java.md:46 +#: src/android/interoperability/java.md msgid "_interoperability/java/HelloWorld.java_:" msgstr "_interoperability/java/HelloWorld.java_:" -#: src/android/interoperability/java.md:67 +#: src/android/interoperability/java.md msgid "\"helloworld_jni\"" msgstr "\"helloworld_jni\"" -#: src/android/interoperability/java.md:68 +#: src/android/interoperability/java.md msgid "\"HelloWorld.java\"" msgstr "سلام دنیا\"HelloWorld.java\"" -#: src/android/interoperability/java.md:69 +#: src/android/interoperability/java.md msgid "\"HelloWorld\"" msgstr "\"HelloWorld\"" -#: src/android/interoperability/java.md:74 +#: src/android/interoperability/java.md msgid "Finally, you can build, sync, and run the binary:" msgstr "در نهایت، می‌توانید باینری را بسازید، همگام‌سازی کنید و اجرا کنید:" @@ -15033,11 +14968,11 @@ msgstr "" "این الگو از CXX interop، ویژگی‌های Rust و تست‌های واحد پشتیبانی می‌کند که بعداً " "از برخی از آنها استفاده خواهیم کرد." -#: src/chromium/build-rules/unsafe.md:1 +#: src/chromium/build-rules/unsafe.md msgid "Including `unsafe` Rust Code" msgstr "شامل کد `unsafe` Rust." -#: src/chromium/build-rules/unsafe.md:3 +#: src/chromium/build-rules/unsafe.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 " @@ -15049,7 +14984,7 @@ msgstr "" "به هدف gn اضافه کنید. (بعداً در دوره ما شرایطی را خواهیم دید که در آن لازم " "است.)" -#: src/chromium/build-rules/unsafe.md:7 +#: src/chromium/build-rules/unsafe.md msgid "" "```gn\n" "import(\"//build/rust/rust_static_library.gni\")\n" @@ -15077,11 +15012,11 @@ msgstr "" "}\n" "```" -#: src/chromium/build-rules/depending.md:3 +#: src/chromium/build-rules/depending.md msgid "Simply add the above target to the `deps` of some Chromium C++ target." msgstr "به سادگی هدف بالا را به `deps` برخی از اهداف Chromium C++ اضافه کنید." -#: src/chromium/build-rules/depending.md:5 +#: src/chromium/build-rules/depending.md msgid "" "```gn\n" "import(\"//build/rust/rust_static_library.gni\")\n" @@ -15111,7 +15046,7 @@ msgstr "" "}\n" "```" -#: src/chromium/build-rules/vscode.md:3 +#: src/chromium/build-rules/vscode.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," @@ -15120,7 +15055,7 @@ msgstr "" "باشد. کد ویژوال استودیو برای Rust در Chromium به خوبی کار می کند و برای " "استفاده از آن،" -#: src/chromium/build-rules/vscode.md:6 +#: src/chromium/build-rules/vscode.md #, fuzzy msgid "" "Ensure your VSCode has the `rust-analyzer` extension, not earlier forms of " @@ -15129,7 +15064,7 @@ msgstr "" "اطمینان حاصل کنید که VSCode شما دارای پسوند `rust-analyzer` است، نه فرم‌های " "قبلی پشتیبانی از Rust" -#: src/chromium/build-rules/vscode.md:8 +#: src/chromium/build-rules/vscode.md msgid "" "`gn gen out/Debug --export-rust-project` (or equivalent for your output " "directory)" @@ -15137,11 +15072,11 @@ msgstr "" "‏ `gn gen out/Debug --export-rust-project` (یا معادل آن برای دایرکتوری خروجی " "شما)" -#: src/chromium/build-rules/vscode.md:10 +#: 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:16 +#: 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." @@ -15149,7 +15084,7 @@ msgstr "" "اگر مخاطب به طور طبیعی نسبت به IDE‌ها علاقه نداشته باشد، نمایش برخی از " "ویژگی‌های code annotation و کاوش در rust-analyzer می‌تواند مفید باشد." -#: src/chromium/build-rules/vscode.md:19 +#: 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):" @@ -15157,12 +15092,12 @@ msgstr "" "مراحل زیر ممکن است به نسخه نمایشی کمک کند (اما در عوض از یک قطعه Rust مربوط " "به Chromium که بیشتر با آن آشنا هستید استفاده کنید):" -#: src/chromium/build-rules/vscode.md:22 +#: 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/build-rules/vscode.md:23 +#: src/chromium/build-rules/vscode.md msgid "" "Place the cursor over the `QrCode::new` call (around line 26) in " "\\`qr_code_generator_ffi_glue.rs" @@ -15170,7 +15105,7 @@ msgstr "" "مکان نما را روی فراخوانی `QrCode::new` (حدود خط 26) در " "\\`qr_code_generator_ffi_glue.rs قرار دهید" -#: src/chromium/build-rules/vscode.md:25 +#: src/chromium/build-rules/vscode.md msgid "" "Demo **show documentation** (typical bindings: vscode = ctrl k i; vim/CoC = " "K)." @@ -15178,7 +15113,7 @@ msgstr "" "نسخه‌ی نمایشی **نمایش مستندات ** (typical bindings: vscode = ctrl k i; vim/" "CoC = K)." -#: src/chromium/build-rules/vscode.md:27 +#: src/chromium/build-rules/vscode.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`.)" @@ -15187,7 +15122,7 @@ msgstr "" "vim/CoC = g d). (این شما را به `//third_party/rust/.../qr_code-.../src/lib." "rs` می‌رساند.)" -#: src/chromium/build-rules/vscode.md:29 +#: src/chromium/build-rules/vscode.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 " @@ -15197,7 +15132,7 @@ msgstr "" "خط 164؛ طرح کلی در پنجره file explorer در vscode است؛ typical vim/CoC " "bindings = space o)" -#: src/chromium/build-rules/vscode.md:32 +#: src/chromium/build-rules/vscode.md msgid "" "Demo **type annotations** (there are quite a few nice examples in the " "`QrCode::with_bits` method)" @@ -15205,7 +15140,7 @@ msgstr "" "نسخه‌ی نمایشی **type annotations** (مثال های بسیار خوبی در متد `QrCode::" "with_bits` وجود دارد)" -#: src/chromium/build-rules/vscode.md:35 +#: 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 " @@ -15215,11 +15150,11 @@ msgstr "" "فایل‌های `BUILD.gn` (که در طول تمرین‌های این جلسه چند بار انجام می‌دهیم) دوباره " "اجرا شود." -#: src/exercises/chromium/build-rules.md:1 +#: src/exercises/chromium/build-rules.md msgid "Build rules exercise" msgstr "تمرین قواعد ساخت" -#: src/exercises/chromium/build-rules.md:3 +#: src/exercises/chromium/build-rules.md msgid "" "In your Chromium build, add a new Rust target to `//ui/base/BUILD.gn` " "containing:" @@ -15227,7 +15162,7 @@ msgstr "" "در ساخت Chromium خود، یک Rust target جدید به `//ui/base/BUILD.gn` اضافه کنید " "که حاوی:" -#: src/exercises/chromium/build-rules.md:13 +#: src/exercises/chromium/build-rules.md msgid "" "**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` " @@ -15237,7 +15172,7 @@ msgstr "" "ناامنی (type of unsafety) در نظر گرفته می‌شود، بنابراین باید کد unsafe را در " "`gn` target خود مجاز کنید." -#: src/exercises/chromium/build-rules.md:16 +#: 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 " @@ -15247,7 +15182,7 @@ msgstr "" "تابع را در بالای `ui/base/resource/resource_bundle.cc` اعلام کنید (بعداً " "خواهیم دید که چگونه می‌توان این کار را با ابزارهای تولید bindings خودکار کرد):" -#: src/exercises/chromium/build-rules.md:24 +#: src/exercises/chromium/build-rules.md msgid "" "Call this function from somewhere in `ui/base/resource/resource_bundle.cc` - " "we suggest the top of `ResourceBundle::MaybeMangleLocalizedString`. Build " @@ -15259,7 +15194,7 @@ msgstr "" "می‌کنیم. Chromium را Build و اجرا کنید و مطمئن شوید که \"Hello from Rust!\" " "بارها چاپ می‌شود." -#: src/exercises/chromium/build-rules.md:28 +#: src/exercises/chromium/build-rules.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-" @@ -15269,12 +15204,12 @@ msgstr "" "کار کند. این کار در تمرین‌های بعدی مفید خواهد بود. اگر موفق شده‌اید، می‌توانید " "از کلیک راست روی\"Go to definition\" در`println!` استفاده کنید." -#: src/exercises/chromium/build-rules.md:32 -#: src/exercises/chromium/interoperability-with-cpp.md:48 +#: src/exercises/chromium/build-rules.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "Where to find help" msgstr "کجا می‌توان help پیدا کرد" -#: src/exercises/chromium/build-rules.md:34 +#: src/exercises/chromium/build-rules.md msgid "" "The options available to the [`rust_static_library` gn template](https://" "source.chromium.org/chromium/chromium/src/+/main:build/rust/" @@ -15284,7 +15219,7 @@ msgstr "" "chromium.org/chromium/chromium/src/+/main:build/rust/rust_static_library.gni;" "l=16)" -#: src/exercises/chromium/build-rules.md:35 +#: src/exercises/chromium/build-rules.md msgid "" "Information about [`#[no_mangle]`](https://doc.rust-lang.org/beta/reference/" "abi.html#the-no_mangle-attribute)" @@ -15292,7 +15227,7 @@ msgstr "" "اطلاعات درباره [`#[no_mangle]`](https://doc.rust-lang.org/beta/reference/abi." "html#the-no_mangle-attribute)" -#: src/exercises/chromium/build-rules.md:36 +#: src/exercises/chromium/build-rules.md msgid "" "Information about [`extern \"C\"`](https://doc.rust-lang.org/std/keyword." "extern.html)" @@ -15300,7 +15235,7 @@ msgstr "" "اطلاعات درباره [`extern \"C\"`](https://doc.rust-lang.org/std/keyword.extern." "html)" -#: src/exercises/chromium/build-rules.md:37 +#: src/exercises/chromium/build-rules.md #, fuzzy msgid "" "Information about gn's [`--export-rust-project`](https://gn.googlesource.com/" @@ -15309,7 +15244,7 @@ msgstr "" "اطلاعاتی درباره gnهای [`--export-rust-project`](https://gn.googlesource.com/" "gn/+/main/docs/reference.md#compilation-database) سوییچ." -#: src/exercises/chromium/build-rules.md:38 +#: src/exercises/chromium/build-rules.md #, fuzzy msgid "" "[How to install rust-analyzer in VSCode](https://code.visualstudio.com/docs/" @@ -15318,7 +15253,7 @@ msgstr "" "[How to install rust-analyzer in VSCode](https://code.visualstudio.com/docs/" "languages/rust)" -#: src/exercises/chromium/build-rules.md:44 +#: src/exercises/chromium/build-rules.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 " @@ -15328,7 +15263,7 @@ msgstr "" "این مثال غیرعادی است زیرا به زبان متقابل با کمترین مخرج مشترک، C خلاصه " "می‌شود. بعداً در دوره، ++C آن را مستقیماً به Rust وصل خواهیم کرد." -#: src/exercises/chromium/build-rules.md:48 +#: src/exercises/chromium/build-rules.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 " @@ -15338,7 +15273,7 @@ msgstr "" "به Rust اجازه دهد دو تابع با نام یکسان تولید کند و Rust دیگر نمی‌تواند تضمین " "کند که تابع مورد نظر فراخوانی شده است." -#: src/exercises/chromium/build-rules.md:52 +#: 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." @@ -15443,7 +15378,7 @@ msgstr "" "چنین عملکردی ممکن است از آزمایش های جداگانه‌ای که در Rust نوشته شده است " "بهره‌مند شود." -#: src/chromium/testing/rust-gtest-interop.md:3 +#: src/chromium/testing/rust-gtest-interop.md msgid "" "The [`rust_gtest_interop`](https://chromium.googlesource.com/chromium/src/+/" "main/testing/rust_gtest_interop/README.md) library provides a way to:" @@ -15451,7 +15386,7 @@ msgstr "" "کتابخانه [`rust_gtest_interop`](https://chromium.googlesource.com/chromium/" "src/+/main/testing/rust_gtest_interop/README.md) راهی را ارائه می‌دهد:" -#: src/chromium/testing/rust-gtest-interop.md:5 +#: src/chromium/testing/rust-gtest-interop.md msgid "" "Use a Rust function as a `gtest` testcase (using the `#[gtest(...)]` " "attribute)" @@ -15459,7 +15394,7 @@ msgstr "" "از یک تابع Rust به عنوان یک تست `gtest` استفاده کنید (با استفاده از " "`#[gtest(...)]` attribute)" -#: src/chromium/testing/rust-gtest-interop.md:7 +#: 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)." @@ -15467,11 +15402,11 @@ msgstr "" "از `expect_eq!` و ماکروهای مشابه (شبیه به `assert_eq!` استفاده کنید، اما " "وقتی assertion ناموفق بود، panic نکنید و تست را خاتمه ندهید)." -#: src/chromium/testing/rust-gtest-interop.md:10 +#: src/chromium/testing/rust-gtest-interop.md msgid "Example:" msgstr "مثال:" -#: src/chromium/testing/build-gn.md:3 +#: src/chromium/testing/build-gn.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:" @@ -15479,7 +15414,7 @@ msgstr "" "ساده‌ترین راه برای build Rust `gtest` اضافه‌کردن آن‌ها به یک باینری تست موجود " "است که از قبل حاوی تست‌هایی است که در ++C نوشته شده‌اند. به عنوان مثال:" -#: src/chromium/testing/build-gn.md:6 +#: src/chromium/testing/build-gn.md msgid "" "```gn\n" "test(\"ui_base_unittests\") {\n" @@ -15497,7 +15432,7 @@ msgstr "" "}\n" "```" -#: src/chromium/testing/build-gn.md:14 +#: 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:" @@ -15505,7 +15440,7 @@ msgstr "" "نگارش تست‌های Rust در یک `static_library` جداگانه نیز کار می‌کند، اما نیاز به " "اعلام دستی وابستگی به کتابخانه‌های پشتیبانی دارد:" -#: src/chromium/testing/build-gn.md:17 +#: src/chromium/testing/build-gn.md msgid "" "```gn\n" "rust_static_library(\"my_rust_lib_unittests\") {\n" @@ -15543,7 +15478,7 @@ msgstr "" "}\n" "```" -#: src/chromium/testing/chromium-import-macro.md:3 +#: src/chromium/testing/chromium-import-macro.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 " @@ -15559,15 +15494,15 @@ msgstr "" "از ماکرو `chromium::import!` از `chromium` crate که به‌طور خودکار وارد می‌شود، " "درنتیجه از کار با چنین نامی پرهیز کنیم:" -#: src/chromium/testing/chromium-import-macro.md:12 +#: src/chromium/testing/chromium-import-macro.md msgid "\"//ui/base:my_rust_lib\"" msgstr "\"//ui/base:my_rust_lib\"" -#: src/chromium/testing/chromium-import-macro.md:18 +#: src/chromium/testing/chromium-import-macro.md msgid "Under the covers the macro expands to something similar to:" msgstr "در زیر جلدها، ماکرو به چیزی شبیه به زیر گسترش می یابد:" -#: src/chromium/testing/chromium-import-macro.md:26 +#: src/chromium/testing/chromium-import-macro.md msgid "" "More information can be found in [the doc comment](https://source.chromium." "org/chromium/chromium/src/+/main:build/rust/chromium_prelude/" @@ -15580,7 +15515,7 @@ msgstr "" "third_party&ss=chromium%2Fchromium%2Fsrc) پیدا کنید. ماکرو مربوطه `chromium::" "import`." -#: src/chromium/testing/chromium-import-macro.md:31 +#: src/chromium/testing/chromium-import-macro.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 " @@ -15594,19 +15529,19 @@ msgstr "" "تضمین می‌کند، بنابراین اهداف`cargo_crate` GN (تولید شده توسط ابزار `gnrt` که " "در بخش بعدی پوشش داده شده است) از نام‌های crate کوتاه استفاده می‌کنند." -#: src/exercises/chromium/testing.md:1 +#: src/exercises/chromium/testing.md msgid "Testing exercise" msgstr "تمرین تستی" -#: src/exercises/chromium/testing.md:3 +#: src/exercises/chromium/testing.md msgid "Time for another exercise!" msgstr "وقت یک تمرین دیگر است!" -#: src/exercises/chromium/testing.md:5 +#: src/exercises/chromium/testing.md msgid "In your Chromium build:" msgstr "درChromium build شما باید:" -#: src/exercises/chromium/testing.md:7 +#: 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, " @@ -15616,15 +15551,15 @@ msgstr "" "کردن دو عدد صحیح دریافت شده به عنوان آرگومان، محاسبه عدد فیبوناچی nام، جمع " "اعداد صحیح در یک برش و غیره." -#: src/exercises/chromium/testing.md:10 +#: src/exercises/chromium/testing.md msgid "Add a separate `..._unittest.rs` file with a test for the new function." msgstr "یک فایل`..._unittest.rs` جداگانه با یک تست برای تابع جدید اضافه کنید." -#: src/exercises/chromium/testing.md:11 +#: src/exercises/chromium/testing.md msgid "Add the new tests to `BUILD.gn`." msgstr "تست‌های جدید را به `BUILD.gn` اضافه کنید." -#: src/exercises/chromium/testing.md:12 +#: src/exercises/chromium/testing.md msgid "Build the tests, run them, and verify that the new test works." msgstr "" "تست‌ها را بسازید، اجرا کنید و بررسی کنید که آيا تست جدید به درستی کار می‌کند." @@ -15735,7 +15670,7 @@ msgstr "" "Rust string را از ورودی غیر UTF8 و `rust::String::c_str` بسازد و می‌تواند یک " "string را با NUL خاتمه دهد)." -#: src/chromium/interoperability-with-cpp/example-bindings.md:3 +#: 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." @@ -15743,19 +15678,19 @@ msgstr "" "‏ CXX مستلزم آن است که کل مرز C++/Rust در ماژول‌های `cxx::bridge` در کد منبع `." "rs` اعلام شود." -#: src/chromium/interoperability-with-cpp/example-bindings.md:16 +#: 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:24 +#: src/chromium/interoperability-with-cpp/example-bindings.md msgid "// Definitions of Rust types and functions go here\n" msgstr "// Definitions of Rust types and functions go here\n" -#: src/chromium/interoperability-with-cpp/example-bindings.md:30 +#: src/chromium/interoperability-with-cpp/example-bindings.md msgid "Point out:" msgstr "اشاره کنید:" -#: src/chromium/interoperability-with-cpp/example-bindings.md:32 +#: 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 " @@ -15766,23 +15701,23 @@ msgstr "" "bridge]` کارهای پیچیده‌ای برای آن انجام می‌دهد و کد تولید شده کمی پیچیده تر " "است - اگرچه این کار همچنان منجر به یک `mod` به نام `ffi` در کد شما می شود." -#: src/chromium/interoperability-with-cpp/example-bindings.md:36 +#: src/chromium/interoperability-with-cpp/example-bindings.md msgid "Native support for C++'s `std::unique_ptr` in Rust" msgstr "پشتیبانی Native در ++C برای`std::unique_ptr`در Rust" -#: src/chromium/interoperability-with-cpp/example-bindings.md:37 +#: src/chromium/interoperability-with-cpp/example-bindings.md msgid "Native support for Rust slices in C++" msgstr "پشتیبانی Native برای Rust Slices در ++C" -#: src/chromium/interoperability-with-cpp/example-bindings.md:38 +#: 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/interoperability-with-cpp/example-bindings.md:39 +#: 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/interoperability-with-cpp/example-bindings.md:41 +#: 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 " @@ -15793,7 +15728,7 @@ msgstr "" "گمراه کننده است. این هِدِر هرگز توسط Rust تفسیر نمی‌شود، بلکه به سادگی " "`#include` در کد ++C تولید‌شده برای کامپایلرهای ++C است." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md:3 +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" "By far the most useful page when using CXX is the [type reference](https://" "cxx.rs/bindings.html)." @@ -15801,11 +15736,11 @@ msgstr "" "تا حد زیادی مفیدترین صفحه هنگام استفاده از CXX برابر [type reference]" "(https://cxx.rs/bindings.html) است." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md:5 +#: 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:7 +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" "Your Rust-C++ interface is sufficiently simple that you can declare all of " "it." @@ -15813,7 +15748,7 @@ msgstr "" "اینترفیس ++Rust-C شما به اندازه کافی ساده است که می‌توانید همه آن را اعلام یا " "declare کنید." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md:8 +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" "You're using only the types natively supported by CXX already, for example " "`std::unique_ptr`, `std::string`, `&[u8]` etc." @@ -15821,7 +15756,7 @@ msgstr "" "شما فقط از تایپ‌هایی استفاده می‌کنید که قبلاً توسط CXX ​​پشتیبانی می‌شوند، برای " "مثال`std::unique_ptr`, `std::string`, `&[u8]` و غیره." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md:11 +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" "It has many limitations --- for example lack of support for Rust's `Option` " "type." @@ -15829,7 +15764,7 @@ msgstr "" "این مورد محدودیت‌های زیادی دارد --- برای مثال عدم پشتیبانی از تایپ 'Option' " "Rust." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md:14 +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.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 " @@ -15843,22 +15778,22 @@ msgstr "" "که پیش نویس پیوندهای CXX برای مرز زبان (language boundary) را پیش‌نویس کنید " "تا ببینید آیا به اندازه کافی ساده به نظر می رسد یا خیر." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md:26 +#: 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/interoperability-with-cpp/limitations-of-cxx.md:28 +#: 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++ exception است (در اسلاید بعدی ارائه شده است)" -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md:29 +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "Function pointers are awkward to use." msgstr "استفاده ازFunction pointerها دشوار است." -#: src/chromium/interoperability-with-cpp/error-handling.md:3 +#: src/chromium/interoperability-with-cpp/error-handling.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:" @@ -15867,11 +15802,11 @@ msgstr "" "+ exception متکی است، بنابراین نمی‌توانیم از آن در Chromium استفاده کنیم. " "جایگزین‌های آن عبارتند از:" -#: src/chromium/interoperability-with-cpp/error-handling.md:6 +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "The `T` part of `Result` can be:" msgstr "قسمت `T` از `نتیجه` می تواند باشد:" -#: src/chromium/interoperability-with-cpp/error-handling.md:7 +#: src/chromium/interoperability-with-cpp/error-handling.md #, fuzzy msgid "" "Returned via out parameters (e.g. via `&mut T`). This requires that `T` can " @@ -15881,11 +15816,11 @@ msgstr "" "این مستلزم آن است که `T` بتواند از مرز FFI عبور کند - برای مثال `T` باید " "باشد:" -#: src/chromium/interoperability-with-cpp/error-handling.md:9 +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "A primitive type (like `u32` or `usize`)" msgstr "یک type اولیه (مانند `u32` یا `usize`)" -#: src/chromium/interoperability-with-cpp/error-handling.md:10 +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "" "A type natively supported by `cxx` (like `UniquePtr`) that has a suitable " "default value to use in a failure case (_unlike_ `Box`)." @@ -15894,7 +15829,7 @@ msgstr "" "دارای یک مقدار پیش‌فرض مناسب برای استفاده در موارد خرابی است (_unlike_ " "`Box`)." -#: src/chromium/interoperability-with-cpp/error-handling.md:12 +#: src/chromium/interoperability-with-cpp/error-handling.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 " @@ -15904,11 +15839,11 @@ msgstr "" "است زمانی مورد نیاز باشد که `T` یک تایپ Rust است که نمی‌تواند از مرز FFI عبور " "کند و نمی تواند در `UniquePtr` ذخیره شود." -#: src/chromium/interoperability-with-cpp/error-handling.md:16 +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "The `E` part of `Result` can be:" msgstr "قسمت `E` از `Result` می‌تواند باشد:" -#: src/chromium/interoperability-with-cpp/error-handling.md:17 +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "" "Returned as a boolean (e.g. `true` representing success, and `false` " "representing failure)" @@ -15916,7 +15851,7 @@ msgstr "" "به‌عنوان یک boolean برگردانده می‌شود (مثلاً `true` نشان‌دهنده موفقیت و `false` " "نشان‌دهنده یک شکست است)" -#: src/chromium/interoperability-with-cpp/error-handling.md:19 +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "" "Preserving error details is in theory possible, but so far hasn't been " "needed in practice." @@ -15924,11 +15859,11 @@ msgstr "" "حفظ جزئیات خطا در تئوری امکان پذیر است، اما تاکنون در عمل مورد نیاز نبوده " "است." -#: src/chromium/interoperability-with-cpp/error-handling-qr.md:1 +#: src/chromium/interoperability-with-cpp/error-handling-qr.md msgid "CXX Error Handling: QR Example" msgstr "مدیریت خطا CXX: مثال QR" -#: src/chromium/interoperability-with-cpp/error-handling-qr.md:3 +#: src/chromium/interoperability-with-cpp/error-handling-qr.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." @@ -15941,11 +15876,11 @@ msgstr "" "drc=7bf1b75b9101ca2013) است که در آن بولی برای ارتباط موفقیت در مق‌بل شکست و " "جایی که نتیجه موفقیت آمیز را می‌توان از مرز FFI عبور داد استفاده می شود:" -#: src/chromium/interoperability-with-cpp/error-handling-qr.md:8 +#: 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:23 +#: src/chromium/interoperability-with-cpp/error-handling-qr.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 " @@ -15956,7 +15891,7 @@ msgstr "" "اندازه بردار نیست بلکه اندازه کد QR است (و مسلماً کمی اضافی است - درواقع این " "جذر اندازه بردار است)." -#: src/chromium/interoperability-with-cpp/error-handling-qr.md:27 +#: src/chromium/interoperability-with-cpp/error-handling-qr.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 " @@ -15968,7 +15903,7 @@ msgstr "" "منجر به رفتار نامشخص می‌شود (برخلاف ++C، زمانی که تنها عمل عدم ارجاع چنین " "حافظه‌ای منجر به UB می‌شود)." -#: src/chromium/interoperability-with-cpp/error-handling-qr.md:32 +#: src/chromium/interoperability-with-cpp/error-handling-qr.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 " @@ -15979,11 +15914,11 @@ msgstr "" "نمی‌توان مانند داده‌های Rust جابه‌جا کرد، زیرا ممکن است حاوی نشانگرهای " "خودارجاعی (self-referential pointers) باشد." -#: src/chromium/interoperability-with-cpp/error-handling-png.md:1 +#: src/chromium/interoperability-with-cpp/error-handling-png.md msgid "CXX Error Handling: PNG Example" msgstr "مدیریت خطا CXX: مثال PNG" -#: src/chromium/interoperability-with-cpp/error-handling-png.md:3 +#: src/chromium/interoperability-with-cpp/error-handling-png.md msgid "" "A prototype of a PNG decoder illustrates what can be done when the " "successful result cannot be passed across the FFI boundary:" @@ -15991,11 +15926,11 @@ msgstr "" "نمونه اولیه PNG decoder نشان می‌دهد که وقتی نتیجه موفقیت آمیز نمی‌تواند از مرز " "FFI عبور کند و چه کاری می توان انجام داد:" -#: src/chromium/interoperability-with-cpp/error-handling-png.md:7 +#: 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:10 +#: src/chromium/interoperability-with-cpp/error-handling-png.md msgid "" "/// This returns an FFI-friendly equivalent of `Result,\n" " /// ()>`.\n" @@ -16003,15 +15938,15 @@ msgstr "" "/// This returns an FFI-friendly equivalent of `Result,\n" " /// ()>`.\n" -#: src/chromium/interoperability-with-cpp/error-handling-png.md:14 +#: src/chromium/interoperability-with-cpp/error-handling-png.md msgid "/// C++ bindings for the `crate::png::ResultOfPngReader` type.\n" msgstr "/// C++ bindings for the `crate::png::ResultOfPngReader` type.\n" -#: src/chromium/interoperability-with-cpp/error-handling-png.md:21 +#: src/chromium/interoperability-with-cpp/error-handling-png.md msgid "/// C++ bindings for the `crate::png::PngReader` type.\n" msgstr "/// C++ bindings for the `crate::png::PngReader` type.\n" -#: src/chromium/interoperability-with-cpp/error-handling-png.md:32 +#: src/chromium/interoperability-with-cpp/error-handling-png.md msgid "" "`PngReader` and `ResultOfPngReader` are Rust types --- objects of these " "types cannot cross the FFI boundary without indirection of a `Box`. We " @@ -16023,7 +15958,7 @@ msgstr "" "نمی‌توانیم `out_parameter: &mut PngReader` داشته باشیم، زیرا CXX به ++C اجازه " "نمی‌دهد Rust object ها را براساس مقدار ذخیره کند." -#: src/chromium/interoperability-with-cpp/error-handling-png.md:37 +#: src/chromium/interoperability-with-cpp/error-handling-png.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 " @@ -16039,11 +15974,11 @@ msgstr "" "مناسب `Result` (به عنوان مثال به «is_err»، «unwrap» و/یا «as_mut» " "ارسال می‌شود." -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md:1 +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md msgid "Using cxx in Chromium" msgstr "استفاده از cxx در Chromium" -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md:3 +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md 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 " @@ -16053,7 +15988,7 @@ msgstr "" "Rust استفاده کنیم را تعریف می‌کنیم. شما معمولاً برای هر `rust_static_library` " "یکی دارید. پس فقط اضافه کنید." -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md:7 +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md msgid "" "```gn\n" "cxx_bindings = [ \"my_rust_file.rs\" ]\n" @@ -16067,21 +16002,21 @@ msgstr "" "allow_unsafe = true\n" "```" -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md:13 +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md msgid "" "to your existing `rust_static_library` target alongside `crate_root` and " "`sources`." msgstr "به هدف `rust_static_library` موجود در کنار `crate_root` و `sources`." -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md:16 +#: 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 "‏ headerهای ++C در یک مکان منطقی تولید می‌شوند، بنابراین شما می‌توانید." -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md:19 +#: 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/chromium/interoperability-with-cpp/using-cxx-in-chromium.md:22 +#: 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://" @@ -16093,12 +16028,12 @@ msgstr "" "source.chromium.org/chromium/chromium/src /+/main:base/containers/span_rust." "h;l=21)." -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md:27 +#: 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/chromium/interoperability-with-cpp/using-cxx-in-chromium.md:29 +#: 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 " @@ -16116,7 +16051,7 @@ msgstr "" "the-cxx-debate) است، اما به طور دقیق، آوردن هر کد خارجی به یک باینری Rust " "می‌تواند باعث رفتار غیرمنتظره از دیدگاه Rust شود." -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md:36 +#: 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 " @@ -16127,15 +16062,15 @@ msgstr "" "است --- در پشت صحنه، CXX توابع Rust «ناامن» و `extern \"C\"` را درست مانند " "در بخش قبل به صورت دستی انجام دادیم." -#: src/exercises/chromium/interoperability-with-cpp.md:1 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "Exercise: Interoperability with C++" msgstr "تمرین: قابلیت همکاری با ++C" -#: src/exercises/chromium/interoperability-with-cpp.md:3 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "Part one" msgstr "قسمت اول" -#: src/exercises/chromium/interoperability-with-cpp.md:5 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" "In the Rust file you previously created, add a `#[cxx::bridge]` which " "specifies a single function, to be called from C++, called " @@ -16145,7 +16080,7 @@ msgstr "" "تابع را مشخص می‌کند که باید از++C فراخوانی شود که نام `hello_from_rust` دارد، " "بدون اینکه پارامتر و هیچ مقداری برگرداند." -#: src/exercises/chromium/interoperability-with-cpp.md:8 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" "Modify your previous `hello_from_rust` function to remove `extern \"C\"` and " "`#[no_mangle]`. This is now just a standard Rust function." @@ -16153,11 +16088,11 @@ msgstr "" "تابع `hello_from_rust` قبلی خود را برای حذف `extern \"C\"` و `#[no_mangle]` " "تغییر دهید. حالا این فقط یک تابع استاندارد Rust است." -#: src/exercises/chromium/interoperability-with-cpp.md:10 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "Modify your `gn` target to build these bindings." msgstr "هدف `gn` خود را برای ایجاد این پیوندها (bindings) تغییر دهید." -#: src/exercises/chromium/interoperability-with-cpp.md:11 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" "In your C++ code, remove the forward-declaration of `hello_from_rust`. " "Instead, include the generated header file." @@ -16165,15 +16100,15 @@ msgstr "" "در کد ++C خود، forward-declaration برای `hello_from_rust` را حذف کنید. در " "عوض، فایل هِدِر تولید شده را اضافه کنید." -#: src/exercises/chromium/interoperability-with-cpp.md:13 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "Build and run!" msgstr "Build و run!" -#: src/exercises/chromium/interoperability-with-cpp.md:15 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "Part two" msgstr "قسمت دوم" -#: src/exercises/chromium/interoperability-with-cpp.md:17 +#: src/exercises/chromium/interoperability-with-cpp.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." @@ -16181,15 +16116,15 @@ msgstr "" "ایده خوبی است که کمی با CXX بازی کنید. این به شما کمک می کند تا به این فکر " "کنید که Rust در Chromium واقعا چقدر انعطاف پذیر است." -#: src/exercises/chromium/interoperability-with-cpp.md:20 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "Some things to try:" msgstr "برخی از چیزهایی که باید امتحان کنید:" -#: src/exercises/chromium/interoperability-with-cpp.md:22 +#: 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:23 +#: src/exercises/chromium/interoperability-with-cpp.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." @@ -16197,7 +16132,7 @@ msgstr "" "یک فایل هِدِر اضافی که می‌توانید از `cxx::bridge` خود `include!` را وارد کنید. " "شما باید تابع ++C خود را در آن فایل هِدِر جدید اعلام کنید." -#: src/exercises/chromium/interoperability-with-cpp.md:25 +#: src/exercises/chromium/interoperability-with-cpp.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/" @@ -16207,7 +16142,7 @@ msgstr "" "`unsafe` را در `#[cxx::bridge]` خود [همانطور که در اینجا توضیح داده شده است]" "(https://cxx.rs/extern-c++.html#functions-and-member-functions)." -#: src/exercises/chromium/interoperability-with-cpp.md:27 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" "You may also need to `#include \"third_party/rust/cxx/v1/crate/include/cxx." "h\"`" @@ -16215,14 +16150,15 @@ 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 را از ++C به Rust منتقل کنید." -#: src/exercises/chromium/interoperability-with-cpp.md:30 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "Pass a reference to a C++ object into Rust." msgstr "ارسال یک reference از یک C++ object به Rust ." -#: src/exercises/chromium/interoperability-with-cpp.md:31 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" "Intentionally get the Rust function signatures mismatched from the `#[cxx::" "bridge]`, and get used to the errors you see." @@ -16230,7 +16166,7 @@ msgstr "" "عمداً امضاهای تابع Rust را که از `#[cxx::bridge]` مطابقت ندارند، دریافت کنید " "و به خطاهایی که می بینید عادت کنید." -#: src/exercises/chromium/interoperability-with-cpp.md:33 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" "Intentionally get the C++ function signatures mismatched from the `#[cxx::" "bridge]`, and get used to the errors you see." @@ -16238,7 +16174,7 @@ msgstr "" "عمداً امضاهای تابع ++C را که از `#[cxx::bridge]` مطابقت ندارند، دریافت کنید و " "به خطاهایی که می بینید عادت کنید." -#: src/exercises/chromium/interoperability-with-cpp.md:35 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" "Pass a `std::unique_ptr` of some type from C++ into Rust, so that Rust can " "own some C++ object." @@ -16246,7 +16182,7 @@ msgstr "" "یک `std::unique_ptr` از نوعی از ++C را به Rust ارسال کنید، به طوری که Rust " "بتواند دارای یک C++ object باشد." -#: src/exercises/chromium/interoperability-with-cpp.md:37 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" "Create a Rust object and pass it into C++, so that C++ owns it. (Hint: you " "need a `Box`)." @@ -16254,19 +16190,19 @@ msgstr "" "یک Rust object ایجاد کنید و آن را به ++C ارسال کنید تا ++C مالک آن باشد. " "(نکته: شما به یک `Box` نیاز دارید)." -#: src/exercises/chromium/interoperability-with-cpp.md:39 +#: 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:40 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "Declare some methods on a Rust type. Call them from C++." msgstr "چند متد را در Rust type اعلام کنید. از ++C آن‌ها را فراخوانی کنید." -#: src/exercises/chromium/interoperability-with-cpp.md:42 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "Part three" msgstr "قسمت سوم" -#: src/exercises/chromium/interoperability-with-cpp.md:44 +#: src/exercises/chromium/interoperability-with-cpp.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 " @@ -16276,11 +16212,11 @@ msgstr "" "برای Rust در Chromium فکر کنید که در آن رابط به اندازه کافی ساده باشد. نحوه " "تعریف این رابط را ترسیم کنید." -#: src/exercises/chromium/interoperability-with-cpp.md:50 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "The [`cxx` binding reference](https://cxx.rs/bindings.html)" msgstr "یک [`cxx` binding reference](https://cxx.rs/bindings.html)" -#: src/exercises/chromium/interoperability-with-cpp.md:51 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" "The [`rust_static_library` gn template](https://source.chromium.org/chromium/" "chromium/src/+/main:build/rust/rust_static_library.gni;l=16)" @@ -16288,11 +16224,11 @@ msgstr "" "یک [`rust_static_library` gn template](https://source.chromium.org/chromium/" "chromium/src/+/main:build/rust/rust_static_library.gni;l=16)" -#: src/exercises/chromium/interoperability-with-cpp.md:57 +#: src/exercises/chromium/interoperability-with-cpp.md msgid "Some of the questions you may encounter:" msgstr "برخی از سؤالاتی که ممکن است با آن مواجه شوید:" -#: src/exercises/chromium/interoperability-with-cpp.md:59 +#: src/exercises/chromium/interoperability-with-cpp.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 " @@ -16302,7 +16238,7 @@ msgstr "" "هر دو نوع تابع هستند. بخاطر اینکه تابع ++ C شما کاملاً با اعلان موجود در " "`cxx::bridge` شما مطابقت ندارد." -#: src/exercises/chromium/interoperability-with-cpp.md:62 +#: src/exercises/chromium/interoperability-with-cpp.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-" @@ -16404,11 +16340,11 @@ msgstr "چگونه قوانین ساخت `gn` برای آن ایجاد کنیم" msgid "How to audit its source code for sufficient safety." msgstr "نحوه بررسی کد منبع آن برای ایمنی کافی" -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md:1 +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md msgid "Configuring the `Cargo.toml` file to add crates" msgstr "پیکربندی فایل `Cargo.toml` برای افزودن crateها" -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md:3 +#: 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." @@ -16420,7 +16356,7 @@ msgstr "" "chromium/src/+/main:third_party/rust/chromium_crates_io/Cargo.toml) مدیریت " "می‌شوند :" -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md:6 +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md msgid "" "```toml\n" "[dependencies]\n" @@ -16438,7 +16374,7 @@ msgstr "" "# lots more...\n" "```" -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md:14 +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md msgid "" "As with any other `Cargo.toml`, you can specify [more details about the " "dependencies](https://doc.rust-lang.org/cargo/reference/specifying-" @@ -16450,7 +16386,7 @@ msgstr "" "مشخص کنید --- معمولاً شما می‌خواهید «ویژگی‌هایی» را که می‌خواهید در crate فعال " "کنید را مشخص کنید." -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md:18 +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.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." @@ -16458,7 +16394,7 @@ msgstr "" "هنگام افزودن crate به Chromium، اغلب باید اطلاعات اضافی را در یک فایل اضافی، " "`gnrt_config.toml` ارائه کنید، که در ادامه با آن آشنا خواهیم شد." -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md:3 +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.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." @@ -16469,19 +16405,19 @@ msgstr "" "toml) قرار دارد. این شامل برنامه‌های extension مخصوص Chromium برای مدیریت " "crate است." -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md:6 +#: 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 "" "اگر crate جدیدی اضافه کنید، باید حداقل`group` را مشخص کنید. این یکی از:" -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md:15 -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md:15 +#: 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/adding-third-party-crates/configuring-gnrt-config-toml.md:22 +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.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." @@ -16489,7 +16425,7 @@ msgstr "" "بسته به طرح کد منبع crate، ممکن است لازم باشد از این فایل برای تعیین محل " "یافتن فایل (های) مجوز آن استفاده کنید." -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md:25 +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md msgid "" "Later, we'll see some other things you will need to configure in this file " "to resolve problems." @@ -16497,7 +16433,7 @@ msgstr "" "بعداً، موارد دیگری را که برای حل مشکلات باید پیکربندی کنید، در این فایل " "مشاهده خواهیم کرد." -#: src/chromium/adding-third-party-crates/downloading-crates.md:3 +#: 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." @@ -16505,11 +16441,11 @@ msgstr "" "ابزاری به نام `gnrt` می‌داند که چگونه جعبه‌ها را بارگیری کند و چگونه قواعد " "`BUILD.gn` را ایجاد کند." -#: src/chromium/adding-third-party-crates/downloading-crates.md:6 +#: src/chromium/adding-third-party-crates/downloading-crates.md msgid "To start, download the crate you want like this:" msgstr "برای شروع، crate مورد نظر خود را به صورت زیر دانلود کنید:" -#: src/chromium/adding-third-party-crates/downloading-crates.md:13 +#: src/chromium/adding-third-party-crates/downloading-crates.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 " @@ -16520,19 +16456,19 @@ msgstr "" "وابستگی‌های آن را از `crates.io` دانلود و اجرا می‌کنید. [بخش قبلی](../cargo." "md) را در مورد این تصمیم امنیتی ببینید." -#: src/chromium/adding-third-party-crates/downloading-crates.md:17 +#: src/chromium/adding-third-party-crates/downloading-crates.md msgid "This `vendor` command may download:" msgstr "این `vendor` command ممکن است بارگیری کند:" -#: src/chromium/adding-third-party-crates/downloading-crates.md:19 +#: src/chromium/adding-third-party-crates/downloading-crates.md msgid "Your crate" msgstr "جعبه‌های (crates) کاربردی شما" -#: src/chromium/adding-third-party-crates/downloading-crates.md:20 +#: src/chromium/adding-third-party-crates/downloading-crates.md msgid "Direct and transitive dependencies" msgstr "وابستگی های مستقیم و گذرا" -#: src/chromium/adding-third-party-crates/downloading-crates.md:21 +#: src/chromium/adding-third-party-crates/downloading-crates.md msgid "" "New versions of other crates, as required by `cargo` to resolve the complete " "set of crates required by Chromium." @@ -16540,7 +16476,7 @@ msgstr "" "نسخه‌های جدید crateهای دیگر، همانطور که `cargo` برای حل کردن مجموعه کامل " "جعبه‌های مورد نیاز Chromium لازم است." -#: src/chromium/adding-third-party-crates/downloading-crates.md:24 +#: src/chromium/adding-third-party-crates/downloading-crates.md msgid "" "Chromium maintains patches for some crates, kept in `//third_party/rust/" "chromium_crates_io/patches`. These will be reapplied automatically, but if " @@ -16550,24 +16486,24 @@ msgstr "" "rust/chromium_crates_io/patches` نگهداری می‌شوند. این‌ها به‌طور خودکار دوباره " "اعمال می‌شوند، اما اگر وصله نشد، ممکن است نیاز به اقدام دستی داشته باشید." -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md:3 +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "" "Once you've downloaded the crate, generate the `BUILD.gn` files like this:" msgstr "" "هنگامی که crate را دانلود کردید، فایل‌های `BUILD.gn` را مانند این تولید کنید:" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md:9 +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "Now run `git status`. You should find:" msgstr "اکنون `git status` را اجرا کنید. شما باید این موارد را پیدا کنید:" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md:11 +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "" "At least one new crate source code in `third_party/rust/chromium_crates_io/" "vendor`" msgstr "" "حداقل یک کد منبع جعبه جدید در `third_party/rust/chromium_crates_io/vendor`" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md:13 +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "" "At least one new `BUILD.gn` in `third_party/rust//v`" @@ -16575,11 +16511,11 @@ msgstr "" "حداقل یک `BUILD.gn` جدید در `third_party/rust//v`" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md:15 +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "An appropriate `README.chromium`" msgstr "یک `README.chromium` مناسب" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md:17 +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "" "The \"major semver version\" is a [Rust \"semver\" version number](https://" "doc.rust-lang.org/cargo/reference/semver.html)." @@ -16587,13 +16523,13 @@ msgstr "" "لطفا به [مرجع Rust ](https://doc.rust-lang.org/reference/type-layout.html) " "مراجعه کنید." -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md:19 +#: 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/adding-third-party-crates/generating-gn-build-rules.md:23 +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.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 " @@ -16603,7 +16539,7 @@ msgstr "" "ناسازگار از crateها را مجاز کند، صحبت کنید. این مورد که در اکوسیستم Cargo " "منع می‌شود ولی گاهی اوقات ضروری است." -#: src/chromium/adding-third-party-crates/resolving-problems.md:3 +#: src/chromium/adding-third-party-crates/resolving-problems.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 " @@ -16615,72 +16551,66 @@ msgstr "" "طراحی `gn` و `ninja` است که هدفشان قواعد build ایستا، قطعی برای به حداکثر " "رساندن موازی‌سازی و تکرارپذیری buildها است." -#: src/chromium/adding-third-party-crates/resolving-problems.md:8 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "" "Some `build.rs` actions are automatically supported; others require action:" msgstr "" "برخی از اقدامات `build.rs` به طور خودکار پشتیبانی می‌شوند. دیگران نیاز به " "اقدام دارند:" -#: src/chromium/adding-third-party-crates/resolving-problems.md:10 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "build script effect" msgstr "ساخت افکت اسکریپت" -#: src/chromium/adding-third-party-crates/resolving-problems.md:10 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "Supported by our gn templates" msgstr "توسط قالب‌های gn ما پشتیبانی می‌شود" -#: src/chromium/adding-third-party-crates/resolving-problems.md:10 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "Work required by you" msgstr "کار مورد نیاز شما" -#: src/chromium/adding-third-party-crates/resolving-problems.md:12 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "Checking rustc version to configure features on and off" msgstr "بررسی نسخه rustc برای پیکربندی ویژگی‌ها روشن و خاموش" -#: src/chromium/adding-third-party-crates/resolving-problems.md:12 -#: src/chromium/adding-third-party-crates/resolving-problems.md:13 -#: src/chromium/adding-third-party-crates/resolving-problems.md:14 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "Yes" msgstr "بلی" -#: src/chromium/adding-third-party-crates/resolving-problems.md:12 -#: src/chromium/adding-third-party-crates/resolving-problems.md:13 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "None" msgstr "None" -#: src/chromium/adding-third-party-crates/resolving-problems.md:13 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "Checking platform or CPU to configure features on and off" msgstr "بررسی پلتفرم یا CPU برای پیکربندی ویژگی‌های روشن و خاموش" -#: src/chromium/adding-third-party-crates/resolving-problems.md:14 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "Generating code" msgstr "تولید کردن کد" -#: src/chromium/adding-third-party-crates/resolving-problems.md:14 +#: 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:15 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "Building C/C++" msgstr "Building C/C++" -#: src/exercises/chromium/interoperability-with-cpp.md:29 -#: src/chromium/adding-third-party-crates/resolving-problems.md:15 -#: src/chromium/adding-third-party-crates/resolving-problems.md:16 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "No" msgstr "خیر" -#: src/chromium/adding-third-party-crates/resolving-problems.md:15 -#: src/chromium/adding-third-party-crates/resolving-problems.md:16 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "Patch around it" msgstr "اطراف آن را Patch کنید" -#: src/chromium/adding-third-party-crates/resolving-problems.md:16 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "Arbitrary other actions" msgstr "سایر اقدامات دلخواه" -#: src/chromium/adding-third-party-crates/resolving-problems.md:18 +#: src/chromium/adding-third-party-crates/resolving-problems.md msgid "" "Fortunately, most crates don't contain a build script, and fortunately, most " "build scripts only do the top two actions." @@ -16688,7 +16618,7 @@ msgstr "" "خوشبختانه، اکثر crateها حاوی build script نیستند و خوشبختانه، اکثر build " "scriptها تنها دو عمل اصلی را انجام می‌دهند." -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md:3 +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md msgid "" "If `ninja` complains about missing files, check the `build.rs` to see if it " "writes source code files." @@ -16696,7 +16626,7 @@ msgstr "" "اگه `ninja` درباره نبودن فایل‌ها اعتراض کرد، `build.rs` را بررسی کنید و " "ببینید که آیا کدهای منبع را می‌نویسد." -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md:6 +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.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, " @@ -16710,7 +16640,7 @@ msgstr "" "`allow-first-party-usage=false` را نیز اضافه کنید. چندین نمونه از قبل در آن " "فایل وجود دارد:" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md:11 +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md msgid "" "```toml\n" "[crate.unicode-linebreak]\n" @@ -16724,7 +16654,7 @@ msgstr "" "build-script-outputs = [\"tables.rs\"]\n" "```" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md:17 +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.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 " @@ -16734,7 +16664,7 @@ msgstr "" "تا فایل‌های `BUILD.gn` را دوباره تولید کنید تا به ninja اطلاع دهید که این " "فایل خروجی خاص ورودی مراحل build بعدی است." -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md:3 +#: 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://" @@ -16749,19 +16679,19 @@ msgstr "" "سیستم ساخت gn، ninja و LLVM ما در بیان روابط بین build actionsها بسیار خاص " "است." -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md:8 +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md msgid "So, your options are:" msgstr "بنابراین، گزینه‌های شما عبارتند از:" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md:10 +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md msgid "Avoid these crates" msgstr "از این crateها اجتناب کنید" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md:11 +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md msgid "Apply a patch to the crate." msgstr "یک وصله (patch) روی crate بزنید." -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md:13 +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md #, fuzzy msgid "" "Patches should be kept in `third_party/rust/chromium_crates_io/patches/" @@ -16776,7 +16706,7 @@ msgstr "" "chromium_crates_io/patches/cxx/) - و هر بار که crate را upgrade می‌کند به‌طور " "خودکار توسط`gnrt` اعمال می‌شود." -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md:3 +#: src/chromium/adding-third-party-crates/depending-on-a-crate.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 " @@ -16786,11 +16716,11 @@ msgstr "" "توجه به نوع crate می‌تواند ساده باشد. درنتیجه هدف `rust_static_library` خود " "را پیدا کنید و یک `dep` روی هدف `:lib` در crate خود اضافه کنید." -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md:7 +#: 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:9 +#: src/chromium/adding-third-party-crates/depending-on-a-crate.md msgid "" "```bob\n" " +------------+ +----------------------+\n" @@ -16806,7 +16736,7 @@ msgstr "" " +------------+ +----------------------+\n" "```" -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md:17 +#: src/chromium/adding-third-party-crates/depending-on-a-crate.md msgid "" "```gn\n" "rust_static_library(\"my_rust_lib\") {\n" @@ -16824,11 +16754,11 @@ msgstr "" "}\n" "```" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md:1 +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "Auditing Third Party Crates" msgstr "حسابرسی Crateهای شخص ثالث" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md:3 +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" "Adding new libraries is subject to Chromium's standard [policies](https://" "chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/rust." @@ -16844,7 +16774,7 @@ msgstr "" "زیادی برای بررسی وجود داشته باشد. از سوی دیگر، safe Rust code می‌تواند عوارض " "جانبی محدودی داشته باشد. پس چگونه باید آن را بررسی کنید؟" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md:9 +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" "Over time Chromium aims to move to a process based around [cargo vet]" "(https://mozilla.github.io/cargo-vet/)." @@ -16852,12 +16782,12 @@ msgstr "" "با گذشت زمان، Chromium قصد دارد به فرآیندی بر اساس [cargo vet](https://" "mozilla.github.io/cargo-vet/) حرکت کند." -#: src/chromium/adding-third-party-crates/reviews-and-audits.md:11 +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" "Meanwhile, for each new crate addition, we are checking for the following:" msgstr "در همین حال، برای هر crate جدید اضافه شده، موارد زیر را بررسی می کنیم:" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md:13 +#: src/chromium/adding-third-party-crates/reviews-and-audits.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 " @@ -16869,12 +16799,12 @@ msgstr "" "کنید که آن‌ها برای چه چیزی هستند. آیا آنها با روشی که Chromium به طور معمول " "ساخته و built می‌شود سازگار هستند؟" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md:17 +#: src/chromium/adding-third-party-crates/reviews-and-audits.md #, fuzzy msgid "Check each crate seems to be reasonably well maintained" msgstr "بررسی کنید که هر crate به نظر برسد که به خوبی نگهداری شده باشد." -#: src/chromium/adding-third-party-crates/reviews-and-audits.md:18 +#: src/chromium/adding-third-party-crates/reviews-and-audits.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 " @@ -16886,7 +16816,7 @@ msgstr "" "audit` که از قضا شامل دانلود وابستگی‌های زیادی از اینترنت می‌شود[2](../cargo." "md))" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md:21 +#: src/chromium/adding-third-party-crates/reviews-and-audits.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." @@ -16896,11 +16826,11 @@ msgstr "" "googlesource.com/chromium/src/+/main/docs/security/rule-of-2.md#unsafe-code-" "in-safe-languages) خوب است" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md:22 +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "Check for any use of `fs` or `net` APIs" msgstr "هرگونه استفاده از APIهای `fs` یا `net` را بررسی کنید" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md:23 +#: src/chromium/adding-third-party-crates/reviews-and-audits.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 " @@ -16910,7 +16840,7 @@ msgstr "" "وارد شده باشد را بگردید. (در اینجا نمی توانید به طور واقع بینانه به دنبال " "نتیجه ۱۰۰ درصدی باشید: اغلب کدهای زیادی وجود دارد.)" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md:27 +#: 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." @@ -16918,19 +16848,19 @@ msgstr "" "این‌ها فقط دستورالعمل‌هایی هستند --- با بازبین‌هایی از `security@chromium.org` " "کار کنید تا راه درستی برای اطمینان از crate پیدا کنید." -#: src/chromium/adding-third-party-crates/checking-in.md:1 +#: src/chromium/adding-third-party-crates/checking-in.md msgid "Checking Crates into Chromium Source Code" msgstr "بررسی Crateها در کد منبع Chromium" -#: src/chromium/adding-third-party-crates/checking-in.md:3 +#: src/chromium/adding-third-party-crates/checking-in.md msgid "`git status` should reveal:" msgstr "‏ `git status` باید نشان دهد:" -#: src/chromium/adding-third-party-crates/checking-in.md:5 +#: src/chromium/adding-third-party-crates/checking-in.md msgid "Crate code in `//third_party/rust/chromium_crates_io`" msgstr "کد Crate را در `//third_party/rust/chromium_crates_io`." -#: src/chromium/adding-third-party-crates/checking-in.md:6 +#: src/chromium/adding-third-party-crates/checking-in.md msgid "" "Metadata (`BUILD.gn` and `README.chromium`) in `//third_party/rust//" "`" @@ -16938,11 +16868,11 @@ msgstr "" "متادیتا (`BUILD.gn` و `README.chromium`) in `//third_party/rust//" "`" -#: src/chromium/adding-third-party-crates/checking-in.md:9 +#: src/chromium/adding-third-party-crates/checking-in.md msgid "Please also add an `OWNERS` file in the latter location." msgstr "لطفاً یک فایل`OWNERS` در مکان دیگر نیز اضافه کنید." -#: src/chromium/adding-third-party-crates/checking-in.md:11 +#: src/chromium/adding-third-party-crates/checking-in.md msgid "" "You should land all this, along with your `Cargo.toml` and `gnrt_config." "toml` changes, into the Chromium repo." @@ -16950,7 +16880,7 @@ msgstr "" "باید همه اینها را به همراه تغییرات `Cargo.toml` و `gnrt_config.toml` خود در " "مخزن Chromium قرار دهید." -#: src/chromium/adding-third-party-crates/checking-in.md:14 +#: 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." @@ -16958,7 +16888,7 @@ msgstr "" "**مهم**: باید از `git add -f` استفاده کنید زیرا در غیر این صورت فایل‌های `." "gitignore` ممکن است منجر به حذف برخی از فایل‌ها شود." -#: src/chromium/adding-third-party-crates/checking-in.md:17 +#: src/chromium/adding-third-party-crates/checking-in.md #, fuzzy msgid "" "As you do so, you might find presubmit checks fail because of non-inclusive " @@ -16971,7 +16901,7 @@ msgstr "" "نام شاخه‌های git می‌شوند و بسیاری از پروژه‌ها هنوز از اصطلاحات غیرمطرح در آنجا " "استفاده می‌کنند. بنابراین ممکن است لازم باشد این موارد را اجرا کنید:" -#: src/chromium/adding-third-party-crates/keeping-up-to-date.md:3 +#: src/chromium/adding-third-party-crates/keeping-up-to-date.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." @@ -16985,7 +16915,7 @@ msgstr "" "این را برای crateهای Rust خودکار کنیم، اما در حال حاضر، همچنان مسئولیت " "شماست، همانطور که برای هر وابستگی به شخص ثالث دیگر این مسئولیت را دارید." -#: src/exercises/chromium/third-party.md:3 +#: src/exercises/chromium/third-party.md #, fuzzy msgid "" "Add [uwuify](https://crates.io/crates/uwuify) to Chromium, turning off the " @@ -16999,7 +16929,7 @@ msgstr "" "Chromium استفاده می‌شود، اما برای رسیدگی به ورودی‌های غیرقابل اعتماد استفاده " "نمی‌شود." -#: src/exercises/chromium/third-party.md:7 +#: 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 " @@ -17011,47 +16941,47 @@ msgstr "" "(https://source.chromium.org /chromium/chromium/src/+/main:build/rust/" "rust_executable.gni) جدید ایجاد کنید که از `uwuify` استفاده می‌کند)." -#: src/exercises/chromium/third-party.md:13 +#: src/exercises/chromium/third-party.md msgid "Students will need to download lots of transitive dependencies." msgstr "دانش‌آموزان باید تعداد زیادی وابستگی گذرا را دانلود کنند." -#: src/exercises/chromium/third-party.md:15 +#: src/exercises/chromium/third-party.md msgid "The total crates needed are:" msgstr "کل crateهای مورد نیاز عبارتند از:" -#: src/exercises/chromium/third-party.md:17 +#: src/exercises/chromium/third-party.md msgid "`instant`," msgstr "`instant`," -#: src/exercises/chromium/third-party.md:18 +#: src/exercises/chromium/third-party.md msgid "`lock_api`," msgstr "`lock_api`," -#: src/exercises/chromium/third-party.md:19 +#: src/exercises/chromium/third-party.md msgid "`parking_lot`," msgstr "`parking_lot`," -#: src/exercises/chromium/third-party.md:20 +#: src/exercises/chromium/third-party.md msgid "`parking_lot_core`," msgstr "`parking_lot_core`," -#: src/exercises/chromium/third-party.md:21 +#: src/exercises/chromium/third-party.md msgid "`redox_syscall`," msgstr "`redox_syscall`," -#: src/exercises/chromium/third-party.md:22 +#: src/exercises/chromium/third-party.md msgid "`scopeguard`," msgstr "`scopeguard`," -#: src/exercises/chromium/third-party.md:23 +#: src/exercises/chromium/third-party.md msgid "`smallvec`, and" msgstr "`smallvec`, و" -#: src/exercises/chromium/third-party.md:24 +#: src/exercises/chromium/third-party.md msgid "`uwuify`." msgstr "`uwuify`." -#: src/exercises/chromium/third-party.md:26 +#: src/exercises/chromium/third-party.md msgid "" "If students are downloading even more than that, they probably forgot to " "turn off the default features." @@ -17059,7 +16989,7 @@ msgstr "" "اگر دانش‌آموزان حتی بیشتر از آن دانلود می‌کنند، احتمالا فراموش کرده‌اند که " "ویژگی‌های پیش‌فرض را خاموش کنند." -#: src/exercises/chromium/third-party.md:29 +#: src/exercises/chromium/third-party.md msgid "" "Thanks to [Daniel Liu](https://github.com/Daniel-Liu-c0deb0t) for this crate!" msgstr "" @@ -17264,7 +17194,7 @@ msgid "" "And give users in the `plugdev` group access to the micro:bit programmer:" msgstr "" -#: src/bare-metal.md src/bare-metal/microcontrollers/debugging.md:33 +#: src/bare-metal.md src/bare-metal/microcontrollers/debugging.md msgid "On MacOS:" msgstr "" @@ -17368,85 +17298,85 @@ msgstr "" msgid "`std` re-exports the contents of both `core` and `alloc`." msgstr "" -#: src/bare-metal/minimal.md:1 +#: src/bare-metal/minimal.md msgid "A minimal `no_std` program" msgstr "" -#: src/bare-metal/minimal.md:19 +#: src/bare-metal/minimal.md msgid "This will compile to an empty binary." msgstr "" -#: src/bare-metal/minimal.md:20 +#: src/bare-metal/minimal.md msgid "`std` provides a panic handler; without it we must provide our own." msgstr "" -#: src/bare-metal/minimal.md:21 +#: src/bare-metal/minimal.md msgid "It can also be provided by another crate, such as `panic-halt`." msgstr "" -#: src/bare-metal/minimal.md:22 +#: 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 "" -#: src/bare-metal/minimal.md:24 +#: 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 "" -#: src/bare-metal/alloc.md:3 +#: 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 "" -#: src/bare-metal/alloc.md:23 +#: src/bare-metal/alloc.md msgid "// SAFETY: `HEAP` is only used here and `entry` is only called once.\n" msgstr "" -#: src/bare-metal/alloc.md:25 +#: src/bare-metal/alloc.md msgid "// Give the allocator some memory to allocate.\n" msgstr "" -#: src/bare-metal/alloc.md:29 +#: src/bare-metal/alloc.md msgid "// Now we can do things that require heap allocation.\n" msgstr "" -#: src/bare-metal/alloc.md:31 +#: src/bare-metal/alloc.md #, fuzzy msgid "\"A string\"" msgstr "String" -#: src/bare-metal/alloc.md:37 +#: 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 "" -#: src/bare-metal/alloc.md:40 +#: 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 "" -#: src/bare-metal/alloc.md:42 +#: 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 "" -#: src/bare-metal/alloc.md:45 +#: 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 "" -#: src/bare-metal/alloc.md:47 +#: src/bare-metal/alloc.md msgid "This example will build but not run, as it doesn't have an entry point." msgstr "" @@ -17472,101 +17402,100 @@ msgstr "" msgid "Run the example with `cargo embed --bin minimal`" msgstr "" -#: src/bare-metal/microcontrollers/mmio.md:3 +#: 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 "" -#: src/bare-metal/microcontrollers/mmio.md:16 +#: src/bare-metal/microcontrollers/mmio.md msgid "/// GPIO port 0 peripheral address\n" msgstr "" -#: src/bare-metal/microcontrollers/mmio.md:19 +#: src/bare-metal/microcontrollers/mmio.md msgid "// GPIO peripheral offsets\n" msgstr "" -#: src/bare-metal/microcontrollers/mmio.md:24 +#: src/bare-metal/microcontrollers/mmio.md msgid "// PIN_CNF fields\n" msgstr "" -#: src/bare-metal/microcontrollers/mmio.md:34 -#: src/bare-metal/microcontrollers/pacs.md:21 -#: src/bare-metal/microcontrollers/hals.md:26 +#: 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 "" -#: src/bare-metal/microcontrollers/mmio.md:37 -#: src/bare-metal/microcontrollers/mmio.md:59 +#: src/bare-metal/microcontrollers/mmio.md msgid "" "// SAFETY: The pointers are to valid peripheral control registers, and no\n" " // aliases exist.\n" msgstr "" -#: src/bare-metal/microcontrollers/mmio.md:56 -#: src/bare-metal/microcontrollers/pacs.md:39 -#: src/bare-metal/microcontrollers/hals.md:30 +#: 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 "" -#: src/bare-metal/microcontrollers/mmio.md:72 +#: 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 "" -#: src/bare-metal/microcontrollers/mmio.md:75 -#: src/bare-metal/microcontrollers/pacs.md:61 -#: src/bare-metal/microcontrollers/hals.md:44 -#: src/bare-metal/microcontrollers/board-support.md:37 +#: 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:1 +#: src/bare-metal/microcontrollers/pacs.md msgid "Peripheral Access Crates" msgstr "" -#: src/bare-metal/microcontrollers/pacs.md:3 +#: 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 "" -#: src/bare-metal/microcontrollers/pacs.md:49 +#: 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 "" -#: src/bare-metal/microcontrollers/pacs.md:51 +#: src/bare-metal/microcontrollers/pacs.md msgid "" "They are organised by peripheral, register, field and value, with names, " "descriptions, addresses and so on." msgstr "" -#: src/bare-metal/microcontrollers/pacs.md:53 +#: 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 "" -#: src/bare-metal/microcontrollers/pacs.md:56 +#: src/bare-metal/microcontrollers/pacs.md msgid "`cortex-m-rt` provides the vector table, among other things." msgstr "" -#: src/bare-metal/microcontrollers/pacs.md:57 +#: 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 "" -#: src/bare-metal/microcontrollers/hals.md:1 +#: src/bare-metal/microcontrollers/hals.md msgid "HAL crates" msgstr "" -#: src/bare-metal/microcontrollers/hals.md:3 +#: 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 " @@ -17574,72 +17503,72 @@ msgid "" "(https://crates.io/crates/embedded-hal)." msgstr "" -#: src/bare-metal/microcontrollers/hals.md:23 +#: src/bare-metal/microcontrollers/hals.md msgid "// Create HAL wrapper for GPIO port 0.\n" msgstr "" -#: src/bare-metal/microcontrollers/hals.md:40 +#: src/bare-metal/microcontrollers/hals.md msgid "" "`set_low` and `set_high` are methods on the `embedded_hal` `OutputPin` trait." msgstr "" -#: src/bare-metal/microcontrollers/hals.md:41 +#: 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 "" -#: src/bare-metal/microcontrollers/board-support.md:1 +#: src/bare-metal/microcontrollers/board-support.md msgid "Board support crates" msgstr "" -#: src/bare-metal/microcontrollers/board-support.md:3 +#: 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:31 +#: 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:33 +#: 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:35 +#: src/bare-metal/microcontrollers/board-support.md msgid "`microbit-v2` includes a simple driver for the LED matrix." msgstr "" -#: src/bare-metal/microcontrollers/type-state.md:1 +#: src/bare-metal/microcontrollers/type-state.md msgid "The type state pattern" msgstr "" -#: src/bare-metal/microcontrollers/type-state.md:11 +#: src/bare-metal/microcontrollers/type-state.md msgid "// let gpio0_01_again = gpio0.p0_01; // Error, moved.\n" msgstr "" -#: src/bare-metal/microcontrollers/type-state.md:19 +#: src/bare-metal/microcontrollers/type-state.md msgid "// pin_input.is_high(); // Error, moved.\n" msgstr "" -#: src/bare-metal/microcontrollers/type-state.md:33 +#: 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 "" -#: src/bare-metal/microcontrollers/type-state.md:35 +#: 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:37 +#: 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 " @@ -17648,39 +17577,39 @@ msgid "" "caught at compile time." msgstr "" -#: src/bare-metal/microcontrollers/type-state.md:42 +#: 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 "" -#: src/bare-metal/microcontrollers/type-state.md:44 +#: src/bare-metal/microcontrollers/type-state.md msgid "Many HAL crates follow this pattern." msgstr "" -#: src/bare-metal/microcontrollers/embedded-hal.md:3 +#: src/bare-metal/microcontrollers/embedded-hal.md msgid "" "The [`embedded-hal`](https://crates.io/crates/embedded-hal) crate provides a " "number of traits covering common microcontroller peripherals:" msgstr "" -#: src/bare-metal/microcontrollers/embedded-hal.md:6 +#: src/bare-metal/microcontrollers/embedded-hal.md msgid "GPIO" msgstr "" -#: src/bare-metal/microcontrollers/embedded-hal.md:7 +#: src/bare-metal/microcontrollers/embedded-hal.md msgid "PWM" msgstr "" -#: src/bare-metal/microcontrollers/embedded-hal.md:8 +#: src/bare-metal/microcontrollers/embedded-hal.md msgid "Delay timers" msgstr "" -#: src/bare-metal/microcontrollers/embedded-hal.md:9 +#: src/bare-metal/microcontrollers/embedded-hal.md msgid "I2C and SPI buses and devices" msgstr "" -#: src/bare-metal/microcontrollers/embedded-hal.md:11 +#: 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-" @@ -17688,66 +17617,66 @@ msgid "" "crates.io/crates/rand_core) respectively." msgstr "" -#: src/bare-metal/microcontrollers/embedded-hal.md:14 +#: src/bare-metal/microcontrollers/embedded-hal.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 device instance." msgstr "" -#: src/bare-metal/microcontrollers/embedded-hal.md:19 +#: 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:21 +#: 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 "" -#: src/bare-metal/microcontrollers/embedded-hal.md:23 +#: src/bare-metal/microcontrollers/embedded-hal.md msgid "" "[`embedded-hal-async`](https://crates.io/crates/embedded-hal-async) provides " "async versions of the traits." msgstr "" -#: src/bare-metal/microcontrollers/embedded-hal.md:24 +#: src/bare-metal/microcontrollers/embedded-hal.md 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 "" -#: src/bare-metal/microcontrollers/probe-rs.md:3 +#: 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 "" -#: src/bare-metal/microcontrollers/probe-rs.md:6 +#: src/bare-metal/microcontrollers/probe-rs.md msgid "" "SWD (Serial Wire Debug) and JTAG via CMSIS-DAP, ST-Link and J-Link probes" msgstr "" -#: src/bare-metal/microcontrollers/probe-rs.md:7 +#: src/bare-metal/microcontrollers/probe-rs.md msgid "GDB stub and Microsoft DAP (Debug Adapter Protocol) server" msgstr "" -#: src/bare-metal/microcontrollers/probe-rs.md:8 +#: src/bare-metal/microcontrollers/probe-rs.md msgid "Cargo integration" msgstr "" -#: src/bare-metal/microcontrollers/probe-rs.md:10 +#: 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 "" -#: src/bare-metal/microcontrollers/probe-rs.md:16 +#: 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 " @@ -17755,141 +17684,141 @@ msgid "" "on-board debugger on the BBC micro:bit uses." msgstr "" -#: src/bare-metal/microcontrollers/probe-rs.md:20 +#: 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 "" -#: src/bare-metal/microcontrollers/probe-rs.md:22 +#: 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 "" -#: src/bare-metal/microcontrollers/probe-rs.md:24 +#: 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 "" -#: src/bare-metal/microcontrollers/probe-rs.md:26 +#: 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 "" -#: src/bare-metal/microcontrollers/probe-rs.md:30 +#: src/bare-metal/microcontrollers/probe-rs.md msgid "cargo-embed is a binary built using the probe-rs library." msgstr "" -#: src/bare-metal/microcontrollers/probe-rs.md:31 +#: 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 "" -#: src/bare-metal/microcontrollers/debugging.md:3 +#: src/bare-metal/microcontrollers/debugging.md msgid "_Embed.toml_:" msgstr "" -#: src/bare-metal/microcontrollers/debugging.md:15 +#: src/bare-metal/microcontrollers/debugging.md msgid "In one terminal under `src/bare-metal/microcontrollers/examples/`:" msgstr "" -#: src/bare-metal/microcontrollers/debugging.md:23 +#: src/bare-metal/microcontrollers/debugging.md msgid "In another terminal in the same directory:" msgstr "" -#: src/bare-metal/microcontrollers/debugging.md:25 +#: src/bare-metal/microcontrollers/debugging.md msgid "On gLinux or Debian:" msgstr "" -#: src/bare-metal/microcontrollers/debugging.md:43 +#: src/bare-metal/microcontrollers/debugging.md msgid "In GDB, try running:" msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:1 -#: src/bare-metal/aps/other-projects.md:1 +#: 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:3 +#: src/bare-metal/microcontrollers/other-projects.md msgid "[RTIC](https://rtic.rs/)" msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:4 +#: src/bare-metal/microcontrollers/other-projects.md msgid "\"Real-Time Interrupt-driven Concurrency\"" msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:5 +#: 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:6 +#: src/bare-metal/microcontrollers/other-projects.md msgid "[Embassy](https://embassy.dev/)" msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:7 +#: src/bare-metal/microcontrollers/other-projects.md msgid "`async` executors with priorities, timers, networking, USB" msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:8 +#: src/bare-metal/microcontrollers/other-projects.md msgid "[TockOS](https://www.tockos.org/documentation/getting-started)" msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:9 +#: src/bare-metal/microcontrollers/other-projects.md msgid "" "Security-focused RTOS with preemptive scheduling and Memory Protection Unit " "support" msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:11 +#: src/bare-metal/microcontrollers/other-projects.md msgid "[Hubris](https://hubris.oxide.computer/)" msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:12 +#: src/bare-metal/microcontrollers/other-projects.md msgid "" "Microkernel RTOS from Oxide Computer Company with memory protection, " "unprivileged drivers, IPC" msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:14 +#: src/bare-metal/microcontrollers/other-projects.md msgid "[Bindings for FreeRTOS](https://github.com/lobaro/FreeRTOS-rust)" msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:15 +#: 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 "" -#: src/bare-metal/microcontrollers/other-projects.md:20 +#: src/bare-metal/microcontrollers/other-projects.md msgid "RTIC can be considered either an RTOS or a concurrency framework." msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:21 +#: src/bare-metal/microcontrollers/other-projects.md msgid "It doesn't include any HALs." msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:22 +#: 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 "" -#: src/bare-metal/microcontrollers/other-projects.md:24 +#: src/bare-metal/microcontrollers/other-projects.md msgid "Cortex-M only." msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:25 +#: src/bare-metal/microcontrollers/other-projects.md msgid "" "Google uses TockOS on the Haven microcontroller for Titan security keys." msgstr "" -#: src/bare-metal/microcontrollers/other-projects.md:26 +#: src/bare-metal/microcontrollers/other-projects.md msgid "" "FreeRTOS is mostly written in C, but there are Rust bindings for writing " "applications." @@ -17909,18 +17838,18 @@ msgstr "" "پس از دیدن تمرین‌ها، می‌توانید به [راه حل‌ها] (solutions-morning.md) ارائه شده " "نگاه کنید." -#: src/exercises/bare-metal/compass.md:3 +#: 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 "" -#: src/exercises/bare-metal/compass.md:7 +#: src/exercises/bare-metal/compass.md msgid "Hints:" msgstr "" -#: src/exercises/bare-metal/compass.md:9 +#: 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/" @@ -17928,112 +17857,112 @@ msgid "" "org/hardware/)." msgstr "" -#: src/exercises/bare-metal/compass.md:13 +#: src/exercises/bare-metal/compass.md msgid "" "The LSM303AGR Inertial Measurement Unit is connected to the internal I2C bus." msgstr "" -#: src/exercises/bare-metal/compass.md:14 +#: src/exercises/bare-metal/compass.md msgid "" "TWI is another name for I2C, so the I2C master peripheral is called TWIM." msgstr "" -#: src/exercises/bare-metal/compass.md:15 +#: src/exercises/bare-metal/compass.md 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 "" -#: src/exercises/bare-metal/compass.md:19 +#: 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 "" -#: src/exercises/bare-metal/compass.md:22 +#: 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 "" -#: src/exercises/bare-metal/compass.md:26 +#: 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 "" -#: src/exercises/bare-metal/compass.md:29 src/exercises/bare-metal/rtc.md:22 +#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md msgid "_src/main.rs_:" msgstr "" -#: src/exercises/bare-metal/compass.md:71 src/exercises/bare-metal/rtc.md:393 +#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md msgid "_Cargo.toml_ (you shouldn't need to change this):" msgstr "" -#: src/exercises/bare-metal/compass.md:93 +#: src/exercises/bare-metal/compass.md msgid "_Embed.toml_ (you shouldn't need to change this):" msgstr "" -#: src/exercises/bare-metal/compass.md:109 src/exercises/bare-metal/rtc.md:1000 +#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md msgid "_.cargo/config.toml_ (you shouldn't need to change this):" msgstr "" -#: src/exercises/bare-metal/compass.md:122 +#: src/exercises/bare-metal/compass.md msgid "See the serial output on Linux with:" msgstr "" -#: src/exercises/bare-metal/compass.md:130 +#: src/exercises/bare-metal/compass.md msgid "" "Or on Mac OS something like (the device name may be slightly different):" msgstr "" -#: src/exercises/bare-metal/compass.md:138 +#: src/exercises/bare-metal/compass.md msgid "Use Ctrl+A Ctrl+Q to quit picocom." msgstr "" -#: src/exercises/bare-metal/solutions-morning.md:1 +#: src/exercises/bare-metal/solutions-morning.md msgid "Bare Metal Rust Morning Exercise" msgstr "" -#: src/exercises/bare-metal/solutions-morning.md:5 +#: src/exercises/bare-metal/solutions-morning.md msgid "([back to exercise](compass.md))" msgstr "" -#: src/exercises/bare-metal/solutions-morning.md:34 +#: src/exercises/bare-metal/solutions-morning.md msgid "// Configure serial port.\n" msgstr "" -#: src/exercises/bare-metal/solutions-morning.md:42 +#: src/exercises/bare-metal/solutions-morning.md msgid "// Use the system timer as a delay provider.\n" msgstr "" -#: src/exercises/bare-metal/solutions-morning.md:45 +#: src/exercises/bare-metal/solutions-morning.md msgid "// Set up the I2C controller and Inertial Measurement Unit.\n" msgstr "" -#: src/exercises/bare-metal/solutions-morning.md:46 +#: src/exercises/bare-metal/solutions-morning.md msgid "\"Setting up IMU...\"" msgstr "" -#: src/exercises/bare-metal/solutions-morning.md:64 +#: src/exercises/bare-metal/solutions-morning.md msgid "// Set up display and timer.\n" msgstr "" -#: src/exercises/bare-metal/solutions-morning.md:71 +#: src/exercises/bare-metal/solutions-morning.md msgid "\"Ready.\"" msgstr "" -#: src/exercises/bare-metal/solutions-morning.md:74 +#: src/exercises/bare-metal/solutions-morning.md msgid "// Read compass data and log it to the serial port.\n" msgstr "" -#: src/exercises/bare-metal/solutions-morning.md:82 +#: src/exercises/bare-metal/solutions-morning.md msgid "\"{},{},{}\\t{},{},{}\"" msgstr "" -#: src/exercises/bare-metal/solutions-morning.md:120 +#: src/exercises/bare-metal/solutions-morning.md msgid "" "// If button A is pressed, switch to the next mode and briefly blink all " "LEDs\n" @@ -18066,12 +17995,12 @@ msgid "" "hardware, but is designed purely for virtual machines." msgstr "" -#: src/bare-metal/aps/entry-point.md:3 +#: src/bare-metal/aps/entry-point.md msgid "" "Before we can start running Rust code, we need to do some initialisation." msgstr "" -#: src/bare-metal/aps/entry-point.md:5 +#: src/bare-metal/aps/entry-point.md msgid "" "```armasm\n" ".section .init.entry, \"ax\"\n" @@ -18147,13 +18076,13 @@ msgid "" "```" msgstr "" -#: src/bare-metal/aps/entry-point.md:77 +#: 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 "" -#: src/bare-metal/aps/entry-point.md:79 +#: 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 " @@ -18162,19 +18091,19 @@ msgid "" "them." msgstr "" -#: src/bare-metal/aps/entry-point.md:84 +#: 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 "" -#: src/bare-metal/aps/entry-point.md:86 +#: 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 "" -#: src/bare-metal/aps/entry-point.md:88 +#: 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 " @@ -18182,7 +18111,7 @@ msgid "" "is not necessarily the case in general." msgstr "" -#: src/bare-metal/aps/entry-point.md:92 +#: 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, " @@ -18193,7 +18122,7 @@ msgid "" "not VA or IPA.)" msgstr "" -#: src/bare-metal/aps/entry-point.md:99 +#: 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 " @@ -18201,24 +18130,24 @@ msgid "" "memory layout that QEMU uses." msgstr "" -#: src/bare-metal/aps/entry-point.md:103 +#: 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 "" -#: src/bare-metal/aps/entry-point.md:105 +#: 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 "" -#: src/bare-metal/aps/inline-assembly.md:1 +#: src/bare-metal/aps/inline-assembly.md msgid "Inline assembly" msgstr "Inline assembly" -#: src/bare-metal/aps/inline-assembly.md:3 +#: 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 " @@ -18228,7 +18157,7 @@ msgstr "" "استفاده کنیم. به عنوان مثال، برای برقراری یک HVC (hypervisor call) نایز است " "که به firmware بگویید سیستم را خاموش کند:" -#: src/bare-metal/aps/inline-assembly.md:20 +#: src/bare-metal/aps/inline-assembly.md #, fuzzy msgid "" "// SAFETY: this only uses the declared registers and doesn't do anything\n" @@ -18237,43 +18166,43 @@ msgstr "" "// SAFETY: this only uses the declared registers and doesn't do anything\n" " // with memory.\n" -#: src/bare-metal/aps/inline-assembly.md:23 +#: src/bare-metal/aps/inline-assembly.md msgid "\"hvc #0\"" msgstr "\"hvc #0\"" -#: src/bare-metal/aps/inline-assembly.md:24 +#: src/bare-metal/aps/inline-assembly.md msgid "\"w0\"" msgstr "\"w0\"" -#: src/bare-metal/aps/inline-assembly.md:25 +#: src/bare-metal/aps/inline-assembly.md msgid "\"w1\"" msgstr "\"w1\"" -#: src/bare-metal/aps/inline-assembly.md:26 +#: src/bare-metal/aps/inline-assembly.md msgid "\"w2\"" msgstr "\"w2\"" -#: src/bare-metal/aps/inline-assembly.md:27 +#: src/bare-metal/aps/inline-assembly.md msgid "\"w3\"" msgstr "\"w3\"" -#: src/bare-metal/aps/inline-assembly.md:28 +#: src/bare-metal/aps/inline-assembly.md msgid "\"w4\"" msgstr "\"w4\"" -#: src/bare-metal/aps/inline-assembly.md:29 +#: src/bare-metal/aps/inline-assembly.md msgid "\"w5\"" msgstr "\"w5\"" -#: src/bare-metal/aps/inline-assembly.md:30 +#: src/bare-metal/aps/inline-assembly.md msgid "\"w6\"" msgstr "\"w6\"" -#: src/bare-metal/aps/inline-assembly.md:31 +#: src/bare-metal/aps/inline-assembly.md msgid "\"w7\"" msgstr "\"w7\"" -#: src/bare-metal/aps/inline-assembly.md:40 +#: 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.)" @@ -18282,7 +18211,7 @@ msgstr "" "crates.io/crates/smccc) استفاده کنید که دارای بسته‌بندی(wrapper) برای همه این " "عملکردها است.)" -#: src/bare-metal/aps/inline-assembly.md:45 +#: 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 " @@ -18292,7 +18221,7 @@ msgstr "" "برای مدیریت وضعیت‌های power در سیستم و CPU بوده، از جمله موارد دیگری از این " "مورد توسط میان‌افزار EL3 و hypervisor در بسیاری از سیستم‌ها پیاده سازی شده است." -#: src/bare-metal/aps/inline-assembly.md:48 +#: 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 " @@ -18304,7 +18233,7 @@ msgstr "" "از `inout` به جای `in` استفاده کنیم زیرا این فراخوانی به طور بالقوه می‌تواند " "محتویات رجیسترها را مخدوش کند." -#: src/bare-metal/aps/inline-assembly.md:52 +#: 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`." @@ -18312,7 +18241,7 @@ msgstr "" "این تابع `main` باید به صورت`#[no_mangle]` و `extern \"C\"` باشد زیرا از " "نقطه ورودی (entry point) ما در `entry.S` فراخوانی می‌شود." -#: src/bare-metal/aps/inline-assembly.md:54 +#: 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. " @@ -18329,7 +18258,7 @@ msgstr "" "نیست کار خاصی انجام دهید، جز اینکه مطمئن شوید که این مورد رجیسترها را تغییر " "نمی‌دهد." -#: src/bare-metal/aps/inline-assembly.md:60 +#: src/bare-metal/aps/inline-assembly.md msgid "" "Run the example in QEMU with `make qemu_psci` under `src/bare-metal/aps/" "examples`." @@ -18337,19 +18266,19 @@ msgstr "" "مثال را در QEMU با `make qemu_psci` در زیر `src/bare-metal/aps/examples` " "اجرا کنید." -#: src/bare-metal/aps/mmio.md:1 +#: src/bare-metal/aps/mmio.md msgid "Volatile memory access for MMIO" msgstr "دسترسی به حافظه فرار برای MMIO" -#: src/bare-metal/aps/mmio.md:3 +#: 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:4 +#: src/bare-metal/aps/mmio.md msgid "Never hold a reference." msgstr "هرگز reference‌ای را نگه ندارید." -#: src/bare-metal/aps/mmio.md:5 +#: src/bare-metal/aps/mmio.md msgid "" "`addr_of!` lets you get fields of structs without creating an intermediate " "reference." @@ -18357,7 +18286,7 @@ msgstr "" "‏ `addr_of!` به شما امکان می‌دهد بدون ایجاد یک مرجع میانی، فیلدهایی از " "ساختارها را دریافت کنید." -#: src/bare-metal/aps/mmio.md:10 +#: 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." @@ -18366,7 +18295,7 @@ msgstr "" "داشته باشد، بنابراین از کامپایلر یا سخت‌افزار از مرتب‌سازی مجدد، کپی‌کردن یا " "حذف آنها جلوگیری کنید." -#: src/bare-metal/aps/mmio.md:12 +#: 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 " @@ -18376,7 +18305,7 @@ msgstr "" "کامپایلر ممکن است فرض کند که مقدار خوانده شده همان مقداری است که نوشته شده " "است و در واقع خواندن memory را سخت‌تر نکند." -#: src/bare-metal/aps/mmio.md:15 +#: 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 " @@ -18386,7 +18315,7 @@ msgstr "" "referenceهایی هستند، اما این همیشه درست نیست. هر زمان که یک reference وجود " "داشته باشد، کامپایلر ممکن است انتخاب کند که reference آن را لغو کند." -#: src/bare-metal/aps/mmio.md:18 +#: src/bare-metal/aps/mmio.md msgid "" "Use the `addr_of!` macro to get struct field pointers from a pointer to the " "struct." @@ -18394,11 +18323,11 @@ msgstr "" "از ماکرو `addr_of!` برای دریافت اشاره‌گرهای struct field از یک اشاره‌گر به " "ساختار استفاده کنید." -#: src/bare-metal/aps/uart.md:1 +#: src/bare-metal/aps/uart.md msgid "Let's write a UART driver" msgstr "بیایید یک درایور UART بنویسیم" -#: src/bare-metal/aps/uart.md:3 +#: 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." @@ -18406,12 +18335,12 @@ msgstr "" "این ماشین QEMU 'virt' یک [PL011](https://developer.arm.com/documentation/" "ddi0183/g) به‌عنوان UART دارد، پس بیایید یک درایور برای آن بنویسیم." -#: src/bare-metal/aps/uart.md:9 +#: src/bare-metal/aps/uart.md #, fuzzy msgid "/// Minimal driver for a PL011 UART.\n" msgstr "/// Minimal driver for a PL011 UART.\n" -#: src/bare-metal/aps/uart.md:17 src/bare-metal/aps/better-uart/driver.md:13 +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md #, fuzzy msgid "" "/// Constructs a new instance of the UART driver for a PL011 device at the\n" @@ -18436,17 +18365,17 @@ msgstr "" "process\n" " /// as device memory and not have any other aliases.\n" -#: src/bare-metal/aps/uart.md:29 src/bare-metal/aps/better-uart/driver.md:25 +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md #, fuzzy msgid "/// Writes a single byte to the UART.\n" msgstr "/// Writes a single byte to the UART.\n" -#: src/bare-metal/aps/uart.md:31 src/bare-metal/aps/better-uart/driver.md:27 +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md #, fuzzy msgid "// Wait until there is room in the TX buffer.\n" msgstr "// Wait until there is room in the TX buffer.\n" -#: src/bare-metal/aps/uart.md:34 src/bare-metal/aps/uart.md:46 +#: src/bare-metal/aps/uart.md #, fuzzy msgid "" "// SAFETY: We know that the base address points to the control\n" @@ -18455,17 +18384,17 @@ msgstr "" "// SAFETY: We know that the base address points to the control\n" " // registers of a PL011 device which is appropriately mapped.\n" -#: src/bare-metal/aps/uart.md:37 src/bare-metal/aps/better-uart/driver.md:33 +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md #, fuzzy msgid "// Write to the TX buffer.\n" msgstr "// Write to the TX buffer.\n" -#: src/bare-metal/aps/uart.md:41 src/bare-metal/aps/better-uart/driver.md:37 +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md #, fuzzy msgid "// Wait until the UART is no longer busy.\n" msgstr "// Wait until the UART is no longer busy.\n" -#: src/bare-metal/aps/uart.md:55 +#: 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 " @@ -18481,7 +18410,7 @@ msgstr "" "همیشه می‌توان `write_byte` را بعداً فراخوانی کرد زیرا می‌توانیم پیش‌شرط‌های لازم " "را فرض کنیم." -#: src/bare-metal/aps/uart.md:61 +#: 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 " @@ -18492,7 +18421,7 @@ msgstr "" "زیرا هر مکانی که `write_byte` را صدا می‌زند باید در مورد ایمنی یا safety " "استدلال کند." -#: src/bare-metal/aps/uart.md:64 +#: src/bare-metal/aps/uart.md #, fuzzy msgid "" "This is a common pattern for writing safe wrappers of unsafe code: moving " @@ -18502,18 +18431,18 @@ msgstr "" "این یک الگوی رایج برای نوشتن بسته‌های ایمن کد ناامن است: انتقال بار اثبات " "سلامت عملکردی از تعداد زیادی مکان به تعداد کمتری مکان." -#: src/bare-metal/aps/uart/traits.md:1 +#: src/bare-metal/aps/uart/traits.md msgid "More traits" msgstr "‏ traitهای بیشتر" -#: src/bare-metal/aps/uart/traits.md:3 +#: 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:17 +#: src/bare-metal/aps/uart/traits.md #, fuzzy msgid "" "// SAFETY: `Uart` just contains a pointer to device memory, which can be\n" @@ -18522,7 +18451,7 @@ msgstr "" "// SAFETY: `Uart` just contains a pointer to device memory, which can be\n" "// accessed from any context.\n" -#: src/bare-metal/aps/uart/traits.md:25 +#: src/bare-metal/aps/uart/traits.md msgid "" "Implementing `Write` lets us use the `write!` and `writeln!` macros with our " "`Uart` type." @@ -18530,7 +18459,7 @@ msgstr "" "پیاده‌سازی `Write`به ما امکان می‌دهد از ماکروهای `write!` و `writeln!` با تایپ " "`Uart` خود استفاده کنیم." -#: src/bare-metal/aps/uart/traits.md:27 +#: src/bare-metal/aps/uart/traits.md msgid "" "Run the example in QEMU with `make qemu_minimal` under `src/bare-metal/aps/" "examples`." @@ -18538,11 +18467,11 @@ msgstr "" "مثال را در QEMU با `make qemu_minimal` در زیر `src/bare-metal/aps/examples` " "اجرا کنید." -#: src/bare-metal/aps/better-uart.md:1 +#: src/bare-metal/aps/better-uart.md msgid "A better UART driver" msgstr "یک درایور UART بهتر" -#: src/bare-metal/aps/better-uart.md:3 +#: src/bare-metal/aps/better-uart.md #, fuzzy msgid "" "The PL011 actually has [a bunch more registers](https://developer.arm.com/" @@ -18557,168 +18486,167 @@ msgstr "" "خواندن را می‌تواند پیچیده کند، برخی از آن فیلدها از نوع bit هستند که دسترسی " "به آنها به روشی ساختاریافته خوب است." -#: src/bare-metal/aps/better-uart.md:7 +#: src/bare-metal/aps/better-uart.md msgid "Offset" msgstr "افست" -#: src/bare-metal/aps/better-uart.md:7 +#: src/bare-metal/aps/better-uart.md msgid "Register name" msgstr "نام رجیستر" -#: src/bare-metal/aps/better-uart.md:7 +#: src/bare-metal/aps/better-uart.md msgid "Width" msgstr "عرض" -#: src/bare-metal/aps/better-uart.md:9 +#: src/bare-metal/aps/better-uart.md msgid "0x00" msgstr "0x00" -#: src/bare-metal/aps/better-uart.md:9 +#: src/bare-metal/aps/better-uart.md msgid "DR" msgstr "DR" -#: src/bare-metal/aps/better-uart.md:9 +#: src/bare-metal/aps/better-uart.md msgid "12" msgstr "12" -#: src/bare-metal/aps/better-uart.md:10 +#: src/bare-metal/aps/better-uart.md msgid "0x04" msgstr "0x04" -#: src/bare-metal/aps/better-uart.md:10 +#: src/bare-metal/aps/better-uart.md msgid "RSR" msgstr "RSR" -#: src/bare-metal/aps/better-uart.md:10 +#: src/bare-metal/aps/better-uart.md msgid "4" msgstr "4" -#: src/bare-metal/aps/better-uart.md:11 +#: src/bare-metal/aps/better-uart.md msgid "0x18" msgstr "0x18" -#: src/bare-metal/aps/better-uart.md:11 +#: src/bare-metal/aps/better-uart.md msgid "FR" msgstr "FR" -#: src/bare-metal/aps/better-uart.md:11 +#: src/bare-metal/aps/better-uart.md msgid "9" msgstr "9" -#: src/bare-metal/aps/better-uart.md:12 +#: src/bare-metal/aps/better-uart.md msgid "0x20" msgstr "0x20" -#: src/bare-metal/aps/better-uart.md:12 +#: src/bare-metal/aps/better-uart.md msgid "ILPR" msgstr "ILPR" -#: src/bare-metal/aps/better-uart.md:12 src/bare-metal/aps/better-uart.md:15 +#: src/bare-metal/aps/better-uart.md msgid "8" msgstr "8" -#: src/bare-metal/aps/better-uart.md:13 +#: src/bare-metal/aps/better-uart.md msgid "0x24" msgstr "0x24" -#: src/bare-metal/aps/better-uart.md:13 +#: src/bare-metal/aps/better-uart.md msgid "IBRD" msgstr "IBRD" -#: src/bare-metal/aps/better-uart.md:13 src/bare-metal/aps/better-uart.md:16 +#: src/bare-metal/aps/better-uart.md msgid "16" msgstr "16" -#: src/bare-metal/aps/better-uart.md:14 +#: src/bare-metal/aps/better-uart.md msgid "0x28" msgstr "0x28" -#: src/bare-metal/aps/better-uart.md:14 +#: src/bare-metal/aps/better-uart.md msgid "FBRD" msgstr "FBRD" -#: src/bare-metal/aps/better-uart.md:14 src/bare-metal/aps/better-uart.md:17 +#: src/bare-metal/aps/better-uart.md msgid "6" msgstr "6" -#: src/bare-metal/aps/better-uart.md:15 +#: src/bare-metal/aps/better-uart.md msgid "0x2c" msgstr "0x2c" -#: src/bare-metal/aps/better-uart.md:15 +#: src/bare-metal/aps/better-uart.md msgid "LCR_H" msgstr "LCR_H" -#: src/bare-metal/aps/better-uart.md:16 +#: src/bare-metal/aps/better-uart.md msgid "0x30" msgstr "0x30" -#: src/bare-metal/aps/better-uart.md:16 +#: src/bare-metal/aps/better-uart.md msgid "CR" msgstr "CR" -#: src/bare-metal/aps/better-uart.md:17 +#: src/bare-metal/aps/better-uart.md msgid "0x34" msgstr "0x34" -#: src/bare-metal/aps/better-uart.md:17 +#: src/bare-metal/aps/better-uart.md msgid "IFLS" msgstr "IFLS" -#: src/bare-metal/aps/better-uart.md:18 +#: src/bare-metal/aps/better-uart.md msgid "0x38" msgstr "0x38" -#: src/bare-metal/aps/better-uart.md:18 +#: src/bare-metal/aps/better-uart.md msgid "IMSC" msgstr "IMSC" -#: src/bare-metal/aps/better-uart.md:18 src/bare-metal/aps/better-uart.md:19 -#: src/bare-metal/aps/better-uart.md:20 src/bare-metal/aps/better-uart.md:21 +#: src/bare-metal/aps/better-uart.md msgid "11" msgstr "11" -#: src/bare-metal/aps/better-uart.md:19 +#: src/bare-metal/aps/better-uart.md msgid "0x3c" msgstr "0x3c" -#: src/bare-metal/aps/better-uart.md:19 +#: src/bare-metal/aps/better-uart.md msgid "RIS" msgstr "RIS" -#: src/bare-metal/aps/better-uart.md:20 +#: src/bare-metal/aps/better-uart.md msgid "0x40" msgstr "0x40" -#: src/bare-metal/aps/better-uart.md:20 +#: src/bare-metal/aps/better-uart.md msgid "MIS" msgstr "MIS" -#: src/bare-metal/aps/better-uart.md:21 +#: src/bare-metal/aps/better-uart.md msgid "0x44" msgstr "0x44" -#: src/bare-metal/aps/better-uart.md:21 +#: src/bare-metal/aps/better-uart.md msgid "ICR" msgstr "ICR" -#: src/bare-metal/aps/better-uart.md:22 +#: src/bare-metal/aps/better-uart.md msgid "0x48" msgstr "0x48" -#: src/bare-metal/aps/better-uart.md:22 +#: src/bare-metal/aps/better-uart.md msgid "DMACR" msgstr "DMACR" -#: src/bare-metal/aps/better-uart.md:22 +#: src/bare-metal/aps/better-uart.md msgid "3" msgstr "3" -#: src/bare-metal/aps/better-uart.md:26 +#: src/bare-metal/aps/better-uart.md msgid "There are also some ID registers which have been omitted for brevity." msgstr "همچنین برخی از ID register هایی وجود دارد که برای اختصار حذف شده‌اند." -#: src/bare-metal/aps/better-uart/bitflags.md:3 +#: src/bare-metal/aps/better-uart/bitflags.md msgid "" "The [`bitflags`](https://crates.io/crates/bitflags) crate is useful for " "working with bitflags." @@ -18726,57 +18654,57 @@ msgstr "" "این crate برای [`bitflags`](https://crates.io/crates/bitflags) جهت کار با " "bitflags مفید است." -#: src/bare-metal/aps/better-uart/bitflags.md:10 +#: src/bare-metal/aps/better-uart/bitflags.md #, fuzzy msgid "/// Flags from the UART flag register.\n" msgstr "/// Flags from the UART flag register.\n" -#: src/bare-metal/aps/better-uart/bitflags.md:14 +#: src/bare-metal/aps/better-uart/bitflags.md #, fuzzy msgid "/// Clear to send.\n" msgstr "/// Clear to send.\n" -#: src/bare-metal/aps/better-uart/bitflags.md:16 +#: src/bare-metal/aps/better-uart/bitflags.md #, fuzzy msgid "/// Data set ready.\n" msgstr "/// Data set ready.\n" -#: src/bare-metal/aps/better-uart/bitflags.md:18 +#: src/bare-metal/aps/better-uart/bitflags.md #, fuzzy msgid "/// Data carrier detect.\n" msgstr "/// Data carrier detect.\n" -#: src/bare-metal/aps/better-uart/bitflags.md:20 +#: src/bare-metal/aps/better-uart/bitflags.md #, fuzzy msgid "/// UART busy transmitting data.\n" msgstr "/// UART busy transmitting data.\n" -#: src/bare-metal/aps/better-uart/bitflags.md:22 +#: src/bare-metal/aps/better-uart/bitflags.md #, fuzzy msgid "/// Receive FIFO is empty.\n" msgstr "/// Receive FIFO is empty.\n" -#: src/bare-metal/aps/better-uart/bitflags.md:24 +#: src/bare-metal/aps/better-uart/bitflags.md #, fuzzy msgid "/// Transmit FIFO is full.\n" msgstr "/// Transmit FIFO is full.\n" -#: src/bare-metal/aps/better-uart/bitflags.md:26 +#: src/bare-metal/aps/better-uart/bitflags.md #, fuzzy msgid "/// Receive FIFO is full.\n" msgstr "/// Receive FIFO is full.\n" -#: src/bare-metal/aps/better-uart/bitflags.md:28 +#: src/bare-metal/aps/better-uart/bitflags.md #, fuzzy msgid "/// Transmit FIFO is empty.\n" msgstr "/// Transmit FIFO is empty.\n" -#: src/bare-metal/aps/better-uart/bitflags.md:30 +#: src/bare-metal/aps/better-uart/bitflags.md #, fuzzy msgid "/// Ring indicator.\n" msgstr "/// Ring indicator.\n" -#: src/bare-metal/aps/better-uart/bitflags.md:38 +#: 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." @@ -18784,18 +18712,18 @@ msgstr "" "ماکرو `bitflags!` یک نوع جدید چیزی مانند`Flags(u16)` را به همراه تعدادی " "پیاده‌سازی متد برای دریافت و تنظیم flagها ایجاد می‌کند." -#: src/bare-metal/aps/better-uart/registers.md:1 +#: src/bare-metal/aps/better-uart/registers.md msgid "Multiple registers" msgstr "رجیستر چندگانه" -#: src/bare-metal/aps/better-uart/registers.md:3 +#: 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 "" "ما می‌توانیم از یک ساختار برای نمایش طرح memory layout یک رجیستر UART استفاده " "کنیم." -#: src/bare-metal/aps/better-uart/registers.md:43 +#: 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, " @@ -18810,17 +18738,16 @@ msgstr "" "اجازه می دهد تا (از جمله موارد دیگر) فیلدها را به هر نحوی که صلاح بداند مرتب " "کند." -#: src/bare-metal/aps/better-uart/driver.md:3 +#: 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:6 +#: src/bare-metal/aps/better-uart/driver.md #, fuzzy msgid "/// Driver for a PL011 UART.\n" msgstr "/// Driver for a PL011 UART.\n" -#: src/bare-metal/aps/better-uart/driver.md:30 -#: src/bare-metal/aps/better-uart/driver.md:56 +#: src/bare-metal/aps/better-uart/driver.md #, fuzzy msgid "" "// SAFETY: We know that self.registers points to the control registers\n" @@ -18829,7 +18756,7 @@ msgstr "" "// SAFETY: We know that self.registers points to the control registers\n" " // of a PL011 device which is appropriately mapped.\n" -#: src/bare-metal/aps/better-uart/driver.md:41 +#: src/bare-metal/aps/better-uart/driver.md #, fuzzy msgid "" "/// Reads and returns a pending byte, or `None` if nothing has been\n" @@ -18839,7 +18766,7 @@ msgstr "" " /// received.\n" "\n" -#: src/bare-metal/aps/better-uart/driver.md:47 +#: src/bare-metal/aps/better-uart/driver.md #, fuzzy msgid "" "// SAFETY: We know that self.registers points to the control\n" @@ -18848,12 +18775,12 @@ msgstr "" "// SAFETY: We know that self.registers points to the control\n" " // registers of a PL011 device which is appropriately mapped.\n" -#: src/bare-metal/aps/better-uart/driver.md:50 +#: src/bare-metal/aps/better-uart/driver.md #, fuzzy msgid "// TODO: Check for error conditions in bits 8-11.\n" msgstr "// TODO: Check for error conditions in bits 8-11.\n" -#: src/bare-metal/aps/better-uart/driver.md:65 +#: 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." @@ -18861,12 +18788,11 @@ msgstr "" "به استفاده از `addr_of!` / `addr_of_mut!` برای دریافت pointerها به فیلدهای " "جداگانه بدون ایجاد یک reference میانی توجه کنید، که ممکن است نادرست باشد." -#: src/bare-metal/aps/better-uart/using.md:1 -#: src/bare-metal/aps/logging/using.md:1 +#: 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:3 +#: 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." @@ -18874,16 +18800,14 @@ msgstr "" "بیایید یک برنامه کوچک با استفاده از درایور خود بنویسیم تا روی کنسول سریال " "بنویسیم و بایت‌های ورودی را echo کنیم." -#: src/bare-metal/aps/better-uart/using.md:19 -#: src/bare-metal/aps/logging/using.md:18 -#: src/exercises/bare-metal/solutions-afternoon.md:33 +#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Base address of the primary PL011 UART.\n" msgstr "/// Base address of the primary PL011 UART.\n" -#: src/bare-metal/aps/better-uart/using.md:25 -#: src/bare-metal/aps/logging/using.md:24 -#: src/exercises/bare-metal/solutions-afternoon.md:44 +#: 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" @@ -18892,29 +18816,28 @@ msgstr "" "// SAFETY: `PL011_BASE_ADDRESS` is the base address of a PL011 device, and\n" " // nothing else accesses that address range.\n" -#: src/bare-metal/aps/better-uart/using.md:29 -#: src/bare-metal/aps/logging/using.md:29 +#: 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:35 +#: src/bare-metal/aps/better-uart/using.md msgid "b'\\r'" msgstr "b'\\r'" -#: src/bare-metal/aps/better-uart/using.md:36 -#: src/concurrency/async-pitfalls/cancellation.md:27 +#: 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:38 +#: src/bare-metal/aps/better-uart/using.md msgid "b'q'" msgstr "b'q'" -#: src/bare-metal/aps/better-uart/using.md:44 +#: src/bare-metal/aps/better-uart/using.md msgid "\"Bye!\"" msgstr "\"Bye!\"" -#: src/bare-metal/aps/better-uart/using.md:51 +#: 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 " @@ -18924,14 +18847,14 @@ msgstr "" "از کد نقطه ورودی ما در `entry.S` فراخوانی می‌شود. برای جزئیات بیشتر، " "یادداشت‌های سخنرانی‌ها را در آنجا ببینید." -#: src/bare-metal/aps/better-uart/using.md:54 +#: src/bare-metal/aps/better-uart/using.md msgid "" "Run the example in QEMU with `make qemu` under `src/bare-metal/aps/examples`." msgstr "" "مثال را در QEMU با `make qemu` در زیر `src/bare-metal/aps/examples` اجرا " "کنید." -#: src/bare-metal/aps/logging.md:3 +#: 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 " @@ -18941,16 +18864,16 @@ msgstr "" "crates/log) استفاده کنید. ما می‌توانیم این کار را با اجرای ویژگی `Log` انجام " "دهیم." -#: src/bare-metal/aps/logging.md:26 +#: src/bare-metal/aps/logging.md msgid "\"[{}] {}\"" msgstr "\"[{}] {}\"" -#: src/bare-metal/aps/logging.md:35 +#: src/bare-metal/aps/logging.md #, fuzzy msgid "/// Initialises UART logger.\n" msgstr "/// Initialises UART logger.\n" -#: src/bare-metal/aps/logging.md:48 +#: src/bare-metal/aps/logging.md msgid "" "The unwrap in `log` is safe because we initialise `LOGGER` before calling " "`set_logger`." @@ -18958,21 +18881,21 @@ msgstr "" "باز کردن در`log` ایمن است زیرا `LOGGER` را قبل از فراخوانی `set_logger` " "مقداردهی اولیه می‌کنیم." -#: src/bare-metal/aps/logging/using.md:3 +#: src/bare-metal/aps/logging/using.md msgid "We need to initialise the logger before we use it." msgstr "قبل از استفاده از لاگر باید مقداردهی اولیه کنیم." -#: src/bare-metal/aps/logging/using.md:38 -#: src/exercises/bare-metal/solutions-afternoon.md:115 +#: 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:46 +#: src/bare-metal/aps/logging/using.md msgid "Note that our panic handler can now log details of panics." msgstr "" "توجه داشته باشید که panic handler ما اکنون می تواند جزئیات panic را ثبت کند." -#: src/bare-metal/aps/logging/using.md:47 +#: src/bare-metal/aps/logging/using.md msgid "" "Run the example in QEMU with `make qemu_logger` under `src/bare-metal/aps/" "examples`." @@ -18980,7 +18903,7 @@ msgstr "" "مثال را در QEMU با `make qemu_logger` در زیر `src/bare-metal/aps/examples` " "اجرا کنید." -#: src/bare-metal/aps/exceptions.md:3 +#: 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 " @@ -18994,12 +18917,12 @@ msgstr "" "این کار را در اسمبلی پیاده‌سازی می‌کنیم تا رجیسترهای فرار (volatile) را قبل از " "فراخوانی Rust در stack ذخیره کنیم:" -#: src/bare-metal/aps/exceptions.md:67 +#: 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:68 +#: 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." @@ -19007,7 +18930,7 @@ msgstr "" "برای سادگی، ما بین SP0 و SPx برای استثناهای EL فعلی، یا بین AArch32 و " "AArch64 برای استثناهای پایین EL تمایز قائل نمی‌شویم." -#: src/bare-metal/aps/exceptions.md:70 +#: 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." @@ -19015,7 +18938,7 @@ msgstr "" "برای این مثال، ما فقط exception را log کرده و سپس خاموش می‌کنیم، زیرا انتظار " "نداریم هیچ یک از آنها واقعاً اتفاق بیفتد." -#: src/bare-metal/aps/exceptions.md:72 +#: src/bare-metal/aps/exceptions.md #, fuzzy msgid "" "We can think of exception handlers and our main execution context more or " @@ -19033,24 +18956,24 @@ msgstr "" "`Sync` نیست، باید آن را در چیزی مانند`Mutex` محصور کرده و یک استاتیک در آن " "قرار دهیم." -#: src/bare-metal/aps/other-projects.md:3 +#: 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:4 +#: src/bare-metal/aps/other-projects.md #, fuzzy msgid "\"coreboot without the C\"" msgstr "\"coreboot without the C\"" -#: src/bare-metal/aps/other-projects.md:5 +#: 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:6 +#: 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:7 +#: src/bare-metal/aps/other-projects.md msgid "" "[Rust RaspberryPi OS tutorial](https://github.com/rust-embedded/rust-" "raspberrypi-OS-tutorials)" @@ -19058,7 +18981,7 @@ msgstr "" "[Rust RaspberryPi OS tutorial](https://github.com/rust-embedded/rust-" "raspberrypi-OS-tutorials)" -#: src/bare-metal/aps/other-projects.md:8 +#: src/bare-metal/aps/other-projects.md msgid "" "Initialisation, UART driver, simple bootloader, JTAG, exception levels, " "exception handling, page tables" @@ -19066,7 +18989,7 @@ msgstr "" "راه‌اندازی، درایور UART و bootloader ساده، JTAG، سطوح exception، مدیریت " "exception و page tableها" -#: src/bare-metal/aps/other-projects.md:10 +#: 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." @@ -19074,15 +18997,15 @@ msgstr "" "برخی ابهامات در مورد نگهداری کَش و راه‌اندازی اولیه در Rust، لزوماً مثال خوبی " "برای کپی کردن برای کد production نیست." -#: src/bare-metal/aps/other-projects.md:12 +#: 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:13 +#: src/bare-metal/aps/other-projects.md msgid "Static analysis to determine maximum stack usage." msgstr "تجزیه‌و‌تحلیل استاتیک برای تعیین حداکثر استفاده از stack." -#: src/bare-metal/aps/other-projects.md:17 +#: 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:" @@ -19091,7 +19014,7 @@ msgstr "" "می‌کند. این کار memory را می‌خواند و روی آن می‌نویسد (به عنوان مثال stack). " "بااین‌حال:" -#: src/bare-metal/aps/other-projects.md:19 +#: src/bare-metal/aps/other-projects.md #, fuzzy msgid "" "Without the MMU and cache, unaligned accesses will fault. It builds with " @@ -19104,7 +19027,7 @@ msgstr "" "ایجاد دسترسی‌های غیرهمتراز توسط کامپایلر جلوگیری کند، بنابراین همیشه باید " "صحیح باشد، اما لزوماً اینطور نیست." -#: src/bare-metal/aps/other-projects.md:23 +#: src/bare-metal/aps/other-projects.md #, fuzzy msgid "" "If it were running in a VM, this can lead to cache coherency issues. The " @@ -19135,7 +19058,7 @@ msgstr "" "ما به چند crate می‌پردازیم که برخی از مشکلات رایج در برنامه‌نویسی bare-metal " "را حل می‌کند." -#: src/bare-metal/useful-crates/zerocopy.md:3 +#: 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 " @@ -19144,7 +19067,7 @@ msgstr "" "این crate [`zerocopy`](https://docs.rs/zerocopy/) (از Fuchsia) صفات و " "ماکروهایی را برای تبدیل ایمن بین دنباله‌های بایت و انواع دیگر فراهم می‌کند." -#: src/bare-metal/useful-crates/zerocopy.md:42 +#: 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 " @@ -19154,7 +19077,7 @@ msgstr "" "نمی‌کند)، اما می‌تواند برای کار با ساختارهای مشترک با سخت افزار مفید باشد. " "توسط DMA، یا از طریق برخی از رابط‌های خارجی ارسال می‌شود." -#: src/bare-metal/useful-crates/zerocopy.md:48 +#: 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." @@ -19163,7 +19086,7 @@ msgstr "" "پیاده‌سازی کرد و بنابراین می‌توان با خیال راحت از یک دنباله بایت‌های نامعتبر " "تبدیل کرد." -#: src/bare-metal/useful-crates/zerocopy.md:50 +#: 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 " @@ -19173,14 +19096,14 @@ msgstr "" "`RequestType` از همه مقادیر ممکن u32 به عنوان متمایزکننده استفاده نمی‌کند، " "بنابراین همه الگوهای بایت معتبر نیستند." -#: src/bare-metal/useful-crates/zerocopy.md:53 +#: src/bare-metal/useful-crates/zerocopy.md #, fuzzy msgid "" "`zerocopy::byteorder` has types for byte-order aware numeric primitives." msgstr "" "‏ `zerocopy::byteorder` دارای تایپ‌های برای اعداد اولیه مطلع از byte-order است." -#: src/bare-metal/useful-crates/zerocopy.md:54 +#: 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 " @@ -19189,7 +19112,7 @@ msgstr "" "مثال را با `cargo run` در `src/bare-metal/useful-crates/zerocopy-example/" "`اجرا کنید. (به دلیل وابستگی به crate در Playground اجرا نمی‌شود.)" -#: src/bare-metal/useful-crates/aarch64-paging.md:3 +#: 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 " @@ -19199,22 +19122,22 @@ msgstr "" "امکان می‌دهد page tableها را مطابق با معماری سیستم حافظه‌مجازی AArch64 ایجاد " "کنید." -#: src/bare-metal/useful-crates/aarch64-paging.md:14 +#: src/bare-metal/useful-crates/aarch64-paging.md #, fuzzy msgid "// Create a new page table with identity mapping.\n" msgstr "// Create a new page table with identity mapping.\n" -#: src/bare-metal/useful-crates/aarch64-paging.md:16 +#: src/bare-metal/useful-crates/aarch64-paging.md #, fuzzy msgid "// Map a 2 MiB region of memory as read-only.\n" msgstr "// Map a 2 MiB region of memory as read-only.\n" -#: src/bare-metal/useful-crates/aarch64-paging.md:21 +#: src/bare-metal/useful-crates/aarch64-paging.md #, fuzzy msgid "// Set `TTBR0_EL1` to activate the page table.\n" msgstr "// Set `TTBR0_EL1` to activate the page table.\n" -#: src/bare-metal/useful-crates/aarch64-paging.md:28 +#: 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." @@ -19222,7 +19145,7 @@ msgstr "" "در حال حاضر فقط از EL1 پشتیبانی می‌کند، اما پشتیبانی از سایر سطوح استثنا باید " "ساده باشد." -#: src/bare-metal/useful-crates/aarch64-paging.md:30 +#: 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/" @@ -19232,7 +19155,7 @@ msgstr "" "android/platform/superproject/+/master:packages/modules/Virtualization/" "pvmfw/) استفاده می‌شود." -#: src/bare-metal/useful-crates/aarch64-paging.md:31 +#: 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." @@ -19240,7 +19163,7 @@ msgstr "" "هیچ راه آسانی برای اجرای این مثال وجود ندارد، زیرا باید روی سخت‌افزار واقعی " "یا تحت QEMU اجرا شود." -#: src/bare-metal/useful-crates/buddy_system_allocator.md:3 +#: 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 " @@ -19261,11 +19184,11 @@ msgstr "" "استفاده کنید. به عنوان مثال، ممکن است بخواهیم فضای MMIO را برای PCI BARها " "اختصاص دهیم:" -#: src/bare-metal/useful-crates/buddy_system_allocator.md:29 +#: 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:30 +#: 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 " @@ -19274,7 +19197,7 @@ msgstr "" "مثال را با `cargo run` در `src/bare-metal/useful-crates/allocator-example/` " "اجرا کنید. (به دلیل وابستگی به crate در Playground اجرا نمی‌شود.)" -#: src/bare-metal/useful-crates/tinyvec.md:3 +#: 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 " @@ -19289,21 +19212,21 @@ msgstr "" "شده را ردیابی می‌کند و اگر سعی کنید بیشتر از آنچه که اختصاص‌داده‌شده را استفاده " "کنید panic می‌کند." -#: src/bare-metal/useful-crates/tinyvec.md:25 +#: 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:27 +#: 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:3 +#: 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 " @@ -19313,7 +19236,7 @@ msgstr "" "`alloc` موجود نیستند. چگونه می‌توانیم هماهنگ‌سازی یا تغییرپذیری داخلی، مانند " "اشتراک‌گذاری وضعیت بین CPU‌های مختلف را مدیریت کنیم؟" -#: src/bare-metal/useful-crates/spin.md:7 +#: 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." @@ -19321,13 +19244,13 @@ msgstr "" "این crate [`spin`](https://crates.io/crates/spin) معادل‌های مبتنی بر " "spinlock، بسیاری از این موارد اولیه را ارائه می‌کند." -#: src/bare-metal/useful-crates/spin.md:26 +#: src/bare-metal/useful-crates/spin.md msgid "Be careful to avoid deadlock if you take locks in interrupt handlers." msgstr "" "اگر در handlerهای وقفه قفل می‌کنید مراقب باشید که از بن بست(deadlock) جلوگیری " "کنید." -#: src/bare-metal/useful-crates/spin.md:27 +#: src/bare-metal/useful-crates/spin.md msgid "" "`spin` also has a ticket lock mutex implementation; equivalents of `RwLock`, " "`Barrier` and `Once` from `std::sync`; and `Lazy` for lazy initialisation." @@ -19335,7 +19258,7 @@ msgstr "" "‏ `spin` همچنین دارای اجرای ticket lock mutex است. معادل‌های `RwLock`, " "`Barrier` و `Once` از `std::sync`. و `Lazy` برای مقداردهی اولیه lazy." -#: src/bare-metal/useful-crates/spin.md:29 +#: 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 " @@ -19345,7 +19268,7 @@ msgstr "" "تایپ‌های مفیدی برای مقداردهی اولیه دیرهنگام با رویکرد کمی متفاوت به `spin::" "once::Once` است." -#: src/bare-metal/useful-crates/spin.md:31 +#: src/bare-metal/useful-crates/spin.md msgid "" "The Rust Playground includes `spin`, so this example will run fine inline." msgstr "" @@ -19364,16 +19287,17 @@ msgstr "" "script برای تولید binary استفاده کرده و سپس از یک `raw_binary` برای تبدیل " "ELF به یک raw binary آماده اجرا استفاده کنید." -#: src/bare-metal/android/vmbase.md:1 +#: src/bare-metal/android/vmbase.md msgid "vmbase" msgstr "vmbase" -#: src/bare-metal/android/vmbase.md:3 +#: 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/" -"master/vmbase/) library provides a linker script and useful defaults for the " -"build rules, along with an entry point, UART console logging and more." +"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 "" "برای ماشین‌های مجازی که تحت crosvm در aarch64 اجرا می‌شوند، کتابخانه [vmbase]" "(https://android.googlesource.com/platform/packages/modules/Virtualization/+/" @@ -19381,7 +19305,7 @@ msgstr "" "می‌کند. برای این قوانین ساخت، همراه با یک نقطه ورودی، UART console logging و " "موارد دیگر." -#: src/bare-metal/android/vmbase.md:24 +#: src/bare-metal/android/vmbase.md msgid "" "The `main!` macro marks your main function, to be called from the `vmbase` " "entry point." @@ -19389,7 +19313,7 @@ msgstr "" "این ماکرو `main!`عملکرد اصلی شما را مشخص می‌کند تا از نقطه ورودی `vmbase` " "فراخوانی شود." -#: src/bare-metal/android/vmbase.md:26 +#: 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." @@ -19409,12 +19333,12 @@ msgstr "" "پس از بررسی تمرین‌ها، می‌توانید به [راه‌حل ها](solutions-afternoon.md) ارائه " "شده نگاهی بیندازید." -#: src/exercises/bare-metal/rtc.md:1 -#: src/exercises/bare-metal/solutions-afternoon.md:3 +#: src/exercises/bare-metal/rtc.md +#: src/exercises/bare-metal/solutions-afternoon.md msgid "RTC driver" msgstr "RTC driver" -#: src/exercises/bare-metal/rtc.md:3 +#: src/exercises/bare-metal/rtc.md #, fuzzy msgid "" "The QEMU aarch64 virt machine has a [PL031](https://developer.arm.com/" @@ -19425,7 +19349,7 @@ msgstr "" "com/documentation/ddi0224/c) در 0x9010000 است. برای این تمرین باید یک درایور " "برای آن بنویسید." -#: src/exercises/bare-metal/rtc.md:6 +#: 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." @@ -19434,7 +19358,7 @@ msgstr "" "[`chrono`](https://crates.io/crates/chrono) برای قالب‌بندی date/time استفاده " "کنید." -#: src/exercises/bare-metal/rtc.md:8 +#: src/exercises/bare-metal/rtc.md #, fuzzy msgid "" "Use the match register and raw interrupt status to busy-wait until a given " @@ -19445,7 +19369,7 @@ msgstr "" "بمانید، به عنوان مثال. ۳ ثانیه در آینده نزدیک (Call [`core::hint::spin_loop`]" "(https://doc.rust-lang.org/core/hint/fn.spin_loop.html) inside the loop.)" -#: src/exercises/bare-metal/rtc.md:11 +#: 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://" @@ -19456,11 +19380,11 @@ msgstr "" "docs.rs/arm-gic/) برای پیکربندی Arm Generic Interrupt Controller استفاده " "کنید." -#: src/exercises/bare-metal/rtc.md:14 +#: src/exercises/bare-metal/rtc.md msgid "Use the RTC interrupt, which is wired to the GIC as `IntId::spi(2)`." msgstr "از وقفه RTC استفاده کنید که به عنوان `IntId::spi(2)` به GIC متصل است." -#: src/exercises/bare-metal/rtc.md:15 +#: 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." @@ -19469,7 +19393,7 @@ msgstr "" "wfi()` به حالت Sleep درآورید، که باعث می‌شود هسته تا زمانی که وقفه دریافت کند " "به خواب برود." -#: src/exercises/bare-metal/rtc.md:19 +#: 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." @@ -19477,83 +19401,83 @@ msgstr "" "دانلود از [exercise template](../../comprehensive-rust-exercises.zip) و " "فایل‌های زیر را در دایرکتوری `rtc` جستجو کنید." -#: src/exercises/bare-metal/rtc.md:79 +#: 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_ (شما فقط باید این را برای بخش سوم تمرین تغییر دهید):" -#: src/exercises/bare-metal/rtc.md:156 +#: 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:216 +#: 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:419 +#: 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:456 +#: 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:606 +#: 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:792 +#: src/exercises/bare-metal/rtc.md msgid "_idmap.S_ (you shouldn't need to change this):" msgstr "_idmap.S_ (نیازی نیست این مورد را تغییر دهید):" -#: src/exercises/bare-metal/rtc.md:842 +#: 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:954 +#: src/exercises/bare-metal/rtc.md msgid "_Makefile_ (you shouldn't need to change this):" msgstr "_Makefile_ (نیازی نیست این مورد را تغییر دهید):" -#: src/exercises/bare-metal/rtc.md:1011 +#: src/exercises/bare-metal/rtc.md msgid "Run the code in QEMU with `make qemu`." msgstr "کد را در QEMU با `make qemu` اجرا کنید." -#: src/exercises/bare-metal/solutions-afternoon.md:1 +#: src/exercises/bare-metal/solutions-afternoon.md msgid "Bare Metal Rust Afternoon" msgstr "بعدازظهربا Bare Metal Rust" -#: src/exercises/bare-metal/solutions-afternoon.md:5 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "([back to exercise](rtc.md))" msgstr "([back to exercise](rtc.md))" -#: src/exercises/bare-metal/solutions-afternoon.md:7 +#: src/exercises/bare-metal/solutions-afternoon.md msgid "_main.rs_:" msgstr "_main.rs_:" -#: src/exercises/bare-metal/solutions-afternoon.md:29 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Base addresses of the GICv3.\n" msgstr "/// Base addresses of the GICv3.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:36 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Base address of the PL031 RTC.\n" msgstr "/// Base address of the PL031 RTC.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:38 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// The IRQ used by the PL031 RTC.\n" msgstr "/// The IRQ used by the PL031 RTC.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:49 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "\"main({:#x}, {:#x}, {:#x}, {:#x})\"" msgstr "\"main({:#x}, {:#x}, {:#x}, {:#x})\"" -#: src/exercises/bare-metal/solutions-afternoon.md:51 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "" "// SAFETY: `GICD_BASE_ADDRESS` and `GICR_BASE_ADDRESS` are the base\n" @@ -19564,7 +19488,7 @@ msgstr "" " // addresses of a GICv3 distributor and redistributor respectively, and\n" " // nothing else accesses those address ranges.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:57 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "" "// SAFETY: `PL031_BASE_ADDRESS` is the base address of a PL031 device, and\n" @@ -19573,91 +19497,86 @@ msgstr "" "// SAFETY: `PL031_BASE_ADDRESS` is the base address of a PL031 device, and\n" " // nothing else accesses that address range.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:62 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "\"RTC: {time}\"" msgstr "\"RTC: {time}\"" -#: src/exercises/bare-metal/solutions-afternoon.md:70 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "// Wait for 3 seconds, without interrupts.\n" msgstr "// Wait for 3 seconds, without interrupts.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:73 -#: src/exercises/bare-metal/solutions-afternoon.md:91 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "\"Waiting for {}\"" msgstr "\"Waiting for {}\"" -#: src/exercises/bare-metal/solutions-afternoon.md:75 -#: src/exercises/bare-metal/solutions-afternoon.md:83 -#: src/exercises/bare-metal/solutions-afternoon.md:96 -#: src/exercises/bare-metal/solutions-afternoon.md:104 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "\"matched={}, interrupt_pending={}\"" msgstr "\"matched={}, interrupt_pending={}\"" -#: src/exercises/bare-metal/solutions-afternoon.md:87 -#: src/exercises/bare-metal/solutions-afternoon.md:108 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "\"Finished waiting\"" msgstr "\"Finished waiting\"" -#: src/exercises/bare-metal/solutions-afternoon.md:89 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "// Wait another 3 seconds for an interrupt.\n" msgstr "// Wait another 3 seconds for an interrupt.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:121 +#: src/exercises/bare-metal/solutions-afternoon.md msgid "_pl031.rs_:" msgstr "_pl031.rs_:" -#: src/exercises/bare-metal/solutions-afternoon.md:128 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Data register\n" msgstr "/// Data register\n" -#: src/exercises/bare-metal/solutions-afternoon.md:130 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Match register\n" msgstr "/// Match register\n" -#: src/exercises/bare-metal/solutions-afternoon.md:132 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Load register\n" msgstr "/// Load register\n" -#: src/exercises/bare-metal/solutions-afternoon.md:134 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Control register\n" msgstr "/// Control register\n" -#: src/exercises/bare-metal/solutions-afternoon.md:137 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Interrupt Mask Set or Clear register\n" msgstr "/// Interrupt Mask Set or Clear register\n" -#: src/exercises/bare-metal/solutions-afternoon.md:140 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Raw Interrupt Status\n" msgstr "/// Raw Interrupt Status\n" -#: src/exercises/bare-metal/solutions-afternoon.md:143 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Masked Interrupt Status\n" msgstr "/// Masked Interrupt Status\n" -#: src/exercises/bare-metal/solutions-afternoon.md:146 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Interrupt Clear Register\n" msgstr "/// Interrupt Clear Register\n" -#: src/exercises/bare-metal/solutions-afternoon.md:150 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Driver for a PL031 real-time clock.\n" msgstr "/// Driver for a PL031 real-time clock.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:158 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "" "/// Constructs a new instance of the RTC driver for a PL031 device at the\n" @@ -19682,17 +19601,12 @@ msgstr "" "process\n" " /// as device memory and not have any other aliases.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:170 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Reads the current RTC value.\n" msgstr "/// Reads the current RTC value.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:172 -#: src/exercises/bare-metal/solutions-afternoon.md:180 -#: src/exercises/bare-metal/solutions-afternoon.md:188 -#: src/exercises/bare-metal/solutions-afternoon.md:199 -#: src/exercises/bare-metal/solutions-afternoon.md:211 -#: src/exercises/bare-metal/solutions-afternoon.md:218 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "" "// SAFETY: We know that self.registers points to the control registers\n" @@ -19701,7 +19615,7 @@ msgstr "" "// SAFETY: We know that self.registers points to the control registers\n" " // of a PL031 device which is appropriately mapped.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:177 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "" "/// Writes a match value. When the RTC value matches this then an interrupt\n" @@ -19710,7 +19624,7 @@ msgstr "" "/// Writes a match value. When the RTC value matches this then an interrupt\n" " /// will be generated (if it is enabled).\n" -#: src/exercises/bare-metal/solutions-afternoon.md:185 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "" "/// Returns whether the match register matches the RTC value, whether or " @@ -19721,7 +19635,7 @@ msgstr "" "not\n" " /// the interrupt is enabled.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:194 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "" "/// Returns whether there is currently an interrupt pending.\n" @@ -19734,7 +19648,7 @@ msgstr "" " /// This should be true if and only if `matched` returns true and the\n" " /// interrupt is masked.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:205 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "" "/// Sets or clears the interrupt mask.\n" @@ -19749,12 +19663,12 @@ msgstr "" "the\n" " /// interrupt is disabled.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:216 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "/// Clears a pending interrupt, if any.\n" msgstr "/// Clears a pending interrupt, if any.\n" -#: src/exercises/bare-metal/solutions-afternoon.md:223 +#: src/exercises/bare-metal/solutions-afternoon.md #, fuzzy msgid "" "// SAFETY: `Rtc` just contains a pointer to device memory, which can be\n" @@ -19823,43 +19737,45 @@ msgstr "" msgid "This segment should take about 30 minutes. It contains:" msgstr "این بخش باید حدود ۳۰ دقیقه طول بکشد و شامل موارد زیر است:" -#: src/concurrency/threads/plain.md:3 +#: src/concurrency/threads/plain.md msgid "Rust threads work similarly to threads in other languages:" msgstr " threadهای Rust مانند threadها در زبان‌های دیگر کار می‌کنند:" -#: src/concurrency/threads/plain.md:12 +#: src/concurrency/threads/plain.md msgid "\"Count in thread: {i}!\"" msgstr "\"شمارنده thread: {i}!\"" -#: src/concurrency/threads/plain.md:18 +#: src/concurrency/threads/plain.md msgid "\"Main thread: {i}\"" msgstr "\"Main thread: {i}\"" -#: src/concurrency/threads/plain.md:24 -msgid "Threads are all daemon threads, the main thread does not wait for them." -msgstr "‏Thread‌ها همه daemon thread هستند و main thread منتظر آنها نیست." +#: 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:25 +#: src/concurrency/threads/plain.md msgid "Thread panics are independent of each other." msgstr "Thread panicها مستقل از یکدیگر هستند." -#: src/concurrency/threads/plain.md:26 +#: src/concurrency/threads/plain.md msgid "Panics can carry a payload, which can be unpacked with `downcast_ref`." msgstr "" "‏Panicها می‌تواند payloadای را حمل کند که می‌توان آن را با «downcast_ref» باز " "کرد." -#: src/concurrency/threads/plain.md:31 +#: src/concurrency/threads/plain.md msgid "Rust thread APIs look not too different from e.g. C++ ones." msgstr "" "‏Rust thread API ها خیلی متفاوت از موارد دیگر به نظر نمی‌رسند. که C++ یکی از " "آن‌ها است." -#: src/concurrency/threads/plain.md:33 +#: src/concurrency/threads/plain.md msgid "Run the example." msgstr "مثال را اجرا کنید." -#: src/concurrency/threads/plain.md:34 +#: src/concurrency/threads/plain.md msgid "" "5ms timing is loose enough that main and spawned threads stay mostly in " "lockstep." @@ -19867,13 +19783,13 @@ msgstr "" "زمان‌بندی 5 میلی‌ثانیه به اندازه‌ای سست هستند که thread اصلی و spawned threadها " "عمدتاً همگام می‌مانند." -#: src/concurrency/threads/plain.md:36 +#: src/concurrency/threads/plain.md msgid "Notice that the program ends before the spawned thread reaches 10!" msgstr "" "توجه داشته باشید که برنامه قبل از اینکه thread spawned به مقدار ۱۰ برسد به " "پایان می‌رسد!" -#: src/concurrency/threads/plain.md:37 +#: src/concurrency/threads/plain.md msgid "" "This is because main ends the program and spawned threads do not make it " "persist." @@ -19881,15 +19797,15 @@ msgstr "" "این به خاطر است که انتهای main برنامه است و spawned threadها ایجاد شده باعث " "تداوم آن نمی‌شوند." -#: src/concurrency/threads/plain.md:39 +#: src/concurrency/threads/plain.md msgid "Compare to pthreads/C++ std::thread/boost::thread if desired." msgstr "در مقابسه با pthreads/C++ std::thread/boost::thread اگر مطلوب باشد." -#: src/concurrency/threads/plain.md:41 +#: src/concurrency/threads/plain.md msgid "How do we wait around for the spawned thread to complete?" msgstr "چقدر باید صبر کنیم تا یک spawned thread تکمیل شود؟" -#: src/concurrency/threads/plain.md:42 +#: src/concurrency/threads/plain.md msgid "" "[`thread::spawn`](https://doc.rust-lang.org/std/thread/fn.spawn.html) " "returns a `JoinHandle`. Look at the docs." @@ -19897,7 +19813,7 @@ msgstr "" "[`thread::spawn`](https://doc.rust-lang.org/std/thread/fn.spawn.html) " "returns a `JoinHandle`. به سند نگاه کنید." -#: src/concurrency/threads/plain.md:43 +#: 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." @@ -19905,7 +19821,7 @@ msgstr "" "`JoinHandle` دارد [`.join()`](https://doc.rust-lang.org/std/thread/struct." "JoinHandle.html#method.join) متد آن بلاک‌ها." -#: src/concurrency/threads/plain.md:45 +#: src/concurrency/threads/plain.md 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." @@ -19913,15 +19829,15 @@ msgstr "" "از «let handle = thread::spawn(...)» و بعد از «handle.join()» استفاده کنید " "تا منتظر بمانید تا thread تمام شود و شمارنده برنامه برابر با مقدار ۱۰ باشد." -#: src/concurrency/threads/plain.md:48 +#: src/concurrency/threads/plain.md msgid "Now what if we want to return a value?" msgstr "حالا اگر بخواهیم مقداری را برگردانیم چه؟" -#: src/concurrency/threads/plain.md:49 +#: src/concurrency/threads/plain.md msgid "Look at docs again:" msgstr "دوباره به اسناد نگاه کنید:" -#: src/concurrency/threads/plain.md:50 +#: src/concurrency/threads/plain.md msgid "" "[`thread::spawn`](https://doc.rust-lang.org/std/thread/fn.spawn.html)'s " "closure returns `T`" @@ -19929,7 +19845,7 @@ msgstr "" "[`thread::spawn`](https://doc.rust-lang.org/std/thread/fn.spawn.html)'s " "closure returns `T`" -#: src/concurrency/threads/plain.md:51 +#: src/concurrency/threads/plain.md msgid "" "`JoinHandle` [`.join()`](https://doc.rust-lang.org/std/thread/struct." "JoinHandle.html#method.join) returns `thread::Result`" @@ -19937,23 +19853,23 @@ msgstr "" "`JoinHandle` [`.join()`](https://doc.rust-lang.org/std/thread/struct." "JoinHandle.html#method.join) returns `thread::Result`" -#: src/concurrency/threads/plain.md:53 +#: src/concurrency/threads/plain.md msgid "" "Use the `Result` return value from `handle.join()` to get access to the " "returned value." msgstr "" "به کمک`Result` از «handle.join()» برای دسترسی به مقدار برگشتی استفاده کنید." -#: src/concurrency/threads/plain.md:56 +#: src/concurrency/threads/plain.md msgid "Ok, what about the other case?" msgstr "خوب، مورد دیگر چطور؟" -#: src/concurrency/threads/plain.md:57 +#: src/concurrency/threads/plain.md msgid "Trigger a panic in the thread. Note that this doesn't panic `main`." msgstr "" "فعال‌سازی یک panic در یک thread. توجه شود که این مورد panic `main` نیست." -#: src/concurrency/threads/plain.md:58 +#: src/concurrency/threads/plain.md msgid "" "Access the panic payload. This is a good time to talk about [`Any`](https://" "doc.rust-lang.org/std/any/index.html)." @@ -19961,30 +19877,30 @@ msgstr "" "دسترسی به این panic payload. بهترین زمان برای پرداخت به این موضوع است [`Any`]" "(https://doc.rust-lang.org/std/any/index.html)." -#: src/concurrency/threads/plain.md:60 +#: src/concurrency/threads/plain.md msgid "Now we can return values from threads! What about taking inputs?" msgstr "" "اکنون می‌توانیم مقادیر را از رشته‌ها برگردانیم! در مورد گرفتن ورودی‌ها چطور؟" -#: src/concurrency/threads/plain.md:61 +#: src/concurrency/threads/plain.md msgid "Capture something by reference in the thread closure." msgstr "چیزی را از طریق reference در بسته‌بندی thread ثبت کنید." -#: src/concurrency/threads/plain.md:62 +#: src/concurrency/threads/plain.md msgid "An error message indicates we must move it." msgstr "یک پیغام خطا نشان می‌دهد که باید آن را جابجا کنیم." -#: src/concurrency/threads/plain.md:63 +#: 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:65 +#: src/concurrency/threads/plain.md msgid "If we want to borrow?" msgstr "اگر بخواهیم قرض (borrow) بگیریم چطور؟" -#: src/concurrency/threads/plain.md:66 +#: src/concurrency/threads/plain.md msgid "" "Main kills child threads when it returns, but another function would just " "return and leave them running." @@ -19992,21 +19908,21 @@ msgstr "" " تابع ‏Main در هنگام بازگشت threadهای فرزند را از بین می‌برد، اما تابع دیگری " "return می‌شود و آنها را در حال اجرا می‌گذارد." -#: src/concurrency/threads/plain.md:68 +#: src/concurrency/threads/plain.md msgid "That would be stack use-after-return, which violates memory safety!" msgstr "" "این کار می‌تواند منجر به stack استفاده پس از return شود که memory safety را " "نقض می‌کند!" -#: src/concurrency/threads/plain.md:69 +#: src/concurrency/threads/plain.md msgid "How do we avoid this? see next slide." msgstr "چگونه از آن جلوگیری کنیم؟ صفحه بعدی را ببینید." -#: src/concurrency/threads/scoped.md:3 +#: src/concurrency/threads/scoped.md msgid "Normal threads cannot borrow from their environment:" msgstr "‏thread‌های معمولی نمی‌توانند از محیط خود قرض (borrow) بگیرند:" -#: src/concurrency/threads/scoped.md:20 +#: 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:" @@ -20014,7 +19930,7 @@ msgstr "" "به‌هرحال, می‌توانید برای این مورد [scoped thread](https://doc.rust-lang.org/" "std/thread/fn.scope.html) ببینید:" -#: src/concurrency/threads/scoped.md:41 +#: 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." @@ -20022,7 +19938,7 @@ msgstr "" "دلیل آن این است که وقتی تابع «thread::scope» کامل می‌شود، اتصال همه thread‌ها " "تضمین می‌شود، بنابراین می‌توانند داده‌های قرضی را برگردانند." -#: src/concurrency/threads/scoped.md:43 +#: 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." @@ -20035,74 +19951,68 @@ msgstr "" msgid "This segment should take about 20 minutes. It contains:" msgstr "" -#: src/concurrency/channels/senders-receivers.md:3 +#: 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 "" -#: src/concurrency/channels/senders-receivers.md:15 -#: src/concurrency/channels/senders-receivers.md:16 -#: src/concurrency/channels/senders-receivers.md:20 +#: src/concurrency/channels/senders-receivers.md msgid "\"Received: {:?}\"" msgstr "" -#: src/concurrency/channels/senders-receivers.md:27 +#: 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 "" -#: src/concurrency/channels/senders-receivers.md:30 +#: 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 "" -#: src/concurrency/channels/unbounded.md:3 +#: src/concurrency/channels/unbounded.md msgid "You get an unbounded and asynchronous channel with `mpsc::channel()`:" msgstr "" -#: src/concurrency/channels/unbounded.md:16 -#: src/concurrency/channels/bounded.md:16 +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md msgid "\"Message {i}\"" msgstr "" -#: src/concurrency/channels/unbounded.md:17 -#: src/concurrency/channels/bounded.md:17 +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md msgid "\"{thread_id:?}: sent Message {i}\"" msgstr "" -#: src/concurrency/channels/unbounded.md:19 -#: src/concurrency/channels/bounded.md:19 +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md msgid "\"{thread_id:?}: done\"" msgstr "" -#: src/concurrency/channels/unbounded.md:24 -#: src/concurrency/channels/bounded.md:24 +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md msgid "\"Main: got {msg}\"" msgstr "" -#: src/concurrency/channels/bounded.md:3 +#: src/concurrency/channels/bounded.md msgid "" "With bounded (synchronous) channels, `send` can block the current thread:" msgstr "" -#: src/concurrency/channels/bounded.md:32 +#: 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 "" -#: src/concurrency/channels/bounded.md:35 +#: src/concurrency/channels/bounded.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." msgstr "" -#: src/concurrency/channels/bounded.md:37 +#: src/concurrency/channels/bounded.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 `recv`." @@ -20116,7 +20026,7 @@ msgstr "ارسال" msgid "Sync" msgstr "همگام سازی" -#: src/concurrency/send-sync/marker-traits.md:3 +#: src/concurrency/send-sync/marker-traits.md msgid "" "How does Rust know to forbid shared access across threads? The answer is in " "two traits:" @@ -20124,7 +20034,7 @@ msgstr "" "‏ Rust چگونه می‌داند که دسترسی مشترک در سراسر threadها را ممنوع می‌کند؟ پاسخ در " "دو trait است:" -#: src/concurrency/send-sync/marker-traits.md:6 +#: 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." @@ -20132,7 +20042,7 @@ msgstr "" "‏[`Send`](https://doc.rust-lang.org/std/marker/trait.Send.html): در صورتی که " "جابجایی `T` در امتداد thread boundary ایمن باشد، تایپ `T` از جنس `Send` است." -#: src/concurrency/send-sync/marker-traits.md:8 +#: 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." @@ -20141,7 +20051,7 @@ msgstr "" "جابجایی یک `&T` در سراسر یک thread boundary ایمن باشد، یک تایپ `T` از جنس " "`Sync` است." -#: src/concurrency/send-sync/marker-traits.md:11 +#: src/concurrency/send-sync/marker-traits.md 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 " @@ -20153,7 +20063,7 @@ msgstr "" "دارای انواع `Send` و `Sync` باشند. شما همچنین می توانید آنها را به صورت دستی " "پیاده سازی کنید به‌خصوص زمانی که می دانید مقدار آن معتبر است." -#: src/concurrency/send-sync/marker-traits.md:22 +#: src/concurrency/send-sync/marker-traits.md msgid "" "One can think of these traits as markers that the type has certain thread-" "safety properties." @@ -20161,11 +20071,11 @@ msgstr "" "می‌توان این traitها را به عنوان نشانگرهایی در نظر گرفت که نوعی ویژگی thread-" "safety خاصی را دارد." -#: src/concurrency/send-sync/marker-traits.md:24 +#: src/concurrency/send-sync/marker-traits.md msgid "They can be used in the generic constraints as normal traits." msgstr "آنها را می‌توان در محدودیت‌های generic به عنوان trait عادی استفاده کرد." -#: src/concurrency/send-sync/send.md:3 +#: 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." @@ -20173,7 +20083,7 @@ msgstr "" "اگر انتقال مقدار `T` به thread دیگری امن باشد، تایپ `T` در [`Send`](https://" "doc.rust-lang.org/std/marker/trait.Send.html) است." -#: src/concurrency/send-sync/send.md:5 +#: 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 " @@ -20184,7 +20094,7 @@ msgstr "" "است که چه زمانی می‌توانید یک مقدار را در یک thread تخصیص دهید و آن را در " "thread دیگر توزیع کنید." -#: src/concurrency/send-sync/send.md:14 +#: src/concurrency/send-sync/send.md msgid "" "As an example, a connection to the SQLite library must only be accessed from " "a single thread." @@ -20192,7 +20102,7 @@ msgstr "" "به عنوان مثال، اتصال به کتابخانه SQLite فقط باید از یک thread قابل دسترسی " "باشد." -#: src/concurrency/send-sync/sync.md:3 +#: 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." @@ -20201,15 +20111,15 @@ msgstr "" "Sync.html) است، اگر در دسترسی به یک مقدار`T` از طریق چندین رشته به طور " "همزمان امن باشد." -#: src/concurrency/send-sync/sync.md:6 +#: src/concurrency/send-sync/sync.md msgid "More precisely, the definition is:" msgstr "به طور دقیق‌تر، تعریف این طور است:" -#: src/concurrency/send-sync/sync.md:8 +#: src/concurrency/send-sync/sync.md msgid "`T` is `Sync` if and only if `&T` is `Send`" msgstr "‏ `T` یک نوع `Sync` فقط و فقط زمانی که `&T` یک نوع `Send` باشد." -#: src/concurrency/send-sync/sync.md:15 +#: 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 " @@ -20219,7 +20129,7 @@ msgstr "" "استفاده مشترک امن باشد، انتقال ارجاعات (pass references) آن به threadها نیز " "امن است." -#: src/concurrency/send-sync/sync.md:19 +#: 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 " @@ -20233,45 +20143,45 @@ msgstr "" "نیز برای انتقال به threadای دیگر ایمن است، زیرا داده‌هایی که به آن ارجاع " "می‌دهد می‌توانند از هر threadای با خیال راحت دسترسی داشته باشند." -#: src/concurrency/send-sync/examples.md:3 +#: src/concurrency/send-sync/examples.md msgid "`Send + Sync`" msgstr "`Send + Sync`" -#: src/concurrency/send-sync/examples.md:5 +#: src/concurrency/send-sync/examples.md msgid "Most types you come across are `Send + Sync`:" msgstr "اکثر انواعی که با آنها روبرو می شوید `Send + Sync` هستند:" -#: src/concurrency/send-sync/examples.md:7 +#: src/concurrency/send-sync/examples.md msgid "`i8`, `f32`, `bool`, `char`, `&str`, ..." msgstr "`i8`, `f32`, `bool`, `char`, `&str`, ..." -#: src/concurrency/send-sync/examples.md:8 +#: src/concurrency/send-sync/examples.md msgid "`(T1, T2)`, `[T; N]`, `&[T]`, `struct { x: T }`, ..." msgstr "`i8`, `f32`, `bool`, `char`, `&str`, ..." -#: src/concurrency/send-sync/examples.md:9 +#: src/concurrency/send-sync/examples.md msgid "`String`, `Option`, `Vec`, `Box`, ..." msgstr "`(T1, T2)`, `[T; N]`, `&[T]`, `struct { x: T }`, ..." -#: src/concurrency/send-sync/examples.md:10 +#: src/concurrency/send-sync/examples.md msgid "`Arc`: Explicitly thread-safe via atomic reference count." msgstr "`String`, `Option`, `Vec`, `Box`, ..." -#: src/concurrency/send-sync/examples.md:11 +#: src/concurrency/send-sync/examples.md msgid "`Mutex`: Explicitly thread-safe via internal locking." msgstr "" "‏`Arc`:به طور صریح از طریق تعداد شمارش atomic reference با thread-safe." -#: src/concurrency/send-sync/examples.md:12 +#: src/concurrency/send-sync/examples.md msgid "`mpsc::Sender`: As of 1.72.0." msgstr "`mpsc::Sender`: از 1.72.0." -#: src/concurrency/send-sync/examples.md:13 +#: src/concurrency/send-sync/examples.md msgid "`AtomicBool`, `AtomicU8`, ...: Uses special atomic instructions." msgstr "" "‏`AtomicBool`، `AtomicU8`، ...: از دستورالعمل های atomic ویژه استفاده می‌کند." -#: src/concurrency/send-sync/examples.md:15 +#: src/concurrency/send-sync/examples.md msgid "" "The generic types are typically `Send + Sync` when the type parameters are " "`Send + Sync`." @@ -20279,11 +20189,11 @@ msgstr "" "در صورت وجود پارامترهای نوع، تایپ‌های generic معمولاً از نوع `Send + Sync` " "هستند.`Send + Sync`." -#: src/concurrency/send-sync/examples.md:18 +#: src/concurrency/send-sync/examples.md msgid "`Send + !Sync`" msgstr "`Send + !Sync`" -#: src/concurrency/send-sync/examples.md:20 +#: 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:" @@ -20291,48 +20201,52 @@ msgstr "" "این تایپ‌ها را می‌توان به رشته‌های دیگر منتقل کرد، اما آنها ایمن نیستند. به طور " "معمول به دلیل تغییرپذیری داخلی(interior mutability):" -#: src/concurrency/send-sync/examples.md:23 +#: src/concurrency/send-sync/examples.md msgid "`mpsc::Receiver`" msgstr "`mpsc::Receiver`" -#: src/concurrency/send-sync/examples.md:24 +#: src/concurrency/send-sync/examples.md msgid "`Cell`" msgstr "`Cell`" -#: src/concurrency/send-sync/examples.md:25 +#: src/concurrency/send-sync/examples.md msgid "`RefCell`" msgstr "`RefCell`" -#: src/concurrency/send-sync/examples.md:27 +#: src/concurrency/send-sync/examples.md msgid "`!Send + Sync`" msgstr "`!Send + Sync`" -#: src/concurrency/send-sync/examples.md:29 +#: src/concurrency/send-sync/examples.md +#, fuzzy msgid "" -"These types are thread-safe, but they cannot be moved to another thread:" +"These types are safe to access (via shared references) from multiple " +"threads, but they cannot be moved to another thread:" msgstr "" "این تایپ‌ها از نظر thread ایمن هستند، اما نمی توان آنها را به thread دیگری " "منتقل کرد:" -#: src/concurrency/send-sync/examples.md:31 +#: src/concurrency/send-sync/examples.md +#, fuzzy msgid "" "`MutexGuard`: Uses OS level primitives which must be deallocated on " -"the thread which created them." +"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 "" "‏«MutexGuard»: از ابتدایی‌های سطح سیستم‌عامل استفاده می‌کند که باید در " "threadای که آنها را ایجاد کرده است، توزیع شوند." -#: src/concurrency/send-sync/examples.md:34 +#: src/concurrency/send-sync/examples.md msgid "`!Send + !Sync`" msgstr "`!Send + !Sync`" -#: src/concurrency/send-sync/examples.md:36 +#: src/concurrency/send-sync/examples.md msgid "These types are not thread-safe and cannot be moved to other threads:" msgstr "" "این تایپ‌ها از نظر thread ایمن نیستند و نمی توان آنها را به رشته های دیگر " "منتقل کرد:" -#: src/concurrency/send-sync/examples.md:38 +#: src/concurrency/send-sync/examples.md msgid "" "`Rc`: each `Rc` has a reference to an `RcBox`, which contains a non-" "atomic reference count." @@ -20340,7 +20254,7 @@ msgstr "" "‏\"Rc\": هر \"Rc\" دارای یک ارجاع به \"RcBox\" است که حاوی تعداد " "مراجع غیر atomic است." -#: src/concurrency/send-sync/examples.md:40 +#: src/concurrency/send-sync/examples.md msgid "" "`*const T`, `*mut T`: Rust assumes raw pointers may have special concurrency " "considerations." @@ -20356,7 +20270,7 @@ msgstr "Arc" msgid "Mutex" msgstr "Mutex" -#: src/concurrency/shared-state/arc.md:3 +#: src/concurrency/shared-state/arc.md msgid "" "[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html) allows shared " "read-only access via `Arc::clone`:" @@ -20364,17 +20278,15 @@ msgstr "" "‏[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html) اجازه می‌دهد " "تا دسترسی read-only مشترک از طریق `Arc::clone` صورت پذیرد:" -#: src/concurrency/shared-state/arc.md:16 +#: src/concurrency/shared-state/arc.md msgid "\"{thread_id:?}: {v:?}\"" msgstr "\"{thread_id:?}: {v:?}\"" -#: src/concurrency/shared-state/arc.md:21 -#: src/concurrency/shared-state/example.md:17 -#: src/concurrency/shared-state/example.md:46 +#: src/concurrency/shared-state/arc.md src/concurrency/shared-state/example.md msgid "\"v: {v:?}\"" msgstr "\"v: {v:?}\"" -#: src/concurrency/shared-state/arc.md:30 +#: src/concurrency/shared-state/arc.md msgid "" "`Arc` stands for \"Atomic Reference Counted\", a thread safe version of `Rc` " "that uses atomic operations." @@ -20382,7 +20294,7 @@ msgstr "" "‏\"Arc\" مخفف \"Atomic Reference Counted\" است، یک نسخه ایمن از `Rc` که از " "عملیات atomic استفاده می‌کند." -#: src/concurrency/shared-state/arc.md:32 +#: src/concurrency/shared-state/arc.md msgid "" "`Arc` implements `Clone` whether or not `T` does. It implements `Send` " "and `Sync` if and only if `T` implements them both." @@ -20391,7 +20303,7 @@ msgstr "" "کند. `Send` و `Sync` را اگر و فقط در صورتی پیاده‌سازی می‌کند که `T` هر دوی " "آنها را پیاده‌سازی کند." -#: src/concurrency/shared-state/arc.md:34 +#: src/concurrency/shared-state/arc.md msgid "" "`Arc::clone()` has the cost of atomic operations that get executed, but " "after that the use of the `T` is free." @@ -20399,7 +20311,7 @@ msgstr "" "‏'Arc::clone()' هزینه عملیات atomic را دارد که اجرا می‌شود، اما پس از آن " "استفاده از `T` آزاد است." -#: src/concurrency/shared-state/arc.md:36 +#: src/concurrency/shared-state/arc.md msgid "" "Beware of reference cycles, `Arc` does not use a garbage collector to detect " "them." @@ -20407,11 +20319,11 @@ msgstr "" "مراقب reference cycleها باشید، `Arc` از garbage collector برای شناسایی آنها " "استفاده نمی‌کند." -#: src/concurrency/shared-state/arc.md:38 +#: src/concurrency/shared-state/arc.md msgid "`std::sync::Weak` can help." msgstr "`std::sync::Weak` می‌تواند مفید باشد." -#: src/concurrency/shared-state/mutex.md:3 +#: src/concurrency/shared-state/mutex.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 " @@ -20423,12 +20335,11 @@ msgstr "" "یکread-only interface (شکل دیگری از [تغییرپذیری (mutable) داخلی](../../" "borrowing/interior-mutability.md)) فراهم می‌کند." -#: src/concurrency/shared-state/mutex.md:12 -#: src/concurrency/shared-state/mutex.md:19 +#: src/concurrency/shared-state/mutex.md msgid "\"v: {:?}\"" msgstr "\"v: {:?}\"" -#: src/concurrency/shared-state/mutex.md:23 +#: src/concurrency/shared-state/mutex.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 " @@ -20438,7 +20349,7 @@ msgstr "" "lang.org/std/sync/struct.Mutex.html#impl-Sync-for-Mutex%3CT%3E) برای اجرای " "کامل آن داریم." -#: src/concurrency/shared-state/mutex.md:33 +#: src/concurrency/shared-state/mutex.md msgid "" "`Mutex` in Rust looks like a collection with just one element --- the " "protected data." @@ -20446,7 +20357,7 @@ msgstr "" "‏«Mutex» در Rust مانند مجموعه‌ای با تنها یک عنصر --- داده‌های محافظت شده " "(protected) به نظر می‌رسد." -#: src/concurrency/shared-state/mutex.md:35 +#: src/concurrency/shared-state/mutex.md msgid "" "It is not possible to forget to acquire the mutex before accessing the " "protected data." @@ -20454,7 +20365,7 @@ msgstr "" "نمی‌توان قبل از دسترسی به داده‌های محافظت شده یا protected، دسترسی mutex را " "فراموش کرد." -#: src/concurrency/shared-state/mutex.md:37 +#: 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." @@ -20462,7 +20373,7 @@ msgstr "" "با گرفتن lock می‌توانید `&mut T` را از `&Mutex` دریافت کنید.`MutexGuard` " "تضمین می‌کند که`&mut T` بیشتر از قفل نگه‌داشته شده، موجود نمی‌ماند." -#: src/concurrency/shared-state/mutex.md:39 +#: src/concurrency/shared-state/mutex.md msgid "" "`Mutex` implements both `Send` and `Sync` iff (if and only if) `T` " "implements `Send`." @@ -20470,15 +20381,15 @@ msgstr "" "‏`Mutex` هر دوی پیاده سازی `Send` و `Sync` iff (فقط و فقط) `T` از `Send` " "استفاده‌ می‌کنند." -#: src/concurrency/shared-state/mutex.md:41 +#: src/concurrency/shared-state/mutex.md msgid "A read-write lock counterpart: `RwLock`." msgstr "‏ همتای قفل خواندن و نوشتن: `RwLock`." -#: src/concurrency/shared-state/mutex.md:42 +#: src/concurrency/shared-state/mutex.md msgid "Why does `lock()` return a `Result`?" msgstr "چرا `lock()` یک`Result` برمی‌گرداند؟" -#: src/concurrency/shared-state/mutex.md:43 +#: 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 " @@ -20493,29 +20404,29 @@ msgstr "" "می‌توانید `into_inner()` را در مورد خطا برای بازیابی داده‌ها بدون توجه به آن " "فراخوانی کنید." -#: src/concurrency/shared-state/example.md:3 +#: src/concurrency/shared-state/example.md msgid "Let us see `Arc` and `Mutex` in action:" msgstr "اجازه دهید `Arc` و `Mutex` را در عمل ببینیم:" -#: src/concurrency/shared-state/example.md:6 +#: src/concurrency/shared-state/example.md msgid "// use std::sync::{Arc, Mutex};\n" msgstr "// use std::sync::{Arc, Mutex};\n" -#: src/concurrency/shared-state/example.md:24 +#: src/concurrency/shared-state/example.md msgid "Possible solution:" msgstr "راه‌حل ممکن:" -#: src/concurrency/shared-state/example.md:50 +#: src/concurrency/shared-state/example.md msgid "Notable parts:" msgstr "بخش‌های قابل توجه:" -#: src/concurrency/shared-state/example.md:52 +#: 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/concurrency/shared-state/example.md:54 +#: src/concurrency/shared-state/example.md msgid "" "Wrapping a `Mutex` in an `Arc` is a common pattern to share mutable state " "between threads." @@ -20523,7 +20434,7 @@ msgstr "" "قرار دادن یک `Mutex` در یک `Arc` یک الگوی رایج برای به اشتراک گذاشتن حالت " "قابل تغییر (mutable) بین threadها است." -#: src/concurrency/shared-state/example.md:56 +#: 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." @@ -20531,17 +20442,17 @@ msgstr "" "‏ `v: Arc<_>` باید به عنوان `v2` کلون شود تا بتوان آن را به thread دیگری " "منتقل کرد. نکته `move` به lambda signature اضافه شد." -#: src/concurrency/shared-state/example.md:58 +#: src/concurrency/shared-state/example.md msgid "" "Blocks are introduced to narrow the scope of the `LockGuard` as much as " "possible." msgstr "بلوک‌ها برای محدود کردن دامنه `LockGuard` تا حد امکان معرفی شده‌اند." -#: src/concurrency/sync-exercises/dining-philosophers.md:3 +#: src/concurrency/sync-exercises/dining-philosophers.md msgid "The dining philosophers problem is a classic problem in concurrency:" msgstr "مسئله ناهار خوردن فیلسوفان، در واقع یک مسئله کلاسیک concurrency است:" -#: src/concurrency/sync-exercises/dining-philosophers.md:5 +#: src/concurrency/sync-exercises/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 " @@ -20561,7 +20472,7 @@ msgstr "" "در حال غذاخوردن. پس از اینکه یک فیلسوف غذاخوردن را تمام کرد، هر دو چنگال را " "پایین می‌گذارد." -#: src/concurrency/sync-exercises/dining-philosophers.md:13 +#: src/concurrency/sync-exercises/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 " @@ -20571,8 +20482,8 @@ msgstr "" "محلی نیاز دارید. کد زیر را در فایلی به نام `src/main.rs` کپی کنید، جاهای " "خالی را پر کنید و آزمایش کنید که `cargo run` به بن‌بست (deadlock) نمی‌خورد:" -#: src/concurrency/sync-exercises/dining-philosophers.md:28 -#: src/concurrency/async-exercises/dining-philosophers.md:23 +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/dining-philosophers.md msgid "" "// left_fork: ...\n" " // right_fork: ...\n" @@ -20582,90 +20493,90 @@ msgstr "" " // right_fork: ...\n" " // thoughts: ...\n" -#: src/concurrency/sync-exercises/dining-philosophers.md:36 -#: src/concurrency/sync-exercises/solutions.md:22 -#: src/concurrency/async-exercises/dining-philosophers.md:31 -#: src/concurrency/async-exercises/solutions.md:23 +#: 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 "\"ایول! {} یک ایده جدید!\"" -#: src/concurrency/sync-exercises/dining-philosophers.md:41 -#: src/concurrency/async-exercises/solutions.md:31 +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "// Pick up forks...\n" msgstr "// Pick up forks...\n" -#: src/concurrency/sync-exercises/dining-philosophers.md:42 -#: src/concurrency/sync-exercises/solutions.md:31 -#: src/concurrency/async-exercises/dining-philosophers.md:38 -#: src/concurrency/async-exercises/solutions.md:51 +#: 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:48 -#: src/concurrency/sync-exercises/solutions.md:37 -#: src/concurrency/async-exercises/dining-philosophers.md:44 -#: src/concurrency/async-exercises/solutions.md:59 +#: 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:48 -#: src/concurrency/sync-exercises/solutions.md:37 -#: src/concurrency/async-exercises/dining-philosophers.md:44 -#: src/concurrency/async-exercises/solutions.md:59 +#: 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:48 -#: src/concurrency/sync-exercises/solutions.md:37 -#: src/concurrency/async-exercises/dining-philosophers.md:44 -#: src/concurrency/async-exercises/solutions.md:59 +#: 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:48 -#: src/concurrency/sync-exercises/solutions.md:37 -#: src/concurrency/async-exercises/dining-philosophers.md:44 -#: src/concurrency/async-exercises/solutions.md:59 +#: 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 #, fuzzy msgid "\"Aristotle\"" msgstr "\"Aristotle\"" -#: src/concurrency/sync-exercises/dining-philosophers.md:48 -#: src/concurrency/sync-exercises/solutions.md:37 -#: src/concurrency/async-exercises/dining-philosophers.md:44 -#: src/concurrency/async-exercises/solutions.md:59 +#: 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/concurrency/sync-exercises/dining-philosophers.md:51 -#: src/concurrency/async-exercises/dining-philosophers.md:48 -#: src/concurrency/async-exercises/solutions.md:63 +#: 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 "// Create forks\n" -#: src/concurrency/sync-exercises/dining-philosophers.md:53 -#: src/concurrency/async-exercises/dining-philosophers.md:50 -#: src/concurrency/async-exercises/solutions.md:67 +#: 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 "// Create philosophers\n" -#: src/concurrency/sync-exercises/dining-philosophers.md:55 +#: src/concurrency/sync-exercises/dining-philosophers.md msgid "// Make each of them think and eat 100 times\n" msgstr "// Make each of them think and eat 100 times\n" -#: src/concurrency/sync-exercises/dining-philosophers.md:57 -#: src/concurrency/async-exercises/dining-philosophers.md:54 -#: src/concurrency/async-exercises/solutions.md:95 +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "// Output their thoughts\n" msgstr "// Output their thoughts\n" -#: src/concurrency/sync-exercises/dining-philosophers.md:61 +#: 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:65 +#: src/concurrency/sync-exercises/dining-philosophers.md msgid "" "```toml\n" "[package]\n" @@ -20681,7 +20592,7 @@ msgstr "" "edition = \"2021\"\n" "```" -#: src/concurrency/sync-exercises/link-checker.md:3 +#: src/concurrency/sync-exercises/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 " @@ -20693,7 +20604,7 @@ msgstr "" "معتبر هستند. باید به‌صورت بازگشتی صفحات دیگر را در همان دامنه بررسی کند و این " "کار را تا زمانی که همه صفحات تأیید نشده‌اند ادامه دهد." -#: src/concurrency/sync-exercises/link-checker.md:8 +#: src/concurrency/sync-exercises/link-checker.md msgid "" "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`]" @@ -20706,14 +20617,14 @@ msgstr "" "برای رسیدگی به خطاها نیاز داریم پس درنتیجه از [`thiserror`](https://docs.rs/" "thiserror/) استفاده خواهیم کرد." -#: src/concurrency/sync-exercises/link-checker.md:12 +#: src/concurrency/sync-exercises/link-checker.md #, fuzzy msgid "Create a new Cargo project and `reqwest` it as a dependency with:" msgstr "" "یک پروژه Cargo جدید ایجاد کنید و آن را به عنوان یک وابستگی با `reqwest` " "اعلام کنید:" -#: src/concurrency/sync-exercises/link-checker.md:22 +#: src/concurrency/sync-exercises/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." @@ -20721,13 +20632,13 @@ msgstr "" "اگر`cargo add` با `error: no such subcommand` ناموفق بود، لطفاً فایل `Cargo." "toml` را دستی ویرایش کنید و وابستگی‌های ذکر شده در زیر را اضافه کنید." -#: src/concurrency/sync-exercises/link-checker.md:25 +#: src/concurrency/sync-exercises/link-checker.md msgid "" "The `cargo add` calls will update the `Cargo.toml` file to look like this:" msgstr "" "فراخوانی‌ها `cargo add` را در فایل `Cargo.toml` به‌صورت زیر به‌روزرسانی می‌کند:" -#: src/concurrency/sync-exercises/link-checker.md:29 +#: src/concurrency/sync-exercises/link-checker.md msgid "" "```toml\n" "[package]\n" @@ -20757,7 +20668,7 @@ msgstr "" "thiserror = \"1.0.37\"\n" "```" -#: src/concurrency/sync-exercises/link-checker.md:42 +#: src/concurrency/sync-exercises/link-checker.md msgid "" "You can now download the start page. Try with a small site such as `https://" "www.google.org/`." @@ -20765,55 +20676,55 @@ msgstr "" "اکنون می توانید صفحه شروع را دانلود کنید. با یک سایت کوچک مانند `https://www." "google.org/` امتحان کنید." -#: src/concurrency/sync-exercises/link-checker.md:45 +#: src/concurrency/sync-exercises/link-checker.md msgid "Your `src/main.rs` file should look something like this:" msgstr "فایل `src/main.rs` شما باید چیزی شبیه به این باشد:" -#: src/concurrency/sync-exercises/link-checker.md:57 -#: src/concurrency/sync-exercises/solutions.md:93 +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md msgid "\"request error: {0}\"" msgstr "\"request error: {0}\"" -#: src/concurrency/sync-exercises/link-checker.md:59 -#: src/concurrency/sync-exercises/solutions.md:95 +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md #, fuzzy msgid "\"bad http response: {0}\"" msgstr "\"bad http response: {0}\"" -#: src/concurrency/sync-exercises/link-checker.md:70 -#: src/concurrency/sync-exercises/solutions.md:106 +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md msgid "\"Checking {:#}\"" msgstr "\"بررسی {:#}\"" -#: src/concurrency/sync-exercises/link-checker.md:88 -#: src/concurrency/sync-exercises/solutions.md:124 +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md msgid "\"href\"" msgstr "\"href\"" -#: src/concurrency/sync-exercises/link-checker.md:95 -#: src/concurrency/sync-exercises/solutions.md:131 +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md #, fuzzy msgid "\"On {base_url:#}: ignored unparsable {href:?}: {err}\"" msgstr "\"On {base_url:#}: ignored unparsable {href:?}: {err}\"" -#: src/concurrency/sync-exercises/link-checker.md:104 -#: src/concurrency/sync-exercises/solutions.md:241 +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md msgid "\"https://www.google.org\"" msgstr "\"https://www.google.org\"" -#: src/concurrency/sync-exercises/link-checker.md:107 +#: src/concurrency/sync-exercises/link-checker.md msgid "\"Links: {links:#?}\"" msgstr "\"Links: {links:#?}\"" -#: src/concurrency/sync-exercises/link-checker.md:108 +#: src/concurrency/sync-exercises/link-checker.md msgid "\"Could not extract links: {err:#}\"" msgstr "\"نمی‌تواند لینک را باز کند: {err:#}\"" -#: src/concurrency/sync-exercises/link-checker.md:113 +#: src/concurrency/sync-exercises/link-checker.md msgid "Run the code in `src/main.rs` with" msgstr "این کد را در `src/main.rs` اجرا کنید" -#: src/concurrency/sync-exercises/link-checker.md:121 +#: src/concurrency/sync-exercises/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." @@ -20822,7 +20733,7 @@ msgstr "" "شوند به یک channel ارسال کنید و اجازه دهید چند thread به‌صورت موازی URLها را " "بررسی کنند." -#: src/concurrency/sync-exercises/link-checker.md:123 +#: src/concurrency/sync-exercises/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 " @@ -20832,11 +20743,11 @@ msgstr "" "google.org» استخراج کنید. حد بالا را حدود ۱۰۰ صفحه یا بیشتر قرار دهید تا در " "نهایت توسط سایت مسدود نشوید." -#: src/concurrency/sync-exercises/solutions.md:27 +#: src/concurrency/sync-exercises/solutions.md msgid "\"{} is trying to eat\"" msgstr "\"{} is trying to eat\"" -#: src/concurrency/sync-exercises/solutions.md:51 +#: src/concurrency/sync-exercises/solutions.md #, fuzzy msgid "" "// To avoid a deadlock, we have to break the symmetry\n" @@ -20847,22 +20758,22 @@ msgstr "" " // somewhere. This will swap the forks without deinitializing\n" " // either of them.\n" -#: src/concurrency/sync-exercises/solutions.md:75 +#: src/concurrency/sync-exercises/solutions.md msgid "\"{thought}\"" msgstr "\"{thought}\"" -#: src/concurrency/sync-exercises/solutions.md:80 +#: src/concurrency/sync-exercises/solutions.md msgid "Link Checker" msgstr "جستجوگر Link" -#: src/concurrency/sync-exercises/solutions.md:150 +#: src/concurrency/sync-exercises/solutions.md #, fuzzy msgid "" "/// Determine whether links within the given page should be extracted.\n" msgstr "" "/// Determine whether links within the given page should be extracted.\n" -#: src/concurrency/sync-exercises/solutions.md:158 +#: src/concurrency/sync-exercises/solutions.md #, fuzzy msgid "" "/// Mark the given page as visited, returning false if it had already\n" @@ -20871,16 +20782,16 @@ msgstr "" "/// Mark the given page as visited, returning false if it had already\n" " /// been visited.\n" -#: src/concurrency/sync-exercises/solutions.md:184 +#: src/concurrency/sync-exercises/solutions.md #, fuzzy msgid "// The sender got dropped. No more commands coming in.\n" msgstr "// The sender got dropped. No more commands coming in.\n" -#: src/concurrency/sync-exercises/solutions.md:225 +#: src/concurrency/sync-exercises/solutions.md msgid "\"Got crawling error: {:#}\"" msgstr "\"خطای crawling دریافت شد: {:#}\"" -#: src/concurrency/sync-exercises/solutions.md:243 +#: src/concurrency/sync-exercises/solutions.md msgid "\"Bad URLs: {:#?}\"" msgstr "\"Bad URLs: {:#?}\"" @@ -20942,7 +20853,7 @@ msgstr "" msgid "async/await" msgstr "async/await" -#: src/concurrency/async/async-await.md:3 +#: src/concurrency/async/async-await.md #, fuzzy msgid "" "At a high level, async Rust code looks very much like \"normal\" sequential " @@ -20951,12 +20862,12 @@ msgstr "" "در سطح بالا، کد Rust async بسیار شبیه کد متوالی \"عادی\" است (\"normal\" " "sequential code):" -#: src/concurrency/async/async-await.md:10 +#: src/concurrency/async/async-await.md #, fuzzy msgid "\"Count is: {i}!\"" msgstr "\"Count is: {i}!\"" -#: src/concurrency/async/async-await.md:28 +#: 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!" @@ -20964,17 +20875,17 @@ msgstr "" "توجه داشته باشید که این یک مثال ساده برای نشان دادن syntax است. هیچ عملیات " "طولانی مدت یا هیچ هم‌زمانی(concurrency) واقعی در آن وجود ندارد!" -#: src/concurrency/async/async-await.md:31 +#: src/concurrency/async/async-await.md msgid "What is the return type of an async call?" msgstr "نوع برگشت async call چیست؟" -#: src/concurrency/async/async-await.md:32 +#: src/concurrency/async/async-await.md msgid "Use `let future: () = async_main(10);` in `main` to see the type." msgstr "" "برای مشاهده type از `let future: () = async_main(10);` در `main` استفاده " "کنید." -#: src/concurrency/async/async-await.md:34 +#: src/concurrency/async/async-await.md msgid "" "The \"async\" keyword is syntactic sugar. The compiler replaces the return " "type with a future." @@ -20982,7 +20893,7 @@ msgstr "" "کلمه کلیدی \"async\" شیرینیِ syntax زبان Rust است. کامپایلر نوع بازگشتی را با " "یک future جایگزین می‌کند." -#: src/concurrency/async/async-await.md:37 +#: 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." @@ -20990,7 +20901,7 @@ msgstr "" "شما نمی‌توانید بدون دستورالعمل‌های اضافی به کامپایلر در مورد نحوه استفاده از " "future بازگشتی، `main` را async کنید." -#: src/concurrency/async/async-await.md:40 +#: src/concurrency/async/async-await.md msgid "" "You need an executor to run async code. `block_on` blocks the current thread " "until the provided future has run to completion." @@ -20998,13 +20909,13 @@ msgstr "" "برای اجرای کدهای همگام به یک اجرا‌ کننده (executor) نیاز دارید.`block_on` که " "thread رشته فعلی را تا زمانی که future ارائه شده تکمیل شود مسدود می‌کند." -#: src/concurrency/async/async-await.md:43 +#: 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 "" -#: src/concurrency/async/async-await.md:46 +#: src/concurrency/async/async-await.md msgid "" "`.await` can only be used inside an `async` function (or block; these are " "introduced later)." @@ -21012,7 +20923,7 @@ msgstr "" "‏ `.await` فقط می‌تواند در داخل یک تابع `async` استفاده شود (یا block؛ این " "مورد در آینده معرفی می‌شوند)." -#: src/concurrency/async/futures.md:3 +#: 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 " @@ -21024,7 +20935,7 @@ msgstr "" "کامل نشده باشد. می‌توان یک future را poll کرد و `poll` یک [`Poll`](https://" "doc.rust-lang.org/std/task/enum.Poll.html) را برمی‌گرداند." -#: src/concurrency/async/futures.md:23 +#: 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 " @@ -21036,7 +20947,7 @@ msgstr "" "`JoinHandle` برگردانده شده از `tokio::spawn` `Future` را پیاده‌سازی می‌کند تا " "امکان پیوستن (joining) به آن را فراهم کند." -#: src/concurrency/async/futures.md:27 +#: 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." @@ -21044,7 +20955,7 @@ msgstr "" "کلمه کلیدی `.await` که برای Future اعمال می‌شود، باعث می‌شود که تابع async " "فعلی تا زمانی که Future آماده شود متوقف شود و سپس خروجی آن ارزیابی شود." -#: src/concurrency/async/futures.md:33 +#: 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." @@ -21052,7 +20963,7 @@ msgstr "" "تایپ‌های `Future` و `Poll` دقیقاً همانطور که نشان داده شده است اجرا می شوند. " "برای نمایش پیاده‌سازی‌ها در اسناد، روی لینک‌ها کلیک کنید." -#: src/concurrency/async/futures.md:36 +#: 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:" @@ -21060,7 +20971,7 @@ msgstr "" "ما به `Pin` و `Context` نخواهیم رسید، زیرا به جای ساختن کدهای اولیه async، " "بر نوشتن کدهای async تمرکز خواهیم کرد. به طور خلاصه:" -#: src/concurrency/async/futures.md:39 +#: src/concurrency/async/futures.md msgid "" "`Context` allows a Future to schedule itself to be polled again when an " "event occurs." @@ -21068,7 +20979,7 @@ msgstr "" "‏ `Context` به Future اجازه می‌دهد تا زمانی که رویدادی رخ می دهد، خود را برای " "poll مجدد برنامه‌ریزی کند." -#: src/concurrency/async/futures.md:42 +#: 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 " @@ -21078,7 +20989,7 @@ msgstr "" "future معتبر باقی می‌مانند. این برای اجازه دادن به referenceها برای معتبر " "ماندن پس از `.await` لازم است." -#: src/concurrency/async/runtimes.md:3 +#: 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 " @@ -21088,7 +20999,7 @@ msgstr "" "کند و مسئول اجرای futureها (an _executor_) است. Rust یک runtime داخلی ندارد، " "اما چندین گزینه دیگر در دسترس است:" -#: src/concurrency/async/runtimes.md:7 +#: src/concurrency/async/runtimes.md msgid "" "[Tokio](https://tokio.rs/): performant, with a well-developed ecosystem of " "functionality like [Hyper](https://hyper.rs/) for HTTP or [Tonic](https://" @@ -21098,7 +21009,7 @@ msgstr "" "بالا به خوبی توسعه یافته مانند [Hyper](https://hyper.rs/) برای HTTP یا " "[Tonic] (https://github) .com/hyperium/tonic) برای gRPC." -#: src/concurrency/async/runtimes.md:10 +#: src/concurrency/async/runtimes.md msgid "" "[async-std](https://async.rs/): aims to be a \"std for async\", and includes " "a basic runtime in `async::task`." @@ -21106,11 +21017,11 @@ msgstr "" "‏[async-std](https://async.rs/):: هدفش این است که یک \"std for async\" باشد و " "شامل یک runtime اولیه در `async::task` است." -#: src/concurrency/async/runtimes.md:12 +#: src/concurrency/async/runtimes.md msgid "[smol](https://docs.rs/smol/latest/smol/): simple and lightweight" msgstr "‏[smol](https://docs.rs/smol/latest/smol/): ساده و سبک است." -#: src/concurrency/async/runtimes.md:14 +#: 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-" @@ -21120,7 +21031,7 @@ msgstr "" "[Fuchsia](https://fuchsia.googlesource.com/fuchsia/+/refs/heads/main/src/lib/" "fuchsia-async/src/lib.rs) اکنون یکی runtime دارد." -#: src/concurrency/async/runtimes.md:21 +#: 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 " @@ -21130,7 +21041,7 @@ msgstr "" "زبان Rust پشتیبانی می‌شود.playground همچنین اجازه ورود/خروجی (I/O) را نمی " "دهد، بنابراین بیشتر چیزهای async جالب نمی‌توانند در playground اجرا شوند." -#: src/concurrency/async/runtimes.md:25 +#: src/concurrency/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 " @@ -21142,52 +21053,52 @@ msgstr "" "آنها را polling کند. به عنوان مثال، این با JS Promises متفاوت است که حتی اگر " "هرگز استفاده نشوند تا پایان کامل شدن برنامه اجرا خواهند شد." -#: src/concurrency/async/runtimes/tokio.md:3 +#: src/concurrency/async/runtimes/tokio.md #, fuzzy msgid "Tokio provides:" msgstr "Tokio provides:" -#: src/concurrency/async/runtimes/tokio.md:5 +#: src/concurrency/async/runtimes/tokio.md msgid "A multi-threaded runtime for executing asynchronous code." msgstr "" "یک runtime از نوع multi-thread برای اجرای کدهای ناهمزمان(asynchronous)." -#: src/concurrency/async/runtimes/tokio.md:6 +#: src/concurrency/async/runtimes/tokio.md msgid "An asynchronous version of the standard library." msgstr "یک asynchronous version کتابخانه‌ای استاندارد است." -#: src/concurrency/async/runtimes/tokio.md:7 +#: src/concurrency/async/runtimes/tokio.md msgid "A large ecosystem of libraries." msgstr "اکوسیستم بزرگی از کتابخانه‌ها." -#: src/concurrency/async/runtimes/tokio.md:14 +#: src/concurrency/async/runtimes/tokio.md #, fuzzy msgid "\"Count in task: {i}!\"" msgstr "\"connection from {addr:?}\"" -#: src/concurrency/async/runtimes/tokio.md:24 +#: src/concurrency/async/runtimes/tokio.md #, fuzzy msgid "\"Main task: {i}\"" msgstr "\"Main task: {i}\"" -#: src/concurrency/async/runtimes/tokio.md:32 +#: src/concurrency/async/runtimes/tokio.md msgid "With the `tokio::main` macro we can now make `main` async." msgstr "با ماکرو `tokio::main` اکنون می‌توانیم `main` را async کنیم." -#: src/concurrency/async/runtimes/tokio.md:34 +#: src/concurrency/async/runtimes/tokio.md msgid "The `spawn` function creates a new, concurrent \"task\"." msgstr "تابع `spawn` یک \"task\" جدید و همزمان ایجاد می‌کند." -#: src/concurrency/async/runtimes/tokio.md:36 +#: src/concurrency/async/runtimes/tokio.md msgid "Note: `spawn` takes a `Future`, you don't call `.await` on `count_to`." msgstr "" "توجه: `spawn` یک `Future` می‌گیرد، شما `.await` را در `count_to` صدا نمی‌زنید." -#: src/concurrency/async/runtimes/tokio.md:38 +#: src/concurrency/async/runtimes/tokio.md msgid "**Further exploration:**" msgstr "**Further بررسی:**" -#: src/concurrency/async/runtimes/tokio.md:40 +#: src/concurrency/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 " @@ -21196,19 +21107,19 @@ msgstr "" "چرا `count_to` (معمولا) به مقدار ۱۰ نمی‌رسد؟ این نمونه‌ای از لغو async است. " "`tokio::spawn` یک handle را برمی‌گرداند که می‌توان مدتی منتظر ماند تا تمام شود." -#: src/concurrency/async/runtimes/tokio.md:44 +#: src/concurrency/async/runtimes/tokio.md msgid "Try `count_to(10).await` instead of spawning." msgstr "به جای spawn مورد `count_to(10).await`» را امتحان کنید." -#: src/concurrency/async/runtimes/tokio.md:46 +#: src/concurrency/async/runtimes/tokio.md msgid "Try awaiting the task returned from `tokio::spawn`." msgstr "منتظر کار برگشتی از `tokio::spawn` باشید." -#: src/concurrency/async/tasks.md:3 +#: src/concurrency/async/tasks.md msgid "Rust has a task system, which is a form of lightweight threading." msgstr "‏ Rust یک task system دارد که نوعی thread سبک‌ وزن است." -#: src/concurrency/async/tasks.md:5 +#: src/concurrency/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` " @@ -21222,45 +21133,43 @@ msgstr "" "مطابقت دارد. همزمانی در یک task با poll از چندین child future، مانند رقابت " "یک تایمر و یک عملیات I/O امکان‌پذیر است." -#: src/concurrency/async/tasks.md:16 +#: src/concurrency/async/tasks.md msgid "\"127.0.0.1:0\"" msgstr "\"127.0.0.1:0\"" -#: src/concurrency/async/tasks.md:17 +#: src/concurrency/async/tasks.md #, fuzzy msgid "\"listening on port {}\"" msgstr "\"listening on port {}\"" -#: src/concurrency/async/tasks.md:22 +#: src/concurrency/async/tasks.md #, fuzzy msgid "\"connection from {addr:?}\"" msgstr "\"connection from {addr:?}\"" -#: src/concurrency/async/tasks.md:25 +#: src/concurrency/async/tasks.md #, fuzzy msgid "b\"Who are you?\\n\"" msgstr "b\"Who are you?\\n\"" -#: src/concurrency/async/tasks.md:25 src/concurrency/async/tasks.md:28 -#: src/concurrency/async/tasks.md:31 +#: src/concurrency/async/tasks.md #, fuzzy msgid "\"socket error\"" msgstr "\"socket error\"" -#: src/concurrency/async/tasks.md:30 +#: src/concurrency/async/tasks.md #, fuzzy msgid "\"Thanks for dialing in, {name}!\\n\"" msgstr "\"Thanks for dialing in, {name}!\\n\"" -#: src/concurrency/async/tasks.md:40 -#: src/concurrency/async-control-flow/join.md:37 +#: src/concurrency/async/tasks.md src/concurrency/async-control-flow/join.md msgid "" "Copy this example into your prepared `src/main.rs` and run it from there." msgstr "" "این مثال را در `src/main.rs` آماده شده خود کپی کنید و آن را از آنجا اجرا " "کنید." -#: src/concurrency/async/tasks.md:42 +#: src/concurrency/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/" @@ -21269,7 +21178,7 @@ msgstr "" "سعی کنید با یک ابزار اتصال TCP مانند [nc](https://www.unix.com/man-page/" "linux/1/nc/) یا [telnet](https://www.unix.com/) به آن متصل شوید." -#: src/concurrency/async/tasks.md:46 +#: src/concurrency/async/tasks.md #, fuzzy msgid "" "Ask students to visualize what the state of the example server would be with " @@ -21278,7 +21187,7 @@ msgstr "" "از دانش‌آموزان بخواهید که وضعیت سرور مورد مثال را با چند کلاینت متصل تجسم " "کنند. چه taskهایی وجود دارد؟ Future آنها چیست؟" -#: src/concurrency/async/tasks.md:49 +#: src/concurrency/async/tasks.md #, fuzzy msgid "" "This is the first time we've seen an `async` block. This is similar to a " @@ -21288,7 +21197,7 @@ msgstr "" "این اولین بار است که بلوک `async` را می‌بینیم. این شبیه به بسته شدن است، اما " "هیچ استدلالی ندارد. مقدار بازگشتی آن از نوع Future است، شبیه به `async fn`." -#: src/concurrency/async/tasks.md:53 +#: src/concurrency/async/tasks.md msgid "" "Refactor the async block into a function, and improve the error handling " "using `?`." @@ -21296,43 +21205,43 @@ msgstr "" "بلوک async را به یک تابع تغییر دهید و مدیریت خطا را با استفاده از `?` بهبود " "بخشید." -#: src/concurrency/async-control-flow/channels.md:3 +#: src/concurrency/async-control-flow/channels.md msgid "" "Several crates have support for asynchronous channels. For instance `tokio`:" msgstr "" "چندین crate از asynchronous channel پشتیبانی می‌کنند. به عنوان مثال `tokio`:" -#: src/concurrency/async-control-flow/channels.md:13 +#: src/concurrency/async-control-flow/channels.md #, fuzzy msgid "\"Received {count} pings so far.\"" msgstr "\"Received {count} pings so far.\"" -#: src/concurrency/async-control-flow/channels.md:16 +#: src/concurrency/async-control-flow/channels.md #, fuzzy msgid "\"ping_handler complete\"" msgstr "\"ping_handler complete\"" -#: src/concurrency/async-control-flow/channels.md:24 +#: src/concurrency/async-control-flow/channels.md #, fuzzy msgid "\"Failed to send ping.\"" msgstr "\"Failed to send ping.\"" -#: src/concurrency/async-control-flow/channels.md:25 +#: src/concurrency/async-control-flow/channels.md #, fuzzy msgid "\"Sent {} pings so far.\"" msgstr "\"Sent {} pings so far.\"" -#: src/concurrency/async-control-flow/channels.md:29 +#: src/concurrency/async-control-flow/channels.md #, fuzzy msgid "\"Something went wrong in ping handler task.\"" msgstr "\"Something went wrong in ping handler task.\"" -#: src/concurrency/async-control-flow/channels.md:36 +#: src/concurrency/async-control-flow/channels.md msgid "Change the channel size to `3` and see how it affects the execution." msgstr "" "اندازه کانال را به`3` تغییر دهید و ببینید که چگونه بر اجرا تأثیر می‌گذارد." -#: src/concurrency/async-control-flow/channels.md:38 +#: src/concurrency/async-control-flow/channels.md msgid "" "Overall, the interface is similar to the `sync` channels as seen in the " "[morning class](../channels.md)." @@ -21340,11 +21249,11 @@ msgstr "" "به‌طور‌کلی، interface شبیه به channelهای `sync` است که در [کلاس صبح‌گاهی](../" "channels.md) دیده می‌شود." -#: src/concurrency/async-control-flow/channels.md:41 +#: src/concurrency/async-control-flow/channels.md msgid "Try removing the `std::mem::drop` call. What happens? Why?" msgstr "تماس `std::mem::drop` را حذف کنید. چه اتفاقی می‌افتد؟ چرا؟" -#: src/concurrency/async-control-flow/channels.md:43 +#: 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 " @@ -21354,7 +21263,7 @@ msgstr "" "کانال‌هایی است که `sync` و `async` `send` و `recv` را اجرا می‌کنند. این کار " "می‌تواند برای برنامه‌های پیچیده با taskهای پردازشی IO و CPU سنگین مناسب باشد." -#: src/concurrency/async-control-flow/channels.md:47 +#: 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 " @@ -21363,7 +21272,7 @@ msgstr "" "چیزی که کار با کانال‌های `async` را ترجیح می‌دهد، توانایی ترکیب آن‌ها با دیگر " "`future` برای ترکیب آنها و ایجاد جریان کنترل پیچیده است." -#: src/concurrency/async-control-flow/join.md:3 +#: src/concurrency/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 " @@ -21373,26 +21282,26 @@ msgstr "" "مجموعه‌ای (collection) از نتایج آنها را برمی‌گرداند. این شبیه به `Promise.all` " "در JavaScript یا `asyncio.gather` در پایتون است." -#: src/concurrency/async-control-flow/join.md:21 +#: src/concurrency/async-control-flow/join.md #, fuzzy msgid "\"https://google.com\"" msgstr "\"https://google.com\"" -#: src/concurrency/async-control-flow/join.md:22 +#: src/concurrency/async-control-flow/join.md #, fuzzy msgid "\"https://httpbin.org/ip\"" msgstr "\"https://httpbin.org/ip\"" -#: src/concurrency/async-control-flow/join.md:23 +#: src/concurrency/async-control-flow/join.md #, fuzzy msgid "\"https://play.rust-lang.org/\"" msgstr "\"https://play.rust-lang.org/\"" -#: src/concurrency/async-control-flow/join.md:24 +#: src/concurrency/async-control-flow/join.md msgid "\"BAD_URL\"" msgstr "\"BAD_URL\"" -#: src/concurrency/async-control-flow/join.md:39 +#: src/concurrency/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 " @@ -21403,7 +21312,7 @@ msgstr "" "حاضر در جعبه (crate از نوع `futures` است که به زودی در `std::future` تثبیت " "می‌شود." -#: src/concurrency/async-control-flow/join.md:43 +#: src/concurrency/async-control-flow/join.md msgid "" "The risk of `join` is that one of the futures may never resolve, this would " "cause your program to stall." @@ -21411,7 +21320,7 @@ msgstr "" "خطر `join` این است که یکی از future‌ها ممکن است هرگز resolve نشود، این مسئله " "باعث می‌شود برنامه شما متوقف شود." -#: src/concurrency/async-control-flow/join.md:46 +#: src/concurrency/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 " @@ -21425,7 +21334,7 @@ msgstr "" "future اضافه کنید. این یک timeout نیست (که به `select!`نیاز دارد و در فصل " "بعدی توضیح داده ‌می‌شود) بلکه `join!` را نشان می‌دهد." -#: src/concurrency/async-control-flow/select.md:3 +#: src/concurrency/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." @@ -21437,7 +21346,7 @@ msgstr "" "است و در پایتون با `asyncio.wait(task_set, return_when=asyncio." "FIRST_COMPLETED)` قابل مقایسه می‌باشد." -#: src/concurrency/async-control-flow/select.md:8 +#: src/concurrency/async-control-flow/select.md 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, " @@ -21451,76 +21360,37 @@ msgstr "" "`statement` با متغیرهای حاصل اجرا می‌شود. در نتیجه `statement` نتیجه‌ي ماکرو " "`select!` می‌شود." -#: src/concurrency/async-control-flow/select.md:40 -#, fuzzy -msgid "\"Felix\"" -msgstr "\"Felix\"" - -#: src/concurrency/async-control-flow/select.md:40 -#, fuzzy -msgid "\"Failed to send cat.\"" -msgstr "\"Failed to send cat.\"" - -#: src/concurrency/async-control-flow/select.md:44 -#, fuzzy -msgid "\"Failed to send dog.\"" -msgstr "\"Failed to send dog.\"" - -#: src/concurrency/async-control-flow/select.md:49 -#, fuzzy -msgid "\"Failed to receive winner\"" -msgstr "\"Failed to receive winner\"" - -#: src/concurrency/async-control-flow/select.md:51 +#: src/concurrency/async-control-flow/select.md #, fuzzy -msgid "\"Winner is {winner:?}\"" -msgstr "\"Winner is {winner:?}\"" +msgid "\"got: {msg}\"" +msgstr "\"{msg}\"" -#: src/concurrency/async-control-flow/select.md:58 -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." +#: src/concurrency/async-control-flow/select.md +msgid "\"timeout\"" msgstr "" -"در این مثال مسابقه‌ای بین گربه و سگ داریم. `first_animal_to_finish_race` به " -"هر دو channelها گوش می‌دهد و هر کدام را زودتر وارد شوند را انتخاب می‌کند." -"بنابراین سگ ۵۰ میلی‌ثانیه طول می‌کشد، در برابر گربه‌ای که ۵۰۰ میلی‌ثانیه طول " -"می‌کشد تا پیروز شود." -#: src/concurrency/async-control-flow/select.md:63 -msgid "" -"You can use `oneshot` channels in this example as the channels are supposed " -"to receive only one `send`." -msgstr "" -"در این مثال می‌توانید از کانال‌های `oneshot` استفاده کنید زیرا قرار است " -"کانال‌ها فقط یک `send` را دریافت کنند." +#: src/concurrency/async-control-flow/select.md +#, fuzzy +msgid "\"Failed to send greeting\"" +msgstr "\"Failed to send ping.\"" -#: src/concurrency/async-control-flow/select.md:66 -msgid "" -"Try adding a deadline to the race, demonstrating selecting different sorts " -"of futures." +#: src/concurrency/async-control-flow/select.md +msgid "\"Listener failed\"" msgstr "" -"سعی کنید یک ضرب الاجل به رقابت اضافه کنید و انتخاب انواع مختلف future را " -"نشان دهید." -#: src/concurrency/async-control-flow/select.md:69 +#: src/concurrency/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." +"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 "" -"توجه داشته باشید که `select!` شاخه‌های (branch) بی‌همتا را حذف می کند و " -"future آنها را لغو می‌کند. زمانی که هر اجرای `select!` می‌تواند future‌های " -"جدیدی ایجاد می‌کند، راحت‌ترین استفاده از آن است." -#: src/concurrency/async-control-flow/select.md:72 +#: src/concurrency/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." +"`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 "" -"یک راه جایگزین این است که به جای خودِ future از `&mut future` استفاده کنید، " -"اما این کار می‌تواند منجر به مسائلی شود که بیشتر در اسلاید سنجاق (pinning " -"slide) شده بحث شده است." #: src/concurrency/async-pitfalls.md msgid "" @@ -21538,11 +21408,11 @@ msgstr "" msgid "Pin" msgstr "Pin" -#: src/concurrency/async-pitfalls/blocking-executor.md:1 +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "Blocking the executor" msgstr "مسدود کردن executor" -#: src/concurrency/async-pitfalls/blocking-executor.md:3 +#: src/concurrency/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 " @@ -21554,17 +21424,17 @@ msgstr "" "مسدود شدن executor و جلوگیری از اجرای سایر تسک‌ها می‌شود. یک راه حل آسان این " "است که در صورت امکان از متدهای معادل async استفاده کنید." -#: src/concurrency/async-pitfalls/blocking-executor.md:14 +#: src/concurrency/async-pitfalls/blocking-executor.md #, fuzzy msgid "\"future {id} slept for {duration_ms}ms, finished after {}ms\"" msgstr "\"future {id} slept for {duration_ms}ms, finished after {}ms\"" -#: src/concurrency/async-pitfalls/blocking-executor.md:19 +#: src/concurrency/async-pitfalls/blocking-executor.md #, fuzzy msgid "\"current_thread\"" msgstr "\"current_thread\"" -#: src/concurrency/async-pitfalls/blocking-executor.md:30 +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" "Run the code and see that the sleeps happen consecutively rather than " "concurrently." @@ -21572,7 +21442,7 @@ msgstr "" "کد را اجرا کنید و ببینید که sleep‌ها به طور متوالی اتفاق می‌افتند و نه به صورت " "همزمان (concurrent)." -#: src/concurrency/async-pitfalls/blocking-executor.md:33 +#: src/concurrency/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-" @@ -21582,14 +21452,14 @@ msgstr "" "اثرگذاری را آشکارتر می‌کند، اما این اشکال همچنان در طبیعت multi-threaded وجود " "دارد." -#: src/concurrency/async-pitfalls/blocking-executor.md:37 +#: src/concurrency/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` تغییر دهید و منتظر نتیجه " "باشید." -#: src/concurrency/async-pitfalls/blocking-executor.md:39 +#: src/concurrency/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." @@ -21597,7 +21467,7 @@ msgstr "" "راه‌حل دیگر `tokio::task::spawn_blocking` است که یک thread واقعی ایجاد می‌کند " "و handle آن را بدون مسدود کردن executor به future تبدیل می‌کند." -#: src/concurrency/async-pitfalls/blocking-executor.md:42 +#: src/concurrency/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 " @@ -21613,7 +21483,7 @@ msgstr "" "ذخیره‌سازی محلی thread یا نگاشت (map) به threadهای سیستم‌عامل خاص (مانند CUDA) " "بستگی داشته باشد. در چنین شرایطی `tokio::task::spawn_blocking` را ترجیح دهید." -#: src/concurrency/async-pitfalls/blocking-executor.md:48 +#: src/concurrency/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." @@ -21622,7 +21492,7 @@ msgstr "" "await` ممکن است باعث مسدود شدن task دیگری شود و آن task ممکن است در همان " "thread در حال اجرا باشد." -#: src/concurrency/async-pitfalls/pin.md:3 +#: src/concurrency/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 " @@ -21632,7 +21502,7 @@ msgstr "" "می‌کنند. نوع برگشتی نتیجه تبدیل کامپایلر است که متغیرهای محلی را به داده های " "ذخیره شده در future تبدیل می کند." -#: src/concurrency/async-pitfalls/pin.md:7 +#: src/concurrency/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 " @@ -21642,7 +21512,7 @@ msgstr "" "دارند. به همین دلیل، future هرگز نباید به مکان حافظه دیگری منتقل شود، زیرا " "این pointerها را باطل می‌کند." -#: src/concurrency/async-pitfalls/pin.md:11 +#: src/concurrency/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 " @@ -21654,7 +21524,7 @@ msgstr "" "عملیاتی را که می‌تواند نمونه‌ای را که به آن اشاره می‌کند به یک مکان حافظه " "متفاوت منتقل کند را ممنوع می‌کند." -#: src/concurrency/async-pitfalls/pin.md:20 +#: src/concurrency/async-pitfalls/pin.md #, fuzzy msgid "" "// A work item. In this case, just sleep for the given time and respond\n" @@ -21663,47 +21533,47 @@ msgstr "" "// A work item. In this case, just sleep for the given time and respond\n" "// with a message on the `respond_on` channel.\n" -#: src/concurrency/async-pitfalls/pin.md:28 +#: src/concurrency/async-pitfalls/pin.md #, fuzzy msgid "// A worker which listens for work on a queue and performs it.\n" msgstr "// A worker which listens for work on a queue and performs it.\n" -#: src/concurrency/async-pitfalls/pin.md:35 +#: src/concurrency/async-pitfalls/pin.md #, fuzzy msgid "// Pretend to work.\n" msgstr "// Pretend to work.\n" -#: src/concurrency/async-pitfalls/pin.md:38 +#: src/concurrency/async-pitfalls/pin.md #, fuzzy msgid "\"failed to send response\"" msgstr "\"failed to send response\"" -#: src/concurrency/async-pitfalls/pin.md:41 +#: src/concurrency/async-pitfalls/pin.md #, fuzzy msgid "// TODO: report number of iterations every 100ms\n" msgstr "// TODO: report number of iterations every 100ms\n" -#: src/concurrency/async-pitfalls/pin.md:45 +#: src/concurrency/async-pitfalls/pin.md #, fuzzy msgid "// A requester which requests work and waits for it to complete.\n" msgstr "// A requester which requests work and waits for it to complete.\n" -#: src/concurrency/async-pitfalls/pin.md:52 +#: src/concurrency/async-pitfalls/pin.md #, fuzzy msgid "\"failed to send on work queue\"" msgstr "\"failed to send on work queue\"" -#: src/concurrency/async-pitfalls/pin.md:53 +#: src/concurrency/async-pitfalls/pin.md #, fuzzy msgid "\"failed waiting for response\"" msgstr "\"failed waiting for response\"" -#: src/concurrency/async-pitfalls/pin.md:62 +#: src/concurrency/async-pitfalls/pin.md #, fuzzy msgid "\"work result for iteration {i}: {resp}\"" msgstr "\"Welcome to chat! Type a message\"" -#: src/concurrency/async-pitfalls/pin.md:70 +#: src/concurrency/async-pitfalls/pin.md msgid "" "You may recognize this as an example of the actor pattern. Actors typically " "call `select!` in a loop." @@ -21711,7 +21581,7 @@ msgstr "" "شما ممکن است این را به عنوان نمونه ای از الگوی بازیگر (actor pattern) تشخیص " "دهید. بازیگران معمولاً `select!` را در یک حلقه صدا می‌زنند." -#: src/concurrency/async-pitfalls/pin.md:73 +#: src/concurrency/async-pitfalls/pin.md msgid "" "This serves as a summation of a few of the previous lessons, so take your " "time with it." @@ -21719,7 +21589,7 @@ msgstr "" "این به عنوان یک جمع‌بندی از چند درس قبلی عمل می کند، بنابراین وقت خود را صرف " "آن کنید." -#: src/concurrency/async-pitfalls/pin.md:76 +#: src/concurrency/async-pitfalls/pin.md msgid "" "Naively add a `_ = sleep(Duration::from_millis(100)) => { println!(..) }` to " "the `select!`. This will never execute. Why?" @@ -21727,12 +21597,12 @@ msgstr "" "به‌سادگی یک `_ = sleep(Duration::from_millis(100)) => { println!(..) }` را به " "`select!` اضافه کنید. این مورد هرگز اجرا نمی شود. چرا؟" -#: src/concurrency/async-pitfalls/pin.md:79 +#: src/concurrency/async-pitfalls/pin.md msgid "" "Instead, add a `timeout_fut` containing that future outside of the `loop`:" msgstr "درعوض، یک `timeout_fut` حاوی آن future خارج از `loop` اضافه کنید:" -#: src/concurrency/async-pitfalls/pin.md:90 +#: src/concurrency/async-pitfalls/pin.md #, fuzzy msgid "" "This still doesn't work. Follow the compiler errors, adding `&mut` to the " @@ -21743,7 +21613,7 @@ msgstr "" "`timeout_fut` در `select!` اضافه کنید تا حرکت را ادامه دهید، سپس از `Box::" "pin` استفاده کنید:" -#: src/concurrency/async-pitfalls/pin.md:104 +#: src/concurrency/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 " @@ -21753,7 +21623,7 @@ msgstr "" "`Poll::Ready` است (future ترکیبی به این مسئله کمک می‌کند). به‌روزرسانی برای " "بازنشانی `timeout_fut` هر بار که منقضی می‌شود:" -#: src/concurrency/async-pitfalls/pin.md:119 +#: src/concurrency/async-pitfalls/pin.md #, fuzzy msgid "" "Box allocates on the heap. In some cases, `std::pin::pin!` (only recently " @@ -21765,7 +21635,7 @@ msgstr "" "یک گزینه است، اما استفاده از آن برای futureای که دوباره تخصیص داده می‌شود " "دشوار است." -#: src/concurrency/async-pitfalls/pin.md:123 +#: 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." @@ -21773,7 +21643,7 @@ msgstr "" "جایگزین دیگر این است که به هیچ وجه از `pin` استفاده نکنید، بلکه task دیگری " "ایجاد کنید که هر 100 میلی‌ثانیه به یک کانال `oneshot` ارسال می‌شود." -#: src/concurrency/async-pitfalls/pin.md:126 +#: src/concurrency/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 " @@ -21787,7 +21657,7 @@ msgstr "" "اشاره می‌کنند زنده بمانند. با‌این‌حال، تبدیل کد برای بلوک‌ها و توابع async توسط " "borrow checker تأیید نمی‌شود." -#: src/concurrency/async-pitfalls/pin.md:132 +#: src/concurrency/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 " @@ -21797,7 +21667,7 @@ msgstr "" "از یک pointer پین شده از جای خود حرکت داد. با این حال، هنوز هم می‌توان آن را " "از طریق یک pointer بدون پین جابجا کرد." -#: src/concurrency/async-pitfalls/pin.md:136 +#: src/concurrency/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 " @@ -21807,7 +21677,7 @@ msgstr "" "اشاره به نمونه (instance) استفاده می‌‌کند. به همین دلیل است که فقط می‌توان آن " "را روی یک اشاره‌‌گر پین شده فراخوانی کرد." -#: src/concurrency/async-pitfalls/async-traits.md:3 +#: src/concurrency/async-pitfalls/async-traits.md msgid "" "Async methods in traits are were stabilized only recently, in the 1.75 " "release. This required support for using return-position `impl Trait` (RPIT) " @@ -21819,7 +21689,7 @@ msgstr "" "داشت، زیرا شیرین‌زدایی (desugaring) برای `async fn` شامل `-> impl " "Future` است." -#: src/concurrency/async-pitfalls/async-traits.md:7 +#: 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:" @@ -21827,7 +21697,7 @@ msgstr "" "با این‌حال، حتی با پشتیبانی native امروز، برخی از مشکلات در مورد `async fn` و " "RPIT در ویژگی‌ها وجود دارد:" -#: src/concurrency/async-pitfalls/async-traits.md:10 +#: src/concurrency/async-pitfalls/async-traits.md msgid "" "Return-position impl Trait captures all in-scope lifetimes (so some patterns " "of borrowing cannot be expressed)" @@ -21835,7 +21705,7 @@ msgstr "" "‏Return-position impl Trait تمام طول عمرهای درون محدوده را ثبت می کند " "(بنابراین برخی از الگوهای قرض کردن (borrowing) نمی توانند بیان شوند)" -#: src/concurrency/async-pitfalls/async-traits.md:13 +#: src/concurrency/async-pitfalls/async-traits.md msgid "" "Traits whose methods use return-position `impl trait` or `async` are not " "`dyn` compatible." @@ -21843,7 +21713,7 @@ msgstr "" "ویژگی‌هایی که متد‌های آن‌ها از موقعیت بازگشتی `impl trait` یا `async` استفاده " "می‌کنند با `dyn` سازگار نیستند." -#: src/concurrency/async-pitfalls/async-traits.md:16 +#: src/concurrency/async-pitfalls/async-traits.md #, fuzzy msgid "" "If we do need `dyn` support, the crate [async_trait](https://docs.rs/async-" @@ -21854,17 +21724,17 @@ msgstr "" "trait/latest/async_trait/) راه‌حلی را از طریق یک ماکرو ارائه می‌کند، با ذکر " "چند نکته:" -#: src/concurrency/async-pitfalls/async-traits.md:46 +#: src/concurrency/async-pitfalls/async-traits.md #, fuzzy msgid "\"running all sleepers..\"" msgstr "\"running all sleepers..\"" -#: src/concurrency/async-pitfalls/async-traits.md:50 +#: src/concurrency/async-pitfalls/async-traits.md #, fuzzy msgid "\"slept for {}ms\"" msgstr "\"slept for {}ms\"" -#: src/concurrency/async-pitfalls/async-traits.md:68 +#: src/concurrency/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." @@ -21873,7 +21743,7 @@ msgstr "" "هدف از heap allocationها استفاده می‌کند. این heap allocation دارای سربار " "عملکرد است." -#: src/concurrency/async-pitfalls/async-traits.md:71 +#: src/concurrency/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 " @@ -21887,7 +21757,7 @@ msgstr "" "hard/) آنها را به خوبی توضیح داده است. به خصوص اگر شما به این موضوع علاقه‌مند " "هستید." -#: src/concurrency/async-pitfalls/async-traits.md:77 +#: src/concurrency/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." @@ -21895,7 +21765,7 @@ msgstr "" "سعی کنید یک sleep خواب جدید ایجاد کنید که برای مدت زمان تصادفی می‌خوابد و آن " "را به Vec اضافه کنید." -#: src/concurrency/async-pitfalls/cancellation.md:3 +#: src/concurrency/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 " @@ -21907,23 +21777,22 @@ msgstr "" "اطمینان از عملکرد صحیح سیستم حتی در صورت لغو futureها، دقت مناسب لازم است. " "به‌عنوان ‌مثال، نباید داده‌ها را از دست بدهد یا به بن‌بست (deadlock) برسد." -#: src/concurrency/async-pitfalls/cancellation.md:35 -#: src/concurrency/async-pitfalls/cancellation.md:102 +#: src/concurrency/async-pitfalls/cancellation.md #, fuzzy msgid "\"not UTF-8\"" msgstr "\"not UTF-8\"" -#: src/concurrency/async-pitfalls/cancellation.md:51 +#: src/concurrency/async-pitfalls/cancellation.md #, fuzzy msgid "\"hi\\nthere\\n\"" msgstr "\"hi\\nthere\\n\"" -#: src/concurrency/async-pitfalls/cancellation.md:57 +#: src/concurrency/async-pitfalls/cancellation.md #, fuzzy msgid "\"tick!\"" msgstr "\"tick!\"" -#: src/concurrency/async-pitfalls/cancellation.md:73 +#: src/concurrency/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." @@ -21931,7 +21800,7 @@ msgstr "" "کامپایلر در مورد cancellation-safety کمکی نمی‌کند. باید مستندات API را " "بخوانید و در نظر بگیرید که `async fn` شما چه وضعیتی دارد." -#: src/concurrency/async-pitfalls/cancellation.md:76 +#: src/concurrency/async-pitfalls/cancellation.md msgid "" "Unlike `panic` and `?`, cancellation is part of normal control flow (vs " "error-handling)." @@ -21939,29 +21808,29 @@ msgstr "" "برخلاف `panic` و `?`، لغو یا cancellation بخشی از جریان کنترل عادی (و رسیدگی " "به خطا) است." -#: src/concurrency/async-pitfalls/cancellation.md:79 +#: src/concurrency/async-pitfalls/cancellation.md msgid "The example loses parts of the string." msgstr "اسن مثال بخش‌هایی از string را از دست می‌دهد." -#: src/concurrency/async-pitfalls/cancellation.md:81 +#: src/concurrency/async-pitfalls/cancellation.md msgid "" "Whenever the `tick()` branch finishes first, `next()` and its `buf` are " "dropped." msgstr "" "هر زمان که شاخه `tick()` اول تمام شود، `next()` و `buf` آن حذف می شوند." -#: src/concurrency/async-pitfalls/cancellation.md:84 +#: src/concurrency/async-pitfalls/cancellation.md msgid "" "`LinesReader` can be made cancellation-safe by making `buf` part of the " "struct:" msgstr "‏`LinesReader` را می‌توان با تبدیل `buf` به بخشی از ساختار، ایمن کرد:" -#: src/concurrency/async-pitfalls/cancellation.md:98 +#: src/concurrency/async-pitfalls/cancellation.md #, fuzzy msgid "// prefix buf and bytes with self.\n" msgstr "// prefix buf and bytes with self.\n" -#: src/concurrency/async-pitfalls/cancellation.md:108 +#: 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 " @@ -21971,7 +21840,7 @@ msgstr "" "html#method.tick) برای cancellation-safe است زیرا ردیابی می‌کند که آیا یک " "tick تحویل داده شده است." -#: src/concurrency/async-pitfalls/cancellation.md:112 +#: src/concurrency/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 " @@ -21981,7 +21850,7 @@ msgstr "" "AsyncReadExt.html#method.read) برای cancellation-safe است زیرا داده‌ها را " "برمی‌گرداند یا نمی‌خواند." -#: src/concurrency/async-pitfalls/cancellation.md:115 +#: 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_ " @@ -21991,13 +21860,13 @@ msgstr "" "AsyncBufReadExt.html#method.read_line) مشابه مثال است و شبیه cancellation-" "safe نیست. برای جزئیات و موارد جایگزین به مستندات آن مراجعه کنید." -#: src/concurrency/async-exercises/dining-philosophers.md:1 -#: src/concurrency/async-exercises/solutions.md:3 +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "Dining Philosophers --- Async" msgstr "فلسفه Dining --- Async" -#: src/concurrency/async-exercises/dining-philosophers.md:3 +#: src/concurrency/async-exercises/dining-philosophers.md msgid "" "See [dining philosophers](../sync-exercises/dining-philosophers.md) for a " "description of the problem." @@ -22005,7 +21874,7 @@ msgstr "" "برای توضیح مشکل به [dining philosophers](../sync-exercises/dining-" "philosophers.md) مراجعه کنید." -#: src/concurrency/async-exercises/dining-philosophers.md:6 +#: src/concurrency/async-exercises/dining-philosophers.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/" @@ -22015,19 +21884,19 @@ msgstr "" "md) نیاز دارید. کد زیر را در فایلی به نام `src/main.rs` کپی کنید، جاهای خالی " "را پر کنید و تست کنید که `cargo run` به بن بست (`src/main.rs`) نمی‌خورد:" -#: src/concurrency/async-exercises/dining-philosophers.md:37 -#: src/concurrency/async-exercises/solutions.md:29 +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "// Keep trying until we have both forks\n" msgstr "// Keep trying until we have both forks\n" -#: src/concurrency/async-exercises/dining-philosophers.md:52 -#: src/concurrency/async-exercises/solutions.md:85 +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "// Make them think and eat\n" msgstr "// Make them think and eat\n" -#: src/concurrency/async-exercises/dining-philosophers.md:58 +#: 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`:" @@ -22035,7 +21904,7 @@ msgstr "" "از آنجایی که این بار از Async Rust استفاده می‌کنید، به وابستگی `tokio` نیاز " "دارید. می‌توانید از `Cargo.toml` زیر استفاده کنید:" -#: src/concurrency/async-exercises/dining-philosophers.md:63 +#: src/concurrency/async-exercises/dining-philosophers.md msgid "" "```toml\n" "[package]\n" @@ -22059,7 +21928,7 @@ msgstr "" "\"rt-multi-thread\"] }\n" "```" -#: src/concurrency/async-exercises/dining-philosophers.md:73 +#: 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." @@ -22067,11 +21936,11 @@ msgstr "" "همچنین توجه داشته باشید که این بار باید از ماژول `Mutex` و `mpsc` از `tokio` " "crate استفاده کنید." -#: src/concurrency/async-exercises/dining-philosophers.md:79 +#: src/concurrency/async-exercises/dining-philosophers.md msgid "Can you make your implementation single-threaded?" msgstr "آیا می‌توانید پیاده‌سازی خود را تک thread ای کنید؟" -#: src/concurrency/async-exercises/chat-app.md:3 +#: 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 " @@ -22085,7 +21954,7 @@ msgstr "" "استاندارد می‌خواند و آنها را به سرور ارسال می‌کند. سرور چت هر پیامی را که " "دریافت می‌کند برای همه کاربران پخش می‌کند." -#: src/concurrency/async-exercises/chat-app.md:9 +#: 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`]" @@ -22096,15 +21965,16 @@ msgstr "" "sync/broadcast/fn.channel.html) در سمت سرور و [`tokio_websockets`](https://" "docs.rs/tokio-websockets/) برای ارتباط بین کلاینت و سرور." -#: src/concurrency/async-exercises/chat-app.md:12 +#: src/concurrency/async-exercises/chat-app.md msgid "Create a new Cargo project and add the following dependencies:" msgstr "یک پروژه Cargo جدید ایجاد کنید و وابستگی‌های زیر را اضافه کنید:" -#: src/concurrency/async-exercises/chat-app.md:14 +#: src/concurrency/async-exercises/chat-app.md msgid "_Cargo.toml_:" msgstr "_Cargo.toml_:" -#: src/concurrency/async-exercises/chat-app.md:18 +#: src/concurrency/async-exercises/chat-app.md +#, fuzzy msgid "" "```toml\n" "[package]\n" @@ -22115,8 +21985,8 @@ msgid "" "[dependencies]\n" "futures-util = { version = \"0.3.30\", features = [\"sink\"] }\n" "http = \"1.1.0\"\n" -"tokio = { version = \"1.38.1\", features = [\"full\"] }\n" -"tokio-websockets = { version = \"0.8.3\", features = [\"client\", " +"tokio = { version = \"1.40.0\", features = [\"full\"] }\n" +"tokio-websockets = { version = \"0.9.0\", features = [\"client\", " "\"fastrand\", \"server\", \"sha1_smol\"] }\n" "```" msgstr "" @@ -22134,11 +22004,11 @@ msgstr "" "\"fastrand\", \"server\", \"sha1_smol\"] }\n" "```" -#: src/concurrency/async-exercises/chat-app.md:31 +#: src/concurrency/async-exercises/chat-app.md msgid "The required APIs" msgstr "‏API‌های مورد نیاز" -#: src/concurrency/async-exercises/chat-app.md:33 +#: src/concurrency/async-exercises/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 " @@ -22147,7 +22017,7 @@ msgstr "" "شما به توابع زیر از `tokio` و [`tokio_websockets`](https://docs.rs/tokio-" "websockets/) نیاز دارید. چند دقیقه را برای آشنایی با API اختصاص دهید." -#: src/concurrency/async-exercises/chat-app.md:37 +#: 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 " @@ -22157,7 +22027,7 @@ msgstr "" "trait.StreamExt.html#method.next) توسط `WebSocketStream`: برای خواندن " "ناهمزمان پیام‌ها از یک جریان وب سوکت." -#: src/concurrency/async-exercises/chat-app.md:39 +#: 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 " @@ -22167,7 +22037,7 @@ msgstr "" "trait.SinkExt.html#method.send) پیاده‌سازی شده توسط `WebSocketStream`: برای " "ارسال ناهمزمان پیام‌ها در یک Websocket Stream." -#: src/concurrency/async-exercises/chat-app.md:41 +#: 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 " @@ -22177,7 +22047,7 @@ msgstr "" "html#method.next_line): برای خواندن ناهمزمان پیام‌های کاربر از ورودی " "استاندارد." -#: src/concurrency/async-exercises/chat-app.md:43 +#: 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." @@ -22185,11 +22055,11 @@ msgstr "" "‏[Sender::subscribe()](https://docs.rs/tokio/latest/tokio/sync/broadcast/" "struct.Sender.html#method.subscribe): برای اشتراک در یک broadcast channel." -#: src/concurrency/async-exercises/chat-app.md:45 +#: src/concurrency/async-exercises/chat-app.md msgid "Two binaries" msgstr "دو باینری" -#: src/concurrency/async-exercises/chat-app.md:47 +#: src/concurrency/async-exercises/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 " @@ -22207,7 +22077,7 @@ msgstr "" "(به[documentation](https://doc.rust-lang.org/cargo/reference/cargo-targets." "html#binaries) مراجعه کنید )." -#: src/concurrency/async-exercises/chat-app.md:54 +#: src/concurrency/async-exercises/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 " @@ -22217,68 +22087,67 @@ msgstr "" "کپی کنید. وظیفه شما این است که این فایل‌ها را همانطور که در زیر توضیح داده " "شده است تکمیل کنید." -#: src/concurrency/async-exercises/chat-app.md:58 -#: src/concurrency/async-exercises/solutions.md:104 +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md msgid "_src/bin/server.rs_:" msgstr "_src/bin/server.rs_:" -#: src/concurrency/async-exercises/chat-app.md:77 -#: src/concurrency/async-exercises/chat-app.md:124 +#: src/concurrency/async-exercises/chat-app.md #, fuzzy msgid "// TODO: For a hint, see the description of the task below.\n" msgstr "// TODO: For a hint, see the description of the task below.\n" -#: src/concurrency/async-exercises/chat-app.md:85 -#: src/concurrency/async-exercises/solutions.md:154 +#: 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:86 -#: src/concurrency/async-exercises/solutions.md:155 +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "\"listening on port 2000\"" msgstr "\"listening on port 2000\"" -#: src/concurrency/async-exercises/chat-app.md:90 -#: src/concurrency/async-exercises/solutions.md:159 +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "\"New connection from {addr:?}\"" msgstr "\"New connection from {addr:?}\"" -#: src/concurrency/async-exercises/chat-app.md:93 -#: src/concurrency/async-exercises/solutions.md:162 +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "// Wrap the raw TCP stream into a websocket.\n" msgstr "// Wrap the raw TCP stream into a websocket.\n" -#: src/concurrency/async-exercises/chat-app.md:102 -#: src/concurrency/async-exercises/solutions.md:171 +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md msgid "_src/bin/client.rs_:" msgstr "_src/bin/client.rs_:" -#: src/concurrency/async-exercises/chat-app.md:116 -#: src/concurrency/async-exercises/solutions.md:183 +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "\"ws://127.0.0.1:2000\"" msgstr "\"ws://127.0.0.1:2000\"" -#: src/concurrency/async-exercises/chat-app.md:129 +#: src/concurrency/async-exercises/chat-app.md msgid "Running the binaries" msgstr "راه‌اندازی باینری" -#: src/concurrency/async-exercises/chat-app.md:131 +#: src/concurrency/async-exercises/chat-app.md msgid "Run the server with:" msgstr "سرور را راه‌اندازی کنید با استفاده از:" -#: src/concurrency/async-exercises/chat-app.md:137 +#: src/concurrency/async-exercises/chat-app.md msgid "and the client with:" msgstr "و این کلاینت با:" -#: src/concurrency/async-exercises/chat-app.md:145 +#: src/concurrency/async-exercises/chat-app.md msgid "Implement the `handle_connection` function in `src/bin/server.rs`." msgstr "تابع `handle_connection` را در `src/bin/server.rs` پیاده‌سازی کنید." -#: src/concurrency/async-exercises/chat-app.md:146 +#: 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 " @@ -22289,11 +22158,11 @@ msgstr "" "پخش(broadcast) می‌کند. دیگری پیام‌های دریافت شده توسط سرور را برای کاربر ارسال " "می‌کند." -#: src/concurrency/async-exercises/chat-app.md:149 +#: 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:150 +#: src/concurrency/async-exercises/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 " @@ -22304,7 +22173,7 @@ msgstr "" "task استفاده کنید: (۱) خواندن پیام های کاربر از ورودی استاندارد و ارسال آنها " "به سرور و (۲) دریافت پیام از سرور و نمایش آنها برای کاربر." -#: src/concurrency/async-exercises/chat-app.md:154 +#: 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." @@ -22312,7 +22181,7 @@ msgstr "" "اختیاری: پس از اتمام کار، کد را تغییر دهید تا پیام‌ها برای همه کلاینت‌ها، به " "جز فرستنده پیام، منتشر شود." -#: src/concurrency/async-exercises/solutions.md:35 +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "" "// If we didn't get the left fork, drop the right fork if we\n" @@ -22321,7 +22190,7 @@ msgstr "" "// If we didn't get the left fork, drop the right fork if we\n" " // have it and let other tasks make progress.\n" -#: src/concurrency/async-exercises/solutions.md:42 +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "" "// If we didn't get the right fork, drop the left fork and let\n" @@ -22330,27 +22199,27 @@ msgstr "" "// If we didn't get the right fork, drop the left fork and let\n" " // other tasks make progress.\n" -#: src/concurrency/async-exercises/solutions.md:54 +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "// The locks are dropped here\n" msgstr "// The locks are dropped here\n" -#: src/concurrency/async-exercises/solutions.md:82 +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "// tx is dropped here, so we don't need to explicitly drop it later\n" msgstr "// tx is dropped here, so we don't need to explicitly drop it later\n" -#: src/concurrency/async-exercises/solutions.md:97 +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "\"Here is a thought: {thought}\"" msgstr "\"Here is a thought: {thought}\"" -#: src/concurrency/async-exercises/solutions.md:122 +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "\"Welcome to chat! Type a message\"" msgstr "\"Welcome to chat! Type a message\"" -#: src/concurrency/async-exercises/solutions.md:126 +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "" "// A continuous loop for concurrently performing two tasks: (1) receiving\n" @@ -22361,17 +22230,17 @@ msgstr "" " // messages from `ws_stream` and broadcasting them, and (2) receiving\n" " // messages on `bcast_rx` and sending them to the client.\n" -#: src/concurrency/async-exercises/solutions.md:135 +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "\"From client {addr:?} {text:?}\"" msgstr "\"From client {addr:?} {text:?}\"" -#: src/concurrency/async-exercises/solutions.md:190 +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "// Continuous loop for concurrently sending and receiving messages.\n" msgstr "// Continuous loop for concurrently sending and receiving messages.\n" -#: src/concurrency/async-exercises/solutions.md:197 +#: src/concurrency/async-exercises/solutions.md #, fuzzy msgid "\"From server: {}\"" msgstr "\"From server: {}\"" @@ -22423,6 +22292,13 @@ msgstr "" "argument: \n" "اطلاعاتی که به یک تابع یا متد منتقل می‌شود." +#: src/glossary.md +msgid "" +"associated type: \n" +"A type associated with a specific trait. Useful for defining the " +"relationship between types." +msgstr "" + #: src/glossary.md msgid "" "Bare-metal Rust: \n" @@ -23181,11 +23057,12 @@ msgstr "" "پوشش داده شده است." #: src/other-resources.md +#, fuzzy msgid "" -"[Advanced testing for Rust applications](https://github.com/mainmatter/rust-" -"advanced-testing-workshop): 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." +"[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 "" "‏ [تست پیشرفته برای برنامه‌های Rust](https://github.com/mainmatter/rust-" "advanced-testing-workshop): کارگاهی خودآموز که فراتر از چارچوب تست داخلی " @@ -23286,6 +23163,102 @@ msgstr "" "از [CXX](https://cxx.rs/) استفاده می‌کند. لطفاً برای جزئیات، از جمله شرایط " "license، دایرکتوری `third_party/cxx/` را ببینید." +#~ msgid "Slices: `&[T]`" +#~ msgstr "برش ها: `&[T]`" + +#~ msgid "Slices: &\\[T\\]" +#~ msgstr "برش‌ها: `[T]&`" + +#~ msgid "" +#~ "By default, closures will capture by reference if they can. The `move` " +#~ "keyword makes them capture by value." +#~ msgstr "" +#~ "به‌طور پیش‌فرض، closure ها اگر بتوانند، با ارجاع (reference) مقادیر را " +#~ "می‌گیرند. کلمه کلیدی `move` باعث می‌شود که آنها مقادیر را به‌صورت مالکیت (by " +#~ "value) بگیرند." + +#~ msgid "" +#~ "There is a plan to transition [Android](https://source.android.com/docs/" +#~ "setup/build/bazel/introduction), [ChromeOS](https://chromium.googlesource." +#~ "com/chromiumos/bazel/), and [Fuchsia](https://source.android.com/docs/" +#~ "setup/build/bazel/introduction) to Bazel." +#~ msgstr "" +#~ "برنامه‌ای برای انتقال [Android](https://source.android.com/docs/setup/" +#~ "build/bazel/introduction)، [ChromeOS](https://chromium.googlesource.com/" +#~ "chromiumos/bazel/) وجود دارد و انتقال [Fuchsia](https://source.android." +#~ "com/docs/setup/build/bazel/introduction) به Bazel." + +#~ msgid "" +#~ "Learning Bazel-like build rules is useful for all Rust OS developers." +#~ msgstr "" +#~ "یادگیری قوانین ساخت Bazel-like برای همه توسعه‌دهندگان Rust OS مفید است." + +#~ msgid "" +#~ "Threads are all daemon threads, the main thread does not wait for them." +#~ msgstr "‏Thread‌ها همه daemon thread هستند و main thread منتظر آنها نیست." + +#, fuzzy +#~ msgid "\"Felix\"" +#~ msgstr "\"Felix\"" + +#, fuzzy +#~ msgid "\"Failed to send cat.\"" +#~ msgstr "\"Failed to send cat.\"" + +#, fuzzy +#~ msgid "\"Failed to send dog.\"" +#~ msgstr "\"Failed to send dog.\"" + +#, fuzzy +#~ msgid "\"Failed to receive winner\"" +#~ msgstr "\"Failed to receive winner\"" + +#, fuzzy +#~ msgid "\"Winner is {winner:?}\"" +#~ msgstr "\"Winner is {winner:?}\"" + +#~ 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` " +#~ "به هر دو channelها گوش می‌دهد و هر کدام را زودتر وارد شوند را انتخاب می‌کند." +#~ "بنابراین سگ ۵۰ میلی‌ثانیه طول می‌کشد، در برابر گربه‌ای که ۵۰۰ میلی‌ثانیه طول " +#~ "می‌کشد تا پیروز شود." + +#~ msgid "" +#~ "You can use `oneshot` channels in this example as the channels are " +#~ "supposed to receive only one `send`." +#~ msgstr "" +#~ "در این مثال می‌توانید از کانال‌های `oneshot` استفاده کنید زیرا قرار است " +#~ "کانال‌ها فقط یک `send` را دریافت کنند." + +#~ msgid "" +#~ "Try adding a deadline to the race, demonstrating selecting different " +#~ "sorts of futures." +#~ msgstr "" +#~ "سعی کنید یک ضرب الاجل به رقابت اضافه کنید و انتخاب انواع مختلف future را " +#~ "نشان دهید." + +#~ 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!` شاخه‌های (branch) بی‌همتا را حذف می کند و " +#~ "future آنها را لغو می‌کند. زمانی که هر اجرای `select!` می‌تواند future‌های " +#~ "جدیدی ایجاد می‌کند، راحت‌ترین استفاده از آن است." + +#~ 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` استفاده " +#~ "کنید، اما این کار می‌تواند منجر به مسائلی شود که بیشتر در اسلاید سنجاق " +#~ "(pinning slide) شده بحث شده است." + #~ msgid "1 hour and 20 minutes" #~ msgstr "۱ ساعت و ۲۰ دقیقه" From 3637c44a5d9788cbab1c94e2d5dad77e2c8f0d21 Mon Sep 17 00:00:00 2001 From: xrdelectro Date: Thu, 12 Sep 2024 17:53:54 +0300 Subject: [PATCH 2/3] Fix typo in box.md (#2362) --- src/smart-pointers/box.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/smart-pointers/box.md b/src/smart-pointers/box.md index bed5b404368..b481f46ba27 100644 --- a/src/smart-pointers/box.md +++ b/src/smart-pointers/box.md @@ -68,8 +68,8 @@ fn main() { - `Box` is like `std::unique_ptr` in C++, except that it's guaranteed to be not null. - A `Box` can be useful when you: - - have a type whose size that can't be known at compile time, but the Rust - compiler wants to know an exact size. + - have a type whose size can't be known at compile time, but the Rust compiler + wants to know an exact size. - want to transfer ownership of a large amount of data. To avoid copying large amounts of data on the stack, instead store the data on the heap in a `Box` so only the pointer is moved. From c5f9e5337b44c5e4cb9e815483516bd3b5d2ecbf Mon Sep 17 00:00:00 2001 From: Willow Carretero Chavez Date: Thu, 12 Sep 2024 11:33:38 -0400 Subject: [PATCH 3/3] es: Spanish translation refresh (#2232) Fixes #2120. --- po/es.po | 26295 ++++++++++++++++++++++++++++------------------------- 1 file changed, 13989 insertions(+), 12306 deletions(-) diff --git a/po/es.po b/po/es.po index 4e32a4e5ab2..cc143dae529 100644 --- a/po/es.po +++ b/po/es.po @@ -1,7 +1,7 @@ msgid "" msgstr "" "Project-Id-Version: Comprehensive Rust 🦀\n" -"POT-Creation-Date: 2024-01-25T15:03:24-08:00\n" +"POT-Creation-Date: 2024-07-19T19:45:30Z\n" "PO-Revision-Date: \n" "Last-Translator: \n" "Language-Team: \n" @@ -10,6 +10,8 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" +"X-Generator: Poedit 3.4.2\n" +"X-Poedit-Bookmarks: -1,304,-1,-1,-1,-1,-1,-1,-1,-1\n" #: src/SUMMARY.md src/index.md msgid "Welcome to Comprehensive Rust 🦀" @@ -51,51 +53,52 @@ msgstr "Ejecutar Cargo a nivel local" msgid "Day 1: Morning" msgstr "Día 1: mañana" -#: 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 "Te damos la bienvenida" -#: 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 "Hola, Mundo" -#: 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 "¿Qué es 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 "Ventajas de Rust" -#: src/SUMMARY.md src/hello-world/playground.md +#: src/SUMMARY.md src/hello-world.md src/hello-world/playground.md msgid "Playground" msgstr "Playground" -#: 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 "Tipos y valores" -#: 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 "Variables" -#: 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 "Valores" -#: 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 "Aritmética" -#: src/SUMMARY.md src/types-and-values/strings.md -msgid "Strings" -msgstr "Cadenas de texto (_Strings_)" - -#: 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 "Inferencia de tipos" -#: 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 "Ejercicio: Fibonacci" @@ -106,42 +109,61 @@ msgstr "Ejercicio: Fibonacci" #: 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 "Solución" -#: src/SUMMARY.md src/control-flow-basics.md -#, fuzzy +#: 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 "Control de Flujo" +msgstr "Básicos de Control de Flujo" -#: src/SUMMARY.md src/control-flow-basics/conditionals.md -msgid "Conditionals" -msgstr "Condicionales" +#: src/SUMMARY.md +msgid "`if` Expressions" +msgstr "Expresiones `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 "Bucles `for`" +msgstr "Bucles" + +#: 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` y `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 "Etiquetas" + +#: src/SUMMARY.md src/control-flow-basics.md +#: src/control-flow-basics/blocks-and-scopes.md msgid "Blocks and Scopes" msgstr "Bloques y ámbitos" -#: 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 "Ámbitos y _Shadowing_" + +#: src/SUMMARY.md src/control-flow-basics.md +#: src/control-flow-basics/functions.md msgid "Functions" msgstr "Funciones" -#: 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 "Macros" -#: 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 "Ejercicio: secuencia de Collatz" @@ -149,70 +171,90 @@ msgstr "Ejercicio: secuencia de Collatz" msgid "Day 1: Afternoon" msgstr "Día 1: Tarde" -#: 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 "Tuplas y arrays" -#: 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 "Arrays" + +#: src/SUMMARY.md src/tuples-and-arrays.md src/tuples-and-arrays/tuples.md +msgid "Tuples" +msgstr "Tuplas" + +#: src/SUMMARY.md src/tuples-and-arrays.md src/tuples-and-arrays/iteration.md msgid "Array Iteration" msgstr "Iteración de Arreglos (_Arrays_)" -#: src/SUMMARY.md src/tuples-and-arrays/match.md src/pattern-matching.md -msgid "Pattern Matching" -msgstr "Correspondencia de Patrones" - -#: src/SUMMARY.md src/tuples-and-arrays/destructuring.md -#: src/pattern-matching/destructuring.md -msgid "Destructuring" -msgstr "Desestructuración" +#: src/SUMMARY.md src/tuples-and-arrays.md +#: src/tuples-and-arrays/destructuring.md +msgid "Patterns and Destructuring" +msgstr "Patrones y Desestructuración" -#: 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 "Ejercicio: arrays anidados" -#: 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 "Referencias" -#: src/SUMMARY.md src/references/shared.md +#: src/SUMMARY.md src/references.md src/references/shared.md msgid "Shared References" msgstr "Enums compartidas" -#: src/SUMMARY.md src/references/exclusive.md +#: src/SUMMARY.md src/references.md src/references/exclusive.md msgid "Exclusive References" msgstr "Referencias exclusivas" -#: src/SUMMARY.md src/references/exercise.md +#: src/SUMMARY.md +msgid "Slices: `&[T]`" +msgstr "Slices: `&[T]`" + +#: src/SUMMARY.md src/references.md src/references/strings.md +msgid "Strings" +msgstr "Cadenas de texto (_Strings_)" + +#: src/SUMMARY.md src/references.md src/references/exercise.md msgid "Exercise: Geometry" msgstr "Ejercicio: geometría" -#: 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 "Tipos definidos por el usuario" -#: 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 msgid "Named Structs" msgstr "Estructuras con nombre" -#: 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 "Estructuras de tuplas" -#: 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 "Enumeraciones" -#: src/SUMMARY.md src/user-defined-types/static-and-const.md -msgid "Static and Const" -msgstr "Estático y Constantes (_Static y Const_)" +#: src/SUMMARY.md src/user-defined-types.md +msgid "Static" +msgstr "Estático" + +#: src/SUMMARY.md +msgid "Const" +msgstr "Const (constantes)" -#: 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 "Alias de tipo" +msgstr "Aliases de tipo" -#: 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 "Ejercicio: eventos de ascensor" @@ -220,54 +262,87 @@ msgstr "Ejercicio: eventos de ascensor" msgid "Day 2: Morning" msgstr "Día 2: Mañana" -#: src/SUMMARY.md src/pattern-matching/let-control-flow.md -#, fuzzy +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-2.md src/pattern-matching.md +msgid "Pattern Matching" +msgstr "Correspondencia de Patrones" + +#: src/SUMMARY.md src/pattern-matching.md src/pattern-matching/match.md +msgid "Matching Values" +msgstr "Correspondencia de Valores" + +#: src/SUMMARY.md src/pattern-matching.md +msgid "Destructuring Structs" +msgstr "Desestructurando Structs" + +#: src/SUMMARY.md src/pattern-matching.md +msgid "Destructuring Enums" +msgstr "Desestructurando Enums" + +#: src/SUMMARY.md src/pattern-matching.md +#: src/pattern-matching/let-control-flow.md msgid "Let Control Flow" -msgstr "Control de Flujo" +msgstr "Control de Flujo _Let_" -#: 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 "Ejercicio: evaluación de expresiones" -#: src/SUMMARY.md src/methods-and-traits.md -#, fuzzy +#: 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 "Read y Write" +msgstr "Métodos y Traits" -#: 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 "Métodos" -#: 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 "Traits" -#: src/SUMMARY.md src/methods-and-traits/deriving.md -#, fuzzy +#: src/SUMMARY.md src/methods-and-traits/traits/implementing.md +msgid "Implementing Traits" +msgstr "Implementación de Traits" + +#: src/SUMMARY.md src/methods-and-traits/traits/supertraits.md +msgid "Supertraits" +msgstr "Supertraits" + +#: src/SUMMARY.md src/methods-and-traits/traits/associated-types.md +msgid "Associated Types" +msgstr "Tipos de datos asociados" + +#: src/SUMMARY.md src/methods-and-traits.md src/methods-and-traits/deriving.md msgid "Deriving" msgstr "Derivación de Traits" -#: src/SUMMARY.md src/methods-and-traits/trait-objects.md -msgid "Trait Objects" -msgstr "Objetos Trait" - -#: src/SUMMARY.md src/methods-and-traits/exercise.md +#: src/SUMMARY.md src/methods-and-traits.md msgid "Exercise: Generic Logger" msgstr "Ejercicio: registro genérico" -#: src/SUMMARY.md src/generics.md +#: src/SUMMARY.md +msgid "Day 2: Afternoon" +msgstr "Día 2: tarde" + +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-2-afternoon.md src/generics.md msgid "Generics" msgstr "Genéricos" -#: src/SUMMARY.md src/generics/generic-functions.md +#: src/SUMMARY.md src/generics.md src/generics/generic-functions.md msgid "Generic Functions" msgstr "Funciones genéricas" -#: src/SUMMARY.md src/generics/generic-data.md +#: src/SUMMARY.md src/generics.md src/generics/generic-data.md msgid "Generic Data Types" msgstr "Tipos de Datos Genéricos" -#: src/SUMMARY.md src/generics/trait-bounds.md +#: src/SUMMARY.md src/generics/generic-traits.md +msgid "Generic Traits" +msgstr "Traits Genéricos" + +#: src/SUMMARY.md src/generics.md src/generics/trait-bounds.md msgid "Trait Bounds" msgstr "Trait Bounds" @@ -275,23 +350,24 @@ msgstr "Trait Bounds" msgid "`impl Trait`" msgstr "`impl Trait`" +#: src/SUMMARY.md src/generics/dyn-trait.md +msgid "`dyn Trait`" +msgstr "`dyn Trait`" + #: src/SUMMARY.md src/generics/exercise.md msgid "Exercise: Generic `min`" msgstr "Ejercicio: `min` genérico" -#: src/SUMMARY.md -msgid "Day 2: Afternoon" -msgstr "Día 2: tarde" - -#: 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 msgid "Standard Library Types" msgstr "Tipos de la Biblioteca Estándar" -#: src/SUMMARY.md src/std-types/std.md +#: src/SUMMARY.md src/std-types.md src/std-types/std.md msgid "Standard Library" msgstr "Biblioteca estándar" -#: src/SUMMARY.md src/std-types/docs.md +#: src/SUMMARY.md src/std-types.md src/std-types/docs.md msgid "Documentation" msgstr "Documentación" @@ -299,11 +375,12 @@ msgstr "Documentación" 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`" @@ -315,20 +392,21 @@ msgstr "`Vec` (_Vectores_)" 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 "Ejercicio: Contador" -#: src/SUMMARY.md src/std-traits.md -#, fuzzy +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-2-afternoon.md src/std-traits.md msgid "Standard Library Traits" -msgstr "Biblioteca estándar" +msgstr "Traits de la biblioteca estándar" -#: 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 "Comparaciones" -#: src/SUMMARY.md src/std-traits/operators.md +#: src/SUMMARY.md src/std-traits.md src/std-traits/operators.md msgid "Operators" msgstr "Operadores" @@ -336,8 +414,7 @@ msgstr "Operadores" msgid "`From` and `Into`" msgstr "`From` e `Into`" -#: src/SUMMARY.md src/std-traits/casting.md -#, fuzzy +#: src/SUMMARY.md src/std-traits.md src/std-traits/casting.md msgid "Casting" msgstr "Probando" @@ -349,11 +426,11 @@ msgstr "`Read` y `Write`" msgid "`Default`, struct update syntax" msgstr "`Default`, sintaxis de actualización de structs" -#: src/SUMMARY.md src/std-traits/closures.md +#: src/SUMMARY.md src/std-traits.md src/std-traits/closures.md msgid "Closures" msgstr "Cierres" -#: src/SUMMARY.md src/std-traits/exercise.md +#: src/SUMMARY.md src/std-traits.md src/std-traits/exercise.md msgid "Exercise: ROT13" msgstr "Ejercicio: ROT13" @@ -361,24 +438,24 @@ msgstr "Ejercicio: ROT13" msgid "Day 3: Morning" msgstr "Día 3: Mañana" -#: 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 "Manejo de Memoria" -#: 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 "Revisión de la memoria de programas" -#: src/SUMMARY.md src/memory-management/approaches.md -#, fuzzy +#: src/SUMMARY.md src/memory-management.md src/memory-management/approaches.md msgid "Approaches to Memory Management" -msgstr "Gestión Automática de la Memoria" +msgstr "Métodos de Gestión de Memoria" -#: src/SUMMARY.md src/memory-management/ownership.md +#: src/SUMMARY.md src/memory-management.md src/memory-management/ownership.md msgid "Ownership" msgstr "Ownership" -#: src/SUMMARY.md src/memory-management/move.md +#: src/SUMMARY.md src/memory-management.md src/memory-management/move.md msgid "Move Semantics" msgstr "Semántica de movimiento" @@ -386,20 +463,20 @@ msgstr "Semántica de movimiento" msgid "`Clone`" msgstr "Trait `Clone`" -#: src/SUMMARY.md src/memory-management/copy-types.md -#, fuzzy +#: src/SUMMARY.md src/memory-management.md src/memory-management/copy-types.md msgid "Copy Types" -msgstr "Tipos compuestos" +msgstr "Tipos Copy" #: src/SUMMARY.md msgid "`Drop`" msgstr "Trait `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 "Ejercicio: Constructores" -#: 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 "Punteros inteligentes" @@ -412,7 +489,11 @@ 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 +msgid "Owned Trait Objects" +msgstr "Objetos Trait Poseídos" + +#: src/SUMMARY.md src/smart-pointers.md src/smart-pointers/exercise.md msgid "Exercise: Binary Tree" msgstr "Ejercicio: Árbol binario" @@ -420,59 +501,49 @@ msgstr "Ejercicio: Árbol binario" msgid "Day 3: Afternoon" msgstr "Día 3: Tarde" -#: 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 "Préstamos (_Borrowing_)" -#: src/SUMMARY.md src/borrowing/shared.md -#, fuzzy +#: src/SUMMARY.md src/borrowing.md src/borrowing/shared.md msgid "Borrowing a Value" -msgstr "Préstamos (_Borrowing_)" +msgstr "Emprestar (_borrow_) un valor" -#: src/SUMMARY.md src/borrowing/borrowck.md -#, fuzzy +#: src/SUMMARY.md src/borrowing.md src/borrowing/borrowck.md msgid "Borrow Checking" -msgstr "Préstamos (_Borrowing_)" +msgstr "Verificación de Préstamos" -#: src/SUMMARY.md src/borrowing/interior-mutability.md -#, fuzzy +#: src/SUMMARY.md src/borrowing.md src/borrowing/examples.md +msgid "Borrow Errors" +msgstr "Errores de Préstamo" + +#: src/SUMMARY.md src/borrowing.md src/borrowing/interior-mutability.md msgid "Interior Mutability" -msgstr "Interoperabilidad" +msgstr "Mutabilidad Interior" -#: src/SUMMARY.md src/borrowing/exercise.md +#: src/SUMMARY.md src/borrowing.md src/borrowing/exercise.md msgid "Exercise: Health Statistics" msgstr "Ejercicio: Estadísticas de Salud" -#: src/SUMMARY.md src/slices-and-lifetimes.md -#, fuzzy -msgid "Slices and Lifetimes" -msgstr "Tiempos de vida" - -#: src/SUMMARY.md -msgid "Slices: `&[T]`" -msgstr "Slices: `&[T]`" - -#: src/SUMMARY.md src/slices-and-lifetimes/str.md -#, fuzzy -msgid "String References" -msgstr "Referencias colgantes" +#: src/SUMMARY.md src/running-the-course/course-structure.md +#: src/welcome-day-3-afternoon.md src/lifetimes.md +msgid "Lifetimes" +msgstr "Duraciones de vida" -#: src/SUMMARY.md src/slices-and-lifetimes/lifetime-annotations.md -#, fuzzy +#: src/SUMMARY.md src/lifetimes.md src/lifetimes/lifetime-annotations.md msgid "Lifetime Annotations" -msgstr "Tiempos de Vida en Llamadas a Función" +msgstr "Anotaciones de duración de vida" -#: src/SUMMARY.md -#, fuzzy +#: src/SUMMARY.md src/lifetimes.md msgid "Lifetime Elision" -msgstr "Tiempos de vida" +msgstr "Elisión de duración de vida" -#: src/SUMMARY.md -#, fuzzy +#: src/SUMMARY.md src/lifetimes.md msgid "Struct Lifetimes" -msgstr "Tiempos de vida" +msgstr "Duraciones de vida de estructuras (_structs_)" -#: src/SUMMARY.md src/slices-and-lifetimes/exercise.md +#: src/SUMMARY.md src/lifetimes.md src/lifetimes/exercise.md msgid "Exercise: Protobuf Parsing" msgstr "Ejercicio: Análisis de Protobuf" @@ -480,7 +551,8 @@ msgstr "Ejercicio: Análisis de Protobuf" msgid "Day 4: Morning" msgstr "Día 4: Mañana" -#: 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 "Iteradores" @@ -493,23 +565,23 @@ msgid "`IntoIterator`" msgstr "`IntoIterator`" #: src/SUMMARY.md -#, fuzzy msgid "`FromIterator`" -msgstr "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 "Ejercicio: Encadenamiento de métodos del iterador" -#: 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 msgid "Modules" msgstr "Módulos" -#: src/SUMMARY.md src/modules/filesystem.md +#: src/SUMMARY.md src/modules.md src/modules/filesystem.md msgid "Filesystem Hierarchy" msgstr "Jerarquía del sistema de archivos" -#: src/SUMMARY.md src/modules/visibility.md +#: src/SUMMARY.md src/modules.md src/modules/visibility.md msgid "Visibility" msgstr "Visibilidad" @@ -517,39 +589,28 @@ msgstr "Visibilidad" 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 msgid "Exercise: Modules for a GUI Library" msgstr "Ejercicio: Módulos para una biblioteca GUI" -#: 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 "Probando" -#: src/SUMMARY.md +#: src/SUMMARY.md src/testing.md msgid "Test Modules" msgstr "Módulos de Pruebas" -#: src/SUMMARY.md src/testing/other.md +#: src/SUMMARY.md src/testing.md src/testing/other.md msgid "Other Types of Tests" msgstr "Otros tipos de pruebas" -#: src/SUMMARY.md src/testing/useful-crates.md -msgid "Useful Crates" -msgstr "Crates útiles" - -#: src/SUMMARY.md src/testing/googletest.md -msgid "GoogleTest" -msgstr "GoogleTest" - -#: src/SUMMARY.md src/testing/mocking.md -msgid "Mocking" -msgstr "Simulaciones" - -#: src/SUMMARY.md src/testing/lints.md +#: src/SUMMARY.md src/testing.md src/testing/lints.md msgid "Compiler Lints and Clippy" msgstr "Lints de compiladores y Clippy" -#: src/SUMMARY.md src/testing/exercise.md +#: src/SUMMARY.md src/testing.md src/testing/exercise.md msgid "Exercise: Luhn Algorithm" msgstr "Ejercicio: Algoritmo de Luhn" @@ -557,68 +618,65 @@ msgstr "Ejercicio: Algoritmo de Luhn" msgid "Day 4: Afternoon" msgstr "Día 4: Tarde" -#: 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 "Manejo de Errores" -#: src/SUMMARY.md src/error-handling/panics.md +#: src/SUMMARY.md src/error-handling.md src/error-handling/panics.md msgid "Panics" msgstr "Pánicos" -#: src/SUMMARY.md src/error-handling/try.md -#, fuzzy +#: src/SUMMARY.md src/error-handling.md src/error-handling/try.md msgid "Try Operator" -msgstr "Iteradores" +msgstr "Operador `Try` (Intentar)" -#: src/SUMMARY.md src/error-handling/try-conversions.md -#, fuzzy +#: src/SUMMARY.md src/error-handling.md src/error-handling/try-conversions.md msgid "Try Conversions" -msgstr "Conversiones Implícitas" +msgstr "Conversiones `Try` (Intentar)" #: src/SUMMARY.md -#, fuzzy msgid "`Error` Trait" -msgstr "`Error`" +msgstr "Trait `Error`" #: src/SUMMARY.md src/error-handling/thiserror-and-anyhow.md -#, fuzzy msgid "`thiserror` and `anyhow`" -msgstr "`From` e `Into`" +msgstr "`thiserror` y `anyhow`" #: src/SUMMARY.md msgid "Exercise: Rewriting with `Result`" msgstr "Ejercicio: Reescribir con `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 msgid "Unsafe" msgstr "Unsafe" -#: 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 "Dereferenciación de Punteros Sin Formato" -#: 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 "Variables Estáticas Mutables" -#: src/SUMMARY.md src/unsafe-rust/unions.md +#: src/SUMMARY.md src/unsafe-rust.md src/unsafe-rust/unions.md msgid "Unions" msgstr "Uniones" -#: src/SUMMARY.md src/unsafe-rust/unsafe-functions.md -#, fuzzy +#: src/SUMMARY.md src/unsafe-rust.md src/unsafe-rust/unsafe-functions.md msgid "Unsafe Functions" -msgstr "Llamar Funciones Unsafe (Inseguras)" +msgstr "Funciones Inseguras (_Unsafe_)" -#: src/SUMMARY.md +#: src/SUMMARY.md src/unsafe-rust.md msgid "Unsafe Traits" msgstr "Implementación de Traits Unsafe (Inseguras)" -#: src/SUMMARY.md +#: src/SUMMARY.md src/unsafe-rust.md msgid "Exercise: FFI Wrapper" msgstr "Ejercicio: Envoltorio de FFI" @@ -646,19 +704,27 @@ msgstr "Biblioteca" msgid "AIDL" msgstr "AIDL" +#: src/SUMMARY.md src/android/aidl/birthday-service.md +msgid "Birthday Service Tutorial" +msgstr "Tutorial de Servicio de Cumpleaños" + #: src/SUMMARY.md msgid "Interface" msgstr "Interfaz" #: src/SUMMARY.md -msgid "Implementation" -msgstr "Implementación" +msgid "Service API" +msgstr "API de Servicios" + +#: src/SUMMARY.md +msgid "Service" +msgstr "Servicio" #: src/SUMMARY.md msgid "Server" msgstr "Servidor" -#: src/SUMMARY.md src/android/aidl/deploy.md +#: src/SUMMARY.md src/android/aidl/example-service/deploy.md msgid "Deploy" msgstr "Despliegue" @@ -666,10 +732,46 @@ msgstr "Despliegue" msgid "Client" msgstr "Cliente" -#: src/SUMMARY.md src/android/aidl/changing.md +#: src/SUMMARY.md src/android/aidl/example-service/changing-definition.md msgid "Changing API" msgstr "Cambio de API" +#: src/SUMMARY.md +msgid "Updating Implementations" +msgstr "Actualizando Implementaciones" + +#: src/SUMMARY.md +msgid "AIDL Types" +msgstr "Tipos AIDL" + +#: src/SUMMARY.md src/android/aidl/types/primitives.md +msgid "Primitive Types" +msgstr "Tipos Primitivos" + +#: src/SUMMARY.md src/android/aidl/types/arrays.md +msgid "Array Types" +msgstr "Tipos Array" + +#: src/SUMMARY.md src/android/aidl/types/objects.md +msgid "Sending Objects" +msgstr "Enviando Objectos" + +#: src/SUMMARY.md src/android/aidl/types/parcelables.md +msgid "Parcelables" +msgstr "Variables" + +#: src/SUMMARY.md src/android/aidl/types/file-descriptor.md +msgid "Sending Files" +msgstr "Enviando Archívos" + +#: src/SUMMARY.md src/android/testing/googletest.md +msgid "GoogleTest" +msgstr "GoogleTest" + +#: src/SUMMARY.md src/android/testing/mocking.md +msgid "Mocking" +msgstr "Simulaciones" + #: src/SUMMARY.md src/android/logging.md src/bare-metal/aps/logging.md msgid "Logging" msgstr "Almacenamiento de registros" @@ -695,13 +797,12 @@ msgid "With C++" msgstr "Con C++" #: src/SUMMARY.md src/android/interoperability/cpp/bridge.md -#, fuzzy msgid "The Bridge Module" -msgstr "Módulos de Pruebas" +msgstr "El Modulo Puente (_Bridge_)" #: src/SUMMARY.md msgid "Rust Bridge" -msgstr "Rust Bridge" +msgstr "Rust Bridge (_Puente_)" #: src/SUMMARY.md src/android/interoperability/cpp/generated-cpp.md msgid "Generated C++" @@ -717,7 +818,7 @@ msgstr "Tipos de datos compartidos" #: src/SUMMARY.md src/android/interoperability/cpp/shared-enums.md msgid "Shared Enums" -msgstr "Enums compartidas" +msgstr "Enums compartidos" #: src/SUMMARY.md src/android/interoperability/cpp/rust-result.md msgid "Rust Error Handling" @@ -747,9 +848,11 @@ msgstr "Compilar en Android: Rust" msgid "With Java" msgstr "Con 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 "Ejercicios" @@ -766,9 +869,8 @@ msgid "Policy" msgstr "Política" #: src/SUMMARY.md -#, fuzzy msgid "Unsafe Code" -msgstr "Unsafe Rust" +msgstr "Código inseguro" #: src/SUMMARY.md src/chromium/build-rules/depending.md msgid "Depending on Rust Code from Chromium C++" @@ -795,12 +897,10 @@ msgid "`chromium::import!` Macro" msgstr "Macro `chromium::import!`" #: src/SUMMARY.md src/chromium/interoperability-with-cpp.md -#, fuzzy msgid "Interoperability with C++" -msgstr "Interoperabilidad con C" +msgstr "Interoperabilidad con C++" #: src/SUMMARY.md src/chromium/interoperability-with-cpp/example-bindings.md -#, fuzzy msgid "Example Bindings" msgstr "Ejemplos" @@ -932,9 +1032,8 @@ msgid "`embedded-hal`" msgstr "`embedded-hal`" #: src/SUMMARY.md src/bare-metal/microcontrollers/probe-rs.md -#, fuzzy msgid "`probe-rs` and `cargo-embed`" -msgstr "`probe-rs`, `cargo-embed`" +msgstr "`probe-rs` y `cargo-embed`" #: src/SUMMARY.md src/bare-metal/microcontrollers/debugging.md msgid "Debugging" @@ -949,7 +1048,10 @@ msgstr "Otros proyectos" msgid "Compass" msgstr "Brújula" -#: 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 "Soluciones" @@ -1001,10 +1103,14 @@ msgstr "Conductor" msgid "Using It" msgstr "Cómo usarlo" -#: 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 "Excepciones" +#: src/SUMMARY.md +msgid "Useful Crates" +msgstr "Crates útiles" + #: src/SUMMARY.md src/bare-metal/useful-crates/zerocopy.md msgid "`zerocopy`" msgstr "`zerocopy`" @@ -1026,9 +1132,8 @@ msgid "`spin`" msgstr "`spin`" #: src/SUMMARY.md -#, fuzzy msgid "`vmbase`" -msgstr "vmbase" +msgstr "`vmbase`" #: src/SUMMARY.md msgid "RTC Driver" @@ -1038,23 +1143,36 @@ msgstr "Controlador RTC" msgid "Concurrency: Morning" msgstr "Concurrencia: mañana" -#: 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 "Hilos" -#: src/SUMMARY.md src/concurrency/scoped-threads.md +#: src/SUMMARY.md src/concurrency/threads.md src/concurrency/threads/plain.md +msgid "Plain Threads" +msgstr "Hilos Simples" + +#: src/SUMMARY.md src/concurrency/threads.md src/concurrency/threads/scoped.md msgid "Scoped Threads" msgstr "Hilos con ámbito" -#: 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 "Canales" -#: src/SUMMARY.md src/concurrency/channels/unbounded.md +#: src/SUMMARY.md src/concurrency/channels.md +#: src/concurrency/channels/senders-receivers.md +msgid "Senders and Receivers" +msgstr "Transmisores y Receptores" + +#: src/SUMMARY.md src/concurrency/channels.md +#: src/concurrency/channels/unbounded.md msgid "Unbounded Channels" msgstr "Canales sin límites" -#: src/SUMMARY.md src/concurrency/channels/bounded.md +#: src/SUMMARY.md src/concurrency/channels.md +#: src/concurrency/channels/bounded.md msgid "Bounded Channels" msgstr "Canales delimitados" @@ -1062,6 +1180,11 @@ msgstr "Canales delimitados" msgid "`Send` and `Sync`" msgstr "`Send` y `Sync`" +#: src/SUMMARY.md src/concurrency/send-sync.md +#: src/concurrency/send-sync/marker-traits.md +msgid "Marker Traits" +msgstr "Traits de Marcador" + #: src/SUMMARY.md src/concurrency/send-sync/send.md msgid "`Send`" msgstr "`Send`" @@ -1070,34 +1193,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 "Ejemplos" -#: 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 "Estado compartido" -#: 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 "Ejemplo" -#: 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 "La cena de los filósofos" -#: 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 "Comprobador de enlaces multihilo" @@ -1105,69 +1233,79 @@ msgstr "Comprobador de enlaces multihilo" msgid "Concurrency: Afternoon" msgstr "Concurrencia: tarde" -#: 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 "Conceptos básicos de 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 "Runtimes (Tiempos de Ejecución)" -#: 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 "Tasks" -#: 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 +msgid "Channels and Control Flow" +msgstr "Canales y Control de Flujo" + +#: src/SUMMARY.md src/concurrency/async-control-flow.md +#: src/concurrency/async-control-flow/channels.md msgid "Async Channels" msgstr "Canales asíncronos" -#: src/SUMMARY.md -msgid "Control Flow" -msgstr "Control de Flujo" - -#: 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 "Unir" -#: 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 "Seleccionar" -#: 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 "Inconvenientes" -#: src/SUMMARY.md +#: src/SUMMARY.md src/concurrency/async-pitfalls.md msgid "Blocking the Executor" msgstr "Bloqueo del ejecutor" -#: 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 "Traits asíncronos" -#: src/SUMMARY.md src/async/pitfalls/cancellation.md +#: src/SUMMARY.md src/concurrency/async-pitfalls.md +#: src/concurrency/async-pitfalls/cancellation.md msgid "Cancellation" msgstr "Cancelación" -#: 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 "Aplicación de chat de difusión" @@ -1177,8 +1315,9 @@ msgstr "Conclusiones" #: src/SUMMARY.md src/thanks.md msgid "Thanks!" -msgstr "Gracias." +msgstr "¡Gracias!" +#. Please keep { #glossary } untranslated. #: src/SUMMARY.md src/glossary.md msgid "Glossary" msgstr "Glosario" @@ -1202,14 +1341,14 @@ msgid "" "io/github/stars/google/comprehensive-rust?style=flat-square)](https://github." "com/google/comprehensive-rust/stargazers)" msgstr "" -"[![Crear flujo de trabajo](https://img.shields.io/github/actions/workflow/" -"status/google/comprehensive-rust/build.yml?style=flat-square)](https://" -"github.com/google/comprehensive-rust/actions/workflows/build.yml?" -"query=branch%3Amain) [![Colaboradores de GitHub](https://img.shields.io/" -"github/contributors/google/comprehensive-rust?style=flat-square)](https://" -"github.com/google/comprehensive-rust/graphs/contributors) [![Estrellas de " -"GitHub](https://img.shields.io/github/stars/google/comprehensive-rust?" -"style=flat-square)](https://github.com/google/comprehensive-rust/stargazers)" +"[![Flujo de trabajo](https://img.shields.io/github/actions/workflow/status/" +"google/comprehensive-rust/build.yml?style=flat-square)](https://github.com/" +"google/comprehensive-rust/actions/workflows/build.yml?query=branch%3Amain) [!" +"[Colaboradores de GitHub](https://img.shields.io/github/contributors/google/" +"comprehensive-rust?style=flat-square)](https://github.com/google/" +"comprehensive-rust/graphs/contributors) [![Estrellas de GitHub](https://img." +"shields.io/github/stars/google/comprehensive-rust?style=flat-square)]" +"(https://github.com/google/comprehensive-rust/stargazers)" #: src/index.md msgid "" @@ -1217,10 +1356,10 @@ msgid "" "course covers the full spectrum of Rust, from basic syntax to advanced " "topics like generics and error handling." msgstr "" -"Este es un curso de Rust que ha desarrollado el equipo de Android de Google. " -"El curso abarca todo lo relacionado con Rust, desde la sintaxis básica hasta " -"temas avanzados como los genéricos y la gestión de errores. También incluye " -"contenidos específicos de Android el último día." +"Este es un curso de Rust de tres días que ha desarrollado el equipo de " +"Android de Google. El curso abarca todo lo relacionado con Rust, desde la " +"sintaxis básica hasta temas avanzados como los genéricos y la gestión de " +"errores. También incluye contenidos específicos de Android el último día." #: src/index.md msgid "" @@ -1232,6 +1371,22 @@ msgstr "" "comprehensive-rust/>. Si lo estás leyendo en otro lugar, consulta allí para " "obtener actualizaciones." +#: 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 "" +"Este curso está disponible en otros idiomas. Seleccione su idioma preferido " +"en la esquina superior a la derecha, o navega a la página de [Tradduciones]" +"(Translations](running-the-course/translations.md) para una lista de todas " +"las traducciones disponibles." + +#: src/index.md +msgid "The course is also available [as a PDF](comprehensive-rust.pdf)." +msgstr "" +"Este curso tambien está disponible [como un PDF](comprehensive-rust.pdf)." + #: src/index.md msgid "" "The goal of the course is to teach you Rust. We assume you don't know " @@ -1250,7 +1405,7 @@ msgstr "Permitirte modificar programas de Rust y escribir otros nuevos." #: src/index.md msgid "Show you common Rust idioms." -msgstr "Brindarte idiomática propia de Rust." +msgstr "Enseñarte idiomática propia de Rust." #: src/index.md msgid "We call the first four course days Rust Fundamentals." @@ -1273,16 +1428,14 @@ msgstr "" "interoperabilidad con C, C++ y Java." #: src/index.md -#, fuzzy msgid "" "[Chromium](chromium.md): a half-day course on using Rust within Chromium " "based browsers. This includes interoperability with C++ and how to include " "third-party crates in Chromium." msgstr "" -"[Rust en Chromium](../chromium.md) es una clase en profundidad de medio día " -"sobre el uso de Rust como parte del navegador Chromium. Incluye el uso de " -"Rust en el sistema de compilación `gn` de Chromium e incorpora bibliotecas " -"de terceros (\"crates\") e interoperabilidad en C++." +"[Chromium](../chromium.md): una clase de medio día sobre el uso de Rust " +"dentro del navegador Chromium. Incluye interoperabilidad con C++ y como " +"incorporar bibliotecas de tercer partido (\"crates\") en Chromium." #: src/index.md msgid "" @@ -1375,20 +1528,16 @@ msgstr "" "desarrollado el curso en Google." #: src/running-the-course.md -#, fuzzy msgid "" "We typically run classes from 9:00 am to 4:00 pm, with a 1 hour lunch break " "in the middle. This leaves 3 hours for the morning class and 3 hours for the " "afternoon class. Both sessions contain multiple breaks and time for students " "to work on exercises." msgstr "" -"Normalmente, impartimos las clases de 10:00 a 16:00, con una pausa para " -"comer de una hora. Esto deja 2,5 horas para la clase de la mañana y 2,5 " -"horas para la clase de la tarde. Ten en cuenta que esta es solo una " -"recomendación: también puedes dedicar 3 horas a la sesión de la mañana para " -"dar a la gente más tiempo para los ejercicios. El inconveniente de las " -"sesiones más largas es que la gente puede cansarse mucho después de 6 horas " -"completas de clase por la tarde." +"Normalmente impartimos las clases de 09:00 a 16:00, con una pausa para " +"almorzar de una hora. Esto deja 3 horas para la clase de la mañana y 3 horas " +"para la clase de la tarde. Ambas sesiones incluyen varias pausas y tiempo " +"para que los estudiantes completen los ejercicios." #: src/running-the-course.md msgid "Before you run the course, you will want to:" @@ -1410,18 +1559,16 @@ msgstr "" "despejada para mostrar a la clase." #: src/running-the-course.md -#, fuzzy msgid "" "Decide on the dates. Since the course takes four days, we recommend that you " "schedule the days over two weeks. Course participants have said that they " "find it helpful to have a gap in the course since it helps them process all " "the information we give them." msgstr "" -"Decide bien las fechas. Dado que el curso dura al menos tres días completos, " -"te recomendamos que repartas los días a lo largo de dos semanas. Los " -"participantes del curso han dicho que les resulta útil hacer pausas durante " -"el curso, ya que les ayuda a procesar toda la información que les " -"proporcionamos." +"Decide bien las fechas. Dado que el curso dura cuatro días, te recomendamos " +"que repartas los días a lo largo de dos semanas. Los participantes del curso " +"han dicho que les resulta útil hacer pausas durante el curso, ya que les " +"ayuda a procesar toda la información que les proporcionamos." #: src/running-the-course.md msgid "" @@ -1481,8 +1628,8 @@ msgid "" "That is all, good luck running the course! We hope it will be as much fun " "for you as it has been for us!" msgstr "" -"Eso es todo. ¡Buena suerte con el curso! Esperamos que te diviertas tanto " -"como nosotros." +"Eso es todo. ¡Buena suerte con el curso, y esperamos que te diviertas tanto " +"como nosotros!" #: src/running-the-course.md msgid "" @@ -1503,164 +1650,153 @@ msgid "Rust Fundamentals" msgstr "Fundamentos de Rust" #: src/running-the-course/course-structure.md -#, fuzzy msgid "" "The first four days make up [Rust Fundamentals](../welcome-day-1.md). The " "days are fast paced and we cover a lot of ground!" msgstr "" -"Los primeros tres días forman los [Fundamentos de Rust](../welcome-day-1." -"md). Los días son muy intensos y cubrimos mucho terreno:" +"Los primeros cuatro días forman los [Fundamentos de Rust](../welcome-day-1." +"md). ¡Los días son muy intensos y cubrimos mucho terreno!" #: src/running-the-course/course-structure.md msgid "Course schedule:" msgstr "Horario del curso:" #: src/running-the-course/course-structure.md -msgid "Day 1 Morning (3 hours, including breaks)" -msgstr "Día 1 por la mañana (3 horas, incluidos los descansos)" +msgid "Day 1 Morning (2 hours and 5 minutes, including breaks)" +msgstr "Día 1 por la mañana (2 horas y 5 minutos, incluidos los descansos)" -#: src/running-the-course/course-structure.md -msgid "[Welcome](../welcome-day-1.md) (5 minutes)" -msgstr "[Bienvenida](../welcome-day-1.md) (5 minutos)" +#: 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 "Sección" -#: src/running-the-course/course-structure.md -msgid "[Hello, World](../hello-world.md) (20 minutes)" -msgstr "[Hola, mundo](../hello-world.md) (20 minutos)" +#: 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 +msgid "Duration" +msgstr "Duración" + +#: 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 "5 minutos" + +#: 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 "15 minutos" + +#: src/running-the-course/course-structure.md src/welcome-day-1.md +#: src/welcome-day-4.md +msgid "40 minutes" +msgstr "40 minutos" #: src/running-the-course/course-structure.md -msgid "[Types and Values](../types-and-values.md) (1 hour and 5 minutes)" -msgstr "[Tipos y valores](../types-and-values.md) (1 hora y 5 minutos)" +msgid "Day 1 Afternoon (2 hours and 35 minutes, including breaks)" +msgstr "Día 1 por la tarde (2 horas y 35 minutos, incluidos los descansos)" -#: src/running-the-course/course-structure.md -msgid "[Control Flow Basics](../control-flow-basics.md) (1 hour)" -msgstr "" -"[Aspectos básicos del flujo de control](../control-flow-basics.md) (1 hora)" +#: src/running-the-course/course-structure.md src/welcome-day-1-afternoon.md +msgid "35 minutes" +msgstr "35 minutos" -#: src/running-the-course/course-structure.md -msgid "Day 1 Afternoon (2 hours and 55 minutes, including breaks)" -msgstr "Día 1 por la tarde (2 horas y 55 minutos, incluidos los descansos)" +#: 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 "55 minutos" -#: src/running-the-course/course-structure.md -msgid "[Tuples and Arrays](../tuples-and-arrays.md) (1 hour)" -msgstr "[Tuplas y arrays](../tuples-and-arrays.md) (1 hora)" +#: 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 "50 minutos" #: src/running-the-course/course-structure.md -msgid "[References](../references.md) (50 minutes)" -msgstr "[Referencias](../references.md) (50 minutos)" +msgid "Day 2 Morning (2 hours and 10 minutes, including breaks)" +msgstr "Día 2 por la mañana (2 horas y 10 minutos, incluidos los descansos)" + +#: 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 "3 minutos" + +#: 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 "1 hora" #: src/running-the-course/course-structure.md -msgid "[User-Defined Types](../user-defined-types.md) (50 minutes)" -msgstr "" -"[Tipos definidos por el usuario](../user-definition-types.md) (50 minutos)" +msgid "Day 2 Afternoon (3 hours and 15 minutes, including breaks)" +msgstr "Día 2 por la tarde (3 horas y 15 minutos, incluidos los descansos)" -#: src/running-the-course/course-structure.md -#, fuzzy -msgid "Day 2 Morning (3 hours and 5 minutes, including breaks)" -msgstr "Día 4 por la mañana (3 horas y 5 minutos, incluidos los descansos)" +#: src/running-the-course/course-structure.md src/welcome-day-2-afternoon.md +#: src/welcome-day-4.md +msgid "45 minutes" +msgstr "45 minutos" -#: src/running-the-course/course-structure.md -msgid "[Welcome](../welcome-day-2.md) (3 minutes)" -msgstr "[Bienvenida](../welcome-day-2.md) (3 minutos)" +#: 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 "1 hora y 10 minutos" #: src/running-the-course/course-structure.md -msgid "[Pattern Matching](../pattern-matching.md) (50 minutes)" -msgstr "[Coincidencia de patrones](../pattern-matching.md) (50 minutos)" +msgid "Day 3 Morning (2 hours and 20 minutes, including breaks)" +msgstr "Día 3 por la mañana (2 horas y 20 minutos, incluidos los descansos)" #: src/running-the-course/course-structure.md -msgid "[Methods and Traits](../methods-and-traits.md) (55 minutes)" -msgstr "[Métodos y traits](../methods-and-traits.md) (55 minutos)" +msgid "Day 3 Afternoon (1 hour and 55 minutes, including breaks)" +msgstr "Día 3 por la tarde (1 hora y 55 minutos, incluidos los descansos)" #: src/running-the-course/course-structure.md -msgid "[Generics](../generics.md) (45 minutes)" -msgstr "[Genéricos](../generics.md) (45 minutos)" +msgid "Day 4 Morning (2 hours and 40 minutes, including breaks)" +msgstr "Día 4 por la mañana (2 horas y 40 minutos, incluidos los descansos)" #: src/running-the-course/course-structure.md -msgid "Day 2 Afternoon (3 hours, including breaks)" -msgstr "Día 2 por la tarde (3 horas, incluidos los descansos)" +msgid "Day 4 Afternoon (2 hours and 15 minutes, including breaks)" +msgstr "Día 4 por la tarde (2 horas y 15 minutos, incluidos los descansos)" + +#: src/running-the-course/course-structure.md src/welcome-day-4-afternoon.md +msgid "1 hour and 5 minutes" +msgstr "1 hora y 5 minutos" #: src/running-the-course/course-structure.md -msgid "[Standard Library Types](../std-types.md) (1 hour and 10 minutes)" -msgstr "[Tipos de bibliotecas estándar](../std-types.md) (1 hora y 10 minutos)" +msgid "Deep Dives" +msgstr "Información más detallada" #: src/running-the-course/course-structure.md -msgid "[Standard Library Traits](../std-traits.md) (1 hour and 40 minutes)" -msgstr "" -"[Traits de biblioteca estándar](../std-traits.md) (1 hora y 40 minutos)" - -#: src/running-the-course/course-structure.md -msgid "Day 3 Morning (2 hours and 15 minutes, including breaks)" -msgstr "Día 3 por la mañana (2 horas y 15 minutos, incluidos los descansos)" - -#: src/running-the-course/course-structure.md -msgid "[Welcome](../welcome-day-3.md) (3 minutes)" -msgstr "[Bienvenida](../welcome-day-3.md) (3 minutos)" - -#: src/running-the-course/course-structure.md -msgid "[Memory Management](../memory-management.md) (1 hour and 10 minutes)" -msgstr "[Gestión de la memoria](../memory-management.md) (1 hora y 10 minutos)" - -#: src/running-the-course/course-structure.md -#, fuzzy -msgid "[Smart Pointers](../smart-pointers.md) (45 minutes)" -msgstr "[Iteradores](../iterators.md) (45 minutos)" - -#: src/running-the-course/course-structure.md -msgid "Day 3 Afternoon (2 hours and 20 minutes, including breaks)" -msgstr "Día 3 por la tarde (2 horas y 20 minutos, incluidos los descansos)" - -#: src/running-the-course/course-structure.md -msgid "[Borrowing](../borrowing.md) (1 hour)" -msgstr "[Préstamos](../borrowing.md) (1 hora)" - -#: src/running-the-course/course-structure.md -msgid "" -"[Slices and Lifetimes](../slices-and-lifetimes.md) (1 hour and 10 minutes)" -msgstr "" -"[Slices y tiempos de vida](../slices-and-lifetimes.md) (1 hora y 10 minutos)" - -#: src/running-the-course/course-structure.md -msgid "Day 4 Morning (3 hours and 5 minutes, including breaks)" -msgstr "Día 4 por la mañana (3 horas y 5 minutos, incluidos los descansos)" - -#: src/running-the-course/course-structure.md -msgid "[Welcome](../welcome-day-4.md) (3 minutes)" -msgstr "[Bienvenida](../welcome-day-4.md) (3 minutos)" - -#: src/running-the-course/course-structure.md -msgid "[Iterators](../iterators.md) (45 minutes)" -msgstr "[Iteradores](../iterators.md) (45 minutos)" - -#: src/running-the-course/course-structure.md -msgid "[Modules](../modules.md) (40 minutes)" -msgstr "[Módulos](../modules.md) (40 minutos)" - -#: src/running-the-course/course-structure.md -msgid "[Testing](../testing.md) (1 hour and 5 minutes)" -msgstr "[Pruebas](../testing.md) (1 hora y 5 minutos)" - -#: src/running-the-course/course-structure.md -msgid "Day 4 Afternoon (2 hours, including breaks)" -msgstr "Día 4 por la tarde (2 horas, incluidos los descansos)" - -#: src/running-the-course/course-structure.md -msgid "[Error Handling](../error-handling.md) (45 minutes)" -msgstr "[Gestión de errores](../error-handling.md) (45 minutos)" - -#: src/running-the-course/course-structure.md -msgid "[Unsafe Rust](../unsafe-rust.md) (1 hour and 5 minutes)" -msgstr "[Rust inseguro](../unsafe-rust.md) (1 hora y 5 minutos)" - -#: src/running-the-course/course-structure.md -msgid "Deep Dives" -msgstr "Información más detallada" - -#: src/running-the-course/course-structure.md -#, fuzzy msgid "" "In addition to the 4-day class on Rust Fundamentals, we cover some more " "specialized topics:" msgstr "" -"Además de la clase de 3 días sobre los fundamentos de Rust, abordamos " +"Además de la clase de 4 días sobre los fundamentos de Rust, abordamos " "algunos temas más especializados:" #: src/running-the-course/course-structure.md @@ -1777,6 +1913,34 @@ msgstr "" "dependencias. A continuación, podrás copiar y pegar los ejemplos en `src/" "main.rs` para experimentar con ellos:" +#: src/running-the-course/course-structure.md +msgid "Morning (3 hours and 20 minutes, including breaks)" +msgstr "Mañana (3 horas y205 minutos, incluidos los descansos)" + +#: 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 "30 minutos" + +#: 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 "20 minutos" + +#: src/running-the-course/course-structure.md src/concurrency/welcome.md +msgid "Send and Sync" +msgstr "Send y Sync" + +#: src/running-the-course/course-structure.md +msgid "Afternoon (3 hours and 20 minutes, including breaks)" +msgstr "Por la tarde (3 horas y 20 minutos, incluidos los descansos)" + #: src/running-the-course/course-structure.md msgid "Format" msgstr "Formato" @@ -1786,7 +1950,7 @@ msgid "" "The course is meant to be very interactive and we recommend letting the " "questions drive the exploration of Rust!" msgstr "" -"El curso está pensado para ser muy interactivo, por lo que te recomendamos " +"El curso está diseñado para ser muy interactivo, por lo que te recomendamos " "que dejes que las preguntas guíen el aprendizaje de Rust." #: src/running-the-course/keyboard-shortcuts.md @@ -1794,36 +1958,20 @@ msgid "There are several useful keyboard shortcuts in mdBook:" msgstr "Existen varias combinaciones de teclas útiles en mdBook:" #: src/running-the-course/keyboard-shortcuts.md -msgid "Arrow-Left" -msgstr "Flecha izquierda" - -#: src/running-the-course/keyboard-shortcuts.md -msgid ": Navigate to the previous page." -msgstr ": ir a la página anterior." - -#: src/running-the-course/keyboard-shortcuts.md -msgid "Arrow-Right" -msgstr "Flecha derecha" - -#: src/running-the-course/keyboard-shortcuts.md -msgid ": Navigate to the next page." -msgstr ": ir a la página siguiente." - -#: src/running-the-course/keyboard-shortcuts.md src/cargo/code-samples.md -msgid "Ctrl + Enter" -msgstr "Ctrl + Intro" +msgid "Arrow-Left: Navigate to the previous page." +msgstr "Arrow-Left: Navegar a la página anterior." #: src/running-the-course/keyboard-shortcuts.md -msgid ": Execute the code sample that has focus." -msgstr ": ejecutar el código de ejemplo seleccionado." +msgid "Arrow-Right: Navigate to the next page." +msgstr "Arrow-Right: Navegar a la siguiente página." #: src/running-the-course/keyboard-shortcuts.md -msgid "s" -msgstr "s" +msgid "Ctrl + Enter: Execute the code sample that has focus." +msgstr "Ctrl + Enter: Ejecutar el código de ejemplo seleccionado." #: src/running-the-course/keyboard-shortcuts.md -msgid ": Activate the search bar." -msgstr ": activar la barra de búsqueda." +msgid "s: Activate the search bar." +msgstr "s: Activar la barra de búsqueda." #: src/running-the-course/translations.md msgid "" @@ -1840,7 +1988,7 @@ msgid "" "com/hugojacob), [@joaovicmendes](https://github.com/joaovicmendes), and " "[@henrif75](https://github.com/henrif75)." msgstr "" -"[Portugués de Brasil](https://google.github.io/comprehensive-rust/pt-BR/) " +"[Portugués Brasileño](https://google.github.io/comprehensive-rust/pt-BR/) " "por [@rastringer](https://github.com/rastringer), [@hugojacob](https://" "github.com/hugojacob), [@joaovicmendes](https://github.com/joaovicmendes) y " "[@henrif75](https://github.com/henrif75)." @@ -1875,15 +2023,29 @@ msgstr "" "github.com/kuanhungchen) y [@johnathan79717](https://github.com/" "johnathan79717)." +#: src/running-the-course/translations.md +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 "" +"[Japonés](https://google.github.io/comprehensive-rust/ja/) por [@CoinEZ-JPN]" +"(https://github.com/CoinEZ), [@momotaro1105](https://github.com/" +"momotaro1105), [@HidenoriKobayashi](https://github.com/HidenoriKobayashi) y " +"[@kantasv](https://github.com/kantasv)." + #: src/running-the-course/translations.md 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 "" "[Coreano](https://google.github.io/comprehensive-rust/ko/) por [@keispace]" -"(https://github.com/keispace), [@jiyongp](https://github.com/jiyongp) y " -"[@jooyunghan](https://github.com/jooyunghan)." +"(https://github.com/keispace), [@jiyongp](https://github.com/jiyongp), " +"[@jooyunghan](https://github.com/jooyunghan), y [@namhyung](https://github." +"com/namhyung)." #: src/running-the-course/translations.md msgid "" @@ -1893,11 +2055,21 @@ msgstr "" "[Español](https://google.github.io/comprehensive-rust/es/) por [@deavid]" "(https://github.com/deavid)." +#: src/running-the-course/translations.md +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 "" +"[Ucranio](https://google.github.io/comprehensive-rust/uk/) por [@git-user-" +"cpp](https://github.com/git-user-cpp), [@yaremam](https://github.com/" +"yaremam), y [@reta](https://github.com/reta)." + #: src/running-the-course/translations.md msgid "" "Use the language picker in the top-right corner to switch between languages." msgstr "" -"Cambia el idioma con el selector situado en la esquina superior derecha." +"Cambia el idioma con el seleccionador situado en la esquina superior derecha." #: src/running-the-course/translations.md msgid "Incomplete Translations" @@ -1911,6 +2083,14 @@ msgstr "" "Hay muchas traducciones todavía en curso. A continuación, incluimos enlaces " "a las traducciones más actualizadas:" +#: src/running-the-course/translations.md +msgid "" +"[Arabic](https://google.github.io/comprehensive-rust/ar/) by [@younies]" +"(https://github.com/younies)" +msgstr "" +"[Árabe](https://google.github.io/comprehensive-rust/es/) por [@younies]" +"(https://github.com/younies)" + #: src/running-the-course/translations.md msgid "" "[Bengali](https://google.github.io/comprehensive-rust/bn/) by [@raselmandol]" @@ -1922,10 +2102,12 @@ msgstr "" #: src/running-the-course/translations.md 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 "" "[Francés](https://google.github.io/comprehensive-rust/fr/) por [@KookaS]" -"(https://github.com/KookaS) y [@vcaen](https://github.com/vcaen)." +"(https://github.com/KookaS), [@vcaen](https://github.com/vcaen), y " +"[@AdrienBaudemont](https://github.com/AdrienBaudemont)." #: src/running-the-course/translations.md msgid "" @@ -1935,16 +2117,6 @@ msgstr "" "[Alemán](https://google.github.io/comprehensive-rust/de/) por [@Throvn]" "(https://github.com/Throvn) y [@ronaldfw](https://github.com/ronaldfw)." -#: src/running-the-course/translations.md -msgid "" -"[Japanese](https://google.github.io/comprehensive-rust/ja/) by [@CoinEZ-JPN]" -"(https://github.com/CoinEZ) and [@momotaro1105](https://github.com/" -"momotaro1105)." -msgstr "" -"[Japonés](https://google.github.io/comprehensive-rust/ja/) por [@CoinEZ-JPN]" -"(https://github.com/CoinEZ) y [@momotaro1105](https://github.com/" -"momotaro1105)." - #: src/running-the-course/translations.md msgid "" "[Italian](https://google.github.io/comprehensive-rust/it/) by " @@ -1955,6 +2127,19 @@ msgstr "" "[@henrythebuilder](https://github.com/henrythebuilder) y [@detro](https://" "github.com/detro)." +#: 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 "" +"La lista completa de traducciones con su estado corriente también esta " +"disponible [a partir de su ultima actualización](https://google.github.io/" +"comprehensive-rust/translation-report.html) o [sincronizado a la versión mas " +"reciente del curso](https://google.github.io/comprehensive-rust/synced-" +"translation-report.html)." + #: src/running-the-course/translations.md msgid "" "If you want to help with this effort, please see [our instructions](https://" @@ -2031,6 +2216,16 @@ msgstr "" "`apt`. Sin embargo, solo podrás conseguir una versión de Rust obsoleta que " "podría dar lugar a comportamientos inesperados. El comando es el siguiente:" +#: 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 "" +"En macOS, puedes usar [Homebrew](https://brew.sh/) para instalar Rust, pero " +"esto podría proveer una versión anticuada. Por lo tanto, es recomendad " +"instalar Rust del sitio oficial." + #: src/cargo/rust-ecosystem.md msgid "The Rust Ecosystem" msgstr "El ecosistema de Rust" @@ -2078,11 +2273,10 @@ msgstr "" "versiones de Rust instaladas a la vez y `rustup` te permitirá cambiar de una " "a otra según lo necesites." -#: 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 "Puntos clave:" @@ -2170,24 +2364,23 @@ msgstr "" #: src/cargo/rust-ecosystem.md msgid "Project/package structure" -msgstr "Estructura del proyecto/package " +msgstr "Estructura del proyecto/paquete" #: src/cargo/rust-ecosystem.md msgid "[workspaces](https://doc.rust-lang.org/cargo/reference/workspaces.html)" msgstr "" -"[workspaces](https://doc.rust-lang.org/cargo/reference/workspaces.html) " +"[workspaces](https://doc.rust-lang.org/cargo/reference/workspaces.html)" #: src/cargo/rust-ecosystem.md msgid "Dev Dependencies and Runtime Dependency management/caching" -msgstr "Manejo/Caché de Dependencias de Desarrollo y de Runtime " +msgstr "Manejo/Cache de Dependencias de Desarrollo y de Runtime" #: src/cargo/rust-ecosystem.md -#, fuzzy msgid "" "[build scripting](https://doc.rust-lang.org/cargo/reference/build-scripts." "html)" msgstr "" -"[Instalación global](https://doc.rust-lang.org/cargo/commands/cargo-install." +"[build scripting](https://doc.rust-lang.org/cargo/reference/build-scripts." "html)" #: src/cargo/rust-ecosystem.md @@ -2246,12 +2439,12 @@ msgid "\"Edit me!\"" msgstr "\"¡Edítame!\"" #: src/cargo/code-samples.md -msgid "You can use " -msgstr "Puedes usar " - -#: src/cargo/code-samples.md -msgid " to execute the code when focus is in the text box." -msgstr " para ejecutar el código cuando el cursor esté en el cuadro de texto." +msgid "" +"You can use Ctrl + Enter to execute the code when focus is in the " +"text box." +msgstr "" +"Puedes usar Ctrl + Enter para ejecutar el código cuando el cursor " +"esté en el cuadro de texto." #: src/cargo/code-samples.md msgid "" @@ -2338,8 +2531,8 @@ msgid "" "example, using the example on the previous page, make `src/main.rs` look like" msgstr "" "Sustituye el código de plantilla en `src/main.rs` con tu propio código. Por " -"ejemplo, si usamos el ejemplo de la página anterior, podemos hacer que `src/" -"main.rs` tenga el siguiente aspecto:" +"ejemplo, usando el ejemplo de la página anterior, haz que `src/main.rs` " +"tenga el siguiente aspecto:" #: src/cargo/running-locally.md msgid "Use `cargo run` to build and run your updated binary:" @@ -2397,9 +2590,8 @@ msgstr "" "references, funciones, y métodos." #: src/welcome-day-1.md -#, fuzzy msgid "Types and type inference." -msgstr "Inferencia de tipos" +msgstr "Inferencia de tipos." #: src/welcome-day-1.md msgid "Control flow constructs: loops, conditionals, and so on." @@ -2415,39 +2607,18 @@ msgstr "" "Emparejamiento de Patrones: desestructuración de enums, structs y arrays." #: 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 "Horario" -#: 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 "En esta sesión:" - -#: src/welcome-day-1.md -msgid "[Welcome](./welcome-day-1.md) (5 minutes)" -msgstr "[Bienvenida](./welcome-day-1.md) (5 minutos)" - #: src/welcome-day-1.md -msgid "[Hello, World](./hello-world.md) (20 minutes)" -msgstr "[Hola, mundo](./hello-world.md) (20 minutos)" - -#: src/welcome-day-1.md -msgid "[Types and Values](./types-and-values.md) (1 hour and 5 minutes)" -msgstr "[Tipos y valores](./types-and-values.md) (1 hora y 5 minutos)" - -#: src/welcome-day-1.md -msgid "[Control Flow Basics](./control-flow-basics.md) (1 hour)" -msgstr "" -"[Aspectos básicos del flujo de control](./control-flow-basics.md) (1 hora)" - -#: src/welcome-day-1.md src/welcome-day-2-afternoon.md -msgid "Including 10 minute breaks, this session should take about 3 hours" +msgid "" +"Including 10 minute breaks, this session should take about 2 hours and 5 " +"minutes. It contains:" msgstr "" "Contando con los descansos de 10 minutos, la duración prevista de la sesión " -"es de unas 3 horas." +"es de unas 2 horas y 5 minutos. Esta sesión contiene:" #: src/welcome-day-1.md msgid "Please remind the students that:" @@ -2464,11 +2635,10 @@ msgid "" "The class is meant to be interactive and discussions are very much " "encouraged!" msgstr "" -"El curso está pensado para ser muy interactivo, por lo que te recomendamos " -"que dejes que las preguntas guíen el aprendizaje de Rust." +"El curso está diseñado para ser muy interactivo, ¡las discusiones son muy " +"recomendadas!" #: src/welcome-day-1.md -#, fuzzy msgid "" "As an instructor, you should try to keep the discussions relevant, i.e., " "keep the discussions related to how Rust does things vs some other language. " @@ -2477,8 +2647,9 @@ msgid "" msgstr "" "Como instructor, debes intentar llevar discusiones relevantes, por ejemplo, " "mantener relación de cómo Rust hace las cosas vs otros lenguajes. Puede " -"costar encontrar un balance adecuado, pero permite llevar un debate que " -"atraiga la atención de la gente por sobre un discurso unidireccional." +"costar encontrar un balance adecuado, pero generalmente permite las " +"discusiones ya que captan la atención de la gente mas que los discursos " +"unidireccionales." #: src/welcome-day-1.md msgid "" @@ -2518,38 +2689,42 @@ msgstr "" "calendario. Debes tener en cuenta que hay un ejercicio al final de cada " "parte, seguido de una pausa. Organiza las sesiones de forma que se explique " "la solución del ejercicio después de la pausa. Las horas que se indican son " -"una sugerencia para que el curso se ciña al horario establecido. No dudes en " -"modificar el calendario y hacer los cambios que consideres necesarios." +"una sugerencia para que el curso se ciña al horario establecido. ¡No dudes " +"en modificar el calendario y hacer los cambios que consideres necesarios!" + +#: src/hello-world.md src/concurrency/send-sync.md +msgid "This segment should take about 15 minutes. It contains:" +msgstr "Esta sección tiene una duración aproximada de 15 minutos y contiene:" #: 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 "En esta parte se abordarán los siguientes temas:" - -#: src/hello-world.md -msgid "[What is Rust?](./hello-world/what-is-rust.md) (10 minutes)" -msgstr "[¿Qué es Rust?](./hello-world/what-is-rust.md) (10 minutos)" - -#: src/hello-world.md -msgid "[Hello, World](./hello-world/hello-world.md) (5 minutes)" -msgstr "[Hola, mundo](./hello-world/hello-world.md) (5 minutos)" - -#: src/hello-world.md -msgid "[Benefits of Rust](./hello-world/benefits.md) (3 minutes)" -msgstr "[Ventajas de Rust](./hello-world/benefits.md) (3 minutos)" - -#: src/hello-world.md -msgid "[Playground](./hello-world/playground.md) (2 minutes)" -msgstr "[Playground](./hello-world/playground.md) (2 minutos)" - -#: src/hello-world.md -msgid "This segment should take about 20 minutes" -msgstr "Esta sección tiene una duración aproximada de 20 minutos." +#: 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 "Diapositiva" + +#: 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 "10 minutos" + +#: 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 "2 minutos" #: src/hello-world/what-is-rust.md msgid "" @@ -2635,100 +2810,6 @@ msgid "Focuses on reliability and safety without sacrificing performance." msgstr "" "Se centra en la fiabilidad y la seguridad sin sacrificar el rendimiento." -#: src/hello-world/hello-world.md -msgid "" -"Let us jump into the simplest possible Rust program, a classic Hello World " -"program:" -msgstr "Vamos a hablar del programa Rust más simple, un clásico Hola Mundo:" - -#: src/hello-world/hello-world.md -msgid "\"Hello 🌍!\"" -msgstr "\"Hola, 🌍\"" - -#: src/hello-world/hello-world.md -msgid "What you see:" -msgstr "Lo que ves:" - -#: src/hello-world/hello-world.md -msgid "Functions are introduced with `fn`." -msgstr "Las funciones se introducen con `fn`." - -#: src/hello-world/hello-world.md -msgid "Blocks are delimited by curly braces like in C and C++." -msgstr "Los bloques se delimitan con llaves, como en C y C++." - -#: src/hello-world/hello-world.md -msgid "The `main` function is the entry point of the program." -msgstr "La función `main` es el punto de entrada del programa." - -#: src/hello-world/hello-world.md -msgid "Rust has hygienic macros, `println!` is an example of this." -msgstr "Rust tiene macros higiénicas, como por ejemplo `println!`." - -#: src/hello-world/hello-world.md -msgid "Rust strings are UTF-8 encoded and can contain any Unicode character." -msgstr "" -"Las cadenas de Rust están codificadas en UTF-8 y pueden contener caracteres " -"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 "" -"Con esta diapositiva se intenta que los alumnos se sientan cómodos con el " -"código de Rust. En los próximos tres días lo verán mucho, así que " -"empezaremos con algo que ya conocemos." - -#: src/hello-world/hello-world.md -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 es muy similar a otros lenguajes, como C, C++ o Java. Es imperativo y " -"no intenta reinventar las cosas a menos que sea absolutamente necesario." - -#: src/hello-world/hello-world.md -msgid "Rust is modern with full support for things like Unicode." -msgstr "Rust es moderno y totalmente compatible con sistemas como 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 utiliza macros en situaciones en las que se desea tener un número " -"variable de argumentos (sin [sobrecarga](basic-syntax/functions-interlude." -"md) de funciones)." - -#: src/hello-world/hello-world.md -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 "" -"Que las macros sean 'higiénicas' significa que no capturan " -"accidentalmenteidentificadores del ámbito en el que se utilizan. En " -"realidad, las macros de Rust solo son [parcialmente higiénicas](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 es un lenguaje multiparadigma. Por ejemplo, cuenta con [funciones de " -"programación orientadas a objetos](https://doc.rust-lang.org/book/ch17-00-" -"oop.html) y, aunque no es un lenguaje funcional, incluye una serie de " -"[conceptos funcionales](https://doc.rust-lang.org/book/ch13-00-functional-" -"features.html)." - #: src/hello-world/benefits.md msgid "Some unique selling points of Rust:" msgstr "Estas son algunas de las ventajas competitivas de Rust:" @@ -2799,7 +2880,7 @@ msgstr "Enumeraciones (_Enums_) y coincidencia de patrones." #: src/hello-world/benefits.md msgid "Generics." -msgstr "Genéricos" +msgstr "Genéricos." #: src/hello-world/benefits.md msgid "No overhead FFI." @@ -2860,10 +2941,10 @@ 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 "" "Experiencia con Java, Go, Python, JavaScript, etc.: Consigues la misma " -"seguridad en la memoria que en éstos lenguajes, además de una sensación " +"seguridad de memoria que en éstos lenguajes, además de una experiencia " "similar a la de un lenguaje de alto nivel. También consigues un rendimiento " "rápido y predecible como en C y C++ (sin recolector de memoria residual), " "así como acceso a hardware de bajo nivel (si lo necesitas)." @@ -2922,74 +3003,140 @@ msgstr "" "obtener más información sobre las optimizaciones o el ensamblaje generado de " "Rust." -#: src/types-and-values.md -msgid "[Variables](./types-and-values/variables.md) (5 minutes)" -msgstr "[Variables](./types-and-values/variables.md) (5 minutos)" +#: src/types-and-values.md src/control-flow-basics.md src/modules.md +msgid "This segment should take about 40 minutes. It contains:" +msgstr "Esta sección tiene una duración aproximada de 40 minutos y contiene:" -#: src/types-and-values.md -msgid "[Values](./types-and-values/values.md) (10 minutes)" -msgstr "[Valores](./types-and-values/values.md) (10 minutos)" +#: src/types-and-values/hello-world.md +msgid "" +"Let us jump into the simplest possible Rust program, a classic Hello World " +"program:" +msgstr "Vamos a hablar del programa Rust más simple, un clásico Hola Mundo:" -#: src/types-and-values.md -msgid "[Arithmetic](./types-and-values/arithmetic.md) (5 minutes)" -msgstr "[Aritmética](./types-and-values/arithmetic.md) (5 minutos)" +#: src/types-and-values/hello-world.md +msgid "\"Hello 🌍!\"" +msgstr "\"Hola, 🌍\"" -#: src/types-and-values.md -msgid "[Strings](./types-and-values/strings.md) (10 minutes)" -msgstr "[Cadenas](./types-and-values/strings.md) (10 minutos)" +#: src/types-and-values/hello-world.md +msgid "What you see:" +msgstr "Lo que ves:" -#: src/types-and-values.md -msgid "[Type Inference](./types-and-values/inference.md) (5 minutes)" -msgstr "[Inferencia de tipos](./types-and-values/inference.md) (5 minutos)" +#: src/types-and-values/hello-world.md +msgid "Functions are introduced with `fn`." +msgstr "Las funciones se introducen con `fn`." -#: src/types-and-values.md -msgid "[Exercise: Fibonacci](./types-and-values/exercise.md) (30 minutes)" -msgstr "[Ejercicio: Fibonacci](./types-and-values/exercise.md) (30 minutos)" +#: src/types-and-values/hello-world.md +msgid "Blocks are delimited by curly braces like in C and C++." +msgstr "Los bloques se delimitan con llaves, como en C y 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 "Esta sección tiene una duración aproximada de 1 hora y 5 minutos." +#: src/types-and-values/hello-world.md +msgid "The `main` function is the entry point of the program." +msgstr "La función `main` es el punto de entrada del programa." -#: src/types-and-values/variables.md -#, fuzzy -msgid "" -"Rust provides type safety via static typing. Variable bindings are made with " -"`let`:" -msgstr "" -"Rust ofrece seguridad de tipos mediante tipado estático. De forma " -"predeterminada, los enlaces a variables son inmutables:" +#: src/types-and-values/hello-world.md +msgid "Rust has hygienic macros, `println!` is an example of this." +msgstr "Rust tiene macros higiénicas, como por ejemplo `println!`." -#: src/types-and-values/variables.md src/control-flow-basics/loops.md -#: src/control-flow-basics/break-continue.md -#: src/control-flow-basics/blocks-and-scopes.md -msgid "\"x: {x}\"" -msgstr "\"x: {x}\"" +#: src/types-and-values/hello-world.md +msgid "Rust strings are UTF-8 encoded and can contain any Unicode character." +msgstr "" +"Las cadenas de Rust están codificadas en UTF-8 y pueden contener caracteres " +"Unicode." -#: src/types-and-values/variables.md +#: src/types-and-values/hello-world.md msgid "" -"// x = 20;\n" -" // println!(\"x: {x}\");\n" +"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 "" -"// x = 20;\n" -" // println!(\"x: {x}\");\n" +"Con esta diapositiva se intenta que los alumnos se sientan cómodos con el " +"código de Rust. En los próximos tres días lo verán mucho, así que " +"empezaremos con algo reconocible." -#: src/types-and-values/variables.md +#: src/types-and-values/hello-world.md msgid "" -"Uncomment the `x = 20` to demonstrate that variables are immutable by " -"default. Add the `mut` keyword to allow changes." +"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 "" -"Elimina el comentario de `x = 20` para demostrar que las variables son " -"inmutables de forma predeterminada. Añade la palabra clave `mut` para que se " -"puedan hacer cambios." +"Rust es muy similar a otros lenguajes, como C, C++ o Java. Es imperativo y " +"no intenta reinventar las cosas a menos que sea absolutamente necesario." -#: src/types-and-values/variables.md +#: src/types-and-values/hello-world.md +msgid "Rust is modern with full support for things like Unicode." +msgstr "Rust es moderno y totalmente compatible con sistemas como Unicode." + +#: src/types-and-values/hello-world.md msgid "" -"The `i32` here is the type of the variable. This must be known at compile " -"time, but type inference (covered later) allows the programmer to omit it in " -"many cases." +"Rust uses macros for situations where you want to have a variable number of " +"arguments (no function [overloading](../control-flow-basics/functions.md))." msgstr "" -"En este ejemplo, `i32` es el tipo de la variable. Se debe conocer durante el " -"tiempo de compilación, pero la inferencia de tipos (véase más adelante) " +"Rust utiliza macros en situaciones en las que se desea un número variable de " +"argumentos (sin [sobrecarga](basic-syntax/functions-interlude.md) de " +"funciones)." + +#: src/types-and-values/hello-world.md +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 "" +"Que las macros sean 'higiénicas' significa que no capturan " +"accidentalmenteidentificadores del ámbito en el que se utilizan. En " +"realidad, las macros de Rust solo son [parcialmente higiénicas](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 es un lenguaje multiparadigma. Por ejemplo, cuenta con [funciones de " +"programación orientadas a objetos](https://doc.rust-lang.org/book/ch17-00-" +"oop.html) y, aunque no es un lenguaje funcional, incluye una serie de " +"[conceptos funcionales](https://doc.rust-lang.org/book/ch13-00-functional-" +"features.html)." + +#: src/types-and-values/variables.md +msgid "" +"Rust provides type safety via static typing. Variable bindings are made with " +"`let`:" +msgstr "" +"Rust ofrece seguridad de tipos mediante tipado estático. Los enlaces a " +"variables son hechos con `let`:" + +#: 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}\"" + +#: src/types-and-values/variables.md +msgid "" +"// x = 20;\n" +" // println!(\"x: {x}\");\n" +msgstr "" +"// x = 20;\n" +" // println!(\"x: {x}\");\n" + +#: src/types-and-values/variables.md +msgid "" +"Uncomment the `x = 20` to demonstrate that variables are immutable by " +"default. Add the `mut` keyword to allow changes." +msgstr "" +"Elimina el comentario de `x = 20` para demostrar que las variables son " +"inmutables de forma predeterminada. Añade la palabra clave `mut` para que se " +"puedan hacer cambios." + +#: src/types-and-values/variables.md +msgid "" +"The `i32` here is the type of the variable. This must be known at compile " +"time, but type inference (covered later) allows the programmer to omit it in " +"many cases." +msgstr "" +"En este ejemplo, `i32` es el tipo de la variable. Se debe conocer durante el " +"tiempo de compilación, pero la inferencia de tipos (véase más adelante) " "permite al programador omitirla en muchos casos." #: src/types-and-values/values.md @@ -3000,12 +3147,11 @@ msgstr "" "A continuación, se muestran algunos tipos integrados básicos, así como la " "sintaxis de los valores literales de cada tipo." -#: 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 "Tipos" -#: src/types-and-values/values.md src/tuples-and-arrays/tuples-and-arrays.md +#: src/types-and-values/values.md msgid "Literals" msgstr "Literales" @@ -3049,7 +3195,7 @@ msgstr "`3.14`, `-10.0e20`, `2_f32`" msgid "Unicode scalar values" msgstr "Valores escalares Unicode" -#: src/types-and-values/values.md +#: src/types-and-values/values.md src/android/aidl/types/primitives.md msgid "`char`" msgstr "`char`" @@ -3061,7 +3207,7 @@ msgstr "`'a'`, `'α'`, `'∞'`" msgid "Booleans" msgstr "Booleanos" -#: src/types-and-values/values.md +#: src/types-and-values/values.md src/android/aidl/types/primitives.md msgid "`bool`" msgstr "`bool`" @@ -3125,12 +3271,12 @@ msgstr "" #: src/types-and-values/arithmetic.md 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 "" "¿Qué pasa con el desbordamiento de enteros? En C y C++, el desbordamiento de " -"números enteros _con signo_ no está definido y se pueden llevar a cabo " -"distintas acciones en diferentes plataformas o compiladores. En Rust sí está " +"números enteros _con signo_ no está definido, y podría tener diferentes " +"resultados en diferentes plataformas o compiladores. En Rust sí está " "definido." #: src/types-and-values/arithmetic.md @@ -3156,104 +3302,6 @@ msgstr "" "De hecho, el compilador detectará si existe un desbordamiento de expresiones " "constantes, por ello el ejemplo requiere una función independiente." -#: 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 "" -"En Rust hay dos tipos para representar cadenas, de los que hablaremos con " -"detenimiento más adelante. Ambos tipos _siempre_ almacenan cadenas " -"codificadas en UTF-8." - -#: src/types-and-values/strings.md -#, fuzzy -msgid "`String` - a modifiable, owned string." -msgstr "`String` es un búfer de cadena mutable." - -#: src/types-and-values/strings.md -msgid "`&str` - a read-only string. String literals have this type." -msgstr "" -"`&str`: es una cadena de solo lectura. Los literales de cadena son de este " -"tipo." - -#: src/types-and-values/strings.md -msgid "\"Greetings\"" -msgstr "\"Saludos\"" - -#: 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 "\"frase final: {}\"" - -#: 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 "" -"En esta diapositiva se presentan las cadenas. Más adelante hablaremos de " -"todo lo relacionado con este tema, pero esta información es suficiente para " -"que se puedan usar cadenas en las diapositivas y ejercicios que vienen a " -"continuación." - -#: src/types-and-values/strings.md -msgid "Invalid UTF-8 in a string is UB, and this not allowed in safe Rust." -msgstr "" -"La codificación UTF-8 no válida en una cadena tiene comportamiento " -"indefinido y no es compatible con Rust seguro." - -#: 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` es un tipo definido por el usuario con un constructor (`::new()`) y " -"métodos como `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 "" -"La `&` en `&str` indica que se trata de una referencia. Más adelante " -"hablaremos de las referencias, por el momento solo es necesario saber que " -"`&str` es una unidad que significa \"cadena de solo lectura\"." - -#: 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 "" -"La línea marcada como comentario se indexa en la cadena por posición de " -"byte. `12..13` no termina en el límite de un carácter, por lo que el " -"programa da error. Ajusta el intervalo en función del mensaje de error." - -#: 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 "" -"Las cadenas sin formato te permiten crear un valor `&str` con los escapes " -"inhabilitados: `r\"\\n\" == \"\\\\n\"`. Puedes insertar comillas dobles con " -"la misma cantidad de `#` a cada lado de ellas:" - #: src/types-and-values/inference.md msgid "Rust will look at how the variable is _used_ to determine the type:" msgstr "Rust consultará cómo se _usa_ la variable para determinar el tipo:" @@ -3297,13 +3345,13 @@ msgstr "// ERROR: no hay implementación para `{float} == {integer}`\n" #: src/types-and-values/exercise.md 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 "" -"El primer número de Fibonacci y el segundo son `1`. Para n>2, el número de " +"La secuencie de Fibonacci empieza con `[0, 1]`. Para n>1, el número de " "Fibonacci en la posición n se calcula de forma recursiva como la suma de los " -"números de Fibonacci n-1 y n-2'" +"números de Fibonacci n-1 y n-2." #: src/types-and-values/exercise.md msgid "" @@ -3326,80 +3374,27 @@ msgid "// The recursive case.\n" msgstr "// El caso recursivo.\n" #: src/types-and-values/exercise.md src/types-and-values/solution.md -msgid "\"fib(n) = {}\"" -msgstr "\"fib(n) = {}\"" - -#: src/control-flow-basics.md -msgid "[Conditionals](./control-flow-basics/conditionals.md) (5 minutes)" -msgstr "[Condicionales](./control-flow-basics/conditionals.md) (5 minutos)" - -#: src/control-flow-basics.md -msgid "[Loops](./control-flow-basics/loops.md) (5 minutes)" -msgstr "[Bucles](./control-flow-basics/loops.md) (5 minutos)" - -#: src/control-flow-basics.md -msgid "" -"[break and continue](./control-flow-basics/break-continue.md) (5 minutes)" -msgstr "" -"[break y continue](./control-flow-basics/break-continue.md) (5 minutos)" - -#: src/control-flow-basics.md -msgid "" -"[Blocks and Scopes](./control-flow-basics/blocks-and-scopes.md) (10 minutes)" -msgstr "" -"[Bloques y ámbitos (scopes)](./control-flow-basics/blocks-and-scopes.md) (10 " -"minutos)" +msgid "\"fib({n}) = {}\"" +msgstr "\"fib({n}) = {}\"" #: src/control-flow-basics.md -msgid "[Functions](./control-flow-basics/functions.md) (3 minutes)" -msgstr "[Funciones](./control-flow-basics/functions.md) (3 minutos)" +msgid "if Expressions" +msgstr "Expresiones if" -#: src/control-flow-basics.md -msgid "[Macros](./control-flow-basics/macros.md) (2 minutes)" -msgstr "[Macros](./control-flow-basics/macros.md) (2 minutos)" +#: src/control-flow-basics.md src/pattern-matching.md src/concurrency/async.md +#: src/concurrency/async-control-flow.md +msgid "4 minutes" +msgstr "4 minutos" #: src/control-flow-basics.md -msgid "" -"[Exercise: Collatz Sequence](./control-flow-basics/exercise.md) (30 minutes)" -msgstr "" -"[Ejercicio: secuencia de Collatz](./control-flow-basics/exercise.md) (30 " -"minutos)" - -#: src/control-flow-basics.md src/tuples-and-arrays.md src/borrowing.md -msgid "This segment should take about 1 hour" -msgstr "Esta sección tiene una duración aproximada de 1 hora" - -#: src/control-flow-basics/conditionals.md -msgid "Much of the Rust syntax will be familiar to you from C, C++ or Java:" -msgstr "" -"Gran parte de la sintaxis de Rust te resultará familiar de C, C++ o Java:" - -#: src/control-flow-basics/conditionals.md -msgid "Blocks are delimited by curly braces." -msgstr "Los bloques están delimitados por llaves." - -#: src/control-flow-basics/conditionals.md -msgid "" -"Line comments are started with `//`, block comments are delimited by `/* ... " -"*/`." -msgstr "" -"Los comentarios de línea empiezan por `//`, mientras que los comentarios de " -"bloque están delimitados por `/* ... */`." - -#: src/control-flow-basics/conditionals.md -msgid "Keywords like `if` and `while` work the same." -msgstr "Palabras clave como `if` y `while` funcionan igual." - -#: src/control-flow-basics/conditionals.md -msgid "Variable assignment is done with `=`, comparison is done with `==`." -msgstr "" -"La asignación de variables se realiza con `=` y la comparación con `==`." +msgid "break and continue" +msgstr "`break` y `continue`" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md msgid "`if` expressions" msgstr "Expresiones `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:" @@ -3408,19 +3403,19 @@ msgstr "" "expressions/if-expr.html#if-expressions) de la misma forma que en otros " "lenguajes:" -#: src/control-flow-basics/conditionals.md -msgid "\"small\"" -msgstr "\"pequeño\"" +#: src/control-flow-basics/if.md +msgid "\"zero!\"" +msgstr "\"cero!\"" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md msgid "\"biggish\"" msgstr "\"muy grande\"" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md msgid "\"huge\"" msgstr "\"enorme\"" -#: 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:" @@ -3428,26 +3423,29 @@ msgstr "" "Además, puedes utilizar `if` como expresión. La última expresión de cada " "bloque se convierte en el valor de la expresión `if`:" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md +msgid "\"small\"" +msgstr "\"pequeño\"" + +#: src/control-flow-basics/if.md msgid "\"large\"" msgstr "\"grande\"" -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md msgid "\"number size: {}\"" msgstr "\"tamaño del número: {}\"" -#: src/control-flow-basics/conditionals.md -#, fuzzy +#: src/control-flow-basics/if.md msgid "" "Because `if` is an expression and must have a particular type, both of its " "branch blocks must have the same type. Show what happens if you add `;` " "after `\"small\"` in the second example." msgstr "" -"Dado que `if` es una expresión y debe tener un tipo concreto, ambos bloques " -"de ramas deben tener el mismo tipo. En el segundo ejemplo, puedes mostrar lo " -"que sucede al añadir `;` después de `x / 2`." +"Dado que `if` es una expresión y debe tener un tipo concreto, ambos de sus " +"bloques de ramas deben tener el mismo tipo. En el segundo ejemplo, muestra " +"lo que sucede al añadir `;` después de `\"small\"`." -#: src/control-flow-basics/conditionals.md +#: src/control-flow-basics/if.md 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 " @@ -3462,80 +3460,64 @@ msgid "There are three looping keywords in Rust: `while`, `loop`, and `for`:" msgstr "Hay tres palabras clave de bucle en Rust: `while`, `loop` y `for`:" #: src/control-flow-basics/loops.md -#, fuzzy msgid "`while`" msgstr "Bucles `while`" #: src/control-flow-basics/loops.md -#, fuzzy msgid "" "The [`while` keyword](https://doc.rust-lang.org/reference/expressions/loop-" "expr.html#predicate-loops) works much like in other languages, executing the " "loop body as long as the condition is true." msgstr "" "La [palabra clave `while`](https://doc.rust-lang.org/reference/expressions/" -"loop-expr.html#predicate-loops) es muy similar a otros lenguajes:" +"loop-expr.html#predicate-loops) es muy similar a la de otros lenguajes y " +"ejecuta el cuerpo del bucle mientras que la condición sea valida." #: src/control-flow-basics/loops.md msgid "\"Final x: {x}\"" msgstr "\"x final: {x}\"" -#: src/control-flow-basics/loops.md -#, fuzzy -msgid "`for`" -msgstr "Bucles `for`" - -#: src/control-flow-basics/loops.md -#, fuzzy +#: src/control-flow-basics/loops/for.md msgid "" "The [`for` loop](https://doc.rust-lang.org/std/keyword.for.html) iterates " -"over ranges of values:" -msgstr "" -"[`Drop`](https://doc.rust-lang.org/std/ops/trait.Drop.html) se usa para " -"definir destructores." - -#: src/control-flow-basics/loops.md -msgid "`loop`" -msgstr "`loop`" - -#: src/control-flow-basics/loops.md -#, fuzzy -msgid "" -"The [`loop` statement](https://doc.rust-lang.org/std/keyword.loop.html) just " -"loops forever, until a `break`." +"over ranges of values or the items in a collection:" msgstr "" -"[`Drop`](https://doc.rust-lang.org/std/ops/trait.Drop.html) se usa para " -"definir destructores." +"El [bucle `for`](https://doc.rust-lang.org/std/keyword.for.html) itera sobre " +"rangos de valores o las entradas de una colección:" -#: src/control-flow-basics/loops.md -msgid "\"{i}\"" -msgstr "\"{i}\"" +#: src/control-flow-basics/loops/for.md +msgid "\"elem: {elem}\"" +msgstr "\"elem: {elem}\"" -#: src/control-flow-basics/loops.md +#: src/control-flow-basics/loops/for.md msgid "" -"We will discuss iteration later; for now, just stick to range expressions." +"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 "" -"Hablaremos de la iteración más adelante. Por el momento, céntrate en las " -"expresiones de intervalo." +"Los bucles `for` utilizan un concepto llamado \"iteradores\" para iterar " +"sobre diferentes tipos de rangos/colecciones. Los iteradores serán " +"discutidos en mas detalle mas adelante." -#: src/control-flow-basics/loops.md +#: src/control-flow-basics/loops/for.md msgid "" -"Note that the `for` loop only iterates to `4`. Show the `1..=5` syntax for " -"an inclusive range." +"Note that the first `for` loop only iterates to `4`. Show the `1..=5` syntax " +"for an inclusive range." msgstr "" -"Ten en cuenta que el bucle `for` solo se itera en `4`. Muestra la sintaxis " +"Ten en cuenta que el bucle `for` solo se itera a `4`. Muestra la sintaxis " "`1..=5` para un intervalo inclusivo." -#: src/control-flow-basics/break-continue.md -#, fuzzy +#: src/control-flow-basics/loops/loop.md 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 " -"`loop`, this can take an optional expression that becomes the value of the " -"`loop` expression." +"The [`loop` statement](https://doc.rust-lang.org/std/keyword.loop.html) just " +"loops forever, until a `break`." msgstr "" -"Si quieres salir de un bucle antes, usa [`break`](https://doc.rust-lang.org/" -"reference/expressions/loop-expr.html#break-expressions)." +"El [bucle `loop`](https://doc.rust-lang.org/std/keyword.loop.html) repite " +"hasta encontrar un `break`." + +#: src/control-flow-basics/loops/loop.md +msgid "\"{i}\"" +msgstr "\"{i}\"" #: src/control-flow-basics/break-continue.md msgid "" @@ -3547,10 +3529,27 @@ msgstr "" "expressions)." #: src/control-flow-basics/break-continue.md -msgid "\"{result}\"" -msgstr "\"{result}\"" +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 " +"`loop`, this can take an optional expression that becomes the value of the " +"`loop` expression." +msgstr "" +"Si quieres salir de un bucle antes de que termine, usa [`break`](https://doc." +"rust-lang.org/reference/expressions/loop-expr.html#break-expressions). Para " +"`loop`, este puede tomar una expresión opcional que se vuelve el valor de la " +"expresión `loop`." -#: src/control-flow-basics/break-continue.md +#: 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/labels.md msgid "" "Both `continue` and `break` can optionally take a label argument which is " "used to break out of nested loops:" @@ -3558,18 +3557,11 @@ msgstr "" "De forma opcional, tanto `continue` como `break` pueden utilizar un " "argumento de etiqueta para interrumpir los bucles anidados:" -#: 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 "" -"En este caso, detenemos el bucle exterior tras tres iteraciones del bucle " -"interno." +#: src/control-flow-basics/break-continue/labels.md +msgid "\"elements searched: {elements_searched}\"" +msgstr "\"elementos travesados: {elements_searched}\"" -#: src/control-flow-basics/break-continue.md +#: src/control-flow-basics/break-continue/labels.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 " @@ -3584,14 +3576,13 @@ msgid "Blocks" msgstr "Bloques" #: src/control-flow-basics/blocks-and-scopes.md -#, fuzzy msgid "" "A block in Rust contains a sequence of expressions, enclosed by braces `{}`. " "Each block has a value and a type, which are those of the last expression of " "the block:" msgstr "" -"En Rust, un bloque contiene una secuencia de expresiones. Cada bloque tiene " -"un tipo y un valor, que son los de la última expresión del bloque:" +"En Rust, un bloque contiene una secuencia de expresiones rodeados por llaves " +"`{}`. Cada bloque tiene el tipo y valor de la última expresión del bloque:" #: src/control-flow-basics/blocks-and-scopes.md msgid "\"y: {y}\"" @@ -3606,14 +3597,18 @@ msgstr "" "`()`." #: src/control-flow-basics/blocks-and-scopes.md -msgid "Scopes and Shadowing" -msgstr "Ámbitos y _Shadowing_" +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 "" +"Puedes mostrar cómo cambia el valor del bloque cambiando su última línea. " +"Por ejemplo, añade o quita un punto y coma, o utiliza la expresión `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 "El ámbito de una variable se limita al bloque que la contiene." -#: 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:" @@ -3621,36 +3616,28 @@ msgstr "" "Puedes sombrear variables, tanto las de ámbitos externos como las del propio " "ámbito:" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "\"before: {a}\"" msgstr "\"antes: {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 "\"hola\"" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "\"inner scope: {a}\"" msgstr "\"ámbito interno: {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 "\"sombreado en el ámbito interno: {a}\"" -#: src/control-flow-basics/blocks-and-scopes.md +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "\"after: {a}\"" msgstr "\"después: {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 "" -"Puedes mostrar cómo cambia el valor del bloque cambiando su última línea. " -"Por ejemplo, añade o quita un punto y coma, o utiliza la expresión `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." @@ -3659,24 +3646,22 @@ msgstr "" "el bloque interno del último ejemplo y, a continuación, intenta acceder a " "ella desde fuera de ese bloque." -#: src/control-flow-basics/blocks-and-scopes.md -#, fuzzy +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "" "Shadowing is different from mutation, because after shadowing both " "variable's memory locations exist at the same time. Both are available under " "the same name, depending where you use it in the code." msgstr "" -"Definición: _Shadowing_ (sombreado) es distinto de la mutación, ya que, " -"después de sombrear la memoria de las dos variables, las ubicaciones existen " +"Definición: _Shadowing_ (sombreado) es distinto de la mutación, ya que " +"después de sombrear las ubicaciones de memoria de las dos variables existen " "al mismo tiempo. Ambas están disponibles bajo el mismo nombre, en función de " -"dónde se utiliza en el código. " +"dónde se utiliza en el código." -#: src/control-flow-basics/blocks-and-scopes.md -#, fuzzy +#: src/control-flow-basics/blocks-and-scopes/scopes.md msgid "A shadowing variable can have a different type." -msgstr "Una variable sombreada puede tener un tipo diferente. " +msgstr "Una variable sombreada puede tener un tipo diferente." -#: 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()`." @@ -3694,7 +3679,6 @@ msgstr "" "resultado devuelto." #: src/control-flow-basics/functions.md -#, fuzzy msgid "" "The last expression in a function body (or any block) becomes the return " "value. Simply omit the `;` at the end of the expression. The `return` " @@ -3703,7 +3687,9 @@ msgid "" msgstr "" "La última expresión del cuerpo de una función (o de cualquier bloque) se " "convierte en el valor devuelto. Basta con omitir el carácter `;` al final de " -"la expresión." +"la expresión. La palabra clave `return` puede ser utilizado para devolver " +"valores antes del fin de la función, pero la sintaxis de \"valor desnudo\" " +"es idiomático al fin de una función." #: src/control-flow-basics/functions.md msgid "" @@ -3714,10 +3700,11 @@ msgstr "" "`()`. El compilador deducirá esto si se omite el tipo de retorno `-> ()`." #: src/control-flow-basics/functions.md -#, fuzzy msgid "" "Overloading is not supported -- each function has a single implementation." -msgstr "Cada función tiene una única implementación:" +msgstr "" +"El sobrecargo de funciones no existe en Rust -- cada función tiene una única " +"implementación." #: src/control-flow-basics/functions.md msgid "" @@ -3729,11 +3716,12 @@ msgstr "" "variádicas." #: src/control-flow-basics/functions.md -#, fuzzy msgid "" "Always takes a single set of parameter types. These types can be generic, " "which will be covered later." -msgstr "Siempre se utiliza un único conjunto de tipos de parámetros." +msgstr "" +"Siempre se utiliza un solo conjunto de tipos de parámetros. Estos tipos " +"pueden ser genéricos, lo cual discutiremos mas tarde." #: src/control-flow-basics/macros.md msgid "" @@ -3747,13 +3735,13 @@ msgstr "" "macros útiles." #: src/control-flow-basics/macros.md -#, fuzzy msgid "" "`println!(format, ..)` prints a line to standard output, applying formatting " "described in [`std::fmt`](https://doc.rust-lang.org/std/fmt/index.html)." msgstr "" -"La sobrecarga de operadores se implementa mediante _traits_ en [`std::ops`]" -"(https://doc.rust-lang.org/std/ops/index.html):" +"`println!(format, ..)` imprime una linea a la salida estándar (\"standard " +"output\"), aplicando el formato descrito en [`std::fmt`](https://doc.rust-" +"lang.org/std/fmt/index.html)." #: src/control-flow-basics/macros.md msgid "" @@ -3808,279 +3796,98 @@ msgstr "" #: src/control-flow-basics/exercise.md 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 "" "La [secuencia de Collatz](https://es.wikipedia.org/wiki/" -"Conjetura_de_Collatz) se define de la siguiente manera, para n arbitrario" +"Conjetura_de_Collatz) se define de la siguiente manera, para n1 " +"arbitrario mayor que cero:" #: src/control-flow-basics/exercise.md -#, fuzzy -msgid "1" -msgstr "12" +msgid "" +"If _ni_ is 1, then the sequence terminates at _ni_." +msgstr "Si _ni_es 1, la secuencia termina en _ni_." #: src/control-flow-basics/exercise.md -msgid " greater than zero:" -msgstr " mayor que cero:" +msgid "If _ni_ is even, then _ni+1 = ni / 2_." +msgstr "Si _ni_ es par, _ni+1 = ni / 2_." #: src/control-flow-basics/exercise.md -msgid "If _n" -msgstr "Si _n" +msgid "" +"If _ni_ is odd, then _ni+1 = 3 * ni + 1_." +msgstr "" +"Si _ni_ es impar, _ni+1 = 3 * ni + 1_." #: src/control-flow-basics/exercise.md -msgid "i" -msgstr "i" +msgid "For example, beginning with _n1_ = 3:" +msgstr "Por ejemplo, empezando con _n1_ = 3:" #: src/control-flow-basics/exercise.md -msgid "_ is 1, then the sequence terminates at _n" -msgstr "_ es 1, la secuencia termina en _n" +msgid "3 is odd, so _n2_ = 3 * 3 + 1 = 10;" +msgstr "3 es impar, entonces _n2_ = 3 * 3 + 1 = 10;" #: src/control-flow-basics/exercise.md -msgid "_." -msgstr "_." +msgid "10 is even, so _n3_ = 10 / 2 = 5;" +msgstr "10 is par, entonces _n3_ = 10 / 2 = 5;" #: src/control-flow-basics/exercise.md -msgid "_ is even, then _n" -msgstr "_ es par, entonces _n" +msgid "5 is odd, so _n4_ = 3 * 5 + 1 = 16;" +msgstr "5 es impar, entonces _n4_ = 3 * 5 + 1 = 16;" #: src/control-flow-basics/exercise.md -msgid "i+1" -msgstr "i+1" +msgid "16 is even, so _n5_ = 16 / 2 = 8;" +msgstr "16 es par, entonces _n5_ = 16 / 2 = 8;" #: src/control-flow-basics/exercise.md -msgid " = n" -msgstr " = n" +msgid "8 is even, so _n6_ = 8 / 2 = 4;" +msgstr "8 es par, entonces _n6_ = 8 / 2 = 4;" #: src/control-flow-basics/exercise.md -msgid " / 2_." -msgstr " / 2_." +msgid "4 is even, so _n7_ = 4 / 2 = 2;" +msgstr "44 es par, entonces _n7_ = 4 / 2 = 2;" #: src/control-flow-basics/exercise.md -msgid "_ is odd, then _n" -msgstr "_ es impar, entonces _n" +msgid "2 is even, so _n8_ = 1; and" +msgstr "2 es par, entonces _n8_ = 1; and" #: src/control-flow-basics/exercise.md -msgid " = 3 * n" -msgstr " = 3 * n" +msgid "the sequence terminates." +msgstr "la secuencia finaliza." #: src/control-flow-basics/exercise.md -msgid " + 1_." -msgstr " + 1_." +msgid "" +"Write a function to calculate the length of the collatz sequence for a given " +"initial `n`." +msgstr "" +"Escribe una función para calcular la longitud de la secuencia de Collatz " +"para un número `n` inicial dado." -#: src/control-flow-basics/exercise.md -msgid "For example, beginning with _n" -msgstr "Por ejemplo, si empieza por _n" +#: src/control-flow-basics/exercise.md src/control-flow-basics/solution.md +msgid "/// Determine the length of the collatz sequence beginning at `n`.\n" +msgstr "" +"/// Determina la longitud de la secuencia de Collatz que empieza por `n`.\n" -#: src/control-flow-basics/exercise.md -msgid "_ = 3:" -msgstr "_ = 3:" +#: src/control-flow-basics/solution.md src/concurrency/threads/scoped.md +msgid "\"Length: {}\"" +msgstr "\"Longitud: {}\"" -#: src/control-flow-basics/exercise.md -msgid "3 is odd, so _n" -msgstr "3 es impar, por lo que _n" +#: src/welcome-day-1-afternoon.md src/welcome-day-2-afternoon.md +#: src/welcome-day-3-afternoon.md src/welcome-day-4-afternoon.md +msgid "Welcome Back" +msgstr "Te damos la bienvenida" -#: src/control-flow-basics/exercise.md -#, fuzzy -msgid "2" -msgstr "12" - -#: 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 es par, por lo que _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 es impar, por lo que _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 es par, por lo que _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 es par, por lo que _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 es par, por lo que _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 es par, por lo que _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; y" - -#: src/control-flow-basics/exercise.md -msgid "the sequence terminates." -msgstr "la secuencia finaliza." - -#: src/control-flow-basics/exercise.md -msgid "" -"Write a function to calculate the length of the collatz sequence for a given " -"initial `n`." -msgstr "" -"Escribe una función para calcular la longitud de la secuencia de Collatz " -"para un número `n` inicial dado." - -#: src/control-flow-basics/exercise.md src/control-flow-basics/solution.md -msgid "/// Determine the length of the collatz sequence beginning at `n`.\n" -msgstr "" -"/// Determina la longitud de la secuencia de Collatz que empieza por `n`.\n" - -#: src/control-flow-basics/solution.md src/concurrency/scoped-threads.md -msgid "\"Length: {}\"" -msgstr "\"Longitud: {}\"" - -#: src/welcome-day-1-afternoon.md src/welcome-day-2-afternoon.md -#: src/welcome-day-3-afternoon.md src/welcome-day-4-afternoon.md -#, fuzzy -msgid "Welcome Back" -msgstr "Te damos la bienvenida" - -#: src/welcome-day-1-afternoon.md -msgid "[Tuples and Arrays](./tuples-and-arrays.md) (1 hour)" -msgstr "[Tuplas y arrays](./tuples-and-arrays.md) (1 hora)" - -#: src/welcome-day-1-afternoon.md -msgid "[References](./references.md) (50 minutes)" -msgstr "[Referencias](./references.md) (50 minutos)" - -#: src/welcome-day-1-afternoon.md -msgid "[User-Defined Types](./user-defined-types.md) (50 minutes)" -msgstr "" -"[Tipos definidos por el usuario](./user-definition-types.md) (50 minutos)" - -#: src/welcome-day-1-afternoon.md -msgid "" -"Including 10 minute breaks, this session should take about 2 hours and 55 " -"minutes" -msgstr "" -"Contando con los descansos de 10 minutos, la duración prevista de la sesión " -"es de unas 2 horas y 55 minutos." +#: src/welcome-day-1-afternoon.md +msgid "" +"Including 10 minute breaks, this session should take about 2 hours and 35 " +"minutes. It contains:" +msgstr "" +"Contando con los descansos de 10 minutos, la duración prevista de la sesión " +"es de unas 2 horas y 35 minutos. Contiene:" #: src/tuples-and-arrays.md -msgid "" -"[Tuples and Arrays](./tuples-and-arrays/tuples-and-arrays.md) (10 minutes)" -msgstr "" -"[Tuplas y arrays](./tuples-and-arrays/tuples-and-arrays.md) (10 minutos)" - -#: src/tuples-and-arrays.md -msgid "[Array Iteration](./tuples-and-arrays/iteration.md) (3 minutes)" -msgstr "[Iteración de arrays](./tuples-and-arrays/iteration.md) (3 minutos)" - -#: src/tuples-and-arrays.md -msgid "[Pattern Matching](./tuples-and-arrays/match.md) (10 minutes)" -msgstr "[Coincidencia de patrones](./tuples-and-arrays/match.md) (10 minutos)" - -#: src/tuples-and-arrays.md -msgid "[Destructuring](./tuples-and-arrays/destructuring.md) (5 minutes)" -msgstr "[Desestructuración](./tuples-and-arrays/destructuring.md) (5 minutos)" - -#: src/tuples-and-arrays.md -msgid "[Exercise: Nested Arrays](./tuples-and-arrays/exercise.md) (30 minutes)" -msgstr "" -"[Ejercicio: Arrays anidados](./tuples-and-arrays/exercise.md) (30 minutos)" - -#: 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 "" -"Las tuplas y los arrays son los primeros tipos \"compuestos\" que hemos " -"estudiado. Todos los elementos de un array tienen el mismo tipo, mientras " -"que las tuplas admiten distintos tipos. Ambos tipos tienen un tamaño fijo " -"durante el tiempo de compilación." - -#: src/tuples-and-arrays/tuples-and-arrays.md -#: src/tuples-and-arrays/destructuring.md -msgid "Arrays" -msgstr "Arrays" - -#: 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 "Tuplas" +msgid "This segment should take about 35 minutes. It contains:" +msgstr "Esta sección tiene una duración aproximada de 35 minutos. Contiene:" -#: 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 "Asignación y acceso a arrays:" - -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "Tuple assignment and access:" -msgstr "Asignación y acceso a tuplas:" - -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "Arrays:" -msgstr "Arrays:" - -#: src/tuples-and-arrays/tuples-and-arrays.md -#, fuzzy +#: 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 " @@ -4090,10 +3897,11 @@ msgid "" msgstr "" "Un valor del tipo array `[T; N]` contiene `N` (una constante en tiempo de " "compilación) elementos del mismo tipo `T`. Ten en cuenta que la longitud del " -"array es *parte de su tipo*, lo que significa que `[u8; 3]` y `[u8; 4]` se " -"consideran dos tipos diferentes." +"array es _parte de su tipo), lo que significa que `[u8; 3]` y `[u8; 4]` se " +"consideran dos tipos diferentes. Los slices, que tienen un tamaño " +"determinado al tiempo de ejecución, serán discutidos mas tarde." -#: 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 " @@ -4103,12 +3911,11 @@ msgstr "" "arrays se comprueban en el tiempo de ejecución. Rust suele optimizar estas " "comprobaciones y se pueden evitar utilizando Rust inseguro." -#: 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 "Podemos usar literales para asignar valores a arrays." -#: src/tuples-and-arrays/tuples-and-arrays.md -#, fuzzy +#: 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. " @@ -4116,13 +3923,13 @@ msgid "" "only implement the debug output. This means that we must use debug output " "here." msgstr "" -"En la función _main_, la instrucción de impresión solicita la implementación " -"de depuración con el parámetro de formato `?`: `{}` ofrece la salida " -"predeterminada y `{:?}` ofrece la salida de depuración. También se podría " -"haber usado `{a}` y `{a:?}` sin especificar el valor después de la cadena de " -"formato." +"El macro de impresión `println!` solicita la implementación de depuración " +"con el parámetro de formato `?`: `{}` ofrece la salida predeterminada y `{:?}" +"` ofrece la salida de depuración. Tipos como números enteros y cadenas " +"implementan la salida de depuración. Esto significan que tenemos que usar la " +"salida de depuración en este caso." -#: 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." @@ -4130,19 +3937,15 @@ msgstr "" "Si se añade `#`, por ejemplo `{a:#?}`, se da formato al texto para facilitar " "la lectura." -#: src/tuples-and-arrays/tuples-and-arrays.md -msgid "Tuples:" -msgstr "Tuplas:" - -#: src/tuples-and-arrays/tuples-and-arrays.md +#: src/tuples-and-arrays/tuples.md msgid "Like arrays, tuples have a fixed length." msgstr "Al igual que los arrays, las tuplas tienen una longitud fija." -#: 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 "Las tuplas agrupan valores de diferentes tipos en un tipo compuesto." -#: 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`." @@ -4150,28 +3953,13 @@ msgstr "" "Se puede acceder a los campos de una tupla por el punto y el índice del " "valor, por ejemplo, `t.0`, `t.1`." -#: src/tuples-and-arrays/tuples-and-arrays.md -#, fuzzy -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 "" -"La tupla vacía `()` también se conoce como \"tipo unitario\". Es a la vez un " -"tipo y el único valor válido de ese tipo, es decir, tanto el tipo como su " -"valor se expresan como `()`. Se usa para indicar, por ejemplo, que una " -"función o expresión no tiene valor de retorno, como veremos en una " -"diapositiva posterior." - -#: src/tuples-and-arrays/tuples-and-arrays.md -#, fuzzy +#: 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 "" -"Podríamos pensar en ello como `void`, que quizá resulte familiar de otros " -"lenguajes de programación." +"La tupla vacía `()` es llamado el \"tipo de unidad\" y significa la ausencia " +"de un valor de retorno, parecido a `void` en otros lenguajes." #: src/tuples-and-arrays/iteration.md msgid "The `for` statement supports iterating over arrays (but not tuples)." @@ -4196,317 +3984,118 @@ msgstr "" "solo depuración, como `debug_assert!`, no compilan nada en las compilaciones " "de lanzamiento." -#: src/tuples-and-arrays/match.md -#, fuzzy +#: src/tuples-and-arrays/destructuring.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 "" -"La palabra clave `match` te permite comparar un valor con uno o varios " -"_patrones_. Las comparaciones se hacen de arriba abajo y el primero que " -"coincida gana." - -#: src/tuples-and-arrays/match.md -msgid "The patterns can be simple values, similarly to `switch` in C and C++:" +"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 "" -"Los patrones pueden ser valores simples, del mismo modo que `switch` en C y " -"C++:" - -#: 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 "\"Salir\"" - -#: 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 "\"Desplazarse\"" - -#: 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'" +"Cuando uno trabaja con tuplas y otros valores estructurados, es común querer " +"extraer valores interiores a variables locales. Uno puede manualmente " +"acceder los valores interiores:" -#: src/tuples-and-arrays/match.md -msgid "\"Number input\"" -msgstr "\"Introducción de números\"" - -#: src/tuples-and-arrays/match.md -msgid "\"Lowercase: {key}\"" -msgstr "\"Minúscula: {key}\"" - -#: src/tuples-and-arrays/match.md -msgid "\"Something else\"" -msgstr "\"Otro\"" +#: src/tuples-and-arrays/destructuring.md +msgid "\"left: {left}, right: {right}\"" +msgstr "\"left: {left}, right: {right}\"" -#: src/tuples-and-arrays/match.md +#: src/tuples-and-arrays/destructuring.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." +"However, Rust also supports using pattern matching to destructure a larger " +"value into its constituent parts:" msgstr "" -"`_` es un patrón comodín que coincide con cualquier valor. Las expresiones " -"_deben_ ser irrefutables, lo que significa que deben tener en cuenta todas " -"las posibilidades, por lo que `_` a menudo se usa como caso que atrapa todo." +"Rust también provee la coincidencia de patrones para destructurar un valor " +"en sus partes constituyentes:" -#: src/tuples-and-arrays/match.md -#, fuzzy +#: 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 `()`." +"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 "" -"Al igual que con `if let`, cada brazo de coincidencia debe ser del mismo " -"tipo. El tipo es la última expresión del bloque, si la hay. En el ejemplo " -"anterior, el tipo es `()`." +"Los patrones usados aquí son \"irrefutables\", es decir que el compilador " +"puede estáticamente verificar que el valor a la derecha del `=` tiene la " +"misma estructura que el patrón." -#: src/tuples-and-arrays/match.md +#: src/tuples-and-arrays/destructuring.md msgid "" -"A variable in the pattern (`key` in this example) will create a binding that " -"can be used within the match arm." +"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 "" -"Una variable del patrón (en este ejemplo, `key`) creará un enlace que se " -"puede usar dentro del brazo de coincidencia." +"Un nombre de variable es un patrón irrefutable que siempre coincide con " +"cualquier valor, así que también podemos usar `let` para declarar una sola " +"variable." -#: src/tuples-and-arrays/match.md -msgid "A match guard causes the arm to match only if the condition is true." +#: src/tuples-and-arrays/destructuring.md +msgid "" +"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 "" -"Un protección de coincidencia hace que la expresión coincida únicamente si " -"se cumple la condición." +"Los patrones también se pueden usar en los condicionales, dejando que la " +"comparación de igualdad y el desestructuramiento ocurren al mismo tiempo. " +"Esta forma de coincidencia de patrones sera discutido mas a fondo mas tarde." -#: 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 "Puntos Clave:" - -#: src/tuples-and-arrays/match.md +#: src/tuples-and-arrays/destructuring.md msgid "" -"You might point out how some specific characters are being used when in a " -"pattern" -msgstr "Puedes señalar cómo se usan algunos caracteres concretos en un patrón" - -#: src/tuples-and-arrays/match.md -msgid "`|` as an `or`" -msgstr "`|` como `or`," - -#: src/tuples-and-arrays/match.md -msgid "`..` can expand as much as it needs to be" -msgstr "`..` se puede ampliar tanto como sea necesario." +"Edit the examples above to show the compiler error when the pattern doesn't " +"match the value being matched on." +msgstr "" +"Edita los ejemplos anteriores para enseñar el error de compilador cuando el " +"patrón no coincide con el valor." -#: src/tuples-and-arrays/match.md -msgid "`1..=5` represents an inclusive range" -msgstr "`1..=5` representa un rango inclusivo." +#: src/tuples-and-arrays/exercise.md +msgid "Arrays can contain other arrays:" +msgstr "Los arrays pueden contener otros arrays:" -#: src/tuples-and-arrays/match.md -msgid "`_` is a wild card" -msgstr "`_` es un comodín." +#: src/tuples-and-arrays/exercise.md +msgid "What is the type of this variable?" +msgstr "¿Cuál es el tipo de esta variable?" -#: src/tuples-and-arrays/match.md +#: src/tuples-and-arrays/exercise.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." +"Use an array such as the above to write a function `transpose` which will " +"transpose a matrix (turn rows into columns):" msgstr "" -"Las guardas de coincidencia, como característica sintáctica independiente, " -"son importantes y necesarios cuando queremos expresar de forma concisa ideas " -"más complejas de lo que permitirían los patrones por sí solos." +"Usa el método anterior para escribir una función `transpose` que transpone " +"una matriz (convierte filas en columnas):" -#: src/tuples-and-arrays/match.md +#: src/tuples-and-arrays/exercise.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." +"Copy the code below to and implement the " +"function. This function only operates on 3x3 matrices." msgstr "" -"No son lo mismo que una expresión `if` independiente dentro del brazo de " -"coincidencias. Una expresión `if` dentro del bloque de ramas (después de " -"`=>`) se produce tras seleccionar el brazo de coincidencias. Si no se cumple " -"la condición `if` dentro de ese bloque, no se tienen en cuenta otros brazos " -"de la expresión `match` original." +"Copia el siguiente fragmento de código en e " +"implementa la función. Esta función solo opera sobre matrices 3x3." -#: src/tuples-and-arrays/match.md -msgid "" -"The condition defined in the guard applies to every expression in a pattern " -"with an `|`." -msgstr "" -"La condición definida en el guarda se aplica a todas las expresiones de un " -"patrón con un `|`." +#: src/tuples-and-arrays/exercise.md src/borrowing/exercise.md +#: src/unsafe-rust/exercise.md +msgid "// TODO: remove this when you're done with your implementation.\n" +msgstr "// TODO: borra esto cuando termines de implementarlo.\n" -#: 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." -msgstr "" -"La desestructuración es una forma de extraer datos de una estructura de " -"datos al escribir un patrón que coincida con la estructura de datos, es " -"decir, enlazando variables a los subcomponentes de dicha estructura." +#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md +msgid "//\n" +msgstr "//\n" -#: src/tuples-and-arrays/destructuring.md -#, fuzzy -msgid "You can destructure tuples and arrays by matching on their elements:" -msgstr "" -"Puedes desestructurar arrays, tuplas y slices haciendo coincidir sus " -"elementos:" +#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md +msgid "// <-- the comment makes rustfmt add a newline\n" +msgstr "// <-- el comentario hace que rustfmt añade una nueva línea\n" -#: src/tuples-and-arrays/destructuring.md -msgid "\"on Y axis\"" -msgstr "\"en el eje Y\"" +#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md +msgid "\"matrix: {:#?}\"" +msgstr "\"matriz: {:#?}\"" -#: src/tuples-and-arrays/destructuring.md -msgid "\"on X axis\"" -msgstr "\"en el eje X\"" +#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md +msgid "\"transposed: {:#?}\"" +msgstr "\"traspuesto: {:#?}\"" -#: src/tuples-and-arrays/destructuring.md -msgid "\"left of Y axis\"" -msgstr "\"a la izquierda del eje Y\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"below X axis\"" -msgstr "\"debajo del eje X\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"first quadrant\"" -msgstr "\"primer cuadrante\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"Tell me about {triple:?}\"" -msgstr "\"Dame información sobre {triple:?}\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"First is 0, y = {y}, and z = {z}\"" -msgstr "\"El primero es 0, y = {y}, z = {z}\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"First is 1 and the rest were ignored\"" -msgstr "\"El primero es 1 y el resto se ha ignorado\"" - -#: src/tuples-and-arrays/destructuring.md -msgid "\"All elements were ignored\"" -msgstr "\"Se han ignorado todos los elementos\"" - -#: src/tuples-and-arrays/destructuring.md -#, fuzzy -msgid "Create a new array pattern using `_` to represent an element." -msgstr "Crea un patrón con `_` para representar un elemento. " - -#: src/tuples-and-arrays/destructuring.md -msgid "Add more values to the array." -msgstr "Añade más valores al array." - -#: src/tuples-and-arrays/destructuring.md -msgid "" -"Point out that how `..` will expand to account for different number of " -"elements." -msgstr "" -"Señala cómo `..` se expandirá para representar un número distinto de " -"elementos." - -#: src/tuples-and-arrays/destructuring.md -msgid "Show matching against the tail with patterns `[.., b]` and `[a@..,b]`" -msgstr "" -"Muestra las coincidencias de tail con los patrones `[.., b]` y `[a@..,b]`." - -#: src/tuples-and-arrays/exercise.md -msgid "Arrays can contain other arrays:" -msgstr "Los arrays pueden contener otros arrays:" - -#: src/tuples-and-arrays/exercise.md -#, fuzzy -msgid "What is the type of this variable?" -msgstr "¿Cuál es el tipo de `word` en cada bucle?" - -#: src/tuples-and-arrays/exercise.md -#, fuzzy -msgid "" -"Use an array such as the above to write a function `transpose` which will " -"transpose a matrix (turn rows into columns):" -msgstr "" -"Usa el método anterior para escribir una función `pretty_print` que sirva " -"para dar formato al texto de la matriz y una función `transpose` que " -"transponga una matriz (convertir filas en columnas):" - -#: src/tuples-and-arrays/exercise.md -msgid "Hard-code both functions to operate on 3 × 3 matrices." -msgstr "Codifica ambas funciones para que operen con matrices de 3 × 3." - -#: src/tuples-and-arrays/exercise.md -msgid "" -"Copy the code below to and implement the " -"functions:" -msgstr "" -"Copia el siguiente fragmento de código en e " -"implementa las funciones:" - -#: src/tuples-and-arrays/exercise.md src/borrowing/exercise.md -#: src/unsafe-rust/exercise.md -#, fuzzy -msgid "// TODO: remove this when you're done with your implementation.\n" -msgstr "" -"```rust,should_panic\n" -"// TODO: borra esto cuando termines de implementarlo.\n" -"#![allow(unused_variables, dead_code)]\n" -"```" - -#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md -msgid "// <-- the comment makes rustfmt add a newline\n" -msgstr "// <-- el comentario hace que rustfmt añada una nueva línea\n" - -#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md -msgid "\"matrix: {:#?}\"" -msgstr "\"matriz: {:#?}\"" - -#: src/tuples-and-arrays/exercise.md src/tuples-and-arrays/solution.md -msgid "\"transposed: {:#?}\"" -msgstr "\"traspuesto: {:#?}\"" - -#: src/tuples-and-arrays/solution.md -msgid "//\n" -msgstr "//\n" - -#: src/references.md -msgid "[Shared References](./references/shared.md) (10 minutes)" -msgstr "[Referencias compartidas](./references/shared.md) (10 minutos)" +#: src/references.md src/smart-pointers.md src/borrowing.md +#: src/concurrency/async-pitfalls.md +msgid "This segment should take about 55 minutes. It contains:" +msgstr "Esta sección tiene una duración aproximada de 55 minutos. Contiene:" #: src/references.md -msgid "[Exclusive References](./references/exclusive.md) (10 minutes)" -msgstr "[Referencias exclusivas](./references/included.md) (10 minutos)" - -#: src/references.md -msgid "[Exercise: Geometry](./references/exercise.md) (30 minutes)" -msgstr "[Ejercicio: geometría](./references/exercise.md) (30 minutos)" - -#: src/references.md src/user-defined-types.md src/pattern-matching.md -msgid "This segment should take about 50 minutes" -msgstr "Esta sección tiene una duración aproximada de 50 minutos." +msgid "Slices: &\\[T\\]" +msgstr "Slices: &\\[T\\]" #: src/references/shared.md msgid "" @@ -4568,14 +4157,14 @@ msgid "" msgstr "Rust no crea referencias automáticamente, `&` siempre es obligatorio." #: 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 realizará una desreferencia automática en algunos casos, en especial al " -"invocar métodos (prueba `ref_x.count_ones()`)." +"invocar métodos (prueba `ref_x.count_ones()`). No hay necesidad para un " +"operador `->` como en C++." #: src/references/shared.md msgid "" @@ -4638,17 +4227,214 @@ msgstr "" "cambiar `point.0` mientras `x_coord` está activo." #: src/references/exclusive.md -#, fuzzy msgid "" "Be sure to note the difference between `let mut x_coord: &i32` and `let " "x_coord: &mut i32`. The first one represents a shared reference which can be " "bound to different values, while the second represents an exclusive " "reference to a mutable value." msgstr "" -"Ten en cuenta la diferencia entre `let mut ref_x: &i32` y `let ref_x: &mut " -"i32`. La primera representa una referencia mutable que se puede vincular a " -"distintos valores, mientras que la segunda representa una referencia a un " -"valor mutable." +"Ten en cuenta la diferencia entre `let mut x_coord: &i32` y `let x_coord: " +"&mut i32`. La primera representa una referencia mutable que se puede " +"vincular a distintos valores, mientras que la segunda representa una " +"referencia a un valor mutable." + +#: src/references/slices.md +msgid "Slices" +msgstr "Slices" + +#: src/references/slices.md +msgid "A slice gives you a view into a larger collection:" +msgstr "Un _slice_ ofrece una visión de una colección más amplia:" + +#: src/references/slices.md +msgid "Slices borrow data from the sliced type." +msgstr "Los slices toman prestados datos del tipo slice." + +#: src/references/slices.md +msgid "Question: What happens if you modify `a[3]` right before printing `s`?" +msgstr "" +"Pregunta: ¿Qué ocurre si se modifica `a[3]` justo antes de imprimir `s`?" + +#: src/references/slices.md +msgid "" +"We create a slice by borrowing `a` and specifying the starting and ending " +"indexes in brackets." +msgstr "" +"Creamos un slice tomando prestado `a` y especificando entre paréntesis los " +"índices de inicio y de fin." + +#: 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 "" +"Si el slice comienza en el índice 0, la sintaxis de rango de Rust nos " +"permite eliminar el índice inicial, lo que significa que `&a[0..a.len()]` y " +"`&a[..a.len()]` son idénticos." + +#: src/references/slices.md +msgid "" +"The same is true for the last index, so `&a[2..a.len()]` and `&a[2..]` are " +"identical." +msgstr "" +"Lo mismo ocurre con el último índice, por lo que `&a[2..a.len()]` y " +"`&a[2..]` son idénticos." + +#: src/references/slices.md +msgid "" +"To easily create a slice of the full array, we can therefore use `&a[..]`." +msgstr "" +"Para crear fácilmente un slice del array completo, podemos usar `&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` es una referencia a un slice de `i32`s. Ten en cuenta que el tipo de `s` " +"(`&[i32]`) ya no menciona la longitud del array. Esto nos permite realizar " +"cálculos en slices de diferentes tamaños." + +#: 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 "" +"Los slices siempre tienen préstamos de otros objetos. En este ejemplo, `a` " +"tiene que permanecer \"vivo\" (en el ámbito) al menos durante el tiempo que " +"dure el slice." + +#: 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 "" +"La cuestión sobre la modificación de `a[3]` puede suscitar un debate " +"interesante, pero la respuesta es que, por razones de seguridad de memoria, " +"no se puede hacer mediante `a` en este punto de la ejecución, pero sí se " +"pueden leer los datos de `a` y `s` de forma segura. Funciona antes de crear " +"el slice y después de `println`, cuando el slice ya no se utiliza." + +#: src/references/strings.md +msgid "We can now understand the two string types in Rust:" +msgstr "Ahora podemos entender los dos tipos de cadenas de Rust:" + +#: src/references/strings.md +msgid "`&str` is a slice of UTF-8 encoded bytes, similar to `&[u8]`." +msgstr "`&str` es un slice de bytes codificados en UTF-8, parecido a `&[u8]`." + +#: src/references/strings.md +msgid "" +"`String` is an owned buffer of UTF-8 encoded bytes, similar to `Vec`." +msgstr "" +"`String` es un buffer adueñado de bytes codificados en UTF-8, parecido a " +"`Vec`." + +#: src/references/strings.md src/std-traits/read-and-write.md +msgid "\"World\"" +msgstr "\"mundo\"" + +#: src/references/strings.md +msgid "\"s1: {s1}\"" +msgstr "\"s1: {s1}\"" + +#: src/references/strings.md +msgid "\"Hello \"" +msgstr "\"¡Hola \"" + +#: 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 +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` introduce un slice de cadena, que es una referencia inmutable a los " +"datos de cadena codificados en UTF-8 y almacenados en un bloque de memoria. " +"Los literales de cadena (`\"Hello\"`) se almacenan en el binario del " +"programa." + +#: src/references/strings.md +msgid "" +"Rust's `String` type is a wrapper around a vector of bytes. As with a " +"`Vec`, it is owned." +msgstr "" +"El tipo `String` de Rust es un envoltorio que rodea a un vector de bytes. " +"Como sucede con `Vec`, tiene propietario." + +#: 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 "" +"Al igual que ocurre con muchos otros tipos, `String::from()` crea una cadena " +"a partir de un literal de cadena. `String::new()` crea una cadena vacía a la " +"que se pueden añadir datos de cadena mediante los métodos `push()` y " +"`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 "" +"La macro `format!()` es una forma práctica de generar una cadena propia a " +"partir de valores dinámicos. Acepta la misma especificación de formato que " +"`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 "" +"Puedes tomar prestados slices `&str` de `String` a través de `&` y, de forma " +"opcional, la selección de intervalos. Si seleccionas un intervalo de bytes " +"que no esté alineado con los límites de caracteres, la expresión activará un " +"pánico. El iterador `chars` itera sobre los caracteres y se aconseja esta " +"opción a intentar definir los límites de los caracteres correctamente." + +#: 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 "" +"Para los programadores de C++: piensa en `&str` como el `const char*` de C+" +"+, pero uno que siempre apunta a una cadena válida en la memoria. El " +"`String` de Rust es parecido a `std::string` de C++ (la diferencia principal " +"es que solo puede contener bytes codificados en UTF-8 y nunca utilizará una " +"optimización de cadena pequeña)." + +#: src/references/strings.md +msgid "Byte strings literals allow you to create a `&[u8]` value directly:" +msgstr "" +"Los literales de cadenas de bytes te permiten crear un valor `&[u8]` " +"directamente:" + +#: 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 "" +"Las cadenas sin formato te permiten crear un valor `&str` con los escapes " +"inhabilitados: `r\"\\n\" == \"\\\\n\"`. Puedes insertar comillas dobles con " +"la misma cantidad de `#` a cada lado de ellas:" #: src/references/exercise.md msgid "" @@ -4708,39 +4494,9 @@ msgid "" "direction.\n" msgstr "/// Cambia la magnitud del vector a 1.0 sin cambiar su dirección.\n" -#: src/user-defined-types.md -msgid "[Named Structs](./user-defined-types/named-structs.md) (10 minutes)" -msgstr "" -"[Estructuras con nombre](./user-undefined-types/named-structs.md) (10 " -"minutos)" - -#: src/user-defined-types.md -msgid "[Tuple Structs](./user-defined-types/tuple-structs.md) (10 minutes)" -msgstr "" -"[Estructuras de tuplas](./user-definition-types/tuple-structs.md) (10 " -"minutos)" - -#: src/user-defined-types.md -msgid "[Enums](./user-defined-types/enums.md) (5 minutes)" -msgstr "[Enums](./user-undefined-types/enums.md) (5 minutos)" - -#: src/user-defined-types.md -msgid "" -"[Static and Const](./user-defined-types/static-and-const.md) (5 minutes)" -msgstr "" -"[Variables Static y Const](./user-definition-types/static-and-const.md) (5 " -"minutos)" - -#: src/user-defined-types.md -msgid "[Type Aliases](./user-defined-types/aliases.md) (2 minutes)" -msgstr "[Alias de tipo](./user-definition-types/aliases.md) (2 minutos)" - -#: src/user-defined-types.md -msgid "" -"[Exercise: Elevator Events](./user-defined-types/exercise.md) (15 minutes)" -msgstr "" -"[Ejercicio: Eventos de ascensor](./user-definition-types/exercise.md) (15 " -"minutos)" +#: src/user-defined-types.md src/methods-and-traits.md src/lifetimes.md +msgid "This segment should take about 50 minutes. It contains:" +msgstr "Esta sección tiene una duración aproximada de 50 minutos. Contiene:" #: src/user-defined-types/named-structs.md msgid "Like C and C++, Rust has support for custom structs:" @@ -4763,6 +4519,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 "Puntos Clave:" + #: src/user-defined-types/named-structs.md msgid "Structs work like in C or C++." msgstr "Las estructuras funcionan como en C o en C++." @@ -4778,24 +4539,21 @@ msgid "Unlike in C++, there is no inheritance between structs." msgstr "A diferencia de C++, no existe ninguna herencia entre las estructuras." #: src/user-defined-types/named-structs.md -#, fuzzy msgid "" "This may be a good time to let people know there are different types of " "structs." msgstr "" "Puede que sea un buen momento para indicar a los alumnos que existen " -"diferentes tipos de estructuras. " +"diferentes tipos de estructuras." #: src/user-defined-types/named-structs.md -#, fuzzy msgid "" "Zero-sized structs (e.g. `struct Foo;`) might be used when implementing a " "trait on some type but don’t have any data that you want to store in the " "value itself." msgstr "" "Las estructuras de tamaño cero, como `struct Foo;`, se pueden utilizar al " -"implementar un trait en algún tipo, pero no tienen ningún dato que te " -"interese almacenar en el propio valor. " +"implementar un trait en algún tipo en cuyo valor no quieres almacenar datos." #: src/user-defined-types/named-structs.md msgid "" @@ -4806,22 +4564,20 @@ msgstr "" "utilizan cuando los nombres de los campos no son importantes." #: src/user-defined-types/named-structs.md -#, fuzzy msgid "" "If you already have variables with the right names, then you can create the " "struct using a shorthand." msgstr "" "Si ya dispones de variables con los nombres adecuados, puedes crear la " -"estructura con un método abreviado:" +"estructura con un método abreviado." #: src/user-defined-types/named-structs.md -#, fuzzy msgid "" "The syntax `..avery` allows us to copy the majority of the fields from the " "old struct without having to explicitly type it all out. It must always be " "the last element." msgstr "" -"La sintaxis `..peter` nos permite copiar la mayoría de los campos de la " +"La sintaxis `..avery` nos permite copiar la mayoría de los campos de la " "estructura anterior sin tener que escribirlos explícitamente. Siempre debe " "ser el último elemento." @@ -4848,7 +4604,7 @@ msgstr "\"Pregunta a un científico aeroespacial de la 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" @@ -4866,7 +4622,6 @@ msgstr "" "El número se mide en algunas unidades: `Newtons` en el ejemplo anterior." #: src/user-defined-types/tuple-structs.md -#, fuzzy msgid "" "The value passed some validation when it was created, so you no longer have " "to validate it again at every use: `PhoneNumber(String)` or `OddNumber(u32)`." @@ -4927,10 +4682,10 @@ msgid "\"On this turn: {:?}\"" msgstr "\"En este turno: {:?}\"" #: src/user-defined-types/enums.md -#, fuzzy msgid "Enumerations allow you to collect a set of values under one type." msgstr "" -"Las enumeraciones te permiten recoger un conjunto de valores en un solo tipo." +"Las enumeraciones te permiten colectar un conjunto de valores en un solo " +"tipo." #: src/user-defined-types/enums.md msgid "" @@ -4951,22 +4706,19 @@ msgstr "" "valor `PlayerMove` en el tiempo de ejecución." #: src/user-defined-types/enums.md -#, fuzzy msgid "This might be a good time to compare structs and enums:" msgstr "" "Este es un buen momento para comparar las estructuras y las enumeraciones:" #: src/user-defined-types/enums.md -#, fuzzy msgid "" "In both, you can have a simple version without fields (unit struct) or one " "with different types of fields (variant payloads)." msgstr "" "En ambas puedes tener una versión sencilla sin campos (estructura unitaria) " -"o una versión con distintos tipos de campos (variantes con carga útil). " +"o una versión con distintos tipos de campos (variantes con carga útil)." #: src/user-defined-types/enums.md -#, fuzzy msgid "" "You could even implement the different variants of an enum with separate " "structs but then they wouldn’t be the same type as they would if they were " @@ -4974,7 +4726,7 @@ msgid "" msgstr "" "Incluso podrías implementar las distintas variantes de una enumeración con " "estructuras diferentes, pero entonces no serían del mismo tipo como lo " -"serían si estuvieran todas definidas en una enumeración. " +"serían si estuvieran todas definidas en una enumeración." #: src/user-defined-types/enums.md msgid "Rust uses minimal space to store the discriminant." @@ -4983,7 +4735,7 @@ msgstr "Rust usa muy poco espacio para almacenar el discriminante." #: src/user-defined-types/enums.md msgid "If necessary, it stores an integer of the smallest required size" msgstr "" -"Si es necesario, almacena un número entero del tamaño más pequeño requerido." +"Si es necesario, almacena un número entero del tamaño más pequeño requerido" #: src/user-defined-types/enums.md msgid "" @@ -5012,9 +4764,10 @@ msgstr "" "Sin `repr`, el tipo discriminante ocupa 2 bytes, debido a que 10001 se cabe " "en 2 bytes." -#: 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 "Más información" @@ -5045,54 +4798,13 @@ msgstr "" "Fragmento de código de ejemplo si quieres mostrar cómo puede ser la " "representación bit a bit en la práctica. Es importante tener en cuenta que " "el compilador no ofrece garantías con respecto a esta representación, por lo " -"tanto es totalmente inseguro. " +"tanto es totalmente inseguro." -#: src/user-defined-types/static-and-const.md -#, fuzzy -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 "" -"Las variables estáticas y constantes son dos formas diferentes de crear " -"valores de ámbito global que no se pueden mover ni reasignar durante la " -"ejecución del programa. " - -#: src/user-defined-types/static-and-const.md -msgid "`const`" -msgstr "`const`" - -#: src/user-defined-types/static-and-const.md -msgid "" -"Constant variables are evaluated at compile time and their values are " -"inlined wherever they are used:" -msgstr "" -"Las variables constantes se evalúan en tiempo de compilación y sus valores " -"se insertan dondequiera que se utilicen:" - -#: src/user-defined-types/static-and-const.md -#, fuzzy -msgid "" -"According to the [Rust RFC Book](https://rust-lang.github.io/rfcs/0246-const-" -"vs-static.html) these are inlined upon use." -msgstr "" -"Según el libro [Rust RFC Book](https://rust-lang.github.io/rfcs/0246-const-" -"vs-static.html), se insertan cuando se utilizan." - -#: src/user-defined-types/static-and-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." -msgstr "" -"Sólo se pueden llamar a las funciones marcadas como `const` en tiempo de " -"compilación para generar valores `const`. Sin embargo, las funciones `const` " -"se pueden llamar en _runtime_." - -#: src/user-defined-types/static-and-const.md +#: 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:" @@ -5100,17 +4812,15 @@ msgstr "" "Las variables estáticas vivirán durante toda la ejecución del programa y, " "por lo tanto, no se moverán:" -#: src/user-defined-types/static-and-const.md -#, fuzzy +#: src/user-defined-types/static.md msgid "\"Welcome to RustOS 3.14\"" -msgstr "Te damos la bienvenida al Día 1" +msgstr "\"Bienvenide a 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 -#, fuzzy +#: 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 " @@ -5120,27 +4830,17 @@ msgid "" "`const` is generally preferred." msgstr "" "Tal y como se indica en el libro [Rust RFC Book](https://rust-lang.github.io/" -"rfcs/0246-const-vs-static.html), no están insertadas y tienen una ubicación " -"de memoria real asociada. Esto resulta útil para código insertado y no " -"seguro. Además, la variable continúa durante toda la ejecución del programa. " -"Cuando un valor de ámbito global no tiene ningún motivo para necesitar " -"identidad de objeto, se suele preferir `const`." - -#: src/user-defined-types/static-and-const.md -msgid "Mention that `const` behaves semantically similar to C++'s `constexpr`." -msgstr "" -"Menciona que `const` se comporta semánticamente de forma similar a " -"`constexpr` de C++." +"rfcs/0246-const-vs-static.html), estas no son insertadas y tienen una " +"ubicación de memoria real asociada. Esto resulta útil para código insertado " +"y no seguro. Además, la variable continúa durante toda la ejecución del " +"programa. Cuando un valor de ámbito global no tiene ningún motivo para " +"necesitar identidad de objeto, se suele preferir `const`." -#: 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++." -msgstr "" -"Por su parte, `static` se parece mucho más a `const` o a una variable global " -"mutable de C++." +#: src/user-defined-types/static.md +msgid "`static` is similar to mutable global variables in C++." +msgstr "Por su parte, `static` se parece a una variable global mutable en C++." -#: 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`." @@ -5149,91 +4849,63 @@ msgstr "" "en el estado que requieren los tipos con mutabilidad interior, como " "`Mutex`." -#: src/user-defined-types/static-and-const.md +#: src/user-defined-types/static.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." +"Because `static` variables are accessible from any thread, they must be " +"`Sync`. Interior mutability is possible through a [`Mutex`](https://doc.rust-" +"lang.org/std/sync/struct.Mutex.html), atomic or similar." msgstr "" -"No es muy habitual que se necesite una constante evaluada en _runtime_, pero " -"es útil y más seguro que usar una estática." - -#: src/user-defined-types/static-and-const.md -msgid "Properties table:" -msgstr "Tabla de Propiedades:" - -#: src/user-defined-types/static-and-const.md -#: src/chromium/adding-third-party-crates.md -msgid "Property" -msgstr "Propiedad" - -#: src/user-defined-types/static-and-const.md -msgid "Static" -msgstr "Estático" - -#: src/user-defined-types/static-and-const.md -msgid "Constant" -msgstr "Constante" - -#: src/user-defined-types/static-and-const.md -msgid "Has an address in memory" -msgstr "Tiene una dirección en la memoria" - -#: src/user-defined-types/static-and-const.md -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Yes" -msgstr "Sí" - -#: src/user-defined-types/static-and-const.md -msgid "No (inlined)" -msgstr "No (insertado)" +"Dado que se puede acceder a las variables `static` desde cualquier hilo, " +"deben ser `Sync`. Mutabilidad interior es posible a través de un [`Mutex`]" +"(https://doc.rust-lang.org/std/sync/struct.Mutex.html), atómico o parecido." -#: src/user-defined-types/static-and-const.md -msgid "Lives for the entire duration of the program" -msgstr "Vive durante toda la ejecución del programa" - -#: src/user-defined-types/static-and-const.md -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "No" -msgstr "No" - -#: src/user-defined-types/static-and-const.md -msgid "Can be mutable" -msgstr "Puede ser mutable" - -#: src/user-defined-types/static-and-const.md -msgid "Yes (unsafe)" -msgstr "Sí (inseguro)" +#: src/user-defined-types/static.md +msgid "Thread-local data can be created with the macro `std::thread_local`." +msgstr "" +"Datos locales al hilo se pueden crear con el macro `std::thread_local`." -#: src/user-defined-types/static-and-const.md -msgid "Evaluated at compile time" -msgstr "Evaluado en tiempo de compilación" +#: src/user-defined-types/const.md +msgid "`const`" +msgstr "`const`" -#: src/user-defined-types/static-and-const.md -msgid "Yes (initialised at compile time)" -msgstr "Sí (inicializado en tiempo de compilación)" +#: src/user-defined-types/const.md +msgid "" +"Constants are evaluated at compile time and their values are inlined " +"wherever they are used:" +msgstr "" +"Las variables constantes se evalúan en tiempo de compilación y sus valores " +"se insertan donde sean utilizados:" -#: src/user-defined-types/static-and-const.md -msgid "Inlined wherever it is used" -msgstr "Insertado dondequiera que se utilice" +#: 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." +msgstr "" +"Según el libro [Rust RFC Book](https://rust-lang.github.io/rfcs/0246-const-" +"vs-static.html), se insertan cuando se utilizan." -#: src/user-defined-types/static-and-const.md -#, fuzzy +#: src/user-defined-types/const.md msgid "" -"Because `static` variables are accessible from any thread, they must be " -"`Sync`. Interior mutability is possible through a [`Mutex`](https://doc.rust-" -"lang.org/std/sync/struct.Mutex.html), atomic or similar." +"Only functions marked `const` can be called at compile time to generate " +"`const` values. `const` functions can however be called at runtime." msgstr "" -"Dado que se puede acceder a las variables `static` desde cualquier hilo, es " -"necesario protegerlas, por ejemplo, mediante un comando [`Mutex`](https://" -"doc.rust-lang.org/std/sync/struct.Mutex.html), o que sean accesibles usando " -"código `unsafe`. Veremos la [mutación de datos estáticos](../unsafe/mutable-" -"static-variables.md) en el capítulo sobre Rust inseguro." +"Sólo se pueden llamar a las funciones marcadas como `const` en tiempo de " +"compilación para generar valores `const`. Sin embargo, las funciones `const` " +"se pueden llamar en _runtime_." -#: src/user-defined-types/static-and-const.md -#, fuzzy -msgid "Thread-local data can be created with the macro `std::thread_local`." +#: src/user-defined-types/const.md +msgid "Mention that `const` behaves semantically similar to C++'s `constexpr`" +msgstr "" +"Menciona que `const` se comporta semánticamente de forma similar a " +"`constexpr` de C++" + +#: 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 "" -"Datos del `thread_local` se pueden crear con la macro `std::thread_local`." +"No es muy habitual que se necesite una constante evaluada en _runtime_, pero " +"es útil y más seguro que usar una estática." #: src/user-defined-types/aliases.md msgid "" @@ -5375,18 +5047,17 @@ msgid "Welcome to Day 2" msgstr "Te damos la bienvenida al día 2" #: src/welcome-day-2.md -#, fuzzy msgid "" "Now that we have seen a fair amount of Rust, today will focus on Rust's type " "system:" msgstr "" -"Ahora que ya sabemos bastante sobre Rust, continuaremos con lo siguiente:" +"Ahora que ya sabemos bastante sobre Rust, continuaremos con un enfoque en el " +"sistema de tipos de Rust:" #: src/welcome-day-2.md -#, fuzzy msgid "Pattern matching: extracting data from structures." msgstr "" -"Emparejamiento de Patrones: desestructuración de enums, structs y arrays." +"Coincidencia de Patrones: desestructuración de enums, structs y arrays." #: src/welcome-day-2.md msgid "Methods: associating functions with types." @@ -5408,70 +5079,227 @@ msgstr "" "biblioteca estándar de Rust." #: src/welcome-day-2.md -msgid "[Welcome](./welcome-day-2.md) (3 minutes)" -msgstr "[Bienvenida](./welcome-day-2.md) (3 minutos)" +msgid "" +"Including 10 minute breaks, this session should take about 2 hours and 10 " +"minutes. It contains:" +msgstr "" +"Contando con los descansos de 10 minutos, la duración prevista de la sesión " +"es de unas 2 horas y 10 minutos. Contiene:" -#: src/welcome-day-2.md -msgid "[Pattern Matching](./pattern-matching.md) (50 minutes)" -msgstr "[Coincidencia de patrones](./pattern-matching.md) (50 minutos)" +#: src/pattern-matching.md src/std-types.md src/memory-management.md +#: src/error-handling.md +msgid "This segment should take about 1 hour. It contains:" +msgstr "Esta sección tiene una duración aproximada de 1 hora. Contiene:" -#: src/welcome-day-2.md -msgid "[Methods and Traits](./methods-and-traits.md) (55 minutes)" -msgstr "[Métodos y traits](./methods-and-traits.md) (55 minutos)" +#: src/pattern-matching/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 "" +"La palabra clave `match` te permite comparar un valor con uno o varios " +"_patrones_. Las comparaciones se hacen de arriba a abajo y el primer patrón " +"que coincida gana." -#: src/welcome-day-2.md -msgid "[Generics](./generics.md) (45 minutes)" -msgstr "[Genéricos](./generics.md) (45 minutos)" +#: src/pattern-matching/match.md +msgid "The patterns can be simple values, similarly to `switch` in C and C++:" +msgstr "" +"Los patrones pueden ser valores simples, del mismo modo que `switch` en C y " +"C++:" + +#: src/pattern-matching/match.md +msgid "'x'" +msgstr "'x'" + +#: src/pattern-matching/match.md +msgid "'q'" +msgstr "'q'" + +#: src/pattern-matching/match.md +msgid "\"Quitting\"" +msgstr "\"Salir\"" + +#: 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 "\"Desplazarse\"" + +#: 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 "\"Introducción de números\"" + +#: src/pattern-matching/match.md +msgid "\"Lowercase: {key}\"" +msgstr "\"Minúscula: {key}\"" -#: src/welcome-day-2.md src/welcome-day-4.md +#: src/pattern-matching/match.md +msgid "\"Something else\"" +msgstr "\"Otro\"" + +#: src/pattern-matching/match.md msgid "" -"Including 10 minute breaks, this session should take about 3 hours and 5 " -"minutes" +"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 "" -"Incluyendo descansos de 10 minutos, esta sesión debería durar unas 3 horas y " -"5 minutos" +"`_` es un patrón comodín que coincide con cualquier valor. Las expresiones " +"_deben_ ser exhuastivas, lo que significa que deben tener en cuenta todas " +"las posibilidades, por lo que `_` a menudo se usa como un caso final que " +"atrapa todo." + +#: 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 "" +"Match puede ser usado como una expresión. Al igual que con `if let`, cada " +"brazo de coincidencia debe ser del mismo tipo. El tipo es la última " +"expresión del bloque, si la hay. En el ejemplo anterior, el tipo es `()`." + +#: 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 "" +"Una variable del patrón (en este ejemplo, `key`) creará un enlace que se " +"puede usar dentro del brazo de coincidencia." + +#: src/pattern-matching/match.md +msgid "A match guard causes the arm to match only if the condition is true." +msgstr "" +"Un protección de coincidencia hace que la expresión coincida únicamente si " +"se cumple la condición." + +#: src/pattern-matching/match.md +msgid "" +"You might point out how some specific characters are being used when in a " +"pattern" +msgstr "Puedes señalar cómo se usan algunos caracteres concretos en un patrón" + +#: src/pattern-matching/match.md +msgid "`|` as an `or`" +msgstr "`|` como `or`" -#: src/pattern-matching.md -msgid "[Destructuring](./pattern-matching/destructuring.md) (10 minutes)" -msgstr "[Desestructuración](./pattern-matching/destructuring.md) (10 minutos)" +#: src/pattern-matching/match.md +msgid "`..` can expand as much as it needs to be" +msgstr "`..` puede ampliarse tanto como sea necesario" + +#: src/pattern-matching/match.md +msgid "`1..=5` represents an inclusive range" +msgstr "`1..=5` representa un rango inclusivo" + +#: src/pattern-matching/match.md +msgid "`_` is a wild card" +msgstr "`_` es un comodín" -#: src/pattern-matching.md -msgid "[Let Control Flow](./pattern-matching/let-control-flow.md) (10 minutes)" +#: 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 "" -"[Control de Flujo con `let`](./pattern-matching/let-control-flow.md) (10 " -"minutos)" +"Las guardas de coincidencia, como característica sintáctica independiente, " +"son importantes y necesarios cuando queremos expresar de forma concisa ideas " +"más complejas de lo que permitirían los patrones por sí solos." -#: src/pattern-matching.md +#: src/pattern-matching/match.md msgid "" -"[Exercise: Expression Evaluation](./pattern-matching/exercise.md) (30 " -"minutes)" +"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 "" -"[Ejercicio: evaluación de expresiones](./pattern-matching/exercise.md) (30 " -"minutos)" +"No son lo mismo que una expresión `if` independiente dentro del brazo de " +"coincidencias. Una expresión `if` dentro del bloque de ramas (después de " +"`=>`) se produce tras seleccionar el brazo de coincidencias. Si no se cumple " +"la condición `if` dentro de ese bloque, no se tienen en cuenta otros brazos " +"de la expresión `match` original." -#: src/pattern-matching/destructuring.md -msgid "Like tuples, structs and enums can also be destructured by matching:" +#: src/pattern-matching/match.md +msgid "" +"The condition defined in the guard applies to every expression in a pattern " +"with an `|`." msgstr "" -"Al igual que las tuplas, las estructuras y las enumeraciones también se " -"pueden desestructurar con la coincidencia:" +"La condición definida en el guarda se aplica a todas las expresiones de un " +"patrón con un `|`." -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-structs.md msgid "Structs" msgstr "Structs" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-structs.md +msgid "Like tuples, Struct can also be destructured by matching:" +msgstr "" +"Al igual que las tuplas, las estructuras se pueden desestructurar con la " +"coincidencia:" + +#: 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.md +#: 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}, se han ignorado otros campos\"" -#: 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 "" +"Cambia los valores literales de `foo` para que coincidan con los demás " +"patrones." + +#: src/pattern-matching/destructuring-structs.md +msgid "Add a new field to `Foo` and make changes to the pattern as needed." +msgstr "" +"Añade un campo nuevo a `Foo` y realiza los cambios necesarios en el patrón." + +#: 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 "" +"La diferencia entre una captura y una expresión constante puede ser difícil " +"de detectar. Prueba a cambiar el `2` del segundo brazo por una variable y " +"observa que no funciona. Cámbialo a `const` y verás que vuelve a funcionar." + +#: src/pattern-matching/destructuring-enums.md +msgid "Like tuples, enums can also be destructured by matching:" +msgstr "" +"Al igual que las tuplas, las enumeraciones también se pueden desestructurar " +"con la coincidencia:" + +#: 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 " @@ -5481,19 +5309,19 @@ msgstr "" "valores. Así es como se inspecciona la estructura de tus tipos. Empecemos " "con un tipo `enum` sencillo:" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "\"cannot divide {n} into two equal parts\"" msgstr "\"no se puede dividir {n} en dos partes iguales\"" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "\"{n} divided in two is {half}\"" msgstr "\"{n} dividido entre dos es {half}\"" -#: src/pattern-matching/destructuring.md +#: src/pattern-matching/destructuring-enums.md msgid "\"sorry, an error happened: {msg}\"" msgstr "\"se ha producido un error: {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 " @@ -5503,28 +5331,7 @@ msgstr "" "En el primer brazo, `half` está vinculado al valor que hay dentro de la " "variante `Ok`. En el segundo, `msg` está vinculado al mensaje de error." -#: src/pattern-matching/destructuring.md -msgid "Change the literal values in `foo` to match with the other patterns." -msgstr "" -"Cambia los valores literales de `foo` para que coincidan con los demás " -"patrones." - -#: src/pattern-matching/destructuring.md -msgid "Add a new field to `Foo` and make changes to the pattern as needed." -msgstr "" -"Añade un campo nuevo a `Foo` y realiza los cambios necesarios en el patrón." - -#: 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 "" -"La diferencia entre una captura y una expresión constante puede ser difícil " -"de detectar. Prueba a cambiar el `2` del segundo brazo por una variable y " -"observa que no funciona. Cámbialo a `const` y verás que vuelve a funcionar." - -#: 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`." @@ -5532,7 +5339,7 @@ msgstr "" "La expresión `if`/`else` devuelve una enumeración que más tarde se " "descomprime con `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 " @@ -5543,27 +5350,24 @@ msgstr "" "en los que tu código está ahora incompleto y explica cómo el compilador " "intenta dar sugerencias." -#: src/pattern-matching/destructuring.md -#, fuzzy +#: src/pattern-matching/destructuring-enums.md msgid "" "The values in the enum variants can only be accessed after being pattern " "matched." msgstr "" "Solo se puede acceder a los valores de las variantes de enumeración una vez " -"que coincidan con el patrón. El patrón vincula referencias a los campos del " -"\"brazo de coincidencias\" después de `=>`." +"que coincidan con el patrón." -#: src/pattern-matching/destructuring.md -#, fuzzy +#: 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." msgstr "" "Demuestra lo que pasa cuando la búsqueda no es exhaustiva. Ten en cuenta la " -"ventaja que ofrece el compilador de Rust al confirmar cuándo se gestionan " -"todos los casos. " +"ventaja que ofrece el compilador de Rust al confirmar que se gestionan todos " +"los casos." -#: 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 " @@ -5593,14 +5397,14 @@ msgstr "" msgid "`if let` expressions" msgstr "Expresiones `if let`" +#: src/pattern-matching/let-control-flow.md +msgid "`let else` expressions" +msgstr "Expresiones `let else`" + #: src/pattern-matching/let-control-flow.md msgid "`while let` expressions" msgstr "Expresiones `while let`" -#: src/pattern-matching/let-control-flow.md -msgid "`match` expressions" -msgstr "Expresiones `match`" - #: src/pattern-matching/let-control-flow.md msgid "" "The [`if let` expression](https://doc.rust-lang.org/reference/expressions/if-" @@ -5615,10 +5419,6 @@ msgstr "" msgid "\"slept for {:?}\"" msgstr "\"Horas de sueño: {:?}\"" -#: src/pattern-matching/let-control-flow.md -msgid "`let else` expressions" -msgstr "Expresiones `let else`" - #: src/pattern-matching/let-control-flow.md msgid "" "For the common case of matching a pattern and returning from the function, " @@ -5648,8 +5448,8 @@ msgid "\"result: {:?}\"" msgstr "\"resultado: {:?}\"" #: 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\"" @@ -5664,16 +5464,15 @@ msgstr "" "prueba repetidamente un valor con respecto a un patrón:" #: src/pattern-matching/let-control-flow.md -#, fuzzy msgid "" "Here [`String::pop`](https://doc.rust-lang.org/stable/std/string/struct." "String.html#method.pop) returns `Some(c)` until the string is empty, after " "which it will return `None`. The `while let` lets us keep iterating through " "all items." msgstr "" -"Aquí, el iterador devuelto por `v.into_iter()` devolverá `Option` en " -"cada llamada a `next()`. Devuelve `Some(x)` hasta que finaliza y, a " -"continuación, devuelve `None`. `while let` nos permite seguir iterando a " +"Aquí, [`String::pop`](https://doc.rust-lang.org/stable/std/string/struct." +"String.html#method.pop) devolverá `Some(c)` hasta que la cadena este vacía, " +"cuando empezara a devolver `None`. `while let` nos permite seguir iterando a " "través de todos los elementos." #: src/pattern-matching/let-control-flow.md @@ -5732,15 +5531,14 @@ msgstr "" "coincida con el patrón." #: src/pattern-matching/let-control-flow.md -#, fuzzy msgid "" "You could rewrite the `while let` loop as an infinite loop with an if " "statement that breaks when there is no value to unwrap for `name.pop()`. The " "`while let` provides syntactic sugar for the above scenario." msgstr "" "Puedes reescribir el bucle `while let` como un ciclo infinito con una " -"instrucción if que deje de funcionar si `iter.next()` no tienen ningún valor " -"que desenvolver. `while let` proporciona azúcar sintáctico en la situación " +"instrucción if que rompe el bucle si `name.pop()` no devuelve un valor para " +"desenvolver. `while let` proporciona azúcar sintáctico para la situación " "anterior." #: src/pattern-matching/exercise.md @@ -5821,33 +5619,6 @@ msgstr "\"división entre cero\"" msgid "\"expr: {:?}\"" msgstr "\"expr: {:?}\"" -#: src/methods-and-traits.md -msgid "[Methods](./methods-and-traits/methods.md) (10 minutes)" -msgstr "[Métodos](./methods-and-traits/methods.md) (10 minutos)" - -#: src/methods-and-traits.md -msgid "[Traits](./methods-and-traits/traits.md) (10 minutes)" -msgstr "[Traits](./methods-and-traits/traits.md) (10 minutos)" - -#: src/methods-and-traits.md -msgid "[Deriving](./methods-and-traits/deriving.md) (5 minutes)" -msgstr "[Derivación](./methods-and-traits/deriving.md) (5 minutos)" - -#: src/methods-and-traits.md -msgid "[Trait Objects](./methods-and-traits/trait-objects.md) (10 minutes)" -msgstr "[Objetos de Trait](./methods-and-traits/trait-objects.md) (10 minutos)" - -#: src/methods-and-traits.md -msgid "" -"[Exercise: Generic Logger](./methods-and-traits/exercise.md) (20 minutes)" -msgstr "" -"[Ejercicio: registrador genérico](./methods-and-traits/exercise.md) (20 " -"minutos)" - -#: src/methods-and-traits.md -msgid "This segment should take about 55 minutes" -msgstr "Esta sección tiene una duración aproximada de 55 minutos." - #: src/methods-and-traits/methods.md msgid "" "Rust allows you to associate functions with your new types. You do this with " @@ -5893,13 +5664,12 @@ msgid "// race.add_lap(42);\n" msgstr "// race.add_lap(42);\n" #: src/methods-and-traits/methods.md -#, fuzzy msgid "" "The `self` arguments specify the \"receiver\" - the object the method acts " "on. There are several common receivers for a method:" msgstr "" -"`&self` indica que el método toma prestado el objeto de forma inmutable. Hay " -"otros posibles receptores para un método:" +"El argumento `self` denomina el \"receiver\" (receptor) - el objeto sobre " +"cual el método actuará. Hay varios receivers comunes para un método:" #: src/methods-and-traits/methods.md msgid "" @@ -5931,10 +5701,9 @@ msgstr "" "no implica automáticamente una mutabilidad." #: src/methods-and-traits/methods.md -#, fuzzy msgid "`mut self`: same as above, but the method can mutate the object." msgstr "" -"`mut self`: igual que lo anterior, pero el método puede mutar el objeto. " +"`mut self`: igual que lo anterior, pero el método puede mutar el objeto." #: src/methods-and-traits/methods.md msgid "" @@ -5970,15 +5739,15 @@ msgstr "" #: src/methods-and-traits/methods.md msgid "Point out the use of the keyword `self`, a method receiver." -msgstr "Señala el uso de la palabra clave `self`, receptor de un método. " +msgstr "Señala el uso de la palabra clave `self`, el receptor de un método." #: src/methods-and-traits/methods.md msgid "" "Show that it is an abbreviated term for `self: Self` and perhaps show how " "the struct name could also be used." msgstr "" -"Indica que se trata de un término abreviado de `self:&Self` y muestra cómo " -"se podría utilizar también el nombre de la estructura. " +"Indica que se trata de un término abreviado de `self: Self` y tal vez " +"muestra cómo se podría utilizar también el nombre de la estructura." #: src/methods-and-traits/methods.md msgid "" @@ -5997,13 +5766,12 @@ msgstr "" "notación de puntos puede utilizarse para referirse a campos concretos." #: src/methods-and-traits/methods.md -#, fuzzy msgid "" "This might be a good time to demonstrate how the `&self` differs from `self` " "by trying to run `finish` twice." msgstr "" "Puede ser un buen momento para mostrar la diferencia entre `&self` y `self` " -"modificando el código e intentando ejecutar say_hello dos veces." +"modificando el código e intentando ejecutar `finish` dos veces." #: src/methods-and-traits/methods.md msgid "" @@ -6023,45 +5791,130 @@ msgstr "" "interfaces:" #: src/methods-and-traits/traits.md +msgid "/// Return a sentence from this pet.\n" +msgstr "/// Devuelve una frase de esta mascota.\n" + +#: src/methods-and-traits/traits.md +msgid "/// Print a string to the terminal greeting this pet.\n" +msgstr "/// Imprime un saludo a la mascota en una salida estándar.\n" + +#: src/methods-and-traits/traits.md +msgid "" +"A trait defines a number of methods that types must have in order to " +"implement the trait." +msgstr "" +"Un trait define una serie de métodos que los tipos deben tener para " +"implementar el trait." + +#: src/methods-and-traits/traits.md +msgid "" +"In the \"Generics\" segment, next, we will see how to build functionality " +"that is generic over all types implementing a trait." +msgstr "" +"En la sección de \"Genéricos\" a seguir, veremos como construir " +"funcionalidad que es genérico sobre todos los tipos implementando un trait." + +#: src/methods-and-traits/traits/implementing.md msgid "\"Oh you're a cutie! What's your name? {}\"" msgstr "\"¡Eres una monada! ¿Cómo te llamas? {}\"" -#: src/methods-and-traits/traits.md src/methods-and-traits/trait-objects.md +#: src/methods-and-traits/traits/implementing.md src/generics/dyn-trait.md +#: src/smart-pointers/trait-objects.md msgid "\"Woof, my name is {}!\"" msgstr "\"¡Guau, me llamo {}!\"" -#: src/methods-and-traits/traits.md src/methods-and-traits/trait-objects.md -msgid "\"Miau!\"" -msgstr "\"¡Miau!\"" - -#: src/methods-and-traits/traits.md src/methods-and-traits/trait-objects.md +#: 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.md +#: src/methods-and-traits/traits/implementing.md msgid "" -"A trait defines a number of methods that types must have in order to " -"implement the trait." +"To implement `Trait` for `Type`, you use an `impl Trait for Type { .. }` " +"block." msgstr "" -"Un trait define una serie de métodos que los tipos deben tener para " -"implementar el trait." +"Para implementar `Trait` para un tipo `Type`, utiliza un bloque `impl Trait " +"for Type { .. }`." -#: src/methods-and-traits/traits.md -msgid "Traits are implemented in an `impl for { .. }` block." +#: 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 "" -"Los traits se implementan en un bloque `impl for { .. }`." +"A diferencia de los interfases de Go, tener los métodos adecuados no es " +"suficiente: un tipo `Cat` con un método `talk()` no satisface `Pet` " +"automáticamente al menos que este en un bloque `impl Pet`." -#: src/methods-and-traits/traits.md -#, fuzzy +#: src/methods-and-traits/traits/implementing.md +msgid "" +"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 "" +"Los _traits_ pueden especificar implementaciones predeterminadas de algunos " +"métodos. Implementaciones predeterminadas pueden usar todos los métodos de " +"un trait (incluso los métodos que los usuarios deben implementar ellos " +"mismos). En este caso, `greet` es predeterminado y utiliza `talk`." + +#: 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 "" +"Un trait puede requerir que los tipos que lo implementan también implementen " +"otros traits, llamados _supertraits_. Aquí, cualquier tipo implementando " +"`Pet` también debe implementar `Animal`." + +#: src/methods-and-traits/traits/supertraits.md +#: src/concurrency/async-control-flow/select.md +msgid "\"Rex\"" +msgstr "\"Rex\"" + +#: src/methods-and-traits/traits/supertraits.md +msgid "\"{} has {} legs\"" +msgstr "\"{} tiene {} piernas\"" + +#: 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 "" +"Algunas veces esto es llamado \"herencia de traits\", pero los estudiantes " +"no deben esperar que esto se comporte como la herencia OO (object-oriented). " +"Solo especifica un requerimiento adicional sobre las implementaciones de un " +"trait." + +#: src/methods-and-traits/traits/associated-types.md +msgid "" +"Associated types are placeholder types which are supplied by the trait " +"implementation." +msgstr "" +"Tipos asociados son tipos guarda-espacio que han sido proveídos por la " +"implementación del trait." + +#: 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 "" -"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`." +"Associated types are sometimes also called \"output types\". The key " +"observation is that the implementer, not the caller, chooses this type." msgstr "" -"Los _traits_ pueden especificar los métodos implementados previamente " -"(predeterminados) y los métodos que los usuarios deben implementar ellos " -"mismos. Los métodos con implementaciones predeterminadas pueden basarse en " -"métodos obligatorios." +"Tipos asociados también son llamados \"tipos de salida\". La observación " +"clave es que el implementador, no el ejecutor, escoge este tipo." + +#: src/methods-and-traits/traits/associated-types.md +msgid "" +"Many standard library traits have associated types, including arithmetic " +"operators and `Iterator`." +msgstr "" +"Muchos traits de la biblioteca estándar tienen tipos asociados, incluyendo " +"operadores aritméticos y `Iterator`." #: src/methods-and-traits/deriving.md msgid "" @@ -6103,190 +5956,9 @@ msgstr "" "la compatibilidad con la serialización para una struct con " "`#[derive(Serialize)]`." -#: src/methods-and-traits/trait-objects.md -msgid "" -"Trait objects allow for values of different types, for instance in a " -"collection:" -msgstr "" -"Los objetos de _traits_ permiten valores de diferentes tipos, por ejemplo, " -"en una colección:" - -#: src/methods-and-traits/trait-objects.md -msgid "\"Hello, who are you? {}\"" -msgstr "" - -#: src/methods-and-traits/trait-objects.md -msgid "Memory layout after allocating `pets`:" -msgstr "Diseño de la memoria después de asignar `pets`:" - -#: src/methods-and-traits/trait-objects.md -#, fuzzy -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" -" Stack Heap\n" -".- - - - - - - - - - - - - -. .- - - - - - - - - - - - - - - - - - - - - " -"- -.\n" -": : : :\n" -": " -"pets : : :\n" -": +-----------+-------+ : : +-----+-----" -"+ :\n" -": | ptr | o---+---+-----+-->| o o | o o " -"| :\n" -": | len | 2 | : : +-|-|-+-|-|-" -"+ :\n" -": | capacity | 2 | : : | | | | +---------------" -"+ :\n" -": +-----------+-------+ : : | | | '-->| name: \"Fido\" " -"| :\n" -": : : | | | +---------------" -"+ :\n" -"`- - - - - - - - - - - - - -' : | | " -"| :\n" -" : | | | +----------------------" -"+ : \n" -" : | | '---->| \"::name\" " -"| :\n" -" : | | +----------------------" -"+ : \n" -" : | " -"| : \n" -" : | | +-" -"+ : \n" -" : | '-->|" -"\\| : \n" -" : | +-" -"+ : \n" -" : " -"| : \n" -" : | +----------------------" -"+ : \n" -" : '---->| \"::name\" " -"| : \n" -" : +----------------------" -"+ :\n" -" : :\n" -" '- - - - - - - - - - - - - - - - - - - - - " -"- -'\n" -"\n" -"```" - -#: src/methods-and-traits/trait-objects.md -#, fuzzy -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 "" -"Los tipos que implementan un trait determinado pueden tener diferentes " -"tamaños. Esto hace imposible tener elementos como `Vec` en el ejemplo " -"anterior." - -#: 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` es una forma de indicar al compilador un tipo de tamaño dinámico " -"que implementa `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 "" - -#: src/methods-and-traits/trait-objects.md -#, fuzzy -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 "" -"En el ejemplo, `pets` contiene _punteros grandes_ en los objetos que " -"implementan `Pet`. El puntero grande consta de dos componentes: un puntero " -"al objeto real y un puntero a la tabla de métodos virtuales para la " -"implementación de `Pet` en ese objeto concreto." - -#: 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 "" - -#: src/methods-and-traits/trait-objects.md -msgid "Compare these outputs in the above example:" -msgstr "Compara estas salidas en el ejemplo anterior:" - -#: 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 "Exercise: Logger Trait" +msgstr "Ejercicio: trait de registro" #: src/methods-and-traits/exercise.md msgid "" @@ -6349,39 +6021,38 @@ msgstr "" "/// Registra solo los mensajes que cumplan el nivel de verbosidad " "determinado.\n" -#: src/generics.md -msgid "[Generic Functions](./generics/generic-functions.md) (5 minutes)" -msgstr "[Funciones genéricas](./generics/generic-functions.md) (5 minutos)" +#: src/welcome-day-2-afternoon.md +msgid "" +"Including 10 minute breaks, this session should take about 3 hours and 15 " +"minutes. It contains:" +msgstr "" +"Incluyendo descansos de 10 minutos, esta sesión debería durar unas 3 horas y " +"15 minutos. Contiene:" -#: src/generics.md -msgid "[Generic Data Types](./generics/generic-data.md) (15 minutes)" -msgstr "[Tipos de datos genéricos](./generics/generic-data.md) (15 minutos)" +#: src/generics.md src/iterators.md src/testing.md +msgid "This segment should take about 45 minutes. It contains:" +msgstr "Esta sección tiene una duración aproximada de 45 minutos. Contiene:" #: src/generics.md -msgid "[Trait Bounds](./generics/trait-bounds.md) (10 minutes)" -msgstr "[Límites de traits](./generics/trait-bounds.md) (10 minutos)" +msgid "impl Trait" +msgstr "impl Trait" #: src/generics.md -msgid "[impl Trait](./generics/impl-trait.md) (5 minutes)" -msgstr "[impl Trait](./generics/impl-trait.md) (5 minutos)" +msgid "dyn Trait" +msgstr "Traits dyn" #: src/generics.md -msgid "[Exercise: Generic min](./generics/exercise.md) (10 minutes)" -msgstr "[Ejercicio: min genérico](./generics/exercise.md) (10 minutos)" - -#: src/generics.md src/smart-pointers.md src/iterators.md src/error-handling.md -msgid "This segment should take about 45 minutes" -msgstr "Esta sección tiene una duración aproximada de 45 minutos." +msgid "Exercise: Generic min" +msgstr "Ejercicio: `min` genérico" #: src/generics/generic-functions.md -#, fuzzy msgid "" "Rust supports generics, which lets you abstract algorithms or data " "structures (such as sorting or a binary tree) over the types used or stored." msgstr "" "Rust admite el uso de genéricos, lo que permite abstraer los algoritmos o " -"las estructuras de datos (como el orden o un árbol binario) sobre los tipos " -"utilizados o almacenados." +"las estructuras de datos (como el ordenamiento o un árbol binario) sobre los " +"tipos utilizados o almacenados." #: src/generics/generic-functions.md msgid "/// Pick `even` or `odd` depending on the value of `n`.\n" @@ -6427,24 +6098,20 @@ msgstr "" "que no es válida. En cambio, C++ lo permitiría." #: src/generics/generic-functions.md -#, fuzzy msgid "" "Generic code is turned into non-generic code based on the call sites. This " "is a zero-cost abstraction: you get exactly the same result as if you had " "hand-coded the data structures without the abstraction." msgstr "" -"Se trata de una abstracción sin coste: se obtiene exactamente el mismo " -"resultado que si se hubiesen programado de forma manual las estructuras de " -"datos sin la abstracción." +"Código genérico es convertido en código no genérico basada en los sitios de " +"ejecución .Se trata de una abstracción sin coste: se obtiene exactamente el " +"mismo resultado que si se hubiesen programado de forma manual las " +"estructuras de datos sin la abstracción." #: src/generics/generic-data.md msgid "You can use generics to abstract over the concrete field type:" msgstr "Puedes usar genéricos para abstraer el tipo de campo concreto:" -#: 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:?} y {float:?}\"" @@ -6474,9 +6141,8 @@ msgid "It means these methods are defined for any `T`." msgstr "Significa que estos métodos están definidos para cualquier `T`." #: src/generics/generic-data.md -#, fuzzy msgid "It is possible to write `impl Point { .. }`." -msgstr "Es posible escribir `impl Point { .. }`. " +msgstr "Es posible escribir `impl Point { .. }`." #: src/generics/generic-data.md msgid "" @@ -6496,6 +6162,70 @@ msgstr "" "Actualiza el código para permitir que haya puntos que tengan elementos de " "diferentes tipos con dos variables de tipo, por ejemplo, `T` y `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 "" +"Los traits también pueden ser genéricos, como los tipos y las funciones. Los " +"parámetros de un trait obtienen tipos concretos cuando es usado." + +#: src/generics/generic-traits.md +msgid "\"Converted from integer: {from}\"" +msgstr "\"Convertido del numero entero: {from}\"" + +#: src/generics/generic-traits.md +msgid "\"Converted from bool: {from}\"" +msgstr "\"Convertido del bool: {from}\"" + +#: src/generics/generic-traits.md +msgid "\"{from_int:?}, {from_bool:?}\"" +msgstr "\"{from_int:?}, {from_bool:?}\"" + +#: 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 "" +"El trait `From` sera discutido mas tarde, pero su definición en [la " +"documentación `std`](https://doc.rust-lang.org/std/convert/trait.From.html) " +"es simple." + +#: 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 "" +"Las implementaciones del trait no necesitan cubrir todos los parámetros de " +"tipo posibles. Aquí, `Foo::from(\"hello\")` no compilaría porque no hay una " +"implementación `From<&str>` para `Foo`." + +#: 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 "" +"Tipos genéricos toman tipos como entradas, mientras tipos asociados son " +"tipos de salida. Un trait puede tener varias implementaciones para " +"diferentes tipos de entrada." + +#: 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 "" +"De hecho, Rust requiere que a lo más solo una implementación de un trait " +"coincida con cualquier tipo T. A diferencia de otros lenguajes, Rust no " +"tiene una heurística para escoger la coincidencia \"más especifica\". Hay " +"trabajo corriente para implementar esta heurística, llamado [especialización]" +"(https://rust-lang.github.io/rfcs/1210-impl-specialization.html)." + #: src/generics/trait-bounds.md msgid "" "When working with generics, you often want to require the types to implement " @@ -6585,11 +6315,12 @@ msgid "\"debuggable: {debuggable:?}\"" msgstr "\"depurable: {debuggable:?}\"" #: src/generics/impl-trait.md -#, fuzzy msgid "" "`impl Trait` allows you to work with types which you cannot name. The " "meaning of `impl Trait` is a bit different in the different positions." -msgstr "La naturaleza de `impl Trait` varía ligeramente según la posición." +msgstr "" +"`impl Trait` te deja trabajar con tipos que no puedes nombrar. El " +"significado de `impl Trait` es un poco diferente dependiendo de su posición." #: src/generics/impl-trait.md msgid "" @@ -6633,73 +6364,166 @@ msgstr "" "¿Cuál es el tipo de `debuggable`? Prueba con `let debuggable: () = ..` para " "ver lo que muestra el mensaje de error." +#: src/generics/dyn-trait.md +msgid "" +"In addition to using traits for static dispatch via generics, Rust also " +"supports using them for type-erased, dynamic dispatch via trait objects:" +msgstr "" +"En adición a ser usados para despacho estático con genéricos, los traits " +"también se pueden usar para despacho dinámico/tipo-borrado con objetos de " +"trait:" + +#: src/generics/dyn-trait.md src/smart-pointers/trait-objects.md +msgid "\"Miau!\"" +msgstr "\"¡Miau!\"" + +#: src/generics/dyn-trait.md +msgid "// Uses generics and static dispatch.\n" +msgstr "// Utiliza genéricos y despacho estático.\n" + +#: src/generics/dyn-trait.md src/smart-pointers/trait-objects.md +msgid "\"Hello, who are you? {}\"" +msgstr "\"Hola, quien eres? {}\"" + +#: src/generics/dyn-trait.md +msgid "// Uses type-erasure and dynamic dispatch.\n" +msgstr "// Utiliza borradura de tipos y despacho dinámico.\n" + +#: 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 "" +"Genéricos, incluyendo `impl Trait`, utilizan monomorphización para crear una " +"instancia especializada de la funcionan para cada tipo con el cual el " +"genérico es instanciando. Esto significa que llamar un método de trait " +"dentro de una función generica todavía usa despacho estático, ya que el " +"compilador tiene todo la información necesaria para determinar el tipo cuya " +"implementación debería de usar." + +#: 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 "" +"`dyn Trait` utiliza despacho dinámico con una [tabla virtual de metodos]" +"(https://en.wikipedia.org/wiki/Virtual_method_table) (vtable). Esto " +"significa que solo hay una sola version de `fn dynamic` que es utilizado " +"independientemente del tipo de `Pet` que es proveído." + +#: 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 "" +"Cuando uno usa `dyn Trait`, el objeto trait necesita estar detrás algún tipo " +"de indirección. En este caso es una referencia, pero tipos de puntador " +"inteligentes como `Box` también pueden ser usados (demostraremos este " +"durante el día 3)." + +#: 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 "" +"Durante el tiempo de ejecución, un `&dyn Pet` es representado como un " +"\"puntador gordo\", es decir un par de dos puntadores: Un puntador apunta al " +"objeto concreto que implementa `Pet`, y el otra apunta al vtable para la " +"implementación del trait para ese tipo. Cuando uno llama el método `talk` " +"sobre `&dyn Pet`, el compilador busca el puntador de función para `talk` en " +"el vtable y ejecuta la función, pasando el puntador al `Dog` o `Cat` a esa " +"función. El compilador no necesita saber el tipo concreto del `Pet` para " +"hacer esto." + +#: 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 "" +"Un `dyn Trait` es considerado ser \"tipo-borrado\", ya que no tenemos " +"información sobre el tipo concreto del objeto al tiempo de compilación." + #: src/generics/exercise.md msgid "" "In this short exercise, you will implement a generic `min` function that " -"determines the minimum of two values, using a `LessThan` trait." +"determines the minimum of two values, using the [`Ord`](https://doc.rust-" +"lang.org/stable/std/cmp/trait.Ord.html) trait." msgstr "" "En este breve ejercicio, implementarás una función `min` genérica que " -"determina el mínimo de dos valores mediante un trait `lessThan`." - -#: src/generics/exercise.md src/generics/solution.md -msgid "/// Return true if self is less than other.\n" -msgstr "/// Devuelve true si el valor de self es menor que el de other.\n" +"determina el mínimo de dos valores mediante el trait [`Ord`](https://doc." +"rust-lang.org/stable/std/cmp/trait.Ord.html)." #: src/generics/exercise.md msgid "// TODO: implement the `min` function used in `main`.\n" msgstr "// TAREA: implementar la función `min` usada en `main`.\n" #: src/generics/exercise.md src/generics/solution.md -msgid "\"Shapiro\"" -msgstr "\"Shapiro\"" +#: src/error-handling/exercise.md src/error-handling/solution.md +msgid "'z'" +msgstr "'z'" #: src/generics/exercise.md src/generics/solution.md -msgid "\"Baumann\"" -msgstr "\"Baumann\"" +msgid "'7'" +msgstr "'7'" -#: src/welcome-day-2-afternoon.md -msgid "[Standard Library Types](./std-types.md) (1 hour and 10 minutes)" -msgstr "[Tipos de bibliotecas estándar](./std-types.md) (1 hora y 10 minutos)" +#: src/generics/exercise.md src/generics/solution.md +msgid "'1'" +msgstr "'1'" -#: src/welcome-day-2-afternoon.md -msgid "[Standard Library Traits](./std-traits.md) (1 hour and 40 minutes)" -msgstr "[Traits de biblioteca estándar](./std-traits.md) (1 hora y 40 minutos)" +#: src/generics/exercise.md src/generics/solution.md +msgid "\"goodbye\"" +msgstr "\"adios\"" -#: src/std-types.md -msgid "[Standard Library](./std-types/std.md) (3 minutes)" -msgstr "[Biblioteca estándar](./std-types/std.md) (3 minutos)" +#: src/generics/exercise.md src/generics/solution.md +msgid "\"bat\"" +msgstr "\"murciélago\"" -#: src/std-types.md -msgid "[Documentation](./std-types/docs.md) (5 minutes)" -msgstr "[Documentación](./std-types/docs.md) (5 minutos)" +#: src/generics/exercise.md src/generics/solution.md +msgid "\"armadillo\"" +msgstr "\"armadillo\"" -#: src/std-types.md -msgid "[Option](./std-types/option.md) (10 minutes)" -msgstr "[Option (Opción)](./std-types/option.md) (10 minutos)" +#: src/generics/exercise.md +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 "" +"Enseña a los estudiantes el trait [`Ord`](https://doc.rust-lang.org/stable/" +"std/cmp/trait.Ord.html) y el enum [`Ordering`](https://doc.rust-lang.org/" +"stable/std/cmp/enum.Ordering.html)." -#: src/std-types.md -msgid "[Result](./std-types/result.md) (10 minutes)" -msgstr "[Result (Resultado)](./std-types/result.md) (10 minutos)" +#: src/std-types.md src/std-types/option.md +msgid "Option" +msgstr "Opción" -#: src/std-types.md -msgid "[String](./std-types/string.md) (10 minutes)" -msgstr "[String (Cadena de texto)](./std-types/string.md) (10 minutos)" +#: src/std-types.md src/std-types/result.md src/error-handling.md +msgid "Result" +msgstr "Resultado" -#: src/std-types.md -msgid "[Vec](./std-types/vec.md) (10 minutes)" -msgstr "[Vec (Vectores)](./std-types/vec.md) (10 minutos)" +#: src/std-types.md src/std-types/string.md +msgid "String" +msgstr "String" #: src/std-types.md -msgid "[HashMap](./std-types/hashmap.md) (10 minutes)" -msgstr "[HashMap](./std-types/hashmap.md) (10 minutos)" +msgid "Vec" +msgstr "Vec" #: src/std-types.md -msgid "[Exercise: Counter](./std-types/exercise.md) (10 minutes)" -msgstr "[Ejercicio: contador](./std-types/exercise.md) (10 minutos)" - -#: 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 "Esta sección tiene una duración aproximada de 1 hora y 10 minutos." +msgid "HashMap" +msgstr "HashMap" #: src/std-types.md msgid "" @@ -6711,7 +6535,6 @@ msgstr "" "más se usan." #: src/std-types/std.md -#, fuzzy msgid "" "Rust comes with a standard library which helps establish a set of common " "types used by Rust libraries and programs. This way, two libraries can work " @@ -6723,23 +6546,21 @@ msgstr "" "ambas utilizan el mismo tipo `String`." #: src/std-types/std.md -#, fuzzy msgid "" "In fact, Rust contains several layers of the Standard Library: `core`, " "`alloc` and `std`." msgstr "" "De hecho, Rust contiene varias capas de la biblioteca estándar: `core`, " -"`alloc` y `std`. " +"`alloc` y `std`." #: src/std-types/std.md -#, fuzzy msgid "" "`core` includes the most basic types and functions that don't depend on " "`libc`, allocator or even the presence of an operating system." msgstr "" "`core` incluye los tipos y funciones más básicos que no dependen de `libc`, " "de un _allocator_ (asignador de memoria) ni de la presencia de un sistema " -"operativo. " +"operativo." #: src/std-types/std.md msgid "" @@ -6761,13 +6582,12 @@ msgid "Rust comes with extensive documentation. For example:" msgstr "Rust incluye una amplia documentación. Por ejemplo:" #: src/std-types/docs.md -#, fuzzy msgid "" "All of the details about [loops](https://doc.rust-lang.org/stable/reference/" "expressions/loop-expr.html)." msgstr "" -"Si quieres salir de un bucle antes, usa [`break`](https://doc.rust-lang.org/" -"reference/expressions/loop-expr.html#break-expressions)." +"Todos los detalles sobre [bucles](https://doc.rust-lang.org/stable/reference/" +"expressions/loop-expr.html)." #: src/std-types/docs.md msgid "" @@ -6778,14 +6598,14 @@ msgstr "" "u8.html)." #: src/std-types/docs.md -#, fuzzy msgid "" "Standard library types like [`Option`](https://doc.rust-lang.org/stable/std/" "option/enum.Option.html) or [`BinaryHeap`](https://doc.rust-lang.org/stable/" "std/collections/struct.BinaryHeap.html)." msgstr "" -"[`str`](https://doc.rust-lang.org/std/primitive.str.html) y [`String`]" -"(https://doc.rust-lang.org/std/string/struct.String.html)" +"Tipos de la biblioteca estándar como [`Option`](https://doc.rust-lang.org/" +"stable/std/option/enum.Option.html) o [`BinaryHeap`](https://doc.rust-lang." +"org/stable/std/collections/struct.BinaryHeap.html)." #: src/std-types/docs.md msgid "In fact, you can document your own code:" @@ -6834,18 +6654,12 @@ msgstr "" "números enteros.\n" #: src/std-types/docs.md -#, fuzzy msgid "" "Show students the generated docs for the `rand` crate at ." msgstr "" "Muestra a los alumnos los documentos generados para el crate `rand` en " -"[`docs.rs/rand`](https://docs.rs/rand)." - -#: src/std-types/option.md -#, fuzzy -msgid "Option" -msgstr "Excepciones" +"." #: src/std-types/option.md msgid "" @@ -6878,9 +6692,9 @@ msgid "\"Character not found\"" msgstr "\"No se ha encontrado el carácter\"" #: src/std-types/option.md -#, fuzzy msgid "`Option` is widely used, not just in the standard library." -msgstr "`Option` y `Result` se usan mucho, no solo en la biblioteca estándar." +msgstr "" +"`Option` se usa en muchos contextos, no solo en la biblioteca estándar." #: src/std-types/option.md msgid "" @@ -6914,36 +6728,30 @@ msgstr "" "La \"optimización de nicho\" significa que `Option` a menudo tiene el " "mismo tamaño en memoria que `T`." -#: src/std-types/result.md -msgid "Result" -msgstr "Resultado" - #: src/std-types/result.md 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` es similar a `Option`, pero indica si una operación se ha " +"`Result` es parecido a `Option`, pero indica si una operación se ha " "completado de forma correcta o ha fallado, cada una con un tipo diferente. " -"Es similar a `Res`, que se definió en el ejercicio de expresiones, pero " -"genérico: `Result`, donde `T` se usa en la variante `Ok` y `E` aparece " -"en la variante `Err`." +"Es genérico: `Result` donde `T` es usado en el variante `Ok` y `E` en " +"el variante `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 "\"Querido diario: {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 "\"No se ha podido leer el contenido del archivo\"" -#: src/std-types/result.md +#: src/std-types/result.md src/error-handling/result.md msgid "\"The diary could not be opened: {err}\"" msgstr "\"No se ha podido abrir el diario: {err}\"" @@ -6961,39 +6769,34 @@ msgstr "" "señal de la intención del desarrollador." #: src/std-types/result.md -#, fuzzy msgid "" "`Result` documentation is a recommended read. Not during the course, but it " "is worth mentioning. It contains a lot of convenience methods and functions " "that help functional-style programming." msgstr "" "La documentación sobre `Result` es una lectura recomendada. Aunque no se vea " -"durante este curso, merece la pena mencinarlo. Contiene muchos métodos y " -"funciones prácticos que ayudan a seguir una programación funcional. " +"durante este curso, merece la pena mencionarlo. Contiene muchos métodos y " +"funciones prácticos que ayudan a seguir un estilo de programación funcional." #: src/std-types/result.md msgid "" "`Result` is the standard type to implement error handling as we will see on " -"Day 3." +"Day 4." msgstr "" "`Result` es el tipo estándar para implementar la gestión de errores, tal y " -"como veremos el día 3." - -#: src/std-types/string.md -msgid "String" -msgstr "String" +"como veremos el día 4." #: src/std-types/string.md 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) es el " -"búfer de cadena UTF-8 estándar, ampliable y asignado a un _heap_:" +"búfer de cadena ampliable UTF-8 estándar:" #: 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 "\"Hola\"" @@ -7059,8 +6862,8 @@ msgid "" "When people refer to strings they could either be talking about `&str` or " "`String`." msgstr "" -"Cuando la gente se refiere a cadenas, pueden estar hablando de `&str` o de " -"`String`. " +"Cuando la gente se refiere a una cadena, pueden estar hablando de `&str` o " +"de `String`." #: src/std-types/string.md msgid "" @@ -7087,9 +6890,8 @@ msgstr "" "transparente a los métodos de `str`." #: src/std-types/string.md -#, fuzzy msgid "Write and compare `let s3 = s1.deref();` and `let s3 = &*s1;`." -msgstr "Escribe y compara `let s3 = s1.deref();` y `let s3 = &*s1`;." +msgstr "Escribe y compara `let s3 = s1.deref();` y `let s3 = &*s1;`." #: src/std-types/string.md msgid "" @@ -7111,7 +6913,7 @@ msgid "" "out-of-bounds." msgstr "" "A un carácter mediante `s3. chars().nth(i).unwrap()`, donde `i` está dentro " -"o fuera de los límites" +"o fuera de los límites." #: src/std-types/string.md msgid "" @@ -7121,10 +6923,24 @@ msgstr "" "A una cadena secundaria mediante `s3[0..4]`, donde el slice está en los " "límites de caracteres o no." -#: src/std-types/vec.md +#: src/std-types/string.md msgid "" -"[`Vec`](https://doc.rust-lang.org/std/vec/struct.Vec.html) is the standard " -"resizable heap-allocated buffer:" +"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 "" +"Muchos tipos pueden ser convertidos a una cadena con el método [`to_string`]" +"(https://doc.rust-lang.org/std/string/trait.ToString.html#tymethod." +"to_string). Este trait es automáticamente implementado para cualquier tipo " +"que implemente `Display`, entonces cualquier objeto que pueda ser formateado " +"también puede ser convertido a una cadena." + +#: src/std-types/vec.md +msgid "" +"[`Vec`](https://doc.rust-lang.org/std/vec/struct.Vec.html) is the standard " +"resizable heap-allocated buffer:" msgstr "" "[`Vec`](https://doc.rust-lang.org/std/vec/struct.Vec.html) es el búfer " "estándar redimensionable asignado al _heap_:" @@ -7164,7 +6980,6 @@ msgstr "" "métodos slice en un `Vec`." #: src/std-types/vec.md -#, fuzzy msgid "" "`Vec` is a type of collection, along with `String` and `HashMap`. The data " "it contains is stored on the heap. This means the amount of data doesn't " @@ -7172,7 +6987,7 @@ msgid "" msgstr "" "`Vec` es un tipo de colección, junto con `String` y `HashMap`. Los datos que " "contiene se almacenan en el _heap_. Esto significa que no es necesario " -"conocer la cantidad de datos durante la compilación. Puede aumentar o " +"conocer el tamaño de los datos durante la compilación. Puede aumentar o " "disminuir durante la ejecución." #: src/std-types/vec.md @@ -7409,43 +7224,23 @@ msgstr "\"naranja\"" msgid "\"got {} apples\"" msgstr "\"se han visto {} manzanas\"" -#: src/std-traits.md -msgid "[Comparisons](./std-traits/comparisons.md) (10 minutes)" -msgstr "[Comparaciones](./std-traits/comparisons.md) (10 minutos)" - -#: src/std-traits.md -msgid "[Operators](./std-traits/operators.md) (10 minutes)" -msgstr "[Operadores](./std-traits/operators.md) (10 minutos)" - -#: src/std-traits.md -msgid "[From and Into](./std-traits/from-and-into.md) (10 minutes)" -msgstr "[From e Into](./std-traits/from-and-into.md) (10 minutos)" - -#: src/std-traits.md -msgid "[Casting](./std-traits/casting.md) (5 minutes)" -msgstr "[Conversiones](./std-traits/casting.md) (5 minutos)" - -#: src/std-traits.md -msgid "[Read and Write](./std-traits/read-and-write.md) (10 minutes)" -msgstr "[Read y Write](./std-traits/read-and-write.md) (10 minutos)" - -#: src/std-traits.md -msgid "[Default, struct update syntax](./std-traits/default.md) (5 minutes)" +#: src/std-traits.md src/concurrency/sync-exercises.md +#: src/concurrency/async-exercises.md +msgid "This segment should take about 1 hour and 10 minutes. It contains:" msgstr "" -"[Default, sintaxis de actualización de structs](./std-traits/default.md) (5 " -"minutos)" +"Esta sección tiene una duración aproximada de 1 hora y 10 minutos. Contiene:" #: src/std-traits.md -msgid "[Closures](./std-traits/closures.md) (20 minutes)" -msgstr "[Cierres](./std-traits/closures.md) (20 minutos)" +msgid "From and Into" +msgstr "From e Into" #: src/std-traits.md -msgid "[Exercise: ROT13](./std-traits/exercise.md) (30 minutes)" -msgstr "[Ejercicio: ROT13](./std-traits/exercise.md) (30 minutos)" +msgid "Read and Write" +msgstr "Read y Write" #: src/std-traits.md -msgid "This segment should take about 1 hour and 40 minutes" -msgstr "Esta sección tiene una duración aproximada de 1 hora y 40 minutos." +msgid "Default, struct update syntax" +msgstr "Default, sintaxis de actualización de structs" #: src/std-traits.md msgid "" @@ -7493,9 +7288,8 @@ msgstr "" "equivalencia total usan `Eq` como límite del trait." #: src/std-traits/comparisons.md -#, fuzzy msgid "`PartialOrd` and `Ord`" -msgstr "`PartialEq` y `Eq`" +msgstr "`PartialOrd` y `Ord`" #: src/std-traits/comparisons.md msgid "" @@ -7542,10 +7336,9 @@ msgid "Discussion points:" msgstr "Cuestiones de debate:" #: src/std-traits/operators.md -#, fuzzy msgid "" "You could implement `Add` for `&Point`. In which situations is that useful?" -msgstr "¿En qué situaciones sería útil implementar `Add` para `&Point`? " +msgstr "¿En qué situaciones sería útil implementar `Add` para `&Point`?" #: src/std-traits/operators.md msgid "" @@ -7567,15 +7360,14 @@ msgstr "" "tipo del método?" #: src/std-traits/operators.md -#, fuzzy msgid "" "Short answer: Function type parameters are controlled by the caller, but " "associated types (like `Output`) are controlled by the implementer of a " "trait." msgstr "" "Respuesta corta: el llamador controla los parámetros tipo de la función, " -"pero los tipos asociados (como `Output`) los controla el implementador de un " -"trait ." +"pero los tipos asociados (como `Output`) son controlados por el " +"implementador de un trait." #: src/std-traits/operators.md msgid "" @@ -7745,10 +7537,6 @@ msgstr "" msgid "\"\\n\"" msgstr "\"\\n\"" -#: src/std-traits/read-and-write.md src/slices-and-lifetimes/str.md -msgid "\"World\"" -msgstr "\"mundo\"" - #: src/std-traits/read-and-write.md msgid "\"Logged: {:?}\"" msgstr "\"Registrado: {:?}\"" @@ -7781,8 +7569,8 @@ msgstr "\"Ya está configurado.\"" 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 "\"{:#?}\"" @@ -7816,14 +7604,12 @@ msgstr "" "razonables (por ejemplo, `0`, `\"\"`, etc.)." #: src/std-traits/default.md -#, fuzzy msgid "The partial struct initialization works nicely with default." msgstr "" -"La copia parcial de la estructura funciona correctamente con los valores " -"predeterminados. ." +"La inicialización parcial de estructuras funciona bien con los valores " +"predeterminados." #: src/std-traits/default.md -#, fuzzy msgid "" "The Rust standard library is aware that types can implement `Default` and " "provides convenience methods that use it." @@ -7833,7 +7619,6 @@ msgstr "" "utilizan." #: src/std-traits/default.md -#, fuzzy msgid "" "The `..` syntax is called [struct update syntax](https://doc.rust-lang.org/" "book/ch05-01-defining-structs.html#creating-instances-from-other-instances-" @@ -7841,7 +7626,7 @@ msgid "" msgstr "" "la sintaxis `..` se denomina [sintaxis de actualización de estructuras]" "(https://doc.rust-lang.org/book/ch05-01-defining-structs.html#creating-" -"instances-from-other-instances-with-struct-update-syntax)" +"instances-from-other-instances-with-struct-update-syntax)." #: src/std-traits/closures.md msgid "" @@ -7857,9 +7642,8 @@ msgstr "" "html):" #: src/std-traits/closures.md -#, fuzzy msgid "\"Calling function on {input}\"" -msgstr "Llamar Funciones Unsafe (Inseguras)" +msgstr "\"Llamado función sobre {input}\"" #: src/std-traits/closures.md msgid "\"add_3: {}\"" @@ -7946,13 +7730,17 @@ msgstr "" "De forma predeterminada, los cierres capturan, si pueden, por referencia. La " "palabra clave `move` hace que capturen por valor." +#: src/std-traits/closures.md src/smart-pointers/trait-objects.md +msgid "\"{} {}\"" +msgstr "\"{} {}\"" + #: src/std-traits/closures.md msgid "\"Hi\"" msgstr "\"¿Qué\"" #: src/std-traits/closures.md -msgid "\"there\"" -msgstr "\"pasa?\"" +msgid "\"Greg\"" +msgstr "\"Greg\"" #: src/std-traits/exercise.md msgid "" @@ -8011,65 +7799,20 @@ msgid "Smart pointers: standard library pointer types." msgstr "Punteros inteligentes: tipos de punteros de biblioteca estándar." #: src/welcome-day-3.md -msgid "[Welcome](./welcome-day-3.md) (3 minutes)" -msgstr "[Bienvenida](./welcome-day-3.md) (3 minutos)" - -#: src/welcome-day-3.md -msgid "[Memory Management](./memory-management.md) (1 hour and 10 minutes)" -msgstr "[Gestión de la memoria](./Memory-management.md) (1 hora y 10 minutos)" - -#: src/welcome-day-3.md -#, fuzzy -msgid "[Smart Pointers](./smart-pointers.md) (45 minutes)" -msgstr "[Punteros inteligentes](./smart-pointers.md) (55 minutos)" - -#: src/welcome-day-3.md -#, fuzzy msgid "" -"Including 10 minute breaks, this session should take about 2 hours and 15 " -"minutes" +"Including 10 minute breaks, this session should take about 2 hours and 20 " +"minutes. It contains:" msgstr "" "Contando con los descansos de 10 minutos, la duración prevista de la sesión " -"es de unas 2 horas y 25 minutos." - -#: src/memory-management.md -msgid "[Review of Program Memory](./memory-management/review.md) (5 minutes)" -msgstr "" -"[Revisión de la memoria del programa](./Memory-management/review.md) (5 " -"minutos)" +"es de unas 2 horas y 20 minutos. Contiene:" -#: src/memory-management.md -msgid "" -"[Approaches to Memory Management](./memory-management/approaches.md) (10 " -"minutes)" -msgstr "" -"[Estrategias para la gestión de la memoria](./Memory-manageme t/approaches." -"md) (10 minutos)" - -#: src/memory-management.md -msgid "[Ownership](./memory-management/ownership.md) (5 minutes)" -msgstr "[Ownership](./Memory-management/ownership.md) (5 minutos)" - -#: src/memory-management.md -msgid "[Move Semantics](./memory-management/move.md) (10 minutes)" -msgstr "[Semántica de movimiento](./Memory-management/move.md) (10 minutos)" - -#: src/memory-management.md -msgid "[Clone](./memory-management/clone.md) (2 minutes)" -msgstr "[Clonar](./Memory-management/clone.md) (2 minutos)" - -#: src/memory-management.md -msgid "[Copy Types](./memory-management/copy-types.md) (5 minutes)" -msgstr "[Copiar tipos](./Memory-management/copy-types.md) (5 minutos)" - -#: src/memory-management.md -msgid "[Drop](./memory-management/drop.md) (10 minutes)" -msgstr "[Drop](./Memory-management/drop.md) (10 minutos)" +#: src/memory-management.md src/memory-management/clone.md +msgid "Clone" +msgstr "Clone" #: src/memory-management.md -msgid "[Exercise: Builder Type](./memory-management/exercise.md) (20 minutes)" -msgstr "" -"[Ejercicio: tipo de compilador](./Memory-management/exercise.md) (20 minutos)" +msgid "Drop" +msgstr "`Drop`" #: src/memory-management/review.md msgid "Programs allocate memory in two ways:" @@ -8142,7 +7885,6 @@ msgstr "" "lang.org/std/alloc/index.html)." #: src/memory-management/review.md -#, fuzzy msgid "" "We can inspect the memory layout with `unsafe` Rust. However, you should " "point out that this is rightfully unsafe!" @@ -8171,8 +7913,8 @@ msgstr "" " // un comportamiento indefinido.\n" #: src/memory-management/review.md -msgid "\"ptr = {ptr:#x}, len = {len}, capacity = {capacity}\"" -msgstr "\"ptr = {ptr:#x}, longitud = {len}, capacidad = {capacity}\"" +msgid "\"capacity = {capacity}, ptr = {ptr:#x}, len = {len}\"" +msgstr "\"capacidad = {capacity}, ptr = {ptr:#x}, len = {len}\"" #: src/memory-management/approaches.md msgid "Traditionally, languages have fallen into two broad categories:" @@ -8230,8 +7972,8 @@ msgid "" "Full control _and_ safety via compile time enforcement of correct memory " "management." msgstr "" -"Control _y_ seguridad completa gracias a que el compilador se encarga del " -"correcto manejo de la memoria" +"Control completo _y_ seguridad completa gracias a que el compilador se " +"encarga del manejo correcto de la memoria." #: src/memory-management/approaches.md msgid "It does this with an explicit ownership concept." @@ -8310,18 +8052,20 @@ msgstr "" "produce un error cuando se usan fuera de él:" #: src/memory-management/ownership.md -#, fuzzy msgid "" "We say that the variable _owns_ the value. Every Rust value has precisely " "one owner at all times." -msgstr "Decimos que el valor _pertenece_ a la variable." +msgstr "" +"Decimos que el valor _pertenece_ a la variable. Cada valor en Rust tiene " +"exactamente un dueño en todo tiempo." #: src/memory-management/ownership.md -#, 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 "Al final del ámbito, la variable _se elimina_ y los datos se liberan." +msgstr "" +"Al final del ámbito, la variable _se elimina_ y los datos se liberan. Un " +"destructor puede correr en este momento para librar recursos." #: src/memory-management/ownership.md msgid "" @@ -8343,10 +8087,6 @@ msgstr "Una asignación transferirá su _ownership_ entre variables:" msgid "\"Hello!\"" msgstr "\"¡Hola!\"" -#: 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" @@ -8376,41 +8116,41 @@ msgstr "Después de mover a `s2`:" 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" "```" msgstr "" "```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" +" Stack Heap\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" @@ -8424,11 +8164,12 @@ msgstr "" "Cuando pasas un valor a una función, el valor se asigna al parámetro de la " "función. Esta acción transfiere el _ownership_:" -#: src/memory-management/move.md +#: src/memory-management/move.md src/memory-management/clone.md msgid "\"Hello {name}\"" msgstr "\"Hola {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\"" @@ -8512,9 +8253,8 @@ msgstr "" "programadores a clonar sólo de forma explícita." #: src/memory-management/move.md -#, fuzzy msgid "Defensive Copies in Modern C++" -msgstr "Double free en código C++ moderno" +msgstr "Copias Defensivas en C++ Moderno" #: src/memory-management/move.md msgid "Modern C++ solves this differently:" @@ -8581,10 +8321,6 @@ msgstr "" "A diferencia de Rust, en C++ se puede ejecutar código arbitrario con `=` " "según el tipo que se vaya a copiar o mover." -#: src/memory-management/clone.md -msgid "Clone" -msgstr "Clone" - #: src/memory-management/clone.md msgid "" "Sometimes you _want_ to make a copy of a value. The `Clone` trait " @@ -8596,12 +8332,11 @@ msgstr "" #: src/memory-management/clone.md 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 "" "La función de `Clone` es poder encontrar fácilmente dónde se producen las " -"asignaciones de montículos. Busca `.clone()` y otros elementos como `Vec::" -"new` o `Box::new`." +"asignaciones al heap. Busca a `.clone()` y algunos otros como `vec!` o `Box::" +"new`." #: src/memory-management/clone.md msgid "" @@ -8611,6 +8346,22 @@ msgstr "" "Es habitual \"clonar para salir\" de los problemas con el verificador de " "préstamos y volver más tarde para optimizar esos clones." +#: 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 "" +"`clone` generalmente realiza una copia a fondo del valor. Por ejemplo, si " +"clonas un array, todos los elementos del array tambien son clonados." + +#: src/memory-management/clone.md +msgid "" +"The behavior for `clone` is user-defined, so it can perform custom cloning " +"logic if needed." +msgstr "" +"El comportamiento de `clone` es definido por el usuario, entonces puede " +"realizar lógica personalizada de clonación si es necesario." + #: src/memory-management/copy-types.md msgid "" "While move semantics are the default, certain types are copied by default:" @@ -8682,7 +8433,6 @@ msgstr "" "es de tipo `Copy`." #: src/memory-management/copy-types.md -#, fuzzy msgid "" "Remove `Copy` from the `derive` attribute. The compiler error is now in the " "`println!` for `p1`." @@ -8694,6 +8444,19 @@ msgstr "" msgid "Show that it works if you clone `p1` instead." msgstr "Demuestra que funciona si clonas `p1`." +#: 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 "" +"Referencias compartidas son `Copy`/`Clone`, pero referencias mutables no lo " +"son. Esto es porque Rust requiere que las referencias mutables sean " +"exclusivas. Esto significa que es valido hacer una copia de una referencia " +"compartida, pero hacer lo mismo para una referencia mutable violaría las " +"reglas de préstamo de Rust." + #: src/memory-management/drop.md msgid "The `Drop` Trait" msgstr "El Trait `Drop`" @@ -8711,12 +8474,12 @@ msgstr "" msgid "\"Dropping {}\"" msgstr "\"Suprimiendo {}\"" -#: 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\"" @@ -8793,9 +8556,9 @@ 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 "" -"Respuesta corta: si lo hiciera, se llamaría a `std::mem::drop` al final del " -"bloque, lo que daría como resultado otra llamada a `Drop::drop` y un " -"desbordamiento de la _stack_." +"Respuesta corta: si lo hiciera, `std::mem::drop` sería llamado al final del " +"bloque, lo que daría como resultado otra llamada a `Drop::drop`, ¡y un " +"desbordamiento del _stack_!" #: src/memory-management/drop.md msgid "Try replacing `drop(a)` with `a.drop()`." @@ -8916,20 +8679,12 @@ 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 minutos)" - -#: src/smart-pointers.md -msgid "[Rc](./smart-pointers/rc.md) (5 minutes)" -msgstr "[Rc](./smart-pointers/rc.md) (5 minutos)" +msgid "Box" +msgstr "Box" #: src/smart-pointers.md -msgid "[Exercise: Binary Tree](./smart-pointers/exercise.md) (30 minutes)" -msgstr "[Ejercicio: árbol binario](./smart-pointers/exercise.md) (30 minutos)" +msgid "Rc" +msgstr "Rc" #: src/smart-pointers/box.md msgid "" @@ -8973,7 +8728,6 @@ msgid "\"{list:?}\"" msgstr "\"{list:?}\"" #: src/smart-pointers/box.md -#, fuzzy msgid "" "```bob\n" " Stack Heap\n" @@ -8995,32 +8749,31 @@ msgid "" "```" msgstr "" "```bob\n" -" Stack Heap\n" -".- - - - - - - - - - - - -. .- - - - - - - - - - - - - - - - - - - - - - " -"- -.\n" -": : : :\n" +" Stack Heap\n" +".- - - - - - - - - - - - - - . .- - - - - - - - - - - - - - - - - - - - " +"- - - - -.\n" +": : : :\n" ": " -"list : : :\n" -": +------+----+----+ : : +------+----+----+ +------+----+----" -"+ :\n" -": | Cons | 1 | o--+----+-----+--->| Cons | 2 | o--+--->| Nil | // | // " -"| :\n" -": +------+----+----+ : : +------+----+----+ +------+----+----" -"+ :\n" -": : : :\n" -": : : :\n" -"'- - - - - - - - - - - - -' '- - - - - - - - - - - - - - - - - - - - - - " -"- -'\n" +"list : : :\n" +": +---------+----+----+ : : +---------+----+----+ +------+----" +"+----+ :\n" +": | Element | 1 | o--+----+-----+--->| Element | 2 | o--+--->| Nil | // " +"| // | :\n" +": +---------+----+----+ : : +---------+----+----+ +------+----" +"+----+ :\n" +": : : :\n" +": : : :\n" +"'- - - - - - - - - - - - - - ' '- - - - - - - - - - - - - - - - - - - - " +"- - - - -'\n" "```" #: src/smart-pointers/box.md -#, fuzzy msgid "" "`Box` is like `std::unique_ptr` in C++, except that it's guaranteed to be " "not null." msgstr "" "`Box` es igual que `std::unique_ptr` en C++, salvo que está asegurado que no " -"será nulo. " +"será nulo." #: src/smart-pointers/box.md msgid "A `Box` can be useful when you:" @@ -9031,7 +8784,7 @@ msgid "" "have a type whose size that can't be known at compile time, but the Rust " "compiler wants to know an exact size." msgstr "" -"Si tienes un tipo cuyo tamaño no se conoce durante la compilación, pero el " +"tiene un tipo cuyo tamaño no se conoce durante la compilación, pero el " "compilador de Rust quiere saber el tamaño exacto." #: src/smart-pointers/box.md @@ -9040,19 +8793,19 @@ msgid "" "amounts of data on the stack, instead store the data on the heap in a `Box` " "so only the pointer is moved." msgstr "" -"Si quieres transferir la propiedad de una gran cantidad de datos. Para " -"evitar que se copien grandes cantidades de datos en la _stack_, almacena los " -"datos del _heap_ en un `Box` para que solo se mueva el puntero." +"quieres transferir la propiedad (\"ownership\") de una gran cantidad de " +"datos. Para evitar que se copien grandes cantidades de datos en el _stack_, " +"almacena los datos del _heap_ en un `Box` para que solo se mueva el puntero." #: src/smart-pointers/box.md msgid "" "If `Box` was not used and we attempted to embed a `List` directly into the " -"`List`, the compiler would not compute a fixed size of the struct in memory " -"(`List` would be of infinite size)." +"`List`, the compiler would not be able to compute a fixed size for the " +"struct in memory (the `List` would be of infinite size)." msgstr "" -"Si no se utiliza `Box` e intentamos insertar un `List` directamente dentro " -"de `List`, el compilador no calcularía un tamaño fijo de la estructura en la " -"memoria (`List` tendría un tamaño infinito)." +"Si no utilizamos `Box` e intentamos insertar un `List` directamente dentro " +"de `List`, el compilador no podría calcular un tamaño fijo de la estructura " +"en la memoria (`List` tendría un tamaño infinito)." #: src/smart-pointers/box.md msgid "" @@ -9064,14 +8817,15 @@ msgstr "" #: src/smart-pointers/box.md 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 "" "Elimina `Box` de la definición de la lista y muestra el error del " -"compilador. \"Recursivo con indirección\" es una sugerencia de que puedes " -"usar un Box o referencia de algún tipo, en lugar de almacenar un valor " -"directamente." +"compilador. El mensaje \"recursivo con indirección\" es una sugerencia de " +"que debes usar un Box o referencia de algún tipo en lugar de almacenar un " +"valor directamente." #: src/smart-pointers/box.md msgid "Niche Optimization" @@ -9079,46 +8833,45 @@ msgstr "Optimización de la Memoria" #: 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` no puede estar vacío, por lo que el puntero siempre es válido y no " -"`null`. Esto permite que el compilador optimice el diseño de la memoria:" +"Aunque `Box` se parece a `std::unique_ptr` en C++, no puede ser vació o " +"nulo. Esto hace `Box` uno de los tipos que permite que el compilador " +"optimice el almacenaje de ciertas enumeraciones." #: src/smart-pointers/box.md -#, fuzzy 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 "" -"```bob\n" -" Stack Heap\n" -".- - - - - - - - - - - - -. .- - - - - - - - - - - - - - - - - - - - - - " -"- -.\n" -": : : :\n" -": " -"list : : :\n" -": +------+----+----+ : : +------+----+----+ +------+----+----" -"+ :\n" -": | Cons | 1 | o--+----+-----+--->| Cons | 2 | o--+--->| Nil | // | // " -"| :\n" -": +------+----+----+ : : +------+----+----+ +------+----+----" -"+ :\n" -": : : :\n" -": : : :\n" -"'- - - - - - - - - - - - -' '- - - - - - - - - - - - - - - - - - - - - - " -"- -'\n" -"```" +"Por ejemplo, `Option>` tiene el mismo tamaño que `Box`, ya que el " +"compilador usa el valor nulo para discriminar variantes en vez de usar una " +"etiqueta explicita ([\"Null Pointer Optimization\"](https://doc.rust-lang." +"org/std/option/#representation)):" + +#: src/smart-pointers/box.md +msgid "\"Just box\"" +msgstr "\"Solo box\"" + +#: src/smart-pointers/box.md +msgid "\"Optional box\"" +msgstr "\"Box opcional\"" + +#: src/smart-pointers/box.md +msgid "\"Size of just_box: {}\"" +msgstr "\"Tamaño de just_box: {}\"" + +#: src/smart-pointers/box.md +msgid "\"Size of optional_box: {}\"" +msgstr "\"Tamaño de optional_box: {}\"" + +#: src/smart-pointers/box.md +msgid "\"Size of none: {}\"" +msgstr "\"Tamaño de none: {}\"" #: src/smart-pointers/rc.md msgid "" @@ -9191,15 +8944,192 @@ msgid "Use `Rc::strong_count` to check the reference count." msgstr "Comprueba el recuento de referencias con `Rc::strong_count`." #: src/smart-pointers/rc.md -#, fuzzy msgid "" "`Rc::downgrade` gives you a _weakly reference-counted_ object to create " "cycles that will be dropped properly (likely in combination with `RefCell`)." msgstr "" -"`Rc::downgrade` ofrece un objeto _de referencia contada baja_ para crear " -"`Rc::downgrade` ofrece un objeto de _referencia contada débil_ para crear " +"`Rc::downgrade` ofrece un objeto _de referencia contada debil_ para crear " +"ciclos que que se borraran propiamente (probablemente en combinación con " "`RefCell`)." +#: src/smart-pointers/trait-objects.md +msgid "" +"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 "" +"Previamente vimos que objetos de trait se pueden usar con referencias, e.g. " +"`&dyn Pet`. También podemos usar objetos de trait con punteros inteligentes " +"como `Box` para crear objetos de trait con dueño: `Box`." + +#: src/smart-pointers/trait-objects.md +msgid "Memory layout after allocating `pets`:" +msgstr "Diseño de la memoria después de asignar `pets`:" + +#: src/smart-pointers/trait-objects.md +msgid "" +"```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" +" 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" +"```" + +#: 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 "" +"Los tipos que implementan un trait pueden tener diferentes tamaños. Esto " +"hace imposible tener elementos como `Vec` en el ejemplo anterior." + +#: src/smart-pointers/trait-objects.md +msgid "" +"`dyn Pet` is a way to tell the compiler about a dynamically sized type that " +"implements `Pet`." +msgstr "" +"`dyn Pet` es una forma de indicar al compilador un tipo de tamaño dinámico " +"que implementa `Pet`." + +#: src/smart-pointers/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 "" +"En este ejemplo, `pets` es alocado sobre el stack y los datos del vector " +"sobre el heap. Los dos elementos del vector son _punteros gordos_:" + +#: 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 "" +"Un puntero gordo es un puntero de tamaño doble. Tiene dos componentes: un " +"puntero al objeto y un puntero a la [tabla virtual de métodos](https://en." +"wikipedia.org/wiki/Virtual_method_table) (vtable) para la implementación de " +"`Pet` de ese objeto." + +#: 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 "" +"Los datos para el `Dog` llamado Fido son los campos `name` y `age`. El `Cat` " +"tiene un campo `lives`." + +#: src/smart-pointers/trait-objects.md +msgid "Compare these outputs in the above example:" +msgstr "Compara estas salidas en el ejemplo anterior:" + #: src/smart-pointers/exercise.md msgid "" "A binary tree is a tree-type data structure where every node has two " @@ -9247,61 +9177,32 @@ msgstr "" "/// Si se añade el mismo valor varias veces, solo se almacena una vez.\n" #: src/smart-pointers/exercise.md -msgid "// Implement `new`, `insert`, `len`, and `has`.\n" -msgstr "// Implementa `new`, `insert`, `len` y `has`.\n" +msgid "// Implement `new`, `insert`, `len`, and `has` for `Subtree`.\n" +msgstr "// Implementa `new`, `insert`, `len` y `has` para `Subtree`.\n" #: src/smart-pointers/exercise.md src/smart-pointers/solution.md msgid "// not a unique item\n" msgstr "// No es un elemento único.\n" -#: src/smart-pointers/solution.md src/testing/googletest.md +#: src/smart-pointers/solution.md src/android/testing/googletest.md msgid "\"bar\"" msgstr "\"bar\"" -#: src/welcome-day-3-afternoon.md -msgid "[Borrowing](./borrowing.md) (1 hour)" -msgstr "[Préstamos](./borrowing.md) (1 hora)" - -#: src/welcome-day-3-afternoon.md -msgid "" -"[Slices and Lifetimes](./slices-and-lifetimes.md) (1 hour and 10 minutes)" -msgstr "" -"[Slices y tiempos de vida](./slices-and-lifetimes.md) (1 hora y 10 minutos)" - #: src/welcome-day-3-afternoon.md msgid "" -"Including 10 minute breaks, this session should take about 2 hours and 20 " -"minutes" +"Including 10 minute breaks, this session should take about 1 hour and 55 " +"minutes. It contains:" msgstr "" "Contando con los descansos de 10 minutos, la duración prevista de la sesión " -"es de unas 2 horas y 20 minutos." - -#: src/borrowing.md -msgid "[Borrowing a Value](./borrowing/shared.md) (10 minutes)" -msgstr "[Tomar prestado un valor](./borrowing/shared.md) (10 minutos)" - -#: src/borrowing.md -msgid "[Borrow Checking](./borrowing/borrowck.md) (10 minutes)" -msgstr "[Comprobación de préstamos](./borrowing/borrowck.md) (10 minutos)" - -#: src/borrowing.md -msgid "[Interior Mutability](./borrowing/interior-mutability.md) (10 minutes)" -msgstr "" -"[Mutabilidad interior](./borrowing/interior-mutability.md) (10 minutos)" - -#: src/borrowing.md -msgid "[Exercise: Health Statistics](./borrowing/exercise.md) (30 minutes)" -msgstr "" -"[Ejercicio: estadísticas de salud](./borrowing/exercise.md) (30 minutos)" +"es de una horas y 55 minutos. Contiene:" #: src/borrowing/shared.md -#, fuzzy msgid "" "As we saw before, instead of transferring ownership when calling a function, " "you can let a function _borrow_ the value:" msgstr "" -"En lugar de transferir el _ownership_ al llamar a una función, puedes " -"permitir que una función _tome prestado_ el valor:" +"En lugar de transferir el _ownership_ (posesión) al llamar a una función, " +"puedes permitir que una función _tome prestado_ el valor:" #: src/borrowing/shared.md msgid "The `add` function _borrows_ two points and returns a new point." @@ -9321,61 +9222,64 @@ msgstr "" "valores devueltos." #: src/borrowing/shared.md -msgid "Notes on stack returns:" +msgid "Notes on stack returns and inlining:" msgstr "Notas sobre la devolución de resultados de la _stack_:" #: 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 " "the same when changing to the \"RELEASE\" setting:" msgstr "" -"Demuestra que la instrucción de retorno de `add` es fácil porque el " +"Demuestra que la instrucción de retorno de `add` es barato porque el " "compilador puede eliminar la operación de copia. Cambia el código anterior " "para imprimir las direcciones de la _stack_ y ejecutarlas en el [Playground]" -"(https://play.rust-lang.org/) o consulta el ensamblador en [Godbolt](https://" -"rust.godbolt.org/). En el nivel de optimización \"DEBUG\", las direcciones " -"deberían cambiar. Sin embargo, deberían mantenerse igual modificar la " -"configuración \"RELEASE\":" +"(https://play.rust-lang.org/?" +"version=stable&mode=release&edition=2021&gist=0cb13be1c05d7e3446686ad9947c4671) " +"o consulta el ensamblador en [Godbolt](https://rust.godbolt.org/). En el " +"nivel de optimización \"DEBUG\", las direcciones deberían cambiar. Sin " +"embargo, deberían mantenerse igual modificar la configuración \"RELEASE\":" #: src/borrowing/shared.md -msgid "The Rust compiler can do return value optimization (RVO)." +msgid "" +"The Rust compiler can do automatic inlining, that can be disabled on a " +"function level with `#[inline(never)]`." msgstr "" -"El compilador de Rust puede hacer la optimización del valor devuelto (RVO)." +"El compilador Rust puede hacer enlineamiento automático que puede ser " +"deshabilitado al nivel de una función con `#[inline(never)]`." #: 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 "" -"En C++, la elisión de copia tiene que definirse en la especificación del " -"lenguaje, ya que los constructores pueden tener efectos secundarios. En " -"Rust, esto no supone ningún problema. Si no hay RVO, Rust siempre realizará " -"una copia `memcpy` simple y eficiente." +"Una vez deshabilitado, la dirección impresa cambiara en todos los niveles de " +"optimización. Mirando en Godbolt o Playground, uno puede ver que en este " +"caso el valor de retorno dependen del ABI, e.g. en amd64 los dos i32 que " +"constituyen el punto son regresados en 2 registros (eax y edx)." #: src/borrowing/borrowck.md -#, fuzzy msgid "" "Rust's _borrow checker_ puts constraints on the ways you can borrow values. " "For a given value, at any time:" -msgstr "Rust limita las formas en que se pueden tomar prestados valores:" +msgstr "" +"El _borrow checker_ de Rust limita las formas en que se pueden tomar " +"prestados valores. Para un dado valor, en cualquier tiempo:" #: src/borrowing/borrowck.md -#, fuzzy msgid "You can have one or more shared references to the value, _or_" -msgstr "Puedes tener uno o varios valores `&T` en un momento dado, _o_" +msgstr "Puedes tener uno o varios valores `&T`, _o_" #: src/borrowing/borrowck.md -#, fuzzy msgid "You can have exactly one exclusive reference to the value." -msgstr "puedes tener exactamente un valor `&mut T`." +msgstr "Solo puedes tener exactamente una referencia exclusiva al valor." #: src/borrowing/borrowck.md msgid "" @@ -9438,6 +9342,34 @@ msgstr "" "entiende del todo\", lo que suele dar lugar a \"conflictos con el " "comprobador de préstamos.\"" +#: 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 "" +"Como un ejemplo concreto de como estas reglas de préstamo previenen errores " +"de memoria, considera el caso de modificar una colección cuando existen " +"referencias a sus elementos:" + +#: src/borrowing/examples.md +msgid "\"{elem}\"" +msgstr "\"{elem}\"" + +#: src/borrowing/examples.md +msgid "Similarly, consider the case of iterator invalidation:" +msgstr "Considera este caso parecido de invalidación de iterador:" + +#: 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 "" +"En ambos casos, añadir elementos a la colección puede invalidar referencias " +"pre-existentes a los elementos de la colección si es necesario realizar " +"reasignación." + #: src/borrowing/interior-mutability.md msgid "" "In some situations, it's necessary to modify data behind a shared (read-" @@ -9465,13 +9397,23 @@ msgid "`RefCell`" msgstr "`RefCell`" #: src/borrowing/interior-mutability.md -msgid "\"graph: {root:#?}\"" -msgstr "\"gráfico: {root:#?}\"" +msgid "// Note that `cell` is NOT declared as mutable.\n" +msgstr "// Nota que `cell` NO es declarado como mutable.\n" #: src/borrowing/interior-mutability.md -msgid "\"graph sum: {}\"" -msgstr "\"suma de gráfico: {}\"" - +msgid "" +"// This triggers an error at runtime.\n" +" // let other = cell.borrow();\n" +" // println!(\"{}\", *other);\n" +msgstr "" +"// Esto causa un error al tiempo de ejecución.\n" +" // let other = cell.borrow();\n" +" // println!(\"{}\", *other);\n" + +#: src/borrowing/interior-mutability.md +msgid "\"{cell:?}\"" +msgstr "\"{cell:?}\"" + #: src/borrowing/interior-mutability.md msgid "`Cell`" msgstr "`Cell`" @@ -9512,13 +9454,14 @@ 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` solo permite el acceso compartido (de solo lectura) a su contenido, ya " -"que su objetivo es permitir (y contar) muchas referencias. Ya que nuestro " -"objetivo modificar el valor, necesitamos utilizar la mutabilidad interna." +"El bloque extra en el ejemplo `RefCell` existe para terminar el préstamo " +"creado por la llamada a `borrow_mut` antes de que imprimimos cal celda. " +"Intentando imprimir una celda `RefCell` solo enseña el mensaje " +"`\"{borrowed}\"`." #: src/borrowing/interior-mutability.md msgid "" @@ -9533,23 +9476,13 @@ msgstr "" #: src/borrowing/interior-mutability.md msgid "" -"Demonstrate that reference loops can be created by adding `root` to `subtree." -"children`." -msgstr "" -"Demuestra que se pueden crear bucles de referencia añadiendo `root` a " -"`subtree.children`." - -#: 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 "" -"Para demostrar un pánico en tiempo de ejecución, añade un `fn inc(&mut " -"self)` que incremente `self.value` y llame al mismo método en sus hijos. " -"Esto entrará en pánico en presencia del bucle de referencia, con `thread " -"'main' panicked at 'already borrowed: BorrowMutError'`." +"Ambos `RefCell` y `Cell` son `!Sync`, que significa que `&RefCell` y `&Cell` " +"no pueden ser pasados entre hilos. Esto previene que dos hilos intenten " +"acceder la celda al mismo tiempo." #: src/borrowing/exercise.md msgid "" @@ -9561,24 +9494,22 @@ msgstr "" "de los usuarios." #: src/borrowing/exercise.md -#, fuzzy msgid "" "You'll start with a stubbed function in an `impl` block as well as a `User` " "struct definition. Your goal is to implement the stubbed out method on the " "`User` `struct` defined in the `impl` block." msgstr "" "Comenzarás con algunas funciones stub en un bloque `impl`, así como con una " -"definición de estructura `User`. Tu objetivo es implementar métodos con " -"stubs en la `struct` `User` definida en el bloque `impl`." +"definición de estructura `User`. Tu objetivo es implementar métodos en el " +"`struct` `User` definida en el bloque `impl`." #: src/borrowing/exercise.md -#, fuzzy msgid "" "Copy the code below to and fill in the missing " "method:" msgstr "" -"Copia el fragmento de código que aparece más abajo en la página y rellena los métodos que faltan:" +"Copia el fragmento de código que aparece más abajo en la página a y rellena el método que falta:" #: src/borrowing/exercise.md msgid "" @@ -9589,7 +9520,8 @@ msgstr "" "obtenidas durante una consulta médica\"" #: 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\"" @@ -9597,236 +9529,7 @@ msgstr "\"Bob\"" msgid "\"I'm {} and my age is {}\"" msgstr "\"Me llamo {} y tengo {} años\"" -#: src/slices-and-lifetimes.md -msgid "[Slices: &\\[T\\]](./slices-and-lifetimes/slices.md) (10 minutes)" -msgstr "[Slices: &\\[T\\]](./slices-and-lifetimes/slices.md) (10 minutos)" - -#: src/slices-and-lifetimes.md -msgid "[String References](./slices-and-lifetimes/str.md) (10 minutes)" -msgstr "[Referencias de cadenas](./slices-and-lifetimes/str.md) (10 minutos)" - -#: src/slices-and-lifetimes.md -msgid "" -"[Lifetime Annotations](./slices-and-lifetimes/lifetime-annotations.md) (10 " -"minutes)" -msgstr "" -"[Anotaciones de tiempos de vida](./slices-and-lifetimes/lifetime-annotations." -"md) (10 minutos)" - -#: src/slices-and-lifetimes.md -msgid "" -"[Lifetime Elision](./slices-and-lifetimes/lifetime-elision.md) (5 minutes)" -msgstr "" -"[Omisión de tiempos de vida](./slices-and-lifetimes/lifetime-elision.md) (5 " -"minutos)" - -#: src/slices-and-lifetimes.md -msgid "" -"[Struct Lifetimes](./slices-and-lifetimes/struct-lifetimes.md) (5 minutes)" -msgstr "" -"[Tiempos de vida de structs](./slices-and-lifetimes/struct-lifetimes.md) (5 " -"minutos)" - -#: src/slices-and-lifetimes.md -msgid "" -"[Exercise: Protobuf Parsing](./slices-and-lifetimes/exercise.md) (30 minutes)" -msgstr "" -"[Ejercicio: análisis de Protobuf](./slices-and-lifetimes/exercise.md) (30 " -"minutos)" - -#: src/slices-and-lifetimes/slices.md -msgid "Slices" -msgstr "Slices" - -#: src/slices-and-lifetimes/slices.md -msgid "A slice gives you a view into a larger collection:" -msgstr "Un _slice_ ofrece una visión de una colección más amplia:" - -#: src/slices-and-lifetimes/slices.md -msgid "Slices borrow data from the sliced type." -msgstr "Los slices toman prestados datos del tipo slice." - -#: src/slices-and-lifetimes/slices.md -msgid "Question: What happens if you modify `a[3]` right before printing `s`?" -msgstr "" -"Pregunta: ¿Qué ocurre si se modifica `a[3]` justo antes de imprimir `s`?" - -#: src/slices-and-lifetimes/slices.md -msgid "" -"We create a slice by borrowing `a` and specifying the starting and ending " -"indexes in brackets." -msgstr "" -"Creamos un slice tomando prestado `a` y especificando entre paréntesis los " -"índices de inicio y de fin." - -#: 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 "" -"Si el slice comienza en el índice 0, la sintaxis de rango de Rust nos " -"permite eliminar el índice inicial, lo que significa que `&a[0..a.len()]` y " -"`&a[..a.len()]` son idénticos." - -#: 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 "" -"Lo mismo ocurre con el último índice, por lo que `&a[2..a.len()]` y " -"`&a[2..]` son idénticos." - -#: src/slices-and-lifetimes/slices.md -msgid "" -"To easily create a slice of the full array, we can therefore use `&a[..]`." -msgstr "" -"Para crear fácilmente un slice del array completo, podemos usar `&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` es una referencia a un slice de `i32`s. Ten en cuenta que el tipo de `s` " -"(`&[i32]`) ya no menciona la longitud del array. Esto nos permite realizar " -"cálculos en slices de diferentes tamaños." - -#: src/slices-and-lifetimes/slices.md -#, fuzzy -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 "" -"Los slices siempre tienen préstamos de otros objetos. En este ejemplo, `a` " -"tiene que permanecer \"con vida\" (en el ámbito) al menos durante el tiempo " -"que dure el slice. " - -#: src/slices-and-lifetimes/slices.md -#, fuzzy -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 "" -"La cuestión sobre la modificación de `a[3]` puede suscitar un debate " -"interesante, pero la respuesta es que, por razones de seguridad de memoria, " -"no se puede hacer mediante `a` en este punto de la ejecución, pero sí se " -"pueden leer los datos de `a` y `s` de forma segura. Funciona antes de crear " -"el slice y después de `println`, cuando el slice ya no se utiliza. En la " -"sección que trata sobre el _borrow checker_ se dará más información." - -#: 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 "" -"Ahora podemos entender los dos tipos de cadenas de Rust: `&str` es muy " -"parecida a `&[char]`, pero almacena sus datos en una codificación de " -"longitud variable (UTF-8)." - -#: src/slices-and-lifetimes/str.md -msgid "\"s1: {s1}\"" -msgstr "\"s1: {s1}\"" - -#: src/slices-and-lifetimes/str.md -msgid "\"Hello \"" -msgstr "\"¡Hola \"" - -#: src/slices-and-lifetimes/str.md -msgid "\"s3: {s3}\"" -msgstr "\"s3: {s3}\"" - -#: src/slices-and-lifetimes/str.md -msgid "Rust terminology:" -msgstr "Terminología de Rust:" - -#: src/slices-and-lifetimes/str.md -msgid "`&str` an immutable reference to a string slice." -msgstr "`&str` es una referencia inmutable a un slice de una cadena." - -#: src/slices-and-lifetimes/str.md -msgid "`String` a mutable string buffer." -msgstr "`String` es un búfer de cadena mutable." - -#: src/slices-and-lifetimes/str.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` introduce un slice de cadena, que es una referencia inmutable a los " -"datos de cadena codificados en UTF-8 y almacenados en un bloque de memoria. " -"Los literales de cadena (`\"Hello\"`) se almacenan en el binario del " -"programa." - -#: 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 "" -"El tipo `String` de Rust es un envoltorio que rodea a un vector de bytes. " -"Como sucede con `Vec`, tiene propiedad." - -#: src/slices-and-lifetimes/str.md -#, fuzzy -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 "" -"Al igual que ocurre con muchos otros tipos, `String::from()` crea una cadena " -"a partir de un literal de cadena. `String::new()` crea una cadena vacía a la " -"que se pueden añadir los datos de la cadena mediante los métodos `push()` y " -"`push_str()`." - -#: src/slices-and-lifetimes/str.md -#, fuzzy -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 "" -"La macro `format!()` es una forma práctica de generar una cadena propia a " -"partir de valores dinámicos. Acepta la misma especificación de formato que " -"`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 "" -"Puedes tomar prestados slices `&str` de `String` a través de `&` y, de forma " -"opcional, la selección de intervalos. Si seleccionas un intervalo de bytes " -"que no esté alineado con los límites de caracteres, la expresión activará un " -"pánico. El iterador `chars` itera sobre los caracteres y se aconseja esta " -"opción a intentar definir los límites de los caracteres correctamente." - -#: src/slices-and-lifetimes/str.md -#, fuzzy -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 "" -"Para los programadores de C++: piensa en `&str` como el `const char*` de C+" -"+, pero el que siempre apunta a una cadena válida en la memoria. `String` de " -"Rust es parecido a `std::string` de C++ (la diferencia principal es que " -"solo puede contener bytes codificados en UTF-8 y nunca utilizará una " -"optimización de cadena pequeña)." - -#: src/slices-and-lifetimes/str.md -#, fuzzy -msgid "Byte strings literals allow you to create a `&[u8]` value directly:" -msgstr "Las cadenas de bytes te permiten crear un valor `&[u8]` directamente:" - -#: src/slices-and-lifetimes/lifetime-annotations.md +#: src/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." @@ -9835,7 +9538,7 @@ msgstr "" "valor al que hace referencia. El verificador de préstamos se encarga de " "comprobarlo." -#: src/slices-and-lifetimes/lifetime-annotations.md +#: src/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 " @@ -9848,17 +9551,18 @@ msgstr "" "suele usar. Lee `&'a Point` como \"un `Point` prestado que es válido al " "menos durante el tiempo de vida `a`\"." -#: src/slices-and-lifetimes/lifetime-annotations.md -#, fuzzy +#: src/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 "" -"Las anotaciones durante el tiempo de vida crean restricciones. El compilador " -"verifica que hay una solución válida." +"Los tiempos de vida siempre son inferidos por el compilador: no es posible " +"asignar un tiempo de vida manualmente. Las anotaciones explicitas de tiempo " +"de vida crean restricciones cuando hay ambigüedad; el compilador verifica " +"que hay una solución válida." -#: src/slices-and-lifetimes/lifetime-annotations.md +#: src/lifetimes/lifetime-annotations.md msgid "" "Lifetimes become more complicated when considering passing values to and " "returning values from functions." @@ -9866,34 +9570,34 @@ msgstr "" "Los tiempos de vida se vuelven más complejos cuando se tiene en cuenta la " "transferencia y devolución de valores a las funciones." -#: src/slices-and-lifetimes/lifetime-annotations.md +#: src/lifetimes/lifetime-annotations.md msgid "// What is the lifetime of p3?\n" msgstr "// ¿Cuál es el tiempo de vida de 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 the compiler does not know what lifetime to infer for " -"`p3`. Looking inside the function body shows that it can only safely assume " -"that `p3`'s lifetime is the shorter of `p1` and `p2`. But just like types, " -"Rust requires explicit annotations of lifetimes on function arguments and " -"return values." +"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 " +"`p3`'s lifetime is the shorter of `p1` and `p2`. But just like types, Rust " +"requires explicit annotations of lifetimes on function arguments and return " +"values." msgstr "" "En este ejemplo, el compilador no conoce el tiempo de vida que se debe " -"inferir para `p3`. Al examinar el cuerpo de la función, solo se puede " -"suponer con seguridad que el tiempo de vida de `p3` es menor que`p1` y `p2`. " -"Sin embargo, como sucede con los tipos, Rust requiere anotaciones explícitas " -"de los tiempos de vida en los argumentos de las funciones y los valores " +"inferir para `p3`. Al examinar el cuerpo de la función, se puede suponer con " +"seguridad que el tiempo de vida de `p3` es menor que`p1` y `p2`. Sin " +"embargo, como sucede con los tipos, Rust requiere anotaciones explícitas de " +"los tiempos de vida en los argumentos de las funciones y los valores " "devueltos." -#: src/slices-and-lifetimes/lifetime-annotations.md +#: src/lifetimes/lifetime-annotations.md msgid "Add `'a` appropriately to `left_most`:" msgstr "Añade `'a` correctamente a `left_most`:" -#: 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`." @@ -9901,19 +9605,18 @@ msgstr "" "Por tanto, \"dado p1 y p2, que superan el tiempo de vida de `'a`, el valor " "devuelto tiene una duración de al menos `'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 "" "De forma habitual, los tiempos de vida se pueden omitir, tal como se " "describe en la siguiente diapositiva." -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "Lifetimes in Function Calls" msgstr "Tiempos de Vida en Llamadas a Función" -#: src/slices-and-lifetimes/lifetime-elision.md -#, fuzzy +#: 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 " @@ -9921,17 +9624,18 @@ msgid "" "inference -- it is just a syntactic shorthand." msgstr "" "El tiempo de vida de los argumentos de las funciones y los valores devueltos " -"deben especificarse por completo, pero Rust permite que se puedan eludir en " -"la mayoría de los casos con [unas sencillas reglas](https://doc.rust-lang." -"org/nomicon/lifetime-elision.html)." +"se deben especificar de manera completa, pero Rust permite que se puedan " +"eludir en la mayoría de los casos con [unas reglas sencillas](https://doc." +"rust-lang.org/nomicon/lifetime-elision.html). Esto no es inferencia -- solo " +"es un atajo de sintaxis." -#: 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 "" "A cada argumento que no tenga una anotación de tiempo de vida se le " "proporciona uno." -#: 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." @@ -9939,7 +9643,7 @@ msgstr "" "Si solo hay un tiempo de vida de un argumento, se le asigna a todos los " "valores devueltos que no estén anotados." -#: 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." @@ -9948,12 +9652,12 @@ msgstr "" "`self`, ese tiempo de vida se asigna a todos los valores devueltos que no " "estén anotados." -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "In this example, `cab_distance` is trivially elided." msgstr "" "En este ejemplo, `cab_distance` se ha suprimido sin que suponga un problema." -#: 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." @@ -9961,13 +9665,13 @@ msgstr "" "La función `nearest` proporciona otro ejemplo de una función con múltiples " "referencias en sus argumentos que requiere una anotación explícita." -#: src/slices-and-lifetimes/lifetime-elision.md +#: src/lifetimes/lifetime-elision.md msgid "Try adjusting the signature to \"lie\" about the lifetimes returned:" msgstr "" "Prueba a ajustar la firma para \"mentir\" sobre los tiempos de vida " "devueltos:" -#: 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 " @@ -9978,7 +9682,7 @@ msgstr "" "los punteros sin formato (inseguros), y es uno de los motivos por los que se " "cometen errores con Rust inseguro." -#: 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 " @@ -9994,40 +9698,40 @@ msgstr "" "se llevan a cabo prototipos, resulta más fácil trabajar únicamente con datos " "propios, clonando valores siempre que sea necesario." -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "Lifetimes in Data Structures" msgstr "Tiempos de vida en estructuras de datos" -#: 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 "" "Si un tipo de datos almacena datos prestados, se debe anotar con tiempo de " "vida:" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "\"Bye {text}!\"" msgstr "\"¡Adiós, {text}!\"" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "\"The quick brown fox jumps over the lazy dog.\"" msgstr "" "\"El veloz murciélago hindú comía feliz cardillo y kiwi. La cigüeña tocaba " "el saxofón detrás del palenque de paja.\"" -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "// erase(text);\n" msgstr "// erase(text);\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 " @@ -10037,7 +9741,7 @@ msgstr "" "subyacentes a la `&str` contenida tengan al menos la misma duración que " "cualquier instancia de `Highlight` que utilice esos datos." -#: 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." @@ -10045,7 +9749,7 @@ msgstr "" "Si `text` se consume antes de que acabe el tiempo de vida de `fox` (o " "`dog`), el _borrow checker_ (verificador de préstamos) muestra un error." -#: 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 " @@ -10055,13 +9759,13 @@ msgstr "" "conservar los datos originales. Esto puede ser útil para crear vistas " "ligeras aunque, por lo general, hace que sean un poco más difíciles de usar." -#: src/slices-and-lifetimes/struct-lifetimes.md +#: src/lifetimes/struct-lifetimes.md msgid "When possible, make data structures own their data directly." msgstr "" "Siempre que sea posible, haz que las estructuras de datos sean propietarias " "directas de sus datos." -#: 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 " @@ -10074,7 +9778,7 @@ msgstr "" "tiempo de vida de la propia estructura. Estos son casos prácticos muy " "avanzados." -#: 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 " @@ -10087,7 +9791,7 @@ msgstr "" "ejemplo se muestra un patrón de análisis muy habitual que consiste en " "transferir fracciones de datos. Los datos subyacentes nunca se copian." -#: 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` " @@ -10100,12 +9804,11 @@ msgstr "" "esa información en declaraciones `match` en funciones a las que se llama " "para cada campo." -#: src/slices-and-lifetimes/exercise.md -#, fuzzy +#: src/lifetimes/exercise.md msgid "We'll use the following proto:" -msgstr "Puedes usar el siguiente archivo `Cargo.toml`:" +msgstr "Usaremos el proto que sigue:" -#: 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 " @@ -10118,7 +9821,7 @@ msgstr "" "mensaje de `Person`) y un tipo de wire que define cómo se debe definir la " "carga útil a partir del flujo de bytes." -#: 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 " @@ -10131,7 +9834,7 @@ msgstr "" "retrollamadas para gestionar los campos `Person` y `PhoneNumber`, así como " "analizar un mensaje en una serie de llamadas a dichas retrollamadas." -#: 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`." @@ -10139,39 +9842,15 @@ msgstr "" "Ahora solo tienes que implementar la función `parse_field` y el trait " "`ProtoMessage` para `Person` y `PhoneNumber`." -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Invalid varint\"" -msgstr "\"Varint no válido\"" - -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Invalid wire-type\"" -msgstr "\"Tipo de wire no válido\"" - -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Unexpected EOF\"" -msgstr "\"EOF inesperado\"" - -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Invalid length\"" -msgstr "\"Longitud no válida\"" - -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Unexpected wire-type)\"" -msgstr "\"Tipo de wire inesperado)\"" - -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md -msgid "\"Invalid string (not UTF-8)\"" -msgstr "\"Cadena no válida (no es 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 "/// Tipo de wire como se observa en el wire.\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 indica que el valor es un único VARINT.\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "" "//I64, -- not needed for this exercise\n" " /// The Len WireType indicates that the value is a length represented as " @@ -10183,7 +9862,7 @@ msgstr "" "como\n" " /// VARINT seguida exactamente de ese número de bytes.\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "" "/// The I32 WireType indicates that the value is precisely 4 bytes in\n" " /// little-endian order containing a 32-bit signed integer.\n" @@ -10192,30 +9871,58 @@ msgstr "" " /// el orden little endian que contiene un número entero con signo de 32 " "bits.\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 "/// Valor de un campo, escrito en función del tipo de wire.\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), -- no es necesario para este ejercicio\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// A field, containing the field number and its value.\n" msgstr "/// Campo que contiene el número de campo y su valor.\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, no es necesario para este ejercicio\n" -#: src/slices-and-lifetimes/exercise.md src/slices-and-lifetimes/solution.md +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "\"Invalid wire type: {value}\"" +msgstr "\"Tipo de wire no válido: {value}\"" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "\"Expected string to be a `Len` field\"" +msgstr "\"Cadena era esperado ser un campo `Len`\"" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "\"Invalid string\"" +msgstr "\"Cadena no válida\"" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "\"Expected bytes to be a `Len` field\"" +msgstr "\"Bytes eran esperados ser un campo `Len`\"" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "\"Expected `u64` to be a `Varint` field\"" +msgstr "\"`u64` era esperado ser un campo `Varint`\"" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md +msgid "\"Expected `i32` to be an `I32` field\"" +msgstr "\"`i32` era esperado ser un campo `I32`\"" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "" "/// Parse a VARINT, returning the parsed value and the remaining bytes.\n" msgstr "" "/// Analiza un VARINT, que devuelve el valor analizado y los bytes " "restantes.\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 "\"No hay suficientes bytes para un varint\"" + +#: 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" @@ -10223,19 +9930,23 @@ msgstr "" "// Este es el último byte de VARINT, así que conviértelo en\n" " // u64 y haz que lo devuelva.\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 "// Un número mayor de 7 bytes no es válido.\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 "\"Demasiados bytes para un varint\"" + +#: src/lifetimes/exercise.md src/lifetimes/solution.md msgid "/// Convert a tag into a field number and a WireType.\n" msgstr "/// Convierte una etiqueta en un número de campo y un 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 "/// Analiza un campo y haz que devuelva los bytes restantes.\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.\"" @@ -10243,11 +9954,11 @@ msgstr "" "\"En función del tipo de wire, crea un campo que utilice todos los bytes " "necesarios.\"" -#: src/slices-and-lifetimes/exercise.md +#: src/lifetimes/exercise.md msgid "\"Return the field, and any un-consumed bytes.\"" msgstr "\"Devuelve el campo y los bytes que no se hayan utilizado.\"" -#: 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" @@ -10261,31 +9972,50 @@ msgstr "" "///\n" "/// Se utilizan todos los datos introducidos.\n" -#: src/slices-and-lifetimes/exercise.md +#: src/lifetimes/exercise.md msgid "// TODO: Implement ProtoMessage for Person and PhoneNumber.\n" msgstr "// TAREA: implementar ProtoMessage para Person y PhoneNumber.\n" -#: src/slices-and-lifetimes/solution.md +#: 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 "" +"En este ejercicio hay varios casos en los cuales la lección del protobuf " +"puede fallar, e.g. si intentas leer un `i32` cuando hay menos de 4 bytes " +"restantes en el buffer de datos. Normalmente usaríamos el enum `Result`, " +"pero para simplificar el ejercicio inducimos pánico si ocurre un error. En " +"el día 4 cubriremos el manejo de errores en Rust en mas detall" + +#: src/lifetimes/solution.md +msgid "\"len not a valid `usize`\"" +msgstr "\"len no es un `usize` valido\"" + +#: src/lifetimes/solution.md +msgid "\"Unexpected EOF\"" +msgstr "\"EOF inesperado\"" + +#: src/lifetimes/solution.md msgid "// Unwrap error because `value` is definitely 4 bytes long.\n" msgstr "// Desenvuelve el error porque `value` tiene 4 bytes.\n" -#: src/slices-and-lifetimes/solution.md +#: src/lifetimes/solution.md msgid "// skip everything else\n" msgstr "// salta todos los demás pasos\n" -#: src/slices-and-lifetimes/solution.md -msgid "b\"hello\"" -msgstr "n\"hola\"" - #: src/welcome-day-4.md msgid "Welcome to Day 4" msgstr "Bienvenido al Día 4" #: src/welcome-day-4.md -#, fuzzy msgid "" "Today we will cover topics relating to building large-scale software in Rust:" -msgstr "Hoy vamos a tratar algunos temas más avanzados de Rust:" +msgstr "" +"Hoy vamos a tratar algunos temas relacionados con la construcción de " +"aplicaciones de grande escala en Rust:" #: src/welcome-day-4.md msgid "Iterators: a deep dive on the `Iterator` trait." @@ -10312,39 +10042,24 @@ msgstr "" "expresarte en Rust seguro." #: src/welcome-day-4.md -msgid "[Welcome](./welcome-day-4.md) (3 minutes)" -msgstr "[Bienvenida](./welcome-day-4.md) (3 minutos)" - -#: src/welcome-day-4.md -msgid "[Iterators](./iterators.md) (45 minutes)" -msgstr "[Iteradores](./iterators.md) (45 minutos)" - -#: src/welcome-day-4.md -msgid "[Modules](./modules.md) (40 minutes)" -msgstr "[Módulos](./modules.md) (40 minutos)" - -#: src/welcome-day-4.md -msgid "[Testing](./testing.md) (1 hour and 5 minutes)" -msgstr "[Pruebas](./testing.md) (1 hora y 5 minutos)" - -#: src/iterators.md -msgid "[Iterator](./iterators/iterator.md) (5 minutes)" -msgstr "[Iterator](./iterators/iterator.md) (5 minutos)" +msgid "" +"Including 10 minute breaks, this session should take about 2 hours and 40 " +"minutes. It contains:" +msgstr "" +"Contando con los descansos de 10 minutos, la duración prevista de la sesión " +"es de unas 2 horas y 40 minutos. Contiene:" #: src/iterators.md -msgid "[IntoIterator](./iterators/intoiterator.md) (5 minutes)" -msgstr "[IntoIterator](./iterators/intoiterator.md) (5 minutos)" +msgid "Iterator" +msgstr "Iterador (Iterator)" #: src/iterators.md -msgid "[FromIterator](./iterators/fromiterator.md) (5 minutes)" -msgstr "[FromIterator](./iterators/fromiterator.md) (5 minutos)" +msgid "IntoIterator" +msgstr "`IntoIterator`" -#: src/iterators.md -msgid "" -"[Exercise: Iterator Method Chaining](./iterators/exercise.md) (30 minutes)" -msgstr "" -"[Ejercicio: encadenamiento de métodos del iterador](./iterators/exercise.md) " -"(30 minutos)" +#: src/iterators.md src/iterators/fromiterator.md +msgid "FromIterator" +msgstr "FromIterator" #: src/iterators/iterator.md msgid "" @@ -10390,7 +10105,6 @@ msgstr "" "pero `some_vec.next()` no existe." #: src/iterators/intoiterator.md -#, fuzzy msgid "" "The `Iterator` trait tells you how to _iterate_ once you have created an " "iterator. The related trait [`IntoIterator`](https://doc.rust-lang.org/std/" @@ -10398,20 +10112,21 @@ msgid "" "It is used automatically by the `for` loop." msgstr "" "El trait `Iterator` te indica cómo _iterar_ una vez que has creado un " -"iterador. El trait relacionado `IntoIterator` indica cómo crear el iterador:" +"iterador. El trait relacionado [`IntoIterator`](https://doc.rust-lang.org/" +"std/iter/trait.IntoIterator.html) indica cómo crear un iterador para un " +"tipo. Es usado automáticamente por los bucles `for`." #: src/iterators/intoiterator.md msgid "\"point = {x}, {y}\"" msgstr "\"punto = {x}, {y}\"" #: src/iterators/intoiterator.md -#, fuzzy msgid "" "Click through to the docs for `IntoIterator`. Every implementation of " "`IntoIterator` must declare two types:" msgstr "" -"La sintaxis aquí significa que cada implementación de `IntoIterator` debe " -"declarar dos tipos:" +"Haz clic para leer la documentación para `IntoIterator`. Cada implementación " +"de `IntoIterator` debe declarar dos tipos:" #: src/iterators/intoiterator.md msgid "`Item`: the type to iterate over, such as `i8`," @@ -10464,10 +10179,6 @@ msgstr "" "elementos propios de ese vector. En su lugar, puedes utilizar `for e in " "&some_vector` para iterar sobre referencias a elementos de `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) " @@ -10483,9 +10194,8 @@ msgid "\"prime_squares: {prime_squares:?}\"" msgstr "\"prime_squares: {prime_squares:?}\"" #: src/iterators/fromiterator.md -#, fuzzy msgid "`Iterator` implements" -msgstr "`Iterator`" +msgstr "`Iterator` implementa" #: src/iterators/fromiterator.md msgid "There are two ways to specify `B` for this method:" @@ -10510,35 +10220,35 @@ msgstr "" "collect()`. Reescribe el ejemplo para usar esta opción." #: src/iterators/fromiterator.md -#, fuzzy msgid "" "There are basic implementations of `FromIterator` for `Vec`, `HashMap`, etc. " "There are also more specialized implementations which let you do cool things " "like convert an `Iterator>` into a `Result, E>`." msgstr "" -"También hay implementaciones que permiten hacer cosas interesantes, como " -"convertir un `Iterator>` en un `Result, E>`." +"Existen implementaciones básicas de `FromIterator` para `Vec`, `HashMap`, " +"etc. También existen implementaciones mas especializadas que te dejan hacer " +"cosas padres como convertir un `Iterator>` a un " +"`Result, E>`." #: src/iterators/exercise.md -#, fuzzy msgid "" "In this exercise, you will need to find and use some of the provided methods " "in the [`Iterator`](https://doc.rust-lang.org/std/iter/trait.Iterator.html) " "trait to implement a complex calculation." msgstr "" -"Se puede implementar el trait [`Iterator`](https://doc.rust-lang.org/std/" -"iter/trait.Iterator.html) en tus propios tipos:" +"En este ejercicio, necesitaras encontrar y usar métodos del trait " +"[`Iterator`](https://doc.rust-lang.org/std/iter/trait.Iterator.html) para " +"implementar una calculación compleja." #: src/iterators/exercise.md -#, fuzzy msgid "" "Copy the following code to and make the tests " "pass. Use an iterator expression and `collect` the result to construct the " "return value." msgstr "" "Copia el siguiente fragmento de código en la página para hacer la prueba. Prueba a no asignar un `Vec` a los resultados " -"intermedios:" +"org/> y haz que las pruebas sucedan sin error. Usa una expresión de iterador " +"y `collect` para construir el valor devuelto." #: src/iterators/exercise.md src/iterators/solution.md msgid "" @@ -10555,33 +10265,9 @@ msgstr "" "///\n" "/// El elemento `n` del resultado es `values[(n+offset)%len] - values[n]`.\n" -#: src/modules.md -msgid "[Modules](./modules/modules.md) (5 minutes)" -msgstr "[Módulos](./modules/modules.md) (5 minutos)" - -#: src/modules.md -msgid "[Filesystem Hierarchy](./modules/filesystem.md) (5 minutes)" -msgstr "" -"[Jerarquía del sistema de archivos](./modules/filesystem.md) (5 minutos)" - -#: src/modules.md -msgid "[Visibility](./modules/visibility.md) (5 minutes)" -msgstr "[Visibilidad](./modules/visible.md) (5 minutos)" - -#: src/modules.md -msgid "[use, super, self](./modules/paths.md) (10 minutes)" -msgstr "[use, super, self](./modules/paths.md) (10 minutos)" - -#: src/modules.md -msgid "" -"[Exercise: Modules for a GUI Library](./modules/exercise.md) (15 minutes)" -msgstr "" -"[Ejercicio: módulos para una biblioteca GUI](./modules/exercise.md) (15 " -"minutos)" - -#: src/modules.md -msgid "This segment should take about 40 minutes" -msgstr "Esta sección tiene una duración aproximada de 40 minutos." +#: 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." @@ -10804,10 +10490,6 @@ msgstr "" "En cualquier caso, se debe dar visibilidad a un módulo antecedente (y a " "todos sus descendientes)." -#: 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 " @@ -10830,7 +10512,7 @@ msgstr "Como ruta relativa:" #: src/modules/paths.md msgid "`foo` or `self::foo` refers to `foo` in the current module," -msgstr "`foo` o `self::foo` hacen referencia a `foo` en el módulo." +msgstr "`foo` o `self::foo` hacen referencia a `foo` en el módulo corriente," #: src/modules/paths.md msgid "`super::foo` refers to `foo` in the parent module." @@ -10842,7 +10524,7 @@ msgstr "Como ruta absoluta:" #: src/modules/paths.md msgid "`crate::foo` refers to `foo` in the root of the current crate," -msgstr "`crate::foo` hace referencia a `foo` en la raíz del crate." +msgstr "`crate::foo` hace referencia a `foo` en la raíz del crate corriente," #: src/modules/paths.md msgid "`bar::foo` refers to `foo` in the `bar` crate." @@ -10861,8 +10543,8 @@ msgid "" "making `DiskStorage` and `NetworkStorage` available to other crates with a " "convenient, short path." msgstr "" -"DiskStorage` y `NetworkStorage` estén disponibles para otros crates con una " -"ruta corta y práctica." +"haciendo que `DiskStorage` y `NetworkStorage` estén disponibles para otros " +"crates con una ruta corta y práctica." #: src/modules/paths.md msgid "" @@ -10909,9 +10591,8 @@ msgstr "" "su propio módulo." #: src/modules/exercise.md -#, fuzzy msgid "Cargo Setup" -msgstr "Configurar" +msgstr "Configuración de Cargo" #: src/modules/exercise.md msgid "" @@ -11095,34 +10776,6 @@ msgstr "" msgid "// ---- src/main.rs ----\n" msgstr "// ---- src/main.rs ----\n" -#: src/testing.md -msgid "[Test Modules](./testing/unit-tests.md) (5 minutes)" -msgstr "[Módulos de pruebas](./testing/unit-tests.md) (5 minutos)" - -#: src/testing.md -msgid "[Other Types of Tests](./testing/other.md) (10 minutes)" -msgstr "[Otros tipos de pruebas](./testing/other.md) (10 minutos)" - -#: src/testing.md -msgid "[Useful Crates](./testing/useful-crates.md) (3 minutes)" -msgstr "[Crates útiles](./testing/useful-crates.md) (3 minutos)" - -#: src/testing.md -msgid "[GoogleTest](./testing/googletest.md) (5 minutes)" -msgstr "[GoogleTest](./testing/googletest.md) (5 minutos)" - -#: src/testing.md -msgid "[Mocking](./testing/mocking.md) (5 minutes)" -msgstr "[Simulación](./testing/mocking.md) (5 minutos)" - -#: src/testing.md -msgid "[Compiler Lints and Clippy](./testing/lints.md) (5 minutes)" -msgstr "[Lints de compilador y Clippy](./testing/lints.md) (5 minutos)" - -#: src/testing.md -msgid "[Exercise: Luhn Algorithm](./testing/exercise.md) (30 minutes)" -msgstr "[Ejercicio: Algoritmo de Luhn](./testing/exercise.md) (30 minutos)" - #: src/testing/unit-tests.md msgid "Unit Tests" msgstr "Pruebas Unitarias" @@ -11241,223 +10894,6 @@ msgstr "" "org/?" "version=stable&mode=debug&edition=2021&gist=3ce2ad13ea1302f6572cb15cd96becf0)." -#: src/testing/useful-crates.md -msgid "Rust comes with only basic support for writing tests." -msgstr "Rust solo incluye asistencia básica para las pruebas de escritura." - -#: src/testing/useful-crates.md -msgid "Here are some additional crates which we recommend for writing tests:" -msgstr "" -"A continuación, se indican algunos crates adicionales que recomendamos para " -"escribir pruebas:" - -#: src/testing/useful-crates.md -msgid "" -"[googletest](https://docs.rs/googletest): Comprehensive test assertion " -"library in the tradition of GoogleTest for C++." -msgstr "" -"[googletest](https://docs.rs/googletest): biblioteca completa de aserción de " -"pruebas en la tradición de GoogleTest para C++." - -#: src/testing/useful-crates.md -msgid "[proptest](https://docs.rs/proptest): Property-based testing for Rust." -msgstr "" -"[proptest](https://docs.rs/proptest): pruebas basadas en propiedades para " -"Rust." - -#: src/testing/useful-crates.md -msgid "" -"[rstest](https://docs.rs/rstest): Support for fixtures and parameterised " -"tests." -msgstr "" -"[rstest](https://docs.rs/rstest): asistencia para _fixtures_ y pruebas " -"parametrizadas." - -#: src/testing/googletest.md -#, fuzzy -msgid "" -"The [GoogleTest](https://docs.rs/googletest/) crate allows for flexible test " -"assertions using _matchers_:" -msgstr "" -"[googletest](https://docs.rs/googletest): biblioteca completa de aserción de " -"pruebas en la tradición de GoogleTest para C++." - -#: src/testing/googletest.md -msgid "\"baz\"" -msgstr "\"baz\"" - -#: src/testing/googletest.md -msgid "\"xyz\"" -msgstr "\"xyz\"" - -#: src/testing/googletest.md -msgid "" -"If we change the last element to `\"!\"`, the test fails with a structured " -"error message pin-pointing the error:" -msgstr "" -"Si cambiamos el último elemento a `\"!\"`, la prueba dará error y aparecerá " -"un mensaje de error estructurado que señala cuál es el fallo:" - -#: src/testing/googletest.md -msgid "" -"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 "" -"GoogleTest no forma parte de Rust Playground, por lo que debes llevar a cabo " -"este ejemplo en un entorno local. Usa `cargo add googletest` para añadirlo " -"rápidamente a un proyecto de Cargo que ya tengas." - -#: src/testing/googletest.md -msgid "" -"The `use googletest::prelude::*;` line imports a number of [commonly used " -"macros and types](https://docs.rs/googletest/latest/googletest/prelude/index." -"html)." -msgstr "" -"La línea `use googletest::prelude::*;` importa una serie de [macros y tipos " -"habituales](https://docs.rs/googletest/latest/googletest/prelude/index.html)." - -#: src/testing/googletest.md -msgid "This just scratches the surface, there are many builtin matchers." -msgstr "Esto es solo el comienzo, existen muchos matchers integrados." - -#: src/testing/googletest.md -msgid "" -"A particularly nice feature is that mismatches in multi-line strings strings " -"are shown as a diff:" -msgstr "" -"Una característica muy interesante es que las discrepancias en las cadenas " -"que contienen varias líneas se muestran como un diff:" - -#: src/testing/googletest.md -msgid "" -"\"Memory safety found,\\n\\\n" -" Rust's strong typing guides the way,\\n\\\n" -" Secure code you'll write.\"" -msgstr "" -"\"Se ha encontrado la seguridad de la memoria,\\n\\\n" -" la potente escritura de Rust guía el camino,\\n\\\n" -" protege el código que vayas a escribir.\"" - -#: src/testing/googletest.md -msgid "" -"\"Memory safety found,\\n\\\n" -" Rust's silly humor guides the way,\\n\\\n" -" Secure code you'll write.\"" -msgstr "" -"\"Se ha encontrado seguridad en la memoria,\\n\\\n" -" el divertido sentido del humor de Rust guía el camino,\\n\\\n" -" protege el código que vayas a escribir.\"" - -#: src/testing/googletest.md -msgid "shows a color-coded diff (colors not shown here):" -msgstr "muestra un diff con colores (colores que no se muestran aquí):" - -#: src/testing/googletest.md -msgid "" -"The crate is a Rust port of [GoogleTest for C++](https://google.github.io/" -"googletest/)." -msgstr "" -"El crate es un puerto de Rust de [GoogleTest para C++](https://google.github." -"io/googletest/)." - -#: src/testing/googletest.md -msgid "GoogleTest is available for use in AOSP." -msgstr "GoogleTest se puede utilizar en AOSP." - -#: src/testing/mocking.md -msgid "" -"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 "" -"[Mockall](https://docs.rs/mockall/) es una biblioteca que se usa para hacer " -"simulaciones. Debes refactorizar tu código para usar traits, con los que " -"podrás hacer simulaciones:" - -#: src/testing/mocking.md -msgid "" -"The advice here is for Android (AOSP) where Mockall is the recommended " -"mocking library. 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 "" -"Estos consejos son útiles para Android (AOSP), donde Mockall es la " -"biblioteca de simulaciones recomendada. Hay otras [bibliotecas de simulación " -"disponibles en crates.io](https://crates.io/keywords/mock), especialmente en " -"el área de servicios de simulación de HTTP. Las demás bibliotecas de " -"simulación funcionan de forma similar a Mockall, lo que significa que " -"facilitan la obtención de una implementación simulada de un trait " -"determinado." - -#: src/testing/mocking.md -msgid "" -"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 "" -"Ten en cuenta que las simulaciones son algo _polémicas_, ya que te permiten " -"aislar por completo una prueba de sus dependencias. El resultado inmediato " -"es una ejecución de pruebas más rápida y estable. Por otro lado, las " -"simulaciones se pueden configurar de forma incorrecta y devuelven un " -"resultado diferente del que se obtendría con las dependencias reales." - -#: src/testing/mocking.md -msgid "" -"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 "" -"Si es posible, te recomendamos que uses las dependencias reales. Por " -"ejemplo, muchas bases de datos te permiten configurar un backend en la " -"memoria. Es decir, en tus pruebas obtendrás el comportamiento correcto y, " -"además, son rápidas y se limpiarán de forma automática tras las pruebas." - -#: src/testing/mocking.md -msgid "" -"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 "" -"Del mismo modo, muchos frameworks web te permiten iniciar un servidor en " -"proceso que se vincula a un puerto aleatorio en `localhost`. Siempre es " -"mejor utilizar esta opción en lugar de simular el framework, ya que te ayuda " -"a hacer pruebas con el código en el entorno real." - -#: src/testing/mocking.md -msgid "" -"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 "" -"Mockall no forma parte de Rust Playground, por lo que debes ejecutar este " -"ejemplo en un entorno local. Usa `cargo add modelall` para añadir de forma " -"rápida Mockall a un proyecto de Cargo." - -#: src/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 tiene muchas más funciones. En concreto, puedes configurar " -"expectativas en función de los argumentos. Aquí utilizamos el ejemplo para " -"simular un gato que tiene hambre 3 horas después de que le hayan dado de " -"comer:" - -#: src/testing/mocking.md -msgid "" -"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 "" -"Puedes utilizar `.times(n)` para limitar el número de veces que se puede " -"llamar a un método de simulación a `n`. Si no se cumple, la simulación " -"activará un pánico automáticamente cuando se elimine." - #: src/testing/lints.md msgid "" "The Rust compiler produces fantastic error messages, as well as helpful " @@ -11517,7 +10953,7 @@ msgstr "" "crédito:" #: src/testing/exercise.md -msgid "Ignore all spaces. Reject number with less than two digits." +msgid "Ignore all spaces. Reject numbers with fewer than two digits." msgstr "" "Ignora todos los espacios. Rechaza los números con menos de dos dígitos." @@ -11551,7 +10987,7 @@ msgstr "" #: src/testing/exercise.md msgid "" "The provided code provides a buggy implementation of the luhn algorithm, " -"along with two basic unit tests that confirm that most the algorithm is " +"along with two basic unit tests that confirm that most of the algorithm is " "implemented correctly." msgstr "" "El código proporcionado ofrece una implementación errónea del algoritmo de " @@ -11559,14 +10995,14 @@ msgstr "" "parte del algoritmo se ha implementado correctamente." #: src/testing/exercise.md -#, fuzzy msgid "" "Copy the code below to and write additional " "tests to uncover bugs in the provided implementation, fixing any bugs you " "find." msgstr "" -"Copia el fragmento de código que aparece más abajo en la página y rellena los métodos y funciones que faltan:" +"Copia el fragmento de código que aparece más abajo en la página a y escribe pruebas adicionales para descubrir y arreglar " +"errores en la implementación proveída." #: src/testing/exercise.md src/testing/solution.md msgid "\"4263 9826 4026 9299\"" @@ -11641,46 +11077,24 @@ msgid "\" 0 0 \"" msgstr "\" 0 0 \"" #: src/welcome-day-4-afternoon.md -msgid "[Error Handling](./error-handling.md) (45 minutes)" -msgstr "[Gestión de errores](./error-handling.md) (45 minutos)" - -#: src/welcome-day-4-afternoon.md -msgid "[Unsafe Rust](./unsafe-rust.md) (1 hour and 5 minutes)" -msgstr "[Rust inseguro](./unsafe-rust.md) (1 hora y 5 minutos)" - -#: src/welcome-day-4-afternoon.md -msgid "Including 10 minute breaks, this session should take about 2 hours" +msgid "" +"Including 10 minute breaks, this session should take about 2 hours and 15 " +"minutes. It contains:" msgstr "" "Contando con los descansos de 10 minutos, la duración prevista de la sesión " -"es de unas 2 horas." - -#: src/error-handling.md -msgid "[Panics](./error-handling/panics.md) (3 minutes)" -msgstr "[Pánicos](./error-handling/panics.md) (3 minutos)" +"es de unas 2 horas y 15 minutos. Contiene:" #: src/error-handling.md -msgid "[Try Operator](./error-handling/try.md) (5 minutes)" -msgstr "[Operador Try](./error-handling/try.md) (5 minutos)" +msgid "Error Trait" +msgstr "Trait `Error`" #: src/error-handling.md -msgid "[Try Conversions](./error-handling/try-conversions.md) (5 minutes)" -msgstr "[Conversiones Try](./error-handling/try-conversions.md) (5 minutos)" +msgid "thiserror and anyhow" +msgstr "`thiserror` y `anyhow`" -#: src/error-handling.md -msgid "[Error Trait](./error-handling/error.md) (5 minutes)" -msgstr "[Trait Error](./error-handling/error.md) (5 minutos)" - -#: src/error-handling.md -msgid "" -"[thiserror and anyhow](./error-handling/thiserror-and-anyhow.md) (5 minutes)" -msgstr "" -"[thiserror y anyhow](./error-handling/thiserror-and-anyhow.md) (5 minutos)" - -#: src/error-handling.md -msgid "" -"[Exercise: Rewriting with Result](./error-handling/exercise.md) (20 minutes)" -msgstr "" -"[Ejercicio: reescribir con Result](./error-handling/exercise.md) (20 minutos)" +#: src/error-handling.md src/error-handling/exercise.md +msgid "Exercise: Rewriting with Result" +msgstr "Ejercicio: reescribir con Result" #: src/error-handling/panics.md msgid "Rust handles fatal errors with a \"panic\"." @@ -11706,11 +11120,11 @@ msgstr "Los _panics_ son un síntoma de que hay fallos en el programa." msgid "Runtime failures like failed bounds checks can panic" msgstr "" "Los fallos del tiempo de ejecución, como las comprobaciones de límites " -"fallidas, pueden activar un pánico." +"fallidas, pueden causar un pánico" #: src/error-handling/panics.md msgid "Assertions (such as `assert!`) panic on failure" -msgstr "Las aserciones (como `assert!`) activan un pánico cuando hay fallos." +msgstr "Las aserciones (como `assert!`) causan un pánico cuando fallan" #: src/error-handling/panics.md msgid "Purpose-specific panics can use the `panic!` macro." @@ -11757,7 +11171,7 @@ msgid "" "`catch_unwind`!" msgstr "" "El catching no es habitual, por lo que recomendamos no implementar " -"excepciones con `catch_unwind`." +"excepciones con `catch_unwind`!" #: src/error-handling/panics.md msgid "" @@ -11771,6 +11185,94 @@ msgstr "" msgid "This does not work if `panic = 'abort'` is set in your `Cargo.toml`." msgstr "No funciona si `panic = 'abort'` está definido en `Cargo.toml`." +#: src/error-handling/result.md +msgid "" +"Our primary mechanism for error handling in Rust is the [`Result`](https://" +"doc.rust-lang.org/stable/std/result/enum.Result.html) enum, which we briefly " +"saw when discussing standard library types." +msgstr "" +"El mecanismo primario para el manejo de errores en Rust es el enum [`Result`]" +"(https://doc.rust-lang.org/stable/std/result/enum.Result.html), que vimos " +"brevemente al discutir los tipos de la biblioteca estándar." + +#: src/error-handling/result.md +msgid "" +"`Result` has two variants: `Ok` which contains the success value, and `Err` " +"which contains an error value of some kind." +msgstr "" +"`Result` tiene dos variantes: `Ok`, que contiene el valor de éxito; y `Err`, " +"que contiene un valor de error de algún tipo." + +#: src/error-handling/result.md +msgid "" +"Whether or not a function can produce an error is encoded in the function's " +"type signature by having the function return a `Result` value." +msgstr "" +"La signatura de tipo de una función indica si puede producir un error, en " +"este caso devolverá un valor `Result`." + +#: src/error-handling/result.md +msgid "" +"Like with `Option`, there is no way to forget to handle an error: You cannot " +"access either the success value or the error value without first pattern " +"matching on the `Result` to check which variant you have. Methods like " +"`unwrap` make it easier to write quick-and-dirty code that doesn't do robust " +"error handling, but means that you can always see in your source code where " +"proper error handling is being skipped." +msgstr "" +"Como con `Option`, no hay manera de olvidarse de manejar un error: no puedes " +"acceder el valor de éxito o el valor de error sin hacer coincidencia de " +"patrones sobre el `Result` para ver que variante tienes. Métodos como " +"`unwrap` hacen que sea mas fácil escribir código rápido-y-sucio que no " +"maneja errores de una forma robusta, pero esto significa que siempre puedes " +"ver en tu código donde no estas manejando errores de la manera propia." + +#: src/error-handling/result.md +msgid "" +"It may be helpful to compare error handling in Rust to error handling " +"conventions that students may be familiar with from other programming " +"languages." +msgstr "" +"Podria ayudar comparar el manejo de errores en Rust con las convenciones de " +"manejo de errores de otros lenguajes que conocen los estudiantes." + +#: src/error-handling/result.md +msgid "Many languages use exceptions, e.g. C++, Java, Python." +msgstr "Muchos lenguajes usan excepciones, e.g. C++, Java, Python." + +#: src/error-handling/result.md +msgid "" +"In most languages with exceptions, whether or not a function can throw an " +"exception is not visible as part of its type signature. This generally means " +"that you can't tell when calling a function if it may throw an exception or " +"not." +msgstr "En la mayoria" + +#: src/error-handling/result.md +msgid "" +"Exceptions generally unwind the call stack, propagating upward until a `try` " +"block is reached. An error originating deep in the call stack may impact an " +"unrelated function further up." +msgstr "" + +#: src/error-handling/result.md +msgid "Error Numbers" +msgstr "" + +#: src/error-handling/result.md +msgid "" +"Some languages have functions return an error number (or some other error " +"value) separately from the successful return value of the function. Examples " +"include C and Go." +msgstr "" + +#: src/error-handling/result.md +msgid "" +"Depending on the language it may be possible to forget to check the error " +"value, in which case you may be accessing an uninitialized or otherwise " +"invalid success value." +msgstr "" + #: src/error-handling/try.md msgid "" "Runtime errors like connection-refused or file-not-found are handled with " @@ -11822,9 +11324,10 @@ msgstr "" "archivo, archivo vacío o archivo con nombre de usuario." #: src/error-handling/try.md +#, fuzzy msgid "" "Note that `main` can return a `Result<(), E>` 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 "" @@ -11864,8 +11367,8 @@ msgid "\"Found no username in {path}\"" msgstr "\"No se ha encontrado ningún nombre de usuario en {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 @@ -12018,6 +11521,10 @@ msgstr "\"No se ha podido abrir {path}\"" msgid "\"Failed to read\"" msgstr "\"No se ha podido leer\"" +#: 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 "\"Nombre de usuario: {username}\"" @@ -12093,10 +11600,6 @@ msgstr "" "y `Option`. Se necesita `use anyhow::Context` para habilitar `.context()` y " "`.with_context()` en esos tipos." -#: src/error-handling/exercise.md -msgid "Exercise: Rewriting with Result" -msgstr "Ejercicio: reescribir con Result" - #: src/error-handling/exercise.md msgid "" "The following implements a very simple parser for an expression language. " @@ -12144,10 +11647,6 @@ msgstr "/// Un número literal.\n" msgid "/// A binary operation.\n" msgstr "/// Una operación binaria.\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 "'_'" @@ -12205,36 +11704,9 @@ msgid "\"Invalid number\"" msgstr "\"Número no válido\"" #: src/unsafe-rust.md -msgid "[Unsafe](./unsafe-rust/unsafe.md) (5 minutes)" -msgstr "[Inseguro](./unsafe-rust/unsafe.md) (5 minutos)" - -#: src/unsafe-rust.md -msgid "" -"[Dereferencing Raw Pointers](./unsafe-rust/dereferencing.md) (10 minutes)" -msgstr "" -"[Desreferenciar punteros sin formato](./unsafe-rust/dereferencing.md) (10 " -"minutos)" - -#: src/unsafe-rust.md -msgid "[Mutable Static Variables](./unsafe-rust/mutable-static.md) (5 minutes)" -msgstr "" -"[Variables estáticas mutables](./unsafe-rust/mutable-static.md) (5 minutos)" - -#: src/unsafe-rust.md -msgid "[Unions](./unsafe-rust/unions.md) (5 minutes)" -msgstr "[Uniones](./unsafe-rust/unions.md) (5 minutos)" - -#: src/unsafe-rust.md -msgid "[Unsafe Functions](./unsafe-rust/unsafe-functions.md) (5 minutes)" -msgstr "[Funciones inseguras](./unsafe-rust/unsafe-functions.md) (5 minutos)" - -#: src/unsafe-rust.md -msgid "[Unsafe Traits](./unsafe-rust/unsafe-traits.md) (5 minutes)" -msgstr "[Traits inseguros](./unsafe-rust/unsafe-traits.md) (5 minutos)" - -#: src/unsafe-rust.md -msgid "[Exercise: FFI Wrapper](./unsafe-rust/exercise.md) (30 minutes)" -msgstr "[Ejercicio: envoltorio de FFI](./unsafe-rust/exercise.md) (30 minutos)" +#, fuzzy +msgid "This segment should take about 1 hour and 5 minutes. It contains:" +msgstr "Esta sección tiene una duración aproximada de 1 hora y 5 minutos." #: src/unsafe-rust/unsafe.md msgid "The Rust language has two parts:" @@ -12331,13 +11803,14 @@ msgid "\"careful!\"" msgstr "\"¡cuidado!\"" #: 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 "" "// Es seguro porque r1 y r2 se han obtenido a partir desde referencias y, " "por lo tanto,\n" @@ -12463,6 +11936,11 @@ msgstr "" "Sin embargo, dado que pueden producirse carreras de datos, no es seguro leer " "y escribir variables estáticas mutables:" +#: 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 "\"CONTADOR: {COUNTER}\"" @@ -12546,7 +12024,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\"" @@ -12556,9 +12033,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 "" "// Es seguro porque los índices están en el orden correcto, dentro de los " "límites del\n" @@ -12574,9 +12052,10 @@ msgid "\"char count: {}\"" msgstr "\"recuento de caracteres: {}\"" #: src/unsafe-rust/unsafe-functions.md -#, fuzzy -msgid "// Undefined behavior if abs misbehaves.\n" -msgstr "No hay comportamientos indefinidos en _runtime_:" +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: {}\"" @@ -12622,8 +12101,9 @@ msgstr "" "/// Los punteros deben ser válidos y estar alineados adecuadamente.\n" #: src/unsafe-rust/unsafe-functions.md -msgid "// Safe because ...\n" -msgstr "// Es seguro porque ...\n" +#, fuzzy +msgid "// SAFETY: ...\n" +msgstr "// ...\n" #: src/unsafe-rust/unsafe-functions.md msgid "\"a = {}, b = {}\"" @@ -12706,7 +12186,8 @@ msgstr "" "relleno.\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 "" "// Es seguro porque u32 tiene una representación definida y no tiene espacio " "de relleno.\n" @@ -13402,7 +12883,8 @@ msgstr "// Es necesario para evitar errores de enlace dinámico.\n" 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\"" @@ -13465,142 +12947,243 @@ msgstr "" msgid "You can create new AIDL servers in Rust." msgstr "Puedes crear servidores de AIDL en Rust." -#: 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 "Interfaces de 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 "La API de tu servicio se declara mediante una interfaz de 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 "/** Birthday service interface. */" -#: 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 "/** Generate a Happy Birthday message. */" -#: 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 no está habilitado de forma predeterminada\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 "" -"Add `vendor_available: true` if your AIDL file is used by a binary in the " -"vendor partition." +"Binder generates a trait corresponding to the interface definition. trait to " +"talk to the service." msgstr "" -"Añade `vendor_available: true` si un binario de la partición del proveedor " -"utiliza tu archivo de AIDL." -#: src/android/aidl/implementation.md +#: src/android/aidl/example-service/service-bindings.md +#, fuzzy +msgid "_Generated trait_:" +msgstr "Rust generado:" + +#: 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 "" +"The generated bindings can be found at `out/soong/.intermediates//`." +msgstr "" + +#: 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 "Implementación del servicio" -#: src/android/aidl/implementation.md +#: src/android/aidl/example-service/service.md msgid "We can now implement the AIDL service:" msgstr "Ahora podemos implementar el servicio de 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 "//! Implementación de la interfaz de AIDL de `IBirthdayService`.\n" - -#: src/android/aidl/implementation.md +#: src/android/aidl/example-service/service.md #, fuzzy msgid "/// The `IBirthdayService` implementation.\n" msgstr "/// Implementación del método HelloWorld::hello.\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 "\"Feliz cumpleaños, {name}, te han caído {years} años\"." -#: 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 "Servidor de 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 "Por último, podemos crear un servidor que exponga el servicio:" -#: 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 "//! Servicio de felicitación cumpleaños.\n" -#: src/android/aidl/server.md +#: src/android/aidl/example-service/server.md msgid "/// Entry point for birthday service.\n" msgstr "/// Punto de entrada del servicio de felicitación cumpleaños.\n" -#: src/android/aidl/server.md +#: src/android/aidl/example-service/server.md msgid "\"Failed to register service\"" msgstr "\"No se ha podido registrar el servicio\"" -#: 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 "// Para evitar errores de enlaces dinámicos.\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 "Ahora podemos crear, insertar e iniciar el servicio:" -#: src/android/aidl/deploy.md +#: src/android/aidl/example-service/deploy.md msgid "" "```shell\n" "m birthday_server\n" @@ -13618,61 +13201,65 @@ 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 "Comprueba que el servicio funciona en otra terminal:" -#: src/android/aidl/deploy.md +#: src/android/aidl/example-service/deploy.md msgid "You can also call the service with `service call`:" msgstr "También puedes llamar al servicio con `service call`:" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "AIDL Client" msgstr "Cliente de 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 "" "Por último, podemos crear un cliente de Rust para nuestro nuevo servicio." -#: 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 "/// Conecta con el servicio de felicitación de cumpleaños.\n" - -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "/// Call the birthday service.\n" msgstr "/// Llama al servicio de felicitación cumpleaños.\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 "" "\"No se ha podido conectar con el servicio de felicitación de cumpleaños.\"" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md +#, fuzzy +msgid "// Call the service.\n" +msgstr "/// Llama al servicio de felicitación cumpleaños.\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 "Ten en cuenta que el cliente no depende de `libbirthdayservice`." -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "Build, push, and run the client on your device:" msgstr "Compila, inserta y ejecuta el cliente en tu dispositivo:" -#: src/android/aidl/client.md +#: src/android/aidl/example-service/client.md msgid "" "```shell\n" "m birthday_client\n" @@ -13688,7 +13275,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:" @@ -13696,5992 +13311,5746 @@ msgstr "" "Ampliemos la API con más funciones. Queremos que los clientes puedan indicar " "una lista de líneas para la tarjeta de cumpleaños:" -#: 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 "" -"Utiliza el crate `log` para que se registre automáticamente en `logcat` (en " -"el dispositivo) o `stdout` (en el host):" -#: 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 "//! Demo de registros de 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 "/// Registra un saludo.\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 "\"Iniciando programa.\"" +#: 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 "\"Todo es correcto.\"" +#: src/android/aidl/types.md +msgid "Working With AIDL Types" +msgstr "" -#: src/android/logging.md -msgid "\"Something went wrong!\"" -msgstr "\"Se ha producido un error.\"" +#: 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 "Compila, inserta y ejecuta el binario en tu dispositivo:" +#: 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 "Los registros se muestran en `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:" +#: src/android/aidl/types/primitives.md +msgid "Primitive types map (mostly) idiomatically:" msgstr "" -"Rust admite sin problemas la interoperabilidad con otros lenguajes. Esto " -"significa que puedes hacer lo siguiente:" -#: src/android/interoperability.md -msgid "Call Rust functions from other languages." -msgstr "Llamar a funciones de Rust desde otros lenguajes." +#: src/android/aidl/types/primitives.md +#, fuzzy +msgid "AIDL Type" +msgstr "AIDL" -#: src/android/interoperability.md -msgid "Call functions written in other languages from Rust." -msgstr "Llamar a funciones escritas en otros lenguajes desde Rust." +#: src/android/aidl/types/primitives.md src/android/aidl/types/arrays.md +#: src/android/interoperability/cpp/type-mapping.md +#, fuzzy +msgid "Rust Type" +msgstr "Rust by Example" -#: 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 "" -"Cuando llamas a funciones en otro lenguaje, se dice que estás usando una " -"_interfaz de función externa_, también denominada FFI." -#: src/android/interoperability/with-c.md -msgid "Interoperability with C" -msgstr "Interoperabilidad con 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 admite vincular archivos de objetos con una convención de llamada de C. " -"Del mismo modo, puedes exportar funciones de Rust y llamarlas desde C." -#: src/android/interoperability/with-c.md -msgid "You can do it by hand if you want:" -msgstr "Si quieres, puedes hacerlo de forma manual:" +#: 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 "// Un número mayor de 7 bytes no es válido.\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 "" -"Ya lo hemos visto en el ejercicio [Envoltorio de FFI seguro](../../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 "" -"Esto supone un conocimiento completo de la plataforma objetivo. No se " -"recomienda para producción." -#: src/android/interoperability/with-c.md -msgid "We will look at better options next." -msgstr "A continuación, estudiaremos otras opciones mejores." +#: src/android/aidl/types/primitives.md +msgid "`int`" +msgstr "" -#: src/android/interoperability/with-c/bindgen.md -msgid "Using Bindgen" -msgstr "Uso de 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 "" -"La herramienta [bindgen](https://rust-lang.github.io/rust-bindgen/" -"introduction.html) puede generar automáticamente enlaces desde un archivo de " -"encabezado de C." -#: src/android/interoperability/with-c/bindgen.md -msgid "First create a small C library:" -msgstr "En primer lugar, crea una biblioteca de C pequeña:" +#: 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 "\"| ¡Feliz cumpleaños, %s!\\n\"" +#: src/android/aidl/types/arrays.md +#, fuzzy +msgid "Position" +msgstr "Descripción" -#: src/android/interoperability/with-c/bindgen.md -msgid "\"| Congratulations with the %i years!\\n\"" -msgstr "\"| ¡Enhorabuena por cumplir %i años!\\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 "Añade lo siguiente a tu archivo `Android.bp`:" +#: src/android/aidl/types/arrays.md +#, fuzzy +msgid "`&[T]`" +msgstr "Slices: `&[T]`" -#: 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 "" -"Crea un archivo de encabezado de envoltorio para la biblioteca (no es " -"estrictamente necesario en este ejemplo):" -#: 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 "Ahora puedes generar automáticamente los enlaces:" +#: 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 "Por último, podemos utilizar los enlaces de nuestro programa de 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 "//! Implementación de la interfaz de AIDL de `IBirthdayService`.\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 "//! Implementación de la interfaz de AIDL de `IBirthdayService`.\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 "/// Llama al servicio de felicitación cumpleaños.\n" -#: src/android/interoperability/with-c/bindgen.md -msgid "//! Bindgen demo.\n" -msgstr "//! Demo de 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 "" -"// SEGURIDAD: es seguro llamar a `print_card` con un puntero `card` válido.\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 "" -"Por último, podemos ejecutar pruebas generadas automáticamente para " -"comprobar que los enlaces funcionan:" -#: 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 "\"ninguno\"" +#: 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 "// Archivo generado, se omite la ejecución de lint\n" +#: src/android/aidl/types/file-descriptor.md +#, fuzzy +msgid "\"{name}\"" +msgstr "\"Hola {name}\"" -#: src/android/interoperability/with-c/rust.md -msgid "Calling Rust" -msgstr "Llamar a 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 "Es fácil exportar las funciones y los tipos de Rust a 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 "//! Demo de FFI de Rust.\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 "/// Analiza los números.\n" +#: src/android/aidl/types/file-descriptor.md +#, fuzzy +msgid "\"Invalid file handle\"" +msgstr "\"Longitud no válida\"" -#: src/android/interoperability/with-c/rust.md -msgid "\"x ({x}) is smallest!\"" -msgstr "\"¡x ({x}) es el menor!\"" +#: 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}) probablemente sea mayor que 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 "Rust en Android" -#: 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 "Ahora podemos llamarlo desde un binario de 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 "//! Biblioteca de saludos.\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 +#: 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 "Ahora puedes generar automáticamente los enlaces:" + +#: src/android/testing.md #, fuzzy +msgid "The output looks like this:" +msgstr "El enfoque general es el siguiente:" + +#: src/android/testing.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" +"```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\\]\" inhabilita la modificación de nombres habitual de Rust, " -"por lo que el símbolo exportado será el nombre de la función. También puedes " -"utilizar `#[export_name = \"some_name\"]` para especificar el nombre que " -"quieras." -#: src/android/interoperability/cpp.md +#: src/android/testing/googletest.md +#, fuzzy 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 "" -"El [crate CXX](https://cxx.rs/) permite una interoperabilidad segura entre " -"Rust y C++." +"[googletest](https://docs.rs/googletest): biblioteca completa de aserción de " +"pruebas en la tradición de GoogleTest para C++." -#: src/android/interoperability/cpp.md -msgid "The overall approach looks like this:" -msgstr "El enfoque general es el siguiente:" +#: 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 se basa en una descripción de las firmas de la función que se mostrarán " -"de un lenguaje a otro. Proporcionas esta descripción mediante bloques " -"externos en un módulo de Rust anotado con la macro de atributo `#[cxx::" -"bridge]`." - -#: 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 "// Estructuras compartidas con campos visibles para ambos lenguajes.\n" - -#: src/android/interoperability/cpp/bridge.md -#: src/android/interoperability/cpp/generated-cpp.md -msgid "// Rust types and signatures exposed to C++.\n" -msgstr "// Tipos y firmas de Rust expuestos a C++.\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 "// Tipos y firmas de C++ y expuestos a Rust.\n" +"Si cambiamos el último elemento a `\"!\"`, la prueba dará error y aparecerá " +"un mensaje de error estructurado que señala cuál es el fallo:" -#: 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/testing/googletest.md +msgid "" +"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 "" +"GoogleTest no forma parte de Rust Playground, por lo que debes llevar a cabo " +"este ejemplo en un entorno local. Usa `cargo add googletest` para añadirlo " +"rápidamente a un proyecto de Cargo que ya tengas." -#: src/android/interoperability/cpp/bridge.md -#: src/android/interoperability/cpp/cpp-bridge.md -msgid "\"include/blobstore.h\"" -msgstr "\"include/blobstore.h\"" +#: src/android/testing/googletest.md +msgid "" +"The `use googletest::prelude::*;` line imports a number of [commonly used " +"macros and types](https://docs.rs/googletest/latest/googletest/prelude/index." +"html)." +msgstr "" +"La línea `use googletest::prelude::*;` importa una serie de [macros y tipos " +"habituales](https://docs.rs/googletest/latest/googletest/prelude/index.html)." -#: src/android/interoperability/cpp/bridge.md -msgid "The bridge is generally declared in an `ffi` module within your crate." -msgstr "Bridge se declara generalmente en un módulo `ffi` dentro del crate." +#: 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://github.com/mainmatter/rust-advanced-testing-" +"workshop), 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/bridge.md +#: src/android/testing/googletest.md +#, fuzzy 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." +"A particularly nice feature is that mismatches in multi-line strings are " +"shown as a diff:" msgstr "" -"A partir de las declaraciones que se han hecho en el módulo bridge, CXX " -"generará definiciones de funciones o tipos de Rust y C++ que coincidan para " -"exponer esos elementos a ambos lenguajes." +"Una característica muy interesante es que las discrepancias en las cadenas " +"que contienen varias líneas se muestran como un diff:" -#: 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)." +"\"Memory safety found,\\n\\\n" +" Rust's strong typing guides the way,\\n\\\n" +" Secure code you'll write.\"" msgstr "" -"Para ver el código de Rust generado, usa [cargo-expand](https://github.com/" -"dtolnay/cargo-expand) para ver la macro de procedimiento desplegada. En la " -"mayoría de los ejemplos, se utilizaría `cargo expand ::ffi` para desplegar " -"únicamente el módulo `ffi` (aunque esta acción no se aplica a los proyectos " -"de Android)." +"\"Se ha encontrado la seguridad de la memoria,\\n\\\n" +" la potente escritura de Rust guía el camino,\\n\\\n" +" protege el código que vayas a escribir.\"" -#: src/android/interoperability/cpp/bridge.md -msgid "To view the generated C++ code, look in `target/cxxbridge`." -msgstr "Para ver el código C++ generado, consulta `target/cxxbridge`." +#: src/android/testing/googletest.md +msgid "" +"\"Memory safety found,\\n\\\n" +" Rust's silly humor guides the way,\\n\\\n" +" Secure code you'll write.\"" +msgstr "" +"\"Se ha encontrado seguridad en la memoria,\\n\\\n" +" el divertido sentido del humor de Rust guía el camino,\\n\\\n" +" protege el código que vayas a escribir.\"" -#: src/android/interoperability/cpp/rust-bridge.md -msgid "Rust Bridge Declarations" -msgstr "Declaraciones Bridge en Rust" +#: src/android/testing/googletest.md +msgid "shows a color-coded diff (colors not shown here):" +msgstr "muestra un diff con colores (colores que no se muestran aquí):" -#: src/android/interoperability/cpp/rust-bridge.md -msgid "// Opaque type\n" -msgstr "// Tipo opaco\n" +#: src/android/testing/googletest.md +msgid "" +"The crate is a Rust port of [GoogleTest for C++](https://google.github.io/" +"googletest/)." +msgstr "" +"El crate es un puerto de Rust de [GoogleTest para C++](https://google.github." +"io/googletest/)." -#: src/android/interoperability/cpp/rust-bridge.md -msgid "// Method on `MyType`\n" -msgstr "// Método en `MyType`\n" +#: src/android/testing/mocking.md +msgid "" +"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 "" +"[Mockall](https://docs.rs/mockall/) es una biblioteca que se usa para hacer " +"simulaciones. Debes refactorizar tu código para usar traits, con los que " +"podrás hacer simulaciones:" -#: src/android/interoperability/cpp/rust-bridge.md +#: src/android/testing/mocking.md #, fuzzy -msgid "// Free function\n" -msgstr "Funciones" - -#: src/android/interoperability/cpp/rust-bridge.md msgid "" -"Items declared in the `extern \"Rust\"` reference items that are in scope in " -"the parent module." +"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 "" -"Elementos declarados en los elementos de referencia `extern de \"Rust\" que " -"se encuentran dentro del ámbito del módulo superior." +"Estos consejos son útiles para Android (AOSP), donde Mockall es la " +"biblioteca de simulaciones recomendada. Hay otras [bibliotecas de simulación " +"disponibles en crates.io](https://crates.io/keywords/mock), especialmente en " +"el área de servicios de simulación de HTTP. Las demás bibliotecas de " +"simulación funcionan de forma similar a Mockall, lo que significa que " +"facilitan la obtención de una implementación simulada de un trait " +"determinado." -#: src/android/interoperability/cpp/rust-bridge.md +#: src/android/testing/mocking.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." +"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 "" -"El generador de código CXX utiliza las secciones `extern de \"Rust\"` para " -"generar un archivo de encabezado de C++ que contenga las declaraciones de C+" -"+ correspondientes. El encabezado generado tiene la misma ruta que el " -"archivo de origen de Rust que contiene el patrón bridge, excepto con la " -"extensión de archivo .rs.h." +"Ten en cuenta que las simulaciones son algo _polémicas_, ya que te permiten " +"aislar por completo una prueba de sus dependencias. El resultado inmediato " +"es una ejecución de pruebas más rápida y estable. Por otro lado, las " +"simulaciones se pueden configurar de forma incorrecta y devuelven un " +"resultado diferente del que se obtendría con las dependencias reales." -#: src/android/interoperability/cpp/generated-cpp.md -msgid "Results in (roughly) the following C++:" +#: src/android/testing/mocking.md +msgid "" +"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 "" -"Los resultados son (aproximadamente) los que se muestran a continuación en C+" -"+:" - -#: src/android/interoperability/cpp/cpp-bridge.md -msgid "C++ Bridge Declarations" -msgstr "Declaraciones Bridge en C++" +"Si es posible, te recomendamos que uses las dependencias reales. Por " +"ejemplo, muchas bases de datos te permiten configurar un backend en la " +"memoria. Es decir, en tus pruebas obtendrás el comportamiento correcto y, " +"además, son rápidas y se limpiarán de forma automática tras las pruebas." -#: src/android/interoperability/cpp/cpp-bridge.md -msgid "Results in (roughly) the following Rust:" +#: src/android/testing/mocking.md +msgid "" +"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 "" -"Los resultados son (aproximadamente) los que se muestran a continuación en " -"Rust:" +"Del mismo modo, muchos frameworks web te permiten iniciar un servidor en " +"proceso que se vincula a un puerto aleatorio en `localhost`. Siempre es " +"mejor utilizar esta opción en lugar de simular el framework, ya que te ayuda " +"a hacer pruebas con el código en el entorno real." -#: src/android/interoperability/cpp/cpp-bridge.md -msgid "\"org$blobstore$cxxbridge1$new_blobstore_client\"" -msgstr "\"org$blobstore$cxxbridge1$new_blobstore_client\"" +#: src/android/testing/mocking.md +msgid "" +"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 "" +"Mockall no forma parte de Rust Playground, por lo que debes ejecutar este " +"ejemplo en un entorno local. Usa `cargo add modelall` para añadir de forma " +"rápida Mockall a un proyecto de Cargo." -#: src/android/interoperability/cpp/cpp-bridge.md -msgid "\"org$blobstore$cxxbridge1$BlobstoreClient$put\"" -msgstr "\"org$blobstore$cxxbridge1$BlobstoreClient$put\"" +#: 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 tiene muchas más funciones. En concreto, puedes configurar " +"expectativas en función de los argumentos. Aquí utilizamos el ejemplo para " +"simular un gato que tiene hambre 3 horas después de que le hayan dado de " +"comer:" -#: src/android/interoperability/cpp/cpp-bridge.md +#: src/android/testing/mocking.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++." +"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 "" -"El programador no tiene que asegurar que las firmas que ha introducido son " -"precisas. CXX lleva a cabo aserciones estáticas en las que las firmas se " -"corresponden exactamente con lo que se declara en C++." +"Puedes utilizar `.times(n)` para limitar el número de veces que se puede " +"llamar a un método de simulación a `n`. Si no se cumple, la simulación " +"activará un pánico automáticamente cuando se elimine." -#: src/android/interoperability/cpp/cpp-bridge.md +#: src/android/logging.md msgid "" -"`unsafe extern` blocks allow you to declare C++ functions that are safe to " -"call from Rust." +"You should use the `log` crate to automatically log to `logcat` (on-device) " +"or `stdout` (on-host):" msgstr "" -"Los bloques `unsafe extern` permiten declarar funciones de C++ que se pueden " -"llamar de forma segura desde Rust." +"Utiliza el crate `log` para que se registre automáticamente en `logcat` (en " +"el dispositivo) o `stdout` (en el host):" -#: 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/logging.md +msgid "_hello_rust_logs/Android.bp_:" +msgstr "_hello_rust_logs/Android.bp_:" -#: src/android/interoperability/cpp/shared-types.md -msgid "Only C-like (unit) enums are supported." -msgstr "Solo se admiten enums tipo C (unidad)." +#: src/android/logging.md +msgid "\"hello_rust_logs\"" +msgstr "\"hello_rust_logs\"" -#: src/android/interoperability/cpp/shared-types.md -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." -msgstr "" -"Un número limitado de traits es compatible con `#[derive()]` en los tipos " -"compartidos. La función correspondiente también se genera para el código C+" -"+; por ejemplo, si derivas `Hash`, también genera una implementación de " -"`std::hash` para el tipo de C++ correspondiente." +#: src/android/logging.md +msgid "\"liblog_rust\"" +msgstr "\"liblog_rust\"" -#: src/android/interoperability/cpp/shared-enums.md -msgid "Generated Rust:" -msgstr "Rust generado:" +#: src/android/logging.md +msgid "\"liblogger\"" +msgstr "\"liblogger\"" -#: src/android/interoperability/cpp/shared-enums.md -msgid "Generated C++:" -msgstr "C++ generado:" +#: src/android/logging.md +msgid "_hello_rust_logs/src/main.rs_:" +msgstr "_hello_rust_logs/src/main.rs_:" -#: src/android/interoperability/cpp/shared-enums.md +#: src/android/logging.md +msgid "//! Rust logging demo.\n" +msgstr "//! Demo de registros de Rust.\n" + +#: src/android/logging.md +msgid "/// Logs a greeting.\n" +msgstr "/// Registra un saludo.\n" + +#: src/android/logging.md +msgid "\"rust\"" +msgstr "\"rust\"" + +#: src/android/logging.md +msgid "\"Starting program.\"" +msgstr "\"Iniciando programa.\"" + +#: src/android/logging.md +msgid "\"Things are going fine.\"" +msgstr "\"Todo es correcto.\"" + +#: src/android/logging.md +msgid "\"Something went wrong!\"" +msgstr "\"Se ha producido un error.\"" + +#: 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 "Compila, inserta y ejecuta el binario en tu dispositivo:" + +#: src/android/logging.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." +"```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 "" -"En Rust, el código generado para las enums compartidas es en realidad una " -"estructura que envuelve un valor numérico. Esto se debe a que no es un " -"comportamiento indefinido en C++ para que una clase de enum contenga un " -"valor distinto de todas las variantes enumeradas y nuestra representación en " -"Rust debe tener el mismo comportamiento." - -#: src/android/interoperability/cpp/rust-result.md -msgid "\"fallible1 requires depth > 0\"" -msgstr "\"fallible1 requiere una profundidad > 0\"" +"```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/rust-result.md -msgid "\"Success!\"" -msgstr "\"Correcto.\"" +#: src/android/logging.md +msgid "The logs show up in `adb logcat`:" +msgstr "Los registros se muestran en `adb logcat`:" -#: src/android/interoperability/cpp/rust-result.md +#: src/android/interoperability.md msgid "" -"Rust functions that return `Result` are translated to exceptions on the C++ " -"side." +"Rust has excellent support for interoperability with other languages. This " +"means that you can:" msgstr "" -"Las funciones de Rust que devuelven `Result` se convierten en excepciones en " -"C++." +"Rust admite sin problemas la interoperabilidad con otros lenguajes. Esto " +"significa que puedes hacer lo siguiente:" -#: src/android/interoperability/cpp/rust-result.md +#: src/android/interoperability.md +msgid "Call Rust functions from other languages." +msgstr "Llamar a funciones de Rust desde otros lenguajes." + +#: src/android/interoperability.md +msgid "Call functions written in other languages from Rust." +msgstr "Llamar a funciones escritas en otros lenguajes desde Rust." + +#: src/android/interoperability.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." +"When you call functions in a foreign language we say that you're using a " +"_foreign function interface_, also known as FFI." msgstr "" -"La excepción que se genera siempre será del tipo `rust::Error`, que muestra " -"principalmente una forma de obtener la cadena del mensaje de error. El " -"mensaje de error procede de la implementación `Display` del tipo de error." +"Cuando llamas a funciones en otro lenguaje, se dice que estás usando una " +"_interfaz de función externa_, también denominada FFI." -#: src/android/interoperability/cpp/rust-result.md +#: src/android/interoperability/with-c.md +msgid "Interoperability with C" +msgstr "Interoperabilidad con C" + +#: src/android/interoperability/with-c.md msgid "" -"A panic unwinding from Rust to C++ will always cause the process to " -"immediately terminate." +"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 "" -"Si un pánico pasa de Rust a C++, el proceso siempre finalizará " -"inmediatamente." +"Rust admite vincular archivos de objetos con una convención de llamada de C. " +"Del mismo modo, puedes exportar funciones de Rust y llamarlas desde C." -#: src/android/interoperability/cpp/cpp-exception.md -msgid "\"example/include/example.h\"" -msgstr "\"example/include/example.h\"" +#: src/android/interoperability/with-c.md +msgid "You can do it by hand if you want:" +msgstr "Si quieres, puedes hacerlo de forma manual:" -#: src/android/interoperability/cpp/cpp-exception.md -msgid "\"Error: {}\"" -msgstr "\"Error: {}\"" +#: src/android/interoperability/with-c.md +msgid "// SAFETY: `abs` doesn't have any safety requirements.\n" +msgstr "" -#: src/android/interoperability/cpp/cpp-exception.md +#: src/android/interoperability/with-c.md +msgid "\"{x}, {abs_x}\"" +msgstr "\"{x}, {abs_x}\"" + +#: src/android/interoperability/with-c.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." +"We already saw this in the [Safe FFI Wrapper exercise](../../exercises/day-3/" +"safe-ffi-wrapper.md)." msgstr "" -"Las funciones de C++ declaradas para devolver un `Result` detectarán " -"cualquier excepción en C++ y la devolverán como un valor `Err` a la función " -"de llamada de Rust." +"Ya lo hemos visto en el ejercicio [Envoltorio de FFI seguro](../../exercises/" +"day-3/safe-ffi-wrapper.md)." -#: src/android/interoperability/cpp/cpp-exception.md +#: src/android/interoperability/with-c.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." +"This assumes full knowledge of the target platform. Not recommended for " +"production." msgstr "" -"Si se produce una excepción desde una función externa de \"C++\" no " -"declarada por el bridge de CXX para devolver `Result`, el programa llamará a " -"`std::terminate` de C++. El comportamiento equivale a la misma excepción que " -"se genera mediante una función `noexcept`de C++." +"Esto supone un conocimiento completo de la plataforma objetivo. No se " +"recomienda para producción." -#: src/android/interoperability/cpp/type-mapping.md -#, fuzzy -msgid "Rust Type" -msgstr "Rust by Example" +#: src/android/interoperability/with-c.md +msgid "We will look at better options next." +msgstr "A continuación, estudiaremos otras opciones mejores." -#: src/android/interoperability/cpp/type-mapping.md -#, fuzzy -msgid "C++ Type" -msgstr "Ejemplo en C++" +#: src/android/interoperability/with-c/bindgen.md +msgid "Using Bindgen" +msgstr "Uso de Bindgen" -#: src/android/interoperability/cpp/type-mapping.md -#, fuzzy -msgid "`rust::String`" -msgstr "`std::string`" +#: 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." +msgstr "" +"La herramienta [bindgen](https://rust-lang.github.io/rust-bindgen/" +"introduction.html) puede generar automáticamente enlaces desde un archivo de " +"encabezado de C." -#: src/android/interoperability/cpp/type-mapping.md -msgid "`&str`" -msgstr "`&str`" +#: src/android/interoperability/with-c/bindgen.md +msgid "First create a small C library:" +msgstr "En primer lugar, crea una biblioteca de C pequeña:" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`rust::Str`" -msgstr "`rust::Str`" +#: src/android/interoperability/with-c/bindgen.md +msgid "_interoperability/bindgen/libbirthday.h_:" +msgstr "_interoperability/bindgen/libbirthday.h_:" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`CxxString`" -msgstr "CxxString" +#: src/android/interoperability/with-c/bindgen.md +msgid "_interoperability/bindgen/libbirthday.c_:" +msgstr "_interoperability/bindgen/libbirthday.c_:" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`std::string`" -msgstr "`std::string`" +#: src/android/interoperability/with-c/bindgen.md +msgid "" +msgstr "" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`&[T]`/`&mut [T]`" -msgstr "`&[T]`/`&mut [T]`" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday.h\"" +msgstr "\"libbirthday.h\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`rust::Slice`" -msgstr "`rust::Slice`" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"+--------------\\n\"" +msgstr "\"+--------------\\n\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`rust::Box`" -msgstr "`rust::Box`" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"| Happy Birthday %s!\\n\"" +msgstr "\"| ¡Feliz cumpleaños, %s!\\n\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`UniquePtr`" -msgstr "`UniquePtr`" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"| Congratulations with the %i years!\\n\"" +msgstr "\"| ¡Enhorabuena por cumplir %i años!\\n\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`std::unique_ptr`" -msgstr "`std::unique_ptr`" +#: src/android/interoperability/with-c/bindgen.md +msgid "Add this to your `Android.bp` file:" +msgstr "Añade lo siguiente a tu archivo `Android.bp`:" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`Vec`" -msgstr "`Vec`" - -#: src/android/interoperability/cpp/type-mapping.md -msgid "`rust::Vec`" -msgstr "`rust::Vec`" +#: src/android/interoperability/with-c/bindgen.md +msgid "_interoperability/bindgen/Android.bp_:" +msgstr "_interoperability/bindgen/Android.bp_:" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`CxxVector`" -msgstr "`CxxVector`" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday\"" +msgstr "\"libbirthday\"" -#: src/android/interoperability/cpp/type-mapping.md -msgid "`std::vector`" -msgstr "`std::vector`" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday.c\"" +msgstr "\"libbirthday.c\"" -#: src/android/interoperability/cpp/type-mapping.md +#: src/android/interoperability/with-c/bindgen.md msgid "" -"These types can be used in the fields of shared structs and the arguments " -"and returns of extern functions." +"Create a wrapper header file for the library (not strictly needed in this " +"example):" msgstr "" -"Estos tipos se pueden utilizar en los campos de estructura compartidas y en " -"los argumentos e instrucciones de retorno de las funciones externas." +"Crea un archivo de encabezado de envoltorio para la biblioteca (no es " +"estrictamente necesario en este ejemplo):" -#: src/android/interoperability/cpp/type-mapping.md -msgid "" -"Note that Rust's `String` does not map directly to `std::string`. There are " -"a few reasons for this:" -msgstr "" -"Ten en cuenta que `String` de Rust no se cruza directamente con `std::" -"string`. Puede haber varios motivos:" +#: src/android/interoperability/with-c/bindgen.md +msgid "_interoperability/bindgen/libbirthday_wrapper.h_:" +msgstr "_interoperability/bindgen/libbirthday_wrapper.h_:" -#: src/android/interoperability/cpp/type-mapping.md -msgid "" -"`std::string` does not uphold the UTF-8 invariant that `String` requires." -msgstr "" -"`std::string` no mantiene la invariante de UTF-8 que requiere `String`." +#: src/android/interoperability/with-c/bindgen.md +msgid "You can now auto-generate the bindings:" +msgstr "Ahora puedes generar automáticamente los enlaces:" -#: src/android/interoperability/cpp/type-mapping.md -msgid "" -"The two types have different layouts in memory and so can't be passed " -"directly between languages." -msgstr "" -"Los dos tipos tienen diseños diferentes en la memoria y, por lo tanto, no se " -"pueden transferir directamente entre lenguajes." +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday_bindgen\"" +msgstr "\"libbirthday_bindgen\"" -#: 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." -msgstr "" -"`std::string` requiere constructores de movimiento que no coincidan con la " -"semántica de movimiento de Rust, por lo que `std::string` no se puede " -"transferir a Rust mediante un valor." +#: src/android/interoperability/with-c/bindgen.md +msgid "\"birthday_bindgen\"" +msgstr "\"birthday_bindgen\"" -#: 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 "Rust en Android" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday_wrapper.h\"" +msgstr "\"libbirthday_wrapper.h\"" -#: src/android/interoperability/cpp/android-build-cpp.md -msgid "" -"Create a `cc_library_static` to build the C++ library, including the CXX " -"generated header and source file." -msgstr "" -"Crea un `cc_library_static` para compilar la biblioteca de C++, incluidos el " -"encabezado y el archivo de origen generados por CXX." +#: src/android/interoperability/with-c/bindgen.md +msgid "\"bindings\"" +msgstr "\"bindings\"" -#: 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/bindgen.md +msgid "Finally, we can use the bindings in our Rust program:" +msgstr "Por último, podemos utilizar los enlaces de nuestro programa de Rust:" -#: src/android/interoperability/cpp/android-build-cpp.md -msgid "\"cxx_test.cpp\"" -msgstr "\"cxx_test.cpp\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"print_birthday_card\"" +msgstr "\"print_birthday_card\"" -#: src/android/interoperability/cpp/android-build-cpp.md -msgid "\"cxx-bridge-header\"" -msgstr "\"cxx-bridge-header\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"main.rs\"" +msgstr "\"main.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/android/interoperability/with-c/bindgen.md +msgid "_interoperability/bindgen/main.rs_:" +msgstr "_interoperability/bindgen/main.rs_:" -#: 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 "//! Bindgen demo.\n" +msgstr "//! Demo de Bindgen.\n" -#: 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." +"// 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 "" -"Señala que `libcxx_test_bridge_header` y `libcxx_test_bridge_code` son las " -"dependencias de los enlaces de C++ generados por CXX. En la siguiente " -"diapositiva veremos cómo se configuran." -#: src/android/interoperability/cpp/android-build-cpp.md +#: src/android/interoperability/with-c/bindgen.md msgid "" -"Note that you also need to depend on the `cxx-bridge-header` library in " -"order to pull in common CXX definitions." +"```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 "" -"Ten en cuenta que también debes depender de la biblioteca `cxx-bridge-" -"header` para obtener definiciones de CXX habituales." +"```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/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." +#: src/android/interoperability/with-c/bindgen.md +msgid "Finally, we can run auto-generated tests to ensure the bindings work:" msgstr "" -"Los documentos completos sobre el uso de CXX en Android se pueden encontrar " -"en [los documentos de Android](https://source.android.com/docs/setup/build/" -"rust/building-rust-modules/android-rust-patterns#rust-cpp-interop-using-" -"cxx). Puedes compartir ese enlace con la clase para que los participantes " -"sepan dónde pueden buscar estas instrucciones de ahora en adelante." +"Por último, podemos ejecutar pruebas generadas automáticamente para " +"comprobar que los enlaces funcionan:" -#: 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 "" -"Crea dos genrule, una para generar el encabezado de CXX y otra para generar " -"el archivo de origen de CXX. Luego se usarán como entradas a " -"`cc_library_static`." +#: src/android/interoperability/with-c/bindgen.md +msgid "\"libbirthday_bindgen_test\"" +msgstr "\"libbirthday_bindgen_test\"" -#: 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 "" -"// Genera un encabezado de C++ que contenga los enlaces de C++\n" -"// a las funciones exportadas de Rust en lib.rs.\n" +#: src/android/interoperability/with-c/bindgen.md +msgid "\":libbirthday_bindgen\"" +msgstr "\":libbirthday_bindgen\"" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "\"cxxbridge\"" -msgstr "\"cxxbridge\"" +#: src/android/interoperability/with-c/bindgen.md +msgid "\"none\"" +msgstr "\"ninguno\"" -#: 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 "// Generated file, skip linting\n" +msgstr "// Archivo generado, se omite la ejecución de lint\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/rust.md +msgid "Calling Rust" +msgstr "Llamar a Rust" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "\"lib.rs.h\"" -msgstr "\"lib.rs.h\"" +#: src/android/interoperability/with-c/rust.md +msgid "Exporting Rust functions and types to C is easy:" +msgstr "Es fácil exportar las funciones y los tipos de Rust a C:" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "// Generate the C++ code that Rust calls into.\n" -msgstr "// Genera el código C++ al que llama Rust.\n" +#: src/android/interoperability/with-c/rust.md +msgid "_interoperability/rust/libanalyze/analyze.rs_" +msgstr "_interoperability/rust/libanalyze/analyze.rs_" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "\"$(location cxxbridge) $(in) > $(out)\"" -msgstr "\"$(location cxxbridge) $(in) > $(out)\"" +#: src/android/interoperability/with-c/rust.md +msgid "//! Rust FFI demo.\n" +msgstr "//! Demo de FFI de Rust.\n" -#: src/android/interoperability/cpp/android-cpp-genrules.md -msgid "\"lib.rs.cc\"" -msgstr "\"lib.rs.cc\"" +#: src/android/interoperability/with-c/rust.md +msgid "/// Analyze the numbers.\n" +msgstr "/// Analiza los números.\n" -#: 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 "" -"La herramienta `cxxbridge` es una herramienta independiente que genera el " -"lado C++ del módulo de bridge. Se incluye en Android y está disponible como " -"herramienta de Soong." +#: src/android/interoperability/with-c/rust.md +msgid "\"x ({x}) is smallest!\"" +msgstr "\"¡x ({x}) es el menor!\"" -#: src/android/interoperability/cpp/android-cpp-genrules.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." -msgstr "" -"Por convención, si el archivo de origen de Rust es `lib.rs`, el archivo de " -"encabezado se llamará `lib.rs.h` y el archivo de origen, `lib.rs.cc`. Sin " -"embargo, esta convención en cuanto a la nomenclatura no es obligatoria." +#: src/android/interoperability/with-c/rust.md +msgid "\"y ({y}) is probably larger than x ({x})\"" +msgstr "\"y ({y}) probablemente sea mayor que x ({x})\"" -#: src/android/interoperability/cpp/android-build-rust.md -msgid "" -"Create a `rust_binary` that depends on `libcxx` and your `cc_library_static`." -msgstr "" -"Crea un `rust_binary` que dependa de `libcxx` y de tu `cc_library_static`." +#: src/android/interoperability/with-c/rust.md +msgid "_interoperability/rust/libanalyze/analyze.h_" +msgstr "_interoperability/rust/libanalyze/analyze.h_" -#: src/android/interoperability/cpp/android-build-rust.md -msgid "\"cxx_test\"" -msgstr "\"cxx_test\"" +#: src/android/interoperability/with-c/rust.md +msgid "_interoperability/rust/libanalyze/Android.bp_" +msgstr "_interoperability/rust/libanalyze/Android.bp_" -#: src/android/interoperability/cpp/android-build-rust.md -msgid "\"libcxx\"" -msgstr "\"libcxx\"" +#: src/android/interoperability/with-c/rust.md +msgid "\"libanalyze_ffi\"" +msgstr "\"libanalyze_ffi\"" -#: src/android/interoperability/java.md -msgid "Interoperability with Java" -msgstr "Interoperabilidad con Java" +#: src/android/interoperability/with-c/rust.md +msgid "\"analyze_ffi\"" +msgstr "\"analyze_ffi\"" -#: 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 puede cargar objetos compartidos a través de la [interfaz nativa de " -"Java (JNI)](https://es.wikipedia.org/wiki/Java_Native_Interface). [El crate " -"`jni`](https://docs.rs/jni/) permite crear una biblioteca compatible." +#: src/android/interoperability/with-c/rust.md +msgid "\"analyze.rs\"" +msgstr "\"analyze.rs\"" -#: src/android/interoperability/java.md -msgid "First, we create a Rust function to export to Java:" -msgstr "En primer lugar, creamos una función de Rust para exportar a Java:" +#: src/android/interoperability/with-c/rust.md +msgid "We can now call this from a C binary:" +msgstr "Ahora podemos llamarlo desde un binario de C:" -#: src/android/interoperability/java.md -msgid "_interoperability/java/src/lib.rs_:" -msgstr "_interoperability/java/src/lib.rs_:" +#: src/android/interoperability/with-c/rust.md +msgid "_interoperability/rust/analyze/main.c_" +msgstr "_interoperability/rust/analyze/main.c_" -#: src/android/interoperability/java.md -msgid "//! Rust <-> Java FFI demo.\n" -msgstr "//! Rust <-> Demo de FFI de Java.\n" +#: src/android/interoperability/with-c/rust.md +msgid "\"analyze.h\"" +msgstr "\"analyze.h\"" -#: src/android/interoperability/java.md -msgid "/// HelloWorld::hello method implementation.\n" -msgstr "/// Implementación del método HelloWorld::hello.\n" +#: src/android/interoperability/with-c/rust.md +msgid "_interoperability/rust/analyze/Android.bp_" +msgstr "_interoperability/rust/analyze/Android.bp_" -#: src/android/interoperability/java.md -msgid "\"system\"" -msgstr "\"system\"" +#: src/android/interoperability/with-c/rust.md +msgid "\"analyze_numbers\"" +msgstr "\"analyze_numbers\"" -#: src/android/interoperability/java.md -msgid "\"Hello, {input}!\"" -msgstr "\"¡Hola, {input}!\"" +#: src/android/interoperability/with-c/rust.md +msgid "\"main.c\"" +msgstr "\"main.c\"" -#: src/android/interoperability/java.md -msgid "_interoperability/java/Android.bp_:" -msgstr "_interoperability/java/Android.bp_:" +#: src/android/interoperability/with-c/rust.md +#, fuzzy +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" +"```" +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/java.md -msgid "\"libhello_jni\"" -msgstr "\"libhello_jni\"" +#: src/android/interoperability/with-c/rust.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." +msgstr "" +"\"#\\[no_mangle\\]\" inhabilita la modificación de nombres habitual de Rust, " +"por lo que el símbolo exportado será el nombre de la función. También puedes " +"utilizar `#[export_name = \"some_name\"]` para especificar el nombre que " +"quieras." -#: src/android/interoperability/java.md -msgid "\"hello_jni\"" -msgstr "\"hello_jni\"" +#: src/android/interoperability/cpp.md +msgid "" +"The [CXX crate](https://cxx.rs/) makes it possible to do safe " +"interoperability between Rust and C++." +msgstr "" +"El [crate CXX](https://cxx.rs/) permite una interoperabilidad segura entre " +"Rust y C++." -#: src/android/interoperability/java.md -msgid "\"libjni\"" -msgstr "\"libjni\"" +#: src/android/interoperability/cpp.md +msgid "The overall approach looks like this:" +msgstr "El enfoque general es el siguiente:" -#: src/android/interoperability/java.md -#, fuzzy -msgid "We then call this function from Java:" -msgstr "Por último, podemos llamar a esta función desde Java:" +#: src/android/interoperability/cpp/bridge.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." +msgstr "" +"CXX se basa en una descripción de las firmas de la función que se mostrarán " +"de un lenguaje a otro. Proporcionas esta descripción mediante bloques " +"externos en un módulo de Rust anotado con la macro de atributo `#[cxx::" +"bridge]`." -#: src/android/interoperability/java.md -msgid "_interoperability/java/HelloWorld.java_:" -msgstr "_interoperability/java/HelloWorld.java_:" +#: src/android/interoperability/cpp/bridge.md +msgid "\"org::blobstore\"" +msgstr "\"org::blobstore\"" -#: src/android/interoperability/java.md -msgid "\"helloworld_jni\"" -msgstr "\"helloworld_jni\"" +#: src/android/interoperability/cpp/bridge.md +msgid "// Shared structs with fields visible to both languages.\n" +msgstr "// Estructuras compartidas con campos visibles para ambos lenguajes.\n" -#: src/android/interoperability/java.md -msgid "\"HelloWorld.java\"" -msgstr "\"HelloWorld.java\"" +#: src/android/interoperability/cpp/bridge.md +#: src/android/interoperability/cpp/generated-cpp.md +msgid "// Rust types and signatures exposed to C++.\n" +msgstr "// Tipos y firmas de Rust expuestos a C++.\n" -#: src/android/interoperability/java.md -msgid "\"HelloWorld\"" -msgstr "\"HelloWorld\"" +#: 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/java.md -msgid "Finally, you can build, sync, and run the binary:" -msgstr "Ahora puedes compilar, sincronizar y ejecutar el binario:" +#: src/android/interoperability/cpp/bridge.md +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "// C++ types and signatures exposed to Rust.\n" +msgstr "// Tipos y firmas de C++ y expuestos a Rust.\n" -#: 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 "" -"Este es un ejercicio de grupo: escogeremos uno de los proyectos con los que " -"se esté trabajando e intentaremos integrar Rust en él. Algunas sugerencias:" +#: 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/exercises/android/morning.md -msgid "Call your AIDL service with a client written in Rust." -msgstr "Llama a tu servicio de AIDL con un cliente escrito en Rust." +#: src/android/interoperability/cpp/bridge.md +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "\"include/blobstore.h\"" +msgstr "\"include/blobstore.h\"" -#: src/exercises/android/morning.md -msgid "Move a function from your project to Rust and call it." -msgstr "Mueve una función desde tu proyecto a Rust y llámala." +#: src/android/interoperability/cpp/bridge.md +msgid "The bridge is generally declared in an `ffi` module within your crate." +msgstr "Bridge se declara generalmente en un módulo `ffi` dentro del crate." -#: src/exercises/android/morning.md +#: src/android/interoperability/cpp/bridge.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." +"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 "" -"Aquí la solución es abierta, ya que depende de que alguno de los asistentes " -"tenga un fragmento de código que se pueda convertir en Rust sobre la marcha." - -#: src/chromium.md -msgid "Welcome to Rust in Chromium" -msgstr "Te Damos la Bienvenida a Rust en Chromium" +"A partir de las declaraciones que se han hecho en el módulo bridge, CXX " +"generará definiciones de funciones o tipos de Rust y C++ que coincidan para " +"exponer esos elementos a ambos lenguajes." -#: src/chromium.md +#: src/android/interoperability/cpp/bridge.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." +"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 "" -"Rust es compatible con bibliotecas de terceros en Chromium, con código " -"pegamento propio para conectar Rust y el código de C++ de Chromium ya " -"existente." +"Para ver el código de Rust generado, usa [cargo-expand](https://github.com/" +"dtolnay/cargo-expand) para ver la macro de procedimiento desplegada. En la " +"mayoría de los ejemplos, se utilizaría `cargo expand ::ffi` para desplegar " +"únicamente el módulo `ffi` (aunque esta acción no se aplica a los proyectos " +"de Android)." -#: 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 "" -"Hoy vamos a llamar a Rust para que haga algo divertido con las cadenas. Si " -"tienes una esquina del código donde se muestra una cadena UTF8 al usuario, " -"no dudes en seguir estas instrucciones en tu parte del código base en lugar " -"de la parte exacta de la que hablamos." +#: src/android/interoperability/cpp/bridge.md +msgid "To view the generated C++ code, look in `target/cxxbridge`." +msgstr "Para ver el código C++ generado, consulta `target/cxxbridge`." -#: 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 "" -"Asegúrate de que puedes compilar y ejecutar Chromium. Cualquier plataforma y " -"conjunto de marcas de compilación es apto, siempre que tu código sea " -"relativamente reciente (posición de commit 1223636 en adelante, " -"correspondiente a noviembre del 2023):" +#: src/android/interoperability/cpp/rust-bridge.md +msgid "Rust Bridge Declarations" +msgstr "Declaraciones Bridge en Rust" -#: src/chromium/setup.md -msgid "" -"(A component, debug build is recommended for quickest iteration time. This " -"is the default!)" -msgstr "" -"(Se recomienda una versión de depuración de componentes para que el tiempo " -"de iteración sea más rápido. Esta es la opción predeterminada)." - -#: 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 "" -"Consulta [cómo compilar Chromium](https://www.chromium.org/developers/how-" -"tos/get-the-code/) si aún no lo has hecho. Advertencia: el proceso de " -"configuración para compilar Chromium puede tardar." +#: src/android/interoperability/cpp/rust-bridge.md +msgid "// Opaque type\n" +msgstr "// Tipo opaco\n" -#: src/chromium/setup.md -msgid "It's also recommended that you have Visual Studio code installed." -msgstr "Se recomienda que tengas instalado Visual Studio Code." +#: src/android/interoperability/cpp/rust-bridge.md +msgid "// Method on `MyType`\n" +msgstr "// Método en `MyType`\n" -#: src/chromium/setup.md -msgid "About the exercises" -msgstr "Información sobre los ejercicios" +#: src/android/interoperability/cpp/rust-bridge.md +#, fuzzy +msgid "// Free function\n" +msgstr "Funciones" -#: src/chromium/setup.md +#: src/android/interoperability/cpp/rust-bridge.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." +"Items declared in the `extern \"Rust\"` reference items that are in scope in " +"the parent module." msgstr "" -"Esta parte del curso consta de una serie de ejercicios que se complementan " -"entre sí. Las iremos repartiendo a lo largo del curso en lugar de hacerlos " -"todo al final. Si no tienes tiempo para completar una parte concreta, no te " -"preocupes, podrás ponerte al día en la siguiente clase." +"Elementos declarados en los elementos de referencia `extern de \"Rust\" que " +"se encuentran dentro del ámbito del módulo superior." -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/rust-bridge.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." +"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 "" -"La comunidad de Rust suele usar `cargo` y bibliotecas de [crates.io](https://" -"crates.io/). Chromium se compila usando `gn` y `ninja`, además de un " -"conjunto seleccionado de dependencias." - -#: src/chromium/cargo.md -msgid "When writing code in Rust, your choices are:" -msgstr "A la hora de escribir código en Rust, hay disponibles varias opciones:" +"El generador de código CXX utiliza las secciones `extern de \"Rust\"` para " +"generar un archivo de encabezado de C++ que contenga las declaraciones de C+" +"+ correspondientes. El encabezado generado tiene la misma ruta que el " +"archivo de origen de Rust que contiene el patrón bridge, excepto con la " +"extensión de archivo .rs.h." -#: src/chromium/cargo.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." +#: src/android/interoperability/cpp/generated-cpp.md +msgid "Results in (roughly) the following C++:" msgstr "" -"Usar `gn` y `ninja` con la ayuda de las plantillas de `//build/rust/*.gni` " -"(por ejemplo, `rust_static_library`, que veremos más adelante). Se usan la " -"cadena de herramientas y los crates auditados de Chromium." +"Los resultados son (aproximadamente) los que se muestran a continuación en C+" +"+:" -#: src/chromium/cargo.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)" +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "C++ Bridge Declarations" +msgstr "Declaraciones Bridge en C++" + +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "Results in (roughly) the following Rust:" msgstr "" -"Usar `cargo`, pero [restringiendo el uso de la cadena de herramientas y los " -"crates auditados de Chromium](https://chromium.googlesource.com/chromium/src/" -"+/refs/heads/main/docs/rust.md#Using-cargo)." +"Los resultados son (aproximadamente) los que se muestran a continuación en " +"Rust:" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "\"org$blobstore$cxxbridge1$new_blobstore_client\"" +msgstr "\"org$blobstore$cxxbridge1$new_blobstore_client\"" + +#: src/android/interoperability/cpp/cpp-bridge.md +msgid "\"org$blobstore$cxxbridge1$BlobstoreClient$put\"" +msgstr "\"org$blobstore$cxxbridge1$BlobstoreClient$put\"" + +#: src/android/interoperability/cpp/cpp-bridge.md msgid "" -"Use `cargo`, trusting a [toolchain](https://rustup.rs/) and/or [crates " -"downloaded from the internet](https://crates.io/)" +"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 "" -"Usa `cargo` con una [cadena de herramientas](https://rustup.rs/) o [crates " -"descargados de Internet](https://crates.io/)." +"El programador no tiene que asegurar que las firmas que ha introducido son " +"precisas. CXX lleva a cabo aserciones estáticas en las que las firmas se " +"corresponden exactamente con lo que se declara en C++." -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/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." +"`unsafe extern` blocks allow you to declare C++ functions that are safe to " +"call from Rust." msgstr "" -"A partir de ahora, nos centraremos en `gn` y `ninja`, ya que así es como se " -"puede compilar el código de Rust en el navegador Chromium. De igual forma, " -"Cargo es una parte importante del ecosistema de Rust y deberías conservarlo " -"en tu caja de herramientas." +"Los bloques `unsafe extern` permiten declarar funciones de C++ que se pueden " +"llamar de forma segura desde Rust." -#: src/chromium/cargo.md -msgid "Mini exercise" -msgstr "Ejercicio rápido" +#: 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/chromium/cargo.md -msgid "Split into small groups and:" -msgstr "Formad grupos pequeños para:" +#: src/android/interoperability/cpp/shared-types.md +msgid "Only C-like (unit) enums are supported." +msgstr "Solo se admiten enums tipo C (unidad)." -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/shared-types.md msgid "" -"Brainstorm scenarios where `cargo` may offer an advantage and assess the " -"risk profile of these scenarios." +"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 "" -"Hacer una lluvia de ideas sobre situaciones en las que `cargo` pueda ofrecer " -"ventajas y evaluar el perfil de riesgo." +"Un número limitado de traits es compatible con `#[derive()]` en los tipos " +"compartidos. La función correspondiente también se genera para el código C+" +"+; por ejemplo, si derivas `Hash`, también genera una implementación de " +"`std::hash` para el tipo de C++ correspondiente." -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/shared-enums.md +msgid "Generated Rust:" +msgstr "Rust generado:" + +#: src/android/interoperability/cpp/shared-enums.md +msgid "Generated C++:" +msgstr "C++ generado:" + +#: src/android/interoperability/cpp/shared-enums.md msgid "" -"Discuss which tools, libraries, and groups of people need to be trusted when " -"using `gn` and `ninja`, offline `cargo`, etc." +"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 "" -"Debatir en qué herramientas, bibliotecas y grupos de personas hay que " -"confiar al usar `gn` y `ninja`, `cargo` offline, etc." +"En Rust, el código generado para las enums compartidas es en realidad una " +"estructura que envuelve un valor numérico. Esto se debe a que no es un " +"comportamiento indefinido en C++ para que una clase de enum contenga un " +"valor distinto de todas las variantes enumeradas y nuestra representación en " +"Rust debe tener el mismo comportamiento." -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/rust-result.md +msgid "\"fallible1 requires depth > 0\"" +msgstr "\"fallible1 requiere una profundidad > 0\"" + +#: src/android/interoperability/cpp/rust-result.md +msgid "\"Success!\"" +msgstr "\"Correcto.\"" + +#: src/android/interoperability/cpp/rust-result.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." +"Rust functions that return `Result` are translated to exceptions on the C++ " +"side." msgstr "" -"Pide a los participantes que eviten mirar las notas del orador antes de " -"completar el ejercicio. Suponiendo que todas las personas que hacen el curso " -"están en la misma sala, pídeles que hablen en grupos pequeños de 3 a 4 " -"personas." +"Las funciones de Rust que devuelven `Result` se convierten en excepciones en " +"C++." -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/rust-result.md msgid "" -"Notes/hints related to the first part of the exercise (\"scenarios where " -"Cargo may offer an advantage\"):" +"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 "" -"Notas y sugerencias relacionadas con la primera parte del ejercicio " -"(\"situaciones en las que Cargo puede ofrecer ventajas\"):" +"La excepción que se genera siempre será del tipo `rust::Error`, que muestra " +"principalmente una forma de obtener la cadena del mensaje de error. El " +"mensaje de error procede de la implementación `Display` del tipo de error." -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/rust-result.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.)." +"A panic unwinding from Rust to C++ will always cause the process to " +"immediately terminate." msgstr "" -"Es genial que al escribir una herramienta o crear prototipos de una parte de " -"Chromium se pueda acceder al extenso ecosistema de bibliotecas crates.io. " -"Hay un crate para casi cualquier cosa y suelen ser muy fáciles de usar " -"(`clap` para el análisis de la línea de comandos, `serde` para la " -"serialización y deserialización a/desde varios formatos, `itertools` para " -"trabajar con iteradores, etc.)." +"Si un pánico pasa de Rust a C++, el proceso siempre finalizará " +"inmediatamente." -#: src/chromium/cargo.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 "" -"`cargo` makes it easy to try a library (just add a single line to `Cargo." -"toml` and start writing code)" +"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 "" -"`cargo` permite probar una biblioteca fácilmente (solo hay que añadir una " -"línea a `Cargo.toml` y empezar a escribir el código)." +"Las funciones de C++ declaradas para devolver un `Result` detectarán " +"cualquier excepción en C++ y la devolverán como un valor `Err` a la función " +"de llamada de Rust." -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/cpp-exception.md msgid "" -"It may be worth comparing how CPAN helped make `perl` a popular choice. Or " -"comparing with `python` + `pip`." +"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 "" -"Merece la pena comparar cómo la CPAN ayudó a que `perl` fuera una opción " -"popular o compararlo con `python` + `pip`." +"Si se produce una excepción desde una función externa de \"C++\" no " +"declarada por el bridge de CXX para devolver `Result`, el programa llamará a " +"`std::terminate` de C++. El comportamiento equivale a la misma excepción que " +"se genera mediante una función `noexcept`de C++." -#: src/chromium/cargo.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)." -msgstr "" -"La experiencia de desarrollo no solo es agradable gracias a las herramientas " -"principales de Rust (por ejemplo, al usar `rustup` para cambiar a una " -"versión diferente de `rustc` cuando se prueba un crate que necesita " -"funcionar en nightly, stable actual y antiguas versiones de stable), sino " -"también a un ecosistema de herramientas de terceros (por ejemplo, Mozilla " -"proporciona `cargo vet` para optimizar y compartir auditorías de seguridad; " -"el crate `criterion` ofrece un método optimizado para ejecutar comparativas)." +#: src/android/interoperability/cpp/type-mapping.md +#, fuzzy +msgid "C++ Type" +msgstr "Ejemplo en C++" -#: src/chromium/cargo.md -msgid "" -"`cargo` makes it easy to add a tool via `cargo install --locked cargo-vet`." -msgstr "" -"`cargo` permite añadir fácilmente una herramienta mediante `cargoinstall --" -"locked cargo-vet`." +#: src/android/interoperability/cpp/type-mapping.md +#, fuzzy +msgid "`rust::String`" +msgstr "`std::string`" -#: src/chromium/cargo.md -msgid "It may be worth comparing with Chrome Extensions or VScode extensions." -msgstr "" -"Merece la pena compararlo con las extensiones de Chrome o con las de VScode." +#: src/android/interoperability/cpp/type-mapping.md +msgid "`&str`" +msgstr "`&str`" -#: src/chromium/cargo.md -msgid "" -"Broad, generic examples of projects where `cargo` may be the right choice:" -msgstr "" -"Ejemplos generales y genéricos de proyectos en los que `cargo` puede ser la " -"opción más adecuada:" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`rust::Str`" +msgstr "`rust::Str`" -#: src/chromium/cargo.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)." -msgstr "" -"Sorprendentemente, Rust se está volviendo cada vez más popular en el sector " -"por su función de escritura de herramientas de línea de comandos. La " -"amplitud y la ergonomía de las bibliotecas son similares a las de Python, " -"pero son más sólidas (gracias al sistema de tipos enriquecido) y funcionan " -"más rápido (como lenguaje compilado en lugar de interpretado)." +#: src/android/interoperability/cpp/type-mapping.md +msgid "`CxxString`" +msgstr "CxxString" -#: 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 "" -"Para participar en el ecosistema de Rust, es necesario usar herramientas " -"estándar de Rust, como Cargo. Las bibliotecas que quieran recibir " -"contribuciones externas y actuar fuera de Chromium (por ejemplo, en entornos " -"de desarrollo de Bazel o Android/Soong) deberían utilizar Cargo." +#: src/android/interoperability/cpp/type-mapping.md +msgid "`std::string`" +msgstr "`std::string`" -#: src/chromium/cargo.md -msgid "Examples of Chromium-related projects that are `cargo`\\-based:" -msgstr "" -"Ejemplos de proyectos relacionados con Chromium que se basan en `cargo`\\:" +#: src/android/interoperability/cpp/type-mapping.md +msgid "`&[T]`/`&mut [T]`" +msgstr "`&[T]`/`&mut [T]`" -#: 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` (experimentado en otras partes de Google que ha dado " -"lugar a PRs con mejoras de rendimiento)." +#: src/android/interoperability/cpp/type-mapping.md +msgid "`rust::Slice`" +msgstr "`rust::Slice`" -#: src/chromium/cargo.md -msgid "Fontations libraries like `font-types`" -msgstr "Bibliotecas de fuentes, como `font-types`." +#: src/android/interoperability/cpp/type-mapping.md +msgid "`rust::Box`" +msgstr "`rust::Box`" -#: 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 "" -"La herramienta `gnrt` (la veremos más adelante en el curso), que depende de " -"`clap` para el análisis de la línea de comandos y de `toml` para los " -"archivos de configuración." +#: src/android/interoperability/cpp/type-mapping.md +msgid "`UniquePtr`" +msgstr "`UniquePtr`" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/type-mapping.md +msgid "`std::unique_ptr`" +msgstr "`std::unique_ptr`" + +#: src/android/interoperability/cpp/type-mapping.md +msgid "`rust::Vec`" +msgstr "`rust::Vec`" + +#: src/android/interoperability/cpp/type-mapping.md +msgid "`CxxVector`" +msgstr "`CxxVector`" + +#: src/android/interoperability/cpp/type-mapping.md +msgid "`std::vector`" +msgstr "`std::vector`" + +#: src/android/interoperability/cpp/type-mapping.md msgid "" -"Disclaimer: a unique reason for using `cargo` was unavailability of `gn` " -"when building and bootstrapping Rust standard library when building Rust " -"toolchain.)" +"These types can be used in the fields of shared structs and the arguments " +"and returns of extern functions." msgstr "" -"Aclaración: una razón principal para usar `cargo` es que `gn` no está " -"disponible al compilar e iniciar la biblioteca estándar de Rust cuando se " -"compila su cadena de herramientas." +"Estos tipos se pueden utilizar en los campos de estructura compartidas y en " +"los argumentos e instrucciones de retorno de las funciones externas." -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/type-mapping.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`.)" +"Note that Rust's `String` does not map directly to `std::string`. There are " +"a few reasons for this:" msgstr "" -"`run_gnrt.py` usa la copia de Chromium de `cargo` y `rustc`. `gnrt` depende " -"de las bibliotecas de terceros descargadas de Internet. `run_gnrt.py` pide a " -"`cargo` que solo se permita el contenido `--locked` a través de `Cargo.lock`." +"Ten en cuenta que `String` de Rust no se cruza directamente con `std::" +"string`. Puede haber varios motivos:" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/type-mapping.md msgid "" -"Students may identify the following items as being implicitly or explicitly " -"trusted:" +"`std::string` does not uphold the UTF-8 invariant that `String` requires." msgstr "" -"Los participantes pueden tratar de identificar si los siguientes elementos " -"son de confianza implícita o explícita:" +"`std::string` no mantiene la invariante de UTF-8 que requiere `String`." -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/type-mapping.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" +"The two types have different layouts in memory and so can't be passed " +"directly between languages." msgstr "" -"`rustc` (el compilador de Rust), que a su vez depende de las bibliotecas " -"LLVM, el compilador Clang, las fuentes `rustc` (obtenidas de GitHub y " -"revisadas por el equipo de compilación de Rust), y el compilador binario de " -"Rust descargado para el bootstrapping." +"Los dos tipos tienen diseños diferentes en la memoria y, por lo tanto, no se " +"pueden transferir directamente entre lenguajes." -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/type-mapping.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`)" +"`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 "" -"`rustup` (merece la pena destacar que `rustup` se desarrolla en la misma " -"organización que `rustc`, https://github.com/rust-lang/)." +"`std::string` requiere constructores de movimiento que no coincidan con la " +"semántica de movimiento de Rust, por lo que `std::string` no se puede " +"transferir a Rust mediante un valor." -#: src/chromium/cargo.md -msgid "`cargo`, `rustfmt`, etc." -msgstr "`cargo`, `rustfmt`, etc." +#: 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 "Rust en Android" -#: src/chromium/cargo.md +#: src/android/interoperability/cpp/android-build-cpp.md msgid "" -"Various internal infrastructure (bots that build `rustc`, system for " -"distributing the prebuilt toolchain to Chromium engineers, etc.)" +"Create a `cc_library_static` to build the C++ library, including the CXX " +"generated header and source file." msgstr "" -"Varias infraestructuras internas (bots que compilan `rustc`, sistemas para " -"distribuir la cadena de herramientas precompiladas a los ingenieros de " -"Chromium, etc.)" +"Crea un `cc_library_static` para compilar la biblioteca de C++, incluidos el " +"encabezado y el archivo de origen generados por CXX." -#: src/chromium/cargo.md -msgid "Cargo tools like `cargo audit`, `cargo vet`, etc." -msgstr "Herramientas de Cargo, como `cargo audit`, `cargo vet`, etc." +#: 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/cargo.md -msgid "" -"Rust libraries vendored into `//third_party/rust` (audited by " -"security@chromium.org)" -msgstr "" -"Bibliotecas de Rust incluidas en `//third_party/rust` (auditoría de " -"security@chromium.org)." +#: src/android/interoperability/cpp/android-build-cpp.md +msgid "\"cxx_test.cpp\"" +msgstr "\"cxx_test.cpp\"" -#: src/chromium/cargo.md -msgid "Other Rust libraries (some niche, some quite popular and commonly used)" -msgstr "" -"Otras bibliotecas de Rust (algunas de nicho, otras bastante populares y de " -"uso común)." +#: src/android/interoperability/cpp/android-build-cpp.md +msgid "\"cxx-bridge-header\"" +msgstr "\"cxx-bridge-header\"" -#: src/chromium/policy.md -msgid "Chromium Rust policy" -msgstr "Política de Chromium Rust" +#: 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/policy.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 "" -"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)." +"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 "" -"Chromium aún no permite usar Rust propio, excepto en casos excepcionales, " -"según lo aprobado por [Area Tech Leads](https://source.chromium.org/chromium/" -"chromium/src/+/main:ATL_OWNERS)." +"Señala que `libcxx_test_bridge_header` y `libcxx_test_bridge_code` son las " +"dependencias de los enlaces de C++ generados por CXX. En la siguiente " +"diapositiva veremos cómo se configuran." -#: src/chromium/policy.md +#: src/android/interoperability/cpp/android-build-cpp.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." +"Note that you also need to depend on the `cxx-bridge-header` library in " +"order to pull in common CXX definitions." msgstr "" -"La política de Chromium sobre bibliotecas de terceros se describe [aquí]" -"(https://chromium.googlesource.com/chromium/src/+/main/docs/" -"adding_to_third_party.md#rust). Se permite el uso de Rust para bibliotecas " -"de terceros en algunos casos, incluido si son la mejor opción en cuanto al " -"rendimiento o seguridad." +"Ten en cuenta que también debes depender de la biblioteca `cxx-bridge-" +"header` para obtener definiciones de CXX habituales." -#: src/chromium/policy.md +#: src/android/interoperability/cpp/android-build-cpp.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." +"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 "" -"Muy pocas bibliotecas de Rust exponen directamente una API de C o C++, por " -"lo que casi todas estas bibliotecas necesitarán una pequeña parte de código " -"pegamento propio." +"Los documentos completos sobre el uso de CXX en Android se pueden encontrar " +"en [los documentos de Android](https://source.android.com/docs/setup/build/" +"rust/building-rust-modules/android-rust-patterns#rust-cpp-interop-using-" +"cxx). Puedes compartir ese enlace con la clase para que los participantes " +"sepan dónde pueden buscar estas instrucciones de ahora en adelante." -#: src/chromium/policy.md +#: src/android/interoperability/cpp/android-cpp-genrules.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" -"```" +"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 "" -"```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" -"```" +"Crea dos genrule, una para generar el encabezado de CXX y otra para generar " +"el archivo de origen de CXX. Luego se usarán como entradas a " +"`cc_library_static`." -#: src/chromium/policy.md +#: src/android/interoperability/cpp/android-cpp-genrules.md msgid "" -"First-party Rust glue code for a particular third-party crate should " -"normally be kept in `third_party/rust///wrapper`." +"// Generate a C++ header containing the C++ bindings\n" +"// to the Rust exported functions in lib.rs.\n" msgstr "" -"El código pegamento propio de Rust para un crate de terceros concreto " -"normalmente debe guardarse en `third_party/rust///wrapper`." +"// Genera un encabezado de C++ que contenga los enlaces de C++\n" +"// a las funciones exportadas de Rust en lib.rs.\n" -#: src/chromium/policy.md -msgid "Because of this, today's course will be heavily focused on:" -msgstr "Por este motivo, el curso de hoy se centrará en los siguientes temas:" +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"cxxbridge\"" +msgstr "\"cxxbridge\"" -#: src/chromium/policy.md -msgid "Bringing in third-party Rust libraries (\"crates\")" -msgstr "Incorporación de bibliotecas Rust de terceros (\"crates\")." +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"$(location cxxbridge) $(in) --header > $(out)\"" +msgstr "\"$(location cxxbridge) $(in) --header > $(out)\"" -#: src/chromium/policy.md -msgid "Writing glue code to be able to use those crates from Chromium C++." -msgstr "" -"Escribir código pegamento para poder usar esos crates desde Chromium C++." +#: src/android/interoperability/cpp/android-cpp-genrules.md +#: src/android/interoperability/cpp/android-build-rust.md +msgid "\"lib.rs\"" +msgstr "\"lib.rs\"" -#: src/chromium/policy.md -msgid "If this policy changes over time, the course will evolve to keep up." -msgstr "" -"Si esta política cambia con el tiempo, el curso irá evolucionando para " -"adaptarse al cambio." +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"lib.rs.h\"" +msgstr "\"lib.rs.h\"" -#: src/chromium/build-rules.md -msgid "Build rules" -msgstr "Reglas de Compilación (_Build_)" +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "// Generate the C++ code that Rust calls into.\n" +msgstr "// Genera el código C++ al que llama Rust.\n" -#: 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 "" -"El código de Rust se suele compilar con `cargo`. Chromium se compila con " -"`gn` y `ninja` para aumentar la eficiencia. Sus reglas estáticas permiten el " -"máximo paralelismo. Rust no es una excepción." +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"$(location cxxbridge) $(in) > $(out)\"" +msgstr "\"$(location cxxbridge) $(in) > $(out)\"" -#: src/chromium/build-rules.md -msgid "Adding Rust code to Chromium" -msgstr "Añadir código de Rust a Chromium" +#: src/android/interoperability/cpp/android-cpp-genrules.md +msgid "\"lib.rs.cc\"" +msgstr "\"lib.rs.cc\"" -#: src/chromium/build-rules.md +#: src/android/interoperability/cpp/android-cpp-genrules.md msgid "" -"In some existing Chromium `BUILD.gn` file, declare a `rust_static_library`:" +"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 "" -"En algunos archivos `BUILD.gn` de Chromium, declara una " -"`rust_static_library`:" +"La herramienta `cxxbridge` es una herramienta independiente que genera el " +"lado C++ del módulo de bridge. Se incluye en Android y está disponible como " +"herramienta de Soong." -#: src/chromium/build-rules.md +#: src/android/interoperability/cpp/android-cpp-genrules.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" -"```" +"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 "" -"```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" -"```" +"Por convención, si el archivo de origen de Rust es `lib.rs`, el archivo de " +"encabezado se llamará `lib.rs.h` y el archivo de origen, `lib.rs.cc`. Sin " +"embargo, esta convención en cuanto a la nomenclatura no es obligatoria." -#: src/chromium/build-rules.md +#: src/android/interoperability/cpp/android-build-rust.md msgid "" -"You can also add `deps` on other Rust targets. Later we'll use this to " -"depend upon third party code." +"Create a `rust_binary` that depends on `libcxx` and your `cc_library_static`." msgstr "" -"También puedes añadir `deps` en otros segmentos de Rust. Más adelante, lo " -"usaremos en función del código de terceros." +"Crea un `rust_binary` que dependa de `libcxx` y de tu `cc_library_static`." -#: 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 "" -"Debes especificar _tanto_ la raíz del crate _como_ una lista completa de " -"recursos. `crate_root` es el archivo proporcionado al compilador de Rust que " -"representa el archivo raíz de la unidad de compilación, que suele ser `lib." -"rs`. `sources` es una lista completa de todos los archivos de origen que " -"necesita `ninja` para determinar cuándo es necesario compilar de nuevo." +#: src/android/interoperability/cpp/android-build-rust.md +msgid "\"cxx_test\"" +msgstr "\"cxx_test\"" -#: 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 "" -"(No existe `source_set` en Rust porque un crate completo ya es una unidad de " -"compilación. Una `static_library` es la unidad más pequeña)." +#: src/android/interoperability/cpp/android-build-rust.md +msgid "\"libcxx\"" +msgstr "\"libcxx\"" -#: src/chromium/build-rules.md +#: src/android/interoperability/java.md +msgid "Interoperability with Java" +msgstr "Interoperabilidad con Java" + +#: src/android/interoperability/java.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." +"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 "" -"Puede que los participantes se pregunten por qué necesitamos una plantilla " -"gn en vez de usar [la compatibilidad integrada de gn para las bibliotecas " -"estáticas de Rust](https://gn.googlesource.com/gn/+/main/docs/reference." -"md#func_static_library). La respuesta es que esta plantilla es compatible " -"con la interoperabilidad de CXX, las funciones de Rust y las pruebas " -"unitarias, algunas de las cuales usaremos más adelante." +"Java puede cargar objetos compartidos a través de la [interfaz nativa de " +"Java (JNI)](https://es.wikipedia.org/wiki/Java_Native_Interface). [El crate " +"`jni`](https://docs.rs/jni/) permite crear una biblioteca compatible." -#: src/chromium/build-rules/unsafe.md -msgid "Including `unsafe` Rust Code" -msgstr "Incluir código de Rust `unsafe`" +#: src/android/interoperability/java.md +msgid "First, we create a Rust function to export to Java:" +msgstr "En primer lugar, creamos una función de Rust para exportar a Java:" -#: src/chromium/build-rules/unsafe.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.)" -msgstr "" -"El código de Rust inseguro está prohibido en `rust_static_library` de forma " -"predeterminada, por lo que no se podrá compilar. Si necesitas código de Rust " -"inseguro, añade `allow_unsafe = true` al elemento de destino de gn. (Más " -"adelante en el curso veremos circunstancias en las que es necesario hacerlo)." +#: src/android/interoperability/java.md +msgid "_interoperability/java/src/lib.rs_:" +msgstr "_interoperability/java/src/lib.rs_:" -#: src/chromium/build-rules/unsafe.md +#: src/android/interoperability/java.md +msgid "//! Rust <-> Java FFI demo.\n" +msgstr "//! Rust <-> Demo de FFI de Java.\n" + +#: src/android/interoperability/java.md +msgid "/// HelloWorld::hello method implementation.\n" +msgstr "/// Implementación del método HelloWorld::hello.\n" + +#: src/android/interoperability/java.md +msgid "\"system\"" +msgstr "\"system\"" + +#: src/android/interoperability/java.md +msgid "\"Hello, {input}!\"" +msgstr "\"¡Hola, {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 +#, fuzzy +msgid "We then call this function from Java:" +msgstr "Por último, podemos llamar a esta función desde 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 "Ahora puedes compilar, sincronizar y ejecutar el binario:" + +#: src/exercises/android/morning.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" -"```" +"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 "" -"```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" -"```" +"Este es un ejercicio de grupo: escogeremos uno de los proyectos con los que " +"se esté trabajando e intentaremos integrar Rust en él. Algunas sugerencias:" -#: src/chromium/build-rules/depending.md -msgid "Simply add the above target to the `deps` of some Chromium C++ target." -msgstr "" -"Solo tienes que añadir el elemento de destino que aparece arriba a los " -"`deps` de algún elemento de destino de Chromium C++." +#: src/exercises/android/morning.md +msgid "Call your AIDL service with a client written in Rust." +msgstr "Llama a tu servicio de AIDL con un cliente escrito en Rust." -#: src/chromium/build-rules/depending.md +#: src/exercises/android/morning.md +msgid "Move a function from your project to Rust and call it." +msgstr "Mueve una función desde tu proyecto a Rust y llámala." + +#: src/exercises/android/morning.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" -"```" +"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 "" -"```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" -"```" +"Aquí la solución es abierta, ya que depende de que alguno de los asistentes " +"tenga un fragmento de código que se pueda convertir en Rust sobre la marcha." -#: src/chromium/build-rules/vscode.md +#: src/chromium.md +msgid "Welcome to Rust in Chromium" +msgstr "Te Damos la Bienvenida a Rust en Chromium" + +#: src/chromium.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," +"Rust is supported for third-party libraries in Chromium, with first-party " +"glue code to connect between Rust and existing Chromium C++ code." msgstr "" -"Los tipos se omiten en el código de Rust, lo que hace que un buen IDE sea " -"aún más útil para C++. El código de Visual Studio funciona bien con Rust en " -"Chromium. Para utilizarlo, haz lo siguiente:" +"Rust es compatible con bibliotecas de terceros en Chromium, con código " +"pegamento propio para conectar Rust y el código de C++ de Chromium ya " +"existente." -#: src/chromium/build-rules/vscode.md +#: src/chromium.md msgid "" -"Ensure your VSCode has the `rust-analyzer` extension, not earlier forms of " -"Rust support" +"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 "" -"Asegúrate de que VSCode tenga la extensión `rust-analyzer`, no versiones " -"anteriores de compatibilidad con Rust." +"Hoy vamos a llamar a Rust para que haga algo divertido con las cadenas. Si " +"tienes una esquina del código donde se muestra una cadena UTF8 al usuario, " +"no dudes en seguir estas instrucciones en tu parte del código base en lugar " +"de la parte exacta de la que hablamos." -#: src/chromium/build-rules/vscode.md +#: src/chromium/setup.md msgid "" -"`gn gen out/Debug --export-rust-project` (or equivalent for your output " -"directory)" +"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 "" -"`gn gen out/Debug --export-rust-project` (o el equivalente en tu directorio " -"de salida)." - -#: 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`." +"Asegúrate de que puedes compilar y ejecutar Chromium. Cualquier plataforma y " +"conjunto de marcas de compilación es apto, siempre que tu código sea " +"relativamente reciente (posición de commit 1223636 en adelante, " +"correspondiente a noviembre del 2023):" -#: src/chromium/build-rules/vscode.md +#: src/chromium/setup.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." +"(A component, debug build is recommended for quickest iteration time. This " +"is the default!)" msgstr "" -"Una demo de algunas de las funciones de anotación de código y exploración de " -"rust-analyzer puede ser útil si los asistentes se muestran escépticos por " -"los IDE." +"(Se recomienda una versión de depuración de componentes para que el tiempo " +"de iteración sea más rápido. Esta es la opción predeterminada)." -#: src/chromium/build-rules/vscode.md +#: src/chromium/setup.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):" +"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 "" -"Los siguientes pasos pueden servir de ayuda con la demo (aunque puedes usar " -"un fragmento de Rust relacionado con Chromium que te resulte más familiar):" +"Consulta [cómo compilar Chromium](https://www.chromium.org/developers/how-" +"tos/get-the-code/) si aún no lo has hecho. Advertencia: el proceso de " +"configuración para compilar Chromium puede tardar." -#: src/chromium/build-rules/vscode.md -msgid "Open `components/qr_code_generator/qr_code_generator_ffi_glue.rs`" -msgstr "Abre `components/qr_code_generator/qr_code_generator_ffi_glue.rs`." +#: src/chromium/setup.md +msgid "It's also recommended that you have Visual Studio code installed." +msgstr "Se recomienda que tengas instalado Visual Studio Code." -#: src/chromium/build-rules/vscode.md +#: src/chromium/setup.md +msgid "About the exercises" +msgstr "Información sobre los ejercicios" + +#: src/chromium/setup.md msgid "" -"Place the cursor over the `QrCode::new` call (around line 26) in " -"\\`qr_code_generator_ffi_glue.rs" +"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 "" -"Coloca el cursor sobre la llamada `QrCode::new` (aproximadamente en la línea " -"26) en \\`qr_code_generator_ffi_glue.rs." +"Esta parte del curso consta de una serie de ejercicios que se complementan " +"entre sí. Las iremos repartiendo a lo largo del curso en lugar de hacerlos " +"todo al final. Si no tienes tiempo para completar una parte concreta, no te " +"preocupes, podrás ponerte al día en la siguiente clase." -#: src/chromium/build-rules/vscode.md +#: src/chromium/cargo.md +#, fuzzy msgid "" -"Demo **show documentation** (typical bindings: vscode = ctrl k i; vim/CoC = " -"K)." +"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 "" -"Demo **mostrar la documentación** (enlaces típicos: vscode = ctrl ki; vim/" -"CoC = K)." +"La comunidad de Rust suele usar `cargo` y bibliotecas de [crates.io](https://" +"crates.io/). Chromium se compila usando `gn` y `ninja`, además de un " +"conjunto seleccionado de dependencias." -#: src/chromium/build-rules/vscode.md +#: src/chromium/cargo.md +msgid "When writing code in Rust, your choices are:" +msgstr "A la hora de escribir código en Rust, hay disponibles varias opciones:" + +#: src/chromium/cargo.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`.)" +"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 "" -"Demo **ir a la definición** (enlaces típicos: vscode = F12; vim/CoC = gd) " -"(Esta acción te llevará a `//third_party/rust/.../qr_code-.../src/lib.rs`)." +"Usar `gn` y `ninja` con la ayuda de las plantillas de `//build/rust/*.gni` " +"(por ejemplo, `rust_static_library`, que veremos más adelante). Se usan la " +"cadena de herramientas y los crates auditados de Chromium." -#: src/chromium/build-rules/vscode.md +#: src/chromium/cargo.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)" -msgstr "" -"Demo **esquema** y desplázate hasta el método `QrCode::with_bits` (en la " -"línea 164. El esquema se encuentra en el panel del explorador de archivos de " -"vscode. Enlaces típicos de vim/CoC = espacio o)." +"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 "" +"Usar `cargo`, pero [restringiendo el uso de la cadena de herramientas y los " +"crates auditados de Chromium](https://chromium.googlesource.com/chromium/src/" +"+/refs/heads/main/docs/rust.md#Using-cargo)." -#: src/chromium/build-rules/vscode.md +#: src/chromium/cargo.md msgid "" -"Demo **type annotations** (there are quote a few nice examples in the " -"`QrCode::with_bits` method)" +"Use `cargo`, trusting a [toolchain](https://rustup.rs/) and/or [crates " +"downloaded from the internet](https://crates.io/)" msgstr "" -"Demo **anotaciones de tipos** (hay varios ejemplos en el método `QrCode::" -"with_bits`)." +"Usa `cargo` con una [cadena de herramientas](https://rustup.rs/) o [crates " +"descargados de Internet](https://crates.io/)." -#: src/chromium/build-rules/vscode.md +#: src/chromium/cargo.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)." +"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 "" -"Es necesario destacar que hay que volver a ejecutar `gn gen ... --export-" -"rust-project` después de editar los archivos `BUILD.gn` (lo haremos varias " -"veces a lo largo de los ejercicios de esta sesión)." +"A partir de ahora, nos centraremos en `gn` y `ninja`, ya que así es como se " +"puede compilar el código de Rust en el navegador Chromium. De igual forma, " +"Cargo es una parte importante del ecosistema de Rust y deberías conservarlo " +"en tu caja de herramientas." -#: src/exercises/chromium/build-rules.md -msgid "Build rules exercise" -msgstr "Ejercicio de reglas de compilación" +#: src/chromium/cargo.md +msgid "Mini exercise" +msgstr "Ejercicio rápido" -#: src/exercises/chromium/build-rules.md -msgid "" -"In your Chromium build, add a new Rust target to `//ui/base/BUILD.gn` " -"containing:" -msgstr "" -"En tu compilación de Chromium, añade un nuevo elemento de destino de Rust a " -"`//ui/base/build.gn` que contenga lo siguiente:" +#: src/chromium/cargo.md +msgid "Split into small groups and:" +msgstr "Formad grupos pequeños para:" -#: src/exercises/chromium/build-rules.md +#: src/chromium/cargo.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." +"Brainstorm scenarios where `cargo` may offer an advantage and assess the " +"risk profile of these scenarios." msgstr "" -"**Importante:** Ten en cuenta que `no_mangle` en este caso se considera un " -"tipo de inseguridad según el compilador de Rust, por lo que tendrás que " -"permitir código inseguro en el elemento de destino `gn`." +"Hacer una lluvia de ideas sobre situaciones en las que `cargo` pueda ofrecer " +"ventajas y evaluar el perfil de riesgo." -#: src/exercises/chromium/build-rules.md +#: src/chromium/cargo.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):" +"Discuss which tools, libraries, and groups of people need to be trusted when " +"using `gn` and `ninja`, offline `cargo`, etc." msgstr "" -"Añade este nuevo elemento de destino de Rust como una dependencia de `//ui/" -"base:base`. Declara esta función en la parte superior de `ui/base/resource/" -"resource_bundle.cc` (más adelante veremos cómo se puede automatizar mediante " -"herramientas de generación de enlaces):" +"Debatir en qué herramientas, bibliotecas y grupos de personas hay que " +"confiar al usar `gn` y `ninja`, `cargo` offline, etc." -#: src/exercises/chromium/build-rules.md +#: src/chromium/cargo.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." +"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 "" -"Llama a esta función desde algún lugar de `ui/base/resource/resource_bundle." -"cc`. Recomendamos hacerlo en la parte superior de `ResourceBundle::" -"RSMangleLocalizedString`. Compila y ejecuta Chromium y asegúrate de que se " -"imprima \"¡Rust te manda un saludo!\" muchas veces." +"Pide a los participantes que eviten mirar las notas del orador antes de " +"completar el ejercicio. Suponiendo que todas las personas que hacen el curso " +"están en la misma sala, pídeles que hablen en grupos pequeños de 3 a 4 " +"personas." -#: src/exercises/chromium/build-rules.md +#: src/chromium/cargo.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!`." +"Notes/hints related to the first part of the exercise (\"scenarios where " +"Cargo may offer an advantage\"):" msgstr "" -"Si usas VSCode, ahora debes configurar Rust para que funcione correctamente " -"en VSCode. Nos será útil en ejercicios posteriores. Si lo has completado " -"correctamente, podrás hacer clic con el botón derecho y pulsar \"Ir a la " -"definición\" en `println!`." - -#: src/exercises/chromium/build-rules.md -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Where to find help" -msgstr "Dónde obtener ayuda" +"Notas y sugerencias relacionadas con la primera parte del ejercicio " +"(\"situaciones en las que Cargo puede ofrecer ventajas\"):" -#: src/exercises/chromium/build-rules.md +#: src/chromium/cargo.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)" +"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 "" -"Opciones disponibles de la [plantilla gn `rust_static_library`](https://" -"source.chromium.org/chromium/chromium/src/+/main:build/rust/" -"rust_static_library.gni;l=16)" +"Es genial que al escribir una herramienta o crear prototipos de una parte de " +"Chromium se pueda acceder al extenso ecosistema de bibliotecas crates.io. " +"Hay un crate para casi cualquier cosa y suelen ser muy fáciles de usar " +"(`clap` para el análisis de la línea de comandos, `serde` para la " +"serialización y deserialización a/desde varios formatos, `itertools` para " +"trabajar con iteradores, etc.)." -#: src/exercises/chromium/build-rules.md +#: src/chromium/cargo.md msgid "" -"Information about [`#[no_mangle]`](https://doc.rust-lang.org/beta/reference/" -"abi.html#the-no_mangle-attribute)" +"`cargo` makes it easy to try a library (just add a single line to `Cargo." +"toml` and start writing code)" msgstr "" -"Información sobre [`#[no_mangle]`](https://doc.rust-lang.org/beta/reference/" -"abi.html#the-no_mangle-attribute)" +"`cargo` permite probar una biblioteca fácilmente (solo hay que añadir una " +"línea a `Cargo.toml` y empezar a escribir el código)." -#: src/exercises/chromium/build-rules.md +#: src/chromium/cargo.md msgid "" -"Information about [`extern \"C\"`](https://doc.rust-lang.org/std/keyword." -"extern.html)" +"It may be worth comparing how CPAN helped make `perl` a popular choice. Or " +"comparing with `python` + `pip`." msgstr "" -"Información sobre [`extern \"C\"`](https://doc.rust-lang.org/std/keyword." -"extern.html)" +"Merece la pena comparar cómo la CPAN ayudó a que `perl` fuera una opción " +"popular o compararlo con `python` + `pip`." -#: src/exercises/chromium/build-rules.md +#: src/chromium/cargo.md msgid "" -"Information about gn's [`--export-rust-project`](https://gn.googlesource.com/" -"gn/+/main/docs/reference.md#compilation-database) switch" +"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 "" -"Información sobre el interruptor [`--export-rust-project`](https://gn." -"googlesource.com/gn/+/main/docs/reference.md#compilation-database) de gn" +"La experiencia de desarrollo no solo es agradable gracias a las herramientas " +"principales de Rust (por ejemplo, al usar `rustup` para cambiar a una " +"versión diferente de `rustc` cuando se prueba un crate que necesita " +"funcionar en nightly, stable actual y antiguas versiones de stable), sino " +"también a un ecosistema de herramientas de terceros (por ejemplo, Mozilla " +"proporciona `cargo vet` para optimizar y compartir auditorías de seguridad; " +"el crate `criterion` ofrece un método optimizado para ejecutar comparativas)." -#: src/exercises/chromium/build-rules.md +#: src/chromium/cargo.md msgid "" -"[How to install rust-analyzer in VSCode](https://code.visualstudio.com/docs/" -"languages/rust)" +"`cargo` makes it easy to add a tool via `cargo install --locked cargo-vet`." msgstr "" -"[Cómo instalar rust-analyzer en VSCode](https://code.visualstudio.com/docs/" -"languages/rust)" +"`cargo` permite añadir fácilmente una herramienta mediante `cargoinstall --" +"locked cargo-vet`." -#: src/exercises/chromium/build-rules.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." +#: src/chromium/cargo.md +msgid "It may be worth comparing with Chrome Extensions or VScode extensions." msgstr "" -"Este ejemplo no es habitual porque se reduce al lenguaje de " -"interoperabilidad con el mínimo común denominador, C. Tanto C++ como Rust " -"pueden declarar y llamar de forma nativa funciones ABI de C. Más adelante, " -"conectaremos C++ directamente con Rust." +"Merece la pena compararlo con las extensiones de Chrome o con las de VScode." -#: src/exercises/chromium/build-rules.md +#: src/chromium/cargo.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." +"Broad, generic examples of projects where `cargo` may be the right choice:" msgstr "" -"`allow_unsafe = true` es obligatorio porque `#[no_mangle]` podría permitir " -"que Rust genere dos funciones con el mismo nombre, y Rust ya no puede " -"asegurar que se llame a la correcta." +"Ejemplos generales y genéricos de proyectos en los que `cargo` puede ser la " +"opción más adecuada:" -#: src/exercises/chromium/build-rules.md +#: src/chromium/cargo.md msgid "" -"If you need a pure Rust executable, you can also do that using the " -"`rust_executable` gn template." +"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 "" -"Si necesitas un ejecutable puro de Rust, también puedes hacerlo con la " -"plantilla gn `rust_executable`." +"Sorprendentemente, Rust se está volviendo cada vez más popular en el sector " +"por su función de escritura de herramientas de línea de comandos. La " +"amplitud y la ergonomía de las bibliotecas son similares a las de Python, " +"pero son más sólidas (gracias al sistema de tipos enriquecido) y funcionan " +"más rápido (como lenguaje compilado en lugar de interpretado)." -#: src/chromium/testing.md +#: src/chromium/cargo.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:" +"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 "" -"La comunidad de Rust suele crear las pruebas unitarias en un módulo situado " -"en el mismo archivo fuente que el código que se está probando. Este tema ya " -"se ha tratado [antes](../testing.md) en el curso y tiene este aspecto:" +"Para participar en el ecosistema de Rust, es necesario usar herramientas " +"estándar de Rust, como Cargo. Las bibliotecas que quieran recibir " +"contribuciones externas y actuar fuera de Chromium (por ejemplo, en entornos " +"de desarrollo de Bazel o Android/Soong) deberían utilizar Cargo." -#: src/chromium/testing.md -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)." +#: src/chromium/cargo.md +msgid "Examples of Chromium-related projects that are `cargo`\\-based:" msgstr "" -"En Chromium colocamos las pruebas unitarias en un archivo fuente " -"independiente y continuamos con esta práctica con Rust. De esta forma, las " -"pruebas se pueden encontrar de forma coherente y se evita volver a crear " -"archivos `.rs` (en la configuración `test`)." +"Ejemplos de proyectos relacionados con Chromium que se basan en `cargo`\\:" -#: src/chromium/testing.md +#: src/chromium/cargo.md msgid "" -"This results in the following options for testing Rust code in Chromium:" +"`serde_json_lenient` (experimented with in other parts of Google which " +"resulted in PRs with performance improvements)" msgstr "" -"Esta acción genera las siguientes opciones para probar el código de Rust en " -"Chromium:" +"`serde_json_lenient` (experimentado en otras partes de Google que ha dado " +"lugar a PRs con mejoras de rendimiento)." -#: src/chromium/testing.md -msgid "" -"Native Rust tests (i.e. `#[test]`). Discouraged outside of `//third_party/" -"rust`." -msgstr "" -"Pruebas nativas de Rust (es decir, `#[test]`). No se recomienda hacerlas " -"fuera de `//third_party/rust`." +#: src/chromium/cargo.md +msgid "Fontations libraries like `font-types`" +msgstr "Bibliotecas de fuentes, como `font-types`." -#: 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." +"`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 "" -"Pruebas `gtest` escritas en C++ y ejercicios con Rust mediante llamadas de " -"FFI. Suficiente cuando el código de Rust es solo una capa fina de FFI y las " -"pruebas unitarias existentes proporcionan suficiente cobertura para la " -"función." +"La herramienta `gnrt` (la veremos más adelante en el curso), que depende de " +"`clap` para el análisis de la línea de comandos y de `toml` para los " +"archivos de configuración." -#: src/chromium/testing.md +#: src/chromium/cargo.md +#, fuzzy 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." +"Disclaimer: a unique reason for using `cargo` was unavailability of `gn` " +"when building and bootstrapping Rust standard library when building Rust " +"toolchain." msgstr "" -"Pruebas `gtest` creadas en Rust y usando el crate en prueba a través de su " -"API pública (mediante `pub mod for_testing { ... }` si es necesario). Este " -"es el tema de las siguientes diapositivas." +"Aclaración: una razón principal para usar `cargo` es que `gn` no está " +"disponible al compilar e iniciar la biblioteca estándar de Rust cuando se " +"compila su cadena de herramientas." -#: src/chromium/testing.md +#: src/chromium/cargo.md +#, fuzzy 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.)" +"`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 "" -"Menciona que los bots de Chromium deberían hacer pruebas nativas de Rust de " -"crates de terceros tarde o temprano. (Estas pruebas rara vez son necesarias, " -"solo después de añadir o actualizar crates de terceros)." +"`run_gnrt.py` usa la copia de Chromium de `cargo` y `rustc`. `gnrt` depende " +"de las bibliotecas de terceros descargadas de Internet. `run_gnrt.py` pide a " +"`cargo` que solo se permita el contenido `--locked` a través de `Cargo.lock`." -#: src/chromium/testing.md +#: src/chromium/cargo.md msgid "" -"Some examples may help illustrate when C++ `gtest` vs Rust `gtest` should be " -"used:" +"Students may identify the following items as being implicitly or explicitly " +"trusted:" msgstr "" -"Algunos ejemplos pueden ayudarte a ilustrar cuándo se debe usar `gtest` de C+" -"+ o `gtest` de Rust:" +"Los participantes pueden tratar de identificar si los siguientes elementos " +"son de confianza implícita o explícita:" -#: 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`)." +"`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 "" -"QR cuenta con muy pocas funciones en la capa de Rust propia (solo es un " -"código pegamento de FFI) y, por lo tanto, utiliza las pruebas unitarias de C+" -"+ existentes para probar la implementación de C++ y la de Rust " -"(parametrizando las pruebas de modo que habiliten o inhabiliten Rust " -"mediante un `ScopedFeatureList`)." +"`rustc` (el compilador de Rust), que a su vez depende de las bibliotecas " +"LLVM, el compilador Clang, las fuentes `rustc` (obtenidas de GitHub y " +"revisadas por el equipo de compilación de Rust), y el compilador binario de " +"Rust descargado para el bootstrapping." -#: 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." +"`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 "" -"La integración hipotética/WIP de PNG puede necesitar una implementación " -"segura en memoria de las transformaciones de píxeles que proporciona " -"`libpng` pero que faltan en el crate `png`, como por ejemplo, RGBA => BGRA o " -"corrección gamma. Dicha función puede beneficiarse de pruebas independientes " -"creadas en Rust." +"`rustup` (merece la pena destacar que `rustup` se desarrolla en la misma " +"organización que `rustc`, https://github.com/rust-lang/)." -#: src/chromium/testing/rust-gtest-interop.md +#: src/chromium/cargo.md +msgid "`cargo`, `rustfmt`, etc." +msgstr "`cargo`, `rustfmt`, etc." + +#: 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:" +"Various internal infrastructure (bots that build `rustc`, system for " +"distributing the prebuilt toolchain to Chromium engineers, etc.)" msgstr "" -"La biblioteca [`rust_gtest_interop`](https://chromium.googlesource.com/" -"chromium/src/+/main/testing/rust_gtest_interop/README.md) permite hacer lo " -"siguiente:" +"Varias infraestructuras internas (bots que compilan `rustc`, sistemas para " +"distribuir la cadena de herramientas precompiladas a los ingenieros de " +"Chromium, etc.)" -#: src/chromium/testing/rust-gtest-interop.md +#: src/chromium/cargo.md +msgid "Cargo tools like `cargo audit`, `cargo vet`, etc." +msgstr "Herramientas de Cargo, como `cargo audit`, `cargo vet`, etc." + +#: src/chromium/cargo.md msgid "" -"Use a Rust function as a `gtest` testcase (using the `#[gtest(...)]` " -"attribute)" +"Rust libraries vendored into `//third_party/rust` (audited by " +"security@chromium.org)" msgstr "" -"Usar una función de Rust como caso de prueba `gtest` (con el atributo " -"`#[gtest(...)]`)." +"Bibliotecas de Rust incluidas en `//third_party/rust` (auditoría de " +"security@chromium.org)." -#: 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)." +#: src/chromium/cargo.md +msgid "Other Rust libraries (some niche, some quite popular and commonly used)" msgstr "" -"Usar `expect_eq!` y macros similares (similares a `assert_eq!`, pero sin que " -"se produzcan pánicos o sin finalizar la prueba cuando la aserción falle)." +"Otras bibliotecas de Rust (algunas de nicho, otras bastante populares y de " +"uso común)." -#: src/chromium/testing/rust-gtest-interop.md -msgid "Example:" -msgstr "Ejemplo:" +#: src/chromium/policy.md +msgid "Chromium Rust policy" +msgstr "Política de Chromium Rust" -#: src/chromium/testing/build-gn.md +#: src/chromium/policy.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:" +"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 "" -"La forma más sencilla de compilar pruebas `gtest` de Rust es añadirlas a un " -"binario de prueba que ya contenga pruebas creadas en C++. Por ejemplo:" +"Chromium aún no permite usar Rust propio, excepto en casos excepcionales, " +"según lo aprobado por [Area Tech Leads](https://source.chromium.org/chromium/" +"chromium/src/+/main:ATL_OWNERS)." -#: src/chromium/testing/build-gn.md +#: src/chromium/policy.md msgid "" -"```gn\n" -"test(\"ui_base_unittests\") {\n" -" ...\n" -" sources += [ \"my_rust_lib_unittest.rs\" ]\n" -" deps += [ \":my_rust_lib\" ]\n" -"}\n" -"```" +"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 "" -"```gn\n" -"test(\"ui_base_unittests\") {\n" -" ...\n" -" sources += [ \"my_rust_lib_unittest.rs\" ]\n" -" deps += [ \":my_rust_lib\" ]\n" -"}\n" -"```" +"La política de Chromium sobre bibliotecas de terceros se describe [aquí]" +"(https://chromium.googlesource.com/chromium/src/+/main/docs/" +"adding_to_third_party.md#rust). Se permite el uso de Rust para bibliotecas " +"de terceros en algunos casos, incluido si son la mejor opción en cuanto al " +"rendimiento o seguridad." -#: src/chromium/testing/build-gn.md +#: src/chromium/policy.md msgid "" -"Authoring Rust tests in a separate `static_library` also works, but requires " -"manually declaring the dependency on the support libraries:" +"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 "" -"La creación de pruebas de Rust en una `static_library` independiente también " -"funciona, pero es necesario declarar manualmente la dependencia en las " -"bibliotecas de compatibilidad:" +"Muy pocas bibliotecas de Rust exponen directamente una API de C o C++, por " +"lo que casi todas estas bibliotecas necesitarán una pequeña parte de código " +"pegamento propio." -#: src/chromium/testing/build-gn.md +#: src/chromium/policy.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" +"```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 "" -"```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/testing/chromium-import-macro.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:" -msgstr "" -"Después de añadir `:my_rust_lib` a GN `deps`, tenemos que aprender a " -"importar y usar `my_rust_lib` desde `my_rust_lib_unittest.rs`. No hemos " -"proporcionado un `crate_name` explícito para `my_rust_lib`, por lo que el " -"nombre del crate se calcula en función de la ruta y el nombre de destino " -"completos. Por suerte, podemos evitar trabajar con un nombre tan poco " -"práctico usando la macro `chromium::import!` del crate `chromium` importado " -"automáticamente:" - -#: src/chromium/testing/chromium-import-macro.md -msgid "\"//ui/base:my_rust_lib\"" -msgstr "\"//ui/base:my_rust_lib\"" - -#: src/chromium/testing/chromium-import-macro.md -msgid "Under the covers the macro expands to something similar to:" -msgstr "" -"En un segundo plano, la macro se expande a algo parecido a lo siguiente:" - -#: src/chromium/testing/chromium-import-macro.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." -msgstr "" -"Puedes obtener más información en [el comentario del documento](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) de la macro `chromium::import`." +"```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" +"```" -#: src/chromium/testing/chromium-import-macro.md +#: src/chromium/policy.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." +"First-party Rust glue code for a particular third-party crate should " +"normally be kept in `third_party/rust///wrapper`." msgstr "" -"`rust_static_library` permite especificar un nombre explícito mediante la " -"propiedad `crate_name`, pero no se recomienda hacerlo. El motivo es porque " -"el nombre del crate debe ser único en todo el mundo. crates.io garantiza la " -"exclusividad de sus nombres de crate, de modo que los elementos de destino " -"de GN `cargo_crate` (generados por la herramienta `gnrt` que se explican en " -"una sección posterior) usan nombres de crate cortos." - -#: src/exercises/chromium/testing.md -msgid "Testing exercise" -msgstr "Ejercicio de pruebas" +"El código pegamento propio de Rust para un crate de terceros concreto " +"normalmente debe guardarse en `third_party/rust///wrapper`." -#: src/exercises/chromium/testing.md -msgid "Time for another exercise!" -msgstr "¡Vamos a hacer otro ejercicio!" +#: src/chromium/policy.md +msgid "Because of this, today's course will be heavily focused on:" +msgstr "Por este motivo, el curso de hoy se centrará en los siguientes temas:" -#: src/exercises/chromium/testing.md -msgid "In your Chromium build:" -msgstr "En tu compilación de Chromium:" +#: src/chromium/policy.md +msgid "Bringing in third-party Rust libraries (\"crates\")" +msgstr "Incorporación de bibliotecas Rust de terceros (\"crates\")." -#: 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." +#: src/chromium/policy.md +msgid "Writing glue code to be able to use those crates from Chromium C++." msgstr "" -"Añade una función que se pueda probar junto a `hello_from_rust`. Aquí tienes " -"algunas sugerencias: añadir dos números enteros recibidos como argumentos, " -"calcular el enésimo número de la serie Fibonacci, sumar los enteros en un " -"slice, etc." +"Escribir código pegamento para poder usar esos crates desde Chromium C++." -#: src/exercises/chromium/testing.md -msgid "Add a separate `..._unittest.rs` file with a test for the new function." +#: src/chromium/policy.md +msgid "If this policy changes over time, the course will evolve to keep up." msgstr "" -"Añade un archivo `..._unittest.rs` independiente con una prueba de la nueva " -"función." +"Si esta política cambia con el tiempo, el curso irá evolucionando para " +"adaptarse al cambio." -#: src/exercises/chromium/testing.md -msgid "Add the new tests to `BUILD.gn`." -msgstr "Añade las nuevas pruebas a `BUILD.gn`." +#: src/chromium/build-rules.md +msgid "Build rules" +msgstr "Reglas de Compilación (_Build_)" -#: src/exercises/chromium/testing.md -msgid "Build the tests, run them, and verify that the new test works." +#: 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 "" -"Compila las pruebas, ejecútalas y comprueba que la nueva prueba funciona." +"El código de Rust se suele compilar con `cargo`. Chromium se compila con " +"`gn` y `ninja` para aumentar la eficiencia. Sus reglas estáticas permiten el " +"máximo paralelismo. Rust no es una excepción." -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/build-rules.md +msgid "Adding Rust code to Chromium" +msgstr "Añadir código de Rust a Chromium" + +#: src/chromium/build-rules.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." +"In some existing Chromium `BUILD.gn` file, declare a `rust_static_library`:" msgstr "" -"La comunidad de Rust ofrece muchas opciones para la interoperabilidad de C++ " -"y Rust, y continuamente se están desarrollando nuevas herramientas. " -"Actualmente, Chromium usa la herramienta CXX." +"En algunos archivos `BUILD.gn` de Chromium, declara una " +"`rust_static_library`:" -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/build-rules.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++." +"```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 "" -"Describe todos los límites de tu lenguaje en un lenguaje de definición de " -"interfaz (que se parece mucho a Rust) y, a continuación, las herramientas " -"CXX generarán declaraciones de funciones y tipos tanto en Rust como en C++." +"```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.md +#: src/chromium/build-rules.md msgid "" -"See the [CXX tutorial](https://cxx.rs/tutorial.html) for a full example of " -"using this." +"You can also add `deps` on other Rust targets. Later we'll use this to " +"depend upon third party code." msgstr "" -"Consulta el [tutorial de CXX](https://cxx.rs/tutorial.html) para ver un " -"ejemplo completo de su uso." +"También puedes añadir `deps` en otros segmentos de Rust. Más adelante, lo " +"usaremos en función del código de terceros." -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/build-rules.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:" +"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 "" -"Aclara el diagrama. Explica que, en segundo plano, esto hace lo mismo que " -"hemos hecho antes. Señala que automatizar el proceso supone las siguientes " -"ventajas:" +"Debes especificar _tanto_ la raíz del crate _como_ una lista completa de " +"recursos. `crate_root` es el archivo proporcionado al compilador de Rust que " +"representa el archivo raíz de la unidad de compilación, que suele ser `lib." +"rs`. `sources` es una lista completa de todos los archivos de origen que " +"necesita `ninja` para determinar cuándo es necesario compilar de nuevo." -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/build-rules.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)" +"(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 "" -"La herramienta asegura que C++ y Rust coincidan (por ejemplo, se producen " -"errores de compilación si `#[cxx::bridge]` no coincide con las definiciones " -"de C++ o Rust reales, pero con enlaces manuales no sincronizados, se " -"obtendría un comportamiento no definido)" +"(No existe `source_set` en Rust porque un crate completo ya es una unidad de " +"compilación. Una `static_library` es la unidad más pequeña)." -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/build-rules.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)" +"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 "" -"La herramienta automatiza la generación de thunks FFI (funciones pequeñas, " -"compatibles con la ABI de C y gratuitas) para funciones que no son de C (por " -"ejemplo, habilitar llamadas de FFI en métodos de Rust o C++. Los enlaces " -"manuales requerirían la creación manual de estas funciones gratuitas de " -"nivel superior)." +"Puede que los participantes se pregunten por qué necesitamos una plantilla " +"gn en vez de usar [la compatibilidad integrada de gn para las bibliotecas " +"estáticas de Rust](https://gn.googlesource.com/gn/+/main/docs/reference." +"md#func_static_library). La respuesta es que esta plantilla es compatible " +"con la interoperabilidad de CXX, las funciones de Rust y las pruebas " +"unitarias, algunas de las cuales usaremos más adelante." -#: src/chromium/interoperability-with-cpp.md -msgid "The tool and the library can handle a set of core types - for example:" -msgstr "" -"La herramienta y la biblioteca pueden gestionar un conjunto de tipos " -"principales, como por ejemplo:" +#: src/chromium/build-rules/unsafe.md +msgid "Including `unsafe` Rust Code" +msgstr "Incluir código de Rust `unsafe`" -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/build-rules/unsafe.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)" +"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 "" -"`&[T]` se puede transferir a través del límite de FFI, aunque no garantiza " -"ningún diseño concreto de ABI o de memoria. Con los enlaces manuales, `std::" -"span` y `&[T]` se tienen que desestructurar manualmente y compilarlos a " -"partir de un puntero y una longitud. Esto suele acarrear errores, ya que " -"cada lenguaje representa los slices vacíos de forma ligeramente distinta." +"El código de Rust inseguro está prohibido en `rust_static_library` de forma " +"predeterminada, por lo que no se podrá compilar. Si necesitas código de Rust " +"inseguro, añade `allow_unsafe = true` al elemento de destino de gn. (Más " +"adelante en el curso veremos circunstancias en las que es necesario hacerlo)." -#: src/chromium/interoperability-with-cpp.md +#: src/chromium/build-rules/unsafe.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." +"```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 "" -"Los punteros inteligentes como `std::unique_ptr`, `std::shared_ptr` o " -"`Box` se admiten de forma nativa. Con los enlaces manuales, sería necesario " -"pasar punteros sin formato compatibles con ABI de C, lo que aumentaría los " -"riesgos de tiempo de vida y de seguridad en la memoria." +"```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.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)." +#: src/chromium/build-rules/depending.md +msgid "Simply add the above target to the `deps` of some Chromium C++ target." msgstr "" -"Los tipos `rust::String` y `CxxString` entienden y mantienen las diferencias " -"en la representación de cadenas en los distintos lenguajes (por ejemplo, " -"`rust::String::lossy` puede crear una cadena de Rust a partir de una entrada " -"que no sea UTF8 y `rust::String::: c_str` puede terminar una cadena con un " -"carácter nulo)." +"Solo tienes que añadir el elemento de destino que aparece arriba a los " +"`deps` de algún elemento de destino de Chromium C++." -#: src/chromium/interoperability-with-cpp/example-bindings.md +#: src/chromium/build-rules/depending.md msgid "" -"CXX requires that the whole C++/Rust boundary is declared in `cxx::bridge` " -"modules inside `.rs` source code." +"```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 "" -"CXX necesita que se declare todo el límite de C++ o Rust en los módulos " -"`cxx::bridge` del código fuente `.rs`." - -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "\"example/include/blobstore.h\"" -msgstr "\"example/include/blobstore.h\"" +"```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" +"```" -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "// Definitions of Rust types and functions go here\n" +#: src/chromium/build-rules/vscode.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," msgstr "" -"// Las definiciones de los tipos y las funciones de Rust se colocan aquí\n" - -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "Point out:" -msgstr "Señala lo siguiente:" +"Los tipos se omiten en el código de Rust, lo que hace que un buen IDE sea " +"aún más útil para C++. El código de Visual Studio funciona bien con Rust en " +"Chromium. Para utilizarlo, haz lo siguiente:" -#: src/chromium/interoperability-with-cpp/example-bindings.md +#: src/chromium/build-rules/vscode.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." +"Ensure your VSCode has the `rust-analyzer` extension, not earlier forms of " +"Rust support" msgstr "" -"Aunque parece un `mod` de Rust habitual, la macro de procedimiento `#[cxx::" -"bridge]` es capaz de desempeñar tareas complejas. El código generado es " -"bastante más sofisticado, aunque aun así da como resultado un `mod` llamado " -"`ffi` en el código." - -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "Native support for C++'s `std::unique_ptr` in Rust" -msgstr "Compatibilidad nativa con `std::unique_ptr` de C++ en Rust." - -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "Native support for Rust slices in C++" -msgstr "Compatibilidad nativa con los slices de Rust en C++." +"Asegúrate de que VSCode tenga la extensión `rust-analyzer`, no versiones " +"anteriores de compatibilidad con Rust." -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "Calls from C++ to Rust, and Rust types (in the top part)" -msgstr "Llamadas de C++ a Rust y tipos de Rust (en la parte superior)." +#: src/chromium/build-rules/vscode.md +msgid "" +"`gn gen out/Debug --export-rust-project` (or equivalent for your output " +"directory)" +msgstr "" +"`gn gen out/Debug --export-rust-project` (o el equivalente en tu directorio " +"de salida)." -#: src/chromium/interoperability-with-cpp/example-bindings.md -msgid "Calls from Rust to C++, and C++ types (in the bottom part)" -msgstr "Llamadas de Rust a C++ y tipos de C++ (en la parte inferior)." +#: 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/interoperability-with-cpp/example-bindings.md +#: src/chromium/build-rules/vscode.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." +"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 "" -"**Error común**: _Parece_ que Rust está analizando un encabezado de C++, " -"pero no es así. Rust nunca interpreta este encabezado, sino que simplifica " -"`#include`d en el código C++ generado para ayudar a los compiladores de C++." +"Una demo de algunas de las funciones de anotación de código y exploración de " +"rust-analyzer puede ser útil si los asistentes se muestran escépticos por " +"los IDE." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md -#, fuzzy +#: src/chromium/build-rules/vscode.md msgid "" -"By far the most useful page when using CXX is the [type reference](https://" -"cxx.rs/bindings.html)." +"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 "" -"Muestra la correspondencia entre [los tipos de Rust y C++](https://cxx.rs/" -"bindings.html):" +"Los siguientes pasos pueden servir de ayuda con la demo (aunque puedes usar " +"un fragmento de Rust relacionado con Chromium que te resulte más familiar):" -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md -msgid "CXX fundamentally suits cases where:" -msgstr "CXX se adapta básicamente a los casos en los que:" +#: src/chromium/build-rules/vscode.md +msgid "Open `components/qr_code_generator/qr_code_generator_ffi_glue.rs`" +msgstr "Abre `components/qr_code_generator/qr_code_generator_ffi_glue.rs`." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#: src/chromium/build-rules/vscode.md msgid "" -"Your Rust-C++ interface is sufficiently simple that you can declare all of " -"it." +"Place the cursor over the `QrCode::new` call (around line 26) in " +"\\`qr_code_generator_ffi_glue.rs" msgstr "" -"La interfaz de Rust-C++ es lo suficientemente sencilla como para se pueda " -"declarar por completo." +"Coloca el cursor sobre la llamada `QrCode::new` (aproximadamente en la línea " +"26) en \\`qr_code_generator_ffi_glue.rs." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#: src/chromium/build-rules/vscode.md msgid "" -"You're using only the types natively supported by CXX already, for example " -"`std::unique_ptr`, `std::string`, `&[u8]` etc." +"Demo **show documentation** (typical bindings: vscode = ctrl k i; vim/CoC = " +"K)." msgstr "" -"Solo estás usando los tipos compatibles de forma nativa con CXX, como `std::" -"unique_ptr`, `std::string` o `&[u8]`, entre otros." +"Demo **mostrar la documentación** (enlaces típicos: vscode = ctrl ki; vim/" +"CoC = K)." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#: src/chromium/build-rules/vscode.md msgid "" -"It has many limitations --- for example lack of support for Rust's `Option` " -"type." +"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 "" -"Tiene muchas limitaciones, por ejemplo, la falta de compatibilidad con el " -"tipo `Option` de Rust." +"Demo **ir a la definición** (enlaces típicos: vscode = F12; vim/CoC = gd) " +"(Esta acción te llevará a `//third_party/rust/.../qr_code-.../src/lib.rs`)." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#: src/chromium/build-rules/vscode.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." +"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 "" -"Estas restricciones nos limitan a usar Rust en Chromium solo para \"nodos " -"hoja\" muy aislados, en lugar de para la interoperabilidad arbitraria de " -"Rust-C++. Si te planteas un caso práctico de Rust en Chromium, un buen punto " -"de partida es hacer un borrador de los enlaces de CXX para el límite del " -"lenguaje para ver si te parece lo suficientemente sencillo." +"Demo **esquema** y desplázate hasta el método `QrCode::with_bits` (en la " +"línea 164. El esquema se encuentra en el panel del explorador de archivos de " +"vscode. Enlaces típicos de vim/CoC = espacio o)." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#: src/chromium/build-rules/vscode.md +#, fuzzy msgid "" -"You should also discuss some of the other sticky points with CXX, for " -"example:" +"Demo **type annotations** (there are quite a few nice examples in the " +"`QrCode::with_bits` method)" msgstr "" -"También debes hablar de algunos de los otros aspectos delicados con CXX, " -"como los siguientes:" +"Demo **anotaciones de tipos** (hay varios ejemplos en el método `QrCode::" +"with_bits`)." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#: src/chromium/build-rules/vscode.md msgid "" -"Its error handling is based around C++ exceptions (given on the next slide)" +"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 "" -"Su gestión de errores se basa en las excepciones de C++ (como se muestra en " -"la siguiente diapositiva)." +"Es necesario destacar que hay que volver a ejecutar `gn gen ... --export-" +"rust-project` después de editar los archivos `BUILD.gn` (lo haremos varias " +"veces a lo largo de los ejercicios de esta sesión)." -#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md -msgid "Function pointers are awkward to use." -msgstr "Los punteros de función no son muy fáciles de usar." +#: src/exercises/chromium/build-rules.md +msgid "Build rules exercise" +msgstr "Ejercicio de reglas de compilación" -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/exercises/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:" +"In your Chromium build, add a new Rust target to `//ui/base/BUILD.gn` " +"containing:" msgstr "" -"La [compatibilidad con `Result`](https://cxx.rs/binding/result.html) de " -"CXX se basa en excepciones de C++, por lo que no podemos usarlo en Chromium. " -"Alternativas:" - -#: src/chromium/interoperability-with-cpp/error-handling.md -msgid "The `T` part of `Result` can be:" -msgstr "La parte `T` de `Result` puede:" +"En tu compilación de Chromium, añade un nuevo elemento de destino de Rust a " +"`//ui/base/build.gn` que contenga lo siguiente:" -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/exercises/chromium/build-rules.md +#, fuzzy 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:" +"**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 "" -"Devolverse a través de parámetros externos (por ejemplo, mediante `&mut T`). " -"Esto requiere que `T` se pueda transferir a través del límite de FFI. Por " -"ejemplo, `T` tiene que ser:" +"**Importante:** Ten en cuenta que `no_mangle` en este caso se considera un " +"tipo de inseguridad según el compilador de Rust, por lo que tendrás que " +"permitir código inseguro en el elemento de destino `gn`." -#: src/chromium/interoperability-with-cpp/error-handling.md -msgid "A primitive type (like `u32` or `usize`)" -msgstr "Un tipo primitivo (como `u32` o `usize`)." +#: 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 "" +"Añade este nuevo elemento de destino de Rust como una dependencia de `//ui/" +"base:base`. Declara esta función en la parte superior de `ui/base/resource/" +"resource_bundle.cc` (más adelante veremos cómo se puede automatizar mediante " +"herramientas de generación de enlaces):" -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/exercises/chromium/build-rules.md msgid "" -"A type natively supported by `cxx` (like `UniquePtr`) that has a suitable " -"default value to use in a failure case (_unlike_ `Box`)." +"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 "" -"Un tipo compatible de forma nativa con `cxx` (como `UniquePtr`) que tiene " -"un valor predeterminado adecuado para usarlo en caso de fallo (_a diferencia " -"de_ `Box`)." +"Llama a esta función desde algún lugar de `ui/base/resource/resource_bundle." +"cc`. Recomendamos hacerlo en la parte superior de `ResourceBundle::" +"RSMangleLocalizedString`. Compila y ejecuta Chromium y asegúrate de que se " +"imprima \"¡Rust te manda un saludo!\" muchas veces." -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/exercises/chromium/build-rules.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`." +"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 "" -"Mantenerse en el lado de Rust y mostrarse mediante referencia. Esto puede " -"ser necesario cuando `T` es un tipo de Rust, que no se puede transmitir " -"mediante el límite de FFI ni se puede almacenar en `UniquePtr`." +"Si usas VSCode, ahora debes configurar Rust para que funcione correctamente " +"en VSCode. Nos será útil en ejercicios posteriores. Si lo has completado " +"correctamente, podrás hacer clic con el botón derecho y pulsar \"Ir a la " +"definición\" en `println!`." -#: src/chromium/interoperability-with-cpp/error-handling.md -msgid "The `E` part of `Result` can be:" -msgstr "La parte `E` de `Result` puede:" +#: src/exercises/chromium/build-rules.md +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Where to find help" +msgstr "Dónde obtener ayuda" -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/exercises/chromium/build-rules.md msgid "" -"Returned as a boolean (e.g. `true` representing success, and `false` " -"representing failure)" +"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 "" -"Devolverse como un valor booleano (por ejemplo, `true` representa el éxito y " -"`false` representa el error)." +"Opciones disponibles de la [plantilla gn `rust_static_library`](https://" +"source.chromium.org/chromium/chromium/src/+/main:build/rust/" +"rust_static_library.gni;l=16)" -#: src/chromium/interoperability-with-cpp/error-handling.md +#: src/exercises/chromium/build-rules.md msgid "" -"Preserving error details is in theory possible, but so far hasn't been " -"needed in practice." +"Information about [`#[no_mangle]`](https://doc.rust-lang.org/beta/reference/" +"abi.html#the-no_mangle-attribute)" msgstr "" -"En teoría, es posible conservar los detalles de los errores, pero hasta " -"ahora no se ha necesitado en la práctica." - -#: src/chromium/interoperability-with-cpp/error-handling-qr.md -msgid "CXX Error Handling: QR Example" -msgstr "Manejo de Errores en CXX: Ejemplo de QR" +"Información sobre [`#[no_mangle]`](https://doc.rust-lang.org/beta/reference/" +"abi.html#the-no_mangle-attribute)" -#: src/chromium/interoperability-with-cpp/error-handling-qr.md +#: src/exercises/chromium/build-rules.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:" +"Information about [`extern \"C\"`](https://doc.rust-lang.org/std/keyword." +"extern.html)" msgstr "" -"El generador de código QR es [un ejemplo](https://source.chromium.org/" -"chromium/chromium/src/+/main:components/qr_code_generator/" -"qr_code_generator_ffi_glue.rs;l=13-18;" -"drc=7bf1b75b910ca430501b9c6a74c1d18a0223ecca) en el que el valor booleano se " -"utiliza para comunicar que el resultado es correcto o no, y dónde se puede " -"transmitir el resultado correcto a través del límite de FFI:" - -#: src/chromium/interoperability-with-cpp/error-handling-qr.md -msgid "\"qr_code_generator\"" -msgstr "\"qr_code_generator\"" +"Información sobre [`extern \"C\"`](https://doc.rust-lang.org/std/keyword." +"extern.html)" -#: src/chromium/interoperability-with-cpp/error-handling-qr.md +#: src/exercises/chromium/build-rules.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)." +"Information about gn's [`--export-rust-project`](https://gn.googlesource.com/" +"gn/+/main/docs/reference.md#compilation-database) switch" msgstr "" -"Puede que los participantes sientan curiosidad acerca de la semántica del " -"resultado de salida `out_qr_size`. No se trata del tamaño del vector, sino " -"del tamaño del código QR (y admitimos que es un poco redundante, ya que se " -"trata de la raíz cuadrada del tamaño del vector)." +"Información sobre el interruptor [`--export-rust-project`](https://gn." +"googlesource.com/gn/+/main/docs/reference.md#compilation-database) de gn" -#: src/chromium/interoperability-with-cpp/error-handling-qr.md +#: src/exercises/chromium/build-rules.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)." +"[How to install rust-analyzer in VSCode](https://code.visualstudio.com/docs/" +"languages/rust)" msgstr "" -"Cabe destacar la importancia de inicializar `out_qr_size` antes de llamar a " -"la función de Rust. La creación de una referencia de Rust que apunte a una " -"memoria no inicializada tiene como resultado un comportamiento indefinido (a " -"diferencia de C++, cuando solo el acto de desreferenciar la memoria resulta " -"en comportamiento indefinido)." +"[Cómo instalar rust-analyzer en VSCode](https://code.visualstudio.com/docs/" +"languages/rust)" -#: src/chromium/interoperability-with-cpp/error-handling-qr.md +#: src/exercises/chromium/build-rules.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." +"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 "" -"Si los participantes preguntan por `Pin`, explica por qué CXX lo necesita " -"para referencias mutables a datos de C++. Los datos de C++ no se pueden " -"mover como los datos de Rust, ya que pueden contener punteros de " -"autorreferencia." - -#: src/chromium/interoperability-with-cpp/error-handling-png.md -#, fuzzy -msgid "CXX Error Handling: PNG Example" -msgstr "Manejo de Errores" +"Este ejemplo no es habitual porque se reduce al lenguaje de " +"interoperabilidad con el mínimo común denominador, C. Tanto C++ como Rust " +"pueden declarar y llamar de forma nativa funciones ABI de C. Más adelante, " +"conectaremos C++ directamente con Rust." -#: src/chromium/interoperability-with-cpp/error-handling-png.md +#: src/exercises/chromium/build-rules.md msgid "" -"A prototype of a PNG decoder illustrates what can be done when the " -"successful result cannot be passed across the FFI boundary:" +"`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 "" -"Un prototipo de un decodificador PNG ilustra lo que se puede hacer cuando el " -"resultado correcto no se puede transmitir a través del límite de FFI:" - -#: src/chromium/interoperability-with-cpp/error-handling-png.md -msgid "\"gfx::rust_bindings\"" -msgstr "\"gfx::rust_bindings\"" +"`allow_unsafe = true` es obligatorio porque `#[no_mangle]` podría permitir " +"que Rust genere dos funciones con el mismo nombre, y Rust ya no puede " +"asegurar que se llame a la correcta." -#: src/chromium/interoperability-with-cpp/error-handling-png.md +#: src/exercises/chromium/build-rules.md msgid "" -"/// This returns an FFI-friendly equivalent of `Result,\n" -" /// ()>`.\n" +"If you need a pure Rust executable, you can also do that using the " +"`rust_executable` gn template." msgstr "" -"/// Esto devuelve un equivalente de `Result,\n" -" /// ()>`, compatible con FFI.\n" - -#: src/chromium/interoperability-with-cpp/error-handling-png.md -msgid "/// C++ bindings for the `crate::png::ResultOfPngReader` type.\n" -msgstr "/// Enlaces de C++ para el tipo `crate::png::ResultOfPngReader`.\n" - -#: src/chromium/interoperability-with-cpp/error-handling-png.md -msgid "/// C++ bindings for the `crate::png::PngReader` type.\n" -msgstr "/// Enlaces de C++ para el tipo `crate::png::PngReader`.\n" +"Si necesitas un ejecutable puro de Rust, también puedes hacerlo con la " +"plantilla gn `rust_executable`." -#: src/chromium/interoperability-with-cpp/error-handling-png.md +#: src/chromium/testing.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." +"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 "" -"`PngReader` y `ResultOfPngReader` son tipos de Rust. Los objetos de estos " -"tipos no pueden cruzar el límite de FFI sin la indirección de un `Box`. " -"No se puede tener un `out_parameter: &mut PngReader`, ya que CXX no permite " -"que C++ almacene objetos de Rust por valor." +"La comunidad de Rust suele crear las pruebas unitarias en un módulo situado " +"en el mismo archivo fuente que el código que se está probando. Este tema ya " +"se ha tratado [antes](../testing.md) en el curso y tiene este aspecto:" -#: src/chromium/interoperability-with-cpp/error-handling-png.md +#: src/chromium/testing.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`)." +"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 "" -"Este ejemplo ilustra que, aunque CXX no es compatible con plantillas ni " -"genéricos arbitrarios, podemos transmitirlos a través de los límites de FFI " -"si los especializamos de forma manual o los monomorfizamos en un tipo no " -"genérico. En el ejemplo, `ResultOfPngReader` es un tipo no genérico que " -"redirige los métodos adecuados de `Result` (por ejemplo, a `is_err`, " -"`unwrap` o `as_mut`)." - -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md -msgid "Using cxx in Chromium" -msgstr "Usar cxx en Chromium" +"En Chromium colocamos las pruebas unitarias en un archivo fuente " +"independiente y continuamos con esta práctica con Rust. De esta forma, las " +"pruebas se pueden encontrar de forma coherente y se evita volver a crear " +"archivos `.rs` (en la configuración `test`)." -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +#: src/chromium/testing.md 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" +"This results in the following options for testing Rust code in Chromium:" msgstr "" -"En Chromium, definimos un `#[cxx::bridge] mod` independiente para cada nodo " -"hoja en el que queremos usar Rust. Normalmente hay uno por cada " -"`rust_static_library`. Solo tienes que añadir" +"Esta acción genera las siguientes opciones para probar el código de Rust en " +"Chromium:" -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +#: src/chromium/testing.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" -"```" +"Native Rust tests (i.e. `#[test]`). Discouraged outside of `//third_party/" +"rust`." msgstr "" -"```gn\n" -"cxx_bindings = [ \"my_rust_file.rs\" ]\n" -" # list of files containing #[cxx::bridge], not all source files\n" -"allow_unsafe = true\n" -"```" - -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md -msgid "" -"to your existing `rust_static_library` target alongside `crate_root` and " -"`sources`." -msgstr "" -"al elemento `rust_static_library` que ya tengas junto con `crate_root` y " -"`sources`." - -#: 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 "" -"Los encabezados de C++ se generarán en una ubicación razonable, por lo que " -"puedes simplemente incluir" - -#: 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/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 "" -"Encontrarás algunas funciones de utilidad en `//base` para convertir a y " -"desde los tipos de Chromium C++ en tipos CXX de Rust y viceversa. Por " -"ejemplo, [`SpanToRustSlice`](https://source.chromium.org/chromium/chromium/" -"src/+/main:base/containers/span_rust.h;l=21)." - -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md -msgid "Students may ask --- why do we still need `allow_unsafe = true`?" -msgstr "" -"Los participantes pueden preguntarse: \"¿por qué sigue siendo necesario " -"`allow_unsafe = true`?\"" +"Pruebas nativas de Rust (es decir, `#[test]`). No se recomienda hacerlas " +"fuera de `//third_party/rust`." -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +#: src/chromium/testing.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." +"`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 "" -"La respuesta es que ningún código de C o C++ es \"seguro\" según los " -"estándares normales de Rust. Si se llama a C o C++ desde Rust, se pueden " -"llevar a cabo acciones arbitrarias en la memoria y se puede poner en peligro " -"la seguridad de los propios diseños de datos de Rust. La presencia de " -"_demasiadas_ palabras clave `unsafe` en la interoperabilidad de C o C++ " -"puede perjudicar la relación señal-ruido de dicha palabra clave, algo " -"[polémico](https://steveklabnik.com/writing/the-cxx-debate). No obstante, en " -"términos estrictos, introducir código externo en un binario de Rust puede " -"provocar un comportamiento inesperado desde el punto de vista de Rust." +"Pruebas `gtest` escritas en C++ y ejercicios con Rust mediante llamadas de " +"FFI. Suficiente cuando el código de Rust es solo una capa fina de FFI y las " +"pruebas unitarias existentes proporcionan suficiente cobertura para la " +"función." -#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +#: src/chromium/testing.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." +"`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 "" -"La respuesta exacta se encuentra en el diagrama de la parte superior de " -"[esta página](../Interop-with-cpp.md): en segundo plano, CXX genera " -"funciones de Rust `unsafe` y `extern \"C\"`, igual que hicimos de forma " -"manual en la sección anterior." - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Exercise: Interoperability with C++" -msgstr "Ejercicio: Interoperabilidad con C++" - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Part one" -msgstr "Primera parte" +"Pruebas `gtest` creadas en Rust y usando el crate en prueba a través de su " +"API pública (mediante `pub mod for_testing { ... }` si es necesario). Este " +"es el tema de las siguientes diapositivas." -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing.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." +"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 "" -"En el archivo de Rust que has creado anteriormente, añade un `#[cxx::" -"bridge]`, que especifica una sola función, denominada `hello_from_rust`, a " -"la que se llamará desde C++, sin parámetros y sin devolver ningún valor." +"Menciona que los bots de Chromium deberían hacer pruebas nativas de Rust de " +"crates de terceros tarde o temprano. (Estas pruebas rara vez son necesarias, " +"solo después de añadir o actualizar crates de terceros)." -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing.md msgid "" -"Modify your previous `hello_from_rust` function to remove `extern \"C\"` and " -"`#[no_mangle]`. This is now just a standard Rust function." +"Some examples may help illustrate when C++ `gtest` vs Rust `gtest` should be " +"used:" msgstr "" -"Modifica la función `hello_from_rust` anterior para eliminar `extern \"C\"` " -"y `#[no_mangle]`. Ahora es solo una función estándar de Rust." - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Modify your `gn` target to build these bindings." -msgstr "Modifica el elemento de destino de `gn` para compilar estos enlaces." +"Algunos ejemplos pueden ayudarte a ilustrar cuándo se debe usar `gtest` de C+" +"+ o `gtest` de Rust:" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing.md msgid "" -"In your C++ code, remove the forward-declaration of `hello_from_rust`. " -"Instead, include the generated header file." +"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 "" -"En el código C++, elimina la declaración de `hello_from_rust`. En su lugar, " -"incluye el archivo de encabezado que se ha generado." - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Build and run!" -msgstr "Compila y ejecuta." - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Part two" -msgstr "Segunda parte" +"QR cuenta con muy pocas funciones en la capa de Rust propia (solo es un " +"código pegamento de FFI) y, por lo tanto, utiliza las pruebas unitarias de C+" +"+ existentes para probar la implementación de C++ y la de Rust " +"(parametrizando las pruebas de modo que habiliten o inhabiliten Rust " +"mediante un `ScopedFeatureList`)." -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing.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." +"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 "" -"Se recomienda jugar un poco con CXX, ya que nos ayuda a pensar en la " -"flexibilidad que tiene Rust en Chromium." - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Some things to try:" -msgstr "Algunas cosas que probar:" - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Call back into C++ from Rust. You will need:" -msgstr "Vuelve a llamar a C++ desde Rust. Necesitarás lo siguiente:" +"La integración hipotética/WIP de PNG puede necesitar una implementación " +"segura en memoria de las transformaciones de píxeles que proporciona " +"`libpng` pero que faltan en el crate `png`, como por ejemplo, RGBA => BGRA o " +"corrección gamma. Dicha función puede beneficiarse de pruebas independientes " +"creadas en Rust." -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing/rust-gtest-interop.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." +"The [`rust_gtest_interop`](https://chromium.googlesource.com/chromium/src/+/" +"main/testing/rust_gtest_interop/README.md) library provides a way to:" msgstr "" -"Un archivo de encabezado adicional que puedes `include!` desde tu `cxx::" -"bridge`. Deberás declarar la función de C++ en el nuevo archivo de " -"encabezado." +"La biblioteca [`rust_gtest_interop`](https://chromium.googlesource.com/" +"chromium/src/+/main/testing/rust_gtest_interop/README.md) permite hacer lo " +"siguiente:" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing/rust-gtest-interop.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)." +"Use a Rust function as a `gtest` testcase (using the `#[gtest(...)]` " +"attribute)" msgstr "" -"Un bloque `unsafe` para llamar a una función de este tipo, o bien " -"especificar la palabra clave `unsafe` en el `#[cxx::bridge]`, [como se " -"describe aquí](https://cxx.rs/extern-c++.html#functions-and-member-" -"functions)." +"Usar una función de Rust como caso de prueba `gtest` (con el atributo " +"`#[gtest(...)]`)." -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing/rust-gtest-interop.md msgid "" -"You may also need to `#include \"third_party/rust/cxx/v1/crate/include/cxx." -"h\"`" +"Use `expect_eq!` and similar macros (similar to `assert_eq!` but not " +"panicking and not terminating the test when the assertion fails)." msgstr "" -"Es posible que también tengas que incluir `#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 "Transfiere una cadena de C++ desde C++ a Rust." +"Usar `expect_eq!` y macros similares (similares a `assert_eq!`, pero sin que " +"se produzcan pánicos o sin finalizar la prueba cuando la aserción falle)." -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Pass a reference to a C++ object into Rust." -msgstr "Pasa una referencia a un objeto de C++ en Rust." +#: src/chromium/testing/rust-gtest-interop.md +msgid "Example:" +msgstr "Ejemplo:" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing/build-gn.md msgid "" -"Intentionally get the Rust function signatures mismatched from the `#[cxx::" -"bridge]`, and get used to the errors you see." +"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 "" -"Obtén de forma intencional las firmas de la función de Rust que no coincidan " -"con el `#[cxx::bridge]` y familiarízate con los errores que veas." +"La forma más sencilla de compilar pruebas `gtest` de Rust es añadirlas a un " +"binario de prueba que ya contenga pruebas creadas en C++. Por ejemplo:" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing/build-gn.md msgid "" -"Intentionally get the C++ function signatures mismatched from the `#[cxx::" -"bridge]`, and get used to the errors you see." +"```gn\n" +"test(\"ui_base_unittests\") {\n" +" ...\n" +" sources += [ \"my_rust_lib_unittest.rs\" ]\n" +" deps += [ \":my_rust_lib\" ]\n" +"}\n" +"```" msgstr "" -"Obtén de forma intencional las firmas de la función de C++ que no coincidan " -"con el `#[cxx::bridge]` y familiarízate con los errores que veas." +"```gn\n" +"test(\"ui_base_unittests\") {\n" +" ...\n" +" sources += [ \"my_rust_lib_unittest.rs\" ]\n" +" deps += [ \":my_rust_lib\" ]\n" +"}\n" +"```" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing/build-gn.md msgid "" -"Pass a `std::unique_ptr` of some type from C++ into Rust, so that Rust can " -"own some C++ object." +"Authoring Rust tests in a separate `static_library` also works, but requires " +"manually declaring the dependency on the support libraries:" msgstr "" -"Transfiere un `std::unique_ptr` de algún tipo de C++ a Rust, para que a Rust " -"le pertenezca algún objeto de C++." +"La creación de pruebas de Rust en una `static_library` independiente también " +"funciona, pero es necesario declarar manualmente la dependencia en las " +"bibliotecas de compatibilidad:" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing/build-gn.md msgid "" -"Create a Rust object and pass it into C++, so that C++ owns it. (Hint: you " -"need a `Box`)." -msgstr "" -"Crea un objeto de Rust y transmítelo a C++ para que sea su propietario. " -"(Nota: necesitas utilizar un `Box`)." - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Declare some methods on a C++ type. Call them from Rust." -msgstr "Declara algunos métodos en un tipo de C++. Llámalos desde Rust." - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Declare some methods on a Rust type. Call them from C++." -msgstr "Declara algunos métodos en un tipo de Rust. Llámalos desde C++." - -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Part three" -msgstr "Tercera parte" - -#: src/exercises/chromium/interoperability-with-cpp.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." -msgstr "" -"Ahora que conoces los puntos fuertes y las limitaciones de la " -"interoperabilidad de CXX, piensa en un par de casos prácticos de Rust en " -"Chromium en los que la interfaz sea bastante sencilla. Haz un boceto sobre " -"cómo definirías esa interfaz." - -#: src/exercises/chromium/interoperability-with-cpp.md -#, fuzzy -msgid "The [`cxx` binding reference](https://cxx.rs/bindings.html)" +"```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 "" -"Muestra la correspondencia entre [los tipos de Rust y C++](https://cxx.rs/" -"bindings.html):" +"```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/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing/chromium-import-macro.md msgid "" -"The [`rust_static_library` gn template](https://source.chromium.org/chromium/" -"chromium/src/+/main:build/rust/rust_static_library.gni;l=16)" +"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 "" -"La [plantilla gn `rust_static_library`](https://source.chromium.org/chromium/" -"chromium/src/+/main:build/rust/rust_static_library.gni;l=16)" +"Después de añadir `:my_rust_lib` a GN `deps`, tenemos que aprender a " +"importar y usar `my_rust_lib` desde `my_rust_lib_unittest.rs`. No hemos " +"proporcionado un `crate_name` explícito para `my_rust_lib`, por lo que el " +"nombre del crate se calcula en función de la ruta y el nombre de destino " +"completos. Por suerte, podemos evitar trabajar con un nombre tan poco " +"práctico usando la macro `chromium::import!` del crate `chromium` importado " +"automáticamente:" -#: src/exercises/chromium/interoperability-with-cpp.md -msgid "Some of the questions you may encounter:" -msgstr "Estas son algunas de las preguntas que pueden surgir:" +#: src/chromium/testing/chromium-import-macro.md +msgid "\"//ui/base:my_rust_lib\"" +msgstr "\"//ui/base:my_rust_lib\"" -#: src/exercises/chromium/interoperability-with-cpp.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`." +#: src/chromium/testing/chromium-import-macro.md +msgid "Under the covers the macro expands to something similar to:" msgstr "" -"Veo un problema al inicializar una variable de tipo X con el tipo Y, donde X " -"e Y son tipos de funciones. Esto se debe a que la función de C++ no coincide " -"exactamente con la declaración de `cxx::bridge`." +"En un segundo plano, la macro se expande a algo parecido a lo siguiente:" -#: src/exercises/chromium/interoperability-with-cpp.md +#: src/chromium/testing/chromium-import-macro.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." +"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 "" -"Parece que puedo convertir libremente referencias de C++ en referencias de " -"Rust. ¿Eso no supone ningún riesgo de comportamiento indefinido? En el caso " -"de los tipos _opacos_ de CXX, no, porque su tamaño es cero. Sí supondría un " -"problema de comportamiento indefinido en el caso de los tipos triviales de " -"CXX, aunque el diseño de CXX hace que sea bastante difícil crear un ejemplo " -"así." +"Puedes obtener más información en [el comentario del documento](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) de la macro `chromium::import`." -#: src/chromium/adding-third-party-crates.md +#: src/chromium/testing/chromium-import-macro.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!" +"`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 "" -"Las bibliotecas de Rust se llaman \"crates\" y se encuentran en [crates.io]" -"(https://crates.io). _Es habitual_ que los crates de Rust dependen los unos " -"de otros." - -#: src/chromium/adding-third-party-crates.md -msgid "C++ library" -msgstr "Biblioteca C++" - -#: src/chromium/adding-third-party-crates.md -msgid "Rust crate" -msgstr "Crate de Rust" - -#: src/chromium/adding-third-party-crates.md -msgid "Build system" -msgstr "Sistema de compilación" - -#: src/chromium/adding-third-party-crates.md -msgid "Lots" -msgstr "Muchos" +"`rust_static_library` permite especificar un nombre explícito mediante la " +"propiedad `crate_name`, pero no se recomienda hacerlo. El motivo es porque " +"el nombre del crate debe ser único en todo el mundo. crates.io garantiza la " +"exclusividad de sus nombres de crate, de modo que los elementos de destino " +"de GN `cargo_crate` (generados por la herramienta `gnrt` que se explican en " +"una sección posterior) usan nombres de crate cortos." -#: src/chromium/adding-third-party-crates.md -msgid "Consistent: `Cargo.toml`" -msgstr "Consistente: `Cargo.toml`" +#: src/exercises/chromium/testing.md +msgid "Testing exercise" +msgstr "Ejercicio de pruebas" -#: src/chromium/adding-third-party-crates.md -msgid "Typical library size" -msgstr "Tamaño habitual de la biblioteca" +#: src/exercises/chromium/testing.md +msgid "Time for another exercise!" +msgstr "¡Vamos a hacer otro ejercicio!" -#: src/chromium/adding-third-party-crates.md -msgid "Large-ish" -msgstr "Grande" +#: src/exercises/chromium/testing.md +msgid "In your Chromium build:" +msgstr "En tu compilación de Chromium:" -#: src/chromium/adding-third-party-crates.md -msgid "Small" -msgstr "Pequeño" +#: 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." +msgstr "" +"Añade una función que se pueda probar junto a `hello_from_rust`. Aquí tienes " +"algunas sugerencias: añadir dos números enteros recibidos como argumentos, " +"calcular el enésimo número de la serie Fibonacci, sumar los enteros en un " +"slice, etc." -#: src/chromium/adding-third-party-crates.md -msgid "Transitive dependencies" -msgstr "Dependencias transitivas" +#: src/exercises/chromium/testing.md +msgid "Add a separate `..._unittest.rs` file with a test for the new function." +msgstr "" +"Añade un archivo `..._unittest.rs` independiente con una prueba de la nueva " +"función." -#: src/chromium/adding-third-party-crates.md -msgid "Few" -msgstr "Pocos" +#: src/exercises/chromium/testing.md +msgid "Add the new tests to `BUILD.gn`." +msgstr "Añade las nuevas pruebas a `BUILD.gn`." -#: src/chromium/adding-third-party-crates.md -msgid "For a Chromium engineer, this has pros and cons:" -msgstr "Para un ingeniero de Chromium, existen ventajas e inconvenientes:" +#: src/exercises/chromium/testing.md +msgid "Build the tests, run them, and verify that the new test works." +msgstr "" +"Compila las pruebas, ejecútalas y comprueba que la nueva prueba funciona." -#: src/chromium/adding-third-party-crates.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"All crates use a common build system so we can automate their inclusion into " -"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 "" -"Todos los crates usan un sistema de compilación común, así que podemos " -"automatizar su inclusión en Chromium..." +"La comunidad de Rust ofrece muchas opciones para la interoperabilidad de C++ " +"y Rust, y continuamente se están desarrollando nuevas herramientas. " +"Actualmente, Chromium usa la herramienta CXX." -#: src/chromium/adding-third-party-crates.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"... but, crates typically have transitive dependencies, so you will likely " -"have to bring in multiple libraries." +"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 "" -"... pero los crates suelen tener dependencias transitivas, por lo que es " -"probable que tengas que introducir varias bibliotecas." +"Describe todos los límites de tu lenguaje en un lenguaje de definición de " +"interfaz (que se parece mucho a Rust) y, a continuación, las herramientas " +"CXX generarán declaraciones de funciones y tipos tanto en Rust como en C++." -#: src/chromium/adding-third-party-crates.md -msgid "We'll discuss:" -msgstr "Hablaremos sobre los siguientes temas:" +#: src/chromium/interoperability-with-cpp.md +msgid "" +"See the [CXX tutorial](https://cxx.rs/tutorial.html) for a full example of " +"using this." +msgstr "" +"Consulta el [tutorial de CXX](https://cxx.rs/tutorial.html) para ver un " +"ejemplo completo de su uso." -#: src/chromium/adding-third-party-crates.md -msgid "How to put a crate in the Chromium source code tree" -msgstr "Cómo colocar un crate en el árbol de código fuente de Chromium." +#: src/chromium/interoperability-with-cpp.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:" +msgstr "" +"Aclara el diagrama. Explica que, en segundo plano, esto hace lo mismo que " +"hemos hecho antes. Señala que automatizar el proceso supone las siguientes " +"ventajas:" -#: src/chromium/adding-third-party-crates.md -msgid "How to make `gn` build rules for it" -msgstr "Cómo aplicarle reglas de compilación `gn`." - -#: src/chromium/adding-third-party-crates.md -msgid "How to audit its source code for sufficient safety." -msgstr "Cómo auditar su código fuente para obtener la seguridad suficiente." - -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md -msgid "Configuring the `Cargo.toml` file to add crates" -msgstr "Configurar el archivo `Cargo.toml` para añadir crates" - -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md +#: src/chromium/interoperability-with-cpp.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):" +"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 "" -"Chromium tiene un único conjunto de dependencias directas de crate " -"gestionadas de forma centralizada. Se gestionan mediante un único elemento " -"[`Cargo.toml`](https://source.chromium.org/chromium/chromium/src/+/main:" -"third_party/rust/chromium_crates_io/Cargo.toml):" +"La herramienta asegura que C++ y Rust coincidan (por ejemplo, se producen " +"errores de compilación si `#[cxx::bridge]` no coincide con las definiciones " +"de C++ o Rust reales, pero con enlaces manuales no sincronizados, se " +"obtendría un comportamiento no definido)" -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"```toml\n" -"[dependencies]\n" -"bitflags = \"1\"\n" -"cfg-if = \"1\"\n" -"cxx = \"1\"\n" -"# lots more...\n" -"```" +"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 "" -"```toml\n" -"[dependencies]\n" -"bitflags = \"1\"\n" -"cfg-if = \"1\"\n" -"cxx = \"1\"\n" -"# lots more...\n" -"```" +"La herramienta automatiza la generación de thunks FFI (funciones pequeñas, " +"compatibles con la ABI de C y gratuitas) para funciones que no son de C (por " +"ejemplo, habilitar llamadas de FFI en métodos de Rust o C++. Los enlaces " +"manuales requerirían la creación manual de estas funciones gratuitas de " +"nivel superior)." -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.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." +#: src/chromium/interoperability-with-cpp.md +msgid "The tool and the library can handle a set of core types - for example:" msgstr "" -"Al igual que con cualquier otro archivo `Cargo.toml`, puedes especificar " -"[más información sobre las dependencias](https://doc.rust-lang.org/cargo/" -"reference/specifying-dependencies.html). Lo más habitual es que se " -"especifiquen las funciones `features` que se quieran habilitar en el crate." +"La herramienta y la biblioteca pueden gestionar un conjunto de tipos " +"principales, como por ejemplo:" -#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md +#: src/chromium/interoperability-with-cpp.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." +"`&[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 "" -"Al añadir un crate a Chromium, a menudo será necesario proporcionar " -"información adicional en un archivo adicional, `gnrt_config.toml`, que " -"veremos a continuación." +"`&[T]` se puede transferir a través del límite de FFI, aunque no garantiza " +"ningún diseño concreto de ABI o de memoria. Con los enlaces manuales, `std::" +"span` y `&[T]` se tienen que desestructurar manualmente y compilarlos a " +"partir de un puntero y una longitud. Esto suele acarrear errores, ya que " +"cada lenguaje representa los slices vacíos de forma ligeramente distinta." -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md +#: src/chromium/interoperability-with-cpp.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." +"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 "" -"Junto a `Cargo.toml`, se encuentra [`gnrt_config.toml`](https://source." -"chromium.org/chromium/chromium/src/+/main:third_party/rust/" -"chromium_crates_io/gnrt_config.toml). Contiene extensiones específicas de " -"Chromium para la gestión de crates." +"Los punteros inteligentes como `std::unique_ptr`, `std::shared_ptr` o " +"`Box` se admiten de forma nativa. Con los enlaces manuales, sería necesario " +"pasar punteros sin formato compatibles con ABI de C, lo que aumentaría los " +"riesgos de tiempo de vida y de seguridad en la memoria." -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md +#: src/chromium/interoperability-with-cpp.md msgid "" -"If you add a new crate, you should specify at least the `group`. This is one " -"of:" +"`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 "" -"Si añades un nuevo crate, debes especificar al menos el atributo `group`. " -"Puede ser uno de los siguientes:" - -#: 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 "Por ejemplo:" +"Los tipos `rust::String` y `CxxString` entienden y mantienen las diferencias " +"en la representación de cadenas en los distintos lenguajes (por ejemplo, " +"`rust::String::lossy` puede crear una cadena de Rust a partir de una entrada " +"que no sea UTF8 y `rust::String::: c_str` puede terminar una cadena con un " +"carácter nulo)." -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md +#: src/chromium/interoperability-with-cpp/example-bindings.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." +"CXX requires that the whole C++/Rust boundary is declared in `cxx::bridge` " +"modules inside `.rs` source code." msgstr "" -"En función del diseño del código fuente del crate, es posible que también " -"tengas que usar este archivo para especificar dónde se pueden encontrar los " -"archivos `LICENSE`." +"CXX necesita que se declare todo el límite de C++ o Rust en los módulos " +"`cxx::bridge` del código fuente `.rs`." -#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md -msgid "" -"Later, we'll see some other things you will need to configure in this file " -"to resolve problems." -msgstr "" -"Más adelante, veremos otros elementos que tendrás que configurar en este " -"archivo para solucionar los problemas." +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "\"example/include/blobstore.h\"" +msgstr "\"example/include/blobstore.h\"" -#: 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." +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "// Definitions of Rust types and functions go here\n" msgstr "" -"La herramienta `gnrt` puede descargar crates y generar reglas `BUILD.gn`." +"// Las definiciones de los tipos y las funciones de Rust se colocan aquí\n" -#: src/chromium/adding-third-party-crates/downloading-crates.md -msgid "To start, download the crate you want like this:" -msgstr "Para empezar, descarga el crate de esta forma:" +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "Point out:" +msgstr "Señala lo siguiente:" -#: src/chromium/adding-third-party-crates/downloading-crates.md +#: src/chromium/interoperability-with-cpp/example-bindings.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." +"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 "" -"Aunque la herramienta `gnrt` forma parte del código fuente de Chromium, al " -"ejecutar este comando, se descargarán y ejecutarán sus dependencias desde " -"`crates.io`. Consulta [la sección anterior](../cargo.md) sobre la decisión " -"de seguridad." +"Aunque parece un `mod` de Rust habitual, la macro de procedimiento `#[cxx::" +"bridge]` es capaz de desempeñar tareas complejas. El código generado es " +"bastante más sofisticado, aunque aun así da como resultado un `mod` llamado " +"`ffi` en el código." -#: src/chromium/adding-third-party-crates/downloading-crates.md -msgid "This `vendor` command may download:" -msgstr "Este comando `vendor` puede descargar los siguientes elementos:" +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "Native support for C++'s `std::unique_ptr` in Rust" +msgstr "Compatibilidad nativa con `std::unique_ptr` de C++ en Rust." -#: src/chromium/adding-third-party-crates/downloading-crates.md -msgid "Your crate" -msgstr "Tu crate" +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "Native support for Rust slices in C++" +msgstr "Compatibilidad nativa con los slices de Rust en C++." -#: src/chromium/adding-third-party-crates/downloading-crates.md -msgid "Direct and transitive dependencies" -msgstr "Dependencias directas y transitivas." +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "Calls from C++ to Rust, and Rust types (in the top part)" +msgstr "Llamadas de C++ a Rust y tipos de Rust (en la parte superior)." -#: src/chromium/adding-third-party-crates/downloading-crates.md -msgid "" -"New versions of other crates, as required by `cargo` to resolve the complete " -"set of crates required by Chromium." -msgstr "" -"Nuevas versiones de otros crates, según lo requiera `cargo` para resolver el " -"conjunto completo de crates que requiere Chromium." +#: src/chromium/interoperability-with-cpp/example-bindings.md +msgid "Calls from Rust to C++, and C++ types (in the bottom part)" +msgstr "Llamadas de Rust a C++ y tipos de C++ (en la parte inferior)." -#: src/chromium/adding-third-party-crates/downloading-crates.md +#: src/chromium/interoperability-with-cpp/example-bindings.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." +"**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 "" -"Chromium mantiene parches para algunos crates, que se conservan en `//" -"third_party/rust/chromium_crates_io/patches`. Se volverán a aplicar " -"automáticamente pero, si no se puede aplicar el parche, es posible que " -"tengas que realizar una acción manual." +"**Error común**: _Parece_ que Rust está analizando un encabezado de C++, " +"pero no es así. Rust nunca interpreta este encabezado, sino que simplifica " +"`#include`d en el código C++ generado para ayudar a los compiladores de C++." -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +#, fuzzy msgid "" -"Once you've downloaded the crate, generate the `BUILD.gn` files like this:" +"By far the most useful page when using CXX is the [type reference](https://" +"cxx.rs/bindings.html)." msgstr "" -"Una vez que hayas descargado el crate, genera los archivos `BUILD.gn` como " -"se indica a continuación:" +"Muestra la correspondencia entre [los tipos de Rust y C++](https://cxx.rs/" +"bindings.html):" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md -msgid "Now run `git status`. You should find:" -msgstr "Ahora, ejecuta `git status`. Deberías encontrar lo siguiente:" +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +msgid "CXX fundamentally suits cases where:" +msgstr "CXX se adapta básicamente a los casos en los que:" -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" -"At least one new crate source code in `third_party/rust/chromium_crates_io/" -"vendor`" +"Your Rust-C++ interface is sufficiently simple that you can declare all of " +"it." msgstr "" -"Al menos un nuevo código fuente de crate en `third_party/rust/" -"chromium_crates_io/vendor`." +"La interfaz de Rust-C++ es lo suficientemente sencilla como para se pueda " +"declarar por completo." -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" -"At least one new `BUILD.gn` in `third_party/rust//v`" +"You're using only the types natively supported by CXX already, for example " +"`std::unique_ptr`, `std::string`, `&[u8]` etc." msgstr "" -"Al menos un nuevo `BUILD.gn` en `third_party/rust//v`." +"Solo estás usando los tipos compatibles de forma nativa con CXX, como `std::" +"unique_ptr`, `std::string` o `&[u8]`, entre otros." -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md -msgid "An appropriate `README.chromium`" -msgstr "Un archivo `README.chromium` adecuado." - -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" -"The \"major semver version\" is a [Rust \"semver\" version number](https://" -"doc.rust-lang.org/cargo/reference/semver.html)." +"It has many limitations --- for example lack of support for Rust's `Option` " +"type." msgstr "" -"La \"versión semver mayor\" es un [número de versión \"semver\" de Rust]" -"(https://doc.rust-lang.org/cargo/reference/semver.html)." +"Tiene muchas limitaciones, por ejemplo, la falta de compatibilidad con el " +"tipo `Option` de Rust." -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md msgid "" -"Take a close look, especially at the things generated in `third_party/rust`." +"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 "" -"Analiza la situación con detalle, sobre todo los elementos generados en " -"`third_party/rust`." +"Estas restricciones nos limitan a usar Rust en Chromium solo para \"nodos " +"hoja\" muy aislados, en lugar de para la interoperabilidad arbitraria de " +"Rust-C++. Si te planteas un caso práctico de Rust en Chromium, un buen punto " +"de partida es hacer un borrador de los enlaces de CXX para el límite del " +"lenguaje para ver si te parece lo suficientemente sencillo." -#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.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." +"You should also discuss some of the other sticky points with CXX, for " +"example:" msgstr "" -"Habla un poco sobre el semver y, concretamente, sobre la forma en que " -"Chromium permite que existan varias versiones incompatibles de un crate. No " -"es una situación recomendable, pero a veces es necesaria en el ecosistema de " -"Cargo." +"También debes hablar de algunos de los otros aspectos delicados con CXX, " +"como los siguientes:" -#: src/chromium/adding-third-party-crates/resolving-problems.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.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." +"Its error handling is based around C++ exceptions (given on the next slide)" msgstr "" -"Si la compilación falla, puede deberse a un `build.rs`, programas que llevan " -"a cabo acciones arbitrarias durante la compilación. Esto difiere de los " -"diseños de `gn` y `ninja`, que tienen como objetivo crear reglas de " -"compilación estáticas y deterministas para maximizar el paralelismo y la " -"repetibilidad de las compilaciones." +"Su gestión de errores se basa en las excepciones de C++ (como se muestra en " +"la siguiente diapositiva)." -#: src/chromium/adding-third-party-crates/resolving-problems.md +#: src/chromium/interoperability-with-cpp/limitations-of-cxx.md +msgid "Function pointers are awkward to use." +msgstr "Los punteros de función no son muy fáciles de usar." + +#: src/chromium/interoperability-with-cpp/error-handling.md msgid "" -"Some `build.rs` actions are automatically supported; others require action:" +"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 "" -"Algunas acciones `build.rs` son admitidas automáticamente, pero otras deben " -"llevar a cabo alguna acción:" - -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "build script effect" -msgstr "efecto de scripts de compilación" - -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Supported by our gn templates" -msgstr "Compatible con nuestras plantillas de gn" +"La [compatibilidad con `Result`](https://cxx.rs/binding/result.html) de " +"CXX se basa en excepciones de C++, por lo que no podemos usarlo en Chromium. " +"Alternativas:" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Work required by you" -msgstr "Acciones que debes llevar a cabo" +#: src/chromium/interoperability-with-cpp/error-handling.md +msgid "The `T` part of `Result` can be:" +msgstr "La parte `T` de `Result` puede:" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Checking rustc version to configure features on and off" -msgstr "Comprobar la versión de rustc para activar y desactivar funciones" +#: src/chromium/interoperability-with-cpp/error-handling.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:" +msgstr "" +"Devolverse a través de parámetros externos (por ejemplo, mediante `&mut T`). " +"Esto requiere que `T` se pueda transferir a través del límite de FFI. Por " +"ejemplo, `T` tiene que ser:" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "None" -msgstr "Ninguno" +#: src/chromium/interoperability-with-cpp/error-handling.md +msgid "A primitive type (like `u32` or `usize`)" +msgstr "Un tipo primitivo (como `u32` o `usize`)." -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Checking platform or CPU to configure features on and off" -msgstr "Comprobar la plataforma o la CPU para activar y desactivar funciones" +#: src/chromium/interoperability-with-cpp/error-handling.md +msgid "" +"A type natively supported by `cxx` (like `UniquePtr`) that has a suitable " +"default value to use in a failure case (_unlike_ `Box`)." +msgstr "" +"Un tipo compatible de forma nativa con `cxx` (como `UniquePtr`) que tiene " +"un valor predeterminado adecuado para usarlo en caso de fallo (_a diferencia " +"de_ `Box`)." -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Generating code" -msgstr "Generar código" +#: src/chromium/interoperability-with-cpp/error-handling.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`." +msgstr "" +"Mantenerse en el lado de Rust y mostrarse mediante referencia. Esto puede " +"ser necesario cuando `T` es un tipo de Rust, que no se puede transmitir " +"mediante el límite de FFI ni se puede almacenar en `UniquePtr`." -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Yes - specify in `gnrt_config.toml`" -msgstr "Sí: especificar en `gnrt_config.toml`" +#: src/chromium/interoperability-with-cpp/error-handling.md +msgid "The `E` part of `Result` can be:" +msgstr "La parte `E` de `Result` puede:" -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Building C/C++" -msgstr "Compilar en C o C++" +#: src/chromium/interoperability-with-cpp/error-handling.md +msgid "" +"Returned as a boolean (e.g. `true` representing success, and `false` " +"representing failure)" +msgstr "" +"Devolverse como un valor booleano (por ejemplo, `true` representa el éxito y " +"`false` representa el error)." -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Patch around it" -msgstr "Poner un parche" +#: src/chromium/interoperability-with-cpp/error-handling.md +msgid "" +"Preserving error details is in theory possible, but so far hasn't been " +"needed in practice." +msgstr "" +"En teoría, es posible conservar los detalles de los errores, pero hasta " +"ahora no se ha necesitado en la práctica." -#: src/chromium/adding-third-party-crates/resolving-problems.md -msgid "Arbitrary other actions" -msgstr "Otras acciones arbitrarias" +#: src/chromium/interoperability-with-cpp/error-handling-qr.md +msgid "CXX Error Handling: QR Example" +msgstr "Manejo de Errores en CXX: Ejemplo de QR" -#: src/chromium/adding-third-party-crates/resolving-problems.md +#: src/chromium/interoperability-with-cpp/error-handling-qr.md msgid "" -"Fortunately, most crates don't contain a build script, and fortunately, most " -"build scripts only do the top two actions." +"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 "" -"Por suerte, la mayoría de los crates no contienen scripts de compilación y " -"la mayoría de estos scripts de compilación solo llevan a cabo dos acciones " -"principales." +"El generador de código QR es [un ejemplo](https://source.chromium.org/" +"chromium/chromium/src/+/main:components/qr_code_generator/" +"qr_code_generator_ffi_glue.rs;l=13-18;" +"drc=7bf1b75b910ca430501b9c6a74c1d18a0223ecca) en el que el valor booleano se " +"utiliza para comunicar que el resultado es correcto o no, y dónde se puede " +"transmitir el resultado correcto a través del límite de FFI:" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.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 "" -"If `ninja` complains about missing files, check the `build.rs` to see if it " -"writes source code files." +"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 "" -"Si `ninja` se queja de que faltan archivos, comprueba `build.rs` para ver si " -"escribe archivos de código fuente." +"Puede que los participantes sientan curiosidad acerca de la semántica del " +"resultado de salida `out_qr_size`. No se trata del tamaño del vector, sino " +"del tamaño del código QR (y admitimos que es un poco redundante, ya que se " +"trata de la raíz cuadrada del tamaño del vector)." -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md +#: src/chromium/interoperability-with-cpp/error-handling-qr.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:" +"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 "" -"Si es así, modifica [`gnrt_config.toml`](../configuring-gnrt-config-toml.md) " -"para añadir `build-script-outputs` al crate. Si se trata de una dependencia " -"transitiva, de la que el código Chromium no debería depender de forma " -"directa, añade también `allow-first-party-usage=false`. En ese archivo ya " -"hay varios ejemplos:" +"Cabe destacar la importancia de inicializar `out_qr_size` antes de llamar a " +"la función de Rust. La creación de una referencia de Rust que apunte a una " +"memoria no inicializada tiene como resultado un comportamiento indefinido (a " +"diferencia de C++, cuando solo el acto de desreferenciar la memoria resulta " +"en comportamiento indefinido)." -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md +#: src/chromium/interoperability-with-cpp/error-handling-qr.md msgid "" -"```toml\n" -"[crate.unicode-linebreak]\n" -"allow-first-party-usage = false\n" -"build-script-outputs = [\"tables.rs\"]\n" -"```" +"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 "" -"```toml\n" -"[crate.unicode-linebreak]\n" -"allow-first-party-usage = false\n" -"build-script-outputs = [\"tables.rs\"]\n" -"```" +"Si los participantes preguntan por `Pin`, explica por qué CXX lo necesita " +"para referencias mutables a datos de C++. Los datos de C++ no se pueden " +"mover como los datos de Rust, ya que pueden contener punteros de " +"autorreferencia." -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md +#: src/chromium/interoperability-with-cpp/error-handling-png.md +#, fuzzy +msgid "CXX Error Handling: PNG Example" +msgstr "Manejo de Errores" + +#: src/chromium/interoperability-with-cpp/error-handling-png.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." +"A prototype of a PNG decoder illustrates what can be done when the " +"successful result cannot be passed across the FFI boundary:" msgstr "" -"A continuación, vuelve a ejecutar [`gnrt.py -- gen`](../generating-gn-build-" -"rules.md) para generar de nuevo los archivos `build.gn` e informar al ninja " -"de que este archivo de salida concreto se usa como entrada en los pasos de " -"compilación posteriores." +"Un prototipo de un decodificador PNG ilustra lo que se puede hacer cuando el " +"resultado correcto no se puede transmitir a través del límite de FFI:" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.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 "" -"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." +"/// This returns an FFI-friendly equivalent of `Result,\n" +" /// ()>`.\n" msgstr "" -"Algunos crates usan el crate [`cc`](https://crates.io/crates/cc) para " -"compilar y vincular bibliotecas de C y C++. Otros crates analizan C y C++ " -"mediante [`bindgen`](https://crates.io/crates/bindgen) en sus scripts de " -"compilación. Estas acciones no se pueden llevar a cabo en un contexto de " -"Chromium, ya que nuestro sistema de compilación gn, ninja y LLVM es muy " -"específico a la hora de expresar las relaciones entre las acciones de " -"compilación." - -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md -msgid "So, your options are:" -msgstr "Por lo tanto, las opciones son las siguientes:" +"/// Esto devuelve un equivalente de `Result,\n" +" /// ()>`, compatible con FFI.\n" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md -msgid "Avoid these crates" -msgstr "Evitar estos crates." +#: src/chromium/interoperability-with-cpp/error-handling-png.md +msgid "/// C++ bindings for the `crate::png::ResultOfPngReader` type.\n" +msgstr "/// Enlaces de C++ para el tipo `crate::png::ResultOfPngReader`.\n" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md -msgid "Apply a patch to the crate." -msgstr "Aplicar un parche al crate." +#: src/chromium/interoperability-with-cpp/error-handling-png.md +msgid "/// C++ bindings for the `crate::png::PngReader` type.\n" +msgstr "/// Enlaces de C++ para el tipo `crate::png::PngReader`.\n" -#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md +#: src/chromium/interoperability-with-cpp/error-handling-png.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." +"`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 "" -"Los parches deben guardarse en `third_party/rust/chromium_crates_io/patches/" -"`, como los [parches para el crate `cxx`](https://source.chromium.org/" -"chromium/chromium/src/+/main:third_party/rust/chromium_crates_io/patches/" -"cxx/), y `gnrt` lo aplicará automáticamente cada vez que actualice el crate." +"`PngReader` y `ResultOfPngReader` son tipos de Rust. Los objetos de estos " +"tipos no pueden cruzar el límite de FFI sin la indirección de un `Box`. " +"No se puede tener un `out_parameter: &mut PngReader`, ya que CXX no permite " +"que C++ almacene objetos de Rust por valor." -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md +#: src/chromium/interoperability-with-cpp/error-handling-png.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." +"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 "" -"Una vez que se ha añadido un crate de terceros y se han generado reglas de " -"compilación, utilizar un crate es sencillo. Busca tu elemento de destino " -"`rust_static_library` y añade un `dep` en el `:lib` dentro del crate." +"Este ejemplo ilustra que, aunque CXX no es compatible con plantillas ni " +"genéricos arbitrarios, podemos transmitirlos a través de los límites de FFI " +"si los especializamos de forma manual o los monomorfizamos en un tipo no " +"genérico. En el ejemplo, `ResultOfPngReader` es un tipo no genérico que " +"redirige los métodos adecuados de `Result` (por ejemplo, a `is_err`, " +"`unwrap` o `as_mut`)." -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md -msgid "Specifically," -msgstr "Específicamente:" +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +msgid "Using cxx in Chromium" +msgstr "Usar cxx en Chromium" -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md msgid "" -"```bob\n" -" +------------+ +----------------------+\n" -"\"//third_party/rust\" | crate name | \"/v\" | major semver version | \":" -"lib\"\n" -" +------------+ +----------------------+\n" -"```" +"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 "" -"```bob\n" -" +------------+ +----------------------+\n" -"\"//third_party/rust\" | crate name | \"/v\" | major semver version | \":" -"lib\"\n" -" +------------+ +----------------------+\n" -"```" +"En Chromium, definimos un `#[cxx::bridge] mod` independiente para cada nodo " +"hoja en el que queremos usar Rust. Normalmente hay uno por cada " +"`rust_static_library`. Solo tienes que añadir" -#: src/chromium/adding-third-party-crates/depending-on-a-crate.md +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.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" +"cxx_bindings = [ \"my_rust_file.rs\" ]\n" +" # list of files containing #[cxx::bridge], not all source files\n" +"allow_unsafe = true\n" "```" 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" +"cxx_bindings = [ \"my_rust_file.rs\" ]\n" +" # list of files containing #[cxx::bridge], not all source files\n" +"allow_unsafe = true\n" "```" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md -msgid "Auditing Third Party Crates" -msgstr "Auditoría de Crates de Terceros" - -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.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?" +"to your existing `rust_static_library` target alongside `crate_root` and " +"`sources`." msgstr "" -"Añadir nuevas bibliotecas está sujeto a las [políticas](https://chromium." -"googlesource.com/chromium/src/+/refs/heads/main/docs/rust.md#Third_party-" -"review) estándar de Chromium, pero también a la revisión de seguridad. Como " -"puede que no solo incluyas un único crate sino también dependencias " -"transitivas, es posible que haya mucho código que revisar. Por otro lado, el " -"código de Rust seguro puede tener efectos secundarios negativos limitados. " -"¿Cómo se revisa?" +"al elemento `rust_static_library` que ya tengas junto con `crate_root` y " +"`sources`." -#: src/chromium/adding-third-party-crates/reviews-and-audits.md -msgid "" -"Over time Chromium aims to move to a process based around [cargo vet]" -"(https://mozilla.github.io/cargo-vet/)." +#: 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 "" -"Con el tiempo, Chromium intentará adoptar un proceso basado en [cargo vet]" -"(https://mozilla.github.io/cargo-vet/)." +"Los encabezados de C++ se generarán en una ubicación razonable, por lo que " +"puedes simplemente incluir" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md -msgid "" -"Meanwhile, for each new crate addition, we are checking for the following:" -msgstr "Mientras tanto, se debe hacer lo siguiente para cada nuevo crate:" +#: 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/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.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?" +"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 "" -"Entender por qué se usa cada crate. ¿Cuál es la relación entre los crates? " -"Si el sistema de compilación de cada crate contiene un archivo `build.rs` o " -"macros de procedimiento, averigua para qué sirven. ¿Son compatibles con la " -"forma en la que se compila normalmente Chromium?" +"Encontrarás algunas funciones de utilidad en `//base` para convertir a y " +"desde los tipos de Chromium C++ en tipos CXX de Rust y viceversa. Por " +"ejemplo, [`SpanToRustSlice`](https://source.chromium.org/chromium/chromium/" +"src/+/main:base/containers/span_rust.h;l=21)." -#: src/chromium/adding-third-party-crates/reviews-and-audits.md -msgid "Check each crate seems to be reasonably well maintained" -msgstr "Comprobar que cada crate tenga un mantenimiento razonable." +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.md +msgid "Students may ask --- why do we still need `allow_unsafe = true`?" +msgstr "" +"Los participantes pueden preguntarse: \"¿por qué sigue siendo necesario " +"`allow_unsafe = true`?\"" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.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))" +"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 "" -"Usar `cd third-party/rust/chromium_crates_io; cargo audit` para comprobar si " -"existen vulnerabilidades (primero se tiene que usar `cargo install cargo-" -"audit`, lo que, irónicamente, implica descargar muchas dependencias de " -"Internet[2](../cargo.md))." +"La respuesta es que ningún código de C o C++ es \"seguro\" según los " +"estándares normales de Rust. Si se llama a C o C++ desde Rust, se pueden " +"llevar a cabo acciones arbitrarias en la memoria y se puede poner en peligro " +"la seguridad de los propios diseños de datos de Rust. La presencia de " +"_demasiadas_ palabras clave `unsafe` en la interoperabilidad de C o C++ " +"puede perjudicar la relación señal-ruido de dicha palabra clave, algo " +"[polémico](https://steveklabnik.com/writing/the-cxx-debate). No obstante, en " +"términos estrictos, introducir código externo en un binario de Rust puede " +"provocar un comportamiento inesperado desde el punto de vista de Rust." -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/chromium/interoperability-with-cpp/using-cxx-in-chromium.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)" +"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 "" -"Asegúrate de que cualquier código `unsafe` sea adecuado para la [Regla de " -"dos](https://chromium.googlesource.com/chromium/src/+/main/docs/security/" -"rule-of-2.md#unsafe-code-in-safe-languages)." +"La respuesta exacta se encuentra en el diagrama de la parte superior de " +"[esta página](../Interop-with-cpp.md): en segundo plano, CXX genera " +"funciones de Rust `unsafe` y `extern \"C\"`, igual que hicimos de forma " +"manual en la sección anterior." -#: src/chromium/adding-third-party-crates/reviews-and-audits.md -msgid "Check for any use of `fs` or `net` APIs" -msgstr "Comprobar si se usan las APIs `fs` o `net`." +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Exercise: Interoperability with C++" +msgstr "Ejercicio: Interoperabilidad con C++" -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Part one" +msgstr "Primera parte" + +#: src/exercises/chromium/interoperability-with-cpp.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.)" +"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 "" -"Leer todo el código con suficiente profundidad para comprobar si hay algo " -"fuera de lugar que pueda haberse insertado de forma malintencionada. (Es " -"imposible hacerlo perfecto, ya que, a menudo, hay demasiado código)." +"En el archivo de Rust que has creado anteriormente, añade un `#[cxx::" +"bridge]`, que especifica una sola función, denominada `hello_from_rust`, a " +"la que se llamará desde C++, sin parámetros y sin devolver ningún valor." -#: src/chromium/adding-third-party-crates/reviews-and-audits.md +#: src/exercises/chromium/interoperability-with-cpp.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." +"Modify your previous `hello_from_rust` function to remove `extern \"C\"` and " +"`#[no_mangle]`. This is now just a standard Rust function." msgstr "" -"Estas son solo algunas directrices, trabaja con revisores de " -"`security@chromium.org` para determinar la forma adecuada de utilizar los " -"crates." - -#: src/chromium/adding-third-party-crates/checking-in.md -msgid "Checking Crates into Chromium Source Code" -msgstr "Comprobar crates en el código fuente de Chromium" - -#: src/chromium/adding-third-party-crates/checking-in.md -msgid "`git status` should reveal:" -msgstr "`git status` debe revelar lo siguiente:" +"Modifica la función `hello_from_rust` anterior para eliminar `extern \"C\"` " +"y `#[no_mangle]`. Ahora es solo una función estándar de Rust." -#: src/chromium/adding-third-party-crates/checking-in.md -msgid "Crate code in `//third_party/rust/chromium_crates_io`" -msgstr "Código del crate en `//third_party/rust/chromium_crates_io`." +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Modify your `gn` target to build these bindings." +msgstr "Modifica el elemento de destino de `gn` para compilar estos enlaces." -#: src/chromium/adding-third-party-crates/checking-in.md +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"Metadata (`BUILD.gn` and `README.chromium`) in `//third_party/rust//" -"`" +"In your C++ code, remove the forward-declaration of `hello_from_rust`. " +"Instead, include the generated header file." msgstr "" -"Metadatos (`BUILD.gn` y `README.chromium`) en `//third_party/rust//" -"`." +"En el código C++, elimina la declaración de `hello_from_rust`. En su lugar, " +"incluye el archivo de encabezado que se ha generado." -#: src/chromium/adding-third-party-crates/checking-in.md -msgid "Please also add an `OWNERS` file in the latter location." -msgstr "Añade también un archivo `OWNERS` en esta última ubicación." +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Build and run!" +msgstr "Compila y ejecuta." -#: src/chromium/adding-third-party-crates/checking-in.md +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Part two" +msgstr "Segunda parte" + +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"You should land all this, along with your `Cargo.toml` and `gnrt_config." -"toml` changes, into the Chromium repo." +"It's a good idea to play with CXX a little. It helps you think about how " +"flexible Rust in Chromium actually is." msgstr "" -"Deberías llevar todo esto, junto con los cambios de `Cargo.toml` y " -"`gnrt_config.toml`, al repositorio de Chromium." +"Se recomienda jugar un poco con CXX, ya que nos ayuda a pensar en la " +"flexibilidad que tiene Rust en Chromium." -#: src/chromium/adding-third-party-crates/checking-in.md +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Some things to try:" +msgstr "Algunas cosas que probar:" + +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Call back into C++ from Rust. You will need:" +msgstr "Vuelve a llamar a C++ desde Rust. Necesitarás lo siguiente:" + +#: src/exercises/chromium/interoperability-with-cpp.md msgid "" -"**Important**: you need to use `git add -f` because otherwise `.gitignore` " -"files may result in some files being skipped." +"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 "" -"**Importante**: Debes usar `git add -f`, de lo contrario, los archivos `." -"gitignore` pueden provocar que se omitan algunos archivos." +"Un archivo de encabezado adicional que puedes `include!` desde tu `cxx::" +"bridge`. Deberás declarar la función de C++ en el nuevo archivo de " +"encabezado." -#: src/chromium/adding-third-party-crates/checking-in.md +#: src/exercises/chromium/interoperability-with-cpp.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:" +"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 "" -"Si lo haces, es posible que veas que las comprobaciones presubmit no se han " -"completado porque incluyen lenguaje no inclusivo. Esto se debe a que los " -"datos de crate de Rust suelen incluir nombres de ramas en git y muchos " -"proyectos siguen empleando terminología no inclusiva. Por lo tanto, puede " -"que debas ejecutar lo siguiente:" +"Un bloque `unsafe` para llamar a una función de este tipo, o bien " +"especificar la palabra clave `unsafe` en el `#[cxx::bridge]`, [como se " +"describe aquí](https://cxx.rs/extern-c++.html#functions-and-member-" +"functions)." -#: src/chromium/adding-third-party-crates/keeping-up-to-date.md +#: src/exercises/chromium/interoperability-with-cpp.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." +"You may also need to `#include \"third_party/rust/cxx/v1/crate/include/cxx." +"h\"`" msgstr "" -"Como PROPIETARIO de cualquier dependencia de Chromium de terceros, [se " -"espera que la actualices con las correcciones de seguridad](https://chromium." -"googlesource.com/chromium/src/+/main/docs/adding_to_third_party.md#add-" -"owners). La idea es que pronto automaticemos esto para los crates de Rust, " -"pero por ahora sigue siendo tu responsabilidad, igual que cualquier otra " -"dependencia de terceros." +"Es posible que también tengas que incluir `#include \"third_party/rust/cxx/" +"v1/crate/include/cxx.h\"`" -#: src/exercises/chromium/third-party.md +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Pass a C++ string from C++ into Rust." +msgstr "Transfiere una cadena de C++ desde C++ a Rust." + +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Pass a reference to a C++ object into Rust." +msgstr "Pasa una referencia a un objeto de C++ en Rust." + +#: src/exercises/chromium/interoperability-with-cpp.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." +"Intentionally get the Rust function signatures mismatched from the `#[cxx::" +"bridge]`, and get used to the errors you see." msgstr "" -"Añade [uwuify](https://crates.io/crates/uwuify) a Chromium para desactivar " -"las [funciones predeterminadas] del crate (https://doc.rust-lang.org/cargo/" -"reference/features.html#the-default-feature). Supongamos que el crate se " -"usará en el envío de Chromium, pero no para gestionar entradas no fiables." +"Obtén de forma intencional las firmas de la función de Rust que no coincidan " +"con el `#[cxx::bridge]` y familiarízate con los errores que veas." -#: src/exercises/chromium/third-party.md +#: src/exercises/chromium/interoperability-with-cpp.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`)." +"Intentionally get the C++ function signatures mismatched from the `#[cxx::" +"bridge]`, and get used to the errors you see." msgstr "" -"(En el siguiente ejercicio, usaremos uwuify de Chromium, pero puedes " -"saltarte este paso y hacerlo ahora si quieres. También puedes crear un nuevo " -"[destino `rust_executable`](https://source.chromium.org/chromium/chromium/" -"src/+/main:build/rust/rust_executable.gni) que utilice `uwuify`)." +"Obtén de forma intencional las firmas de la función de C++ que no coincidan " +"con el `#[cxx::bridge]` y familiarízate con los errores que veas." -#: src/exercises/chromium/third-party.md -msgid "Students will need to download lots of transitive dependencies." +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "" +"Pass a `std::unique_ptr` of some type from C++ into Rust, so that Rust can " +"own some C++ object." msgstr "" -"Los participantes tendrán que descargar muchas dependencias transitivas." - -#: src/exercises/chromium/third-party.md -msgid "The total crates needed are:" -msgstr "Estos son los crates que se necesitan:" - -#: src/exercises/chromium/third-party.md -#, fuzzy -msgid "`instant`," -msgstr "Por ejemplo:" - -#: 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`" +"Transfiere un `std::unique_ptr` de algún tipo de C++ a Rust, para que a Rust " +"le pertenezca algún objeto de C++." -#: src/exercises/chromium/third-party.md -msgid "`redox_syscall`," -msgstr "`redox_syscall`" +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "" +"Create a Rust object and pass it into C++, so that C++ owns it. (Hint: you " +"need a `Box`)." +msgstr "" +"Crea un objeto de Rust y transmítelo a C++ para que sea su propietario. " +"(Nota: necesitas utilizar un `Box`)." -#: src/exercises/chromium/third-party.md -msgid "`scopeguard`," -msgstr "`scopeguard`" +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Declare some methods on a C++ type. Call them from Rust." +msgstr "Declara algunos métodos en un tipo de C++. Llámalos desde Rust." -#: src/exercises/chromium/third-party.md -msgid "`smallvec`, and" -msgstr "`smallvec`" +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Declare some methods on a Rust type. Call them from C++." +msgstr "Declara algunos métodos en un tipo de Rust. Llámalos desde C++." -#: src/exercises/chromium/third-party.md -msgid "`uwuify`." -msgstr "`uwuify`" +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Part three" +msgstr "Tercera parte" -#: 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." +"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 "" -"Si los alumnos se descargan más datos, seguramente habrán olvidado " -"desactivar las funciones predeterminadas." +"Ahora que conoces los puntos fuertes y las limitaciones de la " +"interoperabilidad de CXX, piensa en un par de casos prácticos de Rust en " +"Chromium en los que la interfaz sea bastante sencilla. Haz un boceto sobre " +"cómo definirías esa interfaz." -#: src/exercises/chromium/third-party.md -msgid "" -"Thanks to [Daniel Liu](https://github.com/Daniel-Liu-c0deb0t) for this crate!" +#: src/exercises/chromium/interoperability-with-cpp.md +#, fuzzy +msgid "The [`cxx` binding reference](https://cxx.rs/bindings.html)" msgstr "" -"Gracias a [Daniel Liu](https://github.com/Daniel-Liu-c0deb0t) por este crate." - -#: src/exercises/chromium/bringing-it-together.md -msgid "Bringing It Together --- Exercise" -msgstr "Poner en práctica todo lo aprendido: ejercicio" +"Muestra la correspondencia entre [los tipos de Rust y C++](https://cxx.rs/" +"bindings.html):" -#: 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." +"The [`rust_static_library` gn template](https://source.chromium.org/chromium/" +"chromium/src/+/main:build/rust/rust_static_library.gni;l=16)" msgstr "" -"En este ejercicio, vas a añadir una función de Chromium completamente nueva " -"que pondrá en práctica todo lo que hemos aprendido." +"La [plantilla gn `rust_static_library`](https://source.chromium.org/chromium/" +"chromium/src/+/main:build/rust/rust_static_library.gni;l=16)" -#: src/exercises/chromium/bringing-it-together.md -msgid "The Brief from Product Management" -msgstr "Resumen de la gestión de productos" +#: src/exercises/chromium/interoperability-with-cpp.md +msgid "Some of the questions you may encounter:" +msgstr "Estas son algunas de las preguntas que pueden surgir:" -#: src/exercises/chromium/bringing-it-together.md +#: src/exercises/chromium/interoperability-with-cpp.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." +"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 "" -"Se ha descubierto una comunidad de hadas que habita en una selva tropical " -"remota. Es importante que les enviemos la versión Chromium para hadas lo " -"antes posible." +"Veo un problema al inicializar una variable de tipo X con el tipo Y, donde X " +"e Y son tipos de funciones. Esto se debe a que la función de C++ no coincide " +"exactamente con la declaración de `cxx::bridge`." -#: 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." -msgstr "" -"El requisito es traducir todas las cadenas de la IU de Chromium al idioma de " -"las hadas." +"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 "" +"Parece que puedo convertir libremente referencias de C++ en referencias de " +"Rust. ¿Eso no supone ningún riesgo de comportamiento indefinido? En el caso " +"de los tipos _opacos_ de CXX, no, porque su tamaño es cero. Sí supondría un " +"problema de comportamiento indefinido en el caso de los tipos triviales de " +"CXX, aunque el diseño de CXX hace que sea bastante difícil crear un ejemplo " +"así." -#: src/exercises/chromium/bringing-it-together.md +#: src/chromium/adding-third-party-crates.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." +"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 "" -"No hay tiempo para obtener las traducciones adecuadas pero, por suerte, el " -"lenguaje de las hadas se parece mucho al inglés y hay un crate de Rust que " -"hace las traducciones." +"Las bibliotecas de Rust se llaman \"crates\" y se encuentran en [crates.io]" +"(https://crates.io). _Es habitual_ que los crates de Rust dependen los unos " +"de otros." -#: src/exercises/chromium/bringing-it-together.md +#: src/chromium/adding-third-party-crates.md +msgid "Property" +msgstr "Propiedad" + +#: src/chromium/adding-third-party-crates.md +msgid "C++ library" +msgstr "Biblioteca C++" + +#: src/chromium/adding-third-party-crates.md +msgid "Rust crate" +msgstr "Crate de Rust" + +#: src/chromium/adding-third-party-crates.md +msgid "Build system" +msgstr "Sistema de compilación" + +#: src/chromium/adding-third-party-crates.md +msgid "Lots" +msgstr "Muchos" + +#: src/chromium/adding-third-party-crates.md +msgid "Consistent: `Cargo.toml`" +msgstr "Consistente: `Cargo.toml`" + +#: src/chromium/adding-third-party-crates.md +msgid "Typical library size" +msgstr "Tamaño habitual de la biblioteca" + +#: src/chromium/adding-third-party-crates.md +msgid "Large-ish" +msgstr "Grande" + +#: src/chromium/adding-third-party-crates.md +msgid "Small" +msgstr "Pequeño" + +#: src/chromium/adding-third-party-crates.md +msgid "Transitive dependencies" +msgstr "Dependencias transitivas" + +#: src/chromium/adding-third-party-crates.md +msgid "Few" +msgstr "Pocos" + +#: src/chromium/adding-third-party-crates.md +msgid "For a Chromium engineer, this has pros and cons:" +msgstr "Para un ingeniero de Chromium, existen ventajas e inconvenientes:" + +#: src/chromium/adding-third-party-crates.md msgid "" -"In fact, you already [imported that crate in the previous exercise](https://" -"crates.io/crates/uwuify)." +"All crates use a common build system so we can automate their inclusion into " +"Chromium..." msgstr "" -"De hecho, ya [importamos ese crate en el ejercicio anterior](https://crates." -"io/crates/uwuify)." +"Todos los crates usan un sistema de compilación común, así que podemos " +"automatizar su inclusión en Chromium..." -#: src/exercises/chromium/bringing-it-together.md +#: src/chromium/adding-third-party-crates.md msgid "" -"(Obviously, real translations of Chrome require incredible care and " -"diligence. Don't ship this!)" +"... but, crates typically have transitive dependencies, so you will likely " +"have to bring in multiple libraries." msgstr "" -"(Obviamente, las traducciones reales de Chrome requieren mucha atención y " -"diligencia. No envíes nada de esto)." +"... pero los crates suelen tener dependencias transitivas, por lo que es " +"probable que tengas que introducir varias bibliotecas." -#: src/exercises/chromium/bringing-it-together.md -msgid "Steps" -msgstr "Pasos" +#: src/chromium/adding-third-party-crates.md +msgid "We'll discuss:" +msgstr "Hablaremos sobre los siguientes temas:" -#: src/exercises/chromium/bringing-it-together.md +#: src/chromium/adding-third-party-crates.md +msgid "How to put a crate in the Chromium source code tree" +msgstr "Cómo colocar un crate en el árbol de código fuente de Chromium." + +#: src/chromium/adding-third-party-crates.md +msgid "How to make `gn` build rules for it" +msgstr "Cómo aplicarle reglas de compilación `gn`." + +#: src/chromium/adding-third-party-crates.md +msgid "How to audit its source code for sufficient safety." +msgstr "Cómo auditar su código fuente para obtener la seguridad suficiente." + +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md +msgid "Configuring the `Cargo.toml` file to add crates" +msgstr "Configurar el archivo `Cargo.toml` para añadir crates" + +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.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_`." +"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 "" -"Modifica `ResourceBundle::RSMangleLocalizedString` para que traduzca todas " -"las cadenas antes de que se muestren. En esta compilación especial de " -"Chromium, siempre se debe hacer esto independientemente de la configuración " -"de `mangle_localized_strings_`." +"Chromium tiene un único conjunto de dependencias directas de crate " +"gestionadas de forma centralizada. Se gestionan mediante un único elemento " +"[`Cargo.toml`](https://source.chromium.org/chromium/chromium/src/+/main:" +"third_party/rust/chromium_crates_io/Cargo.toml):" -#: src/exercises/chromium/bringing-it-together.md +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.md msgid "" -"If you've done everything right across all these exercises, congratulations, " -"you should have created Chrome for pixies!" +"```toml\n" +"[dependencies]\n" +"bitflags = \"1\"\n" +"cfg-if = \"1\"\n" +"cxx = \"1\"\n" +"# lots more...\n" +"```" msgstr "" -"Si has hecho correctamente los ejercicios, habrás creado Chrome para hadas." +"```toml\n" +"[dependencies]\n" +"bitflags = \"1\"\n" +"cfg-if = \"1\"\n" +"cxx = \"1\"\n" +"# lots more...\n" +"```" -#: src/exercises/chromium/bringing-it-together.md +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.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." +"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 "" -"UTF16 y UTF8. Los alumnos deben tener en cuenta que las cadenas de Rust " -"siempre son UTF8. Probablemente decidirán que es mejor hacer la conversión " -"en C++ usando `base::UTF16ToUTF8` y viceversa." +"Al igual que con cualquier otro archivo `Cargo.toml`, puedes especificar " +"[más información sobre las dependencias](https://doc.rust-lang.org/cargo/" +"reference/specifying-dependencies.html). Lo más habitual es que se " +"especifiquen las funciones `features` que se quieran habilitar en el crate." -#: src/exercises/chromium/bringing-it-together.md +#: src/chromium/adding-third-party-crates/configuring-cargo-toml.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)." +"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 "" -"Si los participantes deciden hacer la conversión en Rust, deberán tener en " -"cuenta [`String::from_utf16`](https://doc.rust-lang.org/std/string/struct." -"String.html#method.from_utf16), la gestión de errores y los [tipos " -"compatibles con CXX que pueden transferir un gran número de u16s](https://" -"cxx.rs/binding/slice.html)." +"Al añadir un crate a Chromium, a menudo será necesario proporcionar " +"información adicional en un archivo adicional, `gnrt_config.toml`, que " +"veremos a continuación." -#: src/exercises/chromium/bringing-it-together.md +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.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." +"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 "" -"Los alumnos pueden diseñar el límite de C++ o Rust de varias formas " -"diferentes, por ejemplo, tomando y devolviendo cadenas por valor o colocando " -"una referencia mutable en una cadena. Si se utiliza una referencia mutable, " -"es probable que CXX indique que se debe usar [`Pin`](https://doc.rust-lang." -"org/std/pin/). Puede que debas explicar qué hace `Pin` y, a continuación, " -"explicar por qué CXX lo necesita para referencias mutables a datos de C++. " -"La respuesta es que los datos de C++ no se pueden mover como los datos de " -"Rust, ya que pueden contener punteros de autorreferencia." +"Junto a `Cargo.toml`, se encuentra [`gnrt_config.toml`](https://source." +"chromium.org/chromium/chromium/src/+/main:third_party/rust/" +"chromium_crates_io/gnrt_config.toml). Contiene extensiones específicas de " +"Chromium para la gestión de crates." -#: src/exercises/chromium/bringing-it-together.md +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md msgid "" -"The C++ target containing `ResourceBundle::MaybeMangleLocalizedString` will " -"need to depend on a `rust_static_library` target. The student probably " -"already did this." +"If you add a new crate, you should specify at least the `group`. This is one " +"of:" msgstr "" -"El elemento de destino de C++ que contiene `ResourceBundle::" -"MaybeMangleLocalizedString` deberá depender de un elemento " -"`rust_static_library`. Seguramente los alumnos ya lo hayan hecho." +"Si añades un nuevo crate, debes especificar al menos el atributo `group`. " +"Puede ser uno de los siguientes:" -#: src/exercises/chromium/bringing-it-together.md +#: 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 "Por ejemplo:" + +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md msgid "" -"The `rust_static_library` target will need to depend on `//third_party/rust/" -"uwuify/v0_2:lib`." +"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 "" -"`rust_static_library` deberá depender de `//third_party/rust/uwuify/v0_2:" -"lib`." +"En función del diseño del código fuente del crate, es posible que también " +"tengas que usar este archivo para especificar dónde se pueden encontrar los " +"archivos `LICENSE`." -#: src/exercises/chromium/solutions.md +#: src/chromium/adding-third-party-crates/configuring-gnrt-config-toml.md msgid "" -"Solutions to the Chromium exercises can be found in [this series of CLs]" -"(https://chromium-review.googlesource.com/c/chromium/src/+/5096560)." +"Later, we'll see some other things you will need to configure in this file " +"to resolve problems." msgstr "" -"Las soluciones a los ejercicios de Chromium están en [esta serie de listas " -"de cambios](https://chromium-review.googlesource.com/c/chromium/src/" -"+/5096560)." - -#: src/bare-metal.md -msgid "Welcome to Bare Metal Rust" -msgstr "Te damos la bienvenida a Bare Metal Rust" +"Más adelante, veremos otros elementos que tendrás que configurar en este " +"archivo para solucionar los problemas." -#: src/bare-metal.md +#: src/chromium/adding-third-party-crates/downloading-crates.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." +"A tool called `gnrt` knows how to download crates and how to generate `BUILD." +"gn` rules." msgstr "" -"Este es un curso independiente de un día sobre Rust bare-metal, dirigido a " -"personas que están familiarizadas con los conceptos básicos de Rust (tal vez " -"después de completar el curso Comprehensive Rust). Lo ideal sería que " -"también tuvieran experiencia con la programación bare-metal en otros " -"lenguajes, como C." +"La herramienta `gnrt` puede descargar crates y generar reglas `BUILD.gn`." -#: src/bare-metal.md +#: src/chromium/adding-third-party-crates/downloading-crates.md +msgid "To start, download the crate you want like this:" +msgstr "Para empezar, descarga el crate de esta forma:" + +#: src/chromium/adding-third-party-crates/downloading-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:" +"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 "" -"Hoy vamos a hablar de Rust \"bare-metal\": ejecutar código de Rust sin un " -"sistema operativo. Se dividirá en varias partes:" - -#: src/bare-metal.md -msgid "What is `no_std` Rust?" -msgstr "¿Qué es `no_std` en Rust?" +"Aunque la herramienta `gnrt` forma parte del código fuente de Chromium, al " +"ejecutar este comando, se descargarán y ejecutarán sus dependencias desde " +"`crates.io`. Consulta [la sección anterior](../cargo.md) sobre la decisión " +"de seguridad." -#: src/bare-metal.md -msgid "Writing firmware for microcontrollers." -msgstr "Escribir firmware para microcontroladores." +#: src/chromium/adding-third-party-crates/downloading-crates.md +msgid "This `vendor` command may download:" +msgstr "Este comando `vendor` puede descargar los siguientes elementos:" -#: src/bare-metal.md -msgid "Writing bootloader / kernel code for application processors." -msgstr "Escribir código bootloader o kernel para procesadores de aplicaciones." +#: src/chromium/adding-third-party-crates/downloading-crates.md +msgid "Your crate" +msgstr "Tu crate" -#: src/bare-metal.md -msgid "Some useful crates for bare-metal Rust development." -msgstr "Algunos crates útiles para el desarrollo de Rust bare-metal." +#: src/chromium/adding-third-party-crates/downloading-crates.md +msgid "Direct and transitive dependencies" +msgstr "Dependencias directas y transitivas." -#: src/bare-metal.md +#: src/chromium/adding-third-party-crates/downloading-crates.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." +"New versions of other crates, as required by `cargo` to resolve the complete " +"set of crates required by Chromium." msgstr "" -"En la parte del curso dedicada a los microcontroladores, utilizaremos la " -"versión 2 de [BBC micro:bit](https://microbit.org/) como ejemplo. Es una " -"[placa de desarrollo](https://tech.microbit.org/hardware/) basada en el " -"microcontrolador Nordic nRF51822 con algunos LED y botones, un acelerómetro " -"y una brújula conectados mediante I2C y un depurador SWD integrado." +"Nuevas versiones de otros crates, según lo requiera `cargo` para resolver el " +"conjunto completo de crates que requiere Chromium." -#: src/bare-metal.md +#: src/chromium/adding-third-party-crates/downloading-crates.md msgid "" -"To get started, install some tools we'll need later. On gLinux or Debian:" +"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 "" -"Para empezar, instala algunas de las herramientas que necesitarás más " -"adelante. En gLinux o Debian:" +"Chromium mantiene parches para algunos crates, que se conservan en `//" +"third_party/rust/chromium_crates_io/patches`. Se volverán a aplicar " +"automáticamente pero, si no se puede aplicar el parche, es posible que " +"tengas que realizar una acción manual." -#: src/bare-metal.md +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md msgid "" -"And give users in the `plugdev` group access to the micro:bit programmer:" +"Once you've downloaded the crate, generate the `BUILD.gn` files like this:" msgstr "" -"Permite a los usuarios del grupo `plugdev` acceder al programador micro:bit:" - -#: src/bare-metal.md src/bare-metal/microcontrollers/debugging.md -msgid "On MacOS:" -msgstr "En MacOS:" +"Una vez que hayas descargado el crate, genera los archivos `BUILD.gn` como " +"se indica a continuación:" -#: src/bare-metal/no_std.md -msgid "`core`" -msgstr "`core`" +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +msgid "Now run `git status`. You should find:" +msgstr "Ahora, ejecuta `git status`. Deberías encontrar lo siguiente:" -#: src/bare-metal/no_std.md -msgid "`std`" -msgstr "`std`" +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +msgid "" +"At least one new crate source code in `third_party/rust/chromium_crates_io/" +"vendor`" +msgstr "" +"Al menos un nuevo código fuente de crate en `third_party/rust/" +"chromium_crates_io/vendor`." -#: src/bare-metal/no_std.md -msgid "Slices, `&str`, `CStr`" -msgstr "Slices, `&str`, `CStr`" +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +msgid "" +"At least one new `BUILD.gn` in `third_party/rust//v`" +msgstr "" +"Al menos un nuevo `BUILD.gn` en `third_party/rust//v`." -#: src/bare-metal/no_std.md -msgid "`NonZeroU8`..." -msgstr "`NonZeroU8`..." +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +msgid "An appropriate `README.chromium`" +msgstr "Un archivo `README.chromium` adecuado." -#: src/bare-metal/no_std.md -msgid "`Option`, `Result`" -msgstr "`Option`, `Result`" +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.md +msgid "" +"The \"major semver version\" is a [Rust \"semver\" version number](https://" +"doc.rust-lang.org/cargo/reference/semver.html)." +msgstr "" +"La \"versión semver mayor\" es un [número de versión \"semver\" de Rust]" +"(https://doc.rust-lang.org/cargo/reference/semver.html)." -#: src/bare-metal/no_std.md -msgid "`Display`, `Debug`, `write!`..." -msgstr "`Display`, `Debug`, `write!`..." +#: 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 "" +"Analiza la situación con detalle, sobre todo los elementos generados en " +"`third_party/rust`." -#: src/bare-metal/no_std.md -msgid "`panic!`, `assert_eq!`..." -msgstr "`panic!`, `assert_eq!`..." +#: src/chromium/adding-third-party-crates/generating-gn-build-rules.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." +msgstr "" +"Habla un poco sobre el semver y, concretamente, sobre la forma en que " +"Chromium permite que existan varias versiones incompatibles de un crate. No " +"es una situación recomendable, pero a veces es necesaria en el ecosistema de " +"Cargo." -#: src/bare-metal/no_std.md -msgid "`NonNull` and all the usual pointer-related functions" -msgstr "`NonNull` y todas las funciones relacionadas con punteros habituales" +#: src/chromium/adding-third-party-crates/resolving-problems.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." +msgstr "" +"Si la compilación falla, puede deberse a un `build.rs`, programas que llevan " +"a cabo acciones arbitrarias durante la compilación. Esto difiere de los " +"diseños de `gn` y `ninja`, que tienen como objetivo crear reglas de " +"compilación estáticas y deterministas para maximizar el paralelismo y la " +"repetibilidad de las compilaciones." -#: src/bare-metal/no_std.md -msgid "`Future` and `async`/`await`" -msgstr "`Future` and `async`/`await`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "" +"Some `build.rs` actions are automatically supported; others require action:" +msgstr "" +"Algunas acciones `build.rs` son admitidas automáticamente, pero otras deben " +"llevar a cabo alguna acción:" -#: src/bare-metal/no_std.md -msgid "`fence`, `AtomicBool`, `AtomicPtr`, `AtomicU32`..." -msgstr "`fence`, `AtomicBool`, `AtomicPtr`, `AtomicU32`..." +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "build script effect" +msgstr "efecto de scripts de compilación" -#: src/bare-metal/no_std.md -msgid "`Duration`" -msgstr "`Duration`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Supported by our gn templates" +msgstr "Compatible con nuestras plantillas de gn" -#: src/bare-metal/no_std.md -msgid "`Box`, `Cow`, `Arc`, `Rc`" -msgstr "`Box`, `Cow`, `Arc`, `Rc`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Work required by you" +msgstr "Acciones que debes llevar a cabo" -#: src/bare-metal/no_std.md -msgid "`Vec`, `BinaryHeap`, `BtreeMap`, `LinkedList`, `VecDeque`" -msgstr "`Vec`, `BinaryHeap`, `BtreeMap`, `LinkedList`, `VecDeque`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Checking rustc version to configure features on and off" +msgstr "Comprobar la versión de rustc para activar y desactivar funciones" -#: src/bare-metal/no_std.md -msgid "`String`, `CString`, `format!`" -msgstr "`String`, `CString`, `format!`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Yes" +msgstr "Sí" -#: src/bare-metal/no_std.md -msgid "`Error`" -msgstr "`Error`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "None" +msgstr "Ninguno" -#: 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/resolving-problems.md +msgid "Checking platform or CPU to configure features on and off" +msgstr "Comprobar la plataforma o la CPU para activar y desactivar funciones" -#: src/bare-metal/no_std.md -msgid "`File` and the rest of `fs`" -msgstr "`File` y el resto de `fs`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Generating code" +msgstr "Generar código" -#: src/bare-metal/no_std.md -msgid "`println!`, `Read`, `Write`, `Stdin`, `Stdout` and the rest of `io`" -msgstr "`println!`, `Read`, `Write`, `Stdin`, `Stdout` y el resto de `io`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Yes - specify in `gnrt_config.toml`" +msgstr "Sí: especificar en `gnrt_config.toml`" -#: src/bare-metal/no_std.md -msgid "`Path`, `OsString`" -msgstr "`Path`, `OsString`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Building C/C++" +msgstr "Compilar en C o C++" -#: src/bare-metal/no_std.md -msgid "`net`" -msgstr "`net`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "No" +msgstr "No" -#: src/bare-metal/no_std.md -msgid "`Command`, `Child`, `ExitCode`" -msgstr "`Command`, `Child`, `ExitCode`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Patch around it" +msgstr "Poner un parche" -#: src/bare-metal/no_std.md -msgid "`spawn`, `sleep` and the rest of `thread`" -msgstr "`spawn`, `sleep` y el resto de `thread`" +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "Arbitrary other actions" +msgstr "Otras acciones arbitrarias" -#: 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` depende de RNG." - -#: src/bare-metal/no_std.md -msgid "`std` re-exports the contents of both `core` and `alloc`." -msgstr "`std` vuelve a exportar el contenido de `core` y `alloc`." - -#: src/bare-metal/minimal.md -msgid "A minimal `no_std` program" -msgstr "Un programa `no_std` mínimo" - -#: src/bare-metal/minimal.md -msgid "This will compile to an empty binary." -msgstr "Se compilará en un binario vacío." - -#: src/bare-metal/minimal.md -msgid "`std` provides a panic handler; without it we must provide our own." +#: src/chromium/adding-third-party-crates/resolving-problems.md +msgid "" +"Fortunately, most crates don't contain a build script, and fortunately, most " +"build scripts only do the top two actions." msgstr "" -"`std` proporciona un controlador de _panic_; sin no hay, debemos " -"proporcionar uno nuestro." +"Por suerte, la mayoría de los crates no contienen scripts de compilación y " +"la mayoría de estos scripts de compilación solo llevan a cabo dos acciones " +"principales." -#: src/bare-metal/minimal.md -msgid "It can also be provided by another crate, such as `panic-halt`." -msgstr "También puede proporcionarlo otro crate, como `panic-halt`." +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md +msgid "" +"If `ninja` complains about missing files, check the `build.rs` to see if it " +"writes source code files." +msgstr "" +"Si `ninja` se queja de que faltan archivos, comprueba `build.rs` para ver si " +"escribe archivos de código fuente." -#: src/bare-metal/minimal.md +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md msgid "" -"Depending on the target, you may need to compile with `panic = \"abort\"` to " -"avoid an error about `eh_personality`." +"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 "" -"Dependiendo del objetivo, es posible que tengas que compilar con `panic = " -"\"abort\"` para evitar un error sobre `eh_personality`." +"Si es así, modifica [`gnrt_config.toml`](../configuring-gnrt-config-toml.md) " +"para añadir `build-script-outputs` al crate. Si se trata de una dependencia " +"transitiva, de la que el código Chromium no debería depender de forma " +"directa, añade también `allow-first-party-usage=false`. En ese archivo ya " +"hay varios ejemplos:" -#: src/bare-metal/minimal.md +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.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." +"```toml\n" +"[crate.unicode-linebreak]\n" +"allow-first-party-usage = false\n" +"build-script-outputs = [\"tables.rs\"]\n" +"```" msgstr "" -"Ten en cuenta que no hay `main` ni ningún otro punto de entrada; depende de " -"ti definir un punto de entrada propio. Esto suele implicar una secuencia de " -"comandos de enlazador y algún código de ensamblado de forma que todo esté " -"preparado para que se ejecute el código de Rust." +"```toml\n" +"[crate.unicode-linebreak]\n" +"allow-first-party-usage = false\n" +"build-script-outputs = [\"tables.rs\"]\n" +"```" -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-generate-code.md msgid "" -"To use `alloc` you must implement a [global (heap) allocator](https://doc." -"rust-lang.org/stable/std/alloc/trait.GlobalAlloc.html)." +"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 "" -"Para utilizar `alloc`, debes implementar un [asignador global (de _heap_)]" -"(https://doc.rust-lang.org/stable/std/alloc/trait.GlobalAlloc.html)." +"A continuación, vuelve a ejecutar [`gnrt.py -- gen`](../generating-gn-build-" +"rules.md) para generar de nuevo los archivos `build.gn` e informar al ninja " +"de que este archivo de salida concreto se usa como entrada en los pasos de " +"compilación posteriores." -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md msgid "" -"// Safe because `HEAP` is only used here and `entry` is only called once.\n" +"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 "" -"// Es seguro porque `HEAP` solo se usa aquí y solo se llama una vez a " -"`entry`.\n" +"Algunos crates usan el crate [`cc`](https://crates.io/crates/cc) para " +"compilar y vincular bibliotecas de C y C++. Otros crates analizan C y C++ " +"mediante [`bindgen`](https://crates.io/crates/bindgen) en sus scripts de " +"compilación. Estas acciones no se pueden llevar a cabo en un contexto de " +"Chromium, ya que nuestro sistema de compilación gn, ninja y LLVM es muy " +"específico a la hora de expresar las relaciones entre las acciones de " +"compilación." -#: src/bare-metal/alloc.md -msgid "// Give the allocator some memory to allocate.\n" -msgstr "// Proporciona al asignador algo de memoria para asignar.\n" +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md +msgid "So, your options are:" +msgstr "Por lo tanto, las opciones son las siguientes:" -#: src/bare-metal/alloc.md -msgid "// Now we can do things that require heap allocation.\n" -msgstr "" -"// Ahora podemos llevar a cabo acciones que requieran la asignación de " -"montículo.\n" +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md +msgid "Avoid these crates" +msgstr "Evitar estos crates." -#: src/bare-metal/alloc.md -#, fuzzy -msgid "\"A string\"" -msgstr "String" +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.md +msgid "Apply a patch to the crate." +msgstr "Aplicar un parche al crate." -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/resolving-problems/build-scripts-which-take-arbitrary-actions.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." +"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 "" -"`buddy_system_allocator` es un crate de terceros que implementa un _buddy " -"system allocator_ (una técnica de asignación de memoria) básico. Hay otros " -"crates disponibles, pero también puedes escribir el tuyo propio o conectarte " -"a tu asignador." +"Los parches deben guardarse en `third_party/rust/chromium_crates_io/patches/" +"`, como los [parches para el crate `cxx`](https://source.chromium.org/" +"chromium/chromium/src/+/main:third_party/rust/chromium_crates_io/patches/" +"cxx/), y `gnrt` lo aplicará automáticamente cada vez que actualice el crate." -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/depending-on-a-crate.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." +"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 "" -"El parámetro const de `LockedHeap` es el orden máximo del asignador. Es " -"decir, en este caso, puede asignar regiones de hasta 2\\*\\*32 bytes." +"Una vez que se ha añadido un crate de terceros y se han generado reglas de " +"compilación, utilizar un crate es sencillo. Busca tu elemento de destino " +"`rust_static_library` y añade un `dep` en el `:lib` dentro del crate." -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/depending-on-a-crate.md +msgid "Specifically," +msgstr "Específicamente:" + +#: src/chromium/adding-third-party-crates/depending-on-a-crate.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." +"```bob\n" +" +------------+ +----------------------+\n" +"\"//third_party/rust\" | crate name | \"/v\" | major semver version | \":" +"lib\"\n" +" +------------+ +----------------------+\n" +"```" msgstr "" -"Si algún crate del árbol de dependencias depende de `alloc`, debes tener " -"exactamente un asignador global definido en el binario. Esto se suele hacer " -"en el crate binario de nivel superior." +"```bob\n" +" +------------+ +----------------------+\n" +"\"//third_party/rust\" | crate name | \"/v\" | major semver version | \":" +"lib\"\n" +" +------------+ +----------------------+\n" +"```" -#: src/bare-metal/alloc.md +#: src/chromium/adding-third-party-crates/depending-on-a-crate.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." +"```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 "" -"`extern crate panic_halt as _` es necesario para asegurar que el crate " -"`panic_halt` esté vinculado y así podamos obtener su controlador de _panic_." +"```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/alloc.md -msgid "This example will build but not run, as it doesn't have an entry point." -msgstr "" -"Este ejemplo se compilará pero no se ejecutará, ya que no cuenta con un " -"punto de entrada." +#: src/chromium/adding-third-party-crates/reviews-and-audits.md +msgid "Auditing Third Party Crates" +msgstr "Auditoría de Crates de Terceros" -#: src/bare-metal/microcontrollers.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"The `cortex_m_rt` crate provides (among other things) a reset handler for " -"Cortex M microcontrollers." +"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 "" -"El crate `cortex_m_rt` proporciona (entre otras cosas) un controlador de " -"reinicio para microcontroladores Cortex M." +"Añadir nuevas bibliotecas está sujeto a las [políticas](https://chromium." +"googlesource.com/chromium/src/+/refs/heads/main/docs/rust.md#Third_party-" +"review) estándar de Chromium, pero también a la revisión de seguridad. Como " +"puede que no solo incluyas un único crate sino también dependencias " +"transitivas, es posible que haya mucho código que revisar. Por otro lado, el " +"código de Rust seguro puede tener efectos secundarios negativos limitados. " +"¿Cómo se revisa?" -#: src/bare-metal/microcontrollers.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"Next we'll look at how to access peripherals, with increasing levels of " -"abstraction." +"Over time Chromium aims to move to a process based around [cargo vet]" +"(https://mozilla.github.io/cargo-vet/)." msgstr "" -"A continuación, veremos cómo se accede a los periféricos con niveles de " -"abstracción cada vez mayores." +"Con el tiempo, Chromium intentará adoptar un proceso basado en [cargo vet]" +"(https://mozilla.github.io/cargo-vet/)." -#: src/bare-metal/microcontrollers.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.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 "" -"La macro `cortex_m_rt::entry` requiere que la función tenga el tipo `fn() -" -"> !`, ya que no tiene sentido devolver resultados al controlador de reinicio." - -#: src/bare-metal/microcontrollers.md -msgid "Run the example with `cargo embed --bin minimal`" -msgstr "Ejecuta el ejemplo con `cargo embed --bin minimal`." +"Meanwhile, for each new crate addition, we are checking for the following:" +msgstr "Mientras tanto, se debe hacer lo siguiente para cada nuevo crate:" -#: src/bare-metal/microcontrollers/mmio.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"Most microcontrollers access peripherals via memory-mapped IO. Let's try " -"turning on an LED on our micro:bit:" +"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 "" -"La mayoría de los microcontroladores acceden a los periféricos a través de E/" -"S asignada a la memoria. Vamos a probar a encender un LED en nuestro micro:" -"bit:" - -#: src/bare-metal/microcontrollers/mmio.md -msgid "/// GPIO port 0 peripheral address\n" -msgstr "/// Dirección de periférico del puerto GPIO 0\n" - -#: src/bare-metal/microcontrollers/mmio.md -msgid "// GPIO peripheral offsets\n" -msgstr "// Offset de periféricos GPIO\n" - -#: src/bare-metal/microcontrollers/mmio.md -msgid "// PIN_CNF fields\n" -msgstr "// Campos PIN_CNF\n" +"Entender por qué se usa cada crate. ¿Cuál es la relación entre los crates? " +"Si el sistema de compilación de cada crate contiene un archivo `build.rs` o " +"macros de procedimiento, averigua para qué sirven. ¿Son compatibles con la " +"forma en la que se compila normalmente Chromium?" -#: 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 "// Configura los pines 21 y 28 de GPIO 0 como salidas push-pull.\n" +#: src/chromium/adding-third-party-crates/reviews-and-audits.md +msgid "Check each crate seems to be reasonably well maintained" +msgstr "Comprobar que cada crate tenga un mantenimiento razonable." -#: src/bare-metal/microcontrollers/mmio.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"// Safe because the pointers are to valid peripheral control registers, and\n" -" // no aliases exist.\n" +"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 "" -"// Es seguro porque los punteros dirigen a registros de control de " -"periféricos válidos y\n" -" // no existe ningún alias.\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 "// Define el pin 28 bajo y 21 alto para encender el LED.\n" +"Usar `cd third-party/rust/chromium_crates_io; cargo audit` para comprobar si " +"existen vulnerabilidades (primero se tiene que usar `cargo install cargo-" +"audit`, lo que, irónicamente, implica descargar muchas dependencias de " +"Internet[2](../cargo.md))." -#: src/bare-metal/microcontrollers/mmio.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"GPIO 0 pin 21 is connected to the first column of the LED matrix, and pin 28 " -"to the first row." +"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 "" -"El pin 21 de GPIO 0 está conectado a la primera columna de la matriz de LED " -"y el pin 28 a la primera fila." - -#: 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 "Ejecuta el ejemplo con:" +"Asegúrate de que cualquier código `unsafe` sea adecuado para la [Regla de " +"dos](https://chromium.googlesource.com/chromium/src/+/main/docs/security/" +"rule-of-2.md#unsafe-code-in-safe-languages)." -#: src/bare-metal/microcontrollers/pacs.md -msgid "Peripheral Access Crates" -msgstr "Crates de Acceso Periférico" +#: src/chromium/adding-third-party-crates/reviews-and-audits.md +msgid "Check for any use of `fs` or `net` APIs" +msgstr "Comprobar si se usan las APIs `fs` o `net`." -#: src/bare-metal/microcontrollers/pacs.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.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." +"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 "" -"[`svd2rust`](https://crates.io/crates/svd2rust) genera, en su gran mayoría, " -"envoltorios seguros de Rust para periféricos asignados a la memoria a partir " -"de archivos [CMSIS-SVD](https://www.keil.com/pack/doc/CMSIS/SVD/html/index." -"html)." +"Leer todo el código con suficiente profundidad para comprobar si hay algo " +"fuera de lugar que pueda haberse insertado de forma malintencionada. (Es " +"imposible hacerlo perfecto, ya que, a menudo, hay demasiado código)." -#: src/bare-metal/microcontrollers/pacs.md +#: src/chromium/adding-third-party-crates/reviews-and-audits.md msgid "" -"SVD (System View Description) files are XML files typically provided by " -"silicon vendors which describe the memory map of the device." +"These are just guidelines --- work with reviewers from `security@chromium." +"org` to work out the right way to become confident of the crate." msgstr "" -"Los archivos SVD (System View Description) son archivos XML que suelen " -"proporcionar los proveedores de silicio y que describen el mapa de memoria " -"del dispositivo." +"Estas son solo algunas directrices, trabaja con revisores de " +"`security@chromium.org` para determinar la forma adecuada de utilizar los " +"crates." -#: src/bare-metal/microcontrollers/pacs.md -msgid "" -"They are organised by peripheral, register, field and value, with names, " -"descriptions, addresses and so on." -msgstr "" -"Se organizan por periférico, registro, campo y valor, con nombres, " -"descripciones y direcciones, etc." +#: src/chromium/adding-third-party-crates/checking-in.md +msgid "Checking Crates into Chromium Source Code" +msgstr "Comprobar crates en el código fuente de Chromium" -#: 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 "" -"Los archivos SVD suelen tener errores y estar incompletos, por lo que " -"existen varios proyectos que aplican parches a los errores, añaden detalles " -"que faltan y publican los crates generados." +#: src/chromium/adding-third-party-crates/checking-in.md +msgid "`git status` should reveal:" +msgstr "`git status` debe revelar lo siguiente:" -#: src/bare-metal/microcontrollers/pacs.md -msgid "`cortex-m-rt` provides the vector table, among other things." -msgstr "`cortex-m-rt` proporciona la tabla de vectores, entre otras cosas." +#: src/chromium/adding-third-party-crates/checking-in.md +msgid "Crate code in `//third_party/rust/chromium_crates_io`" +msgstr "Código del crate en `//third_party/rust/chromium_crates_io`." -#: src/bare-metal/microcontrollers/pacs.md +#: src/chromium/adding-third-party-crates/checking-in.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." +"Metadata (`BUILD.gn` and `README.chromium`) in `//third_party/rust//" +"`" msgstr "" -"Si instalas `cargo install cargo-binutils` puedes ejecutar `cargo objdump --" -"bin pac -- -d --no-show-raw-insn` para ver el binario resultante." +"Metadatos (`BUILD.gn` y `README.chromium`) en `//third_party/rust//" +"`." -#: src/bare-metal/microcontrollers/hals.md -msgid "HAL crates" -msgstr "Crates HAL" +#: src/chromium/adding-third-party-crates/checking-in.md +msgid "Please also add an `OWNERS` file in the latter location." +msgstr "Añade también un archivo `OWNERS` en esta última ubicación." -#: src/bare-metal/microcontrollers/hals.md +#: src/chromium/adding-third-party-crates/checking-in.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)." +"You should land all this, along with your `Cargo.toml` and `gnrt_config." +"toml` changes, into the Chromium repo." msgstr "" -"[Los crates HAL](https://github.com/rust-embedded/awesome-embedded-rust#hal-" -"implementation-crates) de muchos microcontroladores incluyen envoltorios " -"alrededor de varios periféricos. Por lo general, implementan traits de " -"[`embedded-hal`](https://crates.io/crates/embedded-hal)." - -#: src/bare-metal/microcontrollers/hals.md -msgid "// Create HAL wrapper for GPIO port 0.\n" -msgstr "// Crea un envoltorio HAL para el puerto GPIO 0.\n" +"Deberías llevar todo esto, junto con los cambios de `Cargo.toml` y " +"`gnrt_config.toml`, al repositorio de Chromium." -#: src/bare-metal/microcontrollers/hals.md +#: src/chromium/adding-third-party-crates/checking-in.md msgid "" -"`set_low` and `set_high` are methods on the `embedded_hal` `OutputPin` trait." +"**Important**: you need to use `git add -f` because otherwise `.gitignore` " +"files may result in some files being skipped." msgstr "" -"`set_low` y `set_high` son métodos del trait `OutputPin` de `embedded_hal`." +"**Importante**: Debes usar `git add -f`, de lo contrario, los archivos `." +"gitignore` pueden provocar que se omitan algunos archivos." -#: src/bare-metal/microcontrollers/hals.md +#: src/chromium/adding-third-party-crates/checking-in.md msgid "" -"HAL crates exist for many Cortex-M and RISC-V devices, including various " -"STM32, GD32, nRF, NXP, MSP430, AVR and PIC microcontrollers." +"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 "" -"Hay crates HAL para muchos dispositivos Cortex-M y RISC-V, incluidos varios " -"microcontroladores STM32, GD32, nRF, NXP, MSP430, AVR y PIC." - -#: src/bare-metal/microcontrollers/board-support.md -msgid "Board support crates" -msgstr "Crates de compatibilidad de placa" +"Si lo haces, es posible que veas que las comprobaciones presubmit no se han " +"completado porque incluyen lenguaje no inclusivo. Esto se debe a que los " +"datos de crate de Rust suelen incluir nombres de ramas en git y muchos " +"proyectos siguen empleando terminología no inclusiva. Por lo tanto, puede " +"que debas ejecutar lo siguiente:" -#: src/bare-metal/microcontrollers/board-support.md +#: src/chromium/adding-third-party-crates/keeping-up-to-date.md msgid "" -"Board support crates provide a further level of wrapping for a specific " -"board for convenience." +"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 "" -"Los crates de compatibilidad de placa proporcionan un nivel adicional de " -"envoltorio a una placa específica para mayor comodidad." +"Como PROPIETARIO de cualquier dependencia de Chromium de terceros, [se " +"espera que la actualices con las correcciones de seguridad](https://chromium." +"googlesource.com/chromium/src/+/main/docs/adding_to_third_party.md#add-" +"owners). La idea es que pronto automaticemos esto para los crates de Rust, " +"pero por ahora sigue siendo tu responsabilidad, igual que cualquier otra " +"dependencia de terceros." -#: src/bare-metal/microcontrollers/board-support.md +#: src/exercises/chromium/third-party.md msgid "" -"In this case the board support crate is just providing more useful names, " -"and a bit of initialisation." +"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 "" -"En este caso, el crate de compatibilidad de placa proporciona solo nombres " -"más útiles y un poco de inicialización." +"Añade [uwuify](https://crates.io/crates/uwuify) a Chromium para desactivar " +"las [funciones predeterminadas] del crate (https://doc.rust-lang.org/cargo/" +"reference/features.html#the-default-feature). Supongamos que el crate se " +"usará en el envío de Chromium, pero no para gestionar entradas no fiables." -#: src/bare-metal/microcontrollers/board-support.md +#: src/exercises/chromium/third-party.md msgid "" -"The crate may also include drivers for some on-board devices outside of the " -"microcontroller itself." +"(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 "" -"El crate también puede incluir controladores para algunos dispositivos " -"integrados fuera del propio microcontrolador ." - -#: src/bare-metal/microcontrollers/board-support.md -msgid "`microbit-v2` includes a simple driver for the LED matrix." -msgstr "`microbit-v2` incluye un controlador sencillo para la matriz de LED." +"(En el siguiente ejercicio, usaremos uwuify de Chromium, pero puedes " +"saltarte este paso y hacerlo ahora si quieres. También puedes crear un nuevo " +"[destino `rust_executable`](https://source.chromium.org/chromium/chromium/" +"src/+/main:build/rust/rust_executable.gni) que utilice `uwuify`)." -#: src/bare-metal/microcontrollers/type-state.md -msgid "The type state pattern" -msgstr "El patrón de tipo de estado" +#: src/exercises/chromium/third-party.md +msgid "Students will need to download lots of transitive dependencies." +msgstr "" +"Los participantes tendrán que descargar muchas dependencias transitivas." -#: 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; // Error, se ha movido.\n" +#: src/exercises/chromium/third-party.md +msgid "The total crates needed are:" +msgstr "Estos son los crates que se necesitan:" -#: src/bare-metal/microcontrollers/type-state.md -msgid "// pin_input.is_high(); // Error, moved.\n" -msgstr "// pin_input.is_high(); // Error, se ha movido.\n" +#: src/exercises/chromium/third-party.md +#, fuzzy +msgid "`instant`," +msgstr "Por ejemplo:" -#: 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 "" -"Los pines no implementan `Copy` ni `Clone`, por lo que solo puede haber una " -"instancia de cada uno. Cuando se quita un pin de la estructura del puerto, " -"nadie más puede usarlo." +#: src/exercises/chromium/third-party.md +msgid "`lock_api`," +msgstr "`lock_api`" -#: 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 "" -"Si cambias la configuración de un pin, se consumirá la instancia del pin " -"anterior y no podrás seguir usando la instancia previa." +#: src/exercises/chromium/third-party.md +msgid "`parking_lot`," +msgstr "`parking_lot`" -#: src/bare-metal/microcontrollers/type-state.md +#: 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/chromium/third-party.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 students are downloading even more than that, they probably forgot to " +"turn off the default features." msgstr "" -"El tipo de un valor indica el estado en el que se encuentra: por ejemplo, en " -"este caso, el estado de configuración de un pin de GPIO. De esta manera, se " -"codifica la máquina de estados en el sistema de tipos, asegurando así que no " -"se use un pin de cierta forma sin antes configurarlo correctamente. Las " -"transiciones de estado ilegales se detectan durante el tiempo de compilación." +"Si los alumnos se descargan más datos, seguramente habrán olvidado " +"desactivar las funciones predeterminadas." -#: src/bare-metal/microcontrollers/type-state.md +#: src/exercises/chromium/third-party.md msgid "" -"You can call `is_high` on an input pin and `set_high` on an output pin, but " -"not vice-versa." +"Thanks to [Daniel Liu](https://github.com/Daniel-Liu-c0deb0t) for this crate!" msgstr "" -"Puedes llamar a `is_high` en un pin de entrada y a `set_high` en un pin de " -"salida, pero no al revés." +"Gracias a [Daniel Liu](https://github.com/Daniel-Liu-c0deb0t) por este crate." -#: src/bare-metal/microcontrollers/type-state.md -msgid "Many HAL crates follow this pattern." -msgstr "Muchos crates HAL siguen este patrón." +#: src/exercises/chromium/bringing-it-together.md +msgid "Bringing It Together --- Exercise" +msgstr "Poner en práctica todo lo aprendido: ejercicio" -#: src/bare-metal/microcontrollers/embedded-hal.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"The [`embedded-hal`](https://crates.io/crates/embedded-hal) crate provides a " -"number of traits covering common microcontroller peripherals." +"In this exercise, you're going to add a whole new Chromium feature, bringing " +"together everything you already learned." msgstr "" -"El crate [`embedded-hal`](https://crates.io/crates/embedded-hal) proporciona " -"una serie de traits que cubren los periféricos habituales de los " -"microcontroladores." - -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "GPIO" -msgstr "GPIO" - -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "ADC" -msgstr "ADC" - -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "I2C, SPI, UART, CAN" -msgstr "I2C, SPI, UART, CAN" - -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "RNG" -msgstr "RNG" - -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "Timers" -msgstr "Temporizadores" +"En este ejercicio, vas a añadir una función de Chromium completamente nueva " +"que pondrá en práctica todo lo que hemos aprendido." -#: src/bare-metal/microcontrollers/embedded-hal.md -msgid "Watchdogs" -msgstr "Watchdogs" +#: src/exercises/chromium/bringing-it-together.md +msgid "The Brief from Product Management" +msgstr "Resumen de la gestión de productos" -#: src/bare-metal/microcontrollers/embedded-hal.md +#: src/exercises/chromium/bringing-it-together.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." +"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 "" -"Es entonces cuando otros crates implementan [controladores](https://github." -"com/rust-embedded/awesome-embedded-rust#driver-crates) en función de estos " -"traits. Por ejemplo, un controlador de acelerómetro podría necesitar una " -"implementación de bus I2C o SPI." +"Se ha descubierto una comunidad de hadas que habita en una selva tropical " +"remota. Es importante que les enviemos la versión Chromium para hadas lo " +"antes posible." -#: src/bare-metal/microcontrollers/embedded-hal.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"There are implementations for many microcontrollers, as well as other " -"platforms such as Linux on Raspberry Pi." +"The requirement is to translate all Chromium's UI strings into Pixie " +"language." msgstr "" -"Hay implementaciones para muchos microcontroladores, así como otras " -"plataformas como Linux en Raspberry Pi." +"El requisito es traducir todas las cadenas de la IU de Chromium al idioma de " +"las hadas." -#: src/bare-metal/microcontrollers/embedded-hal.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"There is work in progress on an `async` version of `embedded-hal`, but it " -"isn't stable yet." +"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 "" -"Se está trabajando en una versión `async` de `embedded-hal`, pero aún no es " -"estable." +"No hay tiempo para obtener las traducciones adecuadas pero, por suerte, el " +"lenguaje de las hadas se parece mucho al inglés y hay un crate de Rust que " +"hace las traducciones." -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"[probe-rs](https://probe.rs/) is a handy toolset for embedded debugging, " -"like OpenOCD but better integrated." +"In fact, you already [imported that crate in the previous exercise](https://" +"crates.io/crates/uwuify)." msgstr "" -"[probe-rs](https://probe.rs/) es un conjunto de herramientas de depuración " -"integradas muy útil, como OpenOCD, pero mejor integrado." +"De hecho, ya [importamos ese crate en el ejercicio anterior](https://crates." +"io/crates/uwuify)." -#: src/bare-metal/microcontrollers/probe-rs.md -#, fuzzy +#: src/exercises/chromium/bringing-it-together.md msgid "" -"SWD (Serial Wire Debug) and JTAG via CMSIS-DAP, ST-Link and J-Link probes" -msgstr " y JTAG a través de comprobaciones CMSIS-DAP, ST-Link y J-Link" - -#: src/bare-metal/microcontrollers/probe-rs.md -msgid "GDB stub and Microsoft DAP (Debug Adapter Protocol) server" +"(Obviously, real translations of Chrome require incredible care and " +"diligence. Don't ship this!)" msgstr "" -"Stub de GDB y servidor de Microsoft DAP (protocolo de adaptador de " -"depuración)" +"(Obviamente, las traducciones reales de Chrome requieren mucha atención y " +"diligencia. No envíes nada de esto)." -#: src/bare-metal/microcontrollers/probe-rs.md -msgid "Cargo integration" -msgstr "Integración de Cargo" +#: src/exercises/chromium/bringing-it-together.md +msgid "Steps" +msgstr "Pasos" -#: src/bare-metal/microcontrollers/probe-rs.md -#, fuzzy +#: src/exercises/chromium/bringing-it-together.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." +"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 "" -" y conectar GDB. Se configura mediante un archivo `Embed.toml` en el " -"directorio del proyecto." +"Modifica `ResourceBundle::RSMangleLocalizedString` para que traduzca todas " +"las cadenas antes de que se muestren. En esta compilación especial de " +"Chromium, siempre se debe hacer esto independientemente de la configuración " +"de `mangle_localized_strings_`." -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/exercises/chromium/bringing-it-together.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." +"If you've done everything right across all these exercises, congratulations, " +"you should have created Chrome for pixies!" msgstr "" -"[CMSIS-DAP](https://arm-software.github.io/CMSIS_5/DAP/html/index.html) es " -"un protocolo estándar de Arm mediante USB que permite que un depurador en " -"circuito acceda al puerto de acceso de depuración CoreSight de varios " -"procesadores Cortex de Arm. Es lo que utiliza el depurador integrado en el " -"BBC micro:bit" +"Si has hecho correctamente los ejercicios, habrás creado Chrome para hadas." -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"ST-Link is a range of in-circuit debuggers from ST Microelectronics, J-Link " -"is a range from SEGGER." +"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 "" -"ST-Link es una gama de depuradores en circuito de ST Microelectronics. J-" -"Link es una gama de SEGGER." +"UTF16 y UTF8. Los alumnos deben tener en cuenta que las cadenas de Rust " +"siempre son UTF8. Probablemente decidirán que es mejor hacer la conversión " +"en C++ usando `base::UTF16ToUTF8` y viceversa." -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"The Debug Access Port is usually either a 5-pin JTAG interface or 2-pin " -"Serial Wire Debug." +"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 "" -"El puerto de acceso de depuración suele ser una interfaz JTAG de 5 pines o " -"una SWD de 2 pines." +"Si los participantes deciden hacer la conversión en Rust, deberán tener en " +"cuenta [`String::from_utf16`](https://doc.rust-lang.org/std/string/struct." +"String.html#method.from_utf16), la gestión de errores y los [tipos " +"compatibles con CXX que pueden transferir un gran número de u16s](https://" +"cxx.rs/binding/slice.html)." -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"probe-rs is a library which you can integrate into your own tools if you " -"want to." +"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 "" -"probe-rs es una biblioteca que puedes integrar en tus propias herramientas." +"Los alumnos pueden diseñar el límite de C++ o Rust de varias formas " +"diferentes, por ejemplo, tomando y devolviendo cadenas por valor o colocando " +"una referencia mutable en una cadena. Si se utiliza una referencia mutable, " +"es probable que CXX indique que se debe usar [`Pin`](https://doc.rust-lang." +"org/std/pin/). Puede que debas explicar qué hace `Pin` y, a continuación, " +"explicar por qué CXX lo necesita para referencias mutables a datos de C++. " +"La respuesta es que los datos de C++ no se pueden mover como los datos de " +"Rust, ya que pueden contener punteros de autorreferencia." -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/exercises/chromium/bringing-it-together.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." +"The C++ target containing `ResourceBundle::MaybeMangleLocalizedString` will " +"need to depend on a `rust_static_library` target. The student probably " +"already did this." msgstr "" -"[El protocolo de adaptador de depuración de Microsoft](https://microsoft." -"github.io/debug-adapter-protocol/) permite que VSCode y otros IDEs depuren " -"el código que se ejecuta en cualquier microcontrolador compatible." - -#: src/bare-metal/microcontrollers/probe-rs.md -msgid "cargo-embed is a binary built using the probe-rs library." -msgstr "cargo-embed es un binario compilado con la biblioteca probe-rs." +"El elemento de destino de C++ que contiene `ResourceBundle::" +"MaybeMangleLocalizedString` deberá depender de un elemento " +"`rust_static_library`. Seguramente los alumnos ya lo hayan hecho." -#: src/bare-metal/microcontrollers/probe-rs.md +#: src/exercises/chromium/bringing-it-together.md msgid "" -"RTT (Real Time Transfers) is a mechanism to transfer data between the debug " -"host and the target through a number of ringbuffers." +"The `rust_static_library` target will need to depend on `//third_party/rust/" +"uwuify/v0_2:lib`." msgstr "" -"TTR (transferencias en tiempo real) es un mecanismo para transferir datos " -"entre el host de depuración y el objetivo a través de una serie de búferes " -"circulares." - -#: src/bare-metal/microcontrollers/debugging.md -#, fuzzy -msgid "_Embed.toml_:" -msgstr "Embed.toml:" - -#: src/bare-metal/microcontrollers/debugging.md -msgid "In one terminal under `src/bare-metal/microcontrollers/examples/`:" -msgstr "En un terminal en `src/bare-metal/microcontrollers/examples/`:" - -#: src/bare-metal/microcontrollers/debugging.md -msgid "In another terminal in the same directory:" -msgstr "En otro terminal del mismo directorio:" - -#: src/bare-metal/microcontrollers/debugging.md -msgid "On gLinux or Debian:" -msgstr "En gLinux o Debian:" - -#: src/bare-metal/microcontrollers/debugging.md -msgid "In GDB, try running:" -msgstr "En GDB, prueba a ejecutar:" - -#: src/bare-metal/microcontrollers/other-projects.md -#: src/bare-metal/aps/other-projects.md -msgid "Other projects" -msgstr "Otros proyectos" - -#: 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 "\"Concurrencia en tiempo real basada en interrupciones\"" +"`rust_static_library` deberá depender de `//third_party/rust/uwuify/v0_2:" +"lib`." -#: src/bare-metal/microcontrollers/other-projects.md +#: src/exercises/chromium/solutions.md msgid "" -"Shared resource management, message passing, task scheduling, timer queue" +"Solutions to the Chromium exercises can be found in [this series of CLs]" +"(https://chromium-review.googlesource.com/c/chromium/src/+/5096560)." msgstr "" -"Gestión de recursos compartidos, envío de mensajes, programación de tareas, " -"cola del temporizador, etc." - -#: 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 "Ejecutores `async` con prioridades, temporizadores, redes, USB, etc." +"Las soluciones a los ejercicios de Chromium están en [esta serie de listas " +"de cambios](https://chromium-review.googlesource.com/c/chromium/src/" +"+/5096560)." -#: 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.md +msgid "Welcome to Bare Metal Rust" +msgstr "Te damos la bienvenida a Bare Metal Rust" -#: src/bare-metal/microcontrollers/other-projects.md +#: src/bare-metal.md msgid "" -"Security-focused RTOS with preemptive scheduling and Memory Protection Unit " -"support" +"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 "" -"RTOS centrado en la seguridad con programación interrumpible y " -"compatibilidad con la unidad de protección de memoria." - -#: src/bare-metal/microcontrollers/other-projects.md -msgid "[Hubris](https://hubris.oxide.computer/)" -msgstr "[Hubris](https://hubris.oxide.computer/)" +"Este es un curso independiente de un día sobre Rust bare-metal, dirigido a " +"personas que están familiarizadas con los conceptos básicos de Rust (tal vez " +"después de completar el curso Comprehensive Rust). Lo ideal sería que " +"también tuvieran experiencia con la programación bare-metal en otros " +"lenguajes, como C." -#: src/bare-metal/microcontrollers/other-projects.md +#: src/bare-metal.md msgid "" -"Microkernel RTOS from Oxide Computer Company with memory protection, " -"unprivileged drivers, IPC" +"Today we will talk about 'bare-metal' Rust: running Rust code without an OS " +"underneath us. This will be divided into several parts:" msgstr "" -"RTOS de microkernel de Oxide Computer Company con protección de memoria, " -"controladores sin privilegios, IPC, etc." +"Hoy vamos a hablar de Rust \"bare-metal\": ejecutar código de Rust sin un " +"sistema operativo. Se dividirá en varias partes:" -#: src/bare-metal/microcontrollers/other-projects.md -msgid "[Bindings for FreeRTOS](https://github.com/lobaro/FreeRTOS-rust)" -msgstr "[Enlaces para FreeRTOS](https://github.com/lobaro/FreeRTOS-rust)" +#: src/bare-metal.md +msgid "What is `no_std` Rust?" +msgstr "¿Qué es `no_std` en 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 "" -"Algunas plataformas tienen implementaciones `std`, como [esp-idf](https://" -"esp-rs.github.io/book/overview/using-the-standard-library.html)." +#: src/bare-metal.md +msgid "Writing firmware for microcontrollers." +msgstr "Escribir firmware para microcontroladores." -#: src/bare-metal/microcontrollers/other-projects.md -msgid "RTIC can be considered either an RTOS or a concurrency framework." -msgstr "RTIC se puede considerar un RTOS o un framework de concurrencia." +#: src/bare-metal.md +msgid "Writing bootloader / kernel code for application processors." +msgstr "Escribir código bootloader o kernel para procesadores de aplicaciones." -#: src/bare-metal/microcontrollers/other-projects.md -msgid "It doesn't include any HALs." -msgstr "No incluye ningún HAL." +#: src/bare-metal.md +msgid "Some useful crates for bare-metal Rust development." +msgstr "Algunos crates útiles para el desarrollo de Rust bare-metal." -#: src/bare-metal/microcontrollers/other-projects.md +#: src/bare-metal.md +#, fuzzy msgid "" -"It uses the Cortex-M NVIC (Nested Virtual Interrupt Controller) for " -"scheduling rather than a proper kernel." +"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 "" -"Usa el NVIC (controlador de interrupción virtual anidado) Cortex‐M para la " -"programación en lugar de un kernel propio." - -#: src/bare-metal/microcontrollers/other-projects.md -msgid "Cortex-M only." -msgstr "Solo Cortex-M." +"En la parte del curso dedicada a los microcontroladores, utilizaremos la " +"versión 2 de [BBC micro:bit](https://microbit.org/) como ejemplo. Es una " +"[placa de desarrollo](https://tech.microbit.org/hardware/) basada en el " +"microcontrolador Nordic nRF51822 con algunos LED y botones, un acelerómetro " +"y una brújula conectados mediante I2C y un depurador SWD integrado." -#: src/bare-metal/microcontrollers/other-projects.md +#: src/bare-metal.md msgid "" -"Google uses TockOS on the Haven microcontroller for Titan security keys." +"To get started, install some tools we'll need later. On gLinux or Debian:" msgstr "" -"Google utiliza TockOS en el microcontrolador Haven para las llaves de " -"seguridad Titan." +"Para empezar, instala algunas de las herramientas que necesitarás más " +"adelante. En gLinux o Debian:" -#: src/bare-metal/microcontrollers/other-projects.md +#: src/bare-metal.md msgid "" -"FreeRTOS is mostly written in C, but there are Rust bindings for writing " -"applications." +"And give users in the `plugdev` group access to the micro:bit programmer:" msgstr "" -"FreeRTOS está escrito principalmente en C, pero hay enlaces de Rust para " -"aplicaciones de escritura." +"Permite a los usuarios del grupo `plugdev` acceder al programador micro:bit:" -#: 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 "" -"Leeremos la dirección desde una brújula I2C, y registraremos las lecturas en " -"un puerto serie." +#: src/bare-metal.md src/bare-metal/microcontrollers/debugging.md +msgid "On MacOS:" +msgstr "En MacOS:" -#: src/exercises/bare-metal/morning.md src/exercises/concurrency/morning.md -msgid "" -"After looking at the exercises, you can look at the [solutions](solutions-" -"morning.md) provided." -msgstr "" -"Después de realizar los ejercicios, puedes consultar las [soluciones]" -"(solutions-morning.md) correspondientes." +#: src/bare-metal/no_std.md +msgid "`core`" +msgstr "`core`" -#: 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 "" -"Leeremos la dirección desde una brújula I2C, y registraremos las lecturas en " -"un puerto serie. Si tienes tiempo, prueba a mostrarlo también en los LED o " -"usa los botones de alguna forma." +#: src/bare-metal/no_std.md +msgid "`std`" +msgstr "`std`" -#: src/exercises/bare-metal/compass.md -msgid "Hints:" -msgstr "Sugerencias:" +#: src/bare-metal/no_std.md +msgid "Slices, `&str`, `CStr`" +msgstr "Slices, `&str`, `CStr`" -#: 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 "" -"Consulta la documentación sobre los crates [`lsm303agr`](https://docs.rs/" -"lsm303agr/latest/lsm303agr/) y [`microbit-v2`](https://docs.rs/microbit-v2/" -"latest/microbit/), así como [el hardware de micro:bit](https://tech.microbit." -"org/hardware/)." +#: src/bare-metal/no_std.md +msgid "`NonZeroU8`..." +msgstr "`NonZeroU8`..." -#: src/exercises/bare-metal/compass.md -msgid "" -"The LSM303AGR Inertial Measurement Unit is connected to the internal I2C bus." -msgstr "" -"La unidad de medición inercial LSM303AGR está conectada al bus I2C interno." +#: src/bare-metal/no_std.md +msgid "`Option`, `Result`" +msgstr "`Option`, `Result`" -#: src/exercises/bare-metal/compass.md -msgid "" -"TWI is another name for I2C, so the I2C master peripheral is called TWIM." -msgstr "" -"TWI es otro nombre para I2C, por lo que el periférico I2C maestro se llama " -"TWIM." +#: src/bare-metal/no_std.md +msgid "`Display`, `Debug`, `write!`..." +msgstr "`Display`, `Debug`, `write!`..." -#: src/exercises/bare-metal/compass.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." -msgstr "" -"El controlador LSM303AGR necesita algo que implemente el trait " -"`embedded_hal::blocking::i2c::WriteRead`. La estructura [`microbit::hal::" -"Twim`](https://docs.rs/microbit-v2/latest/microbit/hal/struct.Twim.html) " -"implementa esto." +#: src/bare-metal/no_std.md +msgid "`panic!`, `assert_eq!`..." +msgstr "`panic!`, `assert_eq!`..." -#: 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 "" -"Tienes una estructura [`microbit::Board`](https://docs.rs/microbit-v2/latest/" -"microbit/struct.Board.html) con campos para los distintos pines y " -"periféricos." +#: src/bare-metal/no_std.md +msgid "`NonNull` and all the usual pointer-related functions" +msgstr "`NonNull` y todas las funciones relacionadas con punteros habituales" -#: 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 "" -"También puedes consultar la \\[hoja de datos nRF52833\\][nRF52833 datasheet]" -"(https://infocenter.nordicsemi.com/pdf/nRF52833_PS_v1.5.pdf) si quieres, " -"pero no debería ser necesario para este ejercicio." +#: src/bare-metal/no_std.md +msgid "`Future` and `async`/`await`" +msgstr "`Future` and `async`/`await`" -#: 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 "" -"Descarga la [plantilla de ejercicio](../../comprehensive-rust-exercises.zip) " -"y busca los siguientes archivos en el directorio `compass`." +#: src/bare-metal/no_std.md +msgid "`fence`, `AtomicBool`, `AtomicPtr`, `AtomicU32`..." +msgstr "`fence`, `AtomicBool`, `AtomicPtr`, `AtomicU32`..." -#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md -#, fuzzy -msgid "_src/main.rs_:" -msgstr "`src/main.rs`:" +#: src/bare-metal/no_std.md +msgid "`Duration`" +msgstr "`Duration`" -#: src/exercises/bare-metal/compass.md -#: src/exercises/bare-metal/solutions-morning.md -msgid "// Configure serial port.\n" -msgstr "// Configura el puerto serie.\n" +#: src/bare-metal/no_std.md +msgid "`Box`, `Cow`, `Arc`, `Rc`" +msgstr "`Box`, `Cow`, `Arc`, `Rc`" -#: src/exercises/bare-metal/compass.md -#: src/exercises/bare-metal/solutions-morning.md -msgid "// Use the system timer as a delay provider.\n" -msgstr "// Usa el temporizador del sistema como proveedor de retrasos.\n" +#: src/bare-metal/no_std.md +msgid "`Vec`, `BinaryHeap`, `BtreeMap`, `LinkedList`, `VecDeque`" +msgstr "`Vec`, `BinaryHeap`, `BtreeMap`, `LinkedList`, `VecDeque`" -#: src/exercises/bare-metal/compass.md -msgid "" -"// Set up the I2C controller and Inertial Measurement Unit.\n" -" // TODO\n" -msgstr "" -"// Configura el controlador I2C y la unidad de medición inercial.\n" -" // TAREA\n" +#: src/bare-metal/no_std.md +msgid "`String`, `CString`, `format!`" +msgstr "`String`, `CString`, `format!`" -#: src/exercises/bare-metal/compass.md -#: src/exercises/bare-metal/solutions-morning.md -msgid "\"Ready.\"" -msgstr "\"Listo.\"" +#: src/bare-metal/no_std.md +msgid "`Error`" +msgstr "`Error`" -#: src/exercises/bare-metal/compass.md -msgid "" -"// Read compass data and log it to the serial port.\n" -" // TODO\n" -msgstr "" -"// Lee datos de la brújula y regístralos en el puerto serie.\n" -" // TAREA\n" +#: src/bare-metal/no_std.md +msgid "`Mutex`, `Condvar`, `Barrier`, `Once`, `RwLock`, `mpsc`" +msgstr "`Mutex`, `Condvar`, `Barrier`, `Once`, `RwLock`, `mpsc`" -#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md -#, fuzzy -msgid "_Cargo.toml_ (you shouldn't need to change this):" -msgstr "`Cargo.toml` (no debería ser necesario cambiarlo):" +#: src/bare-metal/no_std.md +msgid "`File` and the rest of `fs`" +msgstr "`File` y el resto de `fs`" -#: src/exercises/bare-metal/compass.md -#, fuzzy -msgid "_Embed.toml_ (you shouldn't need to change this):" -msgstr "`Embed.toml` (no debería ser necesario cambiarlo):" +#: src/bare-metal/no_std.md +msgid "`println!`, `Read`, `Write`, `Stdin`, `Stdout` and the rest of `io`" +msgstr "`println!`, `Read`, `Write`, `Stdin`, `Stdout` y el resto de `io`" -#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md -#, fuzzy -msgid "_.cargo/config.toml_ (you shouldn't need to change this):" -msgstr "`.cargo/config.toml` (no debería ser necesario cambiarlo):" +#: src/bare-metal/no_std.md +msgid "`Path`, `OsString`" +msgstr "`Path`, `OsString`" -#: src/exercises/bare-metal/compass.md -msgid "See the serial output on Linux with:" -msgstr "Consulta la salida de serie en Linux con:" +#: src/bare-metal/no_std.md +msgid "`net`" +msgstr "`net`" -#: src/exercises/bare-metal/compass.md -msgid "" -"Or on Mac OS something like (the device name may be slightly different):" -msgstr "" -"En Mac OS debería ser algo como lo siguiente (el nombre del dispositivo " -"puede ser algo diferente):" +#: src/bare-metal/no_std.md +msgid "`Command`, `Child`, `ExitCode`" +msgstr "`Command`, `Child`, `ExitCode`" -#: src/exercises/bare-metal/compass.md -msgid "Use Ctrl+A Ctrl+Q to quit picocom." -msgstr "Pulsa Ctrl+A Ctrl+Q para salir de Picocom." +#: src/bare-metal/no_std.md +msgid "`spawn`, `sleep` and the rest of `thread`" +msgstr "`spawn`, `sleep` y el resto de `thread`" -#: src/exercises/bare-metal/solutions-morning.md -msgid "Bare Metal Rust Morning Exercise" -msgstr "Rust Bare Metal: Ejercicio de la Mañana" +#: src/bare-metal/no_std.md +msgid "`SystemTime`, `Instant`" +msgstr "`SystemTime`, `Instant`" -#: src/exercises/bare-metal/solutions-morning.md -msgid "([back to exercise](compass.md))" -msgstr "([volver al ejercicio](compass.md))" +#: src/bare-metal/no_std.md +msgid "`HashMap` depends on RNG." +msgstr "`HashMap` depende de RNG." -#: src/exercises/bare-metal/solutions-morning.md -msgid "// Set up the I2C controller and Inertial Measurement Unit.\n" -msgstr "// Configura el controlador de I2C y la unidad de medición inercial.\n" +#: src/bare-metal/no_std.md +msgid "`std` re-exports the contents of both `core` and `alloc`." +msgstr "`std` vuelve a exportar el contenido de `core` y `alloc`." -#: src/exercises/bare-metal/solutions-morning.md -msgid "\"Setting up IMU...\"" -msgstr "\"Configurando IMU...\"" +#: src/bare-metal/minimal.md +msgid "A minimal `no_std` program" +msgstr "Un programa `no_std` mínimo" -#: src/exercises/bare-metal/solutions-morning.md -msgid "// Set up display and timer.\n" -msgstr "// Configura la pantalla y el temporizador.\n" +#: src/bare-metal/minimal.md +msgid "This will compile to an empty binary." +msgstr "Se compilará en un binario vacío." -#: src/exercises/bare-metal/solutions-morning.md -msgid "// Read compass data and log it to the serial port.\n" -msgstr "// Lee los datos de la brújula y regístralos en el puerto serie.\n" +#: src/bare-metal/minimal.md +msgid "`std` provides a panic handler; without it we must provide our own." +msgstr "" +"`std` proporciona un controlador de _panic_; sin no hay, debemos " +"proporcionar uno nuestro." -#: src/exercises/bare-metal/solutions-morning.md -msgid "\"{},{},{}\\t{},{},{}\"" -msgstr "\"{},{},{}\\t{},{},{}\"" +#: src/bare-metal/minimal.md +msgid "It can also be provided by another crate, such as `panic-halt`." +msgstr "También puede proporcionarlo otro crate, como `panic-halt`." -#: src/exercises/bare-metal/solutions-morning.md +#: src/bare-metal/minimal.md msgid "" -"// If button A is pressed, switch to the next mode and briefly blink all " -"LEDs\n" -" // on.\n" +"Depending on the target, you may need to compile with `panic = \"abort\"` to " +"avoid an error about `eh_personality`." msgstr "" -"// Si se pulsa el botón A, cambia al siguiente modo y haz que parpadeen " -"brevemente todos los LED\n" -" // activados.\n" +"Dependiendo del objetivo, es posible que tengas que compilar con `panic = " +"\"abort\"` para evitar un error sobre `eh_personality`." -#: src/bare-metal/aps.md -msgid "Application processors" -msgstr "Procesadores de aplicaciones" +#: 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 "" +"Ten en cuenta que no hay `main` ni ningún otro punto de entrada; depende de " +"ti definir un punto de entrada propio. Esto suele implicar una secuencia de " +"comandos de enlazador y algún código de ensamblado de forma que todo esté " +"preparado para que se ejecute el código de Rust." -#: src/bare-metal/aps.md +#: src/bare-metal/alloc.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." +"To use `alloc` you must implement a [global (heap) allocator](https://doc." +"rust-lang.org/stable/std/alloc/trait.GlobalAlloc.html)." msgstr "" -"Hasta ahora hemos hablado de microcontroladores, como la serie Cortex‐M de " -"Arm. Ahora vamos a probar a escribir algo para Cortex-A. Para simplificar, " -"solo trabajaremos con la placa ['virt'](https://qemu-project.gitlab.io/qemu/" -"system/arm/virt.html) aarch64 de QEMU." +"Para utilizar `alloc`, debes implementar un [asignador global (de _heap_)]" +"(https://doc.rust-lang.org/stable/std/alloc/trait.GlobalAlloc.html)." -#: src/bare-metal/aps.md +#: src/bare-metal/alloc.md +#, fuzzy +msgid "// SAFETY: `HEAP` is only used here and `entry` is only called once.\n" +msgstr "" +"// Es seguro porque `HEAP` solo se usa aquí y solo se llama una vez a " +"`entry`.\n" + +#: src/bare-metal/alloc.md +msgid "// Give the allocator some memory to allocate.\n" +msgstr "// Proporciona al asignador algo de memoria para asignar.\n" + +#: src/bare-metal/alloc.md +msgid "// Now we can do things that require heap allocation.\n" +msgstr "" +"// Ahora podemos llevar a cabo acciones que requieran la asignación de " +"montículo.\n" + +#: src/bare-metal/alloc.md +#, fuzzy +msgid "\"A string\"" +msgstr "String" + +#: src/bare-metal/alloc.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." +"`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 "" -"En términos generales, los microcontroladores no tienen un MMU ni varios " -"niveles de privilegio (niveles de excepción en las CPU de Arm, anillos en " -"x86), mientras que los procesadores de aplicaciones sí los tienen." +"`buddy_system_allocator` es un crate de terceros que implementa un _buddy " +"system allocator_ (una técnica de asignación de memoria) básico. Hay otros " +"crates disponibles, pero también puedes escribir el tuyo propio o conectarte " +"a tu asignador." -#: src/bare-metal/aps.md +#: src/bare-metal/alloc.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." +"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 "" -"QEMU permite emular varias máquinas o modelos de placa diferentes para cada " -"arquitectura. La placa \"virt\" no se corresponde con ningún hardware real " -"concreto, pero está diseñada exclusivamente para máquinas virtuales." +"El parámetro const de `LockedHeap` es el orden máximo del asignador. Es " +"decir, en este caso, puede asignar regiones de hasta 2\\*\\*32 bytes." -#: src/bare-metal/aps/entry-point.md +#: src/bare-metal/alloc.md msgid "" -"Before we can start running Rust code, we need to do some initialisation." +"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 "" -"Antes de que podamos empezar a ejecutar código de Rust, tenemos que hacer " -"alguna inicialización." +"Si algún crate del árbol de dependencias depende de `alloc`, debes tener " +"exactamente un asignador global definido en el binario. Esto se suele hacer " +"en el crate binario de nivel superior." -#: src/bare-metal/aps/entry-point.md +#: src/bare-metal/alloc.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" -"```" +"`extern crate panic_halt as _` is necessary to ensure that the `panic_halt` " +"crate is linked in so we get its panic handler." msgstr "" -"```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" -"```" +"`extern crate panic_halt as _` es necesario para asegurar que el crate " +"`panic_halt` esté vinculado y así podamos obtener su controlador de _panic_." -#: 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." +#: src/bare-metal/alloc.md +msgid "This example will build but not run, as it doesn't have an entry point." msgstr "" -"Es lo mismo que en C: inicializar el estado del procesador, poner a cero el " -"BSS y configurar el puntero de la _stack_." +"Este ejemplo se compilará pero no se ejecutará, ya que no cuenta con un " +"punto de entrada." -#: src/bare-metal/aps/entry-point.md +#: src/bare-metal/microcontrollers.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." +"The `cortex_m_rt` crate provides (among other things) a reset handler for " +"Cortex M microcontrollers." msgstr "" -"El BSS (símbolo de inicio del bloque, por motivos históricos) es la parte " -"del objeto que contiene variables asignadas de forma estática que se " -"inicializan a cero. Se omiten en la imagen para evitar malgastar espacio con " -"ceros. El compilador asume que el cargador se encargará de ponerlos a cero." +"El crate `cortex_m_rt` proporciona (entre otras cosas) un controlador de " +"reinicio para microcontroladores Cortex M." -#: src/bare-metal/aps/entry-point.md +#: src/bare-metal/microcontrollers.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." +"Next we'll look at how to access peripherals, with increasing levels of " +"abstraction." msgstr "" -"Es posible que el BSS ya esté a cero, dependiendo de cómo se inicialice la " -"memoria y cómo se cargue la imagen, aunque se pone igualmente a cero para " -"estar seguros." +"A continuación, veremos cómo se accede a los periféricos con niveles de " +"abstracción cada vez mayores." -#: src/bare-metal/aps/entry-point.md +#: src/bare-metal/microcontrollers.md msgid "" -"We need to enable the MMU and cache before reading or writing any memory. If " -"we don't:" +"The `cortex_m_rt::entry` macro requires that the function have type `fn() -" +"> !`, because returning to the reset handler doesn't make sense." msgstr "" -"Necesitamos habilitar la MMU y la caché antes de leer o escribir memoria. Si " -"no lo hacemos, sucederá lo siguiente:" +"La macro `cortex_m_rt::entry` requiere que la función tenga el tipo `fn() -" +"> !`, ya que no tiene sentido devolver resultados al controlador de reinicio." -#: src/bare-metal/aps/entry-point.md +#: src/bare-metal/microcontrollers.md +msgid "Run the example with `cargo embed --bin minimal`" +msgstr "Ejecuta el ejemplo con `cargo embed --bin minimal`." + +#: src/bare-metal/microcontrollers/mmio.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." +"Most microcontrollers access peripherals via memory-mapped IO. Let's try " +"turning on an LED on our micro:bit:" msgstr "" -"Los accesos no alineados fallarán. Compilamos el código Rust para el " -"objetivo `aarch64-unknown-none`, que define `+strict-align` para evitar que " -"el compilador genere accesos no alineados. En este caso debería estar bien, " -"pero no tiene por qué ser así en general." +"La mayoría de los microcontroladores acceden a los periféricos a través de E/" +"S asignada a la memoria. Vamos a probar a encender un LED en nuestro micro:" +"bit:" -#: src/bare-metal/aps/entry-point.md +#: src/bare-metal/microcontrollers/mmio.md +msgid "/// GPIO port 0 peripheral address\n" +msgstr "/// Dirección de periférico del puerto GPIO 0\n" + +#: src/bare-metal/microcontrollers/mmio.md +msgid "// GPIO peripheral offsets\n" +msgstr "// Offset de periféricos GPIO\n" + +#: src/bare-metal/microcontrollers/mmio.md +msgid "// PIN_CNF fields\n" +msgstr "// Campos 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 "// Configura los pines 21 y 28 de GPIO 0 como salidas push-pull.\n" + +#: src/bare-metal/microcontrollers/mmio.md +#, fuzzy 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.)" +"// SAFETY: The pointers are to valid peripheral control registers, and no\n" +" // aliases exist.\n" msgstr "" -"Si se estuviera ejecutando en una máquina virtual, podría provocar problemas " -"de coherencia en la caché. El problema es que la máquina virtual accede a la " -"memoria directamente con la caché inhabilitada, mientras que el host cuenta " -"con alias que se pueden almacenar en caché en la misma memoria. Incluso si " -"el host no accede explícitamente a la memoria, los accesos especulativos " -"pueden provocar que se llene la caché, haciendo que los cambios de uno u " -"otro se pierdan cuando se borre la caché o cuando la máquina virtual la " -"habilite. (La caché está codificada por dirección física, no por VA ni IPA)." +"// Es seguro porque los punteros dirigen a registros de control de " +"periféricos válidos y\n" +" // no existe ningún alias.\n" -#: src/bare-metal/aps/entry-point.md +#: 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 "// Define el pin 28 bajo y 21 alto para encender el LED.\n" + +#: src/bare-metal/microcontrollers/mmio.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." +"GPIO 0 pin 21 is connected to the first column of the LED matrix, and pin 28 " +"to the first row." msgstr "" -"Para simplificar, solo se utiliza una tabla de páginas codificada (consulta " -"`idmap.S`) que mapea la identidad del primer GiB de espacio de direcciones " -"para dispositivos, el siguiente GiB para DRAM y otro GiB más para más " -"dispositivos. Esto coincide con la disposición de memoria que utiliza QEMU." +"El pin 21 de GPIO 0 está conectado a la primera columna de la matriz de LED " +"y el pin 28 a la primera fila." -#: src/bare-metal/aps/entry-point.md +#: 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 "Ejecuta el ejemplo con:" + +#: src/bare-metal/microcontrollers/pacs.md +msgid "Peripheral Access Crates" +msgstr "Crates de Acceso Periférico" + +#: src/bare-metal/microcontrollers/pacs.md msgid "" -"We also set up the exception vector (`vbar_el1`), which we'll see more about " -"later." +"[`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 "" -"También configuramos el vector de excepción (`vbar_el1`), del que veremos " -"más contenido en próximas dipositivas." +"[`svd2rust`](https://crates.io/crates/svd2rust) genera, en su gran mayoría, " +"envoltorios seguros de Rust para periféricos asignados a la memoria a partir " +"de archivos [CMSIS-SVD](https://www.keil.com/pack/doc/CMSIS/SVD/html/index." +"html)." -#: src/bare-metal/aps/entry-point.md +#: src/bare-metal/microcontrollers/pacs.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." +"SVD (System View Description) files are XML files typically provided by " +"silicon vendors which describe the memory map of the device." msgstr "" -"Todos los ejemplos de esta tarde se ejecutarán en el nivel de excepción 1 " -"(EL1). Si necesitas ejecutar en un nivel de excepción diferente, deberás " -"modificar `entry.S` según corresponda." - -#: src/bare-metal/aps/inline-assembly.md -msgid "Inline assembly" -msgstr "Ensamblaje integrado" +"Los archivos SVD (System View Description) son archivos XML que suelen " +"proporcionar los proveedores de silicio y que describen el mapa de memoria " +"del dispositivo." -#: src/bare-metal/aps/inline-assembly.md -#, fuzzy +#: src/bare-metal/microcontrollers/pacs.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:" +"They are organised by peripheral, register, field and value, with names, " +"descriptions, addresses and so on." msgstr "" -"A veces necesitamos usar el ensamblador para hacer cosas que no son posibles " -"con código Rust. Por ejemplo, hacer un " +"Se organizan por periférico, registro, campo y valor, con nombres, " +"descripciones y direcciones, etc." -#: src/bare-metal/aps/inline-assembly.md +#: src/bare-metal/microcontrollers/pacs.md msgid "" -"// Safe because this only uses the declared registers and doesn't do\n" -" // anything with memory.\n" +"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 "" -"// Es seguro porque solo utiliza los registros declarados y no\n" -" // hace nada con la memoria.\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\"" +"Los archivos SVD suelen tener errores y estar incompletos, por lo que " +"existen varios proyectos que aplican parches a los errores, añaden detalles " +"que faltan y publican los crates generados." -#: src/bare-metal/aps/inline-assembly.md -msgid "\"w5\"" -msgstr "\"w5\"" +#: src/bare-metal/microcontrollers/pacs.md +msgid "`cortex-m-rt` provides the vector table, among other things." +msgstr "`cortex-m-rt` proporciona la tabla de vectores, entre otras cosas." -#: src/bare-metal/aps/inline-assembly.md -msgid "\"w6\"" -msgstr "\"w6\"" +#: 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 "" +"Si instalas `cargo install cargo-binutils` puedes ejecutar `cargo objdump --" +"bin pac -- -d --no-show-raw-insn` para ver el binario resultante." -#: src/bare-metal/aps/inline-assembly.md -msgid "\"w7\"" -msgstr "\"w7\"" +#: src/bare-metal/microcontrollers/hals.md +msgid "HAL crates" +msgstr "Crates HAL" -#: src/bare-metal/aps/inline-assembly.md +#: src/bare-metal/microcontrollers/hals.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.)" +"[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 "" -"(Si realmente quieres hacer esto, utiliza el crate [`smccc`](https://crates." -"io/crates/smccc) que tiene envoltorios para todas estas funciones)." +"[Los crates HAL](https://github.com/rust-embedded/awesome-embedded-rust#hal-" +"implementation-crates) de muchos microcontroladores incluyen envoltorios " +"alrededor de varios periféricos. Por lo general, implementan traits de " +"[`embedded-hal`](https://crates.io/crates/embedded-hal)." -#: src/bare-metal/aps/inline-assembly.md +#: src/bare-metal/microcontrollers/hals.md +msgid "// Create HAL wrapper for GPIO port 0.\n" +msgstr "// Crea un envoltorio HAL para el puerto GPIO 0.\n" + +#: src/bare-metal/microcontrollers/hals.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." +"`set_low` and `set_high` are methods on the `embedded_hal` `OutputPin` trait." msgstr "" -"PSCI es la interfaz de coordinación de estado de alimentación de Arm, un " -"conjunto estándar de funciones para gestionar los estados de alimentación " -"del sistema y de la CPU, entre otras cosas. Lo implementan el firmware EL3 y " -"los hipervisores en muchos sistemas." +"`set_low` y `set_high` son métodos del trait `OutputPin` de `embedded_hal`." -#: src/bare-metal/aps/inline-assembly.md +#: src/bare-metal/microcontrollers/hals.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." +"HAL crates exist for many Cortex-M and RISC-V devices, including various " +"STM32, GD32, nRF, NXP, MSP430, AVR and PIC microcontrollers." msgstr "" -"La sintaxis `0 => _` significa inicializar el registro a 0 antes de ejecutar " -"el código de ensamblaje integrado e ignorar su contenido después. " -"Necesitamos utilizar `inout` en lugar de `in` porque la llamada podría " -"alterar el contenido de los registros." +"Hay crates HAL para muchos dispositivos Cortex-M y RISC-V, incluidos varios " +"microcontroladores STM32, GD32, nRF, NXP, MSP430, AVR y PIC." -#: src/bare-metal/aps/inline-assembly.md +#: src/bare-metal/microcontrollers/board-support.md +msgid "Board support crates" +msgstr "Crates de compatibilidad de placa" + +#: src/bare-metal/microcontrollers/board-support.md msgid "" -"This `main` function needs to be `#[no_mangle]` and `extern \"C\"` because " -"it is called from our entry point in `entry.S`." +"Board support crates provide a further level of wrapping for a specific " +"board for convenience." msgstr "" -"Esta función `main` debe ser `#[no_mangle]` y `extern \"C\"`, ya que se " -"llama desde nuestro punto de entrada en `entry.S`." +"Los crates de compatibilidad de placa proporcionan un nivel adicional de " +"envoltorio a una placa específica para mayor comodidad." -#: src/bare-metal/aps/inline-assembly.md +#: src/bare-metal/microcontrollers/board-support.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." +"In this case the board support crate is just providing more useful names, " +"and a bit of initialisation." msgstr "" -"`_x0`–`_x3` son los valores de los registros `x0`–`x3`, que el bootloader " -"utiliza habitualmente para pasar elementos al árbol de dispositivos, como un " -"puntero. De acuerdo con la convención de llamadas estándar de aarch64 (que " -"es lo que `extern \"C\"` usa), los registros `x0`–`x7` se utilizan para los " -"primeros ocho argumentos que se pasan a una función, de modo que `entry.S` " -"no tiene que hacer nada especial, salvo asegurarse de que no cambia estos " -"registros." +"En este caso, el crate de compatibilidad de placa proporciona solo nombres " +"más útiles y un poco de inicialización." -#: src/bare-metal/aps/inline-assembly.md +#: src/bare-metal/microcontrollers/board-support.md msgid "" -"Run the example in QEMU with `make qemu_psci` under `src/bare-metal/aps/" -"examples`." +"The crate may also include drivers for some on-board devices outside of the " +"microcontroller itself." msgstr "" -"Ejecuta el ejemplo en QEMU con `make qemu_psci` en `src/bare-metal/aps/" -"examples`." +"El crate también puede incluir controladores para algunos dispositivos " +"integrados fuera del propio microcontrolador ." -#: src/bare-metal/aps/mmio.md -msgid "Volatile memory access for MMIO" -msgstr "Acceso a la memoria volátil para MMIO" +#: src/bare-metal/microcontrollers/board-support.md +msgid "`microbit-v2` includes a simple driver for the LED matrix." +msgstr "`microbit-v2` incluye un controlador sencillo para la matriz de LED." -#: src/bare-metal/aps/mmio.md -msgid "Use `pointer::read_volatile` and `pointer::write_volatile`." -msgstr "Se puede usar `pointer::read_volatile` y `pointer::write_volatile`." +#: src/bare-metal/microcontrollers/type-state.md +msgid "The type state pattern" +msgstr "El patrón de tipo de estado" -#: src/bare-metal/aps/mmio.md -msgid "Never hold a reference." -msgstr "Nunca retengas una referencia." +#: 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; // Error, se ha movido.\n" -#: src/bare-metal/aps/mmio.md -msgid "" -"`addr_of!` lets you get fields of structs without creating an intermediate " -"reference." -msgstr "" -"`addr_of!` permite obtener campos de estructuras sin crear una referencia " -"intermedia." +#: src/bare-metal/microcontrollers/type-state.md +msgid "// pin_input.is_high(); // Error, moved.\n" +msgstr "// pin_input.is_high(); // Error, se ha movido.\n" -#: src/bare-metal/aps/mmio.md +#: src/bare-metal/microcontrollers/type-state.md msgid "" -"Volatile access: read or write operations may have side-effects, so prevent " -"the compiler or hardware from reordering, duplicating or eliding them." +"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 "" -"Acceso volátil: las operaciones de lectura o escritura pueden tener efectos " -"secundarios, por lo que se debe evitar que el compilador o el hardware las " -"reordene, duplique u omita." +"Los pines no implementan `Copy` ni `Clone`, por lo que solo puede haber una " +"instancia de cada uno. Cuando se quita un pin de la estructura del puerto, " +"nadie más puede usarlo." -#: src/bare-metal/aps/mmio.md +#: src/bare-metal/microcontrollers/type-state.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." +"Changing the configuration of a pin consumes the old pin instance, so you " +"can’t keep use the old instance afterwards." msgstr "" -"Normalmente, si escribes y luego lees (por ejemplo, a través de una " -"referencia mutable), el compilador puede suponer que el valor leído es el " -"mismo que el que se acaba de escribir, sin molestarse si quiera en leer " -"realmente la memoria." +"Si cambias la configuración de un pin, se consumirá la instancia del pin " +"anterior y no podrás seguir usando la instancia previa." -#: src/bare-metal/aps/mmio.md +#: src/bare-metal/microcontrollers/type-state.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 "" -"Algunos crates para el acceso volátil al hardware sí mantienen referencias, " -"aunque no es seguro. Siempre que exista una referencia, el compilador puede " -"desreferenciarla." +"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 "" +"El tipo de un valor indica el estado en el que se encuentra: por ejemplo, en " +"este caso, el estado de configuración de un pin de GPIO. De esta manera, se " +"codifica la máquina de estados en el sistema de tipos, asegurando así que no " +"se use un pin de cierta forma sin antes configurarlo correctamente. Las " +"transiciones de estado ilegales se detectan durante el tiempo de compilación." -#: src/bare-metal/aps/mmio.md +#: src/bare-metal/microcontrollers/type-state.md msgid "" -"Use the `addr_of!` macro to get struct field pointers from a pointer to the " -"struct." +"You can call `is_high` on an input pin and `set_high` on an output pin, but " +"not vice-versa." msgstr "" -"Utiliza la macro `addr_of!` para obtener punteros de campos de estructuras a " -"partir de un puntero en la estructura." +"Puedes llamar a `is_high` en un pin de entrada y a `set_high` en un pin de " +"salida, pero no al revés." -#: src/bare-metal/aps/uart.md -msgid "Let's write a UART driver" -msgstr "Vamos a escribir un controlador de UART" +#: src/bare-metal/microcontrollers/type-state.md +msgid "Many HAL crates follow this pattern." +msgstr "Muchos crates HAL siguen este patrón." -#: src/bare-metal/aps/uart.md +#: src/bare-metal/microcontrollers/embedded-hal.md +#, fuzzy msgid "" -"The QEMU 'virt' machine has a [PL011](https://developer.arm.com/" -"documentation/ddi0183/g) UART, so let's write a driver for that." +"The [`embedded-hal`](https://crates.io/crates/embedded-hal) crate provides a " +"number of traits covering common microcontroller peripherals:" msgstr "" -"La máquina \"virt\" de QEMU tiene una UART [PL011]https://developer.arm.com/" -"documentation/ddi0183/g), así que vamos a escribir un controlador para ella." +"El crate [`embedded-hal`](https://crates.io/crates/embedded-hal) proporciona " +"una serie de traits que cubren los periféricos habituales de los " +"microcontroladores." -#: src/bare-metal/aps/uart.md -msgid "/// Minimal driver for a PL011 UART.\n" -msgstr "/// Controlador mínimo para un UART PL011.\n" +#: src/bare-metal/microcontrollers/embedded-hal.md +msgid "GPIO" +msgstr "GPIO" -#: 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" +#: src/bare-metal/microcontrollers/embedded-hal.md +msgid "PWM" msgstr "" -"/// Construye una instancia nueva del controlador de UART para un " -"dispositivo PL011 en la\n" -" /// dirección base proporcionada.\n" -" ///\n" -" /// # Seguridad\n" -" ///\n" -" /// La dirección base debe apuntar a los 8 registros de control MMIO de " -"un \n" -" /// dispositivo PL011, que debe asignarse al espacio de direcciones del " -"proceso\n" -" /// como memoria del dispositivo y no tener ningún otro alias.\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 "/// Escribe un solo byte en el UART.\n" +#: src/bare-metal/microcontrollers/embedded-hal.md +msgid "Delay timers" +msgstr "" -#: 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 "// Espera hasta que haya espacio en el búfer de TX.\n" +#: src/bare-metal/microcontrollers/embedded-hal.md +msgid "I2C and SPI buses and devices" +msgstr "" -#: src/bare-metal/aps/uart.md +#: src/bare-metal/microcontrollers/embedded-hal.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" +"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 "" -"// Es seguro porque sabemos que la dirección base apunta a los registros\n" -" // de control de un dispositivo PL011 que está asignado " -"correctamente.\n" - -#: 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 "// Escribe en el búfer de TX.\n" - -#: 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 "// Espera hasta que el UART esté libre.\n" -#: src/bare-metal/aps/uart.md +#: src/bare-metal/microcontrollers/embedded-hal.md +#, fuzzy 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." +"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 "" -"Ten en cuenta que `Uart::new` no es seguro, mientras que los otros métodos " -"sí lo son. Esto se debe a que mientras que el llamador de `Uart::new` " -"asegure que se cumplan sus requisitos de seguridad (es decir, que solo haya " -"una instancia del controlador para una UART determinada y que nada más " -"asigne alias a su espacio de direcciones), siempre es más seguro llamar a " -"`write_byte` más adelante, ya que podemos asumir\\ las condiciones previas " -"necesarias." +"Es entonces cuando otros crates implementan [controladores](https://github." +"com/rust-embedded/awesome-embedded-rust#driver-crates) en función de estos " +"traits. Por ejemplo, un controlador de acelerómetro podría necesitar una " +"implementación de bus I2C o SPI." -#: src/bare-metal/aps/uart.md +#: src/bare-metal/microcontrollers/embedded-hal.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" +"The traits cover using the peripherals but not initialising or configuring " +"them, as initialisation and configuration is usually highly platform-" +"specific." msgstr "" -"Podríamos haberlo hecho al revés (haciendo que `new` fuese seguro y " -"`write_byte` no seguro), pero\\sería mucho menos cómodo de usar, ya que cada " -"lugar que llamase a `write_byte` tendría que pensar en la seguridad" -#: src/bare-metal/aps/uart.md +#: src/bare-metal/microcontrollers/embedded-hal.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." +"There are implementations for many microcontrollers, as well as other " +"platforms such as Linux on Raspberry Pi." msgstr "" -"Este es un patrón común para escribir envoltorios seguros de código " -"inseguro: mover la carga de la prueba de seguridad de un gran número de " -"lugares a otro más pequeño." - -#: src/bare-metal/aps/uart/traits.md -msgid "More traits" -msgstr "Más traits" +"Hay implementaciones para muchos microcontroladores, así como otras " +"plataformas como Linux en Raspberry Pi." -#: src/bare-metal/aps/uart/traits.md +#: src/bare-metal/microcontrollers/embedded-hal.md +#, fuzzy msgid "" -"We derived the `Debug` trait. It would be useful to implement a few more " -"traits too." +"[`embedded-hal-async`](https://crates.io/crates/embedded-hal-async) provides " +"async versions of the traits." msgstr "" -"Hemos derivado el trait `Debug`. También sería útil implementar algunos " -"traits más." +"El crate [`embedded-hal`](https://crates.io/crates/embedded-hal) proporciona " +"una serie de traits que cubren los periféricos habituales de los " +"microcontroladores." -#: src/bare-metal/aps/uart/traits.md src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/bare-metal/microcontrollers/embedded-hal.md +#, fuzzy msgid "" -"// Safe because it just contains a pointer to device memory, which can be\n" -"// accessed from any context.\n" +"[`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 "" -"// Es seguro porque solo contiene un puntero a la memoria del dispositivo,\n" -"// a la que se puede acceder desde cualquier contexto.\n" +"El crate [`embedded-hal`](https://crates.io/crates/embedded-hal) proporciona " +"una serie de traits que cubren los periféricos habituales de los " +"microcontroladores." -#: src/bare-metal/aps/uart/traits.md +#: src/bare-metal/microcontrollers/probe-rs.md msgid "" -"Implementing `Write` lets us use the `write!` and `writeln!` macros with our " -"`Uart` type." +"[probe-rs](https://probe.rs/) is a handy toolset for embedded debugging, " +"like OpenOCD but better integrated." msgstr "" -"Implementar `Write` nos permite utilizar las macros `write!` y `writeln!` " -"con nuestro tipo `Uart`." +"[probe-rs](https://probe.rs/) es un conjunto de herramientas de depuración " +"integradas muy útil, como OpenOCD, pero mejor integrado." -#: src/bare-metal/aps/uart/traits.md +#: src/bare-metal/microcontrollers/probe-rs.md +#, fuzzy msgid "" -"Run the example in QEMU with `make qemu_minimal` under `src/bare-metal/aps/" -"examples`." +"SWD (Serial Wire Debug) and JTAG via CMSIS-DAP, ST-Link and J-Link probes" +msgstr " y JTAG a través de comprobaciones CMSIS-DAP, ST-Link y J-Link" + +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "GDB stub and Microsoft DAP (Debug Adapter Protocol) server" msgstr "" -"Ejecuta el ejemplo en QEMU con `make qemu_minimal` en `src/bare-metal/aps/" -"examples`." +"Stub de GDB y servidor de Microsoft DAP (protocolo de adaptador de " +"depuración)" -#: src/bare-metal/aps/better-uart.md -msgid "A better UART driver" -msgstr "Un controlador UART mejor" +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "Cargo integration" +msgstr "Integración de Cargo" -#: src/bare-metal/aps/better-uart.md +#: src/bare-metal/microcontrollers/probe-rs.md +#, fuzzy 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." +"`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 "" -"En realidad, PL011 tiene [muchos registros más](https://developer.arm.com/" -"documentation/ddi0183/g/programmers-model/summary-of-registers), por lo que " -"añadir desplazamientos para crear punteros que les permita acceder a ellos " -"da lugar a errores y dificulta la lectura. Además, algunos de ellos son " -"campos de bits a los que estaría bien acceder de forma estructurada." +" y conectar GDB. Se configura mediante un archivo `Embed.toml` en el " +"directorio del proyecto." -#: src/bare-metal/aps/better-uart.md -msgid "Offset" -msgstr "Desplazamiento" +#: 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) es " +"un protocolo estándar de Arm mediante USB que permite que un depurador en " +"circuito acceda al puerto de acceso de depuración CoreSight de varios " +"procesadores Cortex de Arm. Es lo que utiliza el depurador integrado en el " +"BBC micro:bit" -#: src/bare-metal/aps/better-uart.md -msgid "Register name" -msgstr "Nombre de registro" +#: 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 es una gama de depuradores en circuito de ST Microelectronics. J-" +"Link es una gama de SEGGER." -#: src/bare-metal/aps/better-uart.md -msgid "Width" -msgstr "Ancho" +#: 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 "" +"El puerto de acceso de depuración suele ser una interfaz JTAG de 5 pines o " +"una SWD de 2 pines." -#: src/bare-metal/aps/better-uart.md -msgid "0x00" -msgstr "0x00" +#: 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 es una biblioteca que puedes integrar en tus propias herramientas." -#: 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/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 "" +"[El protocolo de adaptador de depuración de Microsoft](https://microsoft." +"github.io/debug-adapter-protocol/) permite que VSCode y otros IDEs depuren " +"el código que se ejecuta en cualquier microcontrolador compatible." -#: src/bare-metal/aps/better-uart.md -msgid "RSR" -msgstr "RSR" +#: src/bare-metal/microcontrollers/probe-rs.md +msgid "cargo-embed is a binary built using the probe-rs library." +msgstr "cargo-embed es un binario compilado con la biblioteca probe-rs." -#: src/bare-metal/aps/better-uart.md -msgid "0x18" -msgstr "0x18" +#: 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 "" +"TTR (transferencias en tiempo real) es un mecanismo para transferir datos " +"entre el host de depuración y el objetivo a través de una serie de búferes " +"circulares." -#: src/bare-metal/aps/better-uart.md -msgid "FR" -msgstr "FR" +#: src/bare-metal/microcontrollers/debugging.md +#, fuzzy +msgid "_Embed.toml_:" +msgstr "Embed.toml:" -#: src/bare-metal/aps/better-uart.md -msgid "9" -msgstr "9" +#: src/bare-metal/microcontrollers/debugging.md +msgid "In one terminal under `src/bare-metal/microcontrollers/examples/`:" +msgstr "En un terminal en `src/bare-metal/microcontrollers/examples/`:" -#: src/bare-metal/aps/better-uart.md -msgid "0x20" -msgstr "0x20" +#: src/bare-metal/microcontrollers/debugging.md +msgid "In another terminal in the same directory:" +msgstr "En otro terminal del mismo directorio:" -#: src/bare-metal/aps/better-uart.md -msgid "ILPR" -msgstr "ILPR" +#: src/bare-metal/microcontrollers/debugging.md +msgid "On gLinux or Debian:" +msgstr "En gLinux o Debian:" -#: src/bare-metal/aps/better-uart.md -msgid "0x24" -msgstr "0x24" +#: src/bare-metal/microcontrollers/debugging.md +msgid "In GDB, try running:" +msgstr "En GDB, prueba a ejecutar:" -#: src/bare-metal/aps/better-uart.md -msgid "IBRD" -msgstr "IBRD" +#: src/bare-metal/microcontrollers/other-projects.md +#: src/bare-metal/aps/other-projects.md +msgid "Other projects" +msgstr "Otros proyectos" -#: src/bare-metal/aps/better-uart.md -msgid "16" -msgstr "16" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "[RTIC](https://rtic.rs/)" +msgstr "[RTIC](https://rtic.rs/)" -#: src/bare-metal/aps/better-uart.md -msgid "0x28" -msgstr "0x28" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "\"Real-Time Interrupt-driven Concurrency\"" +msgstr "\"Concurrencia en tiempo real basada en interrupciones\"" -#: src/bare-metal/aps/better-uart.md -msgid "FBRD" -msgstr "FBRD" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"Shared resource management, message passing, task scheduling, timer queue" +msgstr "" +"Gestión de recursos compartidos, envío de mensajes, programación de tareas, " +"cola del temporizador, etc." -#: src/bare-metal/aps/better-uart.md -msgid "0x2c" -msgstr "0x2c" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "[Embassy](https://embassy.dev/)" +msgstr "[Embassy](https://embassy.dev/)" -#: src/bare-metal/aps/better-uart.md -msgid "LCR_H" -msgstr "LCR_H" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "`async` executors with priorities, timers, networking, USB" +msgstr "Ejecutores `async` con prioridades, temporizadores, redes, USB, etc." -#: src/bare-metal/aps/better-uart.md -msgid "0x30" -msgstr "0x30" +#: 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/aps/better-uart.md -msgid "CR" -msgstr "CR" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"Security-focused RTOS with preemptive scheduling and Memory Protection Unit " +"support" +msgstr "" +"RTOS centrado en la seguridad con programación interrumpible y " +"compatibilidad con la unidad de protección de memoria." -#: src/bare-metal/aps/better-uart.md -msgid "0x34" -msgstr "0x34" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "[Hubris](https://hubris.oxide.computer/)" +msgstr "[Hubris](https://hubris.oxide.computer/)" -#: src/bare-metal/aps/better-uart.md -msgid "IFLS" -msgstr "IFLS" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"Microkernel RTOS from Oxide Computer Company with memory protection, " +"unprivileged drivers, IPC" +msgstr "" +"RTOS de microkernel de Oxide Computer Company con protección de memoria, " +"controladores sin privilegios, IPC, etc." -#: src/bare-metal/aps/better-uart.md -msgid "0x38" -msgstr "0x38" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "[Bindings for FreeRTOS](https://github.com/lobaro/FreeRTOS-rust)" +msgstr "[Enlaces para FreeRTOS](https://github.com/lobaro/FreeRTOS-rust)" -#: src/bare-metal/aps/better-uart.md -msgid "IMSC" -msgstr "IMSC" +#: 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 "" +"Algunas plataformas tienen implementaciones `std`, como [esp-idf](https://" +"esp-rs.github.io/book/overview/using-the-standard-library.html)." -#: src/bare-metal/aps/better-uart.md -msgid "11" -msgstr "11" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "RTIC can be considered either an RTOS or a concurrency framework." +msgstr "RTIC se puede considerar un RTOS o un framework de concurrencia." -#: src/bare-metal/aps/better-uart.md -msgid "0x3c" -msgstr "0x3c" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "It doesn't include any HALs." +msgstr "No incluye ningún HAL." -#: src/bare-metal/aps/better-uart.md -msgid "RIS" -msgstr "RIS" +#: 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 "" +"Usa el NVIC (controlador de interrupción virtual anidado) Cortex‐M para la " +"programación en lugar de un kernel propio." -#: src/bare-metal/aps/better-uart.md -msgid "0x40" -msgstr "0x40" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "Cortex-M only." +msgstr "Solo Cortex-M." -#: src/bare-metal/aps/better-uart.md -msgid "MIS" -msgstr "MIS" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"Google uses TockOS on the Haven microcontroller for Titan security keys." +msgstr "" +"Google utiliza TockOS en el microcontrolador Haven para las llaves de " +"seguridad Titan." -#: src/bare-metal/aps/better-uart.md -msgid "0x44" -msgstr "0x44" +#: src/bare-metal/microcontrollers/other-projects.md +msgid "" +"FreeRTOS is mostly written in C, but there are Rust bindings for writing " +"applications." +msgstr "" +"FreeRTOS está escrito principalmente en C, pero hay enlaces de Rust para " +"aplicaciones de escritura." -#: src/bare-metal/aps/better-uart.md -msgid "ICR" -msgstr "ICR" +#: 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 "" +"Leeremos la dirección desde una brújula I2C, y registraremos las lecturas en " +"un puerto serie." -#: src/bare-metal/aps/better-uart.md -msgid "0x48" -msgstr "0x48" +#: src/exercises/bare-metal/morning.md +msgid "" +"After looking at the exercises, you can look at the [solutions](solutions-" +"morning.md) provided." +msgstr "" +"Después de realizar los ejercicios, puedes consultar las [soluciones]" +"(solutions-morning.md) correspondientes." -#: src/bare-metal/aps/better-uart.md -msgid "DMACR" -msgstr "DMACR" +#: 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 "" +"Leeremos la dirección desde una brújula I2C, y registraremos las lecturas en " +"un puerto serie. Si tienes tiempo, prueba a mostrarlo también en los LED o " +"usa los botones de alguna forma." -#: src/bare-metal/aps/better-uart.md -msgid "There are also some ID registers which have been omitted for brevity." -msgstr "También hay algunos registros de ID que se han omitido para abreviar." +#: src/exercises/bare-metal/compass.md +msgid "Hints:" +msgstr "Sugerencias:" -#: src/bare-metal/aps/better-uart/bitflags.md +#: src/exercises/bare-metal/compass.md msgid "" -"The [`bitflags`](https://crates.io/crates/bitflags) crate is useful for " -"working with bitflags." +"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 "" -"El crate [`bitflags`](https://crates.io/crates/bitflags) resulta útil para " -"trabajar con bitflags." - -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Flags from the UART flag register.\n" -msgstr "/// Marcas del registro de marcas de UART.\n" +"Consulta la documentación sobre los crates [`lsm303agr`](https://docs.rs/" +"lsm303agr/latest/lsm303agr/) y [`microbit-v2`](https://docs.rs/microbit-v2/" +"latest/microbit/), así como [el hardware de micro:bit](https://tech.microbit." +"org/hardware/)." -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Clear to send.\n" -msgstr "/// Borra para enviar.\n" - -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Data set ready.\n" -msgstr "/// Conjunto de datos listo.\n" - -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Data carrier detect.\n" -msgstr "/// Detección del portador de datos.\n" - -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// UART busy transmitting data.\n" -msgstr "/// UART está transmitiendo datos.\n" - -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Receive FIFO is empty.\n" -msgstr "/// El FIFO de recepción está vacío\n" - -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Transmit FIFO is full.\n" -msgstr "/// El FIFO de transmisión está completo.\n" - -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Receive FIFO is full.\n" -msgstr "/// El FIFO de recepción está completo.\n" - -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Transmit FIFO is empty.\n" -msgstr "/// El FIFO de transmisión está vacío.\n" - -#: src/bare-metal/aps/better-uart/bitflags.md src/exercises/bare-metal/rtc.md -msgid "/// Ring indicator.\n" -msgstr "/// Indicador de anillo.\n" - -#: src/bare-metal/aps/better-uart/bitflags.md +#: src/exercises/bare-metal/compass.md msgid "" -"The `bitflags!` macro creates a newtype something like `Flags(u16)`, along " -"with a bunch of method implementations to get and set flags." +"The LSM303AGR Inertial Measurement Unit is connected to the internal I2C bus." msgstr "" -"La macro `bitflags!` crea un newtype, como `Flags(u16)`, junto con un montón " -"de implementaciones de métodos para obtener y definir _flags_ (banderas)." - -#: src/bare-metal/aps/better-uart/registers.md -msgid "Multiple registers" -msgstr "Varios registros" +"La unidad de medición inercial LSM303AGR está conectada al bus I2C interno." -#: src/bare-metal/aps/better-uart/registers.md +#: src/exercises/bare-metal/compass.md msgid "" -"We can use a struct to represent the memory layout of the UART's registers." +"TWI is another name for I2C, so the I2C master peripheral is called TWIM." msgstr "" -"Podemos utilizar una estructura para representar la disposición de la " -"memoria de los registros de UART." +"TWI es otro nombre para I2C, por lo que el periférico I2C maestro se llama " +"TWIM." -#: src/bare-metal/aps/better-uart/registers.md +#: src/exercises/bare-metal/compass.md +#, fuzzy 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." +"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 "" -"[`#[repr(C)]`](https://doc.rust-lang.org/reference/type-layout.html#the-c-" -"representation) indica al compilador que ordene los campos de la estructura " -"siguiendo las mismas reglas que en C. Esto es necesario para que nuestra " -"estructura tenga un diseño predecible, ya que la representación " -"predeterminada de Rust permite que el compilador (entre otras cosas) " -"reordene los campos como crea conveniente." +"El controlador LSM303AGR necesita algo que implemente el trait " +"`embedded_hal::blocking::i2c::WriteRead`. La estructura [`microbit::hal::" +"Twim`](https://docs.rs/microbit-v2/latest/microbit/hal/struct.Twim.html) " +"implementa esto." -#: src/bare-metal/aps/better-uart/driver.md -msgid "Now let's use the new `Registers` struct in our driver." +#: 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 "" -"Ahora vamos a utilizar la nueva estructura de `Registers` en nuestro " -"controlador." - -#: src/bare-metal/aps/better-uart/driver.md -msgid "/// Driver for a PL011 UART.\n" -msgstr "/// Controlador para un UART PL011.\n" +"Tienes una estructura [`microbit::Board`](https://docs.rs/microbit-v2/latest/" +"microbit/struct.Board.html) con campos para los distintos pines y " +"periféricos." -#: src/bare-metal/aps/better-uart/driver.md src/exercises/bare-metal/rtc.md +#: src/exercises/bare-metal/compass.md msgid "" -"// Safe because we know that self.registers points to the control\n" -" // registers of a PL011 device which is appropriately mapped.\n" +"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 "" -"// Es seguro porque sabemos que self.registers apunta\n" -" // a los registros de control de un dispositivo PL011 que está " -"asignado correctamente.\n" +"También puedes consultar la \\[hoja de datos nRF52833\\][nRF52833 datasheet]" +"(https://infocenter.nordicsemi.com/pdf/nRF52833_PS_v1.5.pdf) si quieres, " +"pero no debería ser necesario para este ejercicio." -#: src/bare-metal/aps/better-uart/driver.md src/exercises/bare-metal/rtc.md +#: src/exercises/bare-metal/compass.md msgid "" -"/// Reads and returns a pending byte, or `None` if nothing has been\n" -" /// received.\n" +"Download the [exercise template](../../comprehensive-rust-exercises.zip) and " +"look in the `compass` directory for the following files." msgstr "" -"/// Lee y devuelve un byte pendiente o `None` si no se ha recibido nada\n" -" ///.\n" +"Descarga la [plantilla de ejercicio](../../comprehensive-rust-exercises.zip) " +"y busca los siguientes archivos en el directorio `compass`." -#: 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 "// TAREA: Comprueba si hay condiciones de error en los bits 8 a 11.\n" +#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md +#, fuzzy +msgid "_src/main.rs_:" +msgstr "`src/main.rs`:" -#: 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 "" -"Fíjate en el uso de `addr_of!` y `addr_of_mut!` para llevar punteros a " -"campos individuales sin crear una referencia intermedia. Sería una acción " -"insegura." +#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md +#, fuzzy +msgid "_Cargo.toml_ (you shouldn't need to change this):" +msgstr "`Cargo.toml` (no debería ser necesario cambiarlo):" -#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md -msgid "Using it" -msgstr "Uso" +#: src/exercises/bare-metal/compass.md +#, fuzzy +msgid "_Embed.toml_ (you shouldn't need to change this):" +msgstr "`Embed.toml` (no debería ser necesario cambiarlo):" -#: 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 "" -"Vamos a crear un pequeño programa con nuestro controlador para escribir en " -"la consola serie y compartir los bytes entrantes." +#: src/exercises/bare-metal/compass.md src/exercises/bare-metal/rtc.md +#, fuzzy +msgid "_.cargo/config.toml_ (you shouldn't need to change this):" +msgstr "`.cargo/config.toml` (no debería ser necesario cambiarlo):" -#: 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 "/// Dirección base del UART de PL011 principal.\n" +#: src/exercises/bare-metal/compass.md +msgid "See the serial output on Linux with:" +msgstr "Consulta la salida de serie en Linux con:" -#: 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/exercises/bare-metal/compass.md msgid "" -"// Safe because `PL011_BASE_ADDRESS` is the base address of a PL011 device,\n" -" // and nothing else accesses that address range.\n" +"Or on Mac OS something like (the device name may be slightly different):" msgstr "" -"// Es seguro porque `PL011_BASE_ADDRESS` es la dirección base de un " -"dispositivo PL011\n" -" // y ninguna más accede a ese intervalo de direcciones.\n" +"En Mac OS debería ser algo como lo siguiente (el nombre del dispositivo " +"puede ser algo diferente):" -#: 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/exercises/bare-metal/compass.md +msgid "Use Ctrl+A Ctrl+Q to quit picocom." +msgstr "Pulsa Ctrl+A Ctrl+Q para salir de Picocom." -#: src/bare-metal/aps/better-uart/using.md -msgid "b'\\r'" -msgstr "b'\\r'" +#: src/exercises/bare-metal/solutions-morning.md +msgid "Bare Metal Rust Morning Exercise" +msgstr "Rust Bare Metal: Ejercicio de la Mañana" -#: src/bare-metal/aps/better-uart/using.md src/async/pitfalls/cancellation.md -msgid "b'\\n'" -msgstr "b'\\n'" +#: src/exercises/bare-metal/solutions-morning.md +msgid "([back to exercise](compass.md))" +msgstr "([volver al ejercicio](compass.md))" -#: src/bare-metal/aps/better-uart/using.md -msgid "b'q'" -msgstr "b'q'" +#: src/exercises/bare-metal/solutions-morning.md +msgid "// Configure serial port.\n" +msgstr "// Configura el puerto serie.\n" -#: src/bare-metal/aps/better-uart/using.md -msgid "\"Bye!\"" -msgstr "\"¡Adiós!\"" +#: src/exercises/bare-metal/solutions-morning.md +msgid "// Use the system timer as a delay provider.\n" +msgstr "// Usa el temporizador del sistema como proveedor de retrasos.\n" -#: 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 "" -"Al igual que en el ejemplo de [ensamblaje integrado](../inline-assembly.md), " -"esta función `main` se llama desde nuestro código de punto de entrada en " -"`entry.S`. Consulta las notas del orador para obtener más información." +#: src/exercises/bare-metal/solutions-morning.md +msgid "// Set up the I2C controller and Inertial Measurement Unit.\n" +msgstr "// Configura el controlador de I2C y la unidad de medición inercial.\n" -#: src/bare-metal/aps/better-uart/using.md -msgid "" -"Run the example in QEMU with `make qemu` under `src/bare-metal/aps/examples`." -msgstr "" -"Ejecuta el ejemplo en QEMU con `make qemu` en `src/bare-metal/aps/examples`." +#: src/exercises/bare-metal/solutions-morning.md +msgid "\"Setting up IMU...\"" +msgstr "\"Configurando IMU...\"" -#: 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 "" -"Estaría bien poder utilizar las macros de registro del crate [`log`](https://" -"crates.io/crates/log). Podemos hacerlo implementando el trait `Log`." +#: src/exercises/bare-metal/solutions-morning.md +msgid "// Set up display and timer.\n" +msgstr "// Configura la pantalla y el temporizador.\n" -#: src/bare-metal/aps/logging.md src/exercises/bare-metal/rtc.md -msgid "\"[{}] {}\"" -msgstr "\"[{}] {}\"" +#: src/exercises/bare-metal/solutions-morning.md +msgid "\"Ready.\"" +msgstr "\"Listo.\"" -#: src/bare-metal/aps/logging.md src/exercises/bare-metal/rtc.md -msgid "/// Initialises UART logger.\n" -msgstr "/// Inicia el registro de UART.\n" +#: src/exercises/bare-metal/solutions-morning.md +msgid "// Read compass data and log it to the serial port.\n" +msgstr "// Lee los datos de la brújula y regístralos en el puerto serie.\n" -#: src/bare-metal/aps/logging.md +#: src/exercises/bare-metal/solutions-morning.md +msgid "\"{},{},{}\\t{},{},{}\"" +msgstr "\"{},{},{}\\t{},{},{}\"" + +#: src/exercises/bare-metal/solutions-morning.md msgid "" -"The unwrap in `log` is safe because we initialise `LOGGER` before calling " -"`set_logger`." +"// If button A is pressed, switch to the next mode and briefly blink all " +"LEDs\n" +" // on.\n" msgstr "" -"La desenvoltura en `log` es segura porque inicializamos `LOGGER` antes de " -"llamar a `set_logger`." - -#: src/bare-metal/aps/logging/using.md -msgid "We need to initialise the logger before we use it." -msgstr "Debemos inicializar el registrador antes de utilizarlo." - -#: src/bare-metal/aps/logging/using.md src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "\"{info}\"" -msgstr "\"{info}\"" +"// Si se pulsa el botón A, cambia al siguiente modo y haz que parpadeen " +"brevemente todos los LED\n" +" // activados.\n" -#: src/bare-metal/aps/logging/using.md -msgid "Note that our panic handler can now log details of panics." -msgstr "" -"Ten en cuenta que nuestro controlador de _panic_ ahora ya puede registrar la " -"información de los pánicos." +#: src/bare-metal/aps.md +msgid "Application processors" +msgstr "Procesadores de aplicaciones" -#: src/bare-metal/aps/logging/using.md +#: src/bare-metal/aps.md msgid "" -"Run the example in QEMU with `make qemu_logger` under `src/bare-metal/aps/" -"examples`." +"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 "" -"Ejecuta el ejemplo en QEMU con `make qemu_logger` en `src/bare-metal/aps/" -"examples`." +"Hasta ahora hemos hablado de microcontroladores, como la serie Cortex‐M de " +"Arm. Ahora vamos a probar a escribir algo para Cortex-A. Para simplificar, " +"solo trabajaremos con la placa ['virt'](https://qemu-project.gitlab.io/qemu/" +"system/arm/virt.html) aarch64 de QEMU." -#: src/bare-metal/aps/exceptions.md +#: src/bare-metal/aps.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:" +"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 "" -"AArch64 define una tabla de vectores de excepción con 16 entradas, para 4 " -"tipos de excepciones (synchronous, IRQ, FIQ, SError) desde 4 estados (EL " -"actual con SP0, EL actual con SPx, EL inferior con AArch64 y EL inferior con " -"AArch32). Implementamos esto en el ensamblaje para guardar los registros " -"volátiles en la _stack_ antes de llamar al código de Rust:" +"En términos generales, los microcontroladores no tienen un MMU ni varios " +"niveles de privilegio (niveles de excepción en las CPU de Arm, anillos en " +"x86), mientras que los procesadores de aplicaciones sí los tienen." -#: src/bare-metal/aps/exceptions.md -msgid "EL is exception level; all our examples this afternoon run in EL1." +#: 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 "" -"EL significa nivel de excepción (por sus siglas en inglés); todos nuestros " -"ejemplos de esta tarde se ejecutan en EL1." +"QEMU permite emular varias máquinas o modelos de placa diferentes para cada " +"arquitectura. La placa \"virt\" no se corresponde con ningún hardware real " +"concreto, pero está diseñada exclusivamente para máquinas virtuales." -#: src/bare-metal/aps/exceptions.md +#: src/bare-metal/aps/entry-point.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." +"Before we can start running Rust code, we need to do some initialisation." msgstr "" -"Para simplificar, no distinguimos entre SP0 y SPx para las excepciones del " -"EL actual, ni entre AArch32 y AArch64 para las excepciones de EL inferiores." +"Antes de que podamos empezar a ejecutar código de Rust, tenemos que hacer " +"alguna inicialización." -#: src/bare-metal/aps/exceptions.md +#: src/bare-metal/aps/entry-point.md msgid "" -"For this example we just log the exception and power down, as we don't " -"expect any of them to actually happen." +"```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 "" -"En este ejemplo, nos limitaremos a registrar la excepción y a apagarla, ya " -"que no esperamos que se produzca ninguna." +"```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" +"```" -#: src/bare-metal/aps/exceptions.md +#: src/bare-metal/aps/entry-point.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." +"This is the same as it would be for C: initialising the processor state, " +"zeroing the BSS, and setting up the stack pointer." msgstr "" -"Podríamos pensar en los controladores de excepciones y en nuestro contexto " -"de ejecución principal como si fueran hilos diferentes. [`Send` y `Sync`]" -"(../../concurrency/send-sync.md) controlarán lo que podemos compartir entre " -"ellos, igual que con los hilos. Por ejemplo, si queremos compartir algún " -"valor entre los controladores de excepciones y el resto del programa, y es " -"`Send`en vez de `Sync`, necesitaremos envolverlo en un `Mutex`, por ejemplo, " -"y ponerlo en un estático." - -#: 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 "\"coreboot sin la C\"." - -#: src/bare-metal/aps/other-projects.md -msgid "Supports x86, aarch64 and RISC-V." -msgstr "Compatible con x86, aarch64 y RISC-V." - -#: src/bare-metal/aps/other-projects.md -msgid "Relies on LinuxBoot rather than having many drivers itself." -msgstr "Depende de LinuxBoot en lugar de tener controladores propios." +"Es lo mismo que en C: inicializar el estado del procesador, poner a cero el " +"BSS y configurar el puntero de la _stack_." -#: src/bare-metal/aps/other-projects.md +#: src/bare-metal/aps/entry-point.md msgid "" -"[Rust RaspberryPi OS tutorial](https://github.com/rust-embedded/rust-" -"raspberrypi-OS-tutorials)" +"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 "" -"[Tutorial del SO de Rust en RaspberryPi][Rust RaspberryPi OS tutorial]" -"(https://github.com/rust-embedded/rust-raspberrypi-OS-tutorials)" +"El BSS (símbolo de inicio del bloque, por motivos históricos) es la parte " +"del objeto que contiene variables asignadas de forma estática que se " +"inicializan a cero. Se omiten en la imagen para evitar malgastar espacio con " +"ceros. El compilador asume que el cargador se encargará de ponerlos a cero." -#: src/bare-metal/aps/other-projects.md +#: src/bare-metal/aps/entry-point.md msgid "" -"Initialisation, UART driver, simple bootloader, JTAG, exception levels, " -"exception handling, page tables" -msgstr "" -"Inicialización, controlador de UART, bootloader sencillo, JTAG, niveles de " -"excepción, gestión de excepciones, tablas de páginas, etc." - -#: 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." +"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 "" -"Algunas dudas sobre el mantenimiento de la caché y la inicialización en " -"Rust, aunque no es precisamente un buen ejemplo para copiar en código de " -"producción." - -#: 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 "Análisis estático para determinar el uso máximo de la _stack_." +"Es posible que el BSS ya esté a cero, dependiendo de cómo se inicialice la " +"memoria y cómo se cargue la imagen, aunque se pone igualmente a cero para " +"estar seguros." -#: src/bare-metal/aps/other-projects.md +#: src/bare-metal/aps/entry-point.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:" +"We need to enable the MMU and cache before reading or writing any memory. If " +"we don't:" msgstr "" -"El tutorial del sistema operativo en RaspberryPi ejecuta código de Rust " -"antes de que la MMU y las cachés se habiliten. De este modo, se leerá y " -"escribirá memoria (por ejemplo, la _stack_). Sin embargo:" +"Necesitamos habilitar la MMU y la caché antes de leer o escribir memoria. Si " +"no lo hacemos, sucederá lo siguiente:" -#: src/bare-metal/aps/other-projects.md +#: src/bare-metal/aps/entry-point.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." +"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 "" -"Sin la MMU y la caché, los accesos no alineados fallarán. Se compila con " -"`aarch64-unknown-none`, que define `+strict-align` para evitar que el " -"compilador genere accesos no alineados. Debería estar bien, pero no tiene " -"por qué ser así, en general." +"Los accesos no alineados fallarán. Compilamos el código Rust para el " +"objetivo `aarch64-unknown-none`, que define `+strict-align` para evitar que " +"el compilador genere accesos no alineados. En este caso debería estar bien, " +"pero no tiene por qué ser así en general." -#: src/bare-metal/aps/other-projects.md +#: 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. Again this is " -"alright in this particular case (running directly on the hardware with no " -"hypervisor), but isn't a good pattern in general." +"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 "" "Si se estuviera ejecutando en una máquina virtual, podría provocar problemas " "de coherencia en la caché. El problema es que la máquina virtual accede a la " @@ -19689,5290 +19058,7670 @@ msgstr "" "con alias que se pueden almacenar en caché en la misma memoria. Incluso si " "el host no accede explícitamente a la memoria, los accesos especulativos " "pueden provocar que se llene la caché, haciendo que los cambios de uno u " -"otro se pierdan. De nuevo, es correcto en este caso particular (si se " -"ejecuta directamente en el hardware sin hipervisor) pero, por lo general, no " -"es un buen patrón." - -#: src/bare-metal/useful-crates.md -msgid "Useful crates" -msgstr "Crates Útiles" +"otro se pierdan cuando se borre la caché o cuando la máquina virtual la " +"habilite. (La caché está codificada por dirección física, no por VA ni IPA)." -#: src/bare-metal/useful-crates.md +#: src/bare-metal/aps/entry-point.md msgid "" -"We'll go over a few crates which solve some common problems in bare-metal " -"programming." +"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 "" -"A continuación, repasaremos algunos crates que resuelven ciertos problemas " -"comunes en la programación bare-metal." +"Para simplificar, solo se utiliza una tabla de páginas codificada (consulta " +"`idmap.S`) que mapea la identidad del primer GiB de espacio de direcciones " +"para dispositivos, el siguiente GiB para DRAM y otro GiB más para más " +"dispositivos. Esto coincide con la disposición de memoria que utiliza QEMU." -#: src/bare-metal/useful-crates/zerocopy.md +#: src/bare-metal/aps/entry-point.md msgid "" -"The [`zerocopy`](https://docs.rs/zerocopy/) crate (from Fuchsia) provides " -"traits and macros for safely converting between byte sequences and other " -"types." +"We also set up the exception vector (`vbar_el1`), which we'll see more about " +"later." msgstr "" -"El crate [`zerocopy`](https://docs.rs/zerocopy/) (de Fuchsia) proporciona " -"traits y macros para realizar conversiones seguras entre secuencias de bytes " -"y otros tipos." +"También configuramos el vector de excepción (`vbar_el1`), del que veremos " +"más contenido en próximas dipositivas." -#: src/bare-metal/useful-crates/zerocopy.md +#: src/bare-metal/aps/entry-point.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." +"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 "" -"No es adecuado para MMIO (ya que no utiliza lecturas y escrituras " -"volátiles), pero puede ser útil para trabajar con estructuras compartidas " -"con hardware (por ejemplo, mediante DMA) o enviadas a través de alguna " -"interfaz externa." +"Todos los ejemplos de esta tarde se ejecutarán en el nivel de excepción 1 " +"(EL1). Si necesitas ejecutar en un nivel de excepción diferente, deberás " +"modificar `entry.S` según corresponda." -#: 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` se puede implementar en tipos en los que cualquier patrón de " -"bytes es válido, por lo que se puede convertir de forma segura a partir de " -"una secuencia de bytes que no es fiable." +#: src/bare-metal/aps/inline-assembly.md +msgid "Inline assembly" +msgstr "Ensamblaje integrado" -#: src/bare-metal/useful-crates/zerocopy.md +#: src/bare-metal/aps/inline-assembly.md +#, fuzzy 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." +"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 "" -"Si se intenta derivar `FromBytes` para estos tipos, se produciría un error, " -"pues `RequestType` no utiliza todos los valores u32 posibles como " -"discriminantes y, por tanto, todos los patrones de bytes son válidos." +"A veces necesitamos usar el ensamblador para hacer cosas que no son posibles " +"con código Rust. Por ejemplo, hacer un " -#: src/bare-metal/useful-crates/zerocopy.md +#: src/bare-metal/aps/inline-assembly.md +#, fuzzy msgid "" -"`zerocopy::byteorder` has types for byte-order aware numeric primitives." +"// SAFETY: this only uses the declared registers and doesn't do anything\n" +" // with memory.\n" msgstr "" -"`zerocopy::byteorder` tiene tipos para primitivos numéricos conscientes del " -"orden de bytes." +"// Es seguro porque solo utiliza los registros declarados y no\n" +" // hace nada con la memoria.\n" -#: 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 "" -"Ejecuta el ejemplo con `cargo run` en `src/bare-metal/useful-crates/zerocopy-" -"example/`. (No se ejecutará en el playground debido a la dependencia del " -"crate)." +#: src/bare-metal/aps/inline-assembly.md +msgid "\"hvc #0\"" +msgstr "\"hvc #0\"" -#: 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 "" -"El crate [`aarch64-paging`](https://crates.io/crates/aarch64-paging) permite " -"crear tablas de páginas de acuerdo con la arquitectura del sistema de " -"memoria virtual AArch64." +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w0\"" +msgstr "\"w0\"" -#: src/bare-metal/useful-crates/aarch64-paging.md -msgid "// Create a new page table with identity mapping.\n" -msgstr "// Crea una tabla de páginas con mapeado de identidades.\n" +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w1\"" +msgstr "\"w1\"" -#: src/bare-metal/useful-crates/aarch64-paging.md -msgid "// Map a 2 MiB region of memory as read-only.\n" -msgstr "// Asigna una región de 2 MiB de memoria como de solo lectura.\n" +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w2\"" +msgstr "\"w2\"" -#: src/bare-metal/useful-crates/aarch64-paging.md -msgid "// Set `TTBR0_EL1` to activate the page table.\n" -msgstr "// Configura `TTBR0_EL1` para activar la tabla de páginas.\n" +#: src/bare-metal/aps/inline-assembly.md +msgid "\"w3\"" +msgstr "\"w3\"" -#: src/bare-metal/useful-crates/aarch64-paging.md +#: 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 "" -"For now it only supports EL1, but support for other exception levels should " -"be straightforward to add." +"(If you actually want to do this, use the [`smccc`](https://crates.io/crates/" +"smccc) crate which has wrappers for all these functions.)" msgstr "" -"Por ahora, solo es compatible con EL1, pero debería ser sencillo añadir " -"compatibilidad con otros niveles de excepción." +"(Si realmente quieres hacer esto, utiliza el crate [`smccc`](https://crates." +"io/crates/smccc) que tiene envoltorios para todas estas funciones)." -#: src/bare-metal/useful-crates/aarch64-paging.md +#: src/bare-metal/aps/inline-assembly.md msgid "" -"This is used in Android for the [Protected VM Firmware](https://cs.android." -"com/android/platform/superproject/+/master:packages/modules/Virtualization/" -"pvmfw/)." +"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 "" -"Se utiliza en Android para el [Firmware de Máquina Virtual Protegida]" -"(https://cs.android.com/android/platform/superproject/+/master:packages/" -"modules/Virtualization/pvmfw/)." +"PSCI es la interfaz de coordinación de estado de alimentación de Arm, un " +"conjunto estándar de funciones para gestionar los estados de alimentación " +"del sistema y de la CPU, entre otras cosas. Lo implementan el firmware EL3 y " +"los hipervisores en muchos sistemas." -#: src/bare-metal/useful-crates/aarch64-paging.md +#: src/bare-metal/aps/inline-assembly.md msgid "" -"There's no easy way to run this example, as it needs to run on real hardware " -"or under QEMU." +"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 "" -"No hay una forma sencilla de ejecutar este ejemplo, ya que debe hacerse en " -"hardware real o en QEMU." +"La sintaxis `0 => _` significa inicializar el registro a 0 antes de ejecutar " +"el código de ensamblaje integrado e ignorar su contenido después. " +"Necesitamos utilizar `inout` en lugar de `in` porque la llamada podría " +"alterar el contenido de los registros." -#: src/bare-metal/useful-crates/buddy_system_allocator.md +#: src/bare-metal/aps/inline-assembly.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:" +"This `main` function needs to be `#[no_mangle]` and `extern \"C\"` because " +"it is called from our entry point in `entry.S`." msgstr "" -"[`buddy_system_allocator`](https://crates.io/crates/buddy_system_allocator) " -"es un crate de terceros que implementa un asignador básico del sistema " -"buddy. Se puede utilizar tanto para [`LockedHeap`](https://docs.rs/" -"buddy_system_allocator/0.9.0/buddy_system_allocator/struct.LockedHeap.html) " -"implementando [`GlobalAlloc`](https://doc.rust-lang.org/core/alloc/trait." -"GlobalAlloc.html), de forma que puedas usar el crate `alloc` estándar (tal y " -"como vimos [antes](../alloc.md)), o para asignar otro espacio de " -"direcciones. Por ejemplo, podríamos querer asignar espacio MMIO para los " -"registros de dirección base (BAR) de PCI:" - -#: src/bare-metal/useful-crates/buddy_system_allocator.md -msgid "PCI BARs always have alignment equal to their size." -msgstr "Los BAR de PCI siempre tienen una alineación igual a su tamaño." +"Esta función `main` debe ser `#[no_mangle]` y `extern \"C\"`, ya que se " +"llama desde nuestro punto de entrada en `entry.S`." -#: src/bare-metal/useful-crates/buddy_system_allocator.md +#: src/bare-metal/aps/inline-assembly.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.)" +"`_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 "" -"Ejecuta el ejemplo con `cargo run` en `src/bare-metal/useful-crates/" -"allocator-example/`. (No se ejecutará en el playground debido a la " -"dependencia del crate)." +"`_x0`–`_x3` son los valores de los registros `x0`–`x3`, que el bootloader " +"utiliza habitualmente para pasar elementos al árbol de dispositivos, como un " +"puntero. De acuerdo con la convención de llamadas estándar de aarch64 (que " +"es lo que `extern \"C\"` usa), los registros `x0`–`x7` se utilizan para los " +"primeros ocho argumentos que se pasan a una función, de modo que `entry.S` " +"no tiene que hacer nada especial, salvo asegurarse de que no cambia estos " +"registros." -#: src/bare-metal/useful-crates/tinyvec.md +#: src/bare-metal/aps/inline-assembly.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." +"Run the example in QEMU with `make qemu_psci` under `src/bare-metal/aps/" +"examples`." msgstr "" -"A veces, se necesita algo que se pueda cambiar de tamaño, como `Vec`, pero " -"sin asignación de _heap_. [`tinyvec`](https://crates.io/crates/tinyvec) " -"ofrece un vector respaldado por un array o slice, que se podría asignar " -"estáticamente o en la _stack_, y que hace un seguimiento de cuántos " -"elementos se usan, entrando en _panic_ si intentas utilizar más elementos de " -"los asignados." +"Ejecuta el ejemplo en QEMU con `make qemu_psci` en `src/bare-metal/aps/" +"examples`." -#: src/bare-metal/useful-crates/tinyvec.md -msgid "" -"`tinyvec` requires that the element type implement `Default` for " -"initialisation." -msgstr "" -"`tinyvec` requiere que el tipo de elemento implemente `Default` para la " -"inicialización." +#: src/bare-metal/aps/mmio.md +msgid "Volatile memory access for MMIO" +msgstr "Acceso a la memoria volátil para MMIO" -#: src/bare-metal/useful-crates/tinyvec.md -msgid "" -"The Rust Playground includes `tinyvec`, so this example will run fine inline." -msgstr "" -"El playground de Rust incluye `tinyvec`, por lo que este ejemplo se " -"ejecutará bien aunque esté insertado." +#: src/bare-metal/aps/mmio.md +msgid "Use `pointer::read_volatile` and `pointer::write_volatile`." +msgstr "Se puede usar `pointer::read_volatile` y `pointer::write_volatile`." -#: 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::Mutex` y el resto de los primitivos de sincronización de `std::" -"sync` no están disponibles en `core` o `alloc`. ¿Cómo podemos gestionar la " -"sincronización o la mutabilidad interior para, por ejemplo, compartir el " -"estado entre diferentes CPUs?" +#: src/bare-metal/aps/mmio.md +msgid "Never hold a reference." +msgstr "Nunca retengas una referencia." -#: src/bare-metal/useful-crates/spin.md +#: src/bare-metal/aps/mmio.md msgid "" -"The [`spin`](https://crates.io/crates/spin) crate provides spinlock-based " -"equivalents of many of these primitives." -msgstr "" -"El crate [`spin`](https://crates.io/crates/spin) proporciona equivalentes " -"basados en spinlocks de muchos de estos primitivos." - -#: src/bare-metal/useful-crates/spin.md -msgid "Be careful to avoid deadlock if you take locks in interrupt handlers." +"`addr_of!` lets you get fields of structs without creating an intermediate " +"reference." msgstr "" -"Intenta evitar interbloqueos si usas bloqueos en los controladores de las " -"interrupciones." +"`addr_of!` permite obtener campos de estructuras sin crear una referencia " +"intermedia." -#: src/bare-metal/useful-crates/spin.md -#, fuzzy +#: src/bare-metal/aps/mmio.md msgid "" -"`spin` also has a ticket lock mutex implementation; equivalents of `RwLock`, " -"`Barrier` and `Once` from `std::sync`; and `Lazy` for lazy initialisation." +"Volatile access: read or write operations may have side-effects, so prevent " +"the compiler or hardware from reordering, duplicating or eliding them." msgstr "" -"`spin` también cuenta con una implementación de exclusión mutua de bloqueo " -"de tickets; equivalentes de `RwLock`, `Barrier` y `Once` de `std::sync`, y " -"`Lazy` para inicialización perezosa" +"Acceso volátil: las operaciones de lectura o escritura pueden tener efectos " +"secundarios, por lo que se debe evitar que el compilador o el hardware las " +"reordene, duplique u omita." -#: src/bare-metal/useful-crates/spin.md +#: src/bare-metal/aps/mmio.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`." +"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 "" -"El crate [`once_cell`](https://crates.io/crates/once_cell) también tiene " -"algunos tipos útiles de inicialización tardía con un enfoque ligeramente " -"distinto al de `spin::once::Once`." +"Normalmente, si escribes y luego lees (por ejemplo, a través de una " +"referencia mutable), el compilador puede suponer que el valor leído es el " +"mismo que el que se acaba de escribir, sin molestarse si quiera en leer " +"realmente la memoria." -#: src/bare-metal/useful-crates/spin.md +#: src/bare-metal/aps/mmio.md msgid "" -"The Rust Playground includes `spin`, so this example will run fine inline." +"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 "" -"El playground de Rust incluye `spin`, por lo que este ejemplo se ejecutará " -"bien aunque está insertado." +"Algunos crates para el acceso volátil al hardware sí mantienen referencias, " +"aunque no es seguro. Siempre que exista una referencia, el compilador puede " +"desreferenciarla." -#: src/bare-metal/android.md +#: src/bare-metal/aps/mmio.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." +"Use the `addr_of!` macro to get struct field pointers from a pointer to the " +"struct." msgstr "" -"Para compilar un binario de Rust bare-metal en AOSP, tienes que usar una " -"regla `rust_ffi_static` de Soong para crear tu código Rust y, seguidamente, " -"un `cc_binary` con una secuencia de comandos de enlazador para producir el " -"binario en sí. Por último, un `raw_binary` para convertir el ELF en un " -"binario sin formato que pueda ejecutarse." +"Utiliza la macro `addr_of!` para obtener punteros de campos de estructuras a " +"partir de un puntero en la estructura." -#: src/bare-metal/android/vmbase.md -msgid "vmbase" -msgstr "vmbase" +#: src/bare-metal/aps/uart.md +msgid "Let's write a UART driver" +msgstr "Vamos a escribir un controlador de UART" -#: src/bare-metal/android/vmbase.md +#: src/bare-metal/aps/uart.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." +"The QEMU 'virt' machine has a [PL011](https://developer.arm.com/" +"documentation/ddi0183/g) UART, so let's write a driver for that." msgstr "" -"En el caso de las máquinas virtuales que se ejecutan con crosvm en aarch64, " -"la biblioteca [vmbase](https://android.googlesource.com/platform/packages/" -"modules/Virtualization/+/refs/heads/master/vmbase/) proporciona una " -"secuencia de comandos de enlazador y valores predeterminados útiles para las " -"reglas de compilación, además de un punto de entrada, registro de la consola " -"UART y mucho más." +"La máquina \"virt\" de QEMU tiene una UART [PL011]https://developer.arm.com/" +"documentation/ddi0183/g), así que vamos a escribir un controlador para ella." -#: src/bare-metal/android/vmbase.md -msgid "" -"The `main!` macro marks your main function, to be called from the `vmbase` " -"entry point." -msgstr "" -"La macro `main!` indica tu función principal, que se llama desde el punto de " -"entrada `vmbase`." +#: src/bare-metal/aps/uart.md +msgid "/// Minimal driver for a PL011 UART.\n" +msgstr "/// Controlador mínimo para un UART PL011.\n" -#: src/bare-metal/android/vmbase.md +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md msgid "" -"The `vmbase` entry point handles console initialisation, and issues a " -"PSCI_SYSTEM_OFF to shutdown the VM if your main function returns." +"/// 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 "" -"El punto de entrada `vmbase` gestiona la inicialización de la consola y " -"emite PSCI_SYSTEM_OFF para apagar la máquina virtual si tu función principal " -"devuelve un resultado." +"/// Construye una instancia nueva del controlador de UART para un " +"dispositivo PL011 en la\n" +" /// dirección base proporcionada.\n" +" ///\n" +" /// # Seguridad\n" +" ///\n" +" /// La dirección base debe apuntar a los 8 registros de control MMIO de " +"un \n" +" /// dispositivo PL011, que debe asignarse al espacio de direcciones del " +"proceso\n" +" /// como memoria del dispositivo y no tener ningún otro alias.\n" -#: src/exercises/bare-metal/afternoon.md -msgid "We will write a driver for the PL031 real-time clock device." -msgstr "" -"Escribiremos un controlador para el dispositivo de reloj en tiempo real " -"PL031." +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md +msgid "/// Writes a single byte to the UART.\n" +msgstr "/// Escribe un solo byte en el UART.\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 "// Espera hasta que haya espacio en el búfer de TX.\n" -#: src/exercises/bare-metal/afternoon.md src/exercises/concurrency/afternoon.md +#: src/bare-metal/aps/uart.md +#, fuzzy msgid "" -"After looking at the exercises, you can look at the [solutions](solutions-" -"afternoon.md) provided." +"// SAFETY: We know that the base address points to the control\n" +" // registers of a PL011 device which is appropriately mapped.\n" msgstr "" -"Luego de ver los ejercicios, puedes ver las [soluciones](solutions-afternoon." -"md) que se brindan." +"// Es seguro porque sabemos que la dirección base apunta a los registros\n" +" // de control de un dispositivo PL011 que está asignado " +"correctamente.\n" -#: src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "RTC driver" -msgstr "Controlador RTC" +#: src/bare-metal/aps/uart.md src/bare-metal/aps/better-uart/driver.md +msgid "// Write to the TX buffer.\n" +msgstr "// Escribe en el búfer de TX.\n" -#: 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 "" -"La máquina virtual aarch64 de QEMU tiene un reloj en tiempo real [PL031]" -"(https://developer.arm.com/documentation/ddi0224/c) en 0x9010000. En este " -"ejercicio, debes escribir un controlador para el reloj." +#: 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 "// Espera hasta que el UART esté libre.\n" -#: src/exercises/bare-metal/rtc.md +#: src/bare-metal/aps/uart.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." +"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 "" -"Úsalo para imprimir la hora en la consola serie. Puedes usar el crate " -"[`chrono`](https://crates.io/crates/chrono) para dar formato a la fecha y la " -"hora." +"Ten en cuenta que `Uart::new` no es seguro, mientras que los otros métodos " +"sí lo son. Esto se debe a que mientras que el llamador de `Uart::new` " +"asegure que se cumplan sus requisitos de seguridad (es decir, que solo haya " +"una instancia del controlador para una UART determinada y que nada más " +"asigne alias a su espacio de direcciones), siempre es más seguro llamar a " +"`write_byte` más adelante, ya que podemos asumir\\ las condiciones previas " +"necesarias." -#: src/exercises/bare-metal/rtc.md +#: src/bare-metal/aps/uart.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.)" +"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 "" -"Utiliza el registro de coincidencias y el estado de interrupción sin formato " -"para esperar hasta un momento dado, por ejemplo, un adelanto de 3 segundos. " -"(Llama a [`core::hint::spin_loop`](https://doc.rust-lang.org/core/hint/fn." -"spin_loop.html) dentro d+el bucle)." +"Podríamos haberlo hecho al revés (haciendo que `new` fuese seguro y " +"`write_byte` no seguro), pero\\sería mucho menos cómodo de usar, ya que cada " +"lugar que llamase a `write_byte` tendría que pensar en la seguridad" -#: src/exercises/bare-metal/rtc.md +#: src/bare-metal/aps/uart.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." +"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 "" -"_Ampliación si hay tiempo:_ habilita y gestiona la interrupción que genera " -"la coincidencia de RTC. Puedes usar el controlador que se proporciona con el " -"crate [`arm-gic`](https://docs.rs/arm-gic/) para configurar el controlador " -"de interrupciones genérico (GIC) de Arm." +"Este es un patrón común para escribir envoltorios seguros de código " +"inseguro: mover la carga de la prueba de seguridad de un gran número de " +"lugares a otro más pequeño." -#: src/exercises/bare-metal/rtc.md -msgid "Use the RTC interrupt, which is wired to the GIC as `IntId::spi(2)`." -msgstr "" -"Utiliza la interrupción de RTC, que está conectada al GIC como `IntId::" -"spi(2)`." +#: src/bare-metal/aps/uart/traits.md +msgid "More traits" +msgstr "Más traits" -#: src/exercises/bare-metal/rtc.md +#: src/bare-metal/aps/uart/traits.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." +"We derived the `Debug` trait. It would be useful to implement a few more " +"traits too." msgstr "" -"Después de habilitar la interrupción, puedes poner el núcleo en suspensión " -"mediante `arm_gic::wfi()`, lo que hará que entre en suspensión hasta que " -"reciba una interrupción." +"Hemos derivado el trait `Debug`. También sería útil implementar algunos " +"traits más." -#: src/exercises/bare-metal/rtc.md +#: src/bare-metal/aps/uart/traits.md +#, fuzzy msgid "" -"Download the [exercise template](../../comprehensive-rust-exercises.zip) and " -"look in the `rtc` directory for the following files." +"// SAFETY: `Uart` just contains a pointer to device memory, which can be\n" +"// accessed from any context.\n" msgstr "" -"Descarga la [plantilla de ejercicio](../../comprehensive-rust-exercises.zip) " -"y busca en el directorio `rtc` los siguientes archivos." - -#: src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Base addresses of the GICv3.\n" -msgstr "/// Direcciones base de GICv3.\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})\"" +"// Es seguro porque solo contiene un puntero a la memoria del dispositivo,\n" +"// a la que se puede acceder desde cualquier contexto.\n" -#: src/exercises/bare-metal/rtc.md -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/bare-metal/aps/uart/traits.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" +"Implementing `Write` lets us use the `write!` and `writeln!` macros with our " +"`Uart` type." msgstr "" -"// Es seguro porque `GICD_BASE_ADDRESS` y `GICR_BASE_ADDRESS` son las " -"direcciones base\n" -" // de un distribuidor y un redistribuidor GICv3 respectivamente,\n" -" // y ningún otro elemento tiene acceso a esos intervalos de " -"direcciones.\n" +"Implementar `Write` nos permite utilizar las macros `write!` y `writeln!` " +"con nuestro tipo `Uart`." -#: src/exercises/bare-metal/rtc.md -msgid "// TODO: Create instance of RTC driver and print current time.\n" +#: src/bare-metal/aps/uart/traits.md +msgid "" +"Run the example in QEMU with `make qemu_minimal` under `src/bare-metal/aps/" +"examples`." msgstr "" -"// TAREA: crear una instancia del controlador RTC e imprimir la hora " -"actual.\n" +"Ejecuta el ejemplo en QEMU con `make qemu_minimal` en `src/bare-metal/aps/" +"examples`." -#: src/exercises/bare-metal/rtc.md -msgid "// TODO: Wait for 3 seconds.\n" -msgstr "// TAREA: esperar 3 segundos.\n" +#: src/bare-metal/aps/better-uart.md +msgid "A better UART driver" +msgstr "Un controlador UART mejor" -#: src/exercises/bare-metal/rtc.md -#, fuzzy +#: src/bare-metal/aps/better-uart.md msgid "" -"_src/exceptions.rs_ (you should only need to change this for the 3rd part of " -"the exercise):" +"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 "" -"`src/exceptions.rs` (solo se debería cambiar esto en la tercera parte del " -"ejercicio):" - -#: src/exercises/bare-metal/rtc.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" -"// Con licencia Apache, versión 2.0 (la \"Licencia\");\n" -"// Este archivo solo se puede utilizar según lo estipulado en la Licencia.\n" -"// Puedes obtener una copia de la Licencia en\n" -"//\n" -"// http://www.apache.org/licenses/LICENSE-2.0\n" -"//\n" -"// Salvo que lo exija la legislación aplicable o se haya acordado por " -"escrito, el software\n" -"// distribuido bajo la Licencia se distribuye \"TAL CUAL\",\n" -"// SIN GARANTÍAS NI CONDICIONES DE NINGÚN TIPO, ya sean explícitas o " -"implícitas.\n" -"// Consulta la Licencia para saber los permisos y las limitaciones " -"aplicables a cada idioma\n" -"//.\n" +"En realidad, PL011 tiene [muchos registros más](https://developer.arm.com/" +"documentation/ddi0183/g/programmers-model/summary-of-registers), por lo que " +"añadir desplazamientos para crear punteros que les permita acceder a ellos " +"da lugar a errores y dificulta la lectura. Además, algunos de ellos son " +"campos de bits a los que estaría bien acceder de forma estructurada." -#: src/exercises/bare-metal/rtc.md -msgid "\"sync_exception_current\"" -msgstr "\"sync_exception_current\"" +#: src/bare-metal/aps/better-uart.md +msgid "Offset" +msgstr "Desplazamiento" -#: src/exercises/bare-metal/rtc.md -msgid "\"irq_current\"" -msgstr "\"irq_current\"" +#: src/bare-metal/aps/better-uart.md +msgid "Register name" +msgstr "Nombre de registro" -#: src/exercises/bare-metal/rtc.md -msgid "\"No pending interrupt\"" -msgstr "\"No hay interrupciones pendientes\"" +#: src/bare-metal/aps/better-uart.md +msgid "Width" +msgstr "Ancho" -#: src/exercises/bare-metal/rtc.md -msgid "\"IRQ {intid:?}\"" -msgstr "\"IRQ {intid:?}\"" +#: src/bare-metal/aps/better-uart.md +msgid "0x00" +msgstr "0x00" -#: src/exercises/bare-metal/rtc.md -msgid "\"fiq_current\"" -msgstr "\"fiq_current\"" +#: src/bare-metal/aps/better-uart.md +msgid "DR" +msgstr "DR" -#: src/exercises/bare-metal/rtc.md -msgid "\"serr_current\"" -msgstr "\"serr_current\"" +#: src/bare-metal/aps/better-uart.md +msgid "12" +msgstr "12" -#: src/exercises/bare-metal/rtc.md -msgid "\"sync_lower\"" -msgstr "\"sync_lower\"" +#: src/bare-metal/aps/better-uart.md +msgid "0x04" +msgstr "0x04" -#: src/exercises/bare-metal/rtc.md -msgid "\"irq_lower\"" -msgstr "\"irq_lower\"" +#: src/bare-metal/aps/better-uart.md +msgid "RSR" +msgstr "RSR" -#: src/exercises/bare-metal/rtc.md -msgid "\"fiq_lower\"" -msgstr "\"fiq_lower\"" +#: src/bare-metal/aps/better-uart.md +msgid "4" +msgstr "4" -#: src/exercises/bare-metal/rtc.md -msgid "\"serr_lower\"" -msgstr "\"serr_lower\"" +#: src/bare-metal/aps/better-uart.md +msgid "0x18" +msgstr "0x18" -#: src/exercises/bare-metal/rtc.md -msgid "_src/logger.rs_ (you shouldn't need to change this):" -msgstr "_src/logger.rs_ (no debería ser necesario cambiarlo):" +#: src/bare-metal/aps/better-uart.md +msgid "FR" +msgstr "FR" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR: main\n" -msgstr "// ANCHOR: main\n" +#: src/bare-metal/aps/better-uart.md +msgid "9" +msgstr "9" -#: src/exercises/bare-metal/rtc.md -msgid "_src/pl011.rs_ (you shouldn't need to change this):" -msgstr "_src/pl011.rs_ (no debería ser necesario cambiarlo):" +#: src/bare-metal/aps/better-uart.md +msgid "0x20" +msgstr "0x20" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR: Flags\n" -msgstr "// ANCHOR: Flags\n" +#: src/bare-metal/aps/better-uart.md +msgid "ILPR" +msgstr "ILPR" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR_END: Flags\n" -msgstr "// ANCHOR_END: Flags\n" +#: src/bare-metal/aps/better-uart.md +msgid "8" +msgstr "8" -#: src/exercises/bare-metal/rtc.md -msgid "" -"/// Flags from the UART Receive Status Register / Error Clear Register.\n" -msgstr "" -"/// Marcas del registro de estado de recepción de UART/Registro de borrado " -"de errores.\n" +#: src/bare-metal/aps/better-uart.md +msgid "0x24" +msgstr "0x24" -#: src/exercises/bare-metal/rtc.md -msgid "/// Framing error.\n" -msgstr "/// Error de encuadre.\n" +#: src/bare-metal/aps/better-uart.md +msgid "IBRD" +msgstr "IBRD" -#: src/exercises/bare-metal/rtc.md -msgid "/// Parity error.\n" -msgstr "/// Error de paridad.\n" +#: src/bare-metal/aps/better-uart.md +msgid "16" +msgstr "16" -#: src/exercises/bare-metal/rtc.md -msgid "/// Break error.\n" -msgstr "/// Error de break.\n" +#: src/bare-metal/aps/better-uart.md +msgid "0x28" +msgstr "0x28" -#: src/exercises/bare-metal/rtc.md -msgid "/// Overrun error.\n" -msgstr "/// Error de desbordamiento.\n" +#: src/bare-metal/aps/better-uart.md +msgid "FBRD" +msgstr "FBRD" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR: Registers\n" -msgstr "// ANCHOR: Registers\n" +#: src/bare-metal/aps/better-uart.md +msgid "6" +msgstr "6" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR_END: Registers\n" -msgstr "// ANCHOR_END: Registers\n" +#: src/bare-metal/aps/better-uart.md +msgid "0x2c" +msgstr "0x2c" -#: src/exercises/bare-metal/rtc.md -msgid "" -"// ANCHOR: Uart\n" -"/// Driver for a PL011 UART.\n" -msgstr "" -"// ANCHOR: Uart\n" -"/// Controlador para un UART PL011.\n" +#: src/bare-metal/aps/better-uart.md +msgid "LCR_H" +msgstr "LCR_H" -#: src/exercises/bare-metal/rtc.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" -msgstr "" -"/// Crea una instancia nueva del controlador UART para un dispositivo PL011 " -"en la\n" -" /// dirección base proporcionada.\n" -" ///\n" -" /// # Seguridad\n" -" ///\n" -" /// El objeto la dirección base debe apuntar a los registros de control " -"MMIO de un dispositivo\n" -" /// PL011, que debe asignarse al espacio de direcciones del proceso\n" -" /// como memoria del dispositivo y no tener ningún otro alias.\n" +#: src/bare-metal/aps/better-uart.md +msgid "0x30" +msgstr "0x30" -#: src/exercises/bare-metal/rtc.md -msgid "// ANCHOR_END: Uart\n" -msgstr "// ANCHOR_END: Uart\n" - -#: src/exercises/bare-metal/rtc.md -msgid "_build.rs_ (you shouldn't need to change this):" -msgstr "_build.rs_ (no debería ser necesario cambiarlo):" +#: src/bare-metal/aps/better-uart.md +msgid "CR" +msgstr "CR" -#: src/exercises/bare-metal/rtc.md -msgid "\"linux\"" -msgstr "\"linux\"" +#: src/bare-metal/aps/better-uart.md +msgid "0x34" +msgstr "0x34" -#: src/exercises/bare-metal/rtc.md -msgid "\"CROSS_COMPILE\"" -msgstr "\"CROSS_COMPILE\"" +#: src/bare-metal/aps/better-uart.md +msgid "IFLS" +msgstr "IFLS" -#: src/exercises/bare-metal/rtc.md -msgid "\"aarch64-linux-gnu\"" -msgstr "\"aarch64-linux-gnu\"" +#: src/bare-metal/aps/better-uart.md +msgid "0x38" +msgstr "0x38" -#: src/exercises/bare-metal/rtc.md -msgid "\"aarch64-none-elf\"" -msgstr "\"aarch64-none-elf\"" +#: src/bare-metal/aps/better-uart.md +msgid "IMSC" +msgstr "IMSC" -#: src/exercises/bare-metal/rtc.md -msgid "\"entry.S\"" -msgstr "\"entry.S\"" +#: src/bare-metal/aps/better-uart.md +msgid "11" +msgstr "11" -#: src/exercises/bare-metal/rtc.md -msgid "\"exceptions.S\"" -msgstr "\"exceptions.S\"" +#: src/bare-metal/aps/better-uart.md +msgid "0x3c" +msgstr "0x3c" -#: src/exercises/bare-metal/rtc.md -msgid "\"idmap.S\"" -msgstr "\"idmap.S\"" +#: src/bare-metal/aps/better-uart.md +msgid "RIS" +msgstr "RIS" -#: src/exercises/bare-metal/rtc.md -msgid "\"empty\"" -msgstr "\"empty\"" +#: src/bare-metal/aps/better-uart.md +msgid "0x40" +msgstr "0x40" -#: src/exercises/bare-metal/rtc.md -msgid "_entry.S_ (you shouldn't need to change this):" -msgstr "_entry.S_ (no debería ser necesario cambiarlo):" +#: src/bare-metal/aps/better-uart.md +msgid "MIS" +msgstr "MIS" -#: src/exercises/bare-metal/rtc.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" -"```" -msgstr "" -"```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" -" * Es un punto de entrada genérico para una imagen. 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" -"```" +#: src/bare-metal/aps/better-uart.md +msgid "0x44" +msgstr "0x44" -#: src/exercises/bare-metal/rtc.md -msgid "_exceptions.S_ (you shouldn't need to change this):" -msgstr "_exceptions.S_ (no debería ser necesario cambiarlo):" +#: src/bare-metal/aps/better-uart.md +msgid "ICR" +msgstr "ICR" -#: src/exercises/bare-metal/rtc.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" -"```" -msgstr "" -"```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" -"```" +#: src/bare-metal/aps/better-uart.md +msgid "0x48" +msgstr "0x48" -#: src/exercises/bare-metal/rtc.md -msgid "_idmap.S_ (you shouldn't need to change this):" -msgstr "_idmap.S_ (no debería ser necesario cambiarlo):" +#: src/bare-metal/aps/better-uart.md +msgid "DMACR" +msgstr "DMACR" -#: src/exercises/bare-metal/rtc.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" -"```" -msgstr "" -"```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" -"```" +#: src/bare-metal/aps/better-uart.md +msgid "3" +msgstr "3" -#: src/exercises/bare-metal/rtc.md -msgid "_image.ld_ (you shouldn't need to change this):" -msgstr "_image.ld_ (no debería ser necesario cambiarlo):" +#: src/bare-metal/aps/better-uart.md +msgid "There are also some ID registers which have been omitted for brevity." +msgstr "También hay algunos registros de ID que se han omitido para abreviar." -#: src/exercises/bare-metal/rtc.md +#: src/bare-metal/aps/better-uart/bitflags.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" -"```" +"The [`bitflags`](https://crates.io/crates/bitflags) crate is useful for " +"working with bitflags." msgstr "" -"```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" -"```" - -#: src/exercises/bare-metal/rtc.md -msgid "_Makefile_ (you shouldn't need to change this):" -msgstr "_Makefile_ (no debería ser necesario cambiarlo):" +"El crate [`bitflags`](https://crates.io/crates/bitflags) resulta útil para " +"trabajar con bitflags." -#: src/exercises/bare-metal/rtc.md -msgid "# Copyright 2023 Google LLC" -msgstr "# Copyright 2023 Google LLC" +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Flags from the UART flag register.\n" +msgstr "/// Marcas del registro de marcas de UART.\n" -#: src/exercises/bare-metal/rtc.md -msgid "$(shell uname -s)" -msgstr "$(shell uname -s)" +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Clear to send.\n" +msgstr "/// Borra para enviar.\n" -#: src/exercises/bare-metal/rtc.md -msgid "aarch64-linux-gnu" -msgstr "aarch64-linux-gnu" +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Data set ready.\n" +msgstr "/// Conjunto de datos listo.\n" -#: src/exercises/bare-metal/rtc.md -msgid "stdio -display none -kernel $< -s" -msgstr "stdio -display none -kernel $< -s" +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Data carrier detect.\n" +msgstr "/// Detección del portador de datos.\n" -#: src/exercises/bare-metal/rtc.md -msgid "cargo clean" -msgstr "cargo clean" +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// UART busy transmitting data.\n" +msgstr "/// UART está transmitiendo datos.\n" -#: src/exercises/bare-metal/rtc.md -msgid "Run the code in QEMU with `make qemu`." -msgstr "Ejecuta el código en QEMU con `make qemu`." +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Receive FIFO is empty.\n" +msgstr "/// El FIFO de recepción está vacío\n" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "Bare Metal Rust Afternoon" -msgstr "Rust Bare Metal: Tarde" +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Transmit FIFO is full.\n" +msgstr "/// El FIFO de transmisión está completo.\n" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "([back to exercise](rtc.md))" -msgstr "([volver al ejercicio](rtc.md))" +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Receive FIFO is full.\n" +msgstr "/// El FIFO de recepción está completo.\n" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "_main.rs_:" -msgstr "_main.rs_:" +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Transmit FIFO is empty.\n" +msgstr "/// El FIFO de transmisión está vacío.\n" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Base address of the PL031 RTC.\n" -msgstr "/// Dirección base de PL031 RTC.\n" +#: src/bare-metal/aps/better-uart/bitflags.md +msgid "/// Ring indicator.\n" +msgstr "/// Indicador de anillo.\n" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// The IRQ used by the PL031 RTC.\n" -msgstr "/// IRQ que utiliza PL031 RTC.\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 "" +"La macro `bitflags!` crea un newtype, como `Flags(u16)`, junto con un montón " +"de implementaciones de métodos para obtener y definir _flags_ (banderas)." -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/bare-metal/aps/better-uart/registers.md +msgid "Multiple registers" +msgstr "Varios registros" + +#: src/bare-metal/aps/better-uart/registers.md msgid "" -"// Safe because `PL031_BASE_ADDRESS` is the base address of a PL031 device,\n" -" // and nothing else accesses that address range.\n" +"We can use a struct to represent the memory layout of the UART's registers." msgstr "" -"// Es seguro porque `PL031_BASE_ADDRESS` es la dirección base de un " -"dispositivo PL031\n" -" // y ningún otro elemento puede acceder a ese intervalo de direcciones.\n" +"Podemos utilizar una estructura para representar la disposición de la " +"memoria de los registros de UART." -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "\"RTC: {time}\"" -msgstr "\"RTC: {time}\"" +#: 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) indica al compilador que ordene los campos de la estructura " +"siguiendo las mismas reglas que en C. Esto es necesario para que nuestra " +"estructura tenga un diseño predecible, ya que la representación " +"predeterminada de Rust permite que el compilador (entre otras cosas) " +"reordene los campos como crea conveniente." -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "// Wait for 3 seconds, without interrupts.\n" -msgstr "// Espera 3 segundos, sin interrupciones.\n" +#: src/bare-metal/aps/better-uart/driver.md +msgid "Now let's use the new `Registers` struct in our driver." +msgstr "" +"Ahora vamos a utilizar la nueva estructura de `Registers` en nuestro " +"controlador." -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "\"Waiting for {}\"" -msgstr "\"Esperando a {}\"" +#: src/bare-metal/aps/better-uart/driver.md +msgid "/// Driver for a PL011 UART.\n" +msgstr "/// Controlador para un UART PL011.\n" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "\"matched={}, interrupt_pending={}\"" -msgstr "\"matched={}, interrupt_pending={}\"" +#: 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 "" +"// Es seguro porque sabemos que self.registers apunta\n" +" // a los registros de control de un dispositivo PL011 que está " +"asignado correctamente.\n" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "\"Finished waiting\"" -msgstr "\"Espera finalizada\"" +#: 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 "" +"/// Lee y devuelve un byte pendiente o `None` si no se ha recibido nada\n" +" ///.\n" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "// Wait another 3 seconds for an interrupt.\n" -msgstr "// Espera otros 3 segundos a que se produzca una interrupció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 "" +"// Es seguro porque sabemos que self.registers apunta\n" +" // a los registros de control de un dispositivo PL011 que está " +"asignado correctamente.\n" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "_pl031.rs_:" -msgstr "_pl031.rs_:" +#: src/bare-metal/aps/better-uart/driver.md +msgid "// TODO: Check for error conditions in bits 8-11.\n" +msgstr "// TAREA: Comprueba si hay condiciones de error en los bits 8 a 11.\n" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Data register\n" -msgstr "/// Registro de datos\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 "" +"Fíjate en el uso de `addr_of!` y `addr_of_mut!` para llevar punteros a " +"campos individuales sin crear una referencia intermedia. Sería una acción " +"insegura." -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Match register\n" -msgstr "/// Registro de coincidencias\n" +#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md +msgid "Using it" +msgstr "Uso" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Load register\n" -msgstr "/// Registro de cargas\n" +#: 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 "" +"Vamos a crear un pequeño programa con nuestro controlador para escribir en " +"la consola serie y compartir los bytes entrantes." +#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md #: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Control register\n" -msgstr "/// Registro de control\n" +msgid "/// Base address of the primary PL011 UART.\n" +msgstr "/// Dirección base del UART de PL011 principal.\n" +#: src/bare-metal/aps/better-uart/using.md src/bare-metal/aps/logging/using.md #: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Interrupt Mask Set or Clear register\n" -msgstr "/// Interrumpe Mask Set o Clear register\n" +#, fuzzy +msgid "" +"// SAFETY: `PL011_BASE_ADDRESS` is the base address of a PL011 device, and\n" +" // nothing else accesses that address range.\n" +msgstr "" +"// Es seguro porque `PL011_BASE_ADDRESS` es la dirección base de un " +"dispositivo PL011\n" +" // y ninguna más accede a ese intervalo de direcciones.\n" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Raw Interrupt Status\n" -msgstr "/// Estado de interrupción sin procesar\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/exercises/bare-metal/solutions-afternoon.md -msgid "/// Masked Interrupt Status\n" -msgstr "/// Estado de interrupción enmascarada\n" +#: src/bare-metal/aps/better-uart/using.md +msgid "b'\\r'" +msgstr "b'\\r'" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Interrupt Clear Register\n" -msgstr "/// Interrumpir registro de limpieza\n" +#: src/bare-metal/aps/better-uart/using.md +#: src/concurrency/async-pitfalls/cancellation.md +msgid "b'\\n'" +msgstr "b'\\n'" -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Driver for a PL031 real-time clock.\n" -msgstr "/// Controlador para un reloj en tiempo real PL031.\n" +#: src/bare-metal/aps/better-uart/using.md +msgid "b'q'" +msgstr "b'q'" -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/bare-metal/aps/better-uart/using.md +msgid "\"Bye!\"" +msgstr "\"¡Adiós!\"" + +#: src/bare-metal/aps/better-uart/using.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" +"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 "" -"/// Crea una instancia nueva del controlador RTC para un dispositivo PL031 " -"en la\n" -" /// dirección base proporcionada.\n" -" ///\n" -" /// # Seguridad\n" -" ///\n" -" /// El objeto la dirección base debe apuntar a los registros de control " -"MMIO de un dispositivo\n" -" /// PL031, que debe asignarse al espacio de direcciones del proceso\n" -" /// como memoria del dispositivo y no tener ningún otro alias.\n" - -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Reads the current RTC value.\n" -msgstr "/// Lee el valor de RTC actual.\n" +"Al igual que en el ejemplo de [ensamblaje integrado](../inline-assembly.md), " +"esta función `main` se llama desde nuestro código de punto de entrada en " +"`entry.S`. Consulta las notas del orador para obtener más información." -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/bare-metal/aps/better-uart/using.md msgid "" -"// Safe because we know that self.registers points to the control\n" -" // registers of a PL031 device which is appropriately mapped.\n" +"Run the example in QEMU with `make qemu` under `src/bare-metal/aps/examples`." msgstr "" -"// Es seguro porque sabemos que self.registers apunta\n" -" // a los registros de control de un dispositivo PL031 que está " -"asignado correctamente.\n" +"Ejecuta el ejemplo en QEMU con `make qemu` en `src/bare-metal/aps/examples`." -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/bare-metal/aps/logging.md msgid "" -"/// Writes a match value. When the RTC value matches this then an interrupt\n" -" /// will be generated (if it is enabled).\n" +"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 "" -"/// Escribe un valor de coincidencia. Cuando el valor de RTC coincida, se " -"generará una interrupción\n" -" /// (si está habilitada).\n" +"Estaría bien poder utilizar las macros de registro del crate [`log`](https://" +"crates.io/crates/log). Podemos hacerlo implementando el trait `Log`." -#: src/exercises/bare-metal/solutions-afternoon.md +#: src/bare-metal/aps/logging.md +msgid "\"[{}] {}\"" +msgstr "\"[{}] {}\"" + +#: src/bare-metal/aps/logging.md +msgid "/// Initialises UART logger.\n" +msgstr "/// Inicia el registro de UART.\n" + +#: src/bare-metal/aps/logging.md msgid "" -"/// Returns whether the match register matches the RTC value, whether or " -"not\n" -" /// the interrupt is enabled.\n" +"The unwrap in `log` is safe because we initialise `LOGGER` before calling " +"`set_logger`." msgstr "" -"/// Devuelve en función de si el registro de coincidencias coincide con el " -"valor de RTC,\n" -" /// si la interrupción está habilitada o no.\n" +"La desenvoltura en `log` es segura porque inicializamos `LOGGER` antes de " +"llamar a `set_logger`." -#: 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 "" -"/// Devuelve si hay una interrupción pendiente.\n" -" ///\n" -" /// Solo debe ser true si `matched` devuelve true y\n" -" /// la interrupción está enmascarada.\n" +#: src/bare-metal/aps/logging/using.md +msgid "We need to initialise the logger before we use it." +msgstr "Debemos inicializar el registrador antes de utilizarlo." +#: 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 "" +"Ten en cuenta que nuestro controlador de _panic_ ahora ya puede registrar la " +"información de los pánicos." + +#: src/bare-metal/aps/logging/using.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" +"Run the example in QEMU with `make qemu_logger` under `src/bare-metal/aps/" +"examples`." msgstr "" -"/// Define o borra la máscara de interrupción.\n" -" ///\n" -" /// Si la máscara es true, se habilita la interrupción; Si es false,\n" -" /// se inhabilita la interrupción.\n" +"Ejecuta el ejemplo en QEMU con `make qemu_logger` en `src/bare-metal/aps/" +"examples`." -#: src/exercises/bare-metal/solutions-afternoon.md -msgid "/// Clears a pending interrupt, if any.\n" -msgstr "/// Borra una interrupción pendiente, si la hubiera.\n" +#: 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 define una tabla de vectores de excepción con 16 entradas, para 4 " +"tipos de excepciones (synchronous, IRQ, FIQ, SError) desde 4 estados (EL " +"actual con SP0, EL actual con SPx, EL inferior con AArch64 y EL inferior con " +"AArch32). Implementamos esto en el ensamblaje para guardar los registros " +"volátiles en la _stack_ antes de llamar al código de Rust:" -#: src/concurrency.md -msgid "Welcome to Concurrency in Rust" -msgstr "Te Damos la Bienvenida a Concurrencia en Rust" +#: src/bare-metal/aps/exceptions.md +msgid "EL is exception level; all our examples this afternoon run in EL1." +msgstr "" +"EL significa nivel de excepción (por sus siglas en inglés); todos nuestros " +"ejemplos de esta tarde se ejecutan en EL1." -#: src/concurrency.md +#: src/bare-metal/aps/exceptions.md msgid "" -"Rust has full support for concurrency using OS threads with mutexes and " -"channels." +"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 "" -"Rust es totalmente compatible con la concurrencia mediante hilos del SO con " -"exclusiones mutuas y canales." +"Para simplificar, no distinguimos entre SP0 y SPx para las excepciones del " +"EL actual, ni entre AArch32 y AArch64 para las excepciones de EL inferiores." -#: src/concurrency.md +#: src/bare-metal/aps/exceptions.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." +"For this example we just log the exception and power down, as we don't " +"expect any of them to actually happen." msgstr "" -"El sistema de tipos de Rust desempeña un papel importante al hacer que " -"muchos errores de concurrencia sean errores en tiempo de compilación. A " -"menudo, esto se conoce como _concurrencia sin miedo_, ya que puedes confiar " -"en el compilador para asegurar la corrección en el tiempo de ejecución." +"En este ejemplo, nos limitaremos a registrar la excepción y a apagarla, ya " +"que no esperamos que se produzca ninguna." -#: src/concurrency/threads.md -msgid "Rust threads work similarly to threads in other languages:" -msgstr "Los hilos de Rust funcionan de forma similar a los de otros lenguajes:" +#: 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 "" +"Podríamos pensar en los controladores de excepciones y en nuestro contexto " +"de ejecución principal como si fueran hilos diferentes. [`Send` y `Sync`]" +"(../../concurrency/send-sync.md) controlarán lo que podemos compartir entre " +"ellos, igual que con los hilos. Por ejemplo, si queremos compartir algún " +"valor entre los controladores de excepciones y el resto del programa, y es " +"`Send`en vez de `Sync`, necesitaremos envolverlo en un `Mutex`, por ejemplo, " +"y ponerlo en un estático." -#: src/concurrency/threads.md -msgid "\"Count in thread: {i}!\"" -msgstr "\"Recuento en el hilo: {i}!\"" +#: src/bare-metal/aps/other-projects.md +msgid "[oreboot](https://github.com/oreboot/oreboot)" +msgstr "[oreboot](https://github.com/oreboot/oreboot)" -#: src/concurrency/threads.md -msgid "\"Main thread: {i}\"" -msgstr "\"Hilo principal: {i}\"" +#: src/bare-metal/aps/other-projects.md +msgid "\"coreboot without the C\"" +msgstr "\"coreboot sin la C\"." -#: src/concurrency/threads.md -msgid "Threads are all daemon threads, the main thread does not wait for them." -msgstr "" -"Los hilos son todos hilos daemon, y el hilo principal no espera por ellos." +#: src/bare-metal/aps/other-projects.md +msgid "Supports x86, aarch64 and RISC-V." +msgstr "Compatible con x86, aarch64 y RISC-V." -#: src/concurrency/threads.md -msgid "Thread panics are independent of each other." -msgstr "Los pánicos de los hilos son independientes entre sí." +#: src/bare-metal/aps/other-projects.md +msgid "Relies on LinuxBoot rather than having many drivers itself." +msgstr "Depende de LinuxBoot en lugar de tener controladores propios." -#: src/concurrency/threads.md -msgid "Panics can carry a payload, which can be unpacked with `downcast_ref`." +#: src/bare-metal/aps/other-projects.md +msgid "" +"[Rust RaspberryPi OS tutorial](https://github.com/rust-embedded/rust-" +"raspberrypi-OS-tutorials)" msgstr "" -"Los pánicos pueden transportar una carga útil, que se puede desempaquetar " -"con `downcast_ref`." +"[Tutorial del SO de Rust en RaspberryPi][Rust RaspberryPi OS tutorial]" +"(https://github.com/rust-embedded/rust-raspberrypi-OS-tutorials)" -#: src/concurrency/threads.md +#: src/bare-metal/aps/other-projects.md msgid "" -"Notice that the thread is stopped before it reaches 10 --- the main thread " -"is not waiting." +"Initialisation, UART driver, simple bootloader, JTAG, exception levels, " +"exception handling, page tables" msgstr "" -"Observa que el hilo se detiene antes de llegar a 10; el hilo principal no " -"está esperando." +"Inicialización, controlador de UART, bootloader sencillo, JTAG, niveles de " +"excepción, gestión de excepciones, tablas de páginas, etc." -#: src/concurrency/threads.md +#: src/bare-metal/aps/other-projects.md msgid "" -"Use `let handle = thread::spawn(...)` and later `handle.join()` to wait for " -"the thread to finish." +"Some dodginess around cache maintenance and initialisation in Rust, not " +"necessarily a good example to copy for production code." msgstr "" -"Utiliza `let handle = thread::spawn(...)` y, después, `handle.join()` para " -"esperar a que el hilo termine." +"Algunas dudas sobre el mantenimiento de la caché y la inicialización en " +"Rust, aunque no es precisamente un buen ejemplo para copiar en código de " +"producción." -#: src/concurrency/threads.md -msgid "Trigger a panic in the thread, notice how this doesn't affect `main`." -msgstr "Activa un pánico en el hilo y observa cómo esto no afecta a `main`." +#: 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 "Análisis estático para determinar el uso máximo de la _stack_." -#: src/concurrency/threads.md +#: src/bare-metal/aps/other-projects.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)." +"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 "" -"Usa el valor devuelto `Result` de `handle.join.()` para acceder a la carga " -"útil del pánico. Este es un buen momento para hablar sobre [`Any`](https://" -"doc.rust-lang.org/std/any/index.html)." - -#: src/concurrency/scoped-threads.md -msgid "Normal threads cannot borrow from their environment:" -msgstr "Los hilos normales no pueden tomar nada prestado de su entorno:" +"El tutorial del sistema operativo en RaspberryPi ejecuta código de Rust " +"antes de que la MMU y las cachés se habiliten. De este modo, se leerá y " +"escribirá memoria (por ejemplo, la _stack_). Sin embargo:" -#: src/concurrency/scoped-threads.md +#: src/bare-metal/aps/other-projects.md msgid "" -"However, you can use a [scoped thread](https://doc.rust-lang.org/std/thread/" -"fn.scope.html) for this:" +"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 "" -"Sin embargo, puedes usar un [hilo con ámbito](https://doc.rust-lang.org/std/" -"thread/fn.scope.html) para lo siguiente:" +"Sin la MMU y la caché, los accesos no alineados fallarán. Se compila con " +"`aarch64-unknown-none`, que define `+strict-align` para evitar que el " +"compilador genere accesos no alineados. Debería estar bien, pero no tiene " +"por qué ser así, en general." -#: src/concurrency/scoped-threads.md +#: src/bare-metal/aps/other-projects.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." +"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 "" -"La razón es que, cuando se completa la función `thread::scope`, se asegura " -"que todos los hilos están unidos, por lo que pueden devolver datos prestados." +"Si se estuviera ejecutando en una máquina virtual, podría provocar problemas " +"de coherencia en la caché. El problema es que la máquina virtual accede a la " +"memoria directamente con la caché inhabilitada, mientras que el host cuenta " +"con alias que se pueden almacenar en caché en la misma memoria. Incluso si " +"el host no accede explícitamente a la memoria, los accesos especulativos " +"pueden provocar que se llene la caché, haciendo que los cambios de uno u " +"otro se pierdan. De nuevo, es correcto en este caso particular (si se " +"ejecuta directamente en el hardware sin hipervisor) pero, por lo general, no " +"es un buen patrón." + +#: src/bare-metal/useful-crates.md +msgid "Useful crates" +msgstr "Crates Útiles" -#: src/concurrency/scoped-threads.md +#: src/bare-metal/useful-crates.md msgid "" -"Normal Rust borrowing rules apply: you can either borrow mutably by one " -"thread, or immutably by any number of threads." +"We'll go over a few crates which solve some common problems in bare-metal " +"programming." msgstr "" -"Se aplican las reglas normales de préstamo de Rust: un hilo puede tomar " -"datos prestados de manera mutable o cualquier número de hilos puede tomar " -"datos prestados de manera inmutable." +"A continuación, repasaremos algunos crates que resuelven ciertos problemas " +"comunes en la programación bare-metal." -#: src/concurrency/channels.md +#: src/bare-metal/useful-crates/zerocopy.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." +"The [`zerocopy`](https://docs.rs/zerocopy/) crate (from Fuchsia) provides " +"traits and macros for safely converting between byte sequences and other " +"types." msgstr "" -"Los canales de Rust tienen dos partes: `Sender` y `Receiver`. Las dos " -"partes están conectadas a través del canal, pero solo se ven los puntos " -"finales." - -#: src/concurrency/channels.md -msgid "\"Received: {:?}\"" -msgstr "\"Recibido: {:?}\"" +"El crate [`zerocopy`](https://docs.rs/zerocopy/) (de Fuchsia) proporciona " +"traits y macros para realizar conversiones seguras entre secuencias de bytes " +"y otros tipos." -#: src/concurrency/channels.md +#: src/bare-metal/useful-crates/zerocopy.md msgid "" -"`mpsc` stands for Multi-Producer, Single-Consumer. `Sender` and `SyncSender` " -"implement `Clone` (so you can make multiple producers) but `Receiver` does " -"not." +"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 "" -"`mpsc` son las siglas de Multi-Producer, Single-Consumer (multiproductor, " -"consumidor único.) `Sender` y `SyncSender` implementan `Clone` (es decir, " -"puedes crear varios productores), pero `Receiver` no." +"No es adecuado para MMIO (ya que no utiliza lecturas y escrituras " +"volátiles), pero puede ser útil para trabajar con estructuras compartidas " +"con hardware (por ejemplo, mediante DMA) o enviadas a través de alguna " +"interfaz externa." -#: src/concurrency/channels.md +#: src/bare-metal/useful-crates/zerocopy.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." +"`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 "" -"`send()` y `recv()` devuelven `Result`. Si devuelven `Err`, significa que el " -"homólogo `Sender` o `Receiver` se ha eliminado y el canal se ha cerrado." - -#: src/concurrency/channels/unbounded.md -msgid "You get an unbounded and asynchronous channel with `mpsc::channel()`:" -msgstr "Se obtiene un canal asíncrono y sin límites con `mpsc::channel()`:" +"`FromBytes` se puede implementar en tipos en los que cualquier patrón de " +"bytes es válido, por lo que se puede convertir de forma segura a partir de " +"una secuencia de bytes que no es fiable." -#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md -msgid "\"Message {i}\"" -msgstr "\"Mensaje {i}\"" - -#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md -msgid "\"{thread_id:?}: sent Message {i}\"" -msgstr "\"{thread_id:?}: mensaje enviado {i}\"" - -#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md -msgid "\"{thread_id:?}: done\"" -msgstr "\"{thread_id:?}: completado\"" - -#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md -msgid "\"Main: got {msg}\"" -msgstr "\"Principal: ha recibido {msg}\"" - -#: src/concurrency/channels/bounded.md +#: src/bare-metal/useful-crates/zerocopy.md msgid "" -"With bounded (synchronous) channels, `send` can block the current thread:" -msgstr "Con canales limitados (síncronos), `send` puede bloquear el hilo:" +"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 "" +"Si se intenta derivar `FromBytes` para estos tipos, se produciría un error, " +"pues `RequestType` no utiliza todos los valores u32 posibles como " +"discriminantes y, por tanto, todos los patrones de bytes son válidos." -#: src/concurrency/channels/bounded.md +#: src/bare-metal/useful-crates/zerocopy.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." +"`zerocopy::byteorder` has types for byte-order aware numeric primitives." msgstr "" -"Al llamar a `send`, se bloqueará el hilo hasta que haya espacio suficiente " -"en el canal para el mensaje nuevo. El hilo se puede bloquear de forma " -"indefinida si no hay nadie que lea el canal." +"`zerocopy::byteorder` tiene tipos para primitivos numéricos conscientes del " +"orden de bytes." -#: src/concurrency/channels/bounded.md +#: src/bare-metal/useful-crates/zerocopy.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." +"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 "" -"Si se cierra el canal, se anulará la llamada a `send` y se producirá un " -"error (por eso devuelve `Result`). Un canal se cierra cuando se elimina el " -"receptor." +"Ejecuta el ejemplo con `cargo run` en `src/bare-metal/useful-crates/zerocopy-" +"example/`. (No se ejecutará en el playground debido a la dependencia del " +"crate)." -#: src/concurrency/channels/bounded.md +#: src/bare-metal/useful-crates/aarch64-paging.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`." +"The [`aarch64-paging`](https://crates.io/crates/aarch64-paging) crate lets " +"you create page tables according to the AArch64 Virtual Memory System " +"Architecture." msgstr "" -"Un canal delimitado con un tamaño de cero se denomina \"canal rendezvous\". " -"Cada envío bloqueará el hilo actual hasta que otro hilo llame a `read`." +"El crate [`aarch64-paging`](https://crates.io/crates/aarch64-paging) permite " +"crear tablas de páginas de acuerdo con la arquitectura del sistema de " +"memoria virtual AArch64." -#: src/concurrency/send-sync.md -#, fuzzy +#: src/bare-metal/useful-crates/aarch64-paging.md +msgid "// Create a new page table with identity mapping.\n" +msgstr "// Crea una tabla de páginas con mapeado de identidades.\n" + +#: src/bare-metal/useful-crates/aarch64-paging.md +msgid "// Map a 2 MiB region of memory as read-only.\n" +msgstr "// Asigna una región de 2 MiB de memoria como de solo lectura.\n" + +#: src/bare-metal/useful-crates/aarch64-paging.md +msgid "// Set `TTBR0_EL1` to activate the page table.\n" +msgstr "// Configura `TTBR0_EL1` para activar la tabla de páginas.\n" + +#: src/bare-metal/useful-crates/aarch64-paging.md msgid "" -"How does Rust know to forbid shared access across threads? The answer is in " -"two traits:" +"For now it only supports EL1, but support for other exception levels should " +"be straightforward to add." msgstr "" -"¿Cómo sabe Rust que debe prohibir el acceso compartido entre hilos? La " -"respuesta está en dos traits:" +"Por ahora, solo es compatible con EL1, pero debería ser sencillo añadir " +"compatibilidad con otros niveles de excepción." -#: src/concurrency/send-sync.md +#: src/bare-metal/useful-crates/aarch64-paging.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." +"This is used in Android for the [Protected VM Firmware](https://cs.android." +"com/android/platform/superproject/+/master:packages/modules/Virtualization/" +"pvmfw/)." msgstr "" -"[`Send`](https://doc.rust-lang.org/std/marker/trait.Send.html): un tipo `T` " -"es `Send` si es seguro mover un `T` entre los límites de un hilo." +"Se utiliza en Android para el [Firmware de Máquina Virtual Protegida]" +"(https://cs.android.com/android/platform/superproject/+/master:packages/" +"modules/Virtualization/pvmfw/)." -#: src/concurrency/send-sync.md +#: src/bare-metal/useful-crates/aarch64-paging.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." +"There's no easy way to run this example, as it needs to run on real hardware " +"or under QEMU." msgstr "" -"[`Sync`](https://doc.rust-lang.org/std/marker/trait.Sync.html): un tipo `T` " -"es `Sync` si es seguro mover un `&T` entre los límites de un hilo." +"No hay una forma sencilla de ejecutar este ejemplo, ya que debe hacerse en " +"hardware real o en QEMU." -#: src/concurrency/send-sync.md +#: src/bare-metal/useful-crates/buddy_system_allocator.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." +"[`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 "" -"`Send` y `Sync` son [traits inseguros](../unsafe/unsafe-traits.md). El " -"compilador los derivará automáticamente a tus tipos siempre que solo " -"contengan los tipos `Send` y `Sync`. También puedes implementarlos de forma " -"manual cuando sepas que es válido." +"[`buddy_system_allocator`](https://crates.io/crates/buddy_system_allocator) " +"es un crate de terceros que implementa un asignador básico del sistema " +"buddy. Se puede utilizar tanto para [`LockedHeap`](https://docs.rs/" +"buddy_system_allocator/0.9.0/buddy_system_allocator/struct.LockedHeap.html) " +"implementando [`GlobalAlloc`](https://doc.rust-lang.org/core/alloc/trait." +"GlobalAlloc.html), de forma que puedas usar el crate `alloc` estándar (tal y " +"como vimos [antes](../alloc.md)), o para asignar otro espacio de " +"direcciones. Por ejemplo, podríamos querer asignar espacio MMIO para los " +"registros de dirección base (BAR) de PCI:" -#: src/concurrency/send-sync.md +#: src/bare-metal/useful-crates/buddy_system_allocator.md +msgid "PCI BARs always have alignment equal to their size." +msgstr "Los BAR de PCI siempre tienen una alineación igual a su tamaño." + +#: src/bare-metal/useful-crates/buddy_system_allocator.md msgid "" -"One can think of these traits as markers that the type has certain thread-" -"safety properties." +"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 "" -"Se podría pensar en estos traits como marcadores que indican que el tipo " -"tiene ciertas propiedades de seguridad en hilos." +"Ejecuta el ejemplo con `cargo run` en `src/bare-metal/useful-crates/" +"allocator-example/`. (No se ejecutará en el playground debido a la " +"dependencia del crate)." -#: src/concurrency/send-sync.md -msgid "They can be used in the generic constraints as normal traits." +#: 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 "" -"Se pueden utilizar en las restricciones genéricas como traits normales." +"A veces, se necesita algo que se pueda cambiar de tamaño, como `Vec`, pero " +"sin asignación de _heap_. [`tinyvec`](https://crates.io/crates/tinyvec) " +"ofrece un vector respaldado por un array o slice, que se podría asignar " +"estáticamente o en la _stack_, y que hace un seguimiento de cuántos " +"elementos se usan, entrando en _panic_ si intentas utilizar más elementos de " +"los asignados." -#: src/concurrency/send-sync/send.md +#: src/bare-metal/useful-crates/tinyvec.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." +"`tinyvec` requires that the element type implement `Default` for " +"initialisation." msgstr "" -"Un tipo `T` es [`Send`](https://doc.rust-lang.org/std/marker/trait.Send." -"html) si es seguro mover un valor `T` a otro hilo." +"`tinyvec` requiere que el tipo de elemento implemente `Default` para la " +"inicialización." -#: src/concurrency/send-sync/send.md +#: src/bare-metal/useful-crates/tinyvec.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." +"The Rust Playground includes `tinyvec`, so this example will run fine inline." msgstr "" -"El efecto de mover la propiedad a otro hilo es que los _destructores_ se " -"ejecutarán en ese hilo. Por tanto, la cuestion es cuándo se puede asignar un " -"valor a un hilo y desasignarlo en otro." +"El playground de Rust incluye `tinyvec`, por lo que este ejemplo se " +"ejecutará bien aunque esté insertado." -#: src/concurrency/send-sync/send.md +#: src/bare-metal/useful-crates/spin.md msgid "" -"As an example, a connection to the SQLite library must only be accessed from " -"a single thread." +"`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 "" -"Por ejemplo, solo se puede acceder a una conexión a la biblioteca SQLite " -"desde un único hilo." +"`std::sync::Mutex` y el resto de los primitivos de sincronización de `std::" +"sync` no están disponibles en `core` o `alloc`. ¿Cómo podemos gestionar la " +"sincronización o la mutabilidad interior para, por ejemplo, compartir el " +"estado entre diferentes CPUs?" -#: src/concurrency/send-sync/sync.md +#: src/bare-metal/useful-crates/spin.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." +"The [`spin`](https://crates.io/crates/spin) crate provides spinlock-based " +"equivalents of many of these primitives." msgstr "" -"Un tipo `T` es [`Sync`](https://doc.rust-lang.org/std/marker/trait.Sync." -"html) si es seguro acceder a un valor `T` desde varios hilos al mismo tiempo." +"El crate [`spin`](https://crates.io/crates/spin) proporciona equivalentes " +"basados en spinlocks de muchos de estos primitivos." -#: src/concurrency/send-sync/sync.md -msgid "More precisely, the definition is:" -msgstr "En concreto, la definición es la siguiente:" +#: src/bare-metal/useful-crates/spin.md +msgid "Be careful to avoid deadlock if you take locks in interrupt handlers." +msgstr "" +"Intenta evitar interbloqueos si usas bloqueos en los controladores de las " +"interrupciones." -#: src/concurrency/send-sync/sync.md -msgid "`T` is `Sync` if and only if `&T` is `Send`" -msgstr "`T` es `Sync` únicamente si `&T` es `Send`." +#: 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` también cuenta con una implementación de exclusión mutua de bloqueo " +"de tickets; equivalentes de `RwLock`, `Barrier` y `Once` de `std::sync`, y " +"`Lazy` para inicialización perezosa" -#: src/concurrency/send-sync/sync.md +#: src/bare-metal/useful-crates/spin.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." +"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 "" -"Esta instrucción es, básicamente, una forma resumida de indicar que, si un " -"tipo es seguro para los hilos en uso compartido, también lo es para pasar " -"referencias de él a través de los hilos." +"El crate [`once_cell`](https://crates.io/crates/once_cell) también tiene " +"algunos tipos útiles de inicialización tardía con un enfoque ligeramente " +"distinto al de `spin::once::Once`." -#: src/concurrency/send-sync/sync.md +#: src/bare-metal/useful-crates/spin.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." +"The Rust Playground includes `spin`, so this example will run fine inline." msgstr "" -"Esto se debe a que, si el tipo es Sync, significa que se puede compartir " -"entre múltiples hilos sin el riesgo de que haya carreras de datos u otros " -"problemas de sincronización, por lo que es seguro moverlo a otro hilo. " -"También es seguro mover una referencia al tipo a otro hilo, ya que se puede " -"acceder de forma segura a los datos a los que hace referencia desde " -"cualquier hilo." +"El playground de Rust incluye `spin`, por lo que este ejemplo se ejecutará " +"bien aunque está insertado." -#: 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 "La mayoría de los tipos que encuentras son `Send + Sync`:" - -#: src/concurrency/send-sync/examples.md -msgid "`i8`, `f32`, `bool`, `char`, `&str`, ..." -msgstr "`i8`, `f32`, `bool`, `char`, `&str`, etc." - -#: src/concurrency/send-sync/examples.md -msgid "`(T1, T2)`, `[T; N]`, `&[T]`, `struct { x: T }`, ..." -msgstr "`(T1, T2)`, `[T; N]`, `&[T]`, `struct { x: T }`, etc." - -#: src/concurrency/send-sync/examples.md -msgid "`String`, `Option`, `Vec`, `Box`, ..." -msgstr "`String`, `Option`, `Vec`, `Box`, etc." - -#: src/concurrency/send-sync/examples.md -msgid "`Arc`: Explicitly thread-safe via atomic reference count." -msgstr "" -"`Arc`: explícitamente seguro para los hilos mediante el recuento atómico " -"de referencias." - -#: src/concurrency/send-sync/examples.md -msgid "`Mutex`: Explicitly thread-safe via internal locking." -msgstr "" -"`Mutex`: explícitamente seguro para los hilos mediante bloqueo interno." - -#: src/concurrency/send-sync/examples.md -msgid "`AtomicBool`, `AtomicU8`, ...: Uses special atomic instructions." -msgstr "" -"`AtomicBool`, `AtomicU8`, etc.: utiliza instrucciones atómicas especiales." - -#: src/concurrency/send-sync/examples.md +#: src/bare-metal/android.md msgid "" -"The generic types are typically `Send + Sync` when the type parameters are " -"`Send + Sync`." +"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 "" -"Los tipos genéricos suelen ser `Send + Sync` cuando los parámetros del tipo " -"son `Send + Sync`." +"Para compilar un binario de Rust bare-metal en AOSP, tienes que usar una " +"regla `rust_ffi_static` de Soong para crear tu código Rust y, seguidamente, " +"un `cc_binary` con una secuencia de comandos de enlazador para producir el " +"binario en sí. Por último, un `raw_binary` para convertir el ELF en un " +"binario sin formato que pueda ejecutarse." -#: src/concurrency/send-sync/examples.md -msgid "`Send + !Sync`" -msgstr "`Send + !Sync`" +#: src/bare-metal/android/vmbase.md +msgid "vmbase" +msgstr "vmbase" -#: src/concurrency/send-sync/examples.md +#: src/bare-metal/android/vmbase.md msgid "" -"These types can be moved to other threads, but they're not thread-safe. " -"Typically because of interior mutability:" +"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." msgstr "" -"Estos tipos se pueden mover a otros hilos, pero no son seguros para los " -"hilos. Normalmente, esto se debe a la mutabilidad interior:" - -#: src/concurrency/send-sync/examples.md -msgid "`mpsc::Sender`" -msgstr "`mpsc::Sender`" - -#: src/concurrency/send-sync/examples.md -msgid "`mpsc::Receiver`" -msgstr "`mpsc::Receiver`" - -#: src/concurrency/send-sync/examples.md -msgid "`Cell`" -msgstr "`Cell`" - -#: src/concurrency/send-sync/examples.md -msgid "`RefCell`" -msgstr "`RefCell`" - -#: src/concurrency/send-sync/examples.md -msgid "`!Send + Sync`" -msgstr "`!Send + Sync`" +"En el caso de las máquinas virtuales que se ejecutan con crosvm en aarch64, " +"la biblioteca [vmbase](https://android.googlesource.com/platform/packages/" +"modules/Virtualization/+/refs/heads/master/vmbase/) proporciona una " +"secuencia de comandos de enlazador y valores predeterminados útiles para las " +"reglas de compilación, además de un punto de entrada, registro de la consola " +"UART y mucho más." -#: src/concurrency/send-sync/examples.md +#: src/bare-metal/android/vmbase.md msgid "" -"These types are thread-safe, but they cannot be moved to another thread:" +"The `main!` macro marks your main function, to be called from the `vmbase` " +"entry point." msgstr "" -"Estos tipos son seguros para los hilos _(thread safe)_, pero no se pueden " -"mover a otro hilo:" +"La macro `main!` indica tu función principal, que se llama desde el punto de " +"entrada `vmbase`." -#: src/concurrency/send-sync/examples.md -#, fuzzy +#: src/bare-metal/android/vmbase.md msgid "" -"`MutexGuard`: Uses OS level primitives which must be deallocated on " -"the thread which created them." +"The `vmbase` entry point handles console initialisation, and issues a " +"PSCI_SYSTEM_OFF to shutdown the VM if your main function returns." msgstr "" -"`MutexGuard`: utiliza primitivos de nivel SO que se deben desasignar en " -"el hilo que los creó." - -#: src/concurrency/send-sync/examples.md -msgid "`!Send + !Sync`" -msgstr "`!Send + !Sync`" +"El punto de entrada `vmbase` gestiona la inicialización de la consola y " +"emite PSCI_SYSTEM_OFF para apagar la máquina virtual si tu función principal " +"devuelve un resultado." -#: src/concurrency/send-sync/examples.md -msgid "These types are not thread-safe and cannot be moved to other threads:" +#: src/exercises/bare-metal/afternoon.md +msgid "We will write a driver for the PL031 real-time clock device." msgstr "" -"Estos tipos no son seguros para los hilos y no se pueden mover a otros hilos:" +"Escribiremos un controlador para el dispositivo de reloj en tiempo real " +"PL031." -#: src/concurrency/send-sync/examples.md +#: src/exercises/bare-metal/afternoon.md msgid "" -"`Rc`: each `Rc` has a reference to an `RcBox`, which contains a non-" -"atomic reference count." +"After looking at the exercises, you can look at the [solutions](solutions-" +"afternoon.md) provided." msgstr "" -"`Rc`: cada `Rc` tiene una referencia a un `RcBox`, que contiene un " -"recuento de referencias no atómico." +"Luego de ver los ejercicios, puedes ver las [soluciones](solutions-afternoon." +"md) que se brindan." -#: src/concurrency/send-sync/examples.md -msgid "" -"`*const T`, `*mut T`: Rust assumes raw pointers may have special concurrency " -"considerations." -msgstr "" -"`*const T`, `*mut T`: Rust asume que los punteros sin procesar pueden tener " -"consideraciones especiales de concurrencia." +#: src/exercises/bare-metal/rtc.md +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "RTC driver" +msgstr "Controlador RTC" -#: src/concurrency/shared_state.md +#: src/exercises/bare-metal/rtc.md msgid "" -"Rust uses the type system to enforce synchronization of shared data. This is " -"primarily done via two types:" +"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 "" -"Rust utiliza el sistema de tipos para implementar la sincronización de los " -"datos compartidos. Esto se hace principalmente a través de dos tipos:" +"La máquina virtual aarch64 de QEMU tiene un reloj en tiempo real [PL031]" +"(https://developer.arm.com/documentation/ddi0224/c) en 0x9010000. En este " +"ejercicio, debes escribir un controlador para el reloj." -#: src/concurrency/shared_state.md +#: src/exercises/bare-metal/rtc.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," +"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 "" -"[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html), recuento " -"atómico de referencias `T`: gestiona el uso compartido entre hilos y se " -"encarga de desasignar `T` cuando se elimina la última referencia." +"Úsalo para imprimir la hora en la consola serie. Puedes usar el crate " +"[`chrono`](https://crates.io/crates/chrono) para dar formato a la fecha y la " +"hora." -#: src/concurrency/shared_state.md +#: src/exercises/bare-metal/rtc.md msgid "" -"[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html): ensures " -"mutually exclusive access to the `T` value." +"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 "" -"[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html): asegura " -"el acceso mutuamente excluyente al valor `T`." +"Utiliza el registro de coincidencias y el estado de interrupción sin formato " +"para esperar hasta un momento dado, por ejemplo, un adelanto de 3 segundos. " +"(Llama a [`core::hint::spin_loop`](https://doc.rust-lang.org/core/hint/fn." +"spin_loop.html) dentro d+el bucle)." -#: src/concurrency/shared_state/arc.md +#: src/exercises/bare-metal/rtc.md msgid "" -"[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html) allows shared " -"read-only access via `Arc::clone`:" +"_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 "" -"[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html) permite el " -"acceso compartido de solo lectura a través de `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:?}\"" +"_Ampliación si hay tiempo:_ habilita y gestiona la interrupción que genera " +"la coincidencia de RTC. Puedes usar el controlador que se proporciona con el " +"crate [`arm-gic`](https://docs.rs/arm-gic/) para configurar el controlador " +"de interrupciones genérico (GIC) de Arm." -#: src/concurrency/shared_state/arc.md -msgid "" -"`Arc` stands for \"Atomic Reference Counted\", a thread safe version of `Rc` " -"that uses atomic operations." +#: src/exercises/bare-metal/rtc.md +msgid "Use the RTC interrupt, which is wired to the GIC as `IntId::spi(2)`." msgstr "" -"`Arc` son las siglas de \"Atomic Reference Counted\" (recuento atómico de " -"referencias), una versión de `Rc` segura para los hilos que utiliza " -"operaciones atómicas." +"Utiliza la interrupción de RTC, que está conectada al GIC como `IntId::" +"spi(2)`." -#: src/concurrency/shared_state/arc.md +#: src/exercises/bare-metal/rtc.md msgid "" -"`Arc` implements `Clone` whether or not `T` does. It implements `Send` " -"and `Sync` if and only if `T` implements them both." +"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 "" -"`Arc` implementa `Clone`, independientemente de si `T` lo hace o no. " -"Implementa `Send` y `Sync` si `T` implementa ambos." +"Después de habilitar la interrupción, puedes poner el núcleo en suspensión " +"mediante `arm_gic::wfi()`, lo que hará que entre en suspensión hasta que " +"reciba una interrupción." -#: src/concurrency/shared_state/arc.md +#: src/exercises/bare-metal/rtc.md msgid "" -"`Arc::clone()` has the cost of atomic operations that get executed, but " -"after that the use of the `T` is free." +"Download the [exercise template](../../comprehensive-rust-exercises.zip) and " +"look in the `rtc` directory for the following files." msgstr "" -"`Arc::clone()` tiene el coste de las operaciones atómicas que se ejecutan; " -"después el uso de `T` es libre." +"Descarga la [plantilla de ejercicio](../../comprehensive-rust-exercises.zip) " +"y busca en el directorio `rtc` los siguientes archivos." -#: src/concurrency/shared_state/arc.md +#: src/exercises/bare-metal/rtc.md +#, fuzzy msgid "" -"Beware of reference cycles, `Arc` does not use a garbage collector to detect " -"them." +"_src/exceptions.rs_ (you should only need to change this for the 3rd part of " +"the exercise):" msgstr "" -"Hay que prestar atención a los ciclos de referencia, ya que `Arc` no usa un " -"recolector de memoria residual para detectarlos." +"`src/exceptions.rs` (solo se debería cambiar esto en la tercera parte del " +"ejercicio):" -#: src/concurrency/shared_state/arc.md -msgid "`std::sync::Weak` can help." -msgstr "`std::sync::Weak` puede resultar útil." +#: src/exercises/bare-metal/rtc.md +msgid "_src/logger.rs_ (you shouldn't need to change this):" +msgstr "_src/logger.rs_ (no debería ser necesario cambiarlo):" -#: src/concurrency/shared_state/mutex.md -#, fuzzy -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)):" -msgstr "" -"[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html) asegura " -"la exclusión mutua _y_ permite un acceso mutable a `T` a través de una " -"interfaz de solo lectura:" +#: src/exercises/bare-metal/rtc.md +msgid "_src/pl011.rs_ (you shouldn't need to change this):" +msgstr "_src/pl011.rs_ (no debería ser necesario cambiarlo):" -#: src/concurrency/shared_state/mutex.md -msgid "\"v: {:?}\"" -msgstr "\"v: {:?}\"" +#: src/exercises/bare-metal/rtc.md +msgid "_build.rs_ (you shouldn't need to change this):" +msgstr "_build.rs_ (no debería ser necesario cambiarlo):" -#: src/concurrency/shared_state/mutex.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." -msgstr "" -"Fíjate en cómo tenemos una implementación general de [`impl Sync " -"for Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html#impl-" -"Sync-for-Mutex%3CT%3E)." +#: src/exercises/bare-metal/rtc.md +msgid "_entry.S_ (you shouldn't need to change this):" +msgstr "_entry.S_ (no debería ser necesario cambiarlo):" -#: src/concurrency/shared_state/mutex.md -#, fuzzy -msgid "" -"`Mutex` in Rust looks like a collection with just one element --- the " -"protected data." -msgstr "" -"`Mutex` en Rust parece una colección con un solo elemento: los datos " -"protegidos." +#: src/exercises/bare-metal/rtc.md +msgid "_exceptions.S_ (you shouldn't need to change this):" +msgstr "_exceptions.S_ (no debería ser necesario cambiarlo):" -#: src/concurrency/shared_state/mutex.md -msgid "" -"It is not possible to forget to acquire the mutex before accessing the " -"protected data." -msgstr "" -"No es posible olvidarse de adquirir la exclusión mutua antes de acceder a " -"los datos protegidos." +#: src/exercises/bare-metal/rtc.md +msgid "_idmap.S_ (you shouldn't need to change this):" +msgstr "_idmap.S_ (no debería ser necesario cambiarlo):" -#: 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 "" -"Puedes obtener un `&mut T` de `Mutex` mediante el bloqueo. El " -"`MutexGuard` asegura que `&mut T` no dure más tiempo que el bloqueo que se " -"ha aplicado." +#: src/exercises/bare-metal/rtc.md +msgid "_image.ld_ (you shouldn't need to change this):" +msgstr "_image.ld_ (no debería ser necesario cambiarlo):" -#: src/concurrency/shared_state/mutex.md -msgid "" -"`Mutex` implements both `Send` and `Sync` iff (if and only if) `T` " -"implements `Send`." -msgstr "" -"`Mutex` implementa tanto `Send` como `Sync` únicamente si `T` implementa " -"`Send`." +#: src/exercises/bare-metal/rtc.md +msgid "_Makefile_ (you shouldn't need to change this):" +msgstr "_Makefile_ (no debería ser necesario cambiarlo):" -#: src/concurrency/shared_state/mutex.md -#, fuzzy -msgid "A read-write lock counterpart: `RwLock`." -msgstr "Un equivalente de bloqueo de lectura y escritura: `RwLock`." +#: src/exercises/bare-metal/rtc.md +msgid "Run the code in QEMU with `make qemu`." +msgstr "Ejecuta el código en QEMU con `make qemu`." -#: src/concurrency/shared_state/mutex.md -#, fuzzy -msgid "Why does `lock()` return a `Result`?" -msgstr "¿Por qué `lock()` devuelve un `Result`? " +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "Bare Metal Rust Afternoon" +msgstr "Rust Bare Metal: Tarde" -#: 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 "" -"Si el hilo que contiene `Mutex` entra en pánico, `Mutex` se \"envenena\" " -"para indicar que los datos que protegía pueden estar en un estado " -"incoherente. Llamar a `lock()` en una exclusión mutua envenenada da el error " -"[`PoisonError`](https://doc.rust-lang.org/std/sync/struct.PoisonError.html). " -"Puedes llamar a `into_inner()` en el error para recuperar los datos de todos " -"modos." +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "([back to exercise](rtc.md))" +msgstr "([volver al ejercicio](rtc.md))" -#: src/concurrency/shared_state/example.md -msgid "Let us see `Arc` and `Mutex` in action:" -msgstr "Veamos cómo funcionan `Arc` y `Mutex`:" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "_main.rs_:" +msgstr "_main.rs_:" -#: src/concurrency/shared_state/example.md -msgid "// use std::sync::{Arc, Mutex};\n" -msgstr "// usar std::sync::{Arc, Mutex};\n" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Base addresses of the GICv3.\n" +msgstr "/// Direcciones base de GICv3.\n" -#: src/concurrency/shared_state/example.md -msgid "Possible solution:" -msgstr "Solución posible:" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Base address of the PL031 RTC.\n" +msgstr "/// Dirección base de PL031 RTC.\n" -#: src/concurrency/shared_state/example.md -msgid "Notable parts:" -msgstr "Puntos a destacar:" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// The IRQ used by the PL031 RTC.\n" +msgstr "/// IRQ que utiliza PL031 RTC.\n" -#: src/concurrency/shared_state/example.md -msgid "" -"`v` is wrapped in both `Arc` and `Mutex`, because their concerns are " -"orthogonal." -msgstr "" -"`v` se envuelve tanto en `Arc` como en `Mutex`, porque sus preocupaciones " -"son ortogonales." +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "\"main({:#x}, {:#x}, {:#x}, {:#x})\"" +msgstr "\"main({:#x}, {:#x}, {:#x}, {:#x})\"" -#: src/concurrency/shared_state/example.md +#: src/exercises/bare-metal/solutions-afternoon.md +#, fuzzy msgid "" -"Wrapping a `Mutex` in an `Arc` is a common pattern to share mutable state " -"between threads." +"// 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 "" -"Envolver un `Mutex` en un `Arc` es un patrón habitual para compartir el " -"estado mutable entre hilos." +"// Es seguro porque `GICD_BASE_ADDRESS` y `GICR_BASE_ADDRESS` son las " +"direcciones base\n" +" // de un distribuidor y un redistribuidor GICv3 respectivamente,\n" +" // y ningún otro elemento tiene acceso a esos intervalos de " +"direcciones.\n" -#: src/concurrency/shared_state/example.md +#: src/exercises/bare-metal/solutions-afternoon.md +#, fuzzy 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." +"// SAFETY: `PL031_BASE_ADDRESS` is the base address of a PL031 device, and\n" +" // nothing else accesses that address range.\n" msgstr "" -"`v: Arc<_>` se debe clonar como `v2` antes de poder moverlo a otro hilo. Ten " -"en cuenta que `move` se ha añadido a la firma lambda." +"// Es seguro porque `PL031_BASE_ADDRESS` es la dirección base de un " +"dispositivo PL031\n" +" // y ningún otro elemento puede acceder a ese intervalo de direcciones.\n" -#: src/concurrency/shared_state/example.md -msgid "" -"Blocks are introduced to narrow the scope of the `LockGuard` as much as " -"possible." -msgstr "" -"Se introducen bloqueos para limitar al máximo el ámbito de `LockGuard`." +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "\"RTC: {time}\"" +msgstr "\"RTC: {time}\"" -#: src/exercises/concurrency/morning.md -msgid "Let us practice our new concurrency skills with" -msgstr "Vamos a practicar nuestras nuevas habilidades de concurrencia con" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "// Wait for 3 seconds, without interrupts.\n" +msgstr "// Espera 3 segundos, sin interrupciones.\n" -#: src/exercises/concurrency/morning.md -msgid "Dining philosophers: a classic problem in concurrency." -msgstr "La cena de los filósofos: un problema clásico de concurrencia." +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "\"Waiting for {}\"" +msgstr "\"Esperando a {}\"" -#: 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 "" -"El comprobador de enlaces multihilo: un proyecto más grande donde utilizarás " -"Cargo para descargar dependencias y luego comprobar los enlaces en paralelo." +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "\"matched={}, interrupt_pending={}\"" +msgstr "\"matched={}, interrupt_pending={}\"" -#: src/exercises/concurrency/dining-philosophers.md -msgid "The dining philosophers problem is a classic problem in concurrency:" -msgstr "" -"El problema de la cena de los filósofos es un problema clásico de " -"concurrencia:" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "\"Finished waiting\"" +msgstr "\"Espera finalizada\"" -#: 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 "" -"Cinco filósofos cenan juntos en la misma mesa. Cada filósofo tiene su propio " -"sitio en ella. Hay un tenedor entre cada plato. El plato que van a degustar " -"es una especie de espaguetis que hay que comer con dos tenedores. Los " -"filósofos solo pueden pensar y comer alternativamente. Además, solo pueden " -"comer sus espaguetis cuando disponen de un tenedor a la izquierda y otro a " -"la derecha. Por tanto, los dos tenedores solo estarán disponibles cuando su " -"dos vecinos más cercanos estén pensando y no comiendo. Cuando un filósofo " -"termina de comer, deja los dos tenedores en la mesa." +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "// Wait another 3 seconds for an interrupt.\n" +msgstr "// Espera otros 3 segundos a que se produzca una interrupción.\n" -#: 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 "" -"Para realizar este ejercicio necesitarás una \\[instalación local de " -"Cargo\\] (../../cargo/running-locally.md). Copia el fragmento de código que " -"aparece más abajo en un archivo denominado `src/main.rs`, rellena los " -"espacios en blanco y comprueba que `cargo run` no presenta interbloqueos:" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "_pl031.rs_:" +msgstr "_pl031.rs_:" -#: 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" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Data register\n" +msgstr "/// Registro de datos\n" -#: 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! ¡{} tiene una nueva idea!\"" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Match register\n" +msgstr "/// Registro de coincidencias\n" -#: 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 "// Recoge los tenedores...\n" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Load register\n" +msgstr "/// Registro de cargas\n" -#: 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 "\"{} está comiendo...\"" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Control register\n" +msgstr "/// Registro de control\n" -#: 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 -#, fuzzy -msgid "\"Socrates\"" -msgstr "Crates HAL" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Interrupt Mask Set or Clear register\n" +msgstr "/// Interrumpe Mask Set o Clear register\n" -#: 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 "\"Hipatia\"" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Raw Interrupt Status\n" +msgstr "/// Estado de interrupción sin procesar\n" -#: 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 "\"Platón\"" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Masked Interrupt Status\n" +msgstr "/// Estado de interrupción enmascarada\n" -#: 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 "\"Aristóteles\"" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Interrupt Clear Register\n" +msgstr "/// Interrumpir registro de limpieza\n" -#: 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 "\"Pitágoras\"" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Driver for a PL031 real-time clock.\n" +msgstr "/// Controlador para un reloj en tiempo real PL031.\n" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Create forks\n" -msgstr "// Crea tenedores\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 "" +"/// Crea una instancia nueva del controlador RTC para un dispositivo PL031 " +"en la\n" +" /// dirección base proporcionada.\n" +" ///\n" +" /// # Seguridad\n" +" ///\n" +" /// El objeto la dirección base debe apuntar a los registros de control " +"MMIO de un dispositivo\n" +" /// PL031, que debe asignarse al espacio de direcciones del proceso\n" +" /// como memoria del dispositivo y no tener ningún otro alias.\n" -#: src/exercises/concurrency/dining-philosophers.md -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Create philosophers\n" -msgstr "// Crea filósofos\n" +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Reads the current RTC value.\n" +msgstr "/// Lee el valor de RTC actual.\n" -#: src/exercises/concurrency/dining-philosophers.md -msgid "// Make each of them think and eat 100 times\n" -msgstr "// Haz que cada uno de ellos piense y coma 100 veces\n" - -#: 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 "// Expresa sus reflexiones\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 "" +"// Es seguro porque sabemos que self.registers apunta\n" +" // a los registros de control de un dispositivo PL031 que está " +"asignado correctamente.\n" -#: src/exercises/concurrency/dining-philosophers.md -msgid "You can use the following `Cargo.toml`:" -msgstr "Puedes usar el siguiente archivo `Cargo.toml`:" +#: 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 "" +"/// Escribe un valor de coincidencia. Cuando el valor de RTC coincida, se " +"generará una interrupción\n" +" /// (si está habilitada).\n" -#: src/exercises/concurrency/dining-philosophers.md +#: src/exercises/bare-metal/solutions-afternoon.md msgid "" -"```toml\n" -"[package]\n" -"name = \"dining-philosophers\"\n" -"version = \"0.1.0\"\n" -"edition = \"2021\"\n" -"```" +"/// Returns whether the match register matches the RTC value, whether or " +"not\n" +" /// the interrupt is enabled.\n" msgstr "" -"```toml\n" -"[package]\n" -"name = \"dining-philosophers\"\n" -"version = \"0.1.0\"\n" -"edition = \"2021\"\n" -"```" +"/// Devuelve en función de si el registro de coincidencias coincide con el " +"valor de RTC,\n" +" /// si la interrupción está habilitada o no.\n" -#: src/exercises/concurrency/link-checker.md +#: src/exercises/bare-metal/solutions-afternoon.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." +"/// 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 "" -"Utilicemos nuestros nuevos conocimientos para crear un comprobador de " -"enlaces multihilo. Debería empezar en una página web y comprobar que los " -"enlaces de la página son válidos. Debería consultar otras páginas del mismo " -"dominio y seguir haciéndolo hasta que todas las páginas se hayan validado." +"/// Devuelve si hay una interrupción pendiente.\n" +" ///\n" +" /// Solo debe ser true si `matched` devuelve true y\n" +" /// la interrupción está enmascarada.\n" -#: src/exercises/concurrency/link-checker.md +#: src/exercises/bare-metal/solutions-afternoon.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:" +"/// 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 "" -"Para ello, necesitarás un cliente HTTP como [`reqwest`](https://docs.rs/" -"reqwest/). Crea un proyecto de Cargo y aplica `reqwest` como una dependencia " -"con:" +"/// Define o borra la máscara de interrupción.\n" +" ///\n" +" /// Si la máscara es true, se habilita la interrupción; Si es false,\n" +" /// se inhabilita la interrupción.\n" + +#: src/exercises/bare-metal/solutions-afternoon.md +msgid "/// Clears a pending interrupt, if any.\n" +msgstr "/// Borra una interrupción pendiente, si la hubiera.\n" -#: src/exercises/concurrency/link-checker.md +#: src/exercises/bare-metal/solutions-afternoon.md +#, fuzzy msgid "" -"If `cargo add` fails with `error: no such subcommand`, then please edit the " -"`Cargo.toml` file by hand. Add the dependencies listed below." +"// SAFETY: `Rtc` just contains a pointer to device memory, which can be\n" +"// accessed from any context.\n" msgstr "" -"Si `cargo add` da `error: no such subcommand`, edita el archivo `Cargo.toml` " -"de forma manual. Añade las dependencias que se indican más abajo." +"// Es seguro porque solo contiene un puntero a la memoria del dispositivo,\n" +"// a la que se puede acceder desde cualquier contexto.\n" + +#: src/concurrency/welcome.md +msgid "Welcome to Concurrency in Rust" +msgstr "Te Damos la Bienvenida a Concurrencia en Rust" -#: src/exercises/concurrency/link-checker.md +#: src/concurrency/welcome.md msgid "" -"You will also need a way to find links. We can use [`scraper`](https://docs." -"rs/scraper/) for that:" +"Rust has full support for concurrency using OS threads with mutexes and " +"channels." msgstr "" -"También necesitarás una forma de encontrar enlaces. Podemos usar [`scraper`]" -"(https://docs.rs/scraper/) para eso:" +"Rust es totalmente compatible con la concurrencia mediante hilos del SO con " +"exclusiones mutuas y canales." -#: src/exercises/concurrency/link-checker.md +#: src/concurrency/welcome.md msgid "" -"Finally, we'll need some way of handling errors. We use [`thiserror`]" -"(https://docs.rs/thiserror/) for that:" +"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 "" -"Por último, necesitaremos algún método para gestionar los errores. Para " -"ello, usaremos [`thiserror`](https://docs.rs/thiserror/):" +"El sistema de tipos de Rust desempeña un papel importante al hacer que " +"muchos errores de concurrencia sean errores en tiempo de compilación. A " +"menudo, esto se conoce como _concurrencia sin miedo_, ya que puedes confiar " +"en el compilador para asegurar la corrección en el tiempo de ejecución." -#: src/exercises/concurrency/link-checker.md +#: src/concurrency/welcome.md src/concurrency/welcome-async.md +#, fuzzy msgid "" -"The `cargo add` calls will update the `Cargo.toml` file to look like this:" +"Including 10 minute breaks, this session should take about 3 hours and 20 " +"minutes. It contains:" msgstr "" -"Las llamadas a `cargo add` actualizarán el archivo `Cargo.toml` para que " -"tenga este aspecto:" +"Contando con los descansos de 10 minutos, la duración prevista de la sesión " +"es de unas 2 horas y 20 minutos." -#: src/exercises/concurrency/link-checker.md +#: src/concurrency/welcome.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" -"```" +"Rust lets us access OS concurrency toolkit: threads, sync. primitives, etc." 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" -"```" -#: src/exercises/concurrency/link-checker.md +#: src/concurrency/welcome.md msgid "" -"You can now download the start page. Try with a small site such as `https://" -"www.google.org/`." +"The type system gives us safety for concurrency without any special features." msgstr "" -"Ya puedes descargar la página de inicio. Prueba con un sitio pequeño, como " -"`https://www.google.org/`." -#: src/exercises/concurrency/link-checker.md -msgid "Your `src/main.rs` file should look something like this:" -msgstr "El archivo `src/main.rs` debería tener un aspecto similar a este:" +#: 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/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"request error: {0}\"" -msgstr "\"Error de solicitud: {0}\"" +#: 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 "Esta sección tiene una duración aproximada de 20 minutos." -#: src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"bad http response: {0}\"" -msgstr "\"respuesta HTTP incorrecta: {0}\"" +#: src/concurrency/threads/plain.md +msgid "Rust threads work similarly to threads in other languages:" +msgstr "Los hilos de Rust funcionan de forma similar a los de otros lenguajes:" -#: src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"Checking {:#}\"" -msgstr "\"Comprobando {:#}\"" +#: src/concurrency/threads/plain.md +msgid "\"Count in thread: {i}!\"" +msgstr "\"Recuento en el hilo: {i}!\"" -#: src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"href\"" -msgstr "\"href\"" +#: src/concurrency/threads/plain.md +msgid "\"Main thread: {i}\"" +msgstr "\"Hilo principal: {i}\"" -#: src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"On {base_url:#}: ignored unparsable {href:?}: {err}\"" -msgstr "\"En {base_url:#}: {href:?} ignorado, no se puede analizar: {err}\"" +#: src/concurrency/threads/plain.md +msgid "Threads are all daemon threads, the main thread does not wait for them." +msgstr "" +"Los hilos son todos hilos daemon, y el hilo principal no espera por ellos." -#: src/exercises/concurrency/link-checker.md -#: src/exercises/concurrency/solutions-morning.md -msgid "\"https://www.google.org\"" -msgstr "\"https://www.google.org\"" +#: src/concurrency/threads/plain.md +msgid "Thread panics are independent of each other." +msgstr "Los pánicos de los hilos son independientes entre sí." -#: src/exercises/concurrency/link-checker.md -msgid "\"Links: {links:#?}\"" -msgstr "\"Enlaces: {links:#?}\"" +#: src/concurrency/threads/plain.md +msgid "Panics can carry a payload, which can be unpacked with `downcast_ref`." +msgstr "" +"Los pánicos pueden transportar una carga útil, que se puede desempaquetar " +"con `downcast_ref`." -#: src/exercises/concurrency/link-checker.md -msgid "\"Could not extract links: {err:#}\"" -msgstr "\"No se han podido extraer los enlaces: {err:#}\"" +#: src/concurrency/threads/plain.md +msgid "Rust thread APIs look not too different from e.g. C++ ones." +msgstr "" -#: src/exercises/concurrency/link-checker.md -msgid "Run the code in `src/main.rs` with" -msgstr "Ejecuta el código en `src/main.rs` con" +#: src/concurrency/threads/plain.md +#, fuzzy +msgid "Run the example." +msgstr "Ejecuta el ejemplo con:" -#: src/exercises/concurrency/link-checker.md +#: src/concurrency/threads/plain.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." +"5ms timing is loose enough that main and spawned threads stay mostly in " +"lockstep." msgstr "" -"Comprueba los enlaces en paralelo con los hilos: envía las URLs que se van a " -"comprobar a un canal y deja que varios hilos comprueben las URLs en paralelo." -#: 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." +#: src/concurrency/threads/plain.md +msgid "Notice that the program ends before the spawned thread reaches 10!" msgstr "" -"Amplía esta opción para extraer enlaces de todas las páginas del dominio " -"`www.google.org`. Define un límite máximo de 100 páginas para que el sitio " -"no te bloquee." - -#: src/exercises/concurrency/solutions-morning.md -msgid "Concurrency Morning Exercise" -msgstr "Concurrencia: Ejercicios de la Mañana" - -#: src/exercises/concurrency/solutions-morning.md -msgid "([back to exercise](dining-philosophers.md))" -msgstr "([volver al ejercicio](dining-philosophers.md))" - -#: src/exercises/concurrency/solutions-morning.md -msgid "\"{} is trying to eat\"" -msgstr "\"{} está intentando comer\"" -#: src/exercises/concurrency/solutions-morning.md +#: src/concurrency/threads/plain.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" +"This is because main ends the program and spawned threads do not make it " +"persist." msgstr "" -"// Para evitar un interbloqueo, tenemos que romper la simetría\n" -" // en algún lugar. De este modo, se cambiarán los tenedores sin " -"desinicializar\n" -" // ninguno de ellos.\n" - -#: src/exercises/concurrency/solutions-morning.md -msgid "\"{thought}\"" -msgstr "\"{thought}\"" -#: src/exercises/concurrency/solutions-morning.md -msgid "Link Checker" -msgstr "Comprobador de Enlaces" +#: src/concurrency/threads/plain.md +msgid "Compare to pthreads/C++ std::thread/boost::thread if desired." +msgstr "" -#: src/exercises/concurrency/solutions-morning.md -msgid "([back to exercise](link-checker.md))" -msgstr "([volver al ejercicio](link-checker.md))" +#: src/concurrency/threads/plain.md +msgid "How do we wait around for the spawned thread to complete?" +msgstr "" -#: src/exercises/concurrency/solutions-morning.md +#: src/concurrency/threads/plain.md +#, fuzzy msgid "" -"/// Determine whether links within the given page should be extracted.\n" -msgstr "/// Determina si se deben extraer los enlaces de la página indicada.\n" +"[`thread::spawn`](https://doc.rust-lang.org/std/thread/fn.spawn.html) " +"returns a `JoinHandle`. Look at the docs." +msgstr "" +"[`Default`](https://doc.rust-lang.org/std/default/trait.Default.html) se usa " +"para construir una instancia predeterminada de un tipo." -#: src/exercises/concurrency/solutions-morning.md +#: src/concurrency/threads/plain.md msgid "" -"/// Mark the given page as visited, returning false if it had already\n" -" /// been visited.\n" +"`JoinHandle` has a [`.join()`](https://doc.rust-lang.org/std/thread/struct." +"JoinHandle.html#method.join) method that blocks." msgstr "" -"/// Marca la página indicada como visitada y devuelve false si ya se había\n" -" /// visitado anteriormente.\n" - -#: src/exercises/concurrency/solutions-morning.md -msgid "// The sender got dropped. No more commands coming in.\n" -msgstr "// Se ha descartado el remitente. No se enviarán más comandos.\n" - -#: src/exercises/concurrency/solutions-morning.md -msgid "\"Got crawling error: {:#}\"" -msgstr "\"Se ha producido un error de rastreo: {:#}\"" -#: src/exercises/concurrency/solutions-morning.md -msgid "\"Bad URLs: {:#?}\"" -msgstr "\"URLs incorrectas: {:#?}\"" +#: 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 "" +"Utiliza `let handle = thread::spawn(...)` y, después, `handle.join()` para " +"esperar a que el hilo termine." -#: src/async.md -msgid "Async Rust" -msgstr "Async en Rust" +#: src/concurrency/threads/plain.md +msgid "Now what if we want to return a value?" +msgstr "" -#: 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." +#: src/concurrency/threads/plain.md +msgid "Look at docs again:" msgstr "" -"\"Async\" es un modelo de concurrencia en el que se ejecutan varias tareas " -"al mismo tiempo. Se ejecuta cada una de ellas hasta que se bloquea y, a " -"continuación, se cambia a otra tarea que está lista para progresar. El " -"modelo permite ejecutar un mayor número de tareas en un número limitado de " -"hilos. Esto se debe a que la sobrecarga por tarea suele ser muy baja y los " -"sistemas operativos proporcionan primitivos para identificar de forma " -"eficiente las E/S que pueden continuar." -#: src/async.md +#: src/concurrency/threads/plain.md +#, fuzzy 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." +"[`thread::spawn`](https://doc.rust-lang.org/std/thread/fn.spawn.html)'s " +"closure returns `T`" msgstr "" -"La operación asíncrona de Rust se basa en \"valores futuros\", que " -"representan el trabajo que puede completarse más adelante. Los futuros se " -"\"sondean\" hasta que indican que se han completado." +"Sin embargo, puedes usar un [hilo con ámbito](https://doc.rust-lang.org/std/" +"thread/fn.scope.html) para lo siguiente:" -#: src/async.md +#: src/concurrency/threads/plain.md msgid "" -"Futures are polled by an async runtime, and several different runtimes are " -"available." +"`JoinHandle` [`.join()`](https://doc.rust-lang.org/std/thread/struct." +"JoinHandle.html#method.join) returns `thread::Result`" msgstr "" -"Los futuros se sondean mediante un tiempo de ejecución asíncrono y hay " -"disponibles varios tiempos de ejecución diferentes." -#: src/async.md +#: src/concurrency/threads/plain.md +#, fuzzy 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." +"Use the `Result` return value from `handle.join()` to get access to the " +"returned value." msgstr "" -"Python tiene un modelo similar en su `asyncio`. Sin embargo, su tipo " -"`Future` está basado en retrollamadas y no se sondea. Los programas " -"asíncronos de Python requieren un \"bucle\", similar a un tiempo de " -"ejecución en Rust." +"Usa el valor devuelto `Result` de `handle.join.()` para acceder a la carga " +"útil del pánico. Este es un buen momento para hablar sobre [`Any`](https://" +"doc.rust-lang.org/std/any/index.html)." -#: 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." +#: src/concurrency/threads/plain.md +msgid "Ok, what about the other case?" msgstr "" -"`Promise` de JavaScript es parecido, pero también se basa en retrollamadas. " -"El tiempo de ejecución del lenguaje implementa el bucle de eventos, por lo " -"que muchos de los detalles de la resolución de Promise están ocultos." -#: src/async/async-await.md +#: src/concurrency/threads/plain.md +#, fuzzy +msgid "Trigger a panic in the thread. Note that this doesn't panic `main`." +msgstr "Activa un pánico en el hilo y observa cómo esto no afecta a `main`." + +#: src/concurrency/threads/plain.md +#, fuzzy msgid "" -"At a high level, async Rust code looks very much like \"normal\" sequential " -"code:" +"Access the panic payload. This is a good time to talk about [`Any`](https://" +"doc.rust-lang.org/std/any/index.html)." msgstr "" -"En general, el código asíncrono de Rust se parece mucho al código secuencial " -"\"normal\":" +"Usa el valor devuelto `Result` de `handle.join.()` para acceder a la carga " +"útil del pánico. Este es un buen momento para hablar sobre [`Any`](https://" +"doc.rust-lang.org/std/any/index.html)." -#: src/async/async-await.md -msgid "\"Count is: {i}!\"" -msgstr "\"El recuento es: ¡{i}!\"" +#: src/concurrency/threads/plain.md +msgid "Now we can return values from threads! What about taking inputs?" +msgstr "" -#: 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!" +#: src/concurrency/threads/plain.md +msgid "Capture something by reference in the thread closure." msgstr "" -"Ten en cuenta que este es un ejemplo simplificado para mostrar la sintaxis. " -"No hay ninguna operación de larga duración ni concurrencia real." -#: src/async/async-await.md -msgid "What is the return type of an async call?" -msgstr "¿Cuál es el tipo de resultado devuelto de una llamada asíncrona?" +#: src/concurrency/threads/plain.md +msgid "An error message indicates we must move it." +msgstr "" -#: src/async/async-await.md -msgid "Use `let future: () = async_main(10);` in `main` to see the type." -msgstr "Consulta el tipo con `let future: () = async_main(10);` en `main` ." +#: src/concurrency/threads/plain.md +msgid "Move it in, see we can compute and then return a derived value." +msgstr "" -#: src/async/async-await.md -#, fuzzy +#: src/concurrency/threads/plain.md +msgid "If we want to borrow?" +msgstr "" + +#: src/concurrency/threads/plain.md msgid "" -"The \"async\" keyword is syntactic sugar. The compiler replaces the return " -"type with a future." +"Main kills child threads when it returns, but another function would just " +"return and leave them running." msgstr "" -"La palabra clave \"async\" es azúcar sintáctico. El compilador sustituye el " -"tipo de resultado devuelto por un futuro. " -#: src/async/async-await.md +#: 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 "Los hilos normales no pueden tomar nada prestado de su entorno:" + +#: src/concurrency/threads/scoped.md msgid "" -"You cannot make `main` async, without additional instructions to the " -"compiler on how to use the returned future." +"However, you can use a [scoped thread](https://doc.rust-lang.org/std/thread/" +"fn.scope.html) for this:" msgstr "" -"No se puede hacer que `main` sea asíncrono sin dar instrucciones adicionales " -"al compilador sobre cómo usar el futuro devuelto." +"Sin embargo, puedes usar un [hilo con ámbito](https://doc.rust-lang.org/std/" +"thread/fn.scope.html) para lo siguiente:" -#: src/async/async-await.md -#, fuzzy +#: src/concurrency/threads/scoped.md msgid "" -"You need an executor to run async code. `block_on` blocks the current thread " -"until the provided future has run to completion." +"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 "" -"Se necesita un ejecutor para ejecutar el código asíncrono. `block_on` " -"bloquea el hilo hasta que se complete el futuro proporcionado. " +"La razón es que, cuando se completa la función `thread::scope`, se asegura " +"que todos los hilos están unidos, por lo que pueden devolver datos prestados." -#: src/async/async-await.md +#: src/concurrency/threads/scoped.md msgid "" -"`.await` asynchronously waits for the completion of another operation. " -"Unlike `block_on`, `.await` doesn't block the current thread." +"Normal Rust borrowing rules apply: you can either borrow mutably by one " +"thread, or immutably by any number of threads." msgstr "" -"`.await` espera de forma asíncrona la finalización de otra operación. A " -"diferencia de `block_on`, `.await` no bloquea el hilo." +"Se aplican las reglas normales de préstamo de Rust: un hilo puede tomar " +"datos prestados de manera mutable o cualquier número de hilos puede tomar " +"datos prestados de manera inmutable." -#: src/async/async-await.md +#: src/concurrency/channels.md src/concurrency/async-control-flow.md #, fuzzy +msgid "This segment should take about 20 minutes. It contains:" +msgstr "Esta sección tiene una duración aproximada de 20 minutos." + +#: src/concurrency/channels/senders-receivers.md msgid "" -"`.await` can only be used inside an `async` function (or block; these are " -"introduced later)." +"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 "" -"`.await` solo se puede usar dentro de una función `async` (o bloqueo; estos " -"se verán más tarde). " +"Los canales de Rust tienen dos partes: `Sender` y `Receiver`. Las dos " +"partes están conectadas a través del canal, pero solo se ven los puntos " +"finales." + +#: src/concurrency/channels/senders-receivers.md +msgid "\"Received: {:?}\"" +msgstr "\"Recibido: {:?}\"" -#: src/async/futures.md +#: src/concurrency/channels/senders-receivers.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)." +"`mpsc` stands for Multi-Producer, Single-Consumer. `Sender` and `SyncSender` " +"implement `Clone` (so you can make multiple producers) but `Receiver` does " +"not." msgstr "" -"[`Future`](https://doc.rust-lang.org/std/future/trait.Future.html) es un " -"trait implementado por objetos que representan una operación que puede que " -"aún no se haya completado. Se puede sondear un futuro y `poll` devuelve un " -"[`Poll`](https://doc.rust-lang.org/std/task/enum.Poll.html)." +"`mpsc` son las siglas de Multi-Producer, Single-Consumer (multiproductor, " +"consumidor único.) `Sender` y `SyncSender` implementan `Clone` (es decir, " +"puedes crear varios productores), pero `Receiver` no." -#: src/async/futures.md +#: src/concurrency/channels/senders-receivers.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." +"`send()` and `recv()` return `Result`. If they return `Err`, it means the " +"counterpart `Sender` or `Receiver` is dropped and the channel is closed." msgstr "" -"Una función asíncrona devuelve `impl Future`. También es posible (aunque no " -"es habitual) implementar `Future` para tus propios tipos. Por ejemplo, el " -"`JoinHandle` devuelto por `tokio::spawn` implementa `Future` para permitir " -"que se una a él." +"`send()` y `recv()` devuelven `Result`. Si devuelven `Err`, significa que el " +"homólogo `Sender` o `Receiver` se ha eliminado y el canal se ha cerrado." + +#: src/concurrency/channels/unbounded.md +msgid "You get an unbounded and asynchronous channel with `mpsc::channel()`:" +msgstr "Se obtiene un canal asíncrono y sin límites con `mpsc::channel()`:" + +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md +msgid "\"Message {i}\"" +msgstr "\"Mensaje {i}\"" + +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md +msgid "\"{thread_id:?}: sent Message {i}\"" +msgstr "\"{thread_id:?}: mensaje enviado {i}\"" + +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md +msgid "\"{thread_id:?}: done\"" +msgstr "\"{thread_id:?}: completado\"" + +#: src/concurrency/channels/unbounded.md src/concurrency/channels/bounded.md +msgid "\"Main: got {msg}\"" +msgstr "\"Principal: ha recibido {msg}\"" + +#: src/concurrency/channels/bounded.md +msgid "" +"With bounded (synchronous) channels, `send` can block the current thread:" +msgstr "Con canales limitados (síncronos), `send` puede bloquear el hilo:" -#: src/async/futures.md +#: src/concurrency/channels/bounded.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." +"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 "" -"La palabra clave `.await`, aplicada a un futuro, provoca que la función " -"asíncrona se detenga hasta que dicho futuro esté listo y, a continuación, se " -"evalúa su salida." +"Al llamar a `send`, se bloqueará el hilo hasta que haya espacio suficiente " +"en el canal para el mensaje nuevo. El hilo se puede bloquear de forma " +"indefinida si no hay nadie que lea el canal." -#: src/async/futures.md +#: src/concurrency/channels/bounded.md msgid "" -"The `Future` and `Poll` types are implemented exactly as shown; click the " -"links to show the implementations in the docs." +"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 "" -"Los tipos `Future` y `Polll` se implementan exactamente como se indica. Haz " -"clic en los enlaces para mostrar las implementaciones en los documentos." +"Si se cierra el canal, se anulará la llamada a `send` y se producirá un " +"error (por eso devuelve `Result`). Un canal se cierra cuando se elimina el " +"receptor." -#: src/async/futures.md +#: src/concurrency/channels/bounded.md +#, fuzzy msgid "" -"We will not get to `Pin` and `Context`, as we will focus on writing async " -"code, rather than building new async primitives. Briefly:" +"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 "" -"No trataremos `Pin` ni `Context`, ya que nos centraremos en escribir código " -"asíncrono en lugar de compilar nuevos primitivos asíncronos. Brevemente:" +"Un canal delimitado con un tamaño de cero se denomina \"canal rendezvous\". " +"Cada envío bloqueará el hilo actual hasta que otro hilo llame a `read`." + +#: src/concurrency/send-sync.md +msgid "Send" +msgstr "Send" + +#: src/concurrency/send-sync.md +msgid "Sync" +msgstr "Sync" -#: src/async/futures.md +#: src/concurrency/send-sync/marker-traits.md +#, fuzzy msgid "" -"`Context` allows a Future to schedule itself to be polled again when an " -"event occurs." +"How does Rust know to forbid shared access across threads? The answer is in " +"two traits:" msgstr "" -"`Context` permite que un futuro se programe a sí mismo para que se vuelva a " -"sondear cuando se produzca un evento." +"¿Cómo sabe Rust que debe prohibir el acceso compartido entre hilos? La " +"respuesta está en dos traits:" -#: src/async/futures.md +#: src/concurrency/send-sync/marker-traits.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`." +"[`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 "" -"`Pin` asegura que el futuro no se mueva en la memoria, de forma que los " -"punteros en ese futuro siguen siendo válidos. Esto es necesario para que las " -"referencias sigan siendo válidas después de `.await`." +"[`Send`](https://doc.rust-lang.org/std/marker/trait.Send.html): un tipo `T` " +"es `Send` si es seguro mover un `T` entre los límites de un hilo." -#: src/async/runtimes.md +#: src/concurrency/send-sync/marker-traits.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:" +"[`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 "" -"Un _runtime_ ofrece asistencia para realizar operaciones de forma asíncrona " -"(un _reactor_) y es responsable de ejecutar futuros (un _ejecutor_). Rust no " -"cuenta con un tiempo de ejecución \"integrado\", pero hay varias opciones " -"disponibles:" +"[`Sync`](https://doc.rust-lang.org/std/marker/trait.Sync.html): un tipo `T` " +"es `Sync` si es seguro mover un `&T` entre los límites de un hilo." -#: src/async/runtimes.md +#: src/concurrency/send-sync/marker-traits.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." +"`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 "" -"[Tokio](https://tokio.rs/): eficaz, con un ecosistema bien desarrollado de " -"funciones, como [Hyper](https://hyper.rs/) para HTTP o [Tonic](https://" -"github.com/hyperium/tonic) para usar gRPC." +"`Send` y `Sync` son [traits inseguros](../unsafe/unsafe-traits.md). El " +"compilador los derivará automáticamente a tus tipos siempre que solo " +"contengan los tipos `Send` y `Sync`. También puedes implementarlos de forma " +"manual cuando sepas que es válido." -#: src/async/runtimes.md +#: src/concurrency/send-sync/marker-traits.md msgid "" -"[async-std](https://async.rs/): aims to be a \"std for async\", and includes " -"a basic runtime in `async::task`." +"One can think of these traits as markers that the type has certain thread-" +"safety properties." msgstr "" -"[async-std](https://async.rs/): se trata de un \"std para async\" e incluye " -"un tiempo de ejecución básico en `async::task`." +"Se podría pensar en estos traits como marcadores que indican que el tipo " +"tiene ciertas propiedades de seguridad en hilos." -#: src/async/runtimes.md -msgid "[smol](https://docs.rs/smol/latest/smol/): simple and lightweight" -msgstr "[smol](https://docs.rs/smol/latest/smol/): sencillo y ligero." +#: src/concurrency/send-sync/marker-traits.md +msgid "They can be used in the generic constraints as normal traits." +msgstr "" +"Se pueden utilizar en las restricciones genéricas como traits normales." -#: src/async/runtimes.md +#: src/concurrency/send-sync/send.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." +"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 "" -"Varias aplicaciones de mayor tamaño tienen sus propios tiempos de ejecución. " -"Por ejemplo, [Fuchsia](https://fuchsia.googlesource.com/fuchsia/+/refs/heads/" -"main/src/lib/fuchsia-async/src/lib.rs) ya tiene uno." +"Un tipo `T` es [`Send`](https://doc.rust-lang.org/std/marker/trait.Send." +"html) si es seguro mover un valor `T` a otro hilo." -#: src/async/runtimes.md +#: src/concurrency/send-sync/send.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." +"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 "" -"Ten en cuenta que, de los tiempos de ejecución enumerados, el playground de " -"Rust solo admite Tokio. El playground tampoco permite ningún tipo de E/S, " -"por lo que la mayoría de elementos asíncronos interesantes no se pueden " -"ejecutar. en él." +"El efecto de mover la propiedad a otro hilo es que los _destructores_ se " +"ejecutarán en ese hilo. Por tanto, la cuestion es cuándo se puede asignar un " +"valor a un hilo y desasignarlo en otro." -#: src/async/runtimes.md +#: src/concurrency/send-sync/send.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." +"As an example, a connection to the SQLite library must only be accessed from " +"a single thread." msgstr "" -"Los futuros son \"inertes\", ya que no realizan ninguna acción (ni siquiera " -"iniciar una operación de E/S) a menos que haya un ejecutor que los sondee. " -"Muy diferente de las promesas de JavaScript, por ejemplo, que se ejecutan " -"hasta su finalización, aunque nunca se utilicen." +"Por ejemplo, solo se puede acceder a una conexión a la biblioteca SQLite " +"desde un único hilo." -#: src/async/runtimes/tokio.md -#, fuzzy -msgid "Tokio provides:" -msgstr "Tokio ofrece lo siguiente: " +#: 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 "" +"Un tipo `T` es [`Sync`](https://doc.rust-lang.org/std/marker/trait.Sync." +"html) si es seguro acceder a un valor `T` desde varios hilos al mismo tiempo." -#: src/async/runtimes/tokio.md -msgid "A multi-threaded runtime for executing asynchronous code." -msgstr "Un tiempo de ejecución multihilo para ejecutar código asíncrono." +#: src/concurrency/send-sync/sync.md +msgid "More precisely, the definition is:" +msgstr "En concreto, la definición es la siguiente:" -#: src/async/runtimes/tokio.md -msgid "An asynchronous version of the standard library." -msgstr "Una versión asíncrona de la biblioteca estándar." +#: src/concurrency/send-sync/sync.md +msgid "`T` is `Sync` if and only if `&T` is `Send`" +msgstr "`T` es `Sync` únicamente si `&T` es `Send`." -#: src/async/runtimes/tokio.md -msgid "A large ecosystem of libraries." -msgstr "Un amplio ecosistema de bibliotecas." +#: 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 "" +"Esta instrucción es, básicamente, una forma resumida de indicar que, si un " +"tipo es seguro para los hilos en uso compartido, también lo es para pasar " +"referencias de él a través de los hilos." -#: src/async/runtimes/tokio.md -msgid "\"Count in task: {i}!\"" -msgstr "\"Recuento en la tarea: {i}\"" +#: 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 "" +"Esto se debe a que, si el tipo es Sync, significa que se puede compartir " +"entre múltiples hilos sin el riesgo de que haya carreras de datos u otros " +"problemas de sincronización, por lo que es seguro moverlo a otro hilo. " +"También es seguro mover una referencia al tipo a otro hilo, ya que se puede " +"acceder de forma segura a los datos a los que hace referencia desde " +"cualquier hilo." -#: src/async/runtimes/tokio.md -msgid "\"Main task: {i}\"" -msgstr "\"Tarea principal: {i}\"" +#: src/concurrency/send-sync/examples.md +msgid "`Send + Sync`" +msgstr "`Send + Sync`" -#: src/async/runtimes/tokio.md -msgid "With the `tokio::main` macro we can now make `main` async." -msgstr "Con la macro `tokio::main`, podemos hacer que `main` sea asíncrono." +#: src/concurrency/send-sync/examples.md +msgid "Most types you come across are `Send + Sync`:" +msgstr "La mayoría de los tipos que encuentras son `Send + Sync`:" -#: src/async/runtimes/tokio.md -msgid "The `spawn` function creates a new, concurrent \"task\"." -msgstr "La función `spawn` crea una \"tarea\" simultánea." +#: src/concurrency/send-sync/examples.md +msgid "`i8`, `f32`, `bool`, `char`, `&str`, ..." +msgstr "`i8`, `f32`, `bool`, `char`, `&str`, etc." -#: src/async/runtimes/tokio.md -msgid "Note: `spawn` takes a `Future`, you don't call `.await` on `count_to`." -msgstr "" -"Nota: `spawn` utiliza un `Future`, no se llama a `.await` en `count_to`." +#: src/concurrency/send-sync/examples.md +msgid "`(T1, T2)`, `[T; N]`, `&[T]`, `struct { x: T }`, ..." +msgstr "`(T1, T2)`, `[T; N]`, `&[T]`, `struct { x: T }`, etc." -#: src/async/runtimes/tokio.md -msgid "**Further exploration:**" -msgstr "**Más información:**" +#: src/concurrency/send-sync/examples.md +msgid "`String`, `Option`, `Vec`, `Box`, ..." +msgstr "`String`, `Option`, `Vec`, `Box`, etc." -#: 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." +#: src/concurrency/send-sync/examples.md +msgid "`Arc`: Explicitly thread-safe via atomic reference count." msgstr "" -"¿Por qué `count_to` no suele llegar a 10? Se trata de un ejemplo de " -"cancelación asíncrona. `tokio::spawn` devuelve un controlador que puede " -"esperarse hasta que termine." +"`Arc`: explícitamente seguro para los hilos mediante el recuento atómico " +"de referencias." -#: src/async/runtimes/tokio.md -msgid "Try `count_to(10).await` instead of spawning." -msgstr "Prueba `count_to(10).await` en lugar de usar spawn." +#: src/concurrency/send-sync/examples.md +msgid "`Mutex`: Explicitly thread-safe via internal locking." +msgstr "" +"`Mutex`: explícitamente seguro para los hilos mediante bloqueo interno." -#: src/async/runtimes/tokio.md -msgid "Try awaiting the task returned from `tokio::spawn`." -msgstr "Intenta esperar a la correción de la tarea de `tokio::spawn`." +#: src/concurrency/send-sync/examples.md +#, fuzzy +msgid "`mpsc::Sender`: As of 1.72.0." +msgstr "`mpsc::Sender`" -#: src/async/tasks.md -msgid "Rust has a task system, which is a form of lightweight threading." -msgstr "Rust tiene un sistema de tareas, que es una forma de hilo ligero." +#: src/concurrency/send-sync/examples.md +msgid "`AtomicBool`, `AtomicU8`, ...: Uses special atomic instructions." +msgstr "" +"`AtomicBool`, `AtomicU8`, etc.: utiliza instrucciones atómicas especiales." -#: src/async/tasks.md +#: src/concurrency/send-sync/examples.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." +"The generic types are typically `Send + Sync` when the type parameters are " +"`Send + Sync`." msgstr "" -"Una tarea tiene un solo futuro de nivel superior que el ejecutor sondea para " -"hacer que progrese. El futuro puede tener uno o varios futuros anidados que " -"su método `poll` sondea, lo que se corresponde con una pila de llamadas. La " -"concurrencia dentro de una tarea es posible mediante el sondeo de varios " -"futuros secundarios , como una carrera de un temporizador y una operación de " -"E/S." +"Los tipos genéricos suelen ser `Send + Sync` cuando los parámetros del tipo " +"son `Send + Sync`." -#: src/async/tasks.md -msgid "\"127.0.0.1:0\"" -msgstr "\"127.0.0.1:0\"" +#: src/concurrency/send-sync/examples.md +msgid "`Send + !Sync`" +msgstr "`Send + !Sync`" -#: src/async/tasks.md -msgid "\"listening on port {}\"" -msgstr "\"escuchando en el puerto {}\"" +#: 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 "" +"Estos tipos se pueden mover a otros hilos, pero no son seguros para los " +"hilos. Normalmente, esto se debe a la mutabilidad interior:" -#: src/async/tasks.md -msgid "\"connection from {addr:?}\"" -msgstr "\"conexión de {addr:?}\"" +#: src/concurrency/send-sync/examples.md +msgid "`mpsc::Receiver`" +msgstr "`mpsc::Receiver`" -#: src/async/tasks.md -msgid "b\"Who are you?\\n\"" -msgstr "b\"¿Quién eres?\\n\"" +#: src/concurrency/send-sync/examples.md +msgid "`Cell`" +msgstr "`Cell`" -#: src/async/tasks.md -msgid "\"socket error\"" -msgstr "\"error de socket\"" +#: src/concurrency/send-sync/examples.md +msgid "`RefCell`" +msgstr "`RefCell`" -#: src/async/tasks.md -msgid "\"Thanks for dialing in, {name}!\\n\"" -msgstr "\"¡Gracias por llamar, {name}!\\n\"" +#: src/concurrency/send-sync/examples.md +msgid "`!Send + Sync`" +msgstr "`!Send + Sync`" -#: src/async/tasks.md src/async/control-flow/join.md +#: src/concurrency/send-sync/examples.md msgid "" -"Copy this example into your prepared `src/main.rs` and run it from there." +"These types are thread-safe, but they cannot be moved to another thread:" msgstr "" -"Copia este ejemplo en el archivo `src/main.rs` que has preparado y ejecútalo " -"desde ahí." +"Estos tipos son seguros para los hilos _(thread safe)_, pero no se pueden " +"mover a otro hilo:" -#: src/async/tasks.md +#: src/concurrency/send-sync/examples.md +#, fuzzy 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/)." +"`MutexGuard`: Uses OS level primitives which must be deallocated on " +"the thread which created them." msgstr "" -"Prueba a conectarte mediante una herramienta de conexión TCP como [nc]" -"(https://www.unix.com/man-page/linux/1/nc/) o [telnet](https://www.unix.com/" -"man-page/linux/1/telnet/)." +"`MutexGuard`: utiliza primitivos de nivel SO que se deben desasignar en " +"el hilo que los creó." -#: 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 "" -"Pide a los alumnos que vean cuál sería el estado del servidor de ejemplo con " -"algunos clientes conectados. ¿Qué tareas hay? ¿Cuáles son sus futuros?" +#: src/concurrency/send-sync/examples.md +msgid "`!Send + !Sync`" +msgstr "`!Send + !Sync`" -#: 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`." +#: src/concurrency/send-sync/examples.md +msgid "These types are not thread-safe and cannot be moved to other threads:" msgstr "" -"Esta es la primera vez que vemos un bloque `async`. Es similar a un cierre, " -"pero no acepta argumentos. Su valor devuelto es un futuro, similar a `async " -"fn`. " +"Estos tipos no son seguros para los hilos y no se pueden mover a otros hilos:" -#: src/async/tasks.md +#: src/concurrency/send-sync/examples.md msgid "" -"Refactor the async block into a function, and improve the error handling " -"using `?`." +"`Rc`: each `Rc` has a reference to an `RcBox`, which contains a non-" +"atomic reference count." msgstr "" -"Refactoriza el bloque asíncrono en una función y mejora la gestión de " -"errores con `?`." +"`Rc`: cada `Rc` tiene una referencia a un `RcBox`, que contiene un " +"recuento de referencias no atómico." -#: src/async/channels.md +#: src/concurrency/send-sync/examples.md msgid "" -"Several crates have support for asynchronous channels. For instance `tokio`:" -msgstr "Varios crates admiten canales asíncronos. Por ejemplo, `tokio`:" +"`*const T`, `*mut T`: Rust assumes raw pointers may have special concurrency " +"considerations." +msgstr "" +"`*const T`, `*mut T`: Rust asume que los punteros sin procesar pueden tener " +"consideraciones especiales de concurrencia." -#: src/async/channels.md -msgid "\"Received {count} pings so far.\"" -msgstr "\"Se han recibido {count} pings hasta el momento.\"" +#: src/concurrency/shared-state.md +msgid "Arc" +msgstr "Arc" -#: src/async/channels.md -msgid "\"ping_handler complete\"" -msgstr "\"ping_handler completo\"" +#: src/concurrency/shared-state.md +msgid "Mutex" +msgstr "Mutex" -#: src/async/channels.md -msgid "\"Failed to send ping.\"" -msgstr "\"No se ha podido enviar el ping.\"" +#: src/concurrency/shared-state/arc.md +msgid "" +"[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html) allows shared " +"read-only access via `Arc::clone`:" +msgstr "" +"[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html) permite el " +"acceso compartido de solo lectura a través de `Arc::clone`:" -#: src/async/channels.md -msgid "\"Sent {} pings so far.\"" -msgstr "\"Se han enviado {} pings hasta ahora.\"" +#: src/concurrency/shared-state/arc.md +msgid "\"{thread_id:?}: {v:?}\"" +msgstr "\"{thread_id:?}: {v:?}\"" -#: src/async/channels.md -msgid "\"Something went wrong in ping handler task.\"" -msgstr "\"Se ha producido un error en la tarea del controlador de ping.\"" +#: src/concurrency/shared-state/arc.md src/concurrency/shared-state/example.md +msgid "\"v: {v:?}\"" +msgstr "\"v: {v:?}\"" -#: src/async/channels.md -msgid "Change the channel size to `3` and see how it affects the execution." +#: src/concurrency/shared-state/arc.md +msgid "" +"`Arc` stands for \"Atomic Reference Counted\", a thread safe version of `Rc` " +"that uses atomic operations." msgstr "" -"Cambia el tamaño del canal a `3` y comprueba cómo afecta a la ejecución." +"`Arc` son las siglas de \"Atomic Reference Counted\" (recuento atómico de " +"referencias), una versión de `Rc` segura para los hilos que utiliza " +"operaciones atómicas." -#: src/async/channels.md +#: src/concurrency/shared-state/arc.md msgid "" -"Overall, the interface is similar to the `sync` channels as seen in the " -"[morning class](concurrency/channels.md)." -msgstr "" -"En general, la interfaz es similar a los canales `sync`, tal como se ha " -"visto ver en la [clase de la mañana](concurrency/channels.md)." - -#: src/async/channels.md -msgid "Try removing the `std::mem::drop` call. What happens? Why?" -msgstr "Prueba a quitar la llamada a `std::mem::drop`. ¿Qué sucede? ¿Por qué?" - -#: 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." +"`Arc` implements `Clone` whether or not `T` does. It implements `Send` " +"and `Sync` if and only if `T` implements them both." msgstr "" -"El crate [Flume](https://docs.rs/flume/latest/flume/) tiene canales que " -"implementan `sync` y `async`,`send` y `recv`. Esto puede resultar práctico " -"para aplicaciones complejas con tareas de E/S y tareas pesadas de " -"procesamiento de CPU." +"`Arc` implementa `Clone`, independientemente de si `T` lo hace o no. " +"Implementa `Send` y `Sync` si `T` implementa ambos." -#: src/async/channels.md +#: src/concurrency/shared-state/arc.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." +"`Arc::clone()` has the cost of atomic operations that get executed, but " +"after that the use of the `T` is free." msgstr "" -"Es preferible trabajar con canales `async` por la capacidad de combinarlos " -"con otros `future` para poder crear un flujo de control complejo." - -#: src/async/control-flow.md -msgid "Futures Control Flow" -msgstr "Flujo de Control de Futuros" +"`Arc::clone()` tiene el coste de las operaciones atómicas que se ejecutan; " +"después el uso de `T` es libre." -#: src/async/control-flow.md +#: src/concurrency/shared-state/arc.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." +"Beware of reference cycles, `Arc` does not use a garbage collector to detect " +"them." msgstr "" -"Los futuros pueden combinarse para producir gráficos de flujo de computación " -"simultáneos. Ya hemos visto tareas que funcionan como hilos de ejecución " -"independientes." - -#: src/async/control-flow.md -msgid "[Join](control-flow/join.md)" -msgstr "[Join](control-flow/join.md)" +"Hay que prestar atención a los ciclos de referencia, ya que `Arc` no usa un " +"recolector de memoria residual para detectarlos." -#: src/async/control-flow.md -msgid "[Select](control-flow/select.md)" -msgstr "[Select](control-flow/select.md)" +#: src/concurrency/shared-state/arc.md +msgid "`std::sync::Weak` can help." +msgstr "`std::sync::Weak` puede resultar útil." -#: src/async/control-flow/join.md +#: src/concurrency/shared-state/mutex.md +#, fuzzy 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." +"[`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)):" msgstr "" -"Una operación join espera hasta que todos los futuros estén listos y " -"devuelve una colección de sus resultados. Es similar a `Promise.all` en " -"JavaScript o `asyncio.gather` en Python." - -#: src/async/control-flow/join.md -msgid "\"https://google.com\"" -msgstr "\"https://google.com\"" - -#: src/async/control-flow/join.md -msgid "\"https://httpbin.org/ip\"" -msgstr "\"https://httpbin.org/ip\"" - -#: src/async/control-flow/join.md -msgid "\"https://play.rust-lang.org/\"" -msgstr "\"https://play.rust-lang.org/\"" +"[`Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html) asegura " +"la exclusión mutua _y_ permite un acceso mutable a `T` a través de una " +"interfaz de solo lectura:" -#: src/async/control-flow/join.md -msgid "\"BAD_URL\"" -msgstr "\"BAD_URL\"" +#: src/concurrency/shared-state/mutex.md +msgid "\"v: {:?}\"" +msgstr "\"v: {:?}\"" -#: src/async/control-flow/join.md +#: src/concurrency/shared-state/mutex.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`." +"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 "" -"En el caso de varios futuros de tipos distintos, puedes utilizar `std::" -"future::join!`, pero debes saber cuántos futuros tendrás en el tiempo de " -"compilación. Esto se encuentra actualmente en el crate `futures`, que pronto " -"se estabilizará en `std::future`." +"Fíjate en cómo tenemos una implementación general de [`impl Sync " +"for Mutex`](https://doc.rust-lang.org/std/sync/struct.Mutex.html#impl-" +"Sync-for-Mutex%3CT%3E)." -#: src/async/control-flow/join.md +#: src/concurrency/shared-state/mutex.md #, fuzzy msgid "" -"The risk of `join` is that one of the futures may never resolve, this would " -"cause your program to stall." +"`Mutex` in Rust looks like a collection with just one element --- the " +"protected data." msgstr "" -"El riesgo que supone 'join' es que puede que uno de los futuros no se " -"resuelva nunca, causando que el programa se bloquee. " +"`Mutex` en Rust parece una colección con un solo elemento: los datos " +"protegidos." -#: src/async/control-flow/join.md +#: src/concurrency/shared-state/mutex.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!`." +"It is not possible to forget to acquire the mutex before accessing the " +"protected data." msgstr "" -"También puedes combinar `join_all` con `join!`, por ejemplo, para unir todas " -"las solicitudes a un servicio HTTP, así como una consulta a la base de " -"datos. Prueba a añadir un tokio::time::sleep`al futuro mediante`futures::" -"join!`. No se trata de un tiempo de espera (para eso se requiere `select!`, " -"que se explica en el siguiente capítulo), sino que muestra `join!\\`." +"No es posible olvidarse de adquirir la exclusión mutua antes de acceder a " +"los datos protegidos." -#: src/async/control-flow/select.md +#: src/concurrency/shared-state/mutex.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)`." +"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 "" -"Una operación select espera hasta que un conjunto de futuros esté listo y " -"responde al resultado de ese futuro. En JavaScript, esto es similar a " -"`Promise.race`. En Python, se compara con `asyncio.wait(task_set, " -"return_when=asyncio.FIRST_COMPLETED)`." +"Puedes obtener un `&mut T` de `Mutex` mediante el bloqueo. El " +"`MutexGuard` asegura que `&mut T` no dure más tiempo que el bloqueo que se " +"ha aplicado." -#: src/async/control-flow/select.md -#, fuzzy +#: src/concurrency/shared-state/mutex.md 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." +"`Mutex` implements both `Send` and `Sync` iff (if and only if) `T` " +"implements `Send`." msgstr "" -"Al igual que en el caso de una instrucción _match_, el cuerpo de `select!` " -"tiene una serie de brazos, cada uno de los cuales tiene la forma `pattern = " -"future => statement`. Cuando `future` está listo, la instrucción se ejecuta " -"con las variables de `pattern` vinculadas al resultado de `future`." +"`Mutex` implementa tanto `Send` como `Sync` únicamente si `T` implementa " +"`Send`." -#: src/async/control-flow/select.md -msgid "\"Felix\"" -msgstr "\"Felix\"" +#: src/concurrency/shared-state/mutex.md +#, fuzzy +msgid "A read-write lock counterpart: `RwLock`." +msgstr "Un equivalente de bloqueo de lectura y escritura: `RwLock`." -#: src/async/control-flow/select.md -msgid "\"Failed to send cat.\"" -msgstr "\"No se ha podido enviar el gato.\"" +#: src/concurrency/shared-state/mutex.md +#, fuzzy +msgid "Why does `lock()` return a `Result`?" +msgstr "¿Por qué `lock()` devuelve un `Result`? " -#: src/async/control-flow/select.md -msgid "\"Rex\"" -msgstr "\"Rex\"" +#: 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 "" +"Si el hilo que contiene `Mutex` entra en pánico, `Mutex` se \"envenena\" " +"para indicar que los datos que protegía pueden estar en un estado " +"incoherente. Llamar a `lock()` en una exclusión mutua envenenada da el error " +"[`PoisonError`](https://doc.rust-lang.org/std/sync/struct.PoisonError.html). " +"Puedes llamar a `into_inner()` en el error para recuperar los datos de todos " +"modos." -#: src/async/control-flow/select.md -msgid "\"Failed to send dog.\"" -msgstr "\"No se ha podido enviar el perro.\"" +#: src/concurrency/shared-state/example.md +msgid "Let us see `Arc` and `Mutex` in action:" +msgstr "Veamos cómo funcionan `Arc` y `Mutex`:" -#: src/async/control-flow/select.md -msgid "\"Failed to receive winner\"" -msgstr "\"No se ha podido recibir el ganador\"" +#: src/concurrency/shared-state/example.md +msgid "// use std::sync::{Arc, Mutex};\n" +msgstr "// usar std::sync::{Arc, Mutex};\n" -#: src/async/control-flow/select.md -msgid "\"Winner is {winner:?}\"" -msgstr "\"El ganador es {winner:?}\"" +#: src/concurrency/shared-state/example.md +msgid "Possible solution:" +msgstr "Solución posible:" + +#: src/concurrency/shared-state/example.md +msgid "Notable parts:" +msgstr "Puntos a destacar:" -#: src/async/control-flow/select.md +#: src/concurrency/shared-state/example.md 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." +"`v` is wrapped in both `Arc` and `Mutex`, because their concerns are " +"orthogonal." msgstr "" -"En este ejemplo, tenemos una carrera entre un gato y un perro. " -"`first_animal_to_finish_race` escucha a ambos canales y elige el que llegue " -"primero. Como el perro tarda 50 ms, gana al gato, que tarda 500 ms." +"`v` se envuelve tanto en `Arc` como en `Mutex`, porque sus preocupaciones " +"son ortogonales." -#: src/async/control-flow/select.md +#: src/concurrency/shared-state/example.md msgid "" -"You can use `oneshot` channels in this example as the channels are supposed " -"to receive only one `send`." +"Wrapping a `Mutex` in an `Arc` is a common pattern to share mutable state " +"between threads." msgstr "" -"En este ejemplo, puedes usar canales `oneshot`, ya que se supone que solo " -"recibirán un `send`." +"Envolver un `Mutex` en un `Arc` es un patrón habitual para compartir el " +"estado mutable entre hilos." -#: src/async/control-flow/select.md +#: src/concurrency/shared-state/example.md msgid "" -"Try adding a deadline to the race, demonstrating selecting different sorts " -"of futures." +"`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 "" -"Prueba a añadir un límite a la carrera y demuestra cómo se seleccionan " -"distintos tipos de futuros." +"`v: Arc<_>` se debe clonar como `v2` antes de poder moverlo a otro hilo. Ten " +"en cuenta que `move` se ha añadido a la firma lambda." -#: src/async/control-flow/select.md +#: src/concurrency/shared-state/example.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." +"Blocks are introduced to narrow the scope of the `LockGuard` as much as " +"possible." msgstr "" -"Ten en cuenta que `select!` elimina las ramas sin coincidencias, cancelando " -"así sus futuros. Es más fácil de usar cuando cada ejecución de `select!` " -"crea futuros." +"Se introducen bloqueos para limitar al máximo el ámbito de `LockGuard`." -#: 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." +#: src/concurrency/sync-exercises/dining-philosophers.md +msgid "The dining philosophers problem is a classic problem in concurrency:" msgstr "" -"También puedes enviar `&mut future` en lugar del futuro en sí, pero esto " -"podría provocar problemas, como se explica más adelante en la diapositiva " -"sobre pines." +"El problema de la cena de los filósofos es un problema clásico de " +"concurrencia:" -#: src/async/pitfalls.md -msgid "Pitfalls of async/await" -msgstr "Inconvenientes de async/await" +#: src/concurrency/sync-exercises/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 "" +"Cinco filósofos cenan juntos en la misma mesa. Cada filósofo tiene su propio " +"sitio en ella. Hay un tenedor entre cada plato. El plato que van a degustar " +"es una especie de espaguetis que hay que comer con dos tenedores. Los " +"filósofos solo pueden pensar y comer alternativamente. Además, solo pueden " +"comer sus espaguetis cuando disponen de un tenedor a la izquierda y otro a " +"la derecha. Por tanto, los dos tenedores solo estarán disponibles cuando su " +"dos vecinos más cercanos estén pensando y no comiendo. Cuando un filósofo " +"termina de comer, deja los dos tenedores en la mesa." -#: src/async/pitfalls.md +#: src/concurrency/sync-exercises/dining-philosophers.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:" +"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 "" -"Async/await ofrece una abstracción práctica y eficiente para la programación " -"asíncrona simultánea. Sin embargo, el modelo async/await de Rust también " -"viene acompañado de errores y footguns. En este capítulo veremos algunos de " -"ellos:" +"Para realizar este ejercicio necesitarás una \\[instalación local de " +"Cargo\\] (../../cargo/running-locally.md). Copia el fragmento de código que " +"aparece más abajo en un archivo denominado `src/main.rs`, rellena los " +"espacios en blanco y comprueba que `cargo run` no presenta interbloqueos:" -#: src/async/pitfalls.md -msgid "[Blocking the Executor](pitfalls/blocking-executor.md)" -msgstr "[Bloqueo del ejecutor](pitfalls/blocking-executor.md)" +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/dining-philosophers.md +msgid "" +"// left_fork: ...\n" +" // right_fork: ...\n" +" // thoughts: ...\n" +msgstr "" +"// left_fork: ...\n" +" // right_fork: ...\n" +" // thoughts: ...\n" -#: src/async/pitfalls.md -msgid "[Pin](pitfalls/pin.md)" -msgstr "[Pin](pitfalls/pin.md)" +#: 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! ¡{} tiene una nueva idea!\"" -#: src/async/pitfalls.md -msgid "[Async Traits](pitfalls/async-traits.md)" -msgstr "[Traits asíncronos](pitfalls/async-traits.md)" +#: src/concurrency/sync-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "// Pick up forks...\n" +msgstr "// Recoge los tenedores...\n" -#: src/async/pitfalls.md -msgid "[Cancellation](pitfalls/cancellation.md)" -msgstr "[Cancelación](pitfalls/cancellation.md)" +#: 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 "\"{} está comiendo...\"" -#: src/async/pitfalls/blocking-executor.md -msgid "Blocking the executor" -msgstr "Bloqueo del ejecutor" +#: 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 +#, fuzzy +msgid "\"Socrates\"" +msgstr "Crates HAL" -#: 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 "" -"La mayoría de los tiempos de ejecución asíncronos solo permiten que las " -"tareas de E/S se ejecuten de forma simultánea. Esto significa que las tareas " -"que bloquean la CPU bloquearán el ejecutor e impedirán que se ejecuten otras " -"tareas. Una solución alternativa y sencilla es utilizar métodos asíncronos " -"equivalentes siempre que sea posible." +#: 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 "\"Hipatia\"" -#: src/async/pitfalls/blocking-executor.md -msgid "\"future {id} slept for {duration_ms}ms, finished after {}ms\"" -msgstr "\"future {id} ha dormido {duration_ms} min, terminó después de {} ms\"" +#: 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 "\"Platón\"" -#: src/async/pitfalls/blocking-executor.md -msgid "\"current_thread\"" -msgstr "\"current_thread\"" +#: 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 "\"Aristóteles\"" -#: src/async/pitfalls/blocking-executor.md -msgid "" -"Run the code and see that the sleeps happen consecutively rather than " -"concurrently." -msgstr "" -"Ejecuta el código y comprueba que las suspensiones se producen de forma " -"consecutiva y no simultánea." +#: 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 "\"Pitágoras\"" -#: 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 "" -"La versión `\"current_thread\"` reúne todas las tareas en un solo hilo. Esto " -"consigue que el efecto sea más obvio, pero el error sigue estando presente " -"en la versión multihilo." +#: 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 "// Crea tenedores\n" -#: src/async/pitfalls/blocking-executor.md -msgid "" -"Switch the `std::thread::sleep` to `tokio::time::sleep` and await its result." -msgstr "" -"Cambia `std::thread::sleep` a `tokio::time::sleep`. y espera su resultado." +#: 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 "// Crea filósofos\n" + +#: src/concurrency/sync-exercises/dining-philosophers.md +msgid "// Make each of them think and eat 100 times\n" +msgstr "// Haz que cada uno de ellos piense y coma 100 veces\n" + +#: 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 "// Expresa sus reflexiones\n" + +#: src/concurrency/sync-exercises/dining-philosophers.md +msgid "You can use the following `Cargo.toml`:" +msgstr "Puedes usar el siguiente archivo `Cargo.toml`:" -#: src/async/pitfalls/blocking-executor.md +#: src/concurrency/sync-exercises/dining-philosophers.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." +"```toml\n" +"[package]\n" +"name = \"dining-philosophers\"\n" +"version = \"0.1.0\"\n" +"edition = \"2021\"\n" +"```" msgstr "" -"Otra solución sería `tokio::task::spawn_blocking`, que genera un hilo real y " -"transforma su controlador en un futuro sin bloquear el ejecutor." +"```toml\n" +"[package]\n" +"name = \"dining-philosophers\"\n" +"version = \"0.1.0\"\n" +"edition = \"2021\"\n" +"```" -#: src/async/pitfalls/blocking-executor.md +#: src/concurrency/sync-exercises/link-checker.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." +"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 "" -"No debes pensar en las tareas como hilos del sistema operativo. No se " -"asignan 1 a 1 y la mayoría de los ejecutores permitirán que se ejecuten " -"muchas tareas en un solo hilo del sistema operativo. Esta situación es " -"especialmente problemática cuando se interactúa con otras bibliotecas a " -"través de FFI, donde dicha biblioteca puede depender del almacenamiento " -"local de hilos o puede asignarse a hilos específicos del sistema operativo " -"(por ejemplo, CUDA). En estos casos es preferible usar `tokio::task::" -"spawn_blocking`." +"Utilicemos nuestros nuevos conocimientos para crear un comprobador de " +"enlaces multihilo. Debería empezar en una página web y comprobar que los " +"enlaces de la página son válidos. Debería consultar otras páginas del mismo " +"dominio y seguir haciéndolo hasta que todas las páginas se hayan validado." -#: src/async/pitfalls/blocking-executor.md +#: src/concurrency/sync-exercises/link-checker.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." +"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 "" -"Utiliza las exclusión mutuas de sincronización con cuidado. Si mantienes una " -"exclusión mutua sobre un `.await`, puede que se bloquee otra tarea y que " -"esta se esté ejecutando en el mismo hilo." -#: src/async/pitfalls/pin.md +#: src/concurrency/sync-exercises/link-checker.md +#, fuzzy +msgid "Create a new Cargo project and `reqwest` it as a dependency with:" +msgstr "Crea un proyecto de Cargo y añade las siguientes dependencias:" + +#: src/concurrency/sync-exercises/link-checker.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." +"If `cargo add` fails with `error: no such subcommand`, then please edit the " +"`Cargo.toml` file by hand. Add the dependencies listed below." msgstr "" -"Los bloques y las funciones asíncronos devuelven tipos que implementan el " -"trait `Future`. El tipo devuelto es el resultado de una transformación del " -"compilador que convierte las variables locales en datos almacenados en el " -"futuro." +"Si `cargo add` da `error: no such subcommand`, edita el archivo `Cargo.toml` " +"de forma manual. Añade las dependencias que se indican más abajo." -#: src/async/pitfalls/pin.md +#: src/concurrency/sync-exercises/link-checker.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." +"The `cargo add` calls will update the `Cargo.toml` file to look like this:" msgstr "" -"Algunas de estas variables pueden dirigir punteros a otras variables " -"locales. Por este motivo, el futuro nunca debería trasladarse a otra " -"ubicación de memoria, ya que esta acción invalidaría esos punteros." +"Las llamadas a `cargo add` actualizarán el archivo `Cargo.toml` para que " +"tenga este aspecto:" -#: src/async/pitfalls/pin.md +#: src/concurrency/sync-exercises/link-checker.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." +"```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 "" -"Para evitar que el tipo futuro se mueva en la memoria, solo se puede sondear " -"mediante un puntero fijado. `Pin` es un envoltorio que rodea a una " -"referencia y que no permite todas las operaciones que moverían la instancia " -"a la que apunta a otra ubicación de memoria." +"```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/async/pitfalls/pin.md +#: src/concurrency/sync-exercises/link-checker.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" +"You can now download the start page. Try with a small site such as `https://" +"www.google.org/`." msgstr "" -"// Un elemento de trabajo. En este caso, solo se duerme durante un tiempo " -"determinado y responde\n" -"// con un mensaje en el canal `respond_on`.\n" +"Ya puedes descargar la página de inicio. Prueba con un sitio pequeño, como " +"`https://www.google.org/`." -#: src/async/pitfalls/pin.md -msgid "// A worker which listens for work on a queue and performs it.\n" -msgstr "// Un trabajador que espera trabajo en una cola y lo ejecuta.\n" +#: src/concurrency/sync-exercises/link-checker.md +msgid "Your `src/main.rs` file should look something like this:" +msgstr "El archivo `src/main.rs` debería tener un aspecto similar a este:" -#: src/async/pitfalls/pin.md -msgid "// Pretend to work.\n" -msgstr "// Simula que trabaja.\n" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"request error: {0}\"" +msgstr "\"Error de solicitud: {0}\"" -#: src/async/pitfalls/pin.md -msgid "\"failed to send response\"" -msgstr "\"no se ha podido enviar la respuesta\"" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"bad http response: {0}\"" +msgstr "\"respuesta HTTP incorrecta: {0}\"" -#: src/async/pitfalls/pin.md -msgid "// TODO: report number of iterations every 100ms\n" -msgstr "// TODO: informar del número de iteraciones cada 100 ms\n" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"Checking {:#}\"" +msgstr "\"Comprobando {:#}\"" -#: src/async/pitfalls/pin.md -msgid "// A requester which requests work and waits for it to complete.\n" -msgstr "// Un solicitante que pide trabajo y espera a que se complete.\n" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"href\"" +msgstr "\"href\"" -#: src/async/pitfalls/pin.md -msgid "\"failed to send on work queue\"" -msgstr "\"no se ha podido enviar en la cola de trabajo\"" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"On {base_url:#}: ignored unparsable {href:?}: {err}\"" +msgstr "\"En {base_url:#}: {href:?} ignorado, no se puede analizar: {err}\"" -#: src/async/pitfalls/pin.md -msgid "\"failed waiting for response\"" -msgstr "\"no se ha podido esperar la respuesta\"" +#: src/concurrency/sync-exercises/link-checker.md +#: src/concurrency/sync-exercises/solutions.md +msgid "\"https://www.google.org\"" +msgstr "\"https://www.google.org\"" -#: src/async/pitfalls/pin.md -msgid "\"work result for iteration {i}: {resp}\"" -msgstr "\"resultado del trabajo de la iteración {i}: {resp}\"" +#: src/concurrency/sync-exercises/link-checker.md +msgid "\"Links: {links:#?}\"" +msgstr "\"Enlaces: {links:#?}\"" -#: 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 "" -"Puede que reconozcas esto como un ejemplo del patrón actor. Los actores " -"suelen llamar a `select!` en un bucle." +#: src/concurrency/sync-exercises/link-checker.md +msgid "\"Could not extract links: {err:#}\"" +msgstr "\"No se han podido extraer los enlaces: {err:#}\"" -#: src/async/pitfalls/pin.md +#: src/concurrency/sync-exercises/link-checker.md +msgid "Run the code in `src/main.rs` with" +msgstr "Ejecuta el código en `src/main.rs` con" + +#: src/concurrency/sync-exercises/link-checker.md msgid "" -"This serves as a summation of a few of the previous lessons, so take your " -"time with it." +"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 "" -"Esta sección es un resumen de algunas de las lecciones anteriores, así que " -"tómate tu tiempo ." +"Comprueba los enlaces en paralelo con los hilos: envía las URLs que se van a " +"comprobar a un canal y deja que varios hilos comprueben las URLs en paralelo." -#: src/async/pitfalls/pin.md +#: src/concurrency/sync-exercises/link-checker.md msgid "" -"Naively add a `_ = sleep(Duration::from_millis(100)) => { println!(..) }` to " -"the `select!`. This will never execute. Why?" +"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 "" -"Si añade un `_ = sleep(Duration::from_millis(100)) => { println!(..) }` a " -"`select!`, nunca se ejecutará. ¿Por qué?" +"Amplía esta opción para extraer enlaces de todas las páginas del dominio " +"`www.google.org`. Define un límite máximo de 100 páginas para que el sitio " +"no te bloquee." + +#: src/concurrency/sync-exercises/solutions.md +msgid "\"{} is trying to eat\"" +msgstr "\"{} está intentando comer\"" -#: src/async/pitfalls/pin.md +#: src/concurrency/sync-exercises/solutions.md msgid "" -"Instead, add a `timeout_fut` containing that future outside of the `loop`:" +"// 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 "" -"En su lugar, añade un `timeout_fut` que contenga ese futuro fuera de `loop`:" +"// Para evitar un interbloqueo, tenemos que romper la simetría\n" +" // en algún lugar. De este modo, se cambiarán los tenedores sin " +"desinicializar\n" +" // ninguno de ellos.\n" + +#: src/concurrency/sync-exercises/solutions.md +msgid "\"{thought}\"" +msgstr "\"{thought}\"" -#: src/async/pitfalls/pin.md +#: src/concurrency/sync-exercises/solutions.md +msgid "Link Checker" +msgstr "Comprobador de Enlaces" + +#: src/concurrency/sync-exercises/solutions.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 "" -"Continuará sin funcionar. Sigue los errores del compilador y añade `&mut` a " -"`timeout_fut` en `select!` para ir despejando el problema. A continuación, " -"usa `Box::pin`:" +"/// Determine whether links within the given page should be extracted.\n" +msgstr "/// Determina si se deben extraer los enlaces de la página indicada.\n" -#: src/async/pitfalls/pin.md +#: src/concurrency/sync-exercises/solutions.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." +"/// Mark the given page as visited, returning false if it had already\n" +" /// been visited.\n" msgstr "" -"Se puede compilar, pero una vez que vence el tiempo de espera, aparece " -"`Poll::Ready` en cada iteración (un futuro fusionado podría resultar útil). " -"Actualiza para restablecer `timeout_fut` cada vez que expire." +"/// Marca la página indicada como visitada y devuelve false si ya se había\n" +" /// visitado anteriormente.\n" + +#: src/concurrency/sync-exercises/solutions.md +msgid "// The sender got dropped. No more commands coming in.\n" +msgstr "// Se ha descartado el remitente. No se enviarán más comandos.\n" + +#: src/concurrency/sync-exercises/solutions.md +msgid "\"Got crawling error: {:#}\"" +msgstr "\"Se ha producido un error de rastreo: {:#}\"" + +#: src/concurrency/sync-exercises/solutions.md +msgid "\"Bad URLs: {:#?}\"" +msgstr "\"URLs incorrectas: {:#?}\"" -#: src/async/pitfalls/pin.md +#: src/concurrency/welcome-async.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." +"\"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 "" -"Box se asigna en el montículo. En algunos casos, `std::pin::pin!` (solo si " -"se ha estabilizado recientemente, con código antiguo que suele utilizar " -"`tokio::pin!`) también es una opción, pero difícil de utilizar en un futuro " -"que se reasigna." +"\"Async\" es un modelo de concurrencia en el que se ejecutan varias tareas " +"al mismo tiempo. Se ejecuta cada una de ellas hasta que se bloquea y, a " +"continuación, se cambia a otra tarea que está lista para progresar. El " +"modelo permite ejecutar un mayor número de tareas en un número limitado de " +"hilos. Esto se debe a que la sobrecarga por tarea suele ser muy baja y los " +"sistemas operativos proporcionan primitivos para identificar de forma " +"eficiente las E/S que pueden continuar." -#: src/async/pitfalls/pin.md +#: src/concurrency/welcome-async.md msgid "" -"Another alternative is to not use `pin` at all but spawn another task that " -"will send to a `oneshot` channel every 100ms." +"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 "" -"Otra alternativa es no utilizar `pin`, sino generar otra tarea que se " -"enviará a un canal de `oneshot` cada 100 ms." +"La operación asíncrona de Rust se basa en \"valores futuros\", que " +"representan el trabajo que puede completarse más adelante. Los futuros se " +"\"sondean\" hasta que indican que se han completado." -#: src/async/pitfalls/pin.md +#: src/concurrency/welcome-async.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." +"Futures are polled by an async runtime, and several different runtimes are " +"available." msgstr "" -"Los datos que contienen punteros a sí mismos se denominan autoreferenciales. " -"Normalmente, el verificador de préstamos de Rust evitaría que se movieran " -"los datos de autorreferencia, ya que las referencias no pueden tener una " -"duración mayor que la de los datos a los que apuntan. Sin embargo, el " -"verificador de préstamos no verifica la transformación del código de las " -"funciones y los bloques asíncronos." +"Los futuros se sondean mediante un tiempo de ejecución asíncrono y hay " +"disponibles varios tiempos de ejecución diferentes." -#: src/async/pitfalls/pin.md +#: src/concurrency/welcome-async.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." +"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 "" -"`Pin` es un envoltorio que rodea a una referencia. No se puede mover un " -"objeto desde su lugar mediante un puntero fijado. Sin embargo, sí se puede " -"mover mediante un puntero no fijado." +"Python tiene un modelo similar en su `asyncio`. Sin embargo, su tipo " +"`Future` está basado en retrollamadas y no se sondea. Los programas " +"asíncronos de Python requieren un \"bucle\", similar a un tiempo de " +"ejecución en Rust." -#: src/async/pitfalls/pin.md +#: src/concurrency/welcome-async.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." +"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 "" -"El método `poll` del trait `Future` utiliza `Pin<&mut Self>` en lugar de " -"`&mut Self` para hacer referencia a la instancia. Por eso solo se puede " -"llamar desde un puntero fijado." +"`Promise` de JavaScript es parecido, pero también se basa en retrollamadas. " +"El tiempo de ejecución del lenguaje implementa el bucle de eventos, por lo " +"que muchos de los detalles de la resolución de Promise están ocultos." -#: src/async/pitfalls/async-traits.md +#: src/concurrency/async.md +msgid "async/await" +msgstr "async / await" + +#: src/concurrency/async/async-await.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))" +"At a high level, async Rust code looks very much like \"normal\" sequential " +"code:" msgstr "" -"Los métodos asíncronos en traits todavía no son compatibles con el canal " -"estable. ([Existe una característica experimental en nightly que debería " -"estabilizarse a medio plazo.](https://blog.rust-lang.org/inside-" -"rust/2022/11/17/async-fn-in-trait-nightly.html))" +"En general, el código asíncrono de Rust se parece mucho al código secuencial " +"\"normal\":" + +#: src/concurrency/async/async-await.md +msgid "\"Count is: {i}!\"" +msgstr "\"El recuento es: ¡{i}!\"" -#: src/async/pitfalls/async-traits.md +#: src/concurrency/async/async-await.md msgid "" -"The crate [async_trait](https://docs.rs/async-trait/latest/async_trait/) " -"provides a workaround through a macro:" +"Note that this is a simplified example to show the syntax. There is no long " +"running operation or any real concurrency in it!" msgstr "" -"El crate [async_trait](https://docs.rs/async-trait/latest/async_trait/) " -"proporciona una solución mediante una macro:" +"Ten en cuenta que este es un ejemplo simplificado para mostrar la sintaxis. " +"No hay ninguna operación de larga duración ni concurrencia real." -#: src/async/pitfalls/async-traits.md -msgid "\"running all sleepers..\"" -msgstr "\"ejecutando todos los sleepers…\"." +#: src/concurrency/async/async-await.md +msgid "What is the return type of an async call?" +msgstr "¿Cuál es el tipo de resultado devuelto de una llamada asíncrona?" -#: src/async/pitfalls/async-traits.md -msgid "\"slept for {}ms\"" -msgstr "\"ha dormido {} ms\"" +#: src/concurrency/async/async-await.md +msgid "Use `let future: () = async_main(10);` in `main` to see the type." +msgstr "Consulta el tipo con `let future: () = async_main(10);` en `main` ." -#: src/async/pitfalls/async-traits.md +#: src/concurrency/async/async-await.md +#, fuzzy msgid "" -"`async_trait` is easy to use, but note that it's using heap allocations to " -"achieve this. This heap allocation has performance overhead." +"The \"async\" keyword is syntactic sugar. The compiler replaces the return " +"type with a future." msgstr "" -"`async_trait` es fácil de usar, pero ten en cuenta que utiliza asignaciones " -"de montículos para conseguirlo. Esta asignación de montículo tiene una " -"sobrecarga de rendimiento." +"La palabra clave \"async\" es azúcar sintáctico. El compilador sustituye el " +"tipo de resultado devuelto por un futuro. " -#: src/async/pitfalls/async-traits.md +#: src/concurrency/async/async-await.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." +"You cannot make `main` async, without additional instructions to the " +"compiler on how to use the returned future." msgstr "" -"Los problemas de compatibilidad del lenguaje con `async trait` son muy " -"complejos y no vale la pena describirlos en profundidad. Niko Matsakis lo " -"explica muy bien en [esta publicación](https://smallcultfollowing.com/" -"babysteps/blog/2019/10/26/async-fn-in-traits-are-hard/), por si te interesa " -"investigar más a fondo." +"No se puede hacer que `main` sea asíncrono sin dar instrucciones adicionales " +"al compilador sobre cómo usar el futuro devuelto." -#: src/async/pitfalls/async-traits.md +#: src/concurrency/async/async-await.md +#, fuzzy msgid "" -"Try creating a new sleeper struct that will sleep for a random amount of " -"time and adding it to the Vec." +"You need an executor to run async code. `block_on` blocks the current thread " +"until the provided future has run to completion." msgstr "" -"Prueba a crear una estructura que entre en suspensión durante un periodo " -"aleatorio y añádela a Vec." +"Se necesita un ejecutor para ejecutar el código asíncrono. `block_on` " +"bloquea el hilo hasta que se complete el futuro proporcionado. " -#: src/async/pitfalls/cancellation.md +#: src/concurrency/async/async-await.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." +"`.await` asynchronously waits for the completion of another operation. " +"Unlike `block_on`, `.await` doesn't block the current thread." msgstr "" -"Si eliminas un futuro, no se podrá volver a sondear. Este fenómeno se " -"denomina _cancelación_ y puede producirse en cualquier momento de `await`. " -"Hay que tener cuidado para asegurar que el sistema funcione correctamente, " -"incluso cuando se cancelen los futuros. Por ejemplo, no debería sufrir " -"interbloqueos o perder datos." +"`.await` espera de forma asíncrona la finalización de otra operación. A " +"diferencia de `block_on`, `.await` no bloquea el hilo." -#: src/async/pitfalls/cancellation.md +#: src/concurrency/async/async-await.md #, fuzzy -msgid "\"not UTF-8\"" -msgstr "UTF-8" - -#: src/async/pitfalls/cancellation.md -msgid "\"hi\\nthere\\n\"" -msgstr "\"hi\\nthere\\n\"" - -#: src/async/pitfalls/cancellation.md -msgid "\"tick!\"" -msgstr "\"tick!\"" - -#: 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." +"`.await` can only be used inside an `async` function (or block; these are " +"introduced later)." msgstr "" -"El compilador no ayuda con la seguridad de la cancelación. Debes leer la " -"documentación de la API y tener en cuenta el estado de tu `async fn`." +"`.await` solo se puede usar dentro de una función `async` (o bloqueo; estos " +"se verán más tarde). " -#: src/async/pitfalls/cancellation.md +#: src/concurrency/async/futures.md msgid "" -"Unlike `panic` and `?`, cancellation is part of normal control flow (vs " -"error-handling)." +"[`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 "" -"A diferencia de `panic` y `?`, la cancelación forma parte del flujo de " -"control normal (en contraposición a la gestión de errores)." - -#: src/async/pitfalls/cancellation.md -msgid "The example loses parts of the string." -msgstr "En el ejemplo se pierden partes de la cadena." +"[`Future`](https://doc.rust-lang.org/std/future/trait.Future.html) es un " +"trait implementado por objetos que representan una operación que puede que " +"aún no se haya completado. Se puede sondear un futuro y `poll` devuelve un " +"[`Poll`](https://doc.rust-lang.org/std/task/enum.Poll.html)." -#: src/async/pitfalls/cancellation.md +#: src/concurrency/async/futures.md msgid "" -"Whenever the `tick()` branch finishes first, `next()` and its `buf` are " -"dropped." +"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 "" -"Cuando la rama `tick()` termina primero, se eliminan `next()` y su `buf`." +"Una función asíncrona devuelve `impl Future`. También es posible (aunque no " +"es habitual) implementar `Future` para tus propios tipos. Por ejemplo, el " +"`JoinHandle` devuelto por `tokio::spawn` implementa `Future` para permitir " +"que se una a él." -#: src/async/pitfalls/cancellation.md +#: src/concurrency/async/futures.md msgid "" -"`LinesReader` can be made cancellation-safe by making `buf` part of the " -"struct:" +"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 "" -"`LinesReader` se puede configurar para que no se cancele marcando `buf` como " -"parte del _struct_:" - -#: src/async/pitfalls/cancellation.md -msgid "// prefix buf and bytes with self.\n" -msgstr "// prefijo buf y bytes con self.\n" +"La palabra clave `.await`, aplicada a un futuro, provoca que la función " +"asíncrona se detenga hasta que dicho futuro esté listo y, a continuación, se " +"evalúa su salida." -#: src/async/pitfalls/cancellation.md +#: src/concurrency/async/futures.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'." +"The `Future` and `Poll` types are implemented exactly as shown; click the " +"links to show the implementations in the docs." msgstr "" -"[`Interval::tick`](https://docs.rs/tokio/latest/tokio/time/struct.Interval." -"html#method.tick) es a prueba de cancelaciones, ya que registra si una marca " -"se ha 'entregado'." +"Los tipos `Future` y `Polll` se implementan exactamente como se indica. Haz " +"clic en los enlaces para mostrar las implementaciones en los documentos." -#: src/async/pitfalls/cancellation.md +#: src/concurrency/async/futures.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." +"We will not get to `Pin` and `Context`, as we will focus on writing async " +"code, rather than building new async primitives. Briefly:" msgstr "" -"[`AsyncReadExt::read`](https://docs.rs/tokio/latest/tokio/io/trait." -"AsyncReadExt.html#method.read) es a prueba de cancelaciones porque o " -"devuelve los datos o no los lee." +"No trataremos `Pin` ni `Context`, ya que nos centraremos en escribir código " +"asíncrono en lugar de compilar nuevos primitivos asíncronos. Brevemente:" -#: src/async/pitfalls/cancellation.md +#: src/concurrency/async/futures.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." +"`Context` allows a Future to schedule itself to be polled again when an " +"event occurs." msgstr "" -"[`AsyncBufReadExt::read_line`](https://docs.rs/tokio/latest/tokio/io/trait." -"AsyncBufReadExt.html#method.read_line) es similar al ejemplo y _no está_ " -"configurado a prueba de cancelaciones. Consulta su documentación para " -"obtener información detallada y alternativas." +"`Context` permite que un futuro se programe a sí mismo para que se vuelva a " +"sondear cuando se produzca un evento." -#: src/exercises/concurrency/afternoon.md +#: src/concurrency/async/futures.md msgid "" -"To practice your Async Rust skills, we have again two exercises for you:" +"`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 "" -"Para practicar tus habilidades con async de Rust, tenemos otros dos nuevos " -"ejercicios:" +"`Pin` asegura que el futuro no se mueva en la memoria, de forma que los " +"punteros en ese futuro siguen siendo válidos. Esto es necesario para que las " +"referencias sigan siendo válidas después de `.await`." -#: src/exercises/concurrency/afternoon.md +#: src/concurrency/async/runtimes.md msgid "" -"Dining philosophers: we already saw this problem in the morning. This time " -"you are going to implement it with Async Rust." +"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 "" -"La cena de los filósofos: ya hemos visto este problema por la mañana. Esta " -"vez vas a implementarlo con async de Rust." +"Un _runtime_ ofrece asistencia para realizar operaciones de forma asíncrona " +"(un _reactor_) y es responsable de ejecutar futuros (un _ejecutor_). Rust no " +"cuenta con un tiempo de ejecución \"integrado\", pero hay varias opciones " +"disponibles:" -#: src/exercises/concurrency/afternoon.md +#: src/concurrency/async/runtimes.md msgid "" -"A Broadcast Chat Application: this is a larger project that allows you " -"experiment with more advanced Async Rust features." -msgstr "" -"Una aplicación de chat de difusión: se trata de un proyecto más grande que " -"te permite experimentar con características más avanzadas de async de Rust." - -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "Dining Philosophers --- Async" -msgstr "La Cena de Filósofos --- Async" - -#: src/exercises/concurrency/dining-philosophers-async.md -msgid "" -"See [dining philosophers](dining-philosophers.md) for a description of the " -"problem." +"[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 "" -"Consulta la descripción del problema en la sección sobre [la cena de " -"filósofos](dining-philosophers.md)." +"[Tokio](https://tokio.rs/): eficaz, con un ecosistema bien desarrollado de " +"funciones, como [Hyper](https://hyper.rs/) para HTTP o [Tonic](https://" +"github.com/hyperium/tonic) para usar gRPC." -#: src/exercises/concurrency/dining-philosophers-async.md +#: src/concurrency/async/runtimes.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:" +"[async-std](https://async.rs/): aims to be a \"std for async\", and includes " +"a basic runtime in `async::task`." msgstr "" -"Como antes, necesitarás una [instalación local de Cargo](../../cargo/running-" -"locally.md) para realizar el ejercicio. Copia el fragmento de código que " -"aparece más abajo en un archivo denominado `src/main.rs`, rellena los " -"espacios en blanco y comprueba que `cargo run` no presenta interbloqueos:" +"[async-std](https://async.rs/): se trata de un \"std para async\" e incluye " +"un tiempo de ejecución básico en `async::task`." -#: src/exercises/concurrency/dining-philosophers-async.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Make them think and eat\n" -msgstr "// Hazles pensar y comer\n" +#: src/concurrency/async/runtimes.md +msgid "[smol](https://docs.rs/smol/latest/smol/): simple and lightweight" +msgstr "[smol](https://docs.rs/smol/latest/smol/): sencillo y ligero." -#: src/exercises/concurrency/dining-philosophers-async.md +#: src/concurrency/async/runtimes.md msgid "" -"Since this time you are using Async Rust, you'll need a `tokio` dependency. " -"You can use the following `Cargo.toml`:" +"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 "" -"Dado que esta vez usas async, necesitarás una dependencia `tokio`. Puedes " -"usar el siguiente `Cargo.toml`:" +"Varias aplicaciones de mayor tamaño tienen sus propios tiempos de ejecución. " +"Por ejemplo, [Fuchsia](https://fuchsia.googlesource.com/fuchsia/+/refs/heads/" +"main/src/lib/fuchsia-async/src/lib.rs) ya tiene uno." -#: src/exercises/concurrency/dining-philosophers-async.md +#: src/concurrency/async/runtimes.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" -"```" +"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 "" -"```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" -"```" +"Ten en cuenta que, de los tiempos de ejecución enumerados, el playground de " +"Rust solo admite Tokio. El playground tampoco permite ningún tipo de E/S, " +"por lo que la mayoría de elementos asíncronos interesantes no se pueden " +"ejecutar. en él." -#: src/exercises/concurrency/dining-philosophers-async.md +#: src/concurrency/async/runtimes.md msgid "" -"Also note that this time you have to use the `Mutex` and the `mpsc` module " -"from the `tokio` crate." +"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 "" -"Además, ten en cuenta que esta vez tienes que utilizar `Mutex` y el módulo " -"`mpsc` del crate `tokio`." +"Los futuros son \"inertes\", ya que no realizan ninguna acción (ni siquiera " +"iniciar una operación de E/S) a menos que haya un ejecutor que los sondee. " +"Muy diferente de las promesas de JavaScript, por ejemplo, que se ejecutan " +"hasta su finalización, aunque nunca se utilicen." -#: src/exercises/concurrency/dining-philosophers-async.md -msgid "Can you make your implementation single-threaded?" -msgstr "¿Puedes conseguir que tu implementación tenga un solo hilo? " +#: src/concurrency/async/runtimes/tokio.md +#, fuzzy +msgid "Tokio provides:" +msgstr "Tokio ofrece lo siguiente: " -#: 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." +#: src/concurrency/async/runtimes/tokio.md +msgid "A multi-threaded runtime for executing asynchronous code." +msgstr "Un tiempo de ejecución multihilo para ejecutar código asíncrono." + +#: src/concurrency/async/runtimes/tokio.md +msgid "An asynchronous version of the standard library." +msgstr "Una versión asíncrona de la biblioteca estándar." + +#: src/concurrency/async/runtimes/tokio.md +msgid "A large ecosystem of libraries." +msgstr "Un amplio ecosistema de bibliotecas." + +#: src/concurrency/async/runtimes/tokio.md +msgid "\"Count in task: {i}!\"" +msgstr "\"Recuento en la tarea: {i}\"" + +#: src/concurrency/async/runtimes/tokio.md +msgid "\"Main task: {i}\"" +msgstr "\"Tarea principal: {i}\"" + +#: src/concurrency/async/runtimes/tokio.md +msgid "With the `tokio::main` macro we can now make `main` async." +msgstr "Con la macro `tokio::main`, podemos hacer que `main` sea asíncrono." + +#: src/concurrency/async/runtimes/tokio.md +msgid "The `spawn` function creates a new, concurrent \"task\"." +msgstr "La función `spawn` crea una \"tarea\" simultánea." + +#: src/concurrency/async/runtimes/tokio.md +msgid "Note: `spawn` takes a `Future`, you don't call `.await` on `count_to`." msgstr "" -"En este ejercicio, queremos usar nuestros nuevos conocimientos para " -"implementar una aplicación de chat de difusión. Disponemos de un servidor de " -"chat al que los clientes se conectan y publican sus mensajes. El cliente lee " -"los mensajes de usuario de la entrada estándar y los envía al servidor. El " -"servidor del chat transmite cada mensaje que recibe a todos los clientes." +"Nota: `spawn` utiliza un `Future`, no se llama a `.await` en `count_to`." -#: src/exercises/concurrency/chat-app.md +#: src/concurrency/async/runtimes/tokio.md +msgid "**Further exploration:**" +msgstr "**Más información:**" + +#: src/concurrency/async/runtimes/tokio.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." +"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 "" -"Para ello, usaremos \\[un canal en abierto](https://docs.rs/tokio/latest/" -"tokio/sync/broadcast/fn.channel.html) en el servidor y [`tokio_websockets`]" -"(https://docs.rs/tokio-websockets/) para la comunicación entre el cliente y " -"el servidor." +"¿Por qué `count_to` no suele llegar a 10? Se trata de un ejemplo de " +"cancelación asíncrona. `tokio::spawn` devuelve un controlador que puede " +"esperarse hasta que termine." -#: src/exercises/concurrency/chat-app.md -msgid "Create a new Cargo project and add the following dependencies:" -msgstr "Crea un proyecto de Cargo y añade las siguientes dependencias:" +#: src/concurrency/async/runtimes/tokio.md +msgid "Try `count_to(10).await` instead of spawning." +msgstr "Prueba `count_to(10).await` en lugar de usar spawn." -#: src/exercises/concurrency/chat-app.md -msgid "_Cargo.toml_:" -msgstr "_Cargo.toml_:" +#: src/concurrency/async/runtimes/tokio.md +msgid "Try awaiting the task returned from `tokio::spawn`." +msgstr "Intenta esperar a la correción de la tarea de `tokio::spawn`." + +#: src/concurrency/async/tasks.md +msgid "Rust has a task system, which is a form of lightweight threading." +msgstr "Rust tiene un sistema de tareas, que es una forma de hilo ligero." -#: src/exercises/concurrency/chat-app.md +#: src/concurrency/async/tasks.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" -"```" +"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 "" -"```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" -"```" +"Una tarea tiene un solo futuro de nivel superior que el ejecutor sondea para " +"hacer que progrese. El futuro puede tener uno o varios futuros anidados que " +"su método `poll` sondea, lo que se corresponde con una pila de llamadas. La " +"concurrencia dentro de una tarea es posible mediante el sondeo de varios " +"futuros secundarios , como una carrera de un temporizador y una operación de " +"E/S." -#: src/exercises/concurrency/chat-app.md -msgid "The required APIs" -msgstr "Las APIs necesarias" +#: src/concurrency/async/tasks.md +msgid "\"127.0.0.1:0\"" +msgstr "\"127.0.0.1:0\"" + +#: src/concurrency/async/tasks.md +msgid "\"listening on port {}\"" +msgstr "\"escuchando en el puerto {}\"" + +#: src/concurrency/async/tasks.md +msgid "\"connection from {addr:?}\"" +msgstr "\"conexión de {addr:?}\"" + +#: src/concurrency/async/tasks.md +msgid "b\"Who are you?\\n\"" +msgstr "b\"¿Quién eres?\\n\"" + +#: src/concurrency/async/tasks.md +msgid "\"socket error\"" +msgstr "\"error de socket\"" + +#: src/concurrency/async/tasks.md +msgid "\"Thanks for dialing in, {name}!\\n\"" +msgstr "\"¡Gracias por llamar, {name}!\\n\"" -#: src/exercises/concurrency/chat-app.md +#: src/concurrency/async/tasks.md src/concurrency/async-control-flow/join.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." +"Copy this example into your prepared `src/main.rs` and run it from there." msgstr "" -"Necesitarás las siguientes funciones de `tokio` y [`tokio_websockets`]" -"(https://docs.rs/tokio-websockets/). Dedica unos minutos a familiarizarte " -"con la API. " +"Copia este ejemplo en el archivo `src/main.rs` que has preparado y ejecútalo " +"desde ahí." -#: src/exercises/concurrency/chat-app.md +#: src/concurrency/async/tasks.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." +"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 "" -"[StreamExt::next()](https://docs.rs/futures-util/0.3.28/futures_util/stream/" -"trait.StreamExt.html#method.next) implementado por `WebSocketStream`: " -"permite enviar mensajes de forma asíncrona a través de un flujo Websocket." +"Prueba a conectarte mediante una herramienta de conexión TCP como [nc]" +"(https://www.unix.com/man-page/linux/1/nc/) o [telnet](https://www.unix.com/" +"man-page/linux/1/telnet/)." -#: src/exercises/concurrency/chat-app.md +#: src/concurrency/async/tasks.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." +"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 "" -"[SinkExt::send()](https://docs.rs/futures-util/0.3.28/futures_util/sink/" -"trait.SinkExt.html#method.send) implementado por `WebsocketStream`: permite " -"enviar mensajes de forma asíncrona a través de un flujo Websocket." +"Pide a los alumnos que vean cuál sería el estado del servidor de ejemplo con " +"algunos clientes conectados. ¿Qué tareas hay? ¿Cuáles son sus futuros?" -#: src/exercises/concurrency/chat-app.md +#: src/concurrency/async/tasks.md +#, fuzzy 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." +"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 "" -"[Lines::next_line()](https://docs.rs/tokio/latest/tokio/io/struct.Lines." -"html#method.next_line): para la lectura asíncrona de mensajes de usuario de " -"la entrada estándar." +"Esta es la primera vez que vemos un bloque `async`. Es similar a un cierre, " +"pero no acepta argumentos. Su valor devuelto es un futuro, similar a `async " +"fn`. " -#: src/exercises/concurrency/chat-app.md +#: src/concurrency/async/tasks.md msgid "" -"[Sender::subscribe()](https://docs.rs/tokio/latest/tokio/sync/broadcast/" -"struct.Sender.html#method.subscribe): for subscribing to a broadcast channel." +"Refactor the async block into a function, and improve the error handling " +"using `?`." msgstr "" -"[Sender::subscribe()](https://docs.rs/tokio/latest/tokio/sync/broadcast/" -"struct.Sender.html#method.subscribe): para suscribirse a un canal en abierto." - -#: src/exercises/concurrency/chat-app.md -msgid "Two binaries" -msgstr "Dos binarios" +"Refactoriza el bloque asíncrono en una función y mejora la gestión de " +"errores con `?`." -#: src/exercises/concurrency/chat-app.md +#: src/concurrency/async-control-flow/channels.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 "" -"Normalmente, en un proyecto de Cargo, solo puedes tener un archivo binario y " -"un archivo `src/main.rs`. En este proyecto, se necesitan dos binarios, uno " -"para el cliente y otro para el servidor. Puedes convertirlos en dos " -"proyectos de Cargo independientes, pero los incluiremos en un solo proyecto " -"de Cargo con dos binarios. Para que funcione, el código del cliente y del " -"servidor deben aparecer en `src/bin` (consulta la [documentación](https://" -"doc.rust-lang.org/cargo/reference/cargo-targets.html#binaries)). " - -#: 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 "" -"Copia el fragmento de código del servidor y del cliente que aparecen más " -"abajo en `src/bin/server.rs` y `src/bin/client.rs`, respectivamente. Tu " -"tarea es completar estos archivos como se describe a continuación. " - -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -#, fuzzy -msgid "_src/bin/server.rs_:" -msgstr "`src/bin/server.rs`:" - -#: src/exercises/concurrency/chat-app.md -msgid "// TODO: For a hint, see the description of the task below.\n" -msgstr "" -"// TODO: Para obtener una pista, consulta la descripción de la tarea a " -"continuación.\n" - -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"127.0.0.1:2000\"" -msgstr "\"127.0.0.1:2000\"" - -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"listening on port 2000\"" -msgstr "\"escuchando en el puerto 2000\"" +"Several crates have support for asynchronous channels. For instance `tokio`:" +msgstr "Varios crates admiten canales asíncronos. Por ejemplo, `tokio`:" -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"New connection from {addr:?}\"" -msgstr "\"Nueva conexión de {addr:?}\"" +#: src/concurrency/async-control-flow/channels.md +msgid "\"Received {count} pings so far.\"" +msgstr "\"Se han recibido {count} pings hasta el momento.\"" -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Wrap the raw TCP stream into a websocket.\n" -msgstr "// Envuelve el flujo TCP sin procesar en un websocket.\n" +#: src/concurrency/async-control-flow/channels.md +msgid "\"ping_handler complete\"" +msgstr "\"ping_handler completo\"" -#: src/exercises/concurrency/chat-app.md -#: src/exercises/concurrency/solutions-afternoon.md -msgid "_src/bin/client.rs_:" -msgstr "_src/bin/client.rs_:" +#: src/concurrency/async-control-flow/channels.md +msgid "\"Failed to send ping.\"" +msgstr "\"No se ha podido enviar el ping.\"" -#: 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\"" +#: src/concurrency/async-control-flow/channels.md +msgid "\"Sent {} pings so far.\"" +msgstr "\"Se han enviado {} pings hasta ahora.\"" -#: src/exercises/concurrency/chat-app.md -msgid "Running the binaries" -msgstr "Ejecutar los binarios" +#: src/concurrency/async-control-flow/channels.md +msgid "\"Something went wrong in ping handler task.\"" +msgstr "\"Se ha producido un error en la tarea del controlador de ping.\"" -#: src/exercises/concurrency/chat-app.md -msgid "Run the server with:" -msgstr "Ejecuta el servidor con:" +#: src/concurrency/async-control-flow/channels.md +msgid "Change the channel size to `3` and see how it affects the execution." +msgstr "" +"Cambia el tamaño del canal a `3` y comprueba cómo afecta a la ejecución." -#: src/exercises/concurrency/chat-app.md -msgid "and the client with:" -msgstr "y el cliente con:" +#: src/concurrency/async-control-flow/channels.md +#, fuzzy +msgid "" +"Overall, the interface is similar to the `sync` channels as seen in the " +"[morning class](../channels.md)." +msgstr "" +"En general, la interfaz es similar a los canales `sync`, tal como se ha " +"visto ver en la [clase de la mañana](concurrency/channels.md)." -#: src/exercises/concurrency/chat-app.md -msgid "Implement the `handle_connection` function in `src/bin/server.rs`." -msgstr "Implementa la función `handle_connection` en `src/bin/server.rs`." +#: src/concurrency/async-control-flow/channels.md +msgid "Try removing the `std::mem::drop` call. What happens? Why?" +msgstr "Prueba a quitar la llamada a `std::mem::drop`. ¿Qué sucede? ¿Por qué?" -#: src/exercises/concurrency/chat-app.md +#: src/concurrency/async-control-flow/channels.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." +"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 "" -"Sugerencia: usa `tokio::select!` para realizar dos tareas simultáneamente en " -"un bucle continuo. Una tarea recibe mensajes del cliente y los transmite. La " -"otra envía los mensajes que recibe el servidor al cliente." - -#: src/exercises/concurrency/chat-app.md -msgid "Complete the main function in `src/bin/client.rs`." -msgstr "Completa la función principal en `src/bin/client.rs`." +"El crate [Flume](https://docs.rs/flume/latest/flume/) tiene canales que " +"implementan `sync` y `async`,`send` y `recv`. Esto puede resultar práctico " +"para aplicaciones complejas con tareas de E/S y tareas pesadas de " +"procesamiento de CPU." -#: src/exercises/concurrency/chat-app.md +#: src/concurrency/async-control-flow/channels.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." +"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 "" -"Sugerencia: al igual que antes, usa `tokio::select!` en un bucle continuo " -"para realizar dos tareas simultáneamente: (1) leer los mensajes del usuario " -"desde la entrada estándar y enviarlos al servidor, y (2) recibir mensajes " -"del servidor y mostrárselos al usuario." +"Es preferible trabajar con canales `async` por la capacidad de combinarlos " +"con otros `future` para poder crear un flujo de control complejo." -#: src/exercises/concurrency/chat-app.md +#: src/concurrency/async-control-flow/join.md msgid "" -"Optional: Once you are done, change the code to broadcast messages to all " -"clients, but the sender of the message." +"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 "" -"Opcional: cuando termines, cambia el código para difundir mensajes a todos " -"los clientes, excepto al remitente." +"Una operación join espera hasta que todos los futuros estén listos y " +"devuelve una colección de sus resultados. Es similar a `Promise.all` en " +"JavaScript o `asyncio.gather` en Python." -#: src/exercises/concurrency/solutions-afternoon.md -msgid "Concurrency Afternoon Exercise" -msgstr "Concurrencia: Ejercicios de la Tarde" +#: src/concurrency/async-control-flow/join.md +msgid "\"https://google.com\"" +msgstr "\"https://google.com\"" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "([back to exercise](dining-philosophers-async.md))" -msgstr "([volver al ejercicio](dining-philosophers-async.md))" +#: src/concurrency/async-control-flow/join.md +msgid "\"https://httpbin.org/ip\"" +msgstr "\"https://httpbin.org/ip\"" -#: 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 "" -"// Añade un retraso antes de elegir el segundo tenedor para permitir la " -"ejecución\n" -" // para transferir a otra tarea\n" +#: src/concurrency/async-control-flow/join.md +msgid "\"https://play.rust-lang.org/\"" +msgstr "\"https://play.rust-lang.org/\"" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// The locks are dropped here\n" -msgstr "// Los bloqueos se eliminan aquí\n" +#: src/concurrency/async-control-flow/join.md +msgid "\"BAD_URL\"" +msgstr "\"BAD_URL\"" -#: src/exercises/concurrency/solutions-afternoon.md +#: src/concurrency/async-control-flow/join.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" +"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 "" -"// Para evitar un interbloqueo, tenemos que romper la simetría\n" -" // en algún lugar. De este modo, se cambiarán los tenedores sin " -"desinicializar\n" -" // ninguno de ellos.\n" +"En el caso de varios futuros de tipos distintos, puedes utilizar `std::" +"future::join!`, pero debes saber cuántos futuros tendrás en el tiempo de " +"compilación. Esto se encuentra actualmente en el crate `futures`, que pronto " +"se estabilizará en `std::future`." -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// tx is dropped here, so we don't need to explicitly drop it later\n" +#: 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 "" -"// tx se elimina aquí, por lo que no tenemos que eliminarlo explícitamente " -"más tarde.\n" - -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"Here is a thought: {thought}\"" -msgstr "\"Aquí tienes una reflexión: {thought}\"" +"El riesgo que supone 'join' es que puede que uno de los futuros no se " +"resuelva nunca, causando que el programa se bloquee. " -#: src/exercises/concurrency/solutions-afternoon.md -msgid "([back to exercise](chat-app.md))" -msgstr "([volver al ejercicio](chat-app.md))" +#: src/concurrency/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 "" +"También puedes combinar `join_all` con `join!`, por ejemplo, para unir todas " +"las solicitudes a un servicio HTTP, así como una consulta a la base de " +"datos. Prueba a añadir un tokio::time::sleep`al futuro mediante`futures::" +"join!`. No se trata de un tiempo de espera (para eso se requiere `select!`, " +"que se explica en el siguiente capítulo), sino que muestra `join!\\`." -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"Welcome to chat! Type a message\"" -msgstr "\"Te damos la bienvenida al chat. Escribe un mensaje\"" +#: src/concurrency/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 "" +"Una operación select espera hasta que un conjunto de futuros esté listo y " +"responde al resultado de ese futuro. En JavaScript, esto es similar a " +"`Promise.race`. En Python, se compara con `asyncio.wait(task_set, " +"return_when=asyncio.FIRST_COMPLETED)`." -#: src/exercises/concurrency/solutions-afternoon.md +#: src/concurrency/async-control-flow/select.md #, fuzzy 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" +"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 "" -"Sugerencia: al igual que antes, usa `tokio::select!` en un bucle continuo " -"para realizar dos tareas simultáneamente: (1) leer los mensajes del usuario " -"desde la entrada estándar y enviarlos al servidor, y (2) recibir mensajes " -"del servidor y mostrárselos al usuario." +"Al igual que en el caso de una instrucción _match_, el cuerpo de `select!` " +"tiene una serie de brazos, cada uno de los cuales tiene la forma `pattern = " +"future => statement`. Cuando `future` está listo, la instrucción se ejecuta " +"con las variables de `pattern` vinculadas al resultado de `future`." -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"From client {addr:?} {text:?}\"" -msgstr "\"Del cliente {addr:?} {text:?}\"" +#: src/concurrency/async-control-flow/select.md +msgid "\"Felix\"" +msgstr "\"Felix\"" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "// Continuous loop for concurrently sending and receiving messages.\n" -msgstr "// Bucle continuo para enviar y recibir mensajes simultáneamente.\n" +#: src/concurrency/async-control-flow/select.md +msgid "\"Failed to send cat.\"" +msgstr "\"No se ha podido enviar el gato.\"" -#: src/exercises/concurrency/solutions-afternoon.md -msgid "\"From server: {}\"" -msgstr "\"Del servidor: {}\"" +#: src/concurrency/async-control-flow/select.md +msgid "\"Failed to send dog.\"" +msgstr "\"No se ha podido enviar el perro.\"" -#: src/thanks.md +#: src/concurrency/async-control-flow/select.md +msgid "\"Failed to receive winner\"" +msgstr "\"No se ha podido recibir el ganador\"" + +#: src/concurrency/async-control-flow/select.md +msgid "\"Winner is {winner:?}\"" +msgstr "\"El ganador es {winner:?}\"" + +#: src/concurrency/async-control-flow/select.md msgid "" -"_Thank you for taking Comprehensive Rust 🦀!_ We hope you enjoyed it and " -"that it was useful." +"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 "" -"_Gracias por realizar el curso Comprehensive Rust 🦀._ Esperamos que te haya " -"gustado y que te haya resultado útil." +"En este ejemplo, tenemos una carrera entre un gato y un perro. " +"`first_animal_to_finish_race` escucha a ambos canales y elige el que llegue " +"primero. Como el perro tarda 50 ms, gana al gato, que tarda 500 ms." -#: src/thanks.md +#: src/concurrency/async-control-flow/select.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." +"You can use `oneshot` channels in this example as the channels are supposed " +"to receive only one `send`." msgstr "" -"Nos lo hemos pasado muy bien preparando el curso. Sabemos que no es " -"perfecto, así que si has detectado algún error o tienes ideas para " -"mejorarlo, [ponte en contacto con nosotros en GitHub](https://github.com/" -"google/comprehensive-rust/discussions). Nos encantaría saber tu opinión." +"En este ejemplo, puedes usar canales `oneshot`, ya que se supone que solo " +"recibirán un `send`." -#: src/glossary.md +#: src/concurrency/async-control-flow/select.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." +"Try adding a deadline to the race, demonstrating selecting different sorts " +"of futures." msgstr "" -"A continuación, se incluye un glosario con el objetivo de ofrecer una breve " -"definición de algunos términos de Rust. En el caso de las traducciones, " -"también sirve para relacionar el término con el original en inglés." +"Prueba a añadir un límite a la carrera y demuestra cómo se seleccionan " +"distintos tipos de futuros." -#: src/glossary.md +#: src/concurrency/async-control-flow/select.md msgid "" -"allocate: \n" -"Dynamic memory allocation on [the heap](memory-management/stack-vs-heap.md)." +"Note that `select!` drops unmatched branches, which cancels their futures. " +"It is easiest to use when every execution of `select!` creates new futures." msgstr "" -"asignar: \n" -"Asignación dinámica de memoria en [el montículo](Memory-management/stack-vs-" -"heap.md)." +"Ten en cuenta que `select!` elimina las ramas sin coincidencias, cancelando " +"así sus futuros. Es más fácil de usar cuando cada ejecución de `select!` " +"crea futuros." -#: src/glossary.md +#: src/concurrency/async-control-flow/select.md msgid "" -"argument: \n" -"Information that is passed into a function or method." +"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 "" -"argumento: \n" -"Información que se transmite a una función o método." +"También puedes enviar `&mut future` en lugar del futuro en sí, pero esto " +"podría provocar problemas, como se explica más adelante en la diapositiva " +"sobre pines." -#: src/glossary.md +#: src/concurrency/async-pitfalls.md +#, fuzzy 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)." +"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 "" -"Rust Bare-metal: \n" -"desarrollo de Rust de bajo nivel, a menudo desplegado en un sistema sin " -"sistema operativo. Consulta [Bare-metal Rust](bare-metal.md)." +"Async/await ofrece una abstracción práctica y eficiente para la programación " +"asíncrona simultánea. Sin embargo, el modelo async/await de Rust también " +"viene acompañado de errores y footguns. En este capítulo veremos algunos de " +"ellos:" -#: src/glossary.md +#: src/concurrency/async-pitfalls.md +msgid "Pin" +msgstr "Fijar" + +#: src/concurrency/async-pitfalls/blocking-executor.md +msgid "Blocking the executor" +msgstr "Bloqueo del ejecutor" + +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"block: \n" -"See [Blocks](control-flow/blocks.md) and _scope_." +"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 "" -"bloque: \n" -"Consulta [bloques](control-flow/blocks.md) y _ámbito_." +"La mayoría de los tiempos de ejecución asíncronos solo permiten que las " +"tareas de E/S se ejecuten de forma simultánea. Esto significa que las tareas " +"que bloquean la CPU bloquearán el ejecutor e impedirán que se ejecuten otras " +"tareas. Una solución alternativa y sencilla es utilizar métodos asíncronos " +"equivalentes siempre que sea posible." -#: src/glossary.md +#: src/concurrency/async-pitfalls/blocking-executor.md +msgid "\"future {id} slept for {duration_ms}ms, finished after {}ms\"" +msgstr "\"future {id} ha dormido {duration_ms} min, terminó después de {} ms\"" + +#: src/concurrency/async-pitfalls/blocking-executor.md +msgid "\"current_thread\"" +msgstr "\"current_thread\"" + +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"borrow: \n" -"See [Borrowing](ownership/borrowing.md)." +"Run the code and see that the sleeps happen consecutively rather than " +"concurrently." msgstr "" -"borrow (_omar prestado_): \n" -"Consulta [Borrowing (Préstamos)](ownership/borrowing.md)." +"Ejecuta el código y comprueba que las suspensiones se producen de forma " +"consecutiva y no simultánea." -#: src/glossary.md +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"borrow checker: \n" -"The part of the Rust compiler which checks that all borrows are valid." +"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 "" -"borrow checker (_comprobador de préstamos_): \n" -"la parte del compilador de Rust que comprueba que todos los préstamos sean " -"válidos." +"La versión `\"current_thread\"` reúne todas las tareas en un solo hilo. Esto " +"consigue que el efecto sea más obvio, pero el error sigue estando presente " +"en la versión multihilo." -#: src/glossary.md +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"brace: \n" -"`{` and `}`. Also called _curly brace_, they delimit _blocks_." +"Switch the `std::thread::sleep` to `tokio::time::sleep` and await its result." msgstr "" -"llave: \n" -"`{` and `}`. Delimitan _bloques_." +"Cambia `std::thread::sleep` a `tokio::time::sleep`. y espera su resultado." -#: src/glossary.md +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"build: \n" -"The process of converting source code into executable code or a usable " -"program." +"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 "" -"compilar \n" -"El proceso de conversión de código fuente en código ejecutable o en un " -"programa utilizable." +"Otra solución sería `tokio::task::spawn_blocking`, que genera un hilo real y " +"transforma su controlador en un futuro sin bloquear el ejecutor." -#: src/glossary.md +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"call: \n" -"To invoke or execute a function or method." +"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 "" -"Llamar: \n" -"invocar o ejecutar una función o método." +"No debes pensar en las tareas como hilos del sistema operativo. No se " +"asignan 1 a 1 y la mayoría de los ejecutores permitirán que se ejecuten " +"muchas tareas en un solo hilo del sistema operativo. Esta situación es " +"especialmente problemática cuando se interactúa con otras bibliotecas a " +"través de FFI, donde dicha biblioteca puede depender del almacenamiento " +"local de hilos o puede asignarse a hilos específicos del sistema operativo " +"(por ejemplo, CUDA). En estos casos es preferible usar `tokio::task::" +"spawn_blocking`." -#: src/glossary.md +#: src/concurrency/async-pitfalls/blocking-executor.md msgid "" -"channel: \n" -"Used to safely pass messages [between threads](concurrency/channels.md)." +"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 "" -"Canal: \n" -"se utiliza para enviar mensajes [entre hilos](concurrency/channels.md) de " -"forma segura." +"Utiliza las exclusión mutuas de sincronización con cuidado. Si mantienes una " +"exclusión mutua sobre un `.await`, puede que se bloquee otra tarea y que " +"esta se esté ejecutando en el mismo hilo." -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"Comprehensive Rust 🦀: \n" -"The courses here are jointly called Comprehensive Rust 🦀." +"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 "" -"Comprehensive Rust 🦀: \n" -"el conjunto de cursos que se describen aquí se denomina Comprehensive Rust " -"🦀." +"Los bloques y las funciones asíncronos devuelven tipos que implementan el " +"trait `Future`. El tipo devuelto es el resultado de una transformación del " +"compilador que convierte las variables locales en datos almacenados en el " +"futuro." -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"concurrency: \n" -"The execution of multiple tasks or processes at the same time." +"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 "" -"Simultaneidad: \n" -"ejecución de varias tareas o procesos al mismo tiempo." +"Algunas de estas variables pueden dirigir punteros a otras variables " +"locales. Por este motivo, el futuro nunca debería trasladarse a otra " +"ubicación de memoria, ya que esta acción invalidaría esos punteros." -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"Concurrency in Rust: \n" -"See [Concurrency in Rust](concurrency.md)." +"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 "" -"Simultaneidad en Rust: \n" -"consulta [Simultaneidad en Rust](concurrency.md)." +"Para evitar que el tipo futuro se mueva en la memoria, solo se puede sondear " +"mediante un puntero fijado. `Pin` es un envoltorio que rodea a una " +"referencia y que no permite todas las operaciones que moverían la instancia " +"a la que apunta a otra ubicación de memoria." -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"constant: \n" -"A value that does not change during the execution of a program." +"// 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 "" -"Constante: \n" -" valor que no cambia durante la ejecución de un programa." +"// Un elemento de trabajo. En este caso, solo se duerme durante un tiempo " +"determinado y responde\n" +"// con un mensaje en el canal `respond_on`.\n" -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md +msgid "// A worker which listens for work on a queue and performs it.\n" +msgstr "// Un trabajador que espera trabajo en una cola y lo ejecuta.\n" + +#: src/concurrency/async-pitfalls/pin.md +msgid "// Pretend to work.\n" +msgstr "// Simula que trabaja.\n" + +#: src/concurrency/async-pitfalls/pin.md +msgid "\"failed to send response\"" +msgstr "\"no se ha podido enviar la respuesta\"" + +#: src/concurrency/async-pitfalls/pin.md +msgid "// TODO: report number of iterations every 100ms\n" +msgstr "// TODO: informar del número de iteraciones cada 100 ms\n" + +#: src/concurrency/async-pitfalls/pin.md +msgid "// A requester which requests work and waits for it to complete.\n" +msgstr "// Un solicitante que pide trabajo y espera a que se complete.\n" + +#: src/concurrency/async-pitfalls/pin.md +msgid "\"failed to send on work queue\"" +msgstr "\"no se ha podido enviar en la cola de trabajo\"" + +#: src/concurrency/async-pitfalls/pin.md +msgid "\"failed waiting for response\"" +msgstr "\"no se ha podido esperar la respuesta\"" + +#: src/concurrency/async-pitfalls/pin.md +msgid "\"work result for iteration {i}: {resp}\"" +msgstr "\"resultado del trabajo de la iteración {i}: {resp}\"" + +#: src/concurrency/async-pitfalls/pin.md msgid "" -"control flow: \n" -"The order in which the individual statements or instructions are executed in " -"a program." +"You may recognize this as an example of the actor pattern. Actors typically " +"call `select!` in a loop." msgstr "" -"Flujo de control: \n" -"el orden en el que se ejecutan las instrucciones individuales en un programa." +"Puede que reconozcas esto como un ejemplo del patrón actor. Los actores " +"suelen llamar a `select!` en un bucle." -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"crash: \n" -"An unexpected and unhandled failure or termination of a program." +"This serves as a summation of a few of the previous lessons, so take your " +"time with it." msgstr "" -"Fallo: \n" -"fallo o finalización de un programa de forma inesperada y sin gestionar." +"Esta sección es un resumen de algunas de las lecciones anteriores, así que " +"tómate tu tiempo ." -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"enumeration: \n" -"A data type that holds one of several named constants, possibly with an " -"associated tuple or struct." +"Naively add a `_ = sleep(Duration::from_millis(100)) => { println!(..) }` to " +"the `select!`. This will never execute. Why?" msgstr "" -"Enumeración: \n" -"tipo de dato que contiene una de varias constantes con nombre, posiblemente " -"con una tupla o estructura asociada." +"Si añade un `_ = sleep(Duration::from_millis(100)) => { println!(..) }` a " +"`select!`, nunca se ejecutará. ¿Por qué?" -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"error: \n" -"An unexpected condition or result that deviates from the expected behavior." +"Instead, add a `timeout_fut` containing that future outside of the `loop`:" msgstr "" -"Error: \n" -"condición o resultado inesperado que se desvía del comportamiento esperado." +"En su lugar, añade un `timeout_fut` que contenga ese futuro fuera de `loop`:" -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"error handling: \n" -"The process of managing and responding to errors that occur during program " -"execution." +"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 "" -"Gestión de errores: \n" -"el proceso de gestionar y responder a los errores que se producen durante la " -"ejecución del programa." +"Continuará sin funcionar. Sigue los errores del compilador y añade `&mut` a " +"`timeout_fut` en `select!` para ir despejando el problema. A continuación, " +"usa `Box::pin`:" -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md +#, fuzzy msgid "" -"exercise: \n" -"A task or problem designed to practice and test programming skills." +"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 "" -"Ejercicio: \n" -"una tarea o problema diseñado para practicar y poner a prueba las " -"habilidades de programación." +"Se puede compilar, pero una vez que vence el tiempo de espera, aparece " +"`Poll::Ready` en cada iteración (un futuro fusionado podría resultar útil). " +"Actualiza para restablecer `timeout_fut` cada vez que expire." -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"function: \n" -"A reusable block of code that performs a specific task." +"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 "" -"Función: \n" -"bloque de código reutilizable que lleva a cabo una tarea específica." +"Box se asigna en el montículo. En algunos casos, `std::pin::pin!` (solo si " +"se ha estabilizado recientemente, con código antiguo que suele utilizar " +"`tokio::pin!`) también es una opción, pero difícil de utilizar en un futuro " +"que se reasigna." -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"garbage collector: \n" -"A mechanism that automatically frees up memory occupied by objects that are " -"no longer in use." +"Another alternative is to not use `pin` at all but spawn another task that " +"will send to a `oneshot` channel every 100ms." msgstr "" -"Recolector de elementos no utilizados: \n" -"mecanismo que libera automáticamente la memoria que ocupan objetos que ya no " -"se utilizan." +"Otra alternativa es no utilizar `pin`, sino generar otra tarea que se " +"enviará a un canal de `oneshot` cada 100 ms." -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"generics: \n" -"A feature that allows writing code with placeholders for types, enabling " -"code reuse with different data types." +"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 "" -"Genéricos: \n" -"una función que permite escribir código con marcadores de posición para los " -"tipos, lo que permite reutilizar código con distintos tipos de datos." +"Los datos que contienen punteros a sí mismos se denominan autoreferenciales. " +"Normalmente, el verificador de préstamos de Rust evitaría que se movieran " +"los datos de autorreferencia, ya que las referencias no pueden tener una " +"duración mayor que la de los datos a los que apuntan. Sin embargo, el " +"verificador de préstamos no verifica la transformación del código de las " +"funciones y los bloques asíncronos." -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"immutable: \n" -"Unable to be changed after creation." +"`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 "" -"Inmutable: \n" -"que no se puede cambiar después de crearse." +"`Pin` es un envoltorio que rodea a una referencia. No se puede mover un " +"objeto desde su lugar mediante un puntero fijado. Sin embargo, sí se puede " +"mover mediante un puntero no fijado." -#: src/glossary.md +#: src/concurrency/async-pitfalls/pin.md msgid "" -"integration test: \n" -"A type of test that verifies the interactions between different parts or " -"components of a system." +"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 "" -"Prueba de integración: \n" -"tipo de prueba que verifica las interacciones entre diferentes partes o " -"componentes de un sistema." +"El método `poll` del trait `Future` utiliza `Pin<&mut Self>` en lugar de " +"`&mut Self` para hacer referencia a la instancia. Por eso solo se puede " +"llamar desde un puntero fijado." -#: src/glossary.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "" -"keyword: \n" -"A reserved word in a programming language that has a specific meaning and " -"cannot be used as an identifier." +"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 "" -"Palabra clave: \n" -"palabra reservada en un lenguaje de programación que tiene un significado " -"específico y que no se puede utilizar como identificador." -#: src/glossary.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "" -"library: \n" -"A collection of precompiled routines or code that can be used by programs." +"However, even with the native support today there are some pitfalls around " +"`async fn` and RPIT in traits:" msgstr "" -"Biblioteca: \n" -"una colección de rutinas o código precompilados que pueden utilizar los " -"programas." -#: src/glossary.md +#: src/concurrency/async-pitfalls/async-traits.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." +"Return-position impl Trait captures all in-scope lifetimes (so some patterns " +"of borrowing cannot be expressed)" msgstr "" -"Macro: \n" -"las macros de Rust se pueden reconocer por llevar `!` en el nombre. Las " -"macros se utilizan cuando las funciones normales no son suficientes. Un " -"ejemplo típico es `format!`, que utiliza un número variable de argumentos " -"que no es compatible con las funciones de Rust." -#: src/glossary.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "" -"`main` function: \n" -"Rust programs start executing with the `main` function." +"Traits whose methods use return-position `impl trait` or `async` are not " +"`dyn` compatible." msgstr "" -"Función `main`: \n" -"los programas de Rust empiezan a ejecutarse con la función `main`." -#: src/glossary.md +#: src/concurrency/async-pitfalls/async-traits.md +#, fuzzy msgid "" -"match: \n" -"A control flow construct in Rust that allows for pattern matching on the " -"value of an expression." +"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 "" -"Coincidencia: \n" -"construcción de flujo de control en Rust que permite la coincidencia de " -"patrones con el valor de una expresión." +"El crate [async_trait](https://docs.rs/async-trait/latest/async_trait/) " +"proporciona una solución mediante una macro:" -#: src/glossary.md +#: src/concurrency/async-pitfalls/async-traits.md +msgid "\"running all sleepers..\"" +msgstr "\"ejecutando todos los sleepers…\"." + +#: src/concurrency/async-pitfalls/async-traits.md +msgid "\"slept for {}ms\"" +msgstr "\"ha dormido {} ms\"" + +#: src/concurrency/async-pitfalls/async-traits.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." +"`async_trait` is easy to use, but note that it's using heap allocations to " +"achieve this. This heap allocation has performance overhead." msgstr "" -"Pérdida de memoria: \n" -"situación en la que un programa no libera memoria que ya no se necesita, lo " -"que provoca un aumento gradual en el uso de memoria." +"`async_trait` es fácil de usar, pero ten en cuenta que utiliza asignaciones " +"de montículos para conseguirlo. Esta asignación de montículo tiene una " +"sobrecarga de rendimiento." -#: src/glossary.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "" -"method: \n" -"A function associated with an object or a type in Rust." +"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 "" -"Método: \n" -"una función asociada a un objeto o a un tipo en Rust." +"Los problemas de compatibilidad del lenguaje con `async trait` son muy " +"complejos y no vale la pena describirlos en profundidad. Niko Matsakis lo " +"explica muy bien en [esta publicación](https://smallcultfollowing.com/" +"babysteps/blog/2019/10/26/async-fn-in-traits-are-hard/), por si te interesa " +"investigar más a fondo." -#: src/glossary.md +#: src/concurrency/async-pitfalls/async-traits.md msgid "" -"module: \n" -"A namespace that contains definitions, such as functions, types, or traits, " -"to organize code in Rust." +"Try creating a new sleeper struct that will sleep for a random amount of " +"time and adding it to the Vec." msgstr "" -"Módulo: \n" -"espacio de nombres que contiene definiciones, como funciones, tipos o " -"traits, para organizar el código en Rust." +"Prueba a crear una estructura que entre en suspensión durante un periodo " +"aleatorio y añádela a Vec." -#: src/glossary.md +#: src/concurrency/async-pitfalls/cancellation.md msgid "" -"move: \n" -"The transfer of ownership of a value from one variable to another in Rust." +"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 "" -"Mover: \n" -"la transferencia de la propiedad de un valor de una variable a otra en Rust." +"Si eliminas un futuro, no se podrá volver a sondear. Este fenómeno se " +"denomina _cancelación_ y puede producirse en cualquier momento de `await`. " +"Hay que tener cuidado para asegurar que el sistema funcione correctamente, " +"incluso cuando se cancelen los futuros. Por ejemplo, no debería sufrir " +"interbloqueos o perder datos." -#: src/glossary.md +#: src/concurrency/async-pitfalls/cancellation.md +#, fuzzy +msgid "\"not UTF-8\"" +msgstr "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 "" -"mutable: \n" -"A property in Rust that allows variables to be modified after they have been " -"declared." +"The compiler doesn't help with cancellation-safety. You need to read API " +"documentation and consider what state your `async fn` holds." msgstr "" -"Mutable: \n" -"una propiedad en Rust que permite que se modifiquen las variables después de " -"que se hayan declarado." +"El compilador no ayuda con la seguridad de la cancelación. Debes leer la " +"documentación de la API y tener en cuenta el estado de tu `async fn`." -#: src/glossary.md +#: src/concurrency/async-pitfalls/cancellation.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." +"Unlike `panic` and `?`, cancellation is part of normal control flow (vs " +"error-handling)." msgstr "" -"Propiedad: \n" -"el concepto de Rust que define qué parte del código es responsable de " -"gestionar la memoria asociada a un valor." +"A diferencia de `panic` y `?`, la cancelación forma parte del flujo de " +"control normal (en contraposición a la gestión de errores)." -#: src/glossary.md +#: src/concurrency/async-pitfalls/cancellation.md +msgid "The example loses parts of the string." +msgstr "En el ejemplo se pierden partes de la cadena." + +#: src/concurrency/async-pitfalls/cancellation.md msgid "" -"panic: \n" -"An unrecoverable error condition in Rust that results in the termination of " -"the program." +"Whenever the `tick()` branch finishes first, `next()` and its `buf` are " +"dropped." msgstr "" -"Pánico: \n" -"condición de error irrecuperable en Rust que provoca la finalización del " -"programa." +"Cuando la rama `tick()` termina primero, se eliminan `next()` y su `buf`." -#: src/glossary.md +#: src/concurrency/async-pitfalls/cancellation.md msgid "" -"parameter: \n" -"A value that is passed into a function or method when it is called." +"`LinesReader` can be made cancellation-safe by making `buf` part of the " +"struct:" msgstr "" -"Parámetro: \n" -" valor que se transfiere a una función o método cuando se llama." +"`LinesReader` se puede configurar para que no se cancele marcando `buf` como " +"parte del _struct_:" -#: src/glossary.md +#: src/concurrency/async-pitfalls/cancellation.md +msgid "// prefix buf and bytes with self.\n" +msgstr "// prefijo buf y bytes con self.\n" + +#: src/concurrency/async-pitfalls/cancellation.md msgid "" -"pattern: \n" -"A combination of values, literals, or structures that can be matched against " -"an expression in Rust." +"[`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 "" -"Patrón: \n" -"una combinación de valores, literales o estructuras que se pueden comparar " -"con una expresión de Rust." +"[`Interval::tick`](https://docs.rs/tokio/latest/tokio/time/struct.Interval." +"html#method.tick) es a prueba de cancelaciones, ya que registra si una marca " +"se ha 'entregado'." -#: src/glossary.md +#: src/concurrency/async-pitfalls/cancellation.md msgid "" -"payload: \n" -"The data or information carried by a message, event, or data structure." +"[`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 "" -"Carga útil: \n" -"los datos o la información que transporta un mensaje, evento o estructura de " -"datos." +"[`AsyncReadExt::read`](https://docs.rs/tokio/latest/tokio/io/trait." +"AsyncReadExt.html#method.read) es a prueba de cancelaciones porque o " +"devuelve los datos o no los lee." -#: src/glossary.md +#: src/concurrency/async-pitfalls/cancellation.md msgid "" -"program: \n" -"A set of instructions that a computer can execute to perform a specific task " -"or solve a particular problem." +"[`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 "" -"Programa: \n" -"conjunto de instrucciones que un ordenador puede ejecutar para llevar a cabo " -"una tarea específica o resolver un problema concreto." +"[`AsyncBufReadExt::read_line`](https://docs.rs/tokio/latest/tokio/io/trait." +"AsyncBufReadExt.html#method.read_line) es similar al ejemplo y _no está_ " +"configurado a prueba de cancelaciones. Consulta su documentación para " +"obtener información detallada y alternativas." -#: src/glossary.md +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "Dining Philosophers --- Async" +msgstr "La Cena de Filósofos --- Async" + +#: src/concurrency/async-exercises/dining-philosophers.md +#, fuzzy msgid "" -"programming language: \n" -"A formal system used to communicate instructions to a computer, such as Rust." +"See [dining philosophers](concurrency/sync-exercises/dining-philosophers.md) " +"for a description of the problem." msgstr "" -"Lenguaje de programación: \n" -"un sistema formal que se utiliza para comunicar instrucciones a un " -"ordenador, como Rust." +"Consulta la descripción del problema en la sección sobre [la cena de " +"filósofos](dining-philosophers.md)." -#: src/glossary.md +#: src/concurrency/async-exercises/dining-philosophers.md msgid "" -"receiver: \n" -"The first parameter in a Rust method that represents the instance on which " -"the method is called." +"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 "" -"Receptor: \n" -"el primer parámetro de un método de Rust que representa la instancia en la " -"que se llama al método." +"Como antes, necesitarás una [instalación local de Cargo](../../cargo/running-" +"locally.md) para realizar el ejercicio. Copia el fragmento de código que " +"aparece más abajo en un archivo denominado `src/main.rs`, rellena los " +"espacios en blanco y comprueba que `cargo run` no presenta interbloqueos:" -#: 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." +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "// Keep trying until we have both forks\n" msgstr "" -"Recuento de referencias: \n" -"técnica de gestión de la memoria en la que se hace un seguimiento del número " -"de referencias a un objeto y se desasigna cuando el recuento llega a cero." -#: src/glossary.md -msgid "" -"return: \n" -"A keyword in Rust used to indicate the value to be returned from a function." -msgstr "" -"Retorno: \n" -"una palabra clave de Rust que se utiliza para indicar el valor que se " -"devuelve de una función." +#: src/concurrency/async-exercises/dining-philosophers.md +#: src/concurrency/async-exercises/solutions.md +msgid "// Make them think and eat\n" +msgstr "// Hazles pensar y comer\n" -#: src/glossary.md +#: src/concurrency/async-exercises/dining-philosophers.md msgid "" -"Rust: \n" -"A systems programming language that focuses on safety, performance, and " -"concurrency." +"Since this time you are using Async Rust, you'll need a `tokio` dependency. " +"You can use the following `Cargo.toml`:" msgstr "" -"Rust: \n" -"lenguaje de programación de sistemas que se centra en la seguridad, el " -"rendimiento y la simultaneidad." +"Dado que esta vez usas async, necesitarás una dependencia `tokio`. Puedes " +"usar el siguiente `Cargo.toml`:" -#: src/glossary.md +#: src/concurrency/async-exercises/dining-philosophers.md msgid "" -"Rust Fundamentals: \n" -"Days 1 to 3 of this course." +"```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 "" -"Aspectos básicos de Rust: \n" -"contenido del día 1 al día 3 de este curso." +"```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/glossary.md +#: src/concurrency/async-exercises/dining-philosophers.md msgid "" -"Rust in Android: \n" -"See [Rust in Android](android.md)." +"Also note that this time you have to use the `Mutex` and the `mpsc` module " +"from the `tokio` crate." msgstr "" -"Rust en Android: \n" -"consulta [Rust en Android](android.md)." +"Además, ten en cuenta que esta vez tienes que utilizar `Mutex` y el módulo " +"`mpsc` del crate `tokio`." -#: src/glossary.md -msgid "" -"Rust in Chromium: \n" -"See [Rust in Chromium](chromium.md)." -msgstr "" -"Rust en Chromium: \n" -"consulta [Rust en Chromium](chromium.md)." +#: src/concurrency/async-exercises/dining-philosophers.md +msgid "Can you make your implementation single-threaded?" +msgstr "¿Puedes conseguir que tu implementación tenga un solo hilo? " -#: src/glossary.md +#: src/concurrency/async-exercises/chat-app.md msgid "" -"safe: \n" -"Refers to code that adheres to Rust's ownership and borrowing rules, " -"preventing memory-related errors." +"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 "" -"Seguro: \n" -"se refiere al código que cumple las reglas de propiedad y préstamos de Rust, " -"lo que evita errores relacionados con la memoria." +"En este ejercicio, queremos usar nuestros nuevos conocimientos para " +"implementar una aplicación de chat de difusión. Disponemos de un servidor de " +"chat al que los clientes se conectan y publican sus mensajes. El cliente lee " +"los mensajes de usuario de la entrada estándar y los envía al servidor. El " +"servidor del chat transmite cada mensaje que recibe a todos los clientes." -#: src/glossary.md +#: src/concurrency/async-exercises/chat-app.md msgid "" -"scope: \n" -"The region of a program where a variable is valid and can be used." +"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 "" -"Ámbito: \n" -"la región de un programa en la que una variable es válida y se puede " -"utilizar." +"Para ello, usaremos \\[un canal en abierto](https://docs.rs/tokio/latest/" +"tokio/sync/broadcast/fn.channel.html) en el servidor y [`tokio_websockets`]" +"(https://docs.rs/tokio-websockets/) para la comunicación entre el cliente y " +"el servidor." -#: src/glossary.md -msgid "" -"standard library: \n" -"A collection of modules providing essential functionality in Rust." -msgstr "" -"Biblioteca estándar: \n" -"una colección de módulos que proporcionan funciones esenciales en Rust." +#: src/concurrency/async-exercises/chat-app.md +msgid "Create a new Cargo project and add the following dependencies:" +msgstr "Crea un proyecto de Cargo y añade las siguientes dependencias:" -#: src/glossary.md +#: src/concurrency/async-exercises/chat-app.md +msgid "_Cargo.toml_:" +msgstr "_Cargo.toml_:" + +#: src/concurrency/async-exercises/chat-app.md +#, fuzzy msgid "" -"static: \n" -"A keyword in Rust used to define static variables or items with a `'static` " -"lifetime." +"```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.38.0\", features = [\"full\"] }\n" +"tokio-websockets = { version = \"0.8.3\", features = [\"client\", " +"\"fastrand\", \"server\", \"sha1_smol\"] }\n" +"```" msgstr "" -"Static: \n" -"una palabra clave de Rust que se utiliza para definir variables o elementos " -"estáticos con un tiempo de vida `'static`." +"```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/glossary.md +#: src/concurrency/async-exercises/chat-app.md +msgid "The required APIs" +msgstr "Las APIs necesarias" + +#: src/concurrency/async-exercises/chat-app.md msgid "" -"string: \n" -"A data type storing textual data. See [`String` vs `str`](basic-syntax/" -"string-slices.html) for more." +"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 "" -"String o cadena: \n" -"tipo de datos que almacena datos de texto. Consulta [`String` vs `str`]" -"(basic-syntax/string-slices.html) para obtener más información." +"Necesitarás las siguientes funciones de `tokio` y [`tokio_websockets`]" +"(https://docs.rs/tokio-websockets/). Dedica unos minutos a familiarizarte " +"con la API. " -#: src/glossary.md +#: src/concurrency/async-exercises/chat-app.md msgid "" -"struct: \n" -"A composite data type in Rust that groups together variables of different " -"types under a single name." +"[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 "" -"Struct: \n" -"tipo de datos compuestos de Rust que agrupa variables de diferentes tipos " -"bajo un mismo nombre." +"[StreamExt::next()](https://docs.rs/futures-util/0.3.28/futures_util/stream/" +"trait.StreamExt.html#method.next) implementado por `WebSocketStream`: " +"permite enviar mensajes de forma asíncrona a través de un flujo Websocket." -#: src/glossary.md +#: src/concurrency/async-exercises/chat-app.md msgid "" -"test: \n" -"A Rust module containing functions that test the correctness of other " -"functions." +"[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 "" -"Prueba: \n" -"módulo de Rust que contiene funciones que comprueban que otras funciones " -"sean correctas." +"[SinkExt::send()](https://docs.rs/futures-util/0.3.28/futures_util/sink/" +"trait.SinkExt.html#method.send) implementado por `WebsocketStream`: permite " +"enviar mensajes de forma asíncrona a través de un flujo Websocket." -#: src/glossary.md +#: src/concurrency/async-exercises/chat-app.md msgid "" -"thread: \n" -"A separate sequence of execution in a program, allowing concurrent execution." +"[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 "" -"Hilo: \n" -"una secuencia de ejecución independiente en un programa que permite la " -"ejecución simultánea." +"[Lines::next_line()](https://docs.rs/tokio/latest/tokio/io/struct.Lines." +"html#method.next_line): para la lectura asíncrona de mensajes de usuario de " +"la entrada estándar." -#: src/glossary.md +#: src/concurrency/async-exercises/chat-app.md msgid "" -"thread safety: \n" -"The property of a program that ensures correct behavior in a multithreaded " -"environment." +"[Sender::subscribe()](https://docs.rs/tokio/latest/tokio/sync/broadcast/" +"struct.Sender.html#method.subscribe): for subscribing to a broadcast channel." msgstr "" -"Seguridad en hilos: \n" -"la propiedad de un programa que asegura un comportamiento correcto en un " -"entorno multihilo." +"[Sender::subscribe()](https://docs.rs/tokio/latest/tokio/sync/broadcast/" +"struct.Sender.html#method.subscribe): para suscribirse a un canal en abierto." -#: src/glossary.md +#: src/concurrency/async-exercises/chat-app.md +msgid "Two binaries" +msgstr "Dos binarios" + +#: src/concurrency/async-exercises/chat-app.md msgid "" -"trait: \n" -"A collection of methods defined for an unknown type, providing a way to " -"achieve polymorphism in Rust." +"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 "" -"Trait: \n" -"conjunto de métodos definidos para un tipo desconocido que proporciona una " -"forma de lograr el polimorfismo en Rust." +"Normalmente, en un proyecto de Cargo, solo puedes tener un archivo binario y " +"un archivo `src/main.rs`. En este proyecto, se necesitan dos binarios, uno " +"para el cliente y otro para el servidor. Puedes convertirlos en dos " +"proyectos de Cargo independientes, pero los incluiremos en un solo proyecto " +"de Cargo con dos binarios. Para que funcione, el código del cliente y del " +"servidor deben aparecer en `src/bin` (consulta la [documentación](https://" +"doc.rust-lang.org/cargo/reference/cargo-targets.html#binaries)). " -#: src/glossary.md +#: src/concurrency/async-exercises/chat-app.md msgid "" -"trait bound: \n" -"An abstraction where you can require types to implement some traits of your " -"interest." +"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 "" -"Límite del trait: \n" -"una abstracción en la que puedes requerir que los tipos implementen algunos " -"traits de tu interés." +"Copia el fragmento de código del servidor y del cliente que aparecen más " +"abajo en `src/bin/server.rs` y `src/bin/client.rs`, respectivamente. Tu " +"tarea es completar estos archivos como se describe a continuación. " + +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md +#, fuzzy +msgid "_src/bin/server.rs_:" +msgstr "`src/bin/server.rs`:" + +#: src/concurrency/async-exercises/chat-app.md +msgid "// TODO: For a hint, see the description of the task below.\n" +msgstr "" +"// TODO: Para obtener una pista, consulta la descripción de la tarea a " +"continuación.\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 "\"escuchando en el puerto 2000\"" + +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md +msgid "\"New connection from {addr:?}\"" +msgstr "\"Nueva conexión de {addr:?}\"" + +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md +msgid "// Wrap the raw TCP stream into a websocket.\n" +msgstr "// Envuelve el flujo TCP sin procesar en un websocket.\n" + +#: src/concurrency/async-exercises/chat-app.md +#: src/concurrency/async-exercises/solutions.md +msgid "_src/bin/client.rs_:" +msgstr "_src/bin/client.rs_:" + +#: 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/concurrency/async-exercises/chat-app.md +msgid "Running the binaries" +msgstr "Ejecutar los binarios" + +#: src/concurrency/async-exercises/chat-app.md +msgid "Run the server with:" +msgstr "Ejecuta el servidor con:" + +#: src/concurrency/async-exercises/chat-app.md +msgid "and the client with:" +msgstr "y el cliente con:" + +#: src/concurrency/async-exercises/chat-app.md +msgid "Implement the `handle_connection` function in `src/bin/server.rs`." +msgstr "Implementa la función `handle_connection` en `src/bin/server.rs`." + +#: 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 "" +"Sugerencia: usa `tokio::select!` para realizar dos tareas simultáneamente en " +"un bucle continuo. Una tarea recibe mensajes del cliente y los transmite. La " +"otra envía los mensajes que recibe el servidor al cliente." + +#: src/concurrency/async-exercises/chat-app.md +msgid "Complete the main function in `src/bin/client.rs`." +msgstr "Completa la función principal en `src/bin/client.rs`." + +#: src/concurrency/async-exercises/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 "" +"Sugerencia: al igual que antes, usa `tokio::select!` en un bucle continuo " +"para realizar dos tareas simultáneamente: (1) leer los mensajes del usuario " +"desde la entrada estándar y enviarlos al servidor, y (2) recibir mensajes " +"del servidor y mostrárselos al usuario." + +#: 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 "" +"Opcional: cuando termines, cambia el código para difundir mensajes a todos " +"los clientes, excepto al remitente." + +#: src/concurrency/async-exercises/solutions.md +msgid "" +"// 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 "" + +#: src/concurrency/async-exercises/solutions.md +msgid "" +"// If we didn't get the right fork, drop the left fork and let\n" +" // other tasks make progress.\n" +msgstr "" + +#: src/concurrency/async-exercises/solutions.md +msgid "// The locks are dropped here\n" +msgstr "// Los bloqueos se eliminan aquí\n" + +#: src/concurrency/async-exercises/solutions.md +msgid "// tx is dropped here, so we don't need to explicitly drop it later\n" +msgstr "" +"// tx se elimina aquí, por lo que no tenemos que eliminarlo explícitamente " +"más tarde.\n" + +#: src/concurrency/async-exercises/solutions.md +msgid "\"Here is a thought: {thought}\"" +msgstr "\"Aquí tienes una reflexión: {thought}\"" + +#: src/concurrency/async-exercises/solutions.md +msgid "\"Welcome to chat! Type a message\"" +msgstr "\"Te damos la bienvenida al chat. Escribe un mensaje\"" + +#: src/concurrency/async-exercises/solutions.md +#, fuzzy +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 "" +"Sugerencia: al igual que antes, usa `tokio::select!` en un bucle continuo " +"para realizar dos tareas simultáneamente: (1) leer los mensajes del usuario " +"desde la entrada estándar y enviarlos al servidor, y (2) recibir mensajes " +"del servidor y mostrárselos al usuario." + +#: src/concurrency/async-exercises/solutions.md +msgid "\"From client {addr:?} {text:?}\"" +msgstr "\"Del cliente {addr:?} {text:?}\"" + +#: src/concurrency/async-exercises/solutions.md +msgid "// Continuous loop for concurrently sending and receiving messages.\n" +msgstr "// Bucle continuo para enviar y recibir mensajes simultáneamente.\n" + +#: src/concurrency/async-exercises/solutions.md +msgid "\"From server: {}\"" +msgstr "\"Del servidor: {}\"" + +#: src/thanks.md +msgid "" +"_Thank you for taking Comprehensive Rust 🦀!_ We hope you enjoyed it and " +"that it was useful." +msgstr "" +"_Gracias por realizar el curso Comprehensive Rust 🦀._ Esperamos que te haya " +"gustado y que te haya resultado útil." + +#: 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 "" +"Nos lo hemos pasado muy bien preparando el curso. Sabemos que no es " +"perfecto, así que si has detectado algún error o tienes ideas para " +"mejorarlo, [ponte en contacto con nosotros en GitHub](https://github.com/" +"google/comprehensive-rust/discussions). Nos encantaría saber tu opinió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." +"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 "" -"Tupla: \n" -"tipo de datos compuestos que contiene variables de diferentes tipos. Los " -"campos de tuplas no tienen nombre y se accede a ellos por sus números " -"ordinales." +"A continuación, se incluye un glosario con el objetivo de ofrecer una breve " +"definición de algunos términos de Rust. En el caso de las traducciones, " +"también sirve para relacionar el término con el original en inglés." +#. 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 msgid "" -"type: \n" -"A classification that specifies which operations can be performed on values " -"of a particular kind in Rust." +"allocate: \n" +"Dynamic memory allocation on [the heap](memory-management/stack-vs-heap.md)." msgstr "" -"Tipo: \n" -"una clasificación que especifica qué operaciones se pueden llevar a cabo en " -"valores de una clase concreta en Rust." +"asignar: \n" +"Asignación dinámica de memoria en [el montículo](Memory-management/stack-vs-" +"heap.md)." #: src/glossary.md msgid "" -"type inference: \n" -"The ability of the Rust compiler to deduce the type of a variable or " -"expression." +"argument: \n" +"Information that is passed into a function or method." msgstr "" -"Inferencia de tipos: \n" -"capacidad del compilador de Rust para deducir el tipo de una variable o " -"expresión." +"argumento: \n" +"Información que se transmite a una función o método." #: src/glossary.md msgid "" -"undefined behavior: \n" -"Actions or conditions in Rust that have no specified result, often leading " -"to unpredictable program behavior." +"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 "" -"Comportamiento indefinido: \n" -"acciones o condiciones en Rust que no tienen ningún resultado especificado, " -"lo que a menudo provoca un comportamiento impredecible del programa." +"Rust Bare-metal: \n" +"desarrollo de Rust de bajo nivel, a menudo desplegado en un sistema sin " +"sistema operativo. Consulta [Bare-metal Rust](bare-metal.md)." #: src/glossary.md msgid "" -"union: \n" -"A data type that can hold values of different types but only one at a time." +"block: \n" +"See [Blocks](control-flow/blocks.md) and _scope_." msgstr "" -"Unión: \n" -"tipo de datos que puede contener valores de distintos tipos, pero solo de " -"uno en uno." +"bloque: \n" +"Consulta [bloques](control-flow/blocks.md) y _ámbito_." #: 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)." +"borrow: \n" +"See [Borrowing](ownership/borrowing.md)." msgstr "" -"Prueba unitaria: \n" -"Rust incluye asistencia integrada para llevar a cabo pruebas unitarias de " -"pequeño tamaño y pruebas de integración de mayor tamaño. Consulta la página " -"[Pruebas unitarias](testing/unit-tests.html)." +"borrow (_omar prestado_): \n" +"Consulta [Borrowing (Préstamos)](ownership/borrowing.md)." #: src/glossary.md msgid "" -"unit type: \n" -"Type that holds no data, written as a tuple with no members." +"borrow checker: \n" +"The part of the Rust compiler which checks that all borrows are valid." msgstr "" -"Tipo de unidad: \n" -"tipo que no contiene datos, escrito como una tupla sin miembros." +"borrow checker (_comprobador de préstamos_): \n" +"la parte del compilador de Rust que comprueba que todos los préstamos sean " +"válidos." #: src/glossary.md msgid "" -"unsafe: \n" -"The subset of Rust which allows you to trigger _undefined behavior_. See " -"[Unsafe Rust](unsafe.html)." +"brace: \n" +"`{` and `}`. Also called _curly brace_, they delimit _blocks_." msgstr "" -"Inseguro: \n" -"el subconjunto de Rust que te permite activar un _comportamiento " -"indefinido_. Consulta [Rust inseguro](unsafe.html)." +"llave: \n" +"`{` and `}`. Delimitan _bloques_." #: src/glossary.md msgid "" -"variable: \n" -"A memory location storing data. Variables are valid in a _scope_." +"build: \n" +"The process of converting source code into executable code or a usable " +"program." msgstr "" -"Variable: \n" -"una ubicación de la memoria que almacena datos. Las variables son válidas en " -"un _ámbito_" +"compilar \n" +"El proceso de conversión de código fuente en código ejecutable o en un " +"programa utilizable." -#: src/other-resources.md -msgid "Other Rust Resources" -msgstr "Otros recursos de Rust" +#: src/glossary.md +msgid "" +"call: \n" +"To invoke or execute a function or method." +msgstr "" +"Llamar: \n" +"invocar o ejecutar una función o método." -#: src/other-resources.md +#: src/glossary.md msgid "" -"The Rust community has created a wealth of high-quality and free resources " -"online." +"channel: \n" +"Used to safely pass messages [between threads](concurrency/channels.md)." msgstr "" -"La comunidad de Rust ha creado una gran cantidad de recursos online sin " -"coste y de gran calidad." +"Canal: \n" +"se utiliza para enviar mensajes [entre hilos](concurrency/channels.md) de " +"forma segura." + +#: src/glossary.md +msgid "" +"Comprehensive Rust 🦀: \n" +"The courses here are jointly called Comprehensive Rust 🦀." +msgstr "" +"Comprehensive Rust 🦀: \n" +"el conjunto de cursos que se describen aquí se denomina Comprehensive Rust " +"🦀." + +#: src/glossary.md +msgid "" +"concurrency: \n" +"The execution of multiple tasks or processes at the same time." +msgstr "" +"Simultaneidad: \n" +"ejecución de varias tareas o procesos al mismo tiempo." + +#: src/glossary.md +msgid "" +"Concurrency in Rust: \n" +"See [Concurrency in Rust](concurrency.md)." +msgstr "" +"Simultaneidad en Rust: \n" +"consulta [Simultaneidad en Rust](concurrency.md)." + +#: src/glossary.md +msgid "" +"constant: \n" +"A value that does not change during the execution of a program." +msgstr "" +"Constante: \n" +" valor que no cambia durante la ejecución de un programa." + +#: src/glossary.md +msgid "" +"control flow: \n" +"The order in which the individual statements or instructions are executed in " +"a program." +msgstr "" +"Flujo de control: \n" +"el orden en el que se ejecutan las instrucciones individuales en un programa." + +#: src/glossary.md +msgid "" +"crash: \n" +"An unexpected and unhandled failure or termination of a program." +msgstr "" +"Fallo: \n" +"fallo o finalización de un programa de forma inesperada y sin gestionar." + +#: src/glossary.md +msgid "" +"enumeration: \n" +"A data type that holds one of several named constants, possibly with an " +"associated tuple or struct." +msgstr "" +"Enumeración: \n" +"tipo de dato que contiene una de varias constantes con nombre, posiblemente " +"con una tupla o estructura asociada." + +#: src/glossary.md +msgid "" +"error: \n" +"An unexpected condition or result that deviates from the expected behavior." +msgstr "" +"Error: \n" +"condición o resultado inesperado que se desvía del comportamiento esperado." + +#: src/glossary.md +msgid "" +"error handling: \n" +"The process of managing and responding to errors that occur during program " +"execution." +msgstr "" +"Gestión de errores: \n" +"el proceso de gestionar y responder a los errores que se producen durante la " +"ejecución del programa." + +#: src/glossary.md +msgid "" +"exercise: \n" +"A task or problem designed to practice and test programming skills." +msgstr "" +"Ejercicio: \n" +"una tarea o problema diseñado para practicar y poner a prueba las " +"habilidades de programación." + +#: src/glossary.md +msgid "" +"function: \n" +"A reusable block of code that performs a specific task." +msgstr "" +"Función: \n" +"bloque de código reutilizable que lleva a cabo una tarea específica." + +#: src/glossary.md +msgid "" +"garbage collector: \n" +"A mechanism that automatically frees up memory occupied by objects that are " +"no longer in use." +msgstr "" +"Recolector de elementos no utilizados: \n" +"mecanismo que libera automáticamente la memoria que ocupan objetos que ya no " +"se utilizan." + +#: src/glossary.md +msgid "" +"generics: \n" +"A feature that allows writing code with placeholders for types, enabling " +"code reuse with different data types." +msgstr "" +"Genéricos: \n" +"una función que permite escribir código con marcadores de posición para los " +"tipos, lo que permite reutilizar código con distintos tipos de datos." + +#: src/glossary.md +msgid "" +"immutable: \n" +"Unable to be changed after creation." +msgstr "" +"Inmutable: \n" +"que no se puede cambiar después de crearse." + +#: src/glossary.md +msgid "" +"integration test: \n" +"A type of test that verifies the interactions between different parts or " +"components of a system." +msgstr "" +"Prueba de integración: \n" +"tipo de prueba que verifica las interacciones entre diferentes partes o " +"componentes de un sistema." + +#: 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 "" +"Palabra clave: \n" +"palabra reservada en un lenguaje de programación que tiene un significado " +"específico y que no se puede utilizar como identificador." + +#: src/glossary.md +msgid "" +"library: \n" +"A collection of precompiled routines or code that can be used by programs." +msgstr "" +"Biblioteca: \n" +"una colección de rutinas o código precompilados que pueden utilizar los " +"programas." + +#: 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" +"las macros de Rust se pueden reconocer por llevar `!` en el nombre. Las " +"macros se utilizan cuando las funciones normales no son suficientes. Un " +"ejemplo típico es `format!`, que utiliza un número variable de argumentos " +"que no es compatible con las funciones de Rust." + +#: src/glossary.md +msgid "" +"`main` function: \n" +"Rust programs start executing with the `main` function." +msgstr "" +"Función `main`: \n" +"los programas de Rust empiezan a ejecutarse con la función `main`." + +#: src/glossary.md +msgid "" +"match: \n" +"A control flow construct in Rust that allows for pattern matching on the " +"value of an expression." +msgstr "" +"Coincidencia: \n" +"construcción de flujo de control en Rust que permite la coincidencia de " +"patrones con el valor de una expresión." + +#: 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 "" +"Pérdida de memoria: \n" +"situación en la que un programa no libera memoria que ya no se necesita, lo " +"que provoca un aumento gradual en el uso de memoria." + +#: src/glossary.md +msgid "" +"method: \n" +"A function associated with an object or a type in Rust." +msgstr "" +"Método: \n" +"una función asociada a un objeto o a un tipo en Rust." + +#: src/glossary.md +msgid "" +"module: \n" +"A namespace that contains definitions, such as functions, types, or traits, " +"to organize code in Rust." +msgstr "" +"Módulo: \n" +"espacio de nombres que contiene definiciones, como funciones, tipos o " +"traits, para organizar el código en Rust." + +#: src/glossary.md +msgid "" +"move: \n" +"The transfer of ownership of a value from one variable to another in Rust." +msgstr "" +"Mover: \n" +"la transferencia de la propiedad de un valor de una variable a otra en Rust." + +#: src/glossary.md +msgid "" +"mutable: \n" +"A property in Rust that allows variables to be modified after they have been " +"declared." +msgstr "" +"Mutable: \n" +"una propiedad en Rust que permite que se modifiquen las variables después de " +"que se hayan declarado." + +#: 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 "" +"Propiedad: \n" +"el concepto de Rust que define qué parte del código es responsable de " +"gestionar la memoria asociada a un valor." + +#: src/glossary.md +msgid "" +"panic: \n" +"An unrecoverable error condition in Rust that results in the termination of " +"the program." +msgstr "" +"Pánico: \n" +"condición de error irrecuperable en Rust que provoca la finalización del " +"programa." + +#: src/glossary.md +msgid "" +"parameter: \n" +"A value that is passed into a function or method when it is called." +msgstr "" +"Parámetro: \n" +" valor que se transfiere a una función o método cuando se llama." + +#: src/glossary.md +msgid "" +"pattern: \n" +"A combination of values, literals, or structures that can be matched against " +"an expression in Rust." +msgstr "" +"Patrón: \n" +"una combinación de valores, literales o estructuras que se pueden comparar " +"con una expresión de Rust." + +#: src/glossary.md +msgid "" +"payload: \n" +"The data or information carried by a message, event, or data structure." +msgstr "" +"Carga útil: \n" +"los datos o la información que transporta un mensaje, evento o estructura de " +"datos." + +#: 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 "" +"Programa: \n" +"conjunto de instrucciones que un ordenador puede ejecutar para llevar a cabo " +"una tarea específica o resolver un problema concreto." + +#: src/glossary.md +msgid "" +"programming language: \n" +"A formal system used to communicate instructions to a computer, such as Rust." +msgstr "" +"Lenguaje de programación: \n" +"un sistema formal que se utiliza para comunicar instrucciones a un " +"ordenador, como Rust." + +#: src/glossary.md +msgid "" +"receiver: \n" +"The first parameter in a Rust method that represents the instance on which " +"the method is called." +msgstr "" +"Receptor: \n" +"el primer parámetro de un método de Rust que representa la instancia en la " +"que se llama al método." + +#: 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 "" +"Recuento de referencias: \n" +"técnica de gestión de la memoria en la que se hace un seguimiento del número " +"de referencias a un objeto y se desasigna cuando el recuento llega a cero." + +#: src/glossary.md +msgid "" +"return: \n" +"A keyword in Rust used to indicate the value to be returned from a function." +msgstr "" +"Retorno: \n" +"una palabra clave de Rust que se utiliza para indicar el valor que se " +"devuelve de una función." + +#: src/glossary.md +msgid "" +"Rust: \n" +"A systems programming language that focuses on safety, performance, and " +"concurrency." +msgstr "" +"Rust: \n" +"lenguaje de programación de sistemas que se centra en la seguridad, el " +"rendimiento y la simultaneidad." + +#: src/glossary.md +#, fuzzy +msgid "" +"Rust Fundamentals: \n" +"Days 1 to 4 of this course." +msgstr "" +"Aspectos básicos de Rust: \n" +"contenido del día 1 al día 3 de este curso." + +#: src/glossary.md +msgid "" +"Rust in Android: \n" +"See [Rust in Android](android.md)." +msgstr "" +"Rust en Android: \n" +"consulta [Rust en Android](android.md)." + +#: src/glossary.md +msgid "" +"Rust in Chromium: \n" +"See [Rust in Chromium](chromium.md)." +msgstr "" +"Rust en Chromium: \n" +"consulta [Rust en Chromium](chromium.md)." + +#: src/glossary.md +msgid "" +"safe: \n" +"Refers to code that adheres to Rust's ownership and borrowing rules, " +"preventing memory-related errors." +msgstr "" +"Seguro: \n" +"se refiere al código que cumple las reglas de propiedad y préstamos de Rust, " +"lo que evita errores relacionados con la memoria." + +#: src/glossary.md +msgid "" +"scope: \n" +"The region of a program where a variable is valid and can be used." +msgstr "" +"Ámbito: \n" +"la región de un programa en la que una variable es válida y se puede " +"utilizar." + +#: src/glossary.md +msgid "" +"standard library: \n" +"A collection of modules providing essential functionality in Rust." +msgstr "" +"Biblioteca estándar: \n" +"una colección de módulos que proporcionan funciones esenciales en Rust." + +#: src/glossary.md +msgid "" +"static: \n" +"A keyword in Rust used to define static variables or items with a `'static` " +"lifetime." +msgstr "" +"Static: \n" +"una palabra clave de Rust que se utiliza para definir variables o elementos " +"estáticos con un tiempo de vida `'static`." + +#: src/glossary.md +#, fuzzy +msgid "" +"string: \n" +"A data type storing textual data. See [Strings](references/strings.html) for " +"more." +msgstr "" +"String o cadena: \n" +"tipo de datos que almacena datos de texto. Consulta [`String` vs `str`]" +"(basic-syntax/string-slices.html) para obtener más información." + +#: 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" +"tipo de datos compuestos de Rust que agrupa variables de diferentes tipos " +"bajo un mismo nombre." + +#: src/glossary.md +msgid "" +"test: \n" +"A Rust module containing functions that test the correctness of other " +"functions." +msgstr "" +"Prueba: \n" +"módulo de Rust que contiene funciones que comprueban que otras funciones " +"sean correctas." + +#: src/glossary.md +msgid "" +"thread: \n" +"A separate sequence of execution in a program, allowing concurrent execution." +msgstr "" +"Hilo: \n" +"una secuencia de ejecución independiente en un programa que permite la " +"ejecución simultánea." + +#: src/glossary.md +msgid "" +"thread safety: \n" +"The property of a program that ensures correct behavior in a multithreaded " +"environment." +msgstr "" +"Seguridad en hilos: \n" +"la propiedad de un programa que asegura un comportamiento correcto en un " +"entorno multihilo." + +#: 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" +"conjunto de métodos definidos para un tipo desconocido que proporciona una " +"forma de lograr el polimorfismo en Rust." + +#: src/glossary.md +msgid "" +"trait bound: \n" +"An abstraction where you can require types to implement some traits of your " +"interest." +msgstr "" +"Límite del trait: \n" +"una abstracción en la que puedes requerir que los tipos implementen algunos " +"traits de tu interés." + +#: 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 "" +"Tupla: \n" +"tipo de datos compuestos que contiene variables de diferentes tipos. Los " +"campos de tuplas no tienen nombre y se accede a ellos por sus números " +"ordinales." + +#: src/glossary.md +msgid "" +"type: \n" +"A classification that specifies which operations can be performed on values " +"of a particular kind in Rust." +msgstr "" +"Tipo: \n" +"una clasificación que especifica qué operaciones se pueden llevar a cabo en " +"valores de una clase concreta en Rust." + +#: src/glossary.md +msgid "" +"type inference: \n" +"The ability of the Rust compiler to deduce the type of a variable or " +"expression." +msgstr "" +"Inferencia de tipos: \n" +"capacidad del compilador de Rust para deducir el tipo de una variable o " +"expresión." + +#: src/glossary.md +msgid "" +"undefined behavior: \n" +"Actions or conditions in Rust that have no specified result, often leading " +"to unpredictable program behavior." +msgstr "" +"Comportamiento indefinido: \n" +"acciones o condiciones en Rust que no tienen ningún resultado especificado, " +"lo que a menudo provoca un comportamiento impredecible del programa." + +#: src/glossary.md +msgid "" +"union: \n" +"A data type that can hold values of different types but only one at a time." +msgstr "" +"Unión: \n" +"tipo de datos que puede contener valores de distintos tipos, pero solo de " +"uno en uno." + +#: 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 "" +"Prueba unitaria: \n" +"Rust incluye asistencia integrada para llevar a cabo pruebas unitarias de " +"pequeño tamaño y pruebas de integración de mayor tamaño. Consulta la página " +"[Pruebas unitarias](testing/unit-tests.html)." + +#: src/glossary.md +msgid "" +"unit type: \n" +"Type that holds no data, written as a tuple with no members." +msgstr "" +"Tipo de unidad: \n" +"tipo que no contiene datos, escrito como una tupla sin miembros." + +#: src/glossary.md +msgid "" +"unsafe: \n" +"The subset of Rust which allows you to trigger _undefined behavior_. See " +"[Unsafe Rust](unsafe.html)." +msgstr "" +"Inseguro: \n" +"el subconjunto de Rust que te permite activar un _comportamiento " +"indefinido_. Consulta [Rust inseguro](unsafe.html)." + +#: src/glossary.md +msgid "" +"variable: \n" +"A memory location storing data. Variables are valid in a _scope_." +msgstr "" +"Variable: \n" +"una ubicación de la memoria que almacena datos. Las variables son válidas en " +"un _ámbito_" + +#: src/other-resources.md +msgid "Other Rust Resources" +msgstr "Otros recursos de Rust" + +#: src/other-resources.md +msgid "" +"The Rust community has created a wealth of high-quality and free resources " +"online." +msgstr "" +"La comunidad de Rust ha creado una gran cantidad de recursos online sin " +"coste y de gran calidad." + +#: src/other-resources.md +msgid "Official Documentation" +msgstr "Documentación oficial" + +#: src/other-resources.md +msgid "The Rust project hosts many resources. These cover Rust in general:" +msgstr "" +"El proyecto Rust cuenta con muchos recursos. Estos tratan sobre Rust en " +"general:" + +#: 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/): el libro " +"canónico sobre Rust sin coste alguno. Trata el lenguaje de forma detallada e " +"incluye algunos proyectos que los usuarios pueden compilar." + +#: 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/): trata la " +"sintaxis de Rust a través de una serie de ejemplos que muestran distintas " +"construcciones. A veces incluye pequeños ejercicios en los que se te pide " +"que amplíes el código de los ejemplos." + +#: src/other-resources.md +msgid "" +"[Rust Standard Library](https://doc.rust-lang.org/std/): full documentation " +"of the standard library for Rust." +msgstr "" +"[La biblioteca estándar de Rust](https://doc.rust-lang.org/std/): " +"documentación completa de la biblioteca estándar de Rust." + +#: 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/): un libro " +"incompleto que describe la gramática y el modelo de memoria de Rust." + +#: src/other-resources.md +msgid "More specialized guides hosted on the official Rust site:" +msgstr "Consulta guías más especializadas en el sitio oficial de Rust:" + +#: 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/): trata de Rust " +"inseguro, incluido cómo trabajar con punteros sin formato e interactuar con " +"otros lenguajes (FFI)." + +#: 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/): " +"incluye el nuevo modelo de programación asíncrona que se introdujo después " +"de que se escribiera el libro de Rust." + +#: 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/): " +"una introducción sobre el uso de Rust en dispositivos integrados sin sistema " +"operativo." + +#: src/other-resources.md +msgid "Unofficial Learning Material" +msgstr "Material de formación no oficial" + +#: src/other-resources.md +msgid "A small selection of other guides and tutorial for Rust:" +msgstr "Una pequeña selección de otras guías y tutoriales sobre Rust:" + +#: 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/): trata Rust " +"desde la perspectiva de los programadores de C de bajo nivel." + +#: 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/): explica Rust desde la perspectiva de los desarrolladores que " +"escriben _firmware_ en C." + +#: 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 professonals](https://overexact.com/rust-for-professionals/): " +"trata la sintaxis de Rust comparándola con otros lenguajes, como C, C++, " +"Java, JavaScript y Python." + +#: 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): más de 100 ejercicios " +"para aprender Rust." + +#: 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): una serie de pequeñas presentaciones que cubren tanto " +"la parte básica como la parte más avanzada del lenguaje Rust. También se " +"tratan otros temas como WebAssembly y async/await." + +#: src/other-resources.md +msgid "" +"[Advanced testing for Rust applications](https://github.com/mainmatter/rust-" +"advanced-testing-workshop): 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 "" + +#: 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/es/shows/beginners-" +"series-to-rust/) y [Take your first steps with Rust](https://docs.microsoft." +"com/es/learn/paths/rust-first-steps/): dos guías de Rust dirigidas a nuevos " +"desarrolladores. La primera es un conjunto de 35 vídeos y la segunda es un " +"conjunto de 11 módulos que cubren la sintaxis y las construcciones básicas " +"de Rust." #: src/other-resources.md -msgid "Official Documentation" -msgstr "Documentación oficial" +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/): exploración detallada de las reglas de gestión " +"de la memoria de Rust a través de la implementación de algunos tipos " +"diferentes de estructuras de listas." + +#: src/other-resources.md +msgid "" +"Please see the [Little Book of Rust Books](https://lborb.github.io/book/) " +"for even more Rust books." +msgstr "" +"Consulta [The Little Book of Rust Books](https://lborb.github.io/book/) para " +"ver más libros de Rust." + +#: 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 "" +"Este material se basa en las numerosas fuentes de documentación sobre Rust. " +"Consulta la página de [otros recursos](other-resources.md) para ver una " +"lista completa de recursos útiles." + +#: 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 "" +"El material de Comprehensive Rust está sujeto a los términos de la licencia " +"Apache 2.0. Para obtener más información, consulta [`LICENSE`](https://" +"github.com/google/comprehensive-rust/blob/main/LICENSE)." + +#: src/credits.md +msgid "Rust by Example" +msgstr "Rust by Example" + +#: 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 "" +"Algunos ejemplos y ejercicios se han copiado y adaptado del libro [Rust by " +"Example](https://doc.rust-lang.org/rust-by-example/). Consulta el directorio " +"`third_party/rust-by-example/` para obtener más información, incluidos los " +"términos de la licencia." + +#: src/credits.md +msgid "Rust on Exercism" +msgstr "Rust on Exercism" + +#: 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 "" +"Se han copiado y adaptado algunos ejercicios del recurso [Rust on Exercism]" +"(https://exercism.org/tracks/rust). Consulta el directorio `third_party/rust-" +"on-exercism/` para obtener más información, incluidos los términos de la " +"licencia." + +#: src/credits.md +msgid "CXX" +msgstr "CXX" + +#: 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 "" +"En la sección [Interoperabilidad con C++](android/Interop/cpp.md) se usa una " +"imagen de [CXX](https://cxx.rs/). Consulta el directorio `third_party/cxx/` " +"para obtener más información, incluidos los términos de la licencia." + +#~ msgid "Conditionals" +#~ msgstr "Condicionales" + +#~ msgid "Static and Const" +#~ msgstr "Estático y Constantes (_Static y Const_)" + +#, fuzzy +#~ msgid "Slices and Lifetimes" +#~ msgstr "Tiempos de vida" + +#, fuzzy +#~ msgid "String References" +#~ msgstr "Referencias colgantes" + +#~ msgid "Control Flow" +#~ msgstr "Control de Flujo" + +#~ msgid "Day 1 Morning (3 hours, including breaks)" +#~ msgstr "Día 1 por la mañana (3 horas, incluidos los descansos)" + +#~ msgid "[Welcome](../welcome-day-1.md) (5 minutes)" +#~ msgstr "[Bienvenida](../welcome-day-1.md) (5 minutos)" + +#~ msgid "[Hello, World](../hello-world.md) (20 minutes)" +#~ msgstr "[Hola, mundo](../hello-world.md) (20 minutos)" + +#~ msgid "[Types and Values](../types-and-values.md) (1 hour and 5 minutes)" +#~ msgstr "[Tipos y valores](../types-and-values.md) (1 hora y 5 minutos)" + +#~ msgid "[Control Flow Basics](../control-flow-basics.md) (1 hour)" +#~ msgstr "" +#~ "[Aspectos básicos del flujo de control](../control-flow-basics.md) (1 " +#~ "hora)" + +#~ msgid "[Tuples and Arrays](../tuples-and-arrays.md) (1 hour)" +#~ msgstr "[Tuplas y arrays](../tuples-and-arrays.md) (1 hora)" + +#~ msgid "[References](../references.md) (50 minutes)" +#~ msgstr "[Referencias](../references.md) (50 minutos)" + +#~ msgid "[User-Defined Types](../user-defined-types.md) (50 minutes)" +#~ msgstr "" +#~ "[Tipos definidos por el usuario](../user-definition-types.md) (50 minutos)" + +#~ msgid "[Welcome](../welcome-day-2.md) (3 minutes)" +#~ msgstr "[Bienvenida](../welcome-day-2.md) (3 minutos)" + +#~ msgid "[Pattern Matching](../pattern-matching.md) (50 minutes)" +#~ msgstr "[Coincidencia de patrones](../pattern-matching.md) (50 minutos)" + +#~ msgid "[Methods and Traits](../methods-and-traits.md) (55 minutes)" +#~ msgstr "[Métodos y traits](../methods-and-traits.md) (55 minutos)" + +#~ msgid "[Generics](../generics.md) (45 minutes)" +#~ msgstr "[Genéricos](../generics.md) (45 minutos)" + +#~ msgid "Day 2 Afternoon (3 hours, including breaks)" +#~ msgstr "Día 2 por la tarde (3 horas, incluidos los descansos)" + +#~ msgid "[Standard Library Types](../std-types.md) (1 hour and 10 minutes)" +#~ msgstr "" +#~ "[Tipos de bibliotecas estándar](../std-types.md) (1 hora y 10 minutos)" + +#~ msgid "[Standard Library Traits](../std-traits.md) (1 hour and 40 minutes)" +#~ msgstr "" +#~ "[Traits de biblioteca estándar](../std-traits.md) (1 hora y 40 minutos)" + +#~ msgid "[Welcome](../welcome-day-3.md) (3 minutes)" +#~ msgstr "[Bienvenida](../welcome-day-3.md) (3 minutos)" + +#~ msgid "[Memory Management](../memory-management.md) (1 hour and 10 minutes)" +#~ msgstr "" +#~ "[Gestión de la memoria](../memory-management.md) (1 hora y 10 minutos)" + +#, fuzzy +#~ msgid "[Smart Pointers](../smart-pointers.md) (45 minutes)" +#~ msgstr "[Iteradores](../iterators.md) (45 minutos)" + +#~ msgid "[Borrowing](../borrowing.md) (1 hour)" +#~ msgstr "[Préstamos](../borrowing.md) (1 hora)" + +#~ msgid "" +#~ "[Slices and Lifetimes](../slices-and-lifetimes.md) (1 hour and 10 minutes)" +#~ msgstr "" +#~ "[Slices y tiempos de vida](../slices-and-lifetimes.md) (1 hora y 10 " +#~ "minutos)" + +#~ msgid "[Welcome](../welcome-day-4.md) (3 minutes)" +#~ msgstr "[Bienvenida](../welcome-day-4.md) (3 minutos)" + +#~ msgid "[Iterators](../iterators.md) (45 minutes)" +#~ msgstr "[Iteradores](../iterators.md) (45 minutos)" + +#~ msgid "[Modules](../modules.md) (40 minutes)" +#~ msgstr "[Módulos](../modules.md) (40 minutos)" + +#~ msgid "[Testing](../testing.md) (1 hour and 5 minutes)" +#~ msgstr "[Pruebas](../testing.md) (1 hora y 5 minutos)" + +#~ msgid "Day 4 Afternoon (2 hours, including breaks)" +#~ msgstr "Día 4 por la tarde (2 horas, incluidos los descansos)" + +#~ msgid "[Error Handling](../error-handling.md) (45 minutes)" +#~ msgstr "[Gestión de errores](../error-handling.md) (45 minutos)" + +#~ msgid "[Unsafe Rust](../unsafe-rust.md) (1 hour and 5 minutes)" +#~ msgstr "[Rust inseguro](../unsafe-rust.md) (1 hora y 5 minutos)" + +#~ msgid "Arrow-Left" +#~ msgstr "Flecha izquierda" + +#~ msgid "Arrow-Right" +#~ msgstr "Flecha derecha" + +#~ msgid "Ctrl + Enter" +#~ msgstr "Ctrl + Intro" + +#~ msgid "s" +#~ msgstr "s" + +#~ msgid "You can use " +#~ msgstr "Puedes usar " + +#~ msgid "In this session:" +#~ msgstr "En esta sesión:" + +#~ msgid "[Welcome](./welcome-day-1.md) (5 minutes)" +#~ msgstr "[Bienvenida](./welcome-day-1.md) (5 minutos)" + +#~ msgid "[Hello, World](./hello-world.md) (20 minutes)" +#~ msgstr "[Hola, mundo](./hello-world.md) (20 minutos)" + +#~ msgid "[Types and Values](./types-and-values.md) (1 hour and 5 minutes)" +#~ msgstr "[Tipos y valores](./types-and-values.md) (1 hora y 5 minutos)" + +#~ msgid "[Control Flow Basics](./control-flow-basics.md) (1 hour)" +#~ msgstr "" +#~ "[Aspectos básicos del flujo de control](./control-flow-basics.md) (1 hora)" + +#~ msgid "Including 10 minute breaks, this session should take about 3 hours" +#~ msgstr "" +#~ "Contando con los descansos de 10 minutos, la duración prevista de la " +#~ "sesión es de unas 3 horas." + +#~ msgid "In this segment:" +#~ msgstr "En esta parte se abordarán los siguientes temas:" + +#~ msgid "[What is Rust?](./hello-world/what-is-rust.md) (10 minutes)" +#~ msgstr "[¿Qué es Rust?](./hello-world/what-is-rust.md) (10 minutos)" + +#~ msgid "[Hello, World](./hello-world/hello-world.md) (5 minutes)" +#~ msgstr "[Hola, mundo](./hello-world/hello-world.md) (5 minutos)" + +#~ msgid "[Benefits of Rust](./hello-world/benefits.md) (3 minutes)" +#~ msgstr "[Ventajas de Rust](./hello-world/benefits.md) (3 minutos)" + +#~ msgid "[Playground](./hello-world/playground.md) (2 minutes)" +#~ msgstr "[Playground](./hello-world/playground.md) (2 minutos)" + +#~ msgid "[Variables](./types-and-values/variables.md) (5 minutes)" +#~ msgstr "[Variables](./types-and-values/variables.md) (5 minutos)" + +#~ msgid "[Values](./types-and-values/values.md) (10 minutes)" +#~ msgstr "[Valores](./types-and-values/values.md) (10 minutos)" + +#~ msgid "[Arithmetic](./types-and-values/arithmetic.md) (5 minutes)" +#~ msgstr "[Aritmética](./types-and-values/arithmetic.md) (5 minutos)" + +#~ msgid "[Strings](./types-and-values/strings.md) (10 minutes)" +#~ msgstr "[Cadenas](./types-and-values/strings.md) (10 minutos)" + +#~ msgid "[Type Inference](./types-and-values/inference.md) (5 minutes)" +#~ msgstr "[Inferencia de tipos](./types-and-values/inference.md) (5 minutos)" + +#~ msgid "[Exercise: Fibonacci](./types-and-values/exercise.md) (30 minutes)" +#~ msgstr "[Ejercicio: Fibonacci](./types-and-values/exercise.md) (30 minutos)" + +#~ 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 "" +#~ "En Rust hay dos tipos para representar cadenas, de los que hablaremos con " +#~ "detenimiento más adelante. Ambos tipos _siempre_ almacenan cadenas " +#~ "codificadas en UTF-8." + +#, fuzzy +#~ msgid "`String` - a modifiable, owned string." +#~ msgstr "`String` es un búfer de cadena mutable." + +#~ msgid "`&str` - a read-only string. String literals have this type." +#~ msgstr "" +#~ "`&str`: es una cadena de solo lectura. Los literales de cadena son de " +#~ "este tipo." + +#~ msgid "\"🪐\"" +#~ msgstr "\"🪐\"" + +#~ msgid "\", \"" +#~ msgstr "\", \"" + +#~ msgid "\"final sentence: {}\"" +#~ msgstr "\"frase final: {}\"" + +#~ msgid "//println!(\"{:?}\", &sentence[12..13]);\n" +#~ msgstr "//println!(\"{:?}\", &sentence[12..13]);\n" + +#~ 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 "" +#~ "En esta diapositiva se presentan las cadenas. Más adelante hablaremos de " +#~ "todo lo relacionado con este tema, pero esta información es suficiente " +#~ "para que se puedan usar cadenas en las diapositivas y ejercicios que " +#~ "vienen a continuación." + +#~ msgid "Invalid UTF-8 in a string is UB, and this not allowed in safe Rust." +#~ msgstr "" +#~ "La codificación UTF-8 no válida en una cadena tiene comportamiento " +#~ "indefinido y no es compatible con Rust seguro." + +#~ msgid "" +#~ "`String` is a user-defined type with a constructor (`::new()`) and " +#~ "methods like `s.push_str(..)`." +#~ msgstr "" +#~ "`String` es un tipo definido por el usuario con un constructor (`::" +#~ "new()`) y métodos como `s.push_str(..)`." + +#~ 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 "" +#~ "La `&` en `&str` indica que se trata de una referencia. Más adelante " +#~ "hablaremos de las referencias, por el momento solo es necesario saber que " +#~ "`&str` es una unidad que significa \"cadena de solo lectura\"." + +#~ 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 "" +#~ "La línea marcada como comentario se indexa en la cadena por posición de " +#~ "byte. `12..13` no termina en el límite de un carácter, por lo que el " +#~ "programa da error. Ajusta el intervalo en función del mensaje de error." + +#~ msgid "[Conditionals](./control-flow-basics/conditionals.md) (5 minutes)" +#~ msgstr "[Condicionales](./control-flow-basics/conditionals.md) (5 minutos)" + +#~ msgid "[Loops](./control-flow-basics/loops.md) (5 minutes)" +#~ msgstr "[Bucles](./control-flow-basics/loops.md) (5 minutos)" + +#~ msgid "" +#~ "[break and continue](./control-flow-basics/break-continue.md) (5 minutes)" +#~ msgstr "" +#~ "[break y continue](./control-flow-basics/break-continue.md) (5 minutos)" + +#~ msgid "" +#~ "[Blocks and Scopes](./control-flow-basics/blocks-and-scopes.md) (10 " +#~ "minutes)" +#~ msgstr "" +#~ "[Bloques y ámbitos (scopes)](./control-flow-basics/blocks-and-scopes.md) " +#~ "(10 minutos)" + +#~ msgid "[Functions](./control-flow-basics/functions.md) (3 minutes)" +#~ msgstr "[Funciones](./control-flow-basics/functions.md) (3 minutos)" + +#~ msgid "[Macros](./control-flow-basics/macros.md) (2 minutes)" +#~ msgstr "[Macros](./control-flow-basics/macros.md) (2 minutos)" + +#~ msgid "" +#~ "[Exercise: Collatz Sequence](./control-flow-basics/exercise.md) (30 " +#~ "minutes)" +#~ msgstr "" +#~ "[Ejercicio: secuencia de Collatz](./control-flow-basics/exercise.md) (30 " +#~ "minutos)" + +#~ msgid "Much of the Rust syntax will be familiar to you from C, C++ or Java:" +#~ msgstr "" +#~ "Gran parte de la sintaxis de Rust te resultará familiar de C, C++ o Java:" + +#~ msgid "Blocks are delimited by curly braces." +#~ msgstr "Los bloques están delimitados por llaves." + +#~ msgid "" +#~ "Line comments are started with `//`, block comments are delimited by `/" +#~ "* ... */`." +#~ msgstr "" +#~ "Los comentarios de línea empiezan por `//`, mientras que los comentarios " +#~ "de bloque están delimitados por `/* ... */`." + +#~ msgid "Keywords like `if` and `while` work the same." +#~ msgstr "Palabras clave como `if` y `while` funcionan igual." + +#~ msgid "Variable assignment is done with `=`, comparison is done with `==`." +#~ msgstr "" +#~ "La asignación de variables se realiza con `=` y la comparación con `==`." + +#~ msgid "" +#~ "We will discuss iteration later; for now, just stick to range expressions." +#~ msgstr "" +#~ "Hablaremos de la iteración más adelante. Por el momento, céntrate en las " +#~ "expresiones de intervalo." + +#~ msgid "\"{result}\"" +#~ msgstr "\"{result}\"" + +#~ msgid "\"x: {x}, i: {i}\"" +#~ msgstr "\"x: {x}, i: {i}\"" + +#~ msgid "" +#~ "In this case we break the outer loop after 3 iterations of the inner loop." +#~ msgstr "" +#~ "En este caso, detenemos el bucle exterior tras tres iteraciones del bucle " +#~ "interno." + +#, fuzzy +#~ msgid "1" +#~ msgstr "12" + +#~ msgid " greater than zero:" +#~ msgstr " mayor que cero:" + +#~ msgid "If _n" +#~ msgstr "Si _n" + +#~ msgid "i" +#~ msgstr "i" + +#~ msgid "_." +#~ msgstr "_." + +#~ msgid "_ is even, then _n" +#~ msgstr "_ es par, entonces _n" + +#~ msgid "i+1" +#~ msgstr "i+1" + +#~ msgid " = n" +#~ msgstr " = n" + +#~ msgid " / 2_." +#~ msgstr " / 2_." + +#~ msgid "_ is odd, then _n" +#~ msgstr "_ es impar, entonces _n" + +#~ msgid " = 3 * n" +#~ msgstr " = 3 * n" + +#~ msgid " + 1_." +#~ msgstr " + 1_." + +#~ msgid "_ = 3:" +#~ msgstr "_ = 3:" + +#~ msgid "3 is odd, so _n" +#~ msgstr "3 es impar, por lo que _n" + +#, fuzzy +#~ msgid "2" +#~ msgstr "12" + +#~ msgid "_ = 3 * 3 + 1 = 10;" +#~ msgstr "_ = 3 * 3 + 1 = 10;" + +#~ msgid "10 is even, so _n" +#~ msgstr "10 es par, por lo que _n" + +#~ msgid "_ = 10 / 2 = 5;" +#~ msgstr "_ = 10 / 2 = 5;" + +#~ msgid "5 is odd, so _n" +#~ msgstr "5 es impar, por lo que _n" + +#~ msgid "_ = 3 * 5 + 1 = 16;" +#~ msgstr "_ = 3 * 5 + 1 = 16;" + +#~ msgid "16 is even, so _n" +#~ msgstr "16 es par, por lo que _n" + +#~ msgid "5" +#~ msgstr "5" + +#~ msgid "_ = 16 / 2 = 8;" +#~ msgstr "_ = 16 / 2 = 8;" + +#~ msgid "8 is even, so _n" +#~ msgstr "8 es par, por lo que _n" + +#~ msgid "_ = 8 / 2 = 4;" +#~ msgstr "_ = 8 / 2 = 4;" + +#~ msgid "4 is even, so _n" +#~ msgstr "4 es par, por lo que _n" + +#~ msgid "7" +#~ msgstr "7" + +#~ msgid "_ = 4 / 2 = 2;" +#~ msgstr "_ = 4 / 2 = 2;" + +#~ msgid "2 is even, so _n" +#~ msgstr "2 es par, por lo que _n" + +#~ msgid "_ = 1; and" +#~ msgstr "_ = 1; y" + +#~ msgid "[Tuples and Arrays](./tuples-and-arrays.md) (1 hour)" +#~ msgstr "[Tuplas y arrays](./tuples-and-arrays.md) (1 hora)" + +#~ msgid "[References](./references.md) (50 minutes)" +#~ msgstr "[Referencias](./references.md) (50 minutos)" + +#~ msgid "[User-Defined Types](./user-defined-types.md) (50 minutes)" +#~ msgstr "" +#~ "[Tipos definidos por el usuario](./user-definition-types.md) (50 minutos)" + +#~ msgid "" +#~ "[Tuples and Arrays](./tuples-and-arrays/tuples-and-arrays.md) (10 minutes)" +#~ msgstr "" +#~ "[Tuplas y arrays](./tuples-and-arrays/tuples-and-arrays.md) (10 minutos)" + +#~ msgid "[Array Iteration](./tuples-and-arrays/iteration.md) (3 minutes)" +#~ msgstr "[Iteración de arrays](./tuples-and-arrays/iteration.md) (3 minutos)" + +#~ msgid "[Pattern Matching](./tuples-and-arrays/match.md) (10 minutes)" +#~ msgstr "" +#~ "[Coincidencia de patrones](./tuples-and-arrays/match.md) (10 minutos)" + +#~ msgid "[Destructuring](./tuples-and-arrays/destructuring.md) (5 minutes)" +#~ msgstr "" +#~ "[Desestructuración](./tuples-and-arrays/destructuring.md) (5 minutos)" + +#~ msgid "" +#~ "[Exercise: Nested Arrays](./tuples-and-arrays/exercise.md) (30 minutes)" +#~ msgstr "" +#~ "[Ejercicio: Arrays anidados](./tuples-and-arrays/exercise.md) (30 minutos)" + +#~ 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 "" +#~ "Las tuplas y los arrays son los primeros tipos \"compuestos\" que hemos " +#~ "estudiado. Todos los elementos de un array tienen el mismo tipo, mientras " +#~ "que las tuplas admiten distintos tipos. Ambos tipos tienen un tamaño fijo " +#~ "durante el tiempo de compilación." + +#~ msgid "`[T; N]`" +#~ msgstr "`[T; N]`" + +#~ msgid "`[20, 30, 40]`, `[0; 3]`" +#~ msgstr "`[20, 30, 40]`, `[0; 3]`" + +#~ msgid "`()`, `(T,)`, `(T1, T2)`, ..." +#~ msgstr "`()`, `(T,)`, `(T1, T2)`, ..." + +#~ msgid "`()`, `('x',)`, `('x', 1.2)`, ..." +#~ msgstr "`()`, `('x',)`, `('x', 1.2)`, ..." + +#~ msgid "Array assignment and access:" +#~ msgstr "Asignación y acceso a arrays:" + +#~ msgid "Tuple assignment and access:" +#~ msgstr "Asignación y acceso a tuplas:" + +#~ msgid "Arrays:" +#~ msgstr "Arrays:" + +#~ msgid "Tuples:" +#~ msgstr "Tuplas:" + +#, fuzzy +#~ 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 "" +#~ "La tupla vacía `()` también se conoce como \"tipo unitario\". Es a la vez " +#~ "un tipo y el único valor válido de ese tipo, es decir, tanto el tipo como " +#~ "su valor se expresan como `()`. Se usa para indicar, por ejemplo, que una " +#~ "función o expresión no tiene valor de retorno, como veremos en una " +#~ "diapositiva posterior." + +#, fuzzy +#~ msgid "" +#~ "You can think of it as `void` that can be familiar to you from other " +#~ "programming languages." +#~ msgstr "" +#~ "Podríamos pensar en ello como `void`, que quizá resulte familiar de otros " +#~ "lenguajes de programación." + +#~ 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 "" +#~ "La desestructuración es una forma de extraer datos de una estructura de " +#~ "datos al escribir un patrón que coincida con la estructura de datos, es " +#~ "decir, enlazando variables a los subcomponentes de dicha estructura." + +#, fuzzy +#~ msgid "You can destructure tuples and arrays by matching on their elements:" +#~ msgstr "" +#~ "Puedes desestructurar arrays, tuplas y slices haciendo coincidir sus " +#~ "elementos:" + +#~ msgid "\"on Y axis\"" +#~ msgstr "\"en el eje Y\"" + +#~ msgid "\"on X axis\"" +#~ msgstr "\"en el eje X\"" + +#~ msgid "\"left of Y axis\"" +#~ msgstr "\"a la izquierda del eje Y\"" + +#~ msgid "\"below X axis\"" +#~ msgstr "\"debajo del eje X\"" + +#~ msgid "\"first quadrant\"" +#~ msgstr "\"primer cuadrante\"" + +#~ msgid "\"Tell me about {triple:?}\"" +#~ msgstr "\"Dame información sobre {triple:?}\"" + +#~ msgid "\"First is 0, y = {y}, and z = {z}\"" +#~ msgstr "\"El primero es 0, y = {y}, z = {z}\"" + +#~ msgid "\"First is 1 and the rest were ignored\"" +#~ msgstr "\"El primero es 1 y el resto se ha ignorado\"" + +#~ msgid "\"All elements were ignored\"" +#~ msgstr "\"Se han ignorado todos los elementos\"" + +#, fuzzy +#~ msgid "Create a new array pattern using `_` to represent an element." +#~ msgstr "Crea un patrón con `_` para representar un elemento. " + +#~ msgid "Add more values to the array." +#~ msgstr "Añade más valores al array." + +#~ msgid "" +#~ "Point out that how `..` will expand to account for different number of " +#~ "elements." +#~ msgstr "" +#~ "Señala cómo `..` se expandirá para representar un número distinto de " +#~ "elementos." + +#~ msgid "" +#~ "Show matching against the tail with patterns `[.., b]` and `[a@..,b]`" +#~ msgstr "" +#~ "Muestra las coincidencias de tail con los patrones `[.., b]` y `[a@..,b]`." + +#~ msgid "Hard-code both functions to operate on 3 × 3 matrices." +#~ msgstr "Codifica ambas funciones para que operen con matrices de 3 × 3." + +#~ msgid "" +#~ "Copy the code below to and implement the " +#~ "functions:" +#~ msgstr "" +#~ "Copia el siguiente fragmento de código en e " +#~ "implementa las funciones:" + +#~ msgid "[Shared References](./references/shared.md) (10 minutes)" +#~ msgstr "[Referencias compartidas](./references/shared.md) (10 minutos)" + +#~ msgid "[Exclusive References](./references/exclusive.md) (10 minutes)" +#~ msgstr "[Referencias exclusivas](./references/included.md) (10 minutos)" + +#~ msgid "[Exercise: Geometry](./references/exercise.md) (30 minutes)" +#~ msgstr "[Ejercicio: geometría](./references/exercise.md) (30 minutos)" + +#~ msgid "[Named Structs](./user-defined-types/named-structs.md) (10 minutes)" +#~ msgstr "" +#~ "[Estructuras con nombre](./user-undefined-types/named-structs.md) (10 " +#~ "minutos)" + +#~ msgid "[Tuple Structs](./user-defined-types/tuple-structs.md) (10 minutes)" +#~ msgstr "" +#~ "[Estructuras de tuplas](./user-definition-types/tuple-structs.md) (10 " +#~ "minutos)" + +#~ msgid "[Enums](./user-defined-types/enums.md) (5 minutes)" +#~ msgstr "[Enums](./user-undefined-types/enums.md) (5 minutos)" + +#~ msgid "" +#~ "[Static and Const](./user-defined-types/static-and-const.md) (5 minutes)" +#~ msgstr "" +#~ "[Variables Static y Const](./user-definition-types/static-and-const.md) " +#~ "(5 minutos)" + +#~ msgid "[Type Aliases](./user-defined-types/aliases.md) (2 minutes)" +#~ msgstr "[Alias de tipo](./user-definition-types/aliases.md) (2 minutos)" + +#~ msgid "" +#~ "[Exercise: Elevator Events](./user-defined-types/exercise.md) (15 minutes)" +#~ msgstr "" +#~ "[Ejercicio: Eventos de ascensor](./user-definition-types/exercise.md) (15 " +#~ "minutos)" + +#, fuzzy +#~ 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 "" +#~ "Las variables estáticas y constantes son dos formas diferentes de crear " +#~ "valores de ámbito global que no se pueden mover ni reasignar durante la " +#~ "ejecución del programa. " + +#~ msgid "Properties table:" +#~ msgstr "Tabla de Propiedades:" + +#~ msgid "Has an address in memory" +#~ msgstr "Tiene una dirección en la memoria" + +#~ msgid "No (inlined)" +#~ msgstr "No (insertado)" + +#~ msgid "Lives for the entire duration of the program" +#~ msgstr "Vive durante toda la ejecución del programa" + +#~ msgid "Can be mutable" +#~ msgstr "Puede ser mutable" + +#~ msgid "Yes (unsafe)" +#~ msgstr "Sí (inseguro)" + +#~ msgid "Evaluated at compile time" +#~ msgstr "Evaluado en tiempo de compilación" + +#~ msgid "Yes (initialised at compile time)" +#~ msgstr "Sí (inicializado en tiempo de compilación)" + +#~ msgid "Inlined wherever it is used" +#~ msgstr "Insertado dondequiera que se utilice" + +#~ msgid "[Welcome](./welcome-day-2.md) (3 minutes)" +#~ msgstr "[Bienvenida](./welcome-day-2.md) (3 minutos)" + +#~ msgid "[Pattern Matching](./pattern-matching.md) (50 minutes)" +#~ msgstr "[Coincidencia de patrones](./pattern-matching.md) (50 minutos)" + +#~ msgid "[Methods and Traits](./methods-and-traits.md) (55 minutes)" +#~ msgstr "[Métodos y traits](./methods-and-traits.md) (55 minutos)" + +#~ msgid "[Generics](./generics.md) (45 minutes)" +#~ msgstr "[Genéricos](./generics.md) (45 minutos)" + +#~ msgid "[Destructuring](./pattern-matching/destructuring.md) (10 minutes)" +#~ msgstr "" +#~ "[Desestructuración](./pattern-matching/destructuring.md) (10 minutos)" + +#~ msgid "" +#~ "[Let Control Flow](./pattern-matching/let-control-flow.md) (10 minutes)" +#~ msgstr "" +#~ "[Control de Flujo con `let`](./pattern-matching/let-control-flow.md) (10 " +#~ "minutos)" + +#~ msgid "" +#~ "[Exercise: Expression Evaluation](./pattern-matching/exercise.md) (30 " +#~ "minutes)" +#~ msgstr "" +#~ "[Ejercicio: evaluación de expresiones](./pattern-matching/exercise.md) " +#~ "(30 minutos)" + +#~ msgid "`match` expressions" +#~ msgstr "Expresiones `match`" + +#~ msgid "[Methods](./methods-and-traits/methods.md) (10 minutes)" +#~ msgstr "[Métodos](./methods-and-traits/methods.md) (10 minutos)" + +#~ msgid "[Traits](./methods-and-traits/traits.md) (10 minutes)" +#~ msgstr "[Traits](./methods-and-traits/traits.md) (10 minutos)" + +#~ msgid "[Deriving](./methods-and-traits/deriving.md) (5 minutes)" +#~ msgstr "[Derivación](./methods-and-traits/deriving.md) (5 minutos)" + +#~ msgid "[Trait Objects](./methods-and-traits/trait-objects.md) (10 minutes)" +#~ msgstr "" +#~ "[Objetos de Trait](./methods-and-traits/trait-objects.md) (10 minutos)" + +#~ msgid "" +#~ "[Exercise: Generic Logger](./methods-and-traits/exercise.md) (20 minutes)" +#~ msgstr "" +#~ "[Ejercicio: registrador genérico](./methods-and-traits/exercise.md) (20 " +#~ "minutos)" + +#~ msgid "" +#~ "Trait objects allow for values of different types, for instance in a " +#~ "collection:" +#~ msgstr "" +#~ "Los objetos de _traits_ permiten valores de diferentes tipos, por " +#~ "ejemplo, en una colección:" + +#~ msgid "[Generic Functions](./generics/generic-functions.md) (5 minutes)" +#~ msgstr "[Funciones genéricas](./generics/generic-functions.md) (5 minutos)" + +#~ msgid "[Generic Data Types](./generics/generic-data.md) (15 minutes)" +#~ msgstr "[Tipos de datos genéricos](./generics/generic-data.md) (15 minutos)" + +#~ msgid "[Trait Bounds](./generics/trait-bounds.md) (10 minutes)" +#~ msgstr "[Límites de traits](./generics/trait-bounds.md) (10 minutos)" + +#~ msgid "[impl Trait](./generics/impl-trait.md) (5 minutes)" +#~ msgstr "[impl Trait](./generics/impl-trait.md) (5 minutos)" + +#~ msgid "[Exercise: Generic min](./generics/exercise.md) (10 minutes)" +#~ msgstr "[Ejercicio: min genérico](./generics/exercise.md) (10 minutos)" + +#~ msgid "// fn set_x(&mut self, x: T)\n" +#~ msgstr "// fn set_x(&mut self, x: T)\n" + +#~ msgid "/// Return true if self is less than other.\n" +#~ msgstr "/// Devuelve true si el valor de self es menor que el de other.\n" + +#~ msgid "\"Shapiro\"" +#~ msgstr "\"Shapiro\"" + +#~ msgid "\"Baumann\"" +#~ msgstr "\"Baumann\"" + +#~ msgid "[Standard Library Types](./std-types.md) (1 hour and 10 minutes)" +#~ msgstr "" +#~ "[Tipos de bibliotecas estándar](./std-types.md) (1 hora y 10 minutos)" + +#~ msgid "[Standard Library Traits](./std-traits.md) (1 hour and 40 minutes)" +#~ msgstr "" +#~ "[Traits de biblioteca estándar](./std-traits.md) (1 hora y 40 minutos)" + +#~ msgid "[Standard Library](./std-types/std.md) (3 minutes)" +#~ msgstr "[Biblioteca estándar](./std-types/std.md) (3 minutos)" + +#~ msgid "[Documentation](./std-types/docs.md) (5 minutes)" +#~ msgstr "[Documentación](./std-types/docs.md) (5 minutos)" + +#~ msgid "[Option](./std-types/option.md) (10 minutes)" +#~ msgstr "[Option (Opción)](./std-types/option.md) (10 minutos)" + +#~ msgid "[Result](./std-types/result.md) (10 minutes)" +#~ msgstr "[Result (Resultado)](./std-types/result.md) (10 minutos)" + +#~ msgid "[String](./std-types/string.md) (10 minutes)" +#~ msgstr "[String (Cadena de texto)](./std-types/string.md) (10 minutos)" + +#~ msgid "[Vec](./std-types/vec.md) (10 minutes)" +#~ msgstr "[Vec (Vectores)](./std-types/vec.md) (10 minutos)" + +#~ msgid "[HashMap](./std-types/hashmap.md) (10 minutes)" +#~ msgstr "[HashMap](./std-types/hashmap.md) (10 minutos)" + +#~ msgid "[Exercise: Counter](./std-types/exercise.md) (10 minutes)" +#~ msgstr "[Ejercicio: contador](./std-types/exercise.md) (10 minutos)" + +#~ msgid "[Comparisons](./std-traits/comparisons.md) (10 minutes)" +#~ msgstr "[Comparaciones](./std-traits/comparisons.md) (10 minutos)" + +#~ msgid "[Operators](./std-traits/operators.md) (10 minutes)" +#~ msgstr "[Operadores](./std-traits/operators.md) (10 minutos)" + +#~ msgid "[From and Into](./std-traits/from-and-into.md) (10 minutes)" +#~ msgstr "[From e Into](./std-traits/from-and-into.md) (10 minutos)" + +#~ msgid "[Casting](./std-traits/casting.md) (5 minutes)" +#~ msgstr "[Conversiones](./std-traits/casting.md) (5 minutos)" + +#~ msgid "[Read and Write](./std-traits/read-and-write.md) (10 minutes)" +#~ msgstr "[Read y Write](./std-traits/read-and-write.md) (10 minutos)" + +#~ msgid "[Default, struct update syntax](./std-traits/default.md) (5 minutes)" +#~ msgstr "" +#~ "[Default, sintaxis de actualización de structs](./std-traits/default.md) " +#~ "(5 minutos)" + +#~ msgid "[Closures](./std-traits/closures.md) (20 minutes)" +#~ msgstr "[Cierres](./std-traits/closures.md) (20 minutos)" + +#~ msgid "[Exercise: ROT13](./std-traits/exercise.md) (30 minutes)" +#~ msgstr "[Ejercicio: ROT13](./std-traits/exercise.md) (30 minutos)" + +#~ msgid "This segment should take about 1 hour and 40 minutes" +#~ msgstr "Esta sección tiene una duración aproximada de 1 hora y 40 minutos." + +#~ msgid "\"there\"" +#~ msgstr "\"pasa?\"" + +#~ msgid "[Welcome](./welcome-day-3.md) (3 minutes)" +#~ msgstr "[Bienvenida](./welcome-day-3.md) (3 minutos)" + +#~ msgid "[Memory Management](./memory-management.md) (1 hour and 10 minutes)" +#~ msgstr "" +#~ "[Gestión de la memoria](./Memory-management.md) (1 hora y 10 minutos)" + +#, fuzzy +#~ msgid "[Smart Pointers](./smart-pointers.md) (45 minutes)" +#~ msgstr "[Punteros inteligentes](./smart-pointers.md) (55 minutos)" + +#~ msgid "" +#~ "[Review of Program Memory](./memory-management/review.md) (5 minutes)" +#~ msgstr "" +#~ "[Revisión de la memoria del programa](./Memory-management/review.md) (5 " +#~ "minutos)" + +#~ msgid "" +#~ "[Approaches to Memory Management](./memory-management/approaches.md) (10 " +#~ "minutes)" +#~ msgstr "" +#~ "[Estrategias para la gestión de la memoria](./Memory-manageme t/" +#~ "approaches.md) (10 minutos)" + +#~ msgid "[Ownership](./memory-management/ownership.md) (5 minutes)" +#~ msgstr "[Ownership](./Memory-management/ownership.md) (5 minutos)" + +#~ msgid "[Move Semantics](./memory-management/move.md) (10 minutes)" +#~ msgstr "[Semántica de movimiento](./Memory-management/move.md) (10 minutos)" + +#~ msgid "[Clone](./memory-management/clone.md) (2 minutes)" +#~ msgstr "[Clonar](./Memory-management/clone.md) (2 minutos)" + +#~ msgid "[Copy Types](./memory-management/copy-types.md) (5 minutes)" +#~ msgstr "[Copiar tipos](./Memory-management/copy-types.md) (5 minutos)" + +#~ msgid "[Drop](./memory-management/drop.md) (10 minutes)" +#~ msgstr "[Drop](./Memory-management/drop.md) (10 minutos)" + +#~ msgid "" +#~ "[Exercise: Builder Type](./memory-management/exercise.md) (20 minutes)" +#~ msgstr "" +#~ "[Ejercicio: tipo de compilador](./Memory-management/exercise.md) (20 " +#~ "minutos)" + +#~ msgid "\"ptr = {ptr:#x}, len = {len}, capacity = {capacity}\"" +#~ msgstr "\"ptr = {ptr:#x}, longitud = {len}, capacidad = {capacity}\"" + +#~ msgid "[Box" +#~ msgstr "[Box" + +#~ msgid "](./smart-pointers/box.md) (10 minutes)" +#~ msgstr "](./smart-pointers/box.md) (10 minutos)" + +#~ msgid "[Rc](./smart-pointers/rc.md) (5 minutes)" +#~ msgstr "[Rc](./smart-pointers/rc.md) (5 minutos)" + +#~ msgid "[Exercise: Binary Tree](./smart-pointers/exercise.md) (30 minutes)" +#~ msgstr "" +#~ "[Ejercicio: árbol binario](./smart-pointers/exercise.md) (30 minutos)" + +#~ 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` no puede estar vacío, por lo que el puntero siempre es válido y no " +#~ "`null`. Esto permite que el compilador optimice el diseño de la memoria:" + +#, fuzzy +#~ 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" +#~ ": | Cons | 1 | o--+----+-----+--->| Cons | 2 | o--+--->| Nil | // " +#~ "| // | :\n" +#~ ": +------+----+----+ : : +------+----+----+ +------+----" +#~ "+----+ :\n" +#~ ": : : :\n" +#~ ": : : :\n" +#~ "'- - - - - - - - - - - - -' '- - - - - - - - - - - - - - - - - - - - " +#~ "- - - -'\n" +#~ "```" + +#~ msgid "[Borrowing](./borrowing.md) (1 hour)" +#~ msgstr "[Préstamos](./borrowing.md) (1 hora)" + +#~ msgid "" +#~ "[Slices and Lifetimes](./slices-and-lifetimes.md) (1 hour and 10 minutes)" +#~ msgstr "" +#~ "[Slices y tiempos de vida](./slices-and-lifetimes.md) (1 hora y 10 " +#~ "minutos)" + +#~ msgid "[Borrowing a Value](./borrowing/shared.md) (10 minutes)" +#~ msgstr "[Tomar prestado un valor](./borrowing/shared.md) (10 minutos)" + +#~ msgid "[Borrow Checking](./borrowing/borrowck.md) (10 minutes)" +#~ msgstr "[Comprobación de préstamos](./borrowing/borrowck.md) (10 minutos)" + +#~ msgid "" +#~ "[Interior Mutability](./borrowing/interior-mutability.md) (10 minutes)" +#~ msgstr "" +#~ "[Mutabilidad interior](./borrowing/interior-mutability.md) (10 minutos)" + +#~ msgid "[Exercise: Health Statistics](./borrowing/exercise.md) (30 minutes)" +#~ msgstr "" +#~ "[Ejercicio: estadísticas de salud](./borrowing/exercise.md) (30 minutos)" + +#~ msgid "The Rust compiler can do return value optimization (RVO)." +#~ msgstr "" +#~ "El compilador de Rust puede hacer la optimización del valor devuelto " +#~ "(RVO)." + +#~ 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 "" +#~ "En C++, la elisión de copia tiene que definirse en la especificación del " +#~ "lenguaje, ya que los constructores pueden tener efectos secundarios. En " +#~ "Rust, esto no supone ningún problema. Si no hay RVO, Rust siempre " +#~ "realizará una copia `memcpy` simple y eficiente." + +#~ msgid "\"graph: {root:#?}\"" +#~ msgstr "\"gráfico: {root:#?}\"" + +#~ msgid "\"graph sum: {}\"" +#~ msgstr "\"suma de gráfico: {}\"" + +#~ 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` solo permite el acceso compartido (de solo lectura) a su contenido, " +#~ "ya que su objetivo es permitir (y contar) muchas referencias. Ya que " +#~ "nuestro objetivo modificar el valor, necesitamos utilizar la mutabilidad " +#~ "interna." + +#~ msgid "" +#~ "Demonstrate that reference loops can be created by adding `root` to " +#~ "`subtree.children`." +#~ msgstr "" +#~ "Demuestra que se pueden crear bucles de referencia añadiendo `root` a " +#~ "`subtree.children`." + +#~ 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 "" +#~ "Para demostrar un pánico en tiempo de ejecución, añade un `fn inc(&mut " +#~ "self)` que incremente `self.value` y llame al mismo método en sus hijos. " +#~ "Esto entrará en pánico en presencia del bucle de referencia, con `thread " +#~ "'main' panicked at 'already borrowed: BorrowMutError'`." + +#~ msgid "[Slices: &\\[T\\]](./slices-and-lifetimes/slices.md) (10 minutes)" +#~ msgstr "[Slices: &\\[T\\]](./slices-and-lifetimes/slices.md) (10 minutos)" + +#~ msgid "[String References](./slices-and-lifetimes/str.md) (10 minutes)" +#~ msgstr "" +#~ "[Referencias de cadenas](./slices-and-lifetimes/str.md) (10 minutos)" + +#~ msgid "" +#~ "[Lifetime Annotations](./slices-and-lifetimes/lifetime-annotations.md) " +#~ "(10 minutes)" +#~ msgstr "" +#~ "[Anotaciones de tiempos de vida](./slices-and-lifetimes/lifetime-" +#~ "annotations.md) (10 minutos)" + +#~ msgid "" +#~ "[Lifetime Elision](./slices-and-lifetimes/lifetime-elision.md) (5 minutes)" +#~ msgstr "" +#~ "[Omisión de tiempos de vida](./slices-and-lifetimes/lifetime-elision.md) " +#~ "(5 minutos)" + +#~ msgid "" +#~ "[Struct Lifetimes](./slices-and-lifetimes/struct-lifetimes.md) (5 minutes)" +#~ msgstr "" +#~ "[Tiempos de vida de structs](./slices-and-lifetimes/struct-lifetimes.md) " +#~ "(5 minutos)" + +#~ msgid "" +#~ "[Exercise: Protobuf Parsing](./slices-and-lifetimes/exercise.md) (30 " +#~ "minutes)" +#~ msgstr "" +#~ "[Ejercicio: análisis de Protobuf](./slices-and-lifetimes/exercise.md) (30 " +#~ "minutos)" + +#~ 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 "" +#~ "Ahora podemos entender los dos tipos de cadenas de Rust: `&str` es muy " +#~ "parecida a `&[char]`, pero almacena sus datos en una codificación de " +#~ "longitud variable (UTF-8)." + +#~ msgid "Rust terminology:" +#~ msgstr "Terminología de Rust:" + +#~ msgid "`&str` an immutable reference to a string slice." +#~ msgstr "`&str` es una referencia inmutable a un slice de una cadena." + +#~ msgid "`String` a mutable string buffer." +#~ msgstr "`String` es un búfer de cadena mutable." + +#~ msgid "\"Unexpected wire-type)\"" +#~ msgstr "\"Tipo de wire inesperado)\"" + +#~ msgid "\"Invalid string (not UTF-8)\"" +#~ msgstr "\"Cadena no válida (no es UTF‐8)\"" + +#~ msgid "b\"hello\"" +#~ msgstr "n\"hola\"" + +#~ msgid "[Welcome](./welcome-day-4.md) (3 minutes)" +#~ msgstr "[Bienvenida](./welcome-day-4.md) (3 minutos)" + +#~ msgid "[Iterators](./iterators.md) (45 minutes)" +#~ msgstr "[Iteradores](./iterators.md) (45 minutos)" + +#~ msgid "[Modules](./modules.md) (40 minutes)" +#~ msgstr "[Módulos](./modules.md) (40 minutos)" + +#~ msgid "[Iterator](./iterators/iterator.md) (5 minutes)" +#~ msgstr "[Iterator](./iterators/iterator.md) (5 minutos)" + +#~ msgid "[IntoIterator](./iterators/intoiterator.md) (5 minutes)" +#~ msgstr "[IntoIterator](./iterators/intoiterator.md) (5 minutos)" + +#~ msgid "[FromIterator](./iterators/fromiterator.md) (5 minutes)" +#~ msgstr "[FromIterator](./iterators/fromiterator.md) (5 minutos)" + +#~ msgid "" +#~ "[Exercise: Iterator Method Chaining](./iterators/exercise.md) (30 minutes)" +#~ msgstr "" +#~ "[Ejercicio: encadenamiento de métodos del iterador](./iterators/exercise." +#~ "md) (30 minutos)" + +#~ msgid "[Modules](./modules/modules.md) (5 minutes)" +#~ msgstr "[Módulos](./modules/modules.md) (5 minutos)" + +#~ msgid "[Filesystem Hierarchy](./modules/filesystem.md) (5 minutes)" +#~ msgstr "" +#~ "[Jerarquía del sistema de archivos](./modules/filesystem.md) (5 minutos)" + +#~ msgid "[Visibility](./modules/visibility.md) (5 minutes)" +#~ msgstr "[Visibilidad](./modules/visible.md) (5 minutos)" + +#~ msgid "[use, super, self](./modules/paths.md) (10 minutes)" +#~ msgstr "[use, super, self](./modules/paths.md) (10 minutos)" + +#~ msgid "" +#~ "[Exercise: Modules for a GUI Library](./modules/exercise.md) (15 minutes)" +#~ msgstr "" +#~ "[Ejercicio: módulos para una biblioteca GUI](./modules/exercise.md) (15 " +#~ "minutos)" + +#~ msgid "[Test Modules](./testing/unit-tests.md) (5 minutes)" +#~ msgstr "[Módulos de pruebas](./testing/unit-tests.md) (5 minutos)" + +#~ msgid "[Other Types of Tests](./testing/other.md) (10 minutes)" +#~ msgstr "[Otros tipos de pruebas](./testing/other.md) (10 minutos)" + +#~ msgid "[Useful Crates](./testing/useful-crates.md) (3 minutes)" +#~ msgstr "[Crates útiles](./testing/useful-crates.md) (3 minutos)" + +#~ msgid "[GoogleTest](./testing/googletest.md) (5 minutes)" +#~ msgstr "[GoogleTest](./testing/googletest.md) (5 minutos)" + +#~ msgid "[Mocking](./testing/mocking.md) (5 minutes)" +#~ msgstr "[Simulación](./testing/mocking.md) (5 minutos)" + +#~ msgid "[Compiler Lints and Clippy](./testing/lints.md) (5 minutes)" +#~ msgstr "[Lints de compilador y Clippy](./testing/lints.md) (5 minutos)" + +#~ msgid "[Exercise: Luhn Algorithm](./testing/exercise.md) (30 minutes)" +#~ msgstr "[Ejercicio: Algoritmo de Luhn](./testing/exercise.md) (30 minutos)" + +#~ msgid "Rust comes with only basic support for writing tests." +#~ msgstr "Rust solo incluye asistencia básica para las pruebas de escritura." + +#~ msgid "" +#~ "Here are some additional crates which we recommend for writing tests:" +#~ msgstr "" +#~ "A continuación, se indican algunos crates adicionales que recomendamos " +#~ "para escribir pruebas:" + +#~ msgid "" +#~ "[googletest](https://docs.rs/googletest): Comprehensive test assertion " +#~ "library in the tradition of GoogleTest for C++." +#~ msgstr "" +#~ "[googletest](https://docs.rs/googletest): biblioteca completa de aserción " +#~ "de pruebas en la tradición de GoogleTest para C++." + +#~ msgid "" +#~ "[proptest](https://docs.rs/proptest): Property-based testing for Rust." +#~ msgstr "" +#~ "[proptest](https://docs.rs/proptest): pruebas basadas en propiedades para " +#~ "Rust." + +#~ msgid "" +#~ "[rstest](https://docs.rs/rstest): Support for fixtures and parameterised " +#~ "tests." +#~ msgstr "" +#~ "[rstest](https://docs.rs/rstest): asistencia para _fixtures_ y pruebas " +#~ "parametrizadas." + +#~ msgid "This just scratches the surface, there are many builtin matchers." +#~ msgstr "Esto es solo el comienzo, existen muchos matchers integrados." + +#~ msgid "GoogleTest is available for use in AOSP." +#~ msgstr "GoogleTest se puede utilizar en AOSP." + +#~ msgid "[Error Handling](./error-handling.md) (45 minutes)" +#~ msgstr "[Gestión de errores](./error-handling.md) (45 minutos)" + +#~ msgid "[Unsafe Rust](./unsafe-rust.md) (1 hour and 5 minutes)" +#~ msgstr "[Rust inseguro](./unsafe-rust.md) (1 hora y 5 minutos)" + +#~ msgid "Including 10 minute breaks, this session should take about 2 hours" +#~ msgstr "" +#~ "Contando con los descansos de 10 minutos, la duración prevista de la " +#~ "sesión es de unas 2 horas." + +#~ msgid "[Panics](./error-handling/panics.md) (3 minutes)" +#~ msgstr "[Pánicos](./error-handling/panics.md) (3 minutos)" + +#~ msgid "[Try Operator](./error-handling/try.md) (5 minutes)" +#~ msgstr "[Operador Try](./error-handling/try.md) (5 minutos)" + +#~ msgid "[Try Conversions](./error-handling/try-conversions.md) (5 minutes)" +#~ msgstr "[Conversiones Try](./error-handling/try-conversions.md) (5 minutos)" + +#~ msgid "[Error Trait](./error-handling/error.md) (5 minutes)" +#~ msgstr "[Trait Error](./error-handling/error.md) (5 minutos)" + +#~ msgid "" +#~ "[thiserror and anyhow](./error-handling/thiserror-and-anyhow.md) (5 " +#~ "minutes)" +#~ msgstr "" +#~ "[thiserror y anyhow](./error-handling/thiserror-and-anyhow.md) (5 minutos)" + +#~ msgid "" +#~ "[Exercise: Rewriting with Result](./error-handling/exercise.md) (20 " +#~ "minutes)" +#~ msgstr "" +#~ "[Ejercicio: reescribir con Result](./error-handling/exercise.md) (20 " +#~ "minutos)" + +#~ msgid "[Unsafe](./unsafe-rust/unsafe.md) (5 minutes)" +#~ msgstr "[Inseguro](./unsafe-rust/unsafe.md) (5 minutos)" + +#~ msgid "" +#~ "[Dereferencing Raw Pointers](./unsafe-rust/dereferencing.md) (10 minutes)" +#~ msgstr "" +#~ "[Desreferenciar punteros sin formato](./unsafe-rust/dereferencing.md) (10 " +#~ "minutos)" + +#~ msgid "" +#~ "[Mutable Static Variables](./unsafe-rust/mutable-static.md) (5 minutes)" +#~ msgstr "" +#~ "[Variables estáticas mutables](./unsafe-rust/mutable-static.md) (5 " +#~ "minutos)" + +#~ msgid "[Unions](./unsafe-rust/unions.md) (5 minutes)" +#~ msgstr "[Uniones](./unsafe-rust/unions.md) (5 minutos)" + +#~ msgid "[Unsafe Functions](./unsafe-rust/unsafe-functions.md) (5 minutes)" +#~ msgstr "" +#~ "[Funciones inseguras](./unsafe-rust/unsafe-functions.md) (5 minutos)" + +#~ msgid "[Unsafe Traits](./unsafe-rust/unsafe-traits.md) (5 minutes)" +#~ msgstr "[Traits inseguros](./unsafe-rust/unsafe-traits.md) (5 minutos)" + +#~ msgid "[Exercise: FFI Wrapper](./unsafe-rust/exercise.md) (30 minutes)" +#~ msgstr "" +#~ "[Ejercicio: envoltorio de FFI](./unsafe-rust/exercise.md) (30 minutos)" + +#, fuzzy +#~ msgid "// Undefined behavior if abs misbehaves.\n" +#~ msgstr "No hay comportamientos indefinidos en _runtime_:" + +#~ msgid "// Safe because ...\n" +#~ msgstr "// Es seguro porque ...\n" + +#~ msgid "" +#~ "Add `vendor_available: true` if your AIDL file is used by a binary in the " +#~ "vendor partition." +#~ msgstr "" +#~ "Añade `vendor_available: true` si un binario de la partición del " +#~ "proveedor utiliza tu archivo de AIDL." + +#~ msgid "/// Connect to the BirthdayService.\n" +#~ msgstr "/// Conecta con el servicio de felicitación de cumpleaños.\n" + +#~ msgid "" +#~ "// SAFETY: `print_card` is safe to call with a valid `card` pointer.\n" +#~ msgstr "" +#~ "// SEGURIDAD: es seguro llamar a `print_card` con un puntero `card` " +#~ "válido.\n" + +#~ msgid "ADC" +#~ msgstr "ADC" + +#~ msgid "I2C, SPI, UART, CAN" +#~ msgstr "I2C, SPI, UART, CAN" + +#~ msgid "RNG" +#~ msgstr "RNG" + +#~ msgid "Timers" +#~ msgstr "Temporizadores" + +#~ msgid "Watchdogs" +#~ msgstr "Watchdogs" + +#~ msgid "" +#~ "There is work in progress on an `async` version of `embedded-hal`, but it " +#~ "isn't stable yet." +#~ msgstr "" +#~ "Se está trabajando en una versión `async` de `embedded-hal`, pero aún no " +#~ "es estable." + +#~ msgid "" +#~ "// Set up the I2C controller and Inertial Measurement Unit.\n" +#~ " // TODO\n" +#~ msgstr "" +#~ "// Configura el controlador I2C y la unidad de medición inercial.\n" +#~ " // TAREA\n" + +#~ msgid "" +#~ "// Read compass data and log it to the serial port.\n" +#~ " // TODO\n" +#~ msgstr "" +#~ "// Lee datos de la brújula y regístralos en el puerto serie.\n" +#~ " // TAREA\n" + +#~ msgid "// TODO: Create instance of RTC driver and print current time.\n" +#~ msgstr "" +#~ "// TAREA: crear una instancia del controlador RTC e imprimir la hora " +#~ "actual.\n" + +#~ msgid "// TODO: Wait for 3 seconds.\n" +#~ msgstr "// TAREA: esperar 3 segundos.\n" + +#~ 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" +#~ "// Con licencia Apache, versión 2.0 (la \"Licencia\");\n" +#~ "// Este archivo solo se puede utilizar según lo estipulado en la " +#~ "Licencia.\n" +#~ "// Puedes obtener una copia de la Licencia en\n" +#~ "//\n" +#~ "// http://www.apache.org/licenses/LICENSE-2.0\n" +#~ "//\n" +#~ "// Salvo que lo exija la legislación aplicable o se haya acordado por " +#~ "escrito, el software\n" +#~ "// distribuido bajo la Licencia se distribuye \"TAL CUAL\",\n" +#~ "// SIN GARANTÍAS NI CONDICIONES DE NINGÚN TIPO, ya sean explícitas o " +#~ "implícitas.\n" +#~ "// Consulta la Licencia para saber los permisos y las limitaciones " +#~ "aplicables a cada idioma\n" +#~ "//.\n" + +#~ msgid "\"sync_exception_current\"" +#~ msgstr "\"sync_exception_current\"" + +#~ msgid "\"irq_current\"" +#~ msgstr "\"irq_current\"" + +#~ msgid "\"No pending interrupt\"" +#~ msgstr "\"No hay interrupciones pendientes\"" + +#~ msgid "\"IRQ {intid:?}\"" +#~ msgstr "\"IRQ {intid:?}\"" + +#~ msgid "\"fiq_current\"" +#~ msgstr "\"fiq_current\"" + +#~ msgid "\"serr_current\"" +#~ msgstr "\"serr_current\"" + +#~ msgid "\"sync_lower\"" +#~ msgstr "\"sync_lower\"" + +#~ msgid "\"irq_lower\"" +#~ msgstr "\"irq_lower\"" + +#~ msgid "\"fiq_lower\"" +#~ msgstr "\"fiq_lower\"" + +#~ msgid "\"serr_lower\"" +#~ msgstr "\"serr_lower\"" + +#~ msgid "// ANCHOR: main\n" +#~ msgstr "// ANCHOR: main\n" + +#~ msgid "// ANCHOR: Flags\n" +#~ msgstr "// ANCHOR: Flags\n" + +#~ msgid "// ANCHOR_END: Flags\n" +#~ msgstr "// ANCHOR_END: Flags\n" + +#~ msgid "" +#~ "/// Flags from the UART Receive Status Register / Error Clear Register.\n" +#~ msgstr "" +#~ "/// Marcas del registro de estado de recepción de UART/Registro de " +#~ "borrado de errores.\n" + +#~ msgid "/// Framing error.\n" +#~ msgstr "/// Error de encuadre.\n" + +#~ msgid "/// Parity error.\n" +#~ msgstr "/// Error de paridad.\n" + +#~ msgid "/// Break error.\n" +#~ msgstr "/// Error de break.\n" + +#~ msgid "/// Overrun error.\n" +#~ msgstr "/// Error de desbordamiento.\n" + +#~ msgid "// ANCHOR: Registers\n" +#~ msgstr "// ANCHOR: Registers\n" + +#~ msgid "// ANCHOR_END: Registers\n" +#~ msgstr "// ANCHOR_END: Registers\n" + +#~ msgid "" +#~ "// ANCHOR: Uart\n" +#~ "/// Driver for a PL011 UART.\n" +#~ msgstr "" +#~ "// ANCHOR: Uart\n" +#~ "/// Controlador para un UART PL011.\n" + +#~ 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 "" +#~ "/// Crea una instancia nueva del controlador UART para un dispositivo " +#~ "PL011 en la\n" +#~ " /// dirección base proporcionada.\n" +#~ " ///\n" +#~ " /// # Seguridad\n" +#~ " ///\n" +#~ " /// El objeto la dirección base debe apuntar a los registros de " +#~ "control MMIO de un dispositivo\n" +#~ " /// PL011, que debe asignarse al espacio de direcciones del proceso\n" +#~ " /// como memoria del dispositivo y no tener ningún otro alias.\n" + +#~ msgid "// ANCHOR_END: Uart\n" +#~ msgstr "// ANCHOR_END: Uart\n" + +#~ msgid "\"linux\"" +#~ msgstr "\"linux\"" + +#~ msgid "\"CROSS_COMPILE\"" +#~ msgstr "\"CROSS_COMPILE\"" + +#~ msgid "\"aarch64-linux-gnu\"" +#~ msgstr "\"aarch64-linux-gnu\"" + +#~ msgid "\"aarch64-none-elf\"" +#~ msgstr "\"aarch64-none-elf\"" + +#~ msgid "\"entry.S\"" +#~ msgstr "\"entry.S\"" + +#~ msgid "\"exceptions.S\"" +#~ msgstr "\"exceptions.S\"" + +#~ msgid "\"idmap.S\"" +#~ msgstr "\"idmap.S\"" + +#~ msgid "\"empty\"" +#~ msgstr "\"empty\"" + +#~ 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" +#~ " * 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" +#~ " * Es un punto de entrada genérico para una imagen. 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" +#~ "```" + +#~ 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" +#~ " * 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" +#~ "```" + +#~ 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" +#~ " * 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" +#~ "```" + +#~ 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" +#~ " * 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" +#~ "```" + +#~ 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" + +#~ msgid "" +#~ "Notice that the thread is stopped before it reaches 10 --- the main " +#~ "thread is not waiting." +#~ msgstr "" +#~ "Observa que el hilo se detiene antes de llegar a 10; el hilo principal no " +#~ "está esperando." + +#~ msgid "" +#~ "Rust uses the type system to enforce synchronization of shared data. This " +#~ "is primarily done via two types:" +#~ msgstr "" +#~ "Rust utiliza el sistema de tipos para implementar la sincronización de " +#~ "los datos compartidos. Esto se hace principalmente a través de dos tipos:" + +#~ 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), recuento " +#~ "atómico de referencias `T`: gestiona el uso compartido entre hilos y se " +#~ "encarga de desasignar `T` cuando se elimina la última referencia." + +#~ 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): " +#~ "asegura el acceso mutuamente excluyente al valor `T`." + +#~ msgid "Let us practice our new concurrency skills with" +#~ msgstr "Vamos a practicar nuestras nuevas habilidades de concurrencia con" -#: src/other-resources.md -msgid "The Rust project hosts many resources. These cover Rust in general:" -msgstr "" -"El proyecto Rust cuenta con muchos recursos. Estos tratan sobre Rust en " -"general:" +#~ msgid "Dining philosophers: a classic problem in concurrency." +#~ msgstr "La cena de los filósofos: un problema clásico de concurrencia." -#: 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/): el libro " -"canónico sobre Rust sin coste alguno. Trata el lenguaje de forma detallada e " -"incluye algunos proyectos que los usuarios pueden compilar." +#~ msgid "" +#~ "Multi-threaded link checker: a larger project where you'll use Cargo to " +#~ "download dependencies and then check links in parallel." +#~ msgstr "" +#~ "El comprobador de enlaces multihilo: un proyecto más grande donde " +#~ "utilizarás Cargo para descargar dependencias y luego comprobar los " +#~ "enlaces en paralelo." -#: 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/): trata la " -"sintaxis de Rust a través de una serie de ejemplos que muestran distintas " -"construcciones. A veces incluye pequeños ejercicios en los que se te pide " -"que amplíes el código de los ejemplos." +#~ 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 "" +#~ "Para ello, necesitarás un cliente HTTP como [`reqwest`](https://docs.rs/" +#~ "reqwest/). Crea un proyecto de Cargo y aplica `reqwest` como una " +#~ "dependencia con:" -#: src/other-resources.md -msgid "" -"[Rust Standard Library](https://doc.rust-lang.org/std/): full documentation " -"of the standard library for Rust." -msgstr "" -"[La biblioteca estándar de Rust](https://doc.rust-lang.org/std/): " -"documentación completa de la biblioteca estándar de Rust." +#~ msgid "" +#~ "You will also need a way to find links. We can use [`scraper`](https://" +#~ "docs.rs/scraper/) for that:" +#~ msgstr "" +#~ "También necesitarás una forma de encontrar enlaces. Podemos usar " +#~ "[`scraper`](https://docs.rs/scraper/) para eso:" -#: 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/): un libro " -"incompleto que describe la gramática y el modelo de memoria de Rust." +#~ msgid "" +#~ "Finally, we'll need some way of handling errors. We use [`thiserror`]" +#~ "(https://docs.rs/thiserror/) for that:" +#~ msgstr "" +#~ "Por último, necesitaremos algún método para gestionar los errores. Para " +#~ "ello, usaremos [`thiserror`](https://docs.rs/thiserror/):" -#: src/other-resources.md -msgid "More specialized guides hosted on the official Rust site:" -msgstr "Consulta guías más especializadas en el sitio oficial de Rust:" +#~ msgid "Concurrency Morning Exercise" +#~ msgstr "Concurrencia: Ejercicios de la Mañana" -#: 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/): trata de Rust " -"inseguro, incluido cómo trabajar con punteros sin formato e interactuar con " -"otros lenguajes (FFI)." +#~ msgid "([back to exercise](dining-philosophers.md))" +#~ msgstr "([volver al ejercicio](dining-philosophers.md))" -#: 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/): " -"incluye el nuevo modelo de programación asíncrona que se introdujo después " -"de que se escribiera el libro de Rust." +#~ msgid "([back to exercise](link-checker.md))" +#~ msgstr "([volver al ejercicio](link-checker.md))" -#: 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/): " -"una introducción sobre el uso de Rust en dispositivos integrados sin sistema " -"operativo." +#~ msgid "Async Rust" +#~ msgstr "Async en Rust" -#: src/other-resources.md -msgid "Unofficial Learning Material" -msgstr "Material de formación no oficial" +#~ msgid "Futures Control Flow" +#~ msgstr "Flujo de Control de Futuros" -#: src/other-resources.md -msgid "A small selection of other guides and tutorial for Rust:" -msgstr "Una pequeña selección de otras guías y tutoriales sobre 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 "" +#~ "Los futuros pueden combinarse para producir gráficos de flujo de " +#~ "computación simultáneos. Ya hemos visto tareas que funcionan como hilos " +#~ "de ejecución independientes." -#: 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/): trata Rust " -"desde la perspectiva de los programadores de C de bajo nivel." +#~ msgid "[Join](control-flow/join.md)" +#~ msgstr "[Join](control-flow/join.md)" -#: 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/): explica Rust desde la perspectiva de los desarrolladores que " -"escriben _firmware_ en C." +#~ msgid "[Select](control-flow/select.md)" +#~ msgstr "[Select](control-flow/select.md)" -#: 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 professonals](https://overexact.com/rust-for-professionals/): " -"trata la sintaxis de Rust comparándola con otros lenguajes, como C, C++, " -"Java, JavaScript y Python." +#~ msgid "Pitfalls of async/await" +#~ msgstr "Inconvenientes de async/await" -#: 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): más de 100 ejercicios " -"para aprender Rust." +#~ msgid "[Blocking the Executor](pitfalls/blocking-executor.md)" +#~ msgstr "[Bloqueo del ejecutor](pitfalls/blocking-executor.md)" -#: 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): una serie de pequeñas presentaciones que cubren tanto " -"la parte básica como la parte más avanzada del lenguaje Rust. También se " -"tratan otros temas como WebAssembly y async/await." +#~ msgid "[Pin](pitfalls/pin.md)" +#~ msgstr "[Pin](pitfalls/pin.md)" -#: 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/es/shows/beginners-" -"series-to-rust/) y [Take your first steps with Rust](https://docs.microsoft." -"com/es/learn/paths/rust-first-steps/): dos guías de Rust dirigidas a nuevos " -"desarrolladores. La primera es un conjunto de 35 vídeos y la segunda es un " -"conjunto de 11 módulos que cubren la sintaxis y las construcciones básicas " -"de Rust." +#~ msgid "[Async Traits](pitfalls/async-traits.md)" +#~ msgstr "[Traits asíncronos](pitfalls/async-traits.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/): exploración detallada de las reglas de gestión " -"de la memoria de Rust a través de la implementación de algunos tipos " -"diferentes de estructuras de listas." +#~ msgid "[Cancellation](pitfalls/cancellation.md)" +#~ msgstr "[Cancelación](pitfalls/cancellation.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 "" -"Consulta [The Little Book of Rust Books](https://lborb.github.io/book/) para " -"ver más libros de Rust." +#~ 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 "" +#~ "Los métodos asíncronos en traits todavía no son compatibles con el canal " +#~ "estable. ([Existe una característica experimental en nightly que debería " +#~ "estabilizarse a medio plazo.](https://blog.rust-lang.org/inside-" +#~ "rust/2022/11/17/async-fn-in-trait-nightly.html))" -#: 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 "" -"Este material se basa en las numerosas fuentes de documentación sobre Rust. " -"Consulta la página de [otros recursos](other-resources.md) para ver una " -"lista completa de recursos útiles." +#~ msgid "" +#~ "To practice your Async Rust skills, we have again two exercises for you:" +#~ msgstr "" +#~ "Para practicar tus habilidades con async de Rust, tenemos otros dos " +#~ "nuevos ejercicios:" -#: 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 "" -"El material de Comprehensive Rust está sujeto a los términos de la licencia " -"Apache 2.0. Para obtener más información, consulta [`LICENSE`](https://" -"github.com/google/comprehensive-rust/blob/main/LICENSE)." +#~ msgid "" +#~ "Dining philosophers: we already saw this problem in the morning. This " +#~ "time you are going to implement it with Async Rust." +#~ msgstr "" +#~ "La cena de los filósofos: ya hemos visto este problema por la mañana. " +#~ "Esta vez vas a implementarlo con async de Rust." -#: src/credits.md -msgid "Rust by Example" -msgstr "Rust by Example" +#~ msgid "" +#~ "A Broadcast Chat Application: this is a larger project that allows you " +#~ "experiment with more advanced Async Rust features." +#~ msgstr "" +#~ "Una aplicación de chat de difusión: se trata de un proyecto más grande " +#~ "que te permite experimentar con características más avanzadas de async de " +#~ "Rust." -#: 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 "" -"Algunos ejemplos y ejercicios se han copiado y adaptado del libro [Rust by " -"Example](https://doc.rust-lang.org/rust-by-example/). Consulta el directorio " -"`third_party/rust-by-example/` para obtener más información, incluidos los " -"términos de la licencia." +#~ msgid "Concurrency Afternoon Exercise" +#~ msgstr "Concurrencia: Ejercicios de la Tarde" -#: src/credits.md -msgid "Rust on Exercism" -msgstr "Rust on Exercism" +#~ msgid "([back to exercise](dining-philosophers-async.md))" +#~ msgstr "([volver al ejercicio](dining-philosophers-async.md))" -#: 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 "" -"Se han copiado y adaptado algunos ejercicios del recurso [Rust on Exercism]" -"(https://exercism.org/tracks/rust). Consulta el directorio `third_party/rust-" -"on-exercism/` para obtener más información, incluidos los términos de la " -"licencia." +#~ msgid "" +#~ "// Add a delay before picking the second fork to allow the execution\n" +#~ " // to transfer to another task\n" +#~ msgstr "" +#~ "// Añade un retraso antes de elegir el segundo tenedor para permitir la " +#~ "ejecución\n" +#~ " // para transferir a otra tarea\n" -#: src/credits.md -msgid "CXX" -msgstr "CXX" +#~ 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 "" +#~ "// Para evitar un interbloqueo, tenemos que romper la simetría\n" +#~ " // en algún lugar. De este modo, se cambiarán los tenedores " +#~ "sin desinicializar\n" +#~ " // ninguno de ellos.\n" -#: 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 "" -"En la sección [Interoperabilidad con C++](android/Interop/cpp.md) se usa una " -"imagen de [CXX](https://cxx.rs/). Consulta el directorio `third_party/cxx/` " -"para obtener más información, incluidos los términos de la licencia." +#~ msgid "([back to exercise](chat-app.md))" +#~ msgstr "([volver al ejercicio](chat-app.md))" #~ msgid "Small Example" #~ msgstr "Pequeño ejemplo" @@ -25001,9 +26750,6 @@ msgstr "" #~ msgid "Arrays and for Loops" #~ msgstr "Arrays y Loops for" -#~ msgid "if expressions" -#~ msgstr "expresiones if" - #~ msgid "for expressions" #~ msgstr "expresiones for" @@ -25022,10 +26768,6 @@ msgstr "" #~ msgid "Enum Sizes" #~ msgstr "Tamaños de Enum" -#, fuzzy -#~ msgid "Novel Control Flow" -#~ msgstr "Control de Flujo" - #~ msgid "if let expressions" #~ msgstr "expresiones if let" @@ -25035,9 +26777,6 @@ msgstr "" #~ msgid "match expressions" #~ msgstr "expresiones match" -#~ msgid "Destructuring Structs" -#~ msgstr "Desestructurando Structs" - #~ msgid "Destructuring Arrays" #~ msgstr "Desestructurando Arrays" @@ -25081,30 +26820,18 @@ msgstr "" #~ msgid "Field Shorthand Syntax" #~ msgstr "Sintaxis abreviada de campos" -#~ msgid "Method Receiver" -#~ msgstr "Receptor de método" - #~ msgid "Storing Books" #~ msgstr "Almacenar libros" #~ msgid "Option and Result" #~ msgstr "Option y Result" -#~ msgid "Vec" -#~ msgstr "Vec" - -#~ msgid "HashMap" -#~ msgstr "HashMap" - #~ msgid "Box" #~ msgstr "Box" #~ msgid "Recursive Data Types" #~ msgstr "Tipos de datos recursivos" -#~ msgid "Rc" -#~ msgstr "Rc" - #~ msgid "Iterators and Ownership" #~ msgstr "Iteradores y Ownership (Propiedad)" @@ -25120,15 +26847,9 @@ msgstr "" #~ msgid "Default Methods" #~ msgstr "Métodos por Default" -#~ msgid "impl Trait" -#~ msgstr "impl Trait" - #~ msgid "Important Traits" #~ msgstr "Traits Importantes" -#~ msgid "From and Into" -#~ msgstr "From e Into" - #~ msgid "Operators: Add, Mul, ..." #~ msgstr "Operadores: Add, Mul, …." @@ -25180,27 +26901,6 @@ msgstr "" #~ msgid "spin" #~ msgstr "girar" -#~ msgid "Send and Sync" -#~ msgstr "Send y 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 "Fijar" - #~ msgid "Day 1 Morning" #~ msgstr "Día 1: mañana" @@ -25745,9 +27445,6 @@ msgstr "" #~ msgid "`String` vs `str`" #~ msgstr "`String` o `str`" -#~ msgid "We can now understand the two string types in Rust:" -#~ msgstr "Ahora podemos entender los dos tipos de cadenas de Rust:" - #~ msgid "" #~ "You can borrow `&str` slices from `String` via `&` and optionally range " #~ "selection." @@ -26466,13 +28163,6 @@ msgstr "" #~ msgid "An exercise on pattern matching." #~ msgstr "Un ejercicio sobre coincidencia de patrones." -#~ msgid "" -#~ "Copy the code below to and implement the " -#~ "function." -#~ msgstr "" -#~ "Copia el siguiente fragmento de código en e " -#~ "implementa la función:" - #~ msgid "" #~ "Try to solve the problem the \"simple\" way first, using `for` loops and " #~ "integers. Then, revisit the solution and try to implement it with " @@ -27422,13 +29112,6 @@ msgstr "" #~ "(https://doc.rust-lang.org/std/ops/trait.Mul.html), ... se usan para " #~ "sobrecargar operadores, y" -#~ msgid "" -#~ "[`Default`](https://doc.rust-lang.org/std/default/trait.Default.html) " -#~ "used to construct a default instance of a type." -#~ msgstr "" -#~ "[`Default`](https://doc.rust-lang.org/std/default/trait.Default.html) se " -#~ "usa para construir una instancia predeterminada de un tipo." - #~ msgid "" #~ "`Iterator` implements `fn collect(self) -> B where B: " #~ "FromIterator, Self: Sized`"