python
diff --git a/‎faq/programming.po‎
Lines changed: 135 additions & 43 deletions b/‎faq/programming.po‎
Lines changed: 135 additions & 43 deletions
@@ -22,7 +22,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.9\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2021-01-01 05:02+0000\n"
+"POT-Creation-Date: 2021-04-04 05:56+0000\n"
 "PO-Revision-Date: 2017-02-16 17:43+0000\n"
 "Last-Translator: mollinaca, 2020\n"
 "Language-Team: Japanese (https://www.transifex.com/python-doc/teams/5390/ja/)\n"
@@ -2172,14 +2172,106 @@ msgstr ""
 "を調べたいオブジェクトがまだ生きてることを保証したいなら、オブジェクトへの別の参照を作ってください:"
 
 #: ../../faq/programming.rst:1706
+msgid "When can I rely on identity tests with the *is* operator?"
+msgstr ""
+
+#: ../../faq/programming.rst:1708
+msgid ""
+"The ``is`` operator tests for object identity.  The test ``a is b`` is "
+"equivalent to ``id(a) == id(b)``."
+msgstr ""
+
+#: ../../faq/programming.rst:1711
+msgid ""
+"The most important property of an identity test is that an object is always "
+"identical to itself, ``a is a`` always returns ``True``.  Identity tests are"
+" usually faster than equality tests.  And unlike equality tests, identity "
+"tests are guaranteed to return a boolean ``True`` or ``False``."
+msgstr ""
+
+#: ../../faq/programming.rst:1716
+msgid ""
+"However, identity tests can *only* be substituted for equality tests when "
+"object identity is assured.  Generally, there are three circumstances where "
+"identity is guaranteed:"
+msgstr ""
+
+#: ../../faq/programming.rst:1720
+msgid ""
+"1) Assignments create new names but do not change object identity.  After "
+"the assignment ``new = old``, it is guaranteed that ``new is old``."
+msgstr ""
+
+#: ../../faq/programming.rst:1723
+msgid ""
+"2) Putting an object in a container that stores object references does not "
+"change object identity.  After the list assignment ``s[0] = x``, it is "
+"guaranteed that ``s[0] is x``."
+msgstr ""
+
+#: ../../faq/programming.rst:1727
+msgid ""
+"3) If an object is a singleton, it means that only one instance of that "
+"object can exist.  After the assignments ``a = None`` and ``b = None``, it "
+"is guaranteed that ``a is b`` because ``None`` is a singleton."
+msgstr ""
+
+#: ../../faq/programming.rst:1731
+msgid ""
+"In most other circumstances, identity tests are inadvisable and equality "
+"tests are preferred.  In particular, identity tests should not be used to "
+"check constants such as :class:`int` and :class:`str` which aren't "
+"guaranteed to be singletons::"
+msgstr ""
+
+#: ../../faq/programming.rst:1748
+msgid "Likewise, new instances of mutable containers are never identical::"
+msgstr ""
+
+#: ../../faq/programming.rst:1755
+msgid ""
+"In the standard library code, you will see several common patterns for "
+"correctly using identity tests:"
+msgstr ""
+
+#: ../../faq/programming.rst:1758
+msgid ""
+"1) As recommended by :pep:`8`, an identity test is the preferred way to "
+"check for ``None``.  This reads like plain English in code and avoids "
+"confusion with other objects that may have boolean values that evaluate to "
+"false."
+msgstr ""
+
+#: ../../faq/programming.rst:1762
+msgid ""
+"2) Detecting optional arguments can be tricky when ``None`` is a valid input"
+" value.  In those situations, you can create an singleton sentinel object "
+"guaranteed to be distinct from other objects.  For example, here is how to "
+"implement a method that behaves like :meth:`dict.pop`::"
+msgstr ""
+
+#: ../../faq/programming.rst:1778
+msgid ""
+"3) Container implementations sometimes need to augment equality tests with "
+"identity tests.  This prevents the code from being confused by objects such "
+"as ``float('NaN')`` that are not equal to themselves."
+msgstr ""
+
+#: ../../faq/programming.rst:1782
+msgid ""
+"For example, here is the implementation of "
+":meth:`collections.abc.Sequence.__contains__`::"
+msgstr ""
+
+#: ../../faq/programming.rst:1793
 msgid "Modules"
 msgstr "モジュール (module)"
 
-#: ../../faq/programming.rst:1709
+#: ../../faq/programming.rst:1796
 msgid "How do I create a .pyc file?"
 msgstr ".pyc ファイルを作るにはどうしますか？"
 
