foundations/dictionaryの翻訳

Author: sbtseiji

crates/typst-library/src/foundations/dict.rs

@@ -29,26 +29,24 @@ macro_rules! __dict {
 #[doc(inline)]
 pub use crate::__dict as dict;
 
-/// A map from string keys to values.
+/// 文字列をキーとする、値のマップです。
 ///
-/// You can construct a dictionary by enclosing comma-separated `key: value`
-/// pairs in parentheses. The values do not have to be of the same type. Since
-/// empty parentheses already yield an empty array, you have to use the special
-/// `(:)` syntax to create an empty dictionary.
+/// コンマ区切りの`キー: 値`ペアを括弧で囲むことで辞書を生成できます。
+/// 値は同じ型である必要はありません。空の括弧`()`は空の配列を生成するため、
+/// 空の辞書を作成するには特殊な`(:)`構文を使用する必要があります。
 ///
-/// A dictionary is conceptually similar to an array, but it is indexed by
-/// strings instead of integers. You can access and create dictionary entries
-/// with the `.at()` method. If you know the key statically, you can
-/// alternatively use [field access notation]($scripting/#fields) (`.key`) to
-/// access the value. Dictionaries can be added with the `+` operator and
-/// [joined together]($scripting/#blocks). To check whether a key is present in
-/// the dictionary, use the `in` keyword.
+/// 辞書は概念的に配列と似ていますが、整数でインデックスがつけられる代わりに
+/// 文字列が用いられます。辞書のエントリには`.at()`メソッドでアクセスしたり、
+/// 作成したりできます。キーがあらかじめ分かっている場合は、代わりに
+/// [フィールドアクセス記法]($scripting/#fields) (`.key`)を使って値にアクセス
+/// することもできます。辞書は`+`演算子で加算したり、
+/// [結合したり]($scripting/#blocks)できます。キーが辞書内に存在するか
+/// どうかを確認するには、`in`キーワードを使用してください。
 ///
-/// You can iterate over the pairs in a dictionary using a [for
-/// loop]($scripting/#loops). This will iterate in the order the pairs were
-/// inserted / declared.
+/// 辞書内のペアを[forループ]($scripting/#loops)を使って反復処理することも
+/// できます。その場合、辞書のエントリは挿入または宣言された順に反復処理されます。
 ///
-/// # Example
+/// # 例
 /// ```example
 /// #let dict = (
 ///   name: "Typst",
@@ -160,40 +158,40 @@ impl Dict {
 
 #[scope]
 impl Dict {
-    /// Converts a value into a dictionary.
+    /// 値を辞書に変換します。
     ///
-    /// Note that this function is only intended for conversion of a
-    /// dictionary-like value to a dictionary, not for creation of a dictionary
-    /// from individual pairs. Use the dictionary syntax `(key: value)` instead.
+    /// この関数は、辞書形式の値を辞書に変換することのみを目的としており、個々の値ペアから
+    /// 辞書を作成するためのものではありません。個々の値ペアから辞書を作成する場合は、
+    /// 辞書の構文`(キー: 値)`を使用してください。
+
+
     ///
     /// ```example
     /// #dictionary(sys).at("version")
     /// ```
     #[func(constructor)]
     pub fn construct(
-        /// The value that should be converted to a dictionary.
+        /// 辞書に変換する値。
         value: ToDict,
     ) -> Dict {
         value.0
     }
 
-    /// The number of pairs in the dictionary.
+    /// 辞書に含まれるペアの個数。
     #[func(title = "Length")]
     pub fn len(&self) -> usize {
         self.0.len()
     }
 
-    /// Returns the value associated with the specified key in the dictionary.
-    /// May be used on the left-hand side of an assignment if the key is already
-    /// present in the dictionary. Returns the default value if the key is not
-    /// part of the dictionary or fails with an error if no default value was
-    /// specified.
+    /// 指定されたキーに対応する辞書内の値を返します。キーがすでに辞書内に存在する場合、
+    /// 代入演算子の左辺で使用できます。キーが辞書に存在しない場合、デフォルト値を返し、
+    /// デフォルト値が指定されていない場合はエラーになります。
     #[func]
     pub fn at(
         &self,
-        /// The key at which to retrieve the item.
+        /// 辞書項目を取得するためのキー。
         key: Str,
-        /// A default value to return if the key is not part of the dictionary.
+        /// キーが辞書内にない場合に返されるデフォルト値。
         #[named]
         default: Option<Value>,
     ) -> StrResult<Value> {
@@ -204,26 +202,26 @@ impl Dict {
             .ok_or_else(|| missing_key_no_default(&key))
     }
 
-    /// Inserts a new pair into the dictionary. If the dictionary already
-    /// contains this key, the value is updated.
+    /// 新しいペアを辞書に挿入します。すでにこのキー辞書にが含まれている場合、
+    /// 値は更新されます。
     #[func]
     pub fn insert(
         &mut self,
-        /// The key of the pair that should be inserted.
+        /// 挿入するペアのキー。
         key: Str,
-        /// The value of the pair that should be inserted.
+        /// 挿入するペアの値。
         value: Value,
     ) {
         Arc::make_mut(&mut self.0).insert(key, value);
     }
 
-    /// Removes a pair from the dictionary by key and return the value.
+    /// キーを指定して辞書からペアを削除し、その値を返します。
     #[func]
     pub fn remove(
         &mut self,
-        /// The key of the pair to remove.
+        /// 削除するペアのキー。
         key: Str,
-        /// A default value to return if the key does not exist.
+        /// キーが辞書内にない場合に返されるデフォルト値。
         #[named]
         default: Option<Value>,
     ) -> StrResult<Value> {
@@ -233,20 +231,20 @@ impl Dict {
             .ok_or_else(|| missing_key(&key))
     }
 
-    /// Returns the keys of the dictionary as an array in insertion order.
+    /// 辞書のキーを、挿入された順序で配列として返します。
     #[func]
     pub fn keys(&self) -> Array {
         self.0.keys().cloned().map(Value::Str).collect()
     }
 
-    /// Returns the values of the dictionary as an array in insertion order.
+    /// 辞書の値を、挿入された順序で配列として返します。
     #[func]
     pub fn values(&self) -> Array {
         self.0.values().cloned().collect()
     }
 
-    /// Returns the keys and values of the dictionary as an array of pairs. Each
-    /// pair is represented as an array of length two.
+    /// 辞書のキーと値を、ペアの配列として返します。各ペアは
+    /// 長さ2の配列として表現されます。
     #[func]
     pub fn pairs(&self) -> Array {
         self.0

website/translation-status.json

@@ -22,7 +22,7 @@
 	"/docs/reference/foundations/content/": "untranslated",
 	"/docs/reference/foundations/datetime/": "untranslated",
 	"/docs/reference/foundations/decimal/": "untranslated",
-	"/docs/reference/foundations/dictionary/": "untranslated",
+	"/docs/reference/foundations/dictionary/": "translated",
 	"/docs/reference/foundations/duration/": "untranslated",
 	"/docs/reference/foundations/eval/": "untranslated",
 	"/docs/reference/foundations/float/": "untranslated",