python
diff --git a/‎library/functools.po
Lines changed: 50 additions & 42 deletions b/‎library/functools.po
Lines changed: 50 additions & 42 deletions
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.6\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2018-10-24 14:42+0900\n"
+"POT-Creation-Date: 2018-11-26 14:59+0900\n"
 "PO-Revision-Date: 2018-06-29 17:32+0000\n"
 "Last-Translator: tomo🐧, 2018\n"
 "Language-Team: Japanese (https://www.transifex.com/python-doc/teams/5390/ja/)\n"
@@ -69,7 +69,7 @@ msgstr ""
 "場合には正の数を返す、あらゆる呼び出し可能オブジェクトです。key "
 "関数は呼び出し可能オブジェクトで、1つの引数を受け取り、ソートキーとして使われる値を返します。"
 
-#: ../../library/functools.rst:37 ../../library/functools.rst:221
+#: ../../library/functools.rst:37 ../../library/functools.rst:226
 msgid "Example::"
 msgstr "以下はプログラム例です::"
 
@@ -153,10 +153,18 @@ msgstr ""
 "に最も効率が良くなります。キャッシュのサイズ制限は、キャッシュがウェブサーバーなどの長期間に渡るプロセスにおける限界を超えては大きくならないことを保証します。"
 
 #: ../../library/functools.rst:83
+msgid ""
+"In general, the LRU cache should only be used when you want to reuse "
+"previously computed values.  Accordingly, it doesn't make sense to cache "
+"functions with side-effects, functions that need to create distinct mutable "
+"objects on each call, or impure functions such as time() or random()."
+msgstr ""
+
+#: ../../library/functools.rst:88
 msgid "Example of an LRU cache for static web content::"
 msgstr "静的 web コンテンツ の LRU キャッシュの例::"
 
-#: ../../library/functools.rst:102
8000 +#: ../../library/functools.rst:107
 msgid ""
 "Example of efficiently computing `Fibonacci numbers "
 "<https://en.wikipedia.org/wiki/Fibonacci_number>`_ using a cache to "
@@ -166,11 +174,11 @@ msgstr ""
 "キャッシュを使って `動的計画法 <https://ja.wikipedia.org/wiki/動的計画法>`_ の技法を実装し、`フィボナッチ数 "
 "<https://ja.wikipedia.org/wiki/フィボナッチ数>`_ を効率よく計算する例::"
 
-#: ../../library/functools.rst:122
+#: ../../library/functools.rst:127
 msgid "Added the *typed* option."
 msgstr "*typed* オプションが追加されました。"
 
-#: ../../library/functools.rst:127
+#: ../../library/functools.rst:132
 msgid ""
 "Given a class defining one or more rich comparison ordering methods, this "
 "class decorator supplies the rest.  This simplifies the effort involved in "
@@ -179,7 +187,7 @@ msgstr ""
 "ひとつ以上の拡張順序比較メソッド (rich comparison ordering methods) "
 "を定義したクラスを受け取り、残りを実装するクラスデコレータです。このデコレータは全ての拡張順序比較演算をサポートするための労力を軽減します:"
 
-#: ../../library/functools.rst:131
+#: ../../library/functools.rst:136
6D40
 msgid ""
 "The class must define one of :meth:`__lt__`, :meth:`__le__`, :meth:`__gt__`,"
 " or :meth:`__ge__`. In addition, the class should supply an :meth:`__eq__` "
@@ -188,11 +196,11 @@ msgstr ""
 "引数のクラスは、 :meth:`__lt__`, :meth:`__le__`, :meth:`__gt__`, :meth:`__ge__` "
 "の中からどれか1つと、 :meth:`__eq__` メソッドを定義する必要があります。"
 
-#: ../../library/functools.rst:135
+#: ../../library/functools.rst:140
 msgid "For example::"
 msgstr "例えば::"
 
-#: ../../library/functools.rst:155
+#: ../../library/functools.rst:160
 msgid ""
 "While this decorator makes it easy to create well behaved totally ordered "
 "types, it *does* come at the cost of slower execution and more complex stack"
@@ -203,13 +211,13 @@ msgstr ""
 "このデコレータにより、完全に順序の付いた振る舞いの良い型を簡単に作ることができますが、実行速度は遅くなり、派生した比較メソッドのスタックトレースは複雑になります。性能ベンチマークにより、これがアプリケーションのボトルネックになっていることがわかった場合は、代わりに"
 " 6 つの拡張比較メソッドをすべて実装すれば、簡単にスピードアップを図れるでしょう。"
 
