Merge 3.11 into 3.10

github-actions · github-actions · commit f72e6d047212 · 2024-03-04T23:50:46.000Z
diff --git a/library/stdtypes.po b/library/stdtypes.po
@@ -6586,6 +6586,10 @@ msgid ""
 "to signify a :class:`set` in which all the elements are of type :class:"
 "`bytes`."
 msgstr ""
+"コンテナクラスに対してクラスの :ref:`添字表記 <subscriptions>` に与えられた単"
+"一または複数の引数は、そのオブジェクトが包含する要素の型をあらわします。たと"
+"えば ``set[bytes]`` という表記は、全ての要素が :class:`bytes` であるような :"
+"class:`set` をあらわす型アノテーションとして使うことができます。"
 
 #: ../../library/stdtypes.rst:4823
 msgid ""
@@ -6595,6 +6599,11 @@ msgid ""
 "object. For example, :mod:`regular expressions <re>` can be used on both "
 "the :class:`str` data type and the :class:`bytes` data type:"
 msgstr ""
+":meth:`~object.__class_getitem__` メソッドを定義しているけれどもコンテナでな"
+"いクラスに対しては、クラスの添字表記に与えられた単一または複数の引数は、しば"
+"しばオブジェクトに定義された単一または複数のメソッドの戻り値の型をあらわしま"
+"す。たとえば、 :mod:`正規表現操作 <re>` は :class:`str` と :class:`bytes` の"
+"両方のデータ型に対して使うことができます:"
 
 #: ../../library/stdtypes.rst:4829
 msgid ""
@@ -6603,6 +6612,10 @@ msgid ""
 "both be of type :class:`str`. We can represent this kind of object in type "
 "annotations with the ``GenericAlias`` ``re.Match[str]``."
 msgstr ""
+"``x = re.search('foo', 'foo')`` とした場合、 ``x`` は :ref:`re.Match <match-"
+"objects>` オブジェクトとなり、 ``x.group(0)`` と ``x[0]`` の戻り値はどちら"
+"も :class:`str` となります。このようなオブジェクトは、 ``GenericAlias`` を"
+"使った型アノテーション ``re.Match[str]`` で表現することができます。"
 
 #: ../../library/stdtypes.rst:4835
 msgid ""
@@ -6612,20 +6625,32 @@ msgid ""
 "annotations, we would represent this variety of :ref:`re.Match <match-"
 "objects>` objects with ``re.Match[bytes]``."
 msgstr ""
+"``y = re.search(b'bar', b'bar')`` (ここで ``b`` は :class:`bytes` 型をあらわ"
+"します) とした場合、``y`` もまた ``re.Match`` のインスタンスとなりますが、 "
+"``y.group(0)`` と ``y[0]`` の戻り値はどちらも :class:`bytes` 型になります。型"
+"アノテーションでは、このような :ref:`re.Match <match-objects>` オブジェクト"
+"は ``re.Match[bytes]`` と表現することになるでしょう。"
 
 #: ../../library/stdtypes.rst:4841
 msgid ""
 "``GenericAlias`` objects are instances of the class :class:`types."
 "GenericAlias`, which can also be used to create ``GenericAlias`` objects "
 "directly."
 msgstr ""
+"``GenericAlias`` オブジェクトは :class:`types.GenericAlias` クラスのインスタ"
+"ンスです。このクラスは直接 ``GenericAlias`` オブジェクトを生成するのに使うこ"
+"ともできます。"
 
 #: ../../library/stdtypes.rst:4847
 msgid ""
 "Creates a ``GenericAlias`` representing a type ``T`` parameterized by types "
 "*X*, *Y*, and more depending on the ``T`` used. For example, a function "
 "expecting a :class:`list` containing :class:`float` elements::"
 msgstr ""
+"型 \"X\", \"Y\", またはさらに多くの引数でパラメータ化される型 ``T`` を表現す"
+"る ``GenericAlias`` を生成します。引数の数は ``T`` の使われ方によって決まりま"
+"す。たとえば、 :class:`float` 型の要素を含む :class:`list` を引数にとる関数の"
+"型アノテーションは次のようになります::"
 
 #: ../../library/stdtypes.rst:4855
 msgid ""
@@ -6634,12 +6659,18 @@ msgid ""
 "the value type.  In this example, the function expects a ``dict`` with keys "
 "of type :class:`str` and values of type :class:`int`::"
 msgstr ""
+"もうひとつの例として :term:`mapping` オブジェクトの場合を示します。ここでは"
+"キーと値の2つの型をパラメータとするジェネリック型である :class:`dict` を使っ"
+"ています。この例では、関数はキーが :class:`str` 型、値が :class:`int` 型であ"
+"るような ``dict`` を引数にとります::"
 
 #: ../../library/stdtypes.rst:4863
 msgid ""
 "The builtin functions :func:`isinstance` and :func:`issubclass` do not "
 "accept ``GenericAlias`` types for their second argument::"
 msgstr ""
+"組み込み関数 :func:`isinstance` と :func:`issubclass` は第二引数として "
+"``GenericAlias`` 型を指定することはできません::"
 
 #: ../../library/stdtypes.rst:4871
 msgid ""
@@ -6649,31 +6680,45 @@ msgid ""
 "not checked against their type. For example, the following code is "
 "discouraged, but will run without errors::"
 msgstr ""
+"Python 実行時には :term:`型アノテーション <annotation>` は強制されません。こ"
+"の性質はジェネリック型とその型パラメータにもおよびます。 ``GenericAlias`` か"
+"らコンテナオブジェクトを生成した場合、コンテナ内の要素は型のチェックを受けま"
+"せん。たとえば、以下のコードは推奨されませんが、エラーになることなく実行でき"
+"ます::"
 
 #: ../../library/stdtypes.rst:4881
 msgid ""
 "Furthermore, parameterized generics erase type parameters during object "
 "creation::"
 msgstr ""
+"しかも、パラメータ付きジェネリック型は、オブジェクト生成時にパラメータの型情"
+"報を削除します::"
 
 #: ../../library/stdtypes.rst:4892
 msgid ""
 "Calling :func:`repr` or :func:`str` on a generic shows the parameterized "
 "type::"
 msgstr ""
+":func:`repr` や :func:`str` のジェネリック型に対する呼び出しは、パラメータ型"
+"を表示します::"
 
 #: ../../library/stdtypes.rst:4900
 msgid ""
 "The :meth:`~object.__getitem__` method of generic containers will raise an "
 "exception to disallow mistakes like ``dict[str][str]``::"
 msgstr ""
+"ジェネリックコンテナ型の :meth:`~object.__getitem__` メソッドは、 ``dict[str]"
+"[str]`` のようなミスを許さないように、例外を送出します::"
 
 #: ../../library/stdtypes.rst:4908
 msgid ""
 "However, such expressions are valid when :ref:`type variables <generics>` "
 "are used.  The index must have as many elements as there are type variable "
 "items in the ``GenericAlias`` object's :attr:`~genericalias.__args__`. ::"
 msgstr ""
+"一方で、同様の式は :ref:`型変数 <generics>` が使われた場合は有効です。添字の"
+"数は``GenericAlias`` オブジェクトの :attr:`~genericalias.__args__` 属性におけ"
+"る型変数の数と同じでなければなりません::"
 
 #: ../../library/stdtypes.rst:4919
 msgid "Standard Generic Classes"