-#: ../../faq/programming.rst:1711
+#: ../../faq/programming.rst:1798
 msgid ""
 "When a module is imported for the first time (or when the source file has "
 "changed since the current compiled file was created) a ``.pyc`` file "
@@ -2196,7 +2288,7 @@ msgstr ""
 " で終わり、中間部分はこのファイルを作った ``python`` バイナリに依存した文字列になります。 (詳細は :pep:`3147` "
 "を参照してください。)"
 
-#: ../../faq/programming.rst:1719
+#: ../../faq/programming.rst:1806
 msgid ""
 "One reason that a ``.pyc`` file may not be created is a permissions problem "
 "with the directory containing the source file, meaning that the "
@@ -2207,7 +2299,7 @@ msgstr ""
 "``.pyc`` が作られない理由の 1 つは、ソースファイルがあるディレクトリの権限の問題、つまり ``__pycache__`` "
 "サブディレクトリが作れない問題です。これは、例えば、ウェブサーバーでテストを行っているときのような、開発者のユーザと実行者のユーザが別な場合に、起こり得ます。"
 
-#: ../../faq/programming.rst:1724
+#: ../../faq/programming.rst:1811
 msgid ""
 "Unless the :envvar:`PYTHONDONTWRITEBYTECODE` environment variable is set, "
 "creation of a .pyc file is automatic if you're importing a module and Python"
@@ -2219,7 +2311,7 @@ msgstr ""
 "``__pycache__`` サブディレクトリを作り、そこにコンパイルされたモジュールが置ける能力 (権限、ディスクの空きスペース、など) "
 "がある場合は、 .pyc ファイルは自動的に作られます。"
 
-#: ../../faq/programming.rst:1729
+#: ../../faq/programming.rst:1816
 msgid ""
 "Running Python on a top level script is not considered an import and no "
 "``.pyc`` will be created.  For example, if you have a top-level module "
@@ -2233,7 +2325,7 @@ msgstr ""
 "と打ち込んで) ``foo`` を実行すると、``xyz`` はインポートされるので ``xyz`` の ``.pyc`` "
 "は作成されますが、``foo.py`` はインポートされたわけではないので ``foo`` の ``.pyc`` は作られません。"
 
-#: ../../faq/programming.rst:1736
+#: ../../faq/programming.rst:1823
 msgid ""
 "If you need to create a ``.pyc`` file for ``foo`` -- that is, to create a "
 "``.pyc`` file for a module that is not imported -- you can, using the "
@@ -2242,15 +2334,15 @@ msgstr ""
 "``foo`` の ``.pyc`` ファイルを作成する -- つまり、インポートされていないモジュールの ``.pyc`` ファイルを作成する -- "
 "必要がある場合、 :mod:`py_compile` モジュールと :mod:`compileall` モジュールを使えば可能です。"
 
-#: ../../faq/programming.rst:1740
+#: ../../faq/programming.rst:1827
 msgid ""
 "The :mod:`py_compile` module can manually compile any module.  One way is to"
 " use the ``compile()`` function in that module interactively::"
 msgstr ""
 ":mod:`py_compile` モジュールは手動で任意のモジュールをコンパイルできます。やり方の一つは、このモジュールの ``compile()``"
 " 関数をインタラクティブに実行することです::"
 
-#: ../../faq/programming.rst:1746
+#: ../../faq/programming.rst:1833
 msgid ""
 "This will write the ``.pyc`` to a ``__pycache__`` subdirectory in the same "
 "location as ``foo.py`` (or you can override that with the optional parameter"
@@ -2259,7 +2351,7 @@ msgstr ""
 "このように実行すると、``foo.py`` と同じ場所の ``__pycache__`` サブディレクトリに ``.pyc`` が書き出されます "
 "(出力ファイルの位置は、オプション引数 ``cfile`` で上書きすることもできます)。"
 
-#: ../../faq/programming.rst:1750
+#: ../../faq/programming.rst:1837
 msgid ""
 "You can also automatically compile all files in a directory or directories "
 "using the :mod:`compileall` module.  You can do it from the shell prompt by "
@@ -2269,11 +2361,11 @@ msgstr ""
 ":mod:`compileall` モジュールを使えば自動的に一つや複数のディレクトリのすべてのファイルをコンパイルできます。シェルプロンプトから "
 "``compileall.py`` を起動して、コンパイルしたいファイルを含むディレクトリのパスを指定してください::"
 
-#: ../../faq/programming.rst:1759
+#: ../../faq/programming.rst:1846
 msgid "How do I find the current module name?"
 msgstr "現在のモジュール名を知るにはどうしますか？"
 
-#: ../../faq/programming.rst:1761
+#: ../../faq/programming.rst:1848
 msgid ""
 "A module can find out its own module name by looking at the predefined "
 "global variable ``__name__``.  If this has the value ``'__main__'``, the "