-#: ../../library/functools.rst:164
+#: ../../library/functools.rst:169
 msgid ""
 "Returning NotImplemented from the underlying comparison function for "
 "unrecognised types is now supported."
 msgstr "認識できない型に対して下層の比較関数から NotImplemented を返すことがサポートされるようになりました。"
 
-#: ../../library/functools.rst:170
+#: ../../library/functools.rst:175
 msgid ""
 "Return a new :ref:`partial object<partial-objects>` which when called will "
 "behave like *func* called with the positional arguments *args* and keyword "
@@ -218,7 +226,7 @@ msgid ""
 "extend and override *keywords*. Roughly equivalent to::"
 msgstr ""
 
-#: ../../library/functools.rst:187
+#: ../../library/functools.rst:192
 msgid ""
 "The :func:`partial` is used for partial function application which "
 "\"freezes\" some portion of a function's arguments and/or keywords resulting"
@@ -231,7 +239,7 @@ msgstr ""
 ":func:`partial` を使って *base* 引数のデフォルトが 2 である :func:`int` "
 "関数のように振る舞う呼び出し可能オブジェクトを作ることができます:"
 
-#: ../../library/functools.rst:202
+#: ../../library/functools.rst:207
 msgid ""
 "Return a new :class:`partialmethod` descriptor which behaves like "
 ":class:`partial` except that it is designed to be used as a method "
@@ -240,15 +248,15 @@ msgstr ""
 ":class:`partial` と似た動作をする新しい :class:`partialmethod` 記述子 (デスクリプタ) "
 "を返します。直接呼び出しではなく、メソッド定義としての使用が目的であることのみが、partial とは異なります。"
 
-#: ../../library/functools.rst:206
+#: ../../library/functools.rst:211
 msgid ""
 "*func* must be a :term:`descriptor` or a callable (objects which are both, "
 "like normal functions, are handled as descriptors)."
 msgstr ""
 "*func* は、:term:`descriptor` または呼び出し可能オブジェクトである必要があります "
 "(通常の関数など、両方の性質を持つオブジェクトは記述子として扱われます。)"
 
-#: ../../library/functools.rst:209
+#: ../../library/functools.rst:214
 msgid ""
 "When *func* is a descriptor (such as a normal Python function, "
 ":func:`classmethod`, :func:`staticmethod`, :func:`abstractmethod` or another"
@@ -257,7 +265,7 @@ msgid ""
 "objects>` returned as the result."
 msgstr ""
 
-#: ../../library/functools.rst:215
+#: ../../library/functools.rst:220
 msgid ""
 "When *func* is a non-descriptor callable, an appropriate bound method is "
 "created dynamically. This behaves like a normal Python function when used as"
@@ -269,7 +277,7 @@ msgstr ""
 "は、メソッドとして使用された場合、Python の通常の関数と同様に動作します。 :class:`partialmethod` コンストラクタに "
 "*args* と *keywords* が渡されるよりも前に、 *self* 引数が最初の位置引数として挿入されます。"
 
-#: ../../library/functools.rst:246
+#: ../../library/functools.rst:251
 msgid ""
 "Apply *function* of two arguments cumulatively to the items of *sequence*, "
 "from left to right, so as to reduce the sequence to a single value.  For "
@@ -288,18 +296,18 @@ msgstr ""
 "が存在する場合、計算の際にイテラブルの先頭に置かれ、またイテラブルが空の場合のデフォルトになります。*initializer* "
 "が与えられておらず、*iterable* が単一の要素しか持っていない場合、最初の要素が返されます。"
 
-#: ../../library/functools.rst:255
+#: ../../library/functools.rst:260
 msgid "Roughly equivalent to::"
 msgstr "およそ次と等価です::"
 
-#: ../../library/functools.rst:270
+#: ../../library/functools.rst:275
 msgid ""
 "Transform a function into a :term:`single-dispatch <single dispatch>` "
 ":term:`generic function`."
 msgstr ""
 "関数を :term:`シングルディスパッチ <single dispatch>` :term:`generic function` に変換します。"
 
-#: ../../library/functools.rst:273
+#: ../../library/functools.rst:278
 msgid ""
 "To define a generic function, decorate it with the ``@singledispatch`` "
 "decorator. Note that the dispatch happens on the type of the first argument,"
@@ -308,7 +316,7 @@ msgstr ""
 "汎用関数を定義するには、 ``@singledispatch`` デコレータでデコレートします。ディスパッチは 1 "
 "つ目の引数の型で行われることに注意して、関数を次のように作成してください::"
 
