Merge 3.11 into 3.10

github-actions · github-actions · commit 2c0b8a64ea65 · 2023-01-16T23:50:00.000Z
diff --git a/howto/regex.po b/howto/regex.po
@@ -196,6 +196,10 @@ msgid ""
 "``'$'``; ``'$'`` is usually a metacharacter, but inside a character class "
 "it's stripped of its special nature."
 msgstr ""
+"(``\\`` を除く) 特殊文字は文字クラスの内部では有効になりません。例えば、 "
+"``[akm$]`` は ``'a'``, ``'k'``, ``'m'``, または ``'{TX-PL-LABEL}#x27;`` のい"
+"ずれかにマッチします; ``'{TX-PL-LABEL}#x27;`` は通常は特殊文字ですが、文字ク"
+"ラス内部ではその特別な性質は取り除かれます。"
 
 #: ../../howto/regex.rst:97
 msgid ""
@@ -771,6 +775,11 @@ msgid ""
 "means the sequences will be invalid if raw string notation or escaping the "
 "backslashes isn't used."
 msgstr ""
+"それに加えて、正規表現では有効であるものの Python の文字列リテラルとしては有"
+"効でない特殊文字のエスケープシーケンスは、現在では :exc:`DeprecationWarning` "
+"を引き起こし、最終的には :exc:`SyntaxError` となります。すなわち、そのような"
+"シーケンスは raw string 記法を使うか、バックスラッシュによるエスケープを使わ"
+"ないかぎり無効になることを意味します。"
 
 #: ../../howto/regex.rst:341
 msgid "Regular String"
@@ -1017,6 +1026,11 @@ msgid ""
 "in a :exc:`DeprecationWarning` and will eventually become a :exc:"
 "`SyntaxError`.  See :ref:`the-backslash-plague`."
 msgstr ""
+"この例では、文字列リテラルを raw string リテラルにするプレフィックス ``r`` が"
+"必要です。これは、正規表現とは異なり、通常の \"調理済み\" 文字列リテラルにお"
+"けるエスケープシーケンスは Python では認識されないためであり、現在では :exc:"
+"`DeprecationWarning` を引き起こし、最終的には :exc:`SyntaxError` となります。"
+"詳しくは :ref:`the-backslash-plague` を参照してください。"
 
 #: ../../howto/regex.rst:480
 msgid ""
@@ -1025,6 +1039,10 @@ msgid ""
 "sequence of :ref:`match object <match-objects>` instances as an :term:"
 "`iterator`::"
 msgstr ""
+":meth:`~re.Pattern.findall` は結果を返す前に完全なリストを必ず生成してしまい"
+"ます。いっぽう :meth:`~re.Pattern.finditer` メソッドは :ref:`マッチオブジェク"
+"ト <match-objects>` インスタンスのシーケンスを :term:`iterator` として返しま"
+"す::"
 
 #: ../../howto/regex.rst:496
 msgid "Module-Level Functions"
@@ -1180,6 +1198,18 @@ msgid ""
 "lowercasing doesn't take the current locale into account; it will if you "
 "also set the :const:`LOCALE` flag."
 msgstr ""
+"大文字と小文字を区別しないマッチングを実行します; 文字クラスと文字列リテラル"
+"は大文字か小文字かに関係なくパターンにマッチします。例えば、 ``[A-Z]`` は小文"
+"字のアルファベットにもマッチします。 :const:`ASCII` フラグによって非 ASCII 文"
+"字のマッチングが無効化されていなければ、完全なユニコードのマッチングも可能で"
+"す。ユニコードで ``[a-z]`` または ``[A-Z]`` が :const:`IGNORECASE` フラグとと"
+"もに使われると、 52個の ASCII 文字に加えて 次の4つの 非 ASCII 文字にマッチし"
+"ます: 'İ' (U+0130, ラテン語の大文字 I で、上部に点がついたもの), "
+"'ı' (U+0131, ラテン語の小文字 i で上部に点がない), 'ſ' (U+017F, ラテン語の小"
+"文字 s),  'K' (U+212A, ケルビン記号)。 ``Spam`` は ``'Spam'``, ``'spam'``, "
+"``'spAM'``, そして ``'ſpam'`` にマッチします (ただし最後の文字列はユニコード"
+"モードの場合のみマッチします)。この「小文字化」は現在のロケールを考慮しませ"
+"ん; ただし :const:`LOCALE` フラグをセットした場合はロケールを考慮します。"
 
 #: ../../howto/regex.rst:580
 msgid ""