@@ -2286,78 +2378,78 @@ msgstr ""
 "であるとき、そのプログラムはスクリプトとして実行されています。インポートされることによって使われる大抵のモジュールはコマンドラインインターフェースや自己テストも提供していて、``__name__``"
 " をチェックしてからそのコードだけを実行します::"
 
-#: ../../faq/programming.rst:1776
+#: ../../faq/programming.rst:1863
 msgid "How can I have modules that mutually import each other?"
 msgstr "相互にインポートしあうモジュールを作るにはどうしたらいいですか？"
 
-#: ../../faq/programming.rst:1778
+#: ../../faq/programming.rst:1865
 msgid "Suppose you have the following modules:"
 msgstr "以下のモジュールがあったとしましょう:"
 
-#: ../../faq/programming.rst:1780
+#: ../../faq/programming.rst:1867
 msgid "foo.py::"
 msgstr "foo.py::"
 
-#: ../../faq/programming.rst:1785
+#: ../../faq/programming.rst:1872
 msgid "bar.py::"
 msgstr "bar.py::"
 
-#: ../../faq/programming.rst:1790
+#: ../../faq/programming.rst:1877
 msgid "The problem is that the interpreter will perform the following steps:"
 msgstr "問題はインタプリタが以下の段階を実行することです:"
 
-#: ../../faq/programming.rst:1792
+#: ../../faq/programming.rst:1879
 msgid "main imports foo"
 msgstr "main が foo をインポートする"
 
-#: ../../faq/programming.rst:1793
+#: ../../faq/programming.rst:1880
 msgid "Empty globals for foo are created"
 msgstr "foo の空のグローバルが生成される"
 
-#: ../../faq/programming.rst:1794
+#: ../../faq/programming.rst:1881
 msgid "foo is compiled and starts executing"
 msgstr "foo がコンパイルされ実行を始める"
 
-#: ../../faq/programming.rst:1795
+#: ../../faq/programming.rst:1882
 msgid "foo imports bar"
 msgstr "foo が bar をインポートする"
 
-#: ../../faq/programming.rst:1796
+#: ../../faq/programming.rst:1883
 msgid "Empty globals for bar are created"
 msgstr "bar の空のグローバルが生成される"
 
-#: ../../faq/programming.rst:1797
+#: ../../faq/programming.rst:1884
 msgid "bar is compiled and starts executing"
 msgstr "bar がコンパイルされ実行を始める"
 
-#: ../../faq/programming.rst:1798
+#: ../../faq/programming.rst:1885
 msgid ""
 "bar imports foo (which is a no-op since there already is a module named foo)"
 msgstr "bar が foo をインポートする(すでに foo という名前のモジュールがあるので no-op となる)"
 
-#: ../../faq/programming.rst:1799
+#: ../../faq/programming.rst:1886
 msgid "bar.foo_var = foo.foo_var"
 msgstr "bar.foo_var = foo.foo_var"
 
-#: ../../faq/programming.rst:1801
+#: ../../faq/programming.rst:1888
 msgid ""
 "The last step fails, because Python isn't done with interpreting ``foo`` yet"
 " and the global symbol dictionary for ``foo`` is still empty."
 msgstr ""
 "この最後の段階は失敗します。Python が ``foo`` を解釈し終わっていなくて、``foo`` のグローバルなシンボルの辞書はまだ空ですから。"
 
-#: ../../faq/programming.rst:1804
+#: ../../faq/programming.rst:1891
 msgid ""
 "The same thing happens when you use ``import foo``, and then try to access "
 "``foo.foo_var`` in global code."
 msgstr ""
 "``import foo`` を使って、グローバルコードの ``foo.foo_var`` にアクセスしようとしたときにも、これと同じことが起こります。"
 
-#: ../../faq/programming.rst:1807
+#: ../../faq/programming.rst:1894
 msgid "There are (at least) three possible workarounds for this problem."
 msgstr "この問題には (少なくとも) 三つの解決策があります。"
 
-#: ../../faq/programming.rst:1809
+#: ../../faq/programming.rst:1896
 msgid ""
 "Guido van Rossum recommends avoiding all uses of ``from <module> import "
 "...``, and placing all code inside functions.  Initializations of global "
@@ -2369,61 +2461,61 @@ msgstr ""
 "を全く使わないで、すべてのコードを関数の中に入れることを勧めています。グローバル変数とクラス変数の初期化は定数とビルトイン関数のみで行われるべきです。これでインポートされたすべてのモジュールは"
 " ``<module>.<name>`` として参照されることになります。"
 