-#: ../../library/functools.rst:284
+#: ../../library/functools.rst:289
 msgid ""
 "To add overloaded implementations to the function, use the :func:`register` "
 "attribute of the generic function.  It is a decorator, taking a type "
@@ -318,13 +326,13 @@ msgstr ""
 "関数にオーバーロード実装を追加するには、汎用関数の :func:`register` "
 "属性を使用します。この属性は、型引数を取り、その型の操作を実装する関数をデコレートするデコレータです::"
 
-#: ../../library/functools.rst:302
+#: ../../library/functools.rst:307
 msgid ""
 "To enable registering lambdas and pre-existing functions, the "
 ":func:`register` attribute can be used in a functional form::"
 msgstr ":func:`register` 属性を関数形式で使用すると、lambda 関数と既存の関数の登録を有効にできます::"
 
-#: ../../library/functools.rst:310
+#: ../../library/functools.rst:315
 msgid ""
 "The :func:`register` attribute returns the undecorated function which "
 "enables decorator stacking, pickling, as well as creating unit tests for "
@@ -333,13 +341,13 @@ msgstr ""
 " :func:`register` 属性は、デコレートされていない関数を返します。この関数により、複層デコレータ、デコレータの pickle "
 "化、各変数の独立なユニットテストの作成が可能です::"
 
-#: ../../library/functools.rst:324
+#: ../../library/functools.rst:329
 msgid ""
 "When called, the generic function dispatches on the type of the first "
 "argument::"
 msgstr "汎用関数は、呼び出されると 1 つ目の引数の型でディスパッチします::"
 
-#: ../../library/functools.rst:344
+#: ../../library/functools.rst:349
 msgid ""
 "Where there is no registered implementation for a specific type, its method "
 "resolution order is used to find a more generic implementation. The original"
@@ -350,19 +358,19 @@ msgstr ""
 "特定の型について登録された実装が存在しない場合、その型のメソッド解決順序が、汎用の実装をさらに検索するために使用されます。``@singledispatch``"
 " でデコレートされた元の関数は基底の ``object`` 型に登録されます。これは、他によりよい実装が見つからないことを意味します。"
 
-#: ../../library/functools.rst:350
+#: ../../library/functools.rst:355
 msgid ""
 "To check which implementation will the generic function choose for a given "
 "type, use the ``dispatch()`` attribute::"
 msgstr "指定された型に対して、汎用関数がどの実装を選択するかを確認するには、``dispatch()``  属性を使用します::"
 
-#: ../../library/functools.rst:358
+#: ../../library/functools.rst:363
 msgid ""
 "To access all registered implementations, use the read-only ``registry`` "
 "attribute::"
 msgstr "登録されたすべての実装にアクセスするには、読み出し専用の ``registry`` 属性を使用します::"
 
-#: ../../library/functools.rst:375
+#: ../../library/functools.rst:380
 msgid ""
 "Update a *wrapper* function to look like the *wrapped* function. The "
 "optional arguments are tuples to specify which attributes of the original "
@@ -381,7 +389,7 @@ msgstr ""
 "``__qualname__``, ``__annotations__`` そしてドキュメンテーション文字列 ``__doc__`` に代入する) と "
 "``WRAPPER_UPDATES`` (これはラッパー関数の ``__dict__`` すなわちインスタンス辞書をアップデートする) です。"
 
-#: ../../library/functools.rst:385
+#: ../../library/functools.rst:390
 msgid ""
 "To allow access to the original function for introspection and other "
 "purposes (e.g. bypassing a caching decorator such as :func:`lru_cache`), "
@@ -391,7 +399,7 @@ msgstr ""
 "内観や別の目的 (例えば、 :func:`lru_cache` のようなキャッシュするデコレータの回避) "
 "のために元の関数にア�
1241
��セスできるように、この関数はラップされている関数を参照するラッパーに自動的に ``__wrapped__`` 属性を追加します。"
 
-#: ../../library/functools.rst:390
+#: ../../library/functools.rst:395
 msgid ""
 "The main intended use for this function is in :term:`decorator` functions "
 "which wrap the decorated function and return the wrapper. If the wrapper "
@@ -402,7 +410,7 @@ msgstr ""
 "この関数は主に関数を包んでラッパーを返す :term:`デコレータ <decorator>` "
 "関数の中で使われるよう意図されています。もしラッパー関数がアップデートされないとすると、返される関数のメタデータは元の関数の定義ではなくラッパー関数の定義を反映してしまい、これは通常あまり有益ではありません。"
 
