# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001 Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: # python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-27 14:13+0000\n" "PO-Revision-Date: 2025-09-16 00:02+0000\n" "Last-Translator: python-doc bot, 2025\n" "Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/" "ja/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ja\n" "Plural-Forms: nplurals=1; plural=0;\n" #: ../../tutorial/stdlib2.rst:5 msgid "Brief Tour of the Standard Library --- Part II" msgstr "標準ライブラリミニツアー --- その 2" #: ../../tutorial/stdlib2.rst:7 msgid "" "This second tour covers more advanced modules that support professional " "programming needs. These modules rarely occur in small scripts." msgstr "" "ツアーの第2部では、プロフェッショナルプログラミングを支えるもっと高度なモ" "ジュールをカバーします。ここで挙げるモジュールは、小さなスクリプトの開発では" "ほとんど使いません。" #: ../../tutorial/stdlib2.rst:14 msgid "Output Formatting" msgstr "出力のフォーマット" #: ../../tutorial/stdlib2.rst:16 msgid "" "The :mod:`reprlib` module provides a version of :func:`repr` customized for " "abbreviated displays of large or deeply nested containers::" msgstr "" ":mod:`reprlib` モジュールは、大きなコンテナや、深くネストしたコンテナを省略し" "て表示するバージョンの :func:`repr` を提供しています::" #: ../../tutorial/stdlib2.rst:19 msgid "" ">>> import reprlib\n" ">>> reprlib.repr(set('supercalifragilisticexpialidocious'))\n" "\"{'a', 'c', 'd', 'e', 'f', 'g', ...}\"" msgstr "" #: ../../tutorial/stdlib2.rst:23 msgid "" "The :mod:`pprint` module offers more sophisticated control over printing " "both built-in and user defined objects in a way that is readable by the " "interpreter. When the result is longer than one line, the \"pretty printer\" " "adds line breaks and indentation to more clearly reveal data structure::" msgstr "" ":mod:`pprint` モジュールは、組み込み型やユーザ定義型をわかりやすく表示するた" "めの洗練された制御手段を提供しています。表示結果が複数行にわたる場合は、 " "\"pretty printer\" と呼ばれるものが改行やインデントを追加して、データ構造がよ" "り明確になるように印字します::" #: ../../tutorial/stdlib2.rst:28 msgid "" ">>> import pprint\n" ">>> t = [[[['black', 'cyan'], 'white', ['green', 'red']], [['magenta',\n" "... 'yellow'], 'blue']]]\n" "...\n" ">>> pprint.pprint(t, width=30)\n" "[[[['black', 'cyan'],\n" " 'white',\n" " ['green', 'red']],\n" " [['magenta', 'yellow'],\n" " 'blue']]]" msgstr "" #: ../../tutorial/stdlib2.rst:39 msgid "" "The :mod:`textwrap` module formats paragraphs of text to fit a given screen " "width::" msgstr "" ":mod:`textwrap` モジュールは、段落で構成された文章を、指定したスクリーン幅に" "ぴったり収まるように調整します::" #: ../../tutorial/stdlib2.rst:42 msgid "" ">>> import textwrap\n" ">>> doc = \"\"\"The wrap() method is just like fill() except that it " "returns\n" "... a list of strings instead of one big string with newlines to separate\n" "... the wrapped lines.\"\"\"\n" "...\n" ">>> print(textwrap.fill(doc, width=40))\n" "The wrap() method is just like fill()\n" "except that it returns a list of strings\n" "instead of one big string with newlines\n" "to separate the wrapped lines." msgstr "" #: ../../tutorial/stdlib2.rst:53 msgid "" "The :mod:`locale` module accesses a database of culture specific data " "formats. The grouping attribute of locale's format function provides a " "direct way of formatting numbers with group separators::" msgstr "" ":mod:`locale` モジュールは、文化により異なるデータ表現形式のデータベースにア" "クセスします。 :mod:`locale` の :func:`format` 関数の grouping 属性を使えば、" "数値を適切な桁区切り文字によりグループ化された形式に変換できます::" #: ../../tutorial/stdlib2.rst:57 msgid "" ">>> import locale\n" ">>> locale.setlocale(locale.LC_ALL, 'English_United States.1252')\n" "'English_United States.1252'\n" ">>> conv = locale.localeconv() # get a mapping of conventions\n" ">>> x = 1234567.8\n" ">>> locale.format_string(\"%d\", x, grouping=True)\n" "'1,234,567'\n" ">>> locale.format_string(\"%s%.*f\", (conv['currency_symbol'],\n" "... conv['frac_digits'], x), grouping=True)\n" "'$1,234,567.80'" msgstr "" #: ../../tutorial/stdlib2.rst:72 msgid "Templating" msgstr "文字列テンプレート" #: ../../tutorial/stdlib2.rst:74 msgid "" "The :mod:`string` module includes a versatile :class:`~string.Template` " "class with a simplified syntax suitable for editing by end-users. This " "allows users to customize their applications without having to alter the " "application." msgstr "" ":mod:`string` モジュールには、柔軟で、エンドユーザが簡単に編集できる簡単な構" "文を備えた :class:`~string.Template` クラスが入っています。このクラスを使う" "と、ユーザがアプリケーションを修正することなしにアプリケーションの出力をカス" "タマイズできるようになります。" #: ../../tutorial/stdlib2.rst:78 msgid "" "The format uses placeholder names formed by ``$`` with valid Python " "identifiers (alphanumeric characters and underscores). Surrounding the " "placeholder with braces allows it to be followed by more alphanumeric " "letters with no intervening spaces. Writing ``$$`` creates a single escaped " "``$``::" msgstr "" "テンプレートでは、``$`` と有効な Python 識別子名 (英数字とアンダースコア) か" "らなるプレースホルダ名を使います。プレースホルダの周りを {} で囲えば、プレー" "スホルダの後ろにスペースを挟まず、英数文字を続けることができます。``$$`` のよ" "うにすると、``$`` 自体をエスケープできます::" #: ../../tutorial/stdlib2.rst:83 msgid "" ">>> from string import Template\n" ">>> t = Template('${village}folk send $$10 to $cause.')\n" ">>> t.substitute(village='Nottingham', cause='the ditch fund')\n" "'Nottinghamfolk send $10 to the ditch fund.'" msgstr "" #: ../../tutorial/stdlib2.rst:88 msgid "" "The :meth:`~string.Template.substitute` method raises a :exc:`KeyError` when " "a placeholder is not supplied in a dictionary or a keyword argument. For " "mail-merge style applications, user supplied data may be incomplete and the :" "meth:`~string.Template.safe_substitute` method may be more appropriate --- " "it will leave placeholders unchanged if data is missing::" msgstr "" ":meth:`~string.Template.substitute` メソッドは、プレースホルダに相当する値が" "辞書やキーワード引数にない場合に :exc:`KeyError` を送出します。メールマージ機" "能のようなアプリケーションの場合、ユーザが入力するデータは不完全なことがある" "ので、欠落したデータがあるとプレースホルダをそのままにして出力する :meth:" "`~string.Template.safe_substitute` メソッドを使う方が適切かもしれません::" #: ../../tutorial/stdlib2.rst:94 msgid "" ">>> t = Template('Return the $item to $owner.')\n" ">>> d = dict(item='unladen swallow')\n" ">>> t.substitute(d)\n" "Traceback (most recent call last):\n" " ...\n" "KeyError: 'owner'\n" ">>> t.safe_substitute(d)\n" "'Return the unladen swallow to $owner.'" msgstr "" #: ../../tutorial/stdlib2.rst:103 msgid "" "Template subclasses can specify a custom delimiter. For example, a batch " "renaming utility for a photo browser may elect to use percent signs for " "placeholders such as the current date, image sequence number, or file " "format::" msgstr "" "区切り文字はデフォルトは ``$`` ですが、:class:`~string.Template` のサブクラス" "を派生すると変更することができます。例えば、画像ブラウザ用に一括で名前を変更" "するユーティリティを作っていたとして、現在の日付や画像のシーケンス番号、ファ" "イル形式といったプレースホルダにパーセント記号を使うことにしたら、次のように" "なります::" #: ../../tutorial/stdlib2.rst:107 msgid "" ">>> import time, os.path\n" ">>> photofiles = ['img_1074.jpg', 'img_1076.jpg', 'img_1077.jpg']\n" ">>> class BatchRename(Template):\n" "... delimiter = '%'\n" "...\n" ">>> fmt = input('Enter rename style (%d-date %n-seqnum %f-format): ')\n" "Enter rename style (%d-date %n-seqnum %f-format): Ashley_%n%f\n" "\n" ">>> t = BatchRename(fmt)\n" ">>> date = time.strftime('%d%b%y')\n" ">>> for i, filename in enumerate(photofiles):\n" "... base, ext = os.path.splitext(filename)\n" "... newname = t.substitute(d=date, n=i, f=ext)\n" "... print('{0} --> {1}'.format(filename, newname))\n" "\n" "img_1074.jpg --> Ashley_0.jpg\n" "img_1076.jpg --> Ashley_1.jpg\n" "img_1077.jpg --> Ashley_2.jpg" msgstr "" #: ../../tutorial/stdlib2.rst:126 msgid "" "Another application for templating is separating program logic from the " "details of multiple output formats. This makes it possible to substitute " "custom templates for XML files, plain text reports, and HTML web reports." msgstr "" "テンプレートのもう一つの用途は、複数ある出力フォーマットからのプログラムロ" "ジックの分離です。これにより、XMLファイル用、プレーンテキストのレポート用、" "HTMLのwebレポート用のテンプレートに、同じプログラムロジックから値を埋め込むこ" "とができます。" #: ../../tutorial/stdlib2.rst:134 msgid "Working with Binary Data Record Layouts" msgstr "バイナリデータレコードの操作" #: ../../tutorial/stdlib2.rst:136 msgid "" "The :mod:`struct` module provides :func:`~struct.pack` and :func:`~struct." "unpack` functions for working with variable length binary record formats. " "The following example shows how to loop through header information in a ZIP " "file without using the :mod:`zipfile` module. Pack codes ``\"H\"`` and " "``\"I\"`` represent two and four byte unsigned numbers respectively. The " "``\"<\"`` indicates that they are standard size and in little-endian byte " "order::" msgstr "" ":mod:`struct` モジュールでは、様々な長さのバイナリレコード形式を操作する :" "func:`~struct.pack` や :func:`~struct.unpack` といった関数を提供しています。 " "以下の例では、 :mod:`zipfile` モジュールを使わずに、ZIP ファイルのヘッダ情報" "を巡回する方法を示しています。``\"H\"`` と ``\"I\"`` というパック符号は、そ" "れぞれ2バイトと4バイトの符号無し 整数を表しています。 ``\"<\"`` は、そのパッ" "ク符号が standard サイズであり、バイトオーダーがリトルエンディアンであること" "を示しています::" #: ../../tutorial/stdlib2.rst:144 msgid "" "import struct\n" "\n" "with open('myfile.zip', 'rb') as f:\n" " data = f.read()\n" "\n" "start = 0\n" "for i in range(3): # show the first 3 file headers\n" " start += 14\n" " fields = struct.unpack('` で循環参照を除去" "します)。オブジェクトに対する最後の参照がなくなってしばらくするとメモリは解放" "されます。" #: ../../tutorial/stdlib2.rst:255 msgid "" "This approach works fine for most applications but occasionally there is a " "need to track objects only as long as they are being used by something else. " "Unfortunately, just tracking them creates a reference that makes them " "permanent. The :mod:`weakref` module provides tools for tracking objects " "without creating a reference. When the object is no longer needed, it is " "automatically removed from a weakref table and a callback is triggered for " "weakref objects. Typical applications include caching objects that are " "expensive to create::" msgstr "" "このようなアプローチはほとんどのアプリケーションでうまく動作しますが、中には" "オブジェクトをどこか別の場所で利用している間だけ追跡しておきたい場合もありま" "す。残念ながら、オブジェクトを追跡するだけでオブジェクトに対する恒久的な参照" "を作ることになってしまいます。 :mod:`weakref` モジュールでは、オブジェクトへ" "の参照を作らずに追跡するためのツールを提供しています。弱参照オブジェクトが不" "要になると、弱参照 (weakref) テーブルから自動的に除去され、コールバック関数が" "トリガされます。弱参照を使う典型的な応用例には、作成コストの大きいオブジェク" "トのキャッシュがあります::" #: ../../tutorial/stdlib2.rst:263 msgid "" ">>> import weakref, gc\n" ">>> class A:\n" "... def __init__(self, value):\n" "... self.value = value\n" "... def __repr__(self):\n" "... return str(self.value)\n" "...\n" ">>> a = A(10) # create a reference\n" ">>> d = weakref.WeakValueDictionary()\n" ">>> d['primary'] = a # does not create a reference\n" ">>> d['primary'] # fetch the object if it is still alive\n" "10\n" ">>> del a # remove the one reference\n" ">>> gc.collect() # run garbage collection right away\n" "0\n" ">>> d['primary'] # entry was automatically removed\n" "Traceback (most recent call last):\n" " File \"\", line 1, in \n" " d['primary'] # entry was automatically removed\n" " File \"C:/python314/lib/weakref.py\", line 46, in __getitem__\n" " o = self.data[key]()\n" "KeyError: 'primary'" msgstr "" #: ../../tutorial/stdlib2.rst:290 msgid "Tools for Working with Lists" msgstr "リスト操作のためのツール" #: ../../tutorial/stdlib2.rst:292 msgid "" "Many data structure needs can be met with the built-in list type. However, " "sometimes there is a need for alternative implementations with different " "performance trade-offs." msgstr "" "多くのデータ構造は、組み込みリスト型を使った実装で事足ります。とはいえ、時に" "は組み込みリストとは違うパフォーマンス上のトレードオフを持つような実装が必要" "になこともあります。" #: ../../tutorial/stdlib2.rst:296 msgid "" "The :mod:`array` module provides an :class:`~array.array` object that is " "like a list that stores only homogeneous data and stores it more compactly. " "The following example shows an array of numbers stored as two byte unsigned " "binary numbers (typecode ``\"H\"``) rather than the usual 16 bytes per entry " "for regular lists of Python int objects::" msgstr "" ":mod:`array` (配列) モジュールでは、:class:`~array.array` オブジェクトを提供" "しています。配列はリストに似ていますが、同種のデータのみを よりコンパクトに格" "納します。 以下の例に示すのは、通常 1 要素あたり 16 バイト使う Python の " "int オブジェクトのリストではなく、2 バイト使う符号無しバイナリ整数 (タイプ" "コード ``\"H\"``) の配列です::" #: ../../tutorial/stdlib2.rst:302 msgid "" ">>> from array import array\n" ">>> a = array('H', [4000, 10, 700, 22222])\n" ">>> sum(a)\n" "26932\n" ">>> a[1:3]\n" "array('H', [10, 700])" msgstr "" #: ../../tutorial/stdlib2.rst:309 msgid "" "The :mod:`collections` module provides a :class:`~collections.deque` object " "that is like a list with faster appends and pops from the left side but " "slower lookups in the middle. These objects are well suited for implementing " "queues and breadth first tree searches::" msgstr "" ":mod:`collections` モジュールでは、 :class:`~collections.deque` オブジェクト" "を提供しています。リスト型に似ていますが、データの追加と左端からの取り出しが" "速く、その一方で中間にある値の参照は遅くなります。こうしたオブジェクトは" "キューや木構造の幅優先探索の実装に向いています::" #: ../../tutorial/stdlib2.rst:314 msgid "" ">>> from collections import deque\n" ">>> d = deque([\"task1\", \"task2\", \"task3\"])\n" ">>> d.append(\"task4\")\n" ">>> print(\"Handling\", d.popleft())\n" "Handling task1" msgstr "" #: ../../tutorial/stdlib2.rst:322 msgid "" "unsearched = deque([starting_node])\n" "def breadth_first_search(unsearched):\n" " node = unsearched.popleft()\n" " for m in gen_moves(node):\n" " if is_goal(m):\n" " return m\n" " unsearched.append(m)" msgstr "" #: ../../tutorial/stdlib2.rst:330 msgid "" "In addition to alternative list implementations, the library also offers " "other tools such as the :mod:`bisect` module with functions for manipulating " "sorted lists::" msgstr "" "リストの代わりの実装以外にも、標準ライブラリにはソート済みのリストを操作する" "ための関数を備えた :mod:`bisect` のようなツールも提供しています::" #: ../../tutorial/stdlib2.rst:334 msgid "" ">>> import bisect\n" ">>> scores = [(100, 'perl'), (200, 'tcl'), (400, 'lua'), (500, 'python')]\n" ">>> bisect.insort(scores, (300, 'ruby'))\n" ">>> scores\n" "[(100, 'perl'), (200, 'tcl'), (300, 'ruby'), (400, 'lua'), (500, 'python')]" msgstr "" #: ../../tutorial/stdlib2.rst:340 msgid "" "The :mod:`heapq` module provides functions for implementing heaps based on " "regular lists. The lowest valued entry is always kept at position zero. " "This is useful for applications which repeatedly access the smallest element " "but do not want to run a full list sort::" msgstr "" ":mod:`heapq` モジュールは、通常のリストでヒープを実装するための関数を提供して" "います。ヒープでは、最も低い値をもつエントリがつねにゼロの位置に配置されま" "す。ヒープは、毎回リストをソートすることなく、最小の値をもつ要素に繰り返しア" "クセスするようなアプリケーションで便利です::" #: ../../tutorial/stdlib2.rst:345 msgid "" ">>> from heapq import heapify, heappop, heappush\n" ">>> data = [1, 3, 5, 7, 9, 2, 4, 6, 8, 0]\n" ">>> heapify(data) # rearrange the list into heap order\n" ">>> heappush(data, -5) # add a new entry\n" ">>> [heappop(data) for i in range(3)] # fetch the three smallest entries\n" "[-5, 0, 1]" msgstr "" #: ../../tutorial/stdlib2.rst:356 msgid "Decimal Floating-Point Arithmetic" msgstr "10 進浮動小数演算" #: ../../tutorial/stdlib2.rst:358 msgid "" "The :mod:`decimal` module offers a :class:`~decimal.Decimal` datatype for " "decimal floating-point arithmetic. Compared to the built-in :class:`float` " "implementation of binary floating point, the class is especially helpful for" msgstr "" ":mod:`decimal` モジュールでは、 10 進浮動小数の算術演算をサポートする :class:" "`~decimal.Decimal` データ型を提供しています。組み込みの 2 進浮動小数の実装で" "ある :class:`float` に比べて、このクラスがとりわけ便利なのは、以下の場合です" #: ../../tutorial/stdlib2.rst:362 msgid "" "financial applications and other uses which require exact decimal " "representation," msgstr "財務アプリケーションやその他の正確な10進表記が必要なアプリケーション、" #: ../../tutorial/stdlib2.rst:364 msgid "control over precision," msgstr "精度の制御、" #: ../../tutorial/stdlib2.rst:365 msgid "control over rounding to meet legal or regulatory requirements," msgstr "法的または規制上の理由に基づく値丸めの制御、" #: ../../tutorial/stdlib2.rst:366 msgid "tracking of significant decimal places, or" msgstr "有効桁数の追跡が必要になる場合" #: ../../tutorial/stdlib2.rst:367 msgid "" "applications where the user expects the results to match calculations done " "by hand." msgstr "ユーザが手計算の結果と同じ演算結果を期待するようなアプリケーション。" #: ../../tutorial/stdlib2.rst:370 msgid "" "For example, calculating a 5% tax on a 70 cent phone charge gives different " "results in decimal floating point and binary floating point. The difference " "becomes significant if the results are rounded to the nearest cent::" msgstr "" "例えば、70 セントの電話代にかかる 5% の税金を計算しようとすると、10 進の浮動" "小数点値と 2 進の浮動小数点値では違う結果になってしまいます。計算結果を四捨五" "入してセント単位にしようとすると、以下のように違いがはっきり現れます::" #: ../../tutorial/stdlib2.rst:374 msgid "" ">>> from decimal import *\n" ">>> round(Decimal('0.70') * Decimal('1.05'), 2)\n" "Decimal('0.74')\n" ">>> round(.70 * 1.05, 2)\n" "0.73" msgstr "" #: ../../tutorial/stdlib2.rst:380 msgid "" "The :class:`~decimal.Decimal` result keeps a trailing zero, automatically " "inferring four place significance from multiplicands with two place " "significance. Decimal reproduces mathematics as done by hand and avoids " "issues that can arise when binary floating point cannot exactly represent " "decimal quantities." msgstr "" "上の例で、:class:`~decimal.Decimal` を使った計算では、末尾桁のゼロが保存され" "ており、有効数字2桁の被乗数から自動的に有効数字を 4 桁と判断しています。:" "class:`~decimal.Decimal` は手計算と 同じ方法で計算を行い、2 進浮動小数が 10 " "進小数成分を正確に表現できないことに よって起きる問題を回避しています。" #: ../../tutorial/stdlib2.rst:386 msgid "" "Exact representation enables the :class:`~decimal.Decimal` class to perform " "modulo calculations and equality tests that are unsuitable for binary " "floating point::" msgstr "" ":class:`~decimal.Decimal` クラスは厳密な値を表現できるため、2 進浮動小数点数" "では 期待通りに計算できないような剰余の計算や等値テストも実現できます::" #: ../../tutorial/stdlib2.rst:390 msgid "" ">>> Decimal('1.00') % Decimal('.10')\n" "Decimal('0.00')\n" ">>> 1.00 % 0.10\n" "0.09999999999999995\n" "\n" ">>> sum([Decimal('0.1')]*10) == Decimal('1.0')\n" "True\n" ">>> 0.1 + 0.1 + 0.1 + 0.1 + 0.1 + 0.1 + 0.1 + 0.1 + 0.1 + 0.1 == 1.0\n" "False" msgstr "" #: ../../tutorial/stdlib2.rst:400 msgid "" "The :mod:`decimal` module provides arithmetic with as much precision as " "needed::" msgstr "" ":mod:`decimal` モジュールを使うと、必要なだけの精度で算術演算を行えます::" #: ../../tutorial/stdlib2.rst:402 msgid "" ">>> getcontext().prec = 36\n" ">>> Decimal(1) / Decimal(7)\n" "Decimal('0.142857142857142857142857142857142857')" msgstr ""