-#: ../../faq/programming.rst:1814
+#: ../../faq/programming.rst:1901
 msgid ""
 "Jim Roskind suggests performing steps in the following order in each module:"
 msgstr "Jim Roskind はそれぞれのモジュールに対して以下の順に進めることを提案しています:"
 
-#: ../../faq/programming.rst:1816
+#: ../../faq/programming.rst:1903
 msgid ""
 "exports (globals, functions, and classes that don't need imported base "
 "classes)"
 msgstr "エクスポート (インポートされた基底クラスを必要としないグローバル、関数、クラス)"
 
-#: ../../faq/programming.rst:1818
+#: ../../faq/programming.rst:1905
 msgid "``import`` statements"
 msgstr "``import`` 文"
 
-#: ../../faq/programming.rst:1819
+#: ../../faq/programming.rst:1906
 msgid ""
 "active code (including globals that are initialized from imported values)."
 msgstr "アクティブなコード (インポートされた値によって初期化されるグローバルを含む)。"
 
-#: ../../faq/programming.rst:1821
+#: ../../faq/programming.rst:1908
 msgid ""
 "van Rossum doesn't like this approach much because the imports appear in a "
 "strange place, but it does work."
 msgstr "インポートが奇妙な場所に現れることから van Rossum はこの方法をそれほど好みませんが、これは有効です。"
 
-#: ../../faq/programming.rst:1824
+#: ../../faq/programming.rst:1911
 msgid ""
 "Matthias Urlichs recommends restructuring your code so that the recursive "
 "import is not necessary in the first place."
 msgstr "Matthias Urlichs は第一に再帰インポートが必要ないようにコードを構築しなおすことを推奨しています。"
 
-#: ../../faq/programming.rst:1827
+#: ../../faq/programming.rst:1914
 msgid "These solutions are not mutually exclusive."
 msgstr "これらの解決策はそれぞれ両立させることもできます。"
 
-#: ../../faq/programming.rst:1831
+#: ../../faq/programming.rst:1918
 msgid "__import__('x.y.z') returns <module 'x'>; how do I get z?"
 msgstr "__import__('x.y.z') は <module 'x'> を返しますが、z を得るためにはどうしますか？"
 
-#: ../../faq/programming.rst:1833
+#: ../../faq/programming.rst:1920
 msgid ""
 "Consider using the convenience function :func:`~importlib.import_module` "
 "from :mod:`importlib` instead::"
 msgstr ""
 ":mod:`importlib` に :func:`~importlib.import_module` "
 "という便利な関数があるので、代わりにそちらを使用することを検討してください。"
 
-#: ../../faq/programming.rst:1840
+#: ../../faq/programming.rst:1927
 msgid ""
 "When I edit an imported module and reimport it, the changes don't show up.  "
 "Why does this happen?"
 msgstr "インポートされたモジュールを編集してから再インポートしましたが、変化が現れません。なぜですか？"
 
-#: ../../faq/programming.rst:1842
+#: ../../faq/programming.rst:1929
 msgid ""
 "For reasons of efficiency as well as consistency, Python only reads the "
 "module file on the first time a module is imported.  If it didn't, in a "
@@ -2434,13 +2526,13 @@ msgstr ""
 "効率と一貫性上の理由から、Python "
 "はモジュールが最初にインポートされた時にのみモジュールファイルを読み込みます。そうしないと、たくさんのモジュールでできていて、それぞれが同じ基本モジュールをインポートしているようなプログラムでは、その基本モジュールの解析と再解析が繰り返されることになります。変更されさたモジュールの再読込を強制するには、こうしてください::"
 
-#: ../../faq/programming.rst:1852
+#: ../../faq/programming.rst:1939
 msgid ""
 "Warning: this technique is not 100% fool-proof.  In particular, modules "
 "containing statements like ::"
 msgstr "注意:この手法は 100%安全とは言えません。とりわけ ::"
 
-#: ../../faq/programming.rst:1857
+#: ../../faq/programming.rst:1944
 msgid ""
 "will continue to work with the old version of the imported objects.  If the "
 "module contains class definitions, existing class instances will *not* be "
@@ -2450,7 +2542,7 @@ msgstr ""
 "のような文を含むモジュールは、インポートされたオブジェクトの古いバージョンを使い続けます。そのモジュールにクラス定義が含まれていたら、存在するクラスインスタンスは新しいクラス定義を使うようにアップデート"
 " *されません*。これによって以下の矛盾した振舞いがなされえます::"
 
-#: ../../faq/programming.rst:1870
+#: ../../faq/programming.rst:1957
 msgid ""
 "The nature of the problem is made clear if you print out the \"identity\" of"
 " the class objects::"