-#: ../../library/functools.rst:396
+#: ../../library/functools.rst:401
 msgid ""
 ":func:`update_wrapper` may be used with callables other than functions. Any "
 "attributes named in *assigned* or *updated* that are missing from the object"
@@ -415,19 +423,19 @@ msgstr ""
 "(すなわち、ラッパー関数にそれらの属性を設定しようとは試みられません)。しかし、 *updated* で指名された属性がラッパー関数自身に存在しないなら"
 " :exc:`AttributeError` が送出されます。"
 
-#: ../../library/functools.rst:402
+#: ../../library/functools.rst:407
 msgid "Automatic addition of the ``__wrapped__`` attribute."
 msgstr "``__wrapped__`` 属性の自動的な追加。"
 
-#: ../../library/functools.rst:405
+#: ../../library/functools.rst:410
 msgid "Copying of the ``__annotations__`` attribute by default."
 msgstr "デフォルトで ``__annotations__`` 属性がコピーされます。"
 
-#: ../../library/functools.rst:408
+#: ../../library/functools.rst:413
 msgid "Missing attributes no longer trigger an :exc:`AttributeError`."
 msgstr "存在しない属性によって :exc:`AttributeError` を発生しなくなりました。"
 
-#: ../../library/functools.rst:411
+#: ../../library/functools.rst:416
 msgid ""
 "The ``__wrapped__`` attribute now always refers to the wrapped function, "
 "even if that function defined a ``__wrapped__`` attribute. (see "
@@ -436,7 +444,7 @@ msgstr ""
 "ラップされた関数が ``__wrapped__`` を定義していない場合でも、 ``__wrapped__`` "
 "が常にラップされた関数を参照するようになりました。(:issue:`17482` を参照)"
 
-#: ../../library/functools.rst:419
+#: ../../library/functools.rst:424
 msgid ""
 "This is a convenience function for invoking :func:`update_wrapper` as a "
 "function decorator when defining a wrapper function.  It is equivalent to "
@@ -447,7 +455,7 @@ msgstr ""
 "``partial(update_wrapper, wrapped=wrapped, assigned=assigned, "
 "updated=updated)`` と等価です。例えば::"
 
-#: ../../library/functools.rst:445
+#: ../../library/functools.rst:450
 msgid ""
 "Without the use of this decorator factory, the name of the example function "
 "would have been ``'wrapper'``, and the docstring of the original "
@@ -456,39 +464,39 @@ msgstr ""
 "このデコレータ・ファクトリを使用しないと、上の例中の関数の名前は ``'wrapper'`` となり、元の :func:`example` "
 "のドキュメンテーション文字列は失われてしまいます。"
 
-#: ../../library/functools.rst:453
+#: ../../library/functools.rst:458
 msgid ":class:`partial` Objects"
 msgstr ":class:`partial` オブジェクト"
 
-#: ../../library/functools.rst:455
+#: ../../library/functools.rst:460
 msgid ""
 ":class:`partial` objects are callable objects created by :func:`partial`. "
 "They have three read-only attributes:"
 msgstr ""
 ":class:`partial` オブジェクトは、 :func:`partial` "
 "関数によって作られる呼び出し可能オブジェクトです。オブジェクトには読み出し専用の属性が三つあります:"
 
-#: ../../library/functools.rst:461
+#: ../../library/functools.rst:466
 msgid ""
 "A callable object or function.  Calls to the :class:`partial` object will be"
 " forwarded to :attr:`func` with new arguments and keywords."
 msgstr ""
 "呼び出し可能オブジェクトまたは関数です。 :class:`partial` オブジェクトの呼び出しは新しい引数とキーワードと共に "
 ":attr:`func` に転送されます。"
 
-#: ../../library/functools.rst:467
+#: ../../library/functools.rst:472
 msgid ""
 "The leftmost positional arguments that will be prepended to the positional "
 "arguments provided to a :class:`partial` object call."
 msgstr "最左の位置引数で、 :class:`partial` オブジェクトの呼び出し時にその呼び出しの際の位置引数の前に追加されます。"
 
-#: ../../library/functools.rst:473
+#: ../../library/functools.rst:478
 msgid ""
 "The keyword arguments that will be supplied when the :class:`partial` object"
 " is called."
 msgstr ":class:`partial` オブジェクトの呼び出し時に渡されるキーワード引数です。"
 
-#: ../../library/functools.rst:476
+#: ../../library/functools.rst:481
 msgid ""
 ":class:`partial` objects are like :class:`function` objects in that they are"
 " callable, weak referencable, and can have attributes.  There are some "