@@ -1207,6 +1237,22 @@ msgid ""
 "matching is already enabled by default in Python 3 for Unicode (str) "
 "patterns, and it is able to handle different locales/languages."
 msgstr ""
+"ロケールは言語の違いを考慮したプログラムを書くことを手助けすることを目的とし"
+"た C ライブラリの機能です。例えば、エンコードされたフランス語のテキストを処理"
+"していて、``\\w+`` を使って単語のマッチを行いたいとします。ですがこの場合、 "
+"``\\w`` はバイトパターンにおいて文字クラス ``[A-Za-z]`` だけにマッチします; "
+"すなわち ``é`` や ``ç`` に対応するバイト列にはマッチしません。もしシステムが"
+"適切に設定されていて、ロケールがフランス語に設定されていれば、ある C 関数はプ"
+"ログラムに ``é`` に対応するバイト列も文字として考慮するべきであると伝えます。"
+"正規表現をコンパイルするときに :const:`LOCALE` フラグを設定すると、コンパイル"
+"されたオブジェクトが ``\\w`` に対してロケールを考慮する C 関数を使うようにな"
+"ります; これにより処理は遅くなりますが、 ``\\w+`` を期待通りフランス語の単語"
+"にマッチさせることが可能になります。このフラグを Python 3 で利用することは推"
+"奨されません。なぜならロケールの仕組みは非常に信頼性が低く、同時にひとつの "
+"\"文化\" しか扱うことができず、また8ビットのロケールでしか正しく動作しないか"
+"らです。Python 3 ではユニコード (文字列の) パターンに対してユニコードのマッチ"
+"ングがデフォルトで有効化されており、これにより異なるロケールまたは言語を同時"
+"に扱うことができます。   "
 
 #: ../../howto/regex.rst:605
 msgid ""
@@ -1347,6 +1393,12 @@ msgid ""
 "``'Crow'`` or ``'Servo'``, not ``'Cro'``, a ``'w'`` or an ``'S'``, and "
 "``'ervo'``."
 msgstr ""
+"代替 (alternation) または \"or\" 演算子です。 *A* と *B* が正規表現の場合、 "
+"``A|B`` は *A* と *B* のどちらかにマッチするような文字列にマッチします。複数"
+"の文字からなる文字列による代替処理が適切に動作するために、 ``|`` の優先度は非"
+"常に低く設定されています。 ``Crow|Servo`` は ``'Crow'`` か ``'Servo'`` のどち"
+"らかにマッチするパターンであり、 「``'Cro'`` に続いて ``'w'`` または ``'S'`` "
+"があり、さらに ``'ervo'`` が続く」という意味ではありません。"
 
 #: ../../howto/regex.rst:702
 msgid ""
@@ -1745,13 +1797,18 @@ msgid ""
 "Additionally, you can retrieve named groups as a dictionary with :meth:`~re."
 "Match.groupdict`::"
 msgstr ""
+"さらに、名前付きのグループを :meth:`~re.Match.groupdict` を使って辞書として取"
+"り出すこともできます::"
 
 #: ../../howto/regex.rst:952
 msgid ""
 "Named groups are handy because they let you use easily remembered names, "
 "instead of having to remember numbers.  Here's an example RE from the :mod:"
 "`imaplib` module::"
 msgstr ""
+"名前つきグループは、番号を覚える代わりに簡単に覚えられる名前で管理できるた"
+"め、便利です。以下は :mod:`imaplib` モジュールで使われている正規表現の例で"
+"す::"
 
 #: ../../howto/regex.rst:963
 msgid ""
