configparser.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2025, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# tomo, 2021
# Osamu NAKAMURA, 2021
# souma987, 2023
# Takanori Suzuki <takanori@takanory.net>, 2023
# Yusuke Miyazaki <miyazaki.dev@gmail.com>, 2023
# Arihiro TAKASE, 2023
# Masato HASHIMOTO <cabezon.hashimoto@gmail.com>, 2023
# Taichi Haradaguchi, 2024
# 石井明久, 2024
# Takeshi Nakazato, 2024
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-03-28 14:18+0000\n"
"PO-Revision-Date: 2021-06-28 00:57+0000\n"
"Last-Translator: Takeshi Nakazato, 2024\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"

#: ../../library/configparser.rst:2
msgid ":mod:`!configparser` --- Configuration file parser"
msgstr ":mod:`!configparser` --- 設定ファイルのパーサー"

#: ../../library/configparser.rst:14
msgid "**Source code:** :source:`Lib/configparser.py`"
msgstr "**ソースコード:** :source:`Lib/configparser.py`"

#: ../../library/configparser.rst:24
msgid ""
"This module provides the :class:`ConfigParser` class which implements a "
"basic configuration language which provides a structure similar to what's "
"found in Microsoft Windows INI files.  You can use this to write Python "
"programs which can be customized by end users easily."
msgstr ""
"このモジュールは、 Microsoft Windows の INI ファイルに似た構造を持ったベー"
"シックな設定用言語を実装した :class:`ConfigParser` クラスを提供します。このク"
"ラスを使ってユーザーが簡単にカスタマイズできる Python プログラムを作ることが"
"できます。"

#: ../../library/configparser.rst:31
msgid ""
"This library does *not* interpret or write the value-type prefixes used in "
"the Windows Registry extended version of INI syntax."
msgstr ""
"このライブラリでは、Windowsのレジストリ用に拡張された INI 文法はサポート *し"
"ていません* 。"

#: ../../library/configparser.rst:36
msgid "Module :mod:`tomllib`"
msgstr "モジュール :mod:`tomllib`"

#: ../../library/configparser.rst:37
msgid ""
"TOML is a well-specified format for application configuration files. It is "
"specifically designed to be an improved version of INI."
msgstr ""

#: ../../library/configparser.rst:40
msgid "Module :mod:`shlex`"
msgstr ":mod:`shlex` モジュール"

#: ../../library/configparser.rst:41
msgid ""
"Support for creating Unix shell-like mini-languages which can also be used "
"for application configuration files."
msgstr ""
"アプリケーション設定ファイルにも使える、Unix シェルに似たミニ言語の作成を支援"
"します。"

#: ../../library/configparser.rst:44
msgid "Module :mod:`json`"
msgstr ":mod:`json` モジュール"

#: ../../library/configparser.rst:45
msgid ""
"The ``json`` module implements a subset of JavaScript syntax which is "
"sometimes used for configuration, but does not support comments."
msgstr ""

#: ../../library/configparser.rst:61
msgid "Quick Start"
msgstr "クイックスタート"

#: ../../library/configparser.rst:63
msgid "Let's take a very basic configuration file that looks like this:"
msgstr "次のような、非常に簡単な設定ファイルを例に考えましょう:"

#: ../../library/configparser.rst:65
msgid ""
"[DEFAULT]\n"
"ServerAliveInterval = 45\n"
"Compression = yes\n"
"CompressionLevel = 9\n"
"ForwardX11 = yes\n"
"\n"
"[forge.example]\n"
"User = hg\n"
"\n"
"[topsecret.server.example]\n"
"Port = 50022\n"
"ForwardX11 = no"
msgstr ""

#: ../../library/configparser.rst:80
msgid ""
"The structure of INI files is described `in the following section "
"<#supported-ini-file-structure>`_.  Essentially, the file consists of "
"sections, each of which contains keys with values. :mod:`configparser` "
"classes can read and write such files.  Let's start by creating the above "
"configuration file programmatically."
msgstr ""
"INI ファイルの構造は `下のセクション <#supported-ini-file-structure>`_ で解説"
"します。\n"
"基本的に、ファイルは複数のセクションからなり、各セクションは複数のキーと値を"
"持ちます。\n"
":mod:`configparser` のクラス群はそれらのファイルを読み書きできます。\n"
"まずは上のような設定ファイルをプログラムから作成してみましょう。"

#: ../../library/configparser.rst:86
msgid ""
">>> import configparser\n"
">>> config = configparser.ConfigParser()\n"
">>> config['DEFAULT'] = {'ServerAliveInterval': '45',\n"
"...                      'Compression': 'yes',\n"
"...                      'CompressionLevel': '9'}\n"
">>> config['forge.example'] = {}\n"
">>> config['forge.example']['User'] = 'hg'\n"
">>> config['topsecret.server.example'] = {}\n"
">>> topsecret = config['topsecret.server.example']\n"
">>> topsecret['Port'] = '50022'     # mutates the parser\n"
">>> topsecret['ForwardX11'] = 'no'  # same here\n"
">>> config['DEFAULT']['ForwardX11'] = 'yes'\n"
">>> with open('example.ini', 'w') as configfile:\n"
"...   config.write(configfile)\n"
"..."
msgstr ""

#: ../../library/configparser.rst:104
msgid ""
"As you can see, we can treat a config parser much like a dictionary. There "
"are differences, `outlined later <#mapping-protocol-access>`_, but the "
"behavior is very close to what you would expect from a dictionary."
msgstr ""
"この例でわかるように、config parser は辞書のように扱うことができます。辞書と"
"の違いは `後に <#mapping-protocol-access>`_ 説明しますが、このインターフェイ"
"スは辞書に対して期待するのととても近い動作をします。"

#: ../../library/configparser.rst:108
msgid ""
"Now that we have created and saved a configuration file, let's read it back "
"and explore the data it holds."
msgstr ""
"これで設定ファイルを作成して保存できました。次はこれを読み込み直して、中の"
"データを取り出してみましょう。"

#: ../../library/configparser.rst:111
msgid ""
">>> config = configparser.ConfigParser()\n"
">>> config.sections()\n"
"[]\n"
">>> config.read('example.ini')\n"
"['example.ini']\n"
">>> config.sections()\n"
"['forge.example', 'topsecret.server.example']\n"
">>> 'forge.example' in config\n"
"True\n"
">>> 'python.org' in config\n"
"False\n"
">>> config['forge.example']['User']\n"
"'hg'\n"
">>> config['DEFAULT']['Compression']\n"
"'yes'\n"
">>> topsecret = config['topsecret.server.example']\n"
">>> topsecret['ForwardX11']\n"
"'no'\n"
">>> topsecret['Port']\n"
"'50022'\n"
">>> for key in config['forge.example']:\n"
"...     print(key)\n"
"user\n"
"compressionlevel\n"
"serveraliveinterval\n"
"compression\n"
"forwardx11\n"
">>> config['forge.example']['ForwardX11']\n"
"'yes'"
msgstr ""

#: ../../library/configparser.rst:143
msgid ""
"As we can see above, the API is pretty straightforward.  The only bit of "
"magic involves the ``DEFAULT`` section which provides default values for all "
"other sections [1]_.  Note also that keys in sections are case-insensitive "
"and stored in lowercase [1]_."
msgstr ""
"上の例からわかるように、API はとても直感的です。唯一の魔術は、``DEFAULT`` セ"
"クションが他の全てのセクションのためのデフォルト値を提供していることです "
"[1]_。 また、セクション内の各キーは大文字小文字を区別せず、全て小文字で保存さ"
"れていることにも注意してください [1]_。"

#: ../../library/configparser.rst:148 ../../library/configparser.rst:1003
msgid ""
"It is possible to read several configurations into a single :class:"
"`ConfigParser`, where the most recently added configuration has the highest "
"priority. Any conflicting keys are taken from the more recent configuration "
"while the previously existing keys are retained. The example below reads in "
"an ``override.ini`` file, which will override any conflicting keys from the "
"``example.ini`` file."
msgstr ""

#: ../../library/configparser.rst:155 ../../library/configparser.rst:1010
msgid ""
"[DEFAULT]\n"
"ServerAliveInterval = -1"
msgstr ""

#: ../../library/configparser.rst:160 ../../library/configparser.rst:1015
msgid ""
">>> config_override = configparser.ConfigParser()\n"
">>> config_override['DEFAULT'] = {'ServerAliveInterval': '-1'}\n"
">>> with open('override.ini', 'w') as configfile:\n"
"...     config_override.write(configfile)\n"
"...\n"
">>> config_override = configparser.ConfigParser()\n"
">>> config_override.read(['example.ini', 'override.ini'])\n"
"['example.ini', 'override.ini']\n"
">>> print(config_override.get('DEFAULT', 'ServerAliveInterval'))\n"
"-1"
msgstr ""

#: ../../library/configparser.rst:174
msgid ""
"This behaviour is equivalent to a :meth:`ConfigParser.read` call with "
"several files passed to the *filenames* parameter."
msgstr ""

#: ../../library/configparser.rst:179
msgid "Supported Datatypes"
msgstr "サポートされるデータ型"

#: ../../library/configparser.rst:181
msgid ""
"Config parsers do not guess datatypes of values in configuration files, "
"always storing them internally as strings.  This means that if you need "
"other datatypes, you should convert on your own:"
msgstr ""
"Config parser は値のデータ型について何も推論せず、常に文字列のまま内部に保存"
"します。他のデータ型が必要な場合は自分で変換する必要があります:"

#: ../../library/configparser.rst:185
msgid ""
">>> int(topsecret['Port'])\n"
"50022\n"
">>> float(topsecret['CompressionLevel'])\n"
"9.0"
msgstr ""

#: ../../library/configparser.rst:192
msgid ""
"Since this task is so common, config parsers provide a range of handy getter "
"methods to handle integers, floats and booleans.  The last one is the most "
"interesting because simply passing the value to ``bool()`` would do no good "
"since ``bool('False')`` is still ``True``.  This is why config parsers also "
"provide :meth:`~ConfigParser.getboolean`.  This method is case-insensitive "
"and recognizes Boolean values from ``'yes'``/``'no'``, ``'on'``/``'off'``, "
"``'true'``/``'false'`` and ``'1'``/``'0'`` [1]_.  For example:"
msgstr ""
"このタスクはとても一般的なため、設定パーサーでは整数、浮動小数点数、真偽値を"
"扱うための手頃なゲッターメソッドが提供されています。真偽値の扱いは一筋縄では"
"いきません。文字列を ``bool()`` に渡しても、 ``bool('False')`` が ``True`` に"
"なってしまいます。そこで config parser は :meth:`~ConfigParser.getboolean` を"
"提供しています。このメソッドは大文字小文字を区別せず、 ``'yes'``/``'no'``、"
"``'on'``/``'off'``、``'true'``/``'false'``、``'1'``/``'0'`` を真偽値として認"
"識します [1]_。例えば:"

#: ../../library/configparser.rst:200
msgid ""
">>> topsecret.getboolean('ForwardX11')\n"
"False\n"
">>> config['forge.example'].getboolean('ForwardX11')\n"
"True\n"
">>> config.getboolean('forge.example', 'Compression')\n"
"True"
msgstr ""

#: ../../library/configparser.rst:209
msgid ""
"Apart from :meth:`~ConfigParser.getboolean`, config parsers also provide "
"equivalent :meth:`~ConfigParser.getint` and :meth:`~ConfigParser.getfloat` "
"methods.  You can register your own converters and customize the provided "
"ones. [1]_"
msgstr ""
"config parser では、 :meth:`~ConfigParser.getboolean` 以外に :meth:"
"`~ConfigParser.getint` と :meth:`~ConfigParser.getfloat` メソッドも提供されて"
"います。独自のコンバーターの登録、提供されたメソッドのカスタマイズもできま"
"す。 [1]_"

#: ../../library/configparser.rst:215
msgid "Fallback Values"
msgstr "代替値"

#: ../../library/configparser.rst:217
msgid ""
"As with a dictionary, you can use a section's :meth:`~ConfigParser.get` "
"method to provide fallback values:"
msgstr ""

#: ../../library/configparser.rst:220
msgid ""
">>> topsecret.get('Port')\n"
"'50022'\n"
">>> topsecret.get('CompressionLevel')\n"
"'9'\n"
">>> topsecret.get('Cipher')\n"
">>> topsecret.get('Cipher', '3des-cbc')\n"
"'3des-cbc'"
msgstr ""

#: ../../library/configparser.rst:230
msgid ""
"Please note that default values have precedence over fallback values. For "
"instance, in our example the ``'CompressionLevel'`` key was specified only "
"in the ``'DEFAULT'`` section.  If we try to get it from the section "
"``'topsecret.server.example'``, we will always get the default, even if we "
"specify a fallback:"
msgstr ""
"デフォルト値は代替値よりも優先されることに注意してください。例えば上の例で"
"は、``'CompressionLevel'`` キーは ``'DEFAULT'`` セクションにしか存在しませ"
"ん。その値を ``'topsecret.server.example'`` から取得しようとした場合、代替値"
"を指定しても常にデフォルト値を返します:"

#: ../../library/configparser.rst:236
msgid ""
">>> topsecret.get('CompressionLevel', '3')\n"
"'9'"
msgstr ""

#: ../../library/configparser.rst:241
msgid ""
"One more thing to be aware of is that the parser-level :meth:`~ConfigParser."
"get` method provides a custom, more complex interface, maintained for "
"backwards compatibility.  When using this method, a fallback value can be "
"provided via the ``fallback`` keyword-only argument:"
msgstr ""

#: ../../library/configparser.rst:246
msgid ""
">>> config.get('forge.example', 'monster',\n"
"...            fallback='No such things as monsters')\n"
"'No such things as monsters'"
msgstr ""

#: ../../library/configparser.rst:252
msgid ""
"The same ``fallback`` argument can be used with the :meth:`~ConfigParser."
"getint`, :meth:`~ConfigParser.getfloat` and :meth:`~ConfigParser.getboolean` "
"methods, for example:"
msgstr ""
"同様の ``fallback`` 引数を、:meth:`~ConfigParser.getint` 、 :meth:"
"`~ConfigParser.getfloat` と :meth:`~ConfigParser.getboolean` メソッドでも使え"
"ます。例えば:"

#: ../../library/configparser.rst:256
msgid ""
">>> 'BatchMode' in topsecret\n"
"False\n"
">>> topsecret.getboolean('BatchMode', fallback=True)\n"
"True\n"
">>> config['DEFAULT']['BatchMode'] = 'no'\n"
">>> topsecret.getboolean('BatchMode', fallback=True)\n"
"False"
msgstr ""

#: ../../library/configparser.rst:268
msgid "Supported INI File Structure"
msgstr "サポートするINI ファイルの構造"

#: ../../library/configparser.rst:270
msgid ""
"A configuration file consists of sections, each led by a ``[section]`` "
"header, followed by key/value entries separated by a specific string (``=`` "
"or ``:`` by default [1]_).  By default, section names are case sensitive but "
"keys are not [1]_.  Leading and trailing whitespace is removed from keys and "
"values. Values can be omitted if the parser is configured to allow it [1]_, "
"in which case the key/value delimiter may also be left out.  Values can also "
"span multiple lines, as long as they are indented deeper than the first line "
"of the value.  Depending on the parser's mode, blank lines may be treated as "
"parts of multiline values or ignored."
msgstr ""

#: ../../library/configparser.rst:280
msgid ""
"By default, a valid section name can be any string that does not contain '\\"
"\\n'. To change this, see :attr:`ConfigParser.SECTCRE`."
msgstr ""

#: ../../library/configparser.rst:283
msgid ""
"The first section name may be omitted if the parser is configured to allow "
"an unnamed top level section with ``allow_unnamed_section=True``. In this "
"case, the keys/values may be retrieved by :const:`UNNAMED_SECTION` as in "
"``config[UNNAMED_SECTION]``."
msgstr ""

#: ../../library/configparser.rst:288
msgid ""
"Configuration files may include comments, prefixed by specific characters "
"(``#`` and ``;`` by default [1]_).  Comments may appear on their own on an "
"otherwise empty line, possibly indented. [1]_"
msgstr ""
"設定ファイルには先頭に特定の文字 (デフォルトでは ``#`` および ``;`` [1]_) を"
"つけてコメントをつけることができます。コメントは、他の内容がない行に置くこと"
"ができ、インデントされていても構いません。[1]_"

#: ../../library/configparser.rst:292 ../../library/configparser.rst:376
msgid "For example:"
msgstr "例えば:"

#: ../../library/configparser.rst:294
msgid ""
"[Simple Values]\n"
"key=value\n"
"spaces in keys=allowed\n"
"spaces in values=allowed as well\n"
"spaces around the delimiter = obviously\n"
"you can also use : to delimit keys from values\n"
"\n"
"[All Values Are Strings]\n"
"values like this: 1000000\n"
"or this: 3.14159265359\n"
"are they treated as numbers? : no\n"
"integers, floats and booleans are held as: strings\n"
"can use the API to get converted values directly: true\n"
"\n"
"[Multiline Values]\n"
"chorus: I'm a lumberjack, and I'm okay\n"
"    I sleep all night and I work all day\n"
"\n"
"[No Values]\n"
"key_without_value\n"
"empty string value here =\n"
"\n"
"[You can use comments]\n"
"# like this\n"
"; or this\n"
"\n"
"# By default only in an empty line.\n"
"# Inline comments can be harmful because they prevent users\n"
"# from using the delimiting characters as parts of values.\n"
"# That being said, this can be customized.\n"
"\n"
"    [Sections Can Be Indented]\n"
"        can_values_be_as_well = True\n"
"        does_that_mean_anything_special = False\n"
"        purpose = formatting for readability\n"
"        multiline_values = are\n"
"            handled just fine as\n"
"            long as they are indented\n"
"            deeper than the first line\n"
"            of a value\n"
"        # Did I mention we can indent comments, too?"
msgstr ""

#: ../../library/configparser.rst:342
msgid "Unnamed Sections"
msgstr ""

#: ../../library/configparser.rst:344
msgid ""
"The name of the first section (or unique) may be omitted and values "
"retrieved by the :const:`UNNAMED_SECTION` attribute."
msgstr ""

#: ../../library/configparser.rst:347
msgid ""
">>> config = \"\"\"\n"
"... option = value\n"
"...\n"
"... [  Section 2  ]\n"
"... another = val\n"
"... \"\"\"\n"
">>> unnamed = configparser.ConfigParser(allow_unnamed_section=True)\n"
">>> unnamed.read_string(config)\n"
">>> unnamed.get(configparser.UNNAMED_SECTION, 'option')\n"
"'value'"
msgstr ""

#: ../../library/configparser.rst:361
msgid "Interpolation of values"
msgstr "値の補間"

#: ../../library/configparser.rst:363
msgid ""
"On top of the core functionality, :class:`ConfigParser` supports "
"interpolation.  This means values can be preprocessed before returning them "
"from ``get()`` calls."
msgstr ""
"コア機能に加えて、 :class:`ConfigParser` は補間(interpolation, 内挿とも)をサ"
"ポートします。これは ``get()`` コールが値を返す前に、その値に対して前処理を行"
"えることを意味します。"

#: ../../library/configparser.rst:371
msgid ""
"The default implementation used by :class:`ConfigParser`.  It enables values "
"to contain format strings which refer to other values in the same section, "
"or values in the special default section [1]_.  Additional default values "
"can be provided on initialization."
msgstr ""
":class:`ConfigParser` が使用するデフォルト実装です。値に、同じセクションか特"
"別なデフォルトセクション中 [1]_ の他の値を参照するフォーマット文字列を含める"
"ことができます。追加のデフォルト値を初期化時に提供できます。"

#: ../../library/configparser.rst:378
msgid ""
"[Paths]\n"
"home_dir: /Users\n"
"my_dir: %(home_dir)s/lumberjack\n"
"my_pictures: %(my_dir)s/Pictures\n"
"\n"
"[Escape]\n"
"# use a %% to escape the % sign (% is the only character that needs to be "
"escaped):\n"
"gain: 80%%"
msgstr ""

#: ../../library/configparser.rst:389
msgid ""
"In the example above, :class:`ConfigParser` with *interpolation* set to "
"``BasicInterpolation()`` would resolve ``%(home_dir)s`` to the value of "
"``home_dir`` (``/Users`` in this case).  ``%(my_dir)s`` in effect would "
"resolve to ``/Users/lumberjack``.  All interpolations are done on demand so "
"keys used in the chain of references do not have to be specified in any "
"specific order in the configuration file."
msgstr ""
"上の例では、 *interpolation* に ``BasicInterpolation()`` を設定した :class:"
"`ConfigParser` が ``%(home_dir)s`` を ``home_dir`` の値(このケースでは ``/"
"Users`` )として解決しています、その結果 ``%(my_dir)s`` は ``/Users/"
"lumberjack`` になります。全ての補間は必要に応じて実行されるため、設定ファイル"
"中で参照の連鎖をもつキーを特定の順序で記述する必要はありません。"

#: ../../library/configparser.rst:396
msgid ""
"With ``interpolation`` set to ``None``, the parser would simply return "
"``%(my_dir)s/Pictures`` as the value of ``my_pictures`` and ``%(home_dir)s/"
"lumberjack`` as the value of ``my_dir``."
msgstr ""
"``interpolation`` に ``None`` を設定すれば、パーサーは単に ``my_pictures`` の"
"値として  ``%(my_dir)s/Pictures`` を返し、``my_dir`` の値として "
"``%(home_dir)s/lumberjack`` を返します。"

#: ../../library/configparser.rst:404
msgid ""
"An alternative handler for interpolation which implements a more advanced "
"syntax, used for instance in ``zc.buildout``.  Extended interpolation is "
"using ``${section:option}`` to denote a value from a foreign section. "
"Interpolation can span multiple levels.  For convenience, if the ``section:"
"`` part is omitted, interpolation defaults to the current section (and "
"possibly the default values from the special section)."
msgstr ""
"``zc.buildout`` で使用されるような、より高度な文法を実装した補間ハンドラの別"
"の選択肢です。拡張された補間は、他のセクション中の値を示すのに ``${section:"
"option}`` と書けます。補間は複数のレベルに及べます、利便性のために、もし "
"``section:`` の部分が省略されると、現在のセクションがデフォルト値となります"
"(スペシャルセクション中のデフォルト値を使用することもできます)。"

#: ../../library/configparser.rst:411
msgid ""
"For example, the configuration specified above with basic interpolation, "
"would look like this with extended interpolation:"
msgstr ""
"たとえば、上記の basic interpolation で指定した設定は、extended "
"interpolation を使うと下記のようになります:"

#: ../../library/configparser.rst:414
msgid ""
"[Paths]\n"
"home_dir: /Users\n"
"my_dir: ${home_dir}/lumberjack\n"
"my_pictures: ${my_dir}/Pictures\n"
"\n"
"[Escape]\n"
"# use a $$ to escape the $ sign ($ is the only character that needs to be "
"escaped):\n"
"cost: $$80"
msgstr ""

#: ../../library/configparser.rst:425
msgid "Values from other sections can be fetched as well:"
msgstr "他のセクションから値を持ってくることもできます:"

#: ../../library/configparser.rst:427
msgid ""
"[Common]\n"
"home_dir: /Users\n"
"library_dir: /Library\n"
"system_dir: /System\n"
"macports_dir: /opt/local\n"
"\n"
"[Frameworks]\n"
"Python: 3.2\n"
"path: ${Common:system_dir}/Library/Frameworks/\n"
"\n"
"[Arthur]\n"
"nickname: Two Sheds\n"
"last_name: Jackson\n"
"my_dir: ${Common:home_dir}/twosheds\n"
"my_pictures: ${my_dir}/Pictures\n"
"python_dir: ${Frameworks:path}/Python/Versions/${Frameworks:Python}"
msgstr ""

#: ../../library/configparser.rst:447
msgid "Mapping Protocol Access"
msgstr "マップ型プロトコルアクセス"

#: ../../library/configparser.rst:451
msgid ""
"Mapping protocol access is a generic name for functionality that enables "
"using custom objects as if they were dictionaries.  In case of :mod:"
"`configparser`, the mapping interface implementation is using the "
"``parser['section']['option']`` notation."
msgstr ""
"マップ型プロトコルアクセスは、カスタムオブジェクトを辞書であるかのように使う"
"ための機能の総称です。 :mod:`configparser` の場合、マップ型インターフェースの"
"実装は ``parser['section']['option']`` 表記を使います。"

#: ../../library/configparser.rst:456
msgid ""
"``parser['section']`` in particular returns a proxy for the section's data "
"in the parser.  This means that the values are not copied but they are taken "
"from the original parser on demand.  What's even more important is that when "
"values are changed on a section proxy, they are actually mutated in the "
"original parser."
msgstr ""
"とくに、``parser['section']`` はパーサー内のそのセクションのデータへのプロキ"
"シを返します。つまり、値はコピーされるのではなく必要に応じてオリジナルのパー"
"サーから取られます。さらに重要なことに、セクションのプロキシの値が変更される"
"と、オリジナルのパーサー中の値が実際に変更されます。"

#: ../../library/configparser.rst:462
msgid ""
":mod:`configparser` objects behave as close to actual dictionaries as "
"possible. The mapping interface is complete and adheres to the :class:"
"`~collections.abc.MutableMapping` ABC. However, there are a few differences "
"that should be taken into account:"
msgstr ""
":mod:`configparser` は可能な限り実際の辞書と近い振る舞いをします。マップ型イ"
"ンターフェースは :class:`~collections.abc.MutableMapping` を矛盾なく完成しま"
"す。しかし、考慮するべき違いがいくつかあります:"

#: ../../library/configparser.rst:467
msgid ""
"By default, all keys in sections are accessible in a case-insensitive manner "
"[1]_.  E.g. ``for option in parser[\"section\"]`` yields only "
"``optionxform``'ed option key names.  This means lowercased keys by "
"default.  At the same time, for a section that holds the key ``'a'``, both "
"expressions return ``True``::"
msgstr ""
"デフォルトでは、セクション内の全てのキーは大文字小文字の区別なくアクセスでき"
"ます [1]_。例えば、``for option in parser[\"section\"]`` は ``optionxform`` "
"されたオプションキー名のみを yield します。つまり小文字のキーがデフォルトで"
"す。同時に、キー ``'a'`` を含むセクションにおいて、どちらの式も ``True`` を返"
"します::"

#: ../../library/configparser.rst:472
msgid ""
"\"a\" in parser[\"section\"]\n"
"\"A\" in parser[\"section\"]"
msgstr ""

#: ../../library/configparser.rst:475
msgid ""
"All sections include ``DEFAULTSECT`` values as well which means that ``."
"clear()`` on a section may not leave the section visibly empty.  This is "
"because default values cannot be deleted from the section (because "
"technically they are not there).  If they are overridden in the section, "
"deleting causes the default value to be visible again.  Trying to delete a "
"default value causes a :exc:`KeyError`."
msgstr ""
"全てのセクションは ``DEFAULTSECT`` 値を持ち、すなわちセクションで ``."
"clear()`` してもセクションは見た目上空になりません。これは、デフォルト値は "
"(技術的にはそこにないので) セクションから削除できないためです。デフォルト値が"
"上書きされた場合、それが削除されるとデフォルト値が再び見えるようになります。"
"デフォルト値を削除しようとすると :exc:`KeyError` が発生します。"

#: ../../library/configparser.rst:482
msgid "``DEFAULTSECT`` cannot be removed from the parser:"
msgstr "``DEFAULTSECT`` はパーサーから取り除けません:"

#: ../../library/configparser.rst:484
msgid "trying to delete it raises :exc:`ValueError`,"
msgstr "削除しようとすると :exc:`ValueError` が発生します。"

#: ../../library/configparser.rst:486
msgid "``parser.clear()`` leaves it intact,"
msgstr "``parser.clear()`` はこれをそのまま残し、"

#: ../../library/configparser.rst:488
msgid "``parser.popitem()`` never returns it."
msgstr "``parser.popitem()`` がこれを返すことはありません。"

#: ../../library/configparser.rst:490
msgid ""
"``parser.get(section, option, **kwargs)`` - the second argument is **not** a "
"fallback value.  Note however that the section-level ``get()`` methods are "
"compatible both with the mapping protocol and the classic configparser API."
msgstr ""
"``parser.get(section, option, **kwargs)`` - 第二引数は代替値では *ありません"
"*。ただし、セクションごとの ``get()`` メソッドはマップ型プロトコルと旧式の "
"configparser API の両方に互換です。"

#: ../../library/configparser.rst:494
msgid ""
"``parser.items()`` is compatible with the mapping protocol (returns a list "
"of *section_name*, *section_proxy* pairs including the DEFAULTSECT).  "
"However, this method can also be invoked with arguments: ``parser."
"items(section, raw, vars)``.  The latter call returns a list of *option*, "
"*value* pairs for a specified ``section``, with all interpolations expanded "
"(unless ``raw=True`` is provided)."
msgstr ""
"``parser.items()`` はマップ型プロトコルと互換です (DEFAULTSECT を含む "
"*section_name*, *section_proxy* 対のリストを返します)。ただし、このメソッド"
"は ``parser.items(section, raw, vars)`` のようにして引数を与えることでも呼び"
"出せます。後者の呼び出しは指定された ``section`` の  *option*, *value* 対のリ"
"ストを、(``raw=True`` が与えられない限り) 全ての補間を展開して返します。"

#: ../../library/configparser.rst:501
msgid ""
"The mapping protocol is implemented on top of the existing legacy API so "
"that subclasses overriding the original interface still should have mappings "
"working as expected."
msgstr ""
"マップ型プロトコルは、既存のレガシーな API の上に実装されているので、オリジナ"
"ルのインターフェースを上書きする派生クラスもまたは期待どおりにはたらきます。"

#: ../../library/configparser.rst:507
msgid "Customizing Parser Behaviour"
msgstr "パーサーの振る舞いをカスタマイズする"

#: ../../library/configparser.rst:509
msgid ""
"There are nearly as many INI format variants as there are applications using "
"it. :mod:`configparser` goes a long way to provide support for the largest "
"sensible set of INI styles available.  The default functionality is mainly "
"dictated by historical background and it's very likely that you will want to "
"customize some of the features."
msgstr ""
"INI フォーマットの変種は、それを使うアプリケーションの数と同じくらい多く存在"
"します。 :mod:`configparser` は、可能な限り広い範囲の INI スタイルを集めた集"
"合をサポートするために、非常に役立ちます。デフォルトの機能は主に歴史的背景に"
"よって決められたので、機能によってはカスタマイズしてお使いください。"

#: ../../library/configparser.rst:515
msgid ""
"The most common way to change the way a specific config parser works is to "
"use the :meth:`!__init__` options:"
msgstr ""

#: ../../library/configparser.rst:518
msgid "*defaults*, default value: ``None``"
msgstr "*defaults*, デフォルト値: ``None``"

#: ../../library/configparser.rst:520
msgid ""
"This option accepts a dictionary of key-value pairs which will be initially "
"put in the ``DEFAULT`` section.  This makes for an elegant way to support "
"concise configuration files that don't specify values which are the same as "
"the documented default."
msgstr ""
"このオプションは最初に ``DEFAULT`` セクションに加えられるキー-値の対の辞書を"
"受け付けます。"

#: ../../library/configparser.rst:525
msgid ""
"Hint: if you want to specify default values for a specific section, use :"
"meth:`~ConfigParser.read_dict` before you read the actual file."
msgstr ""

#: ../../library/configparser.rst:528
msgid "*dict_type*, default value: :class:`dict`"
msgstr "*dict_type*, デフォルト値: :class:`dict`"

#: ../../library/configparser.rst:530
msgid ""
"This option has a major impact on how the mapping protocol will behave and "
"how the written configuration files look.  With the standard dictionary, "
"every section is stored in the order they were added to the parser.  Same "
"goes for options within sections."
msgstr ""
"このオプションはマップ型プロトコルの振る舞い方や書き込まれる設定ファイルの見"
"た目に大きく影響します。標準の辞書では、全てのセクションはパーサーに加えられ"
"た順に並びます。同じことがセクション内のオプションにも言えます。"

#: ../../library/configparser.rst:535
msgid ""
"An alternative dictionary type can be used for example to sort sections and "
"options on write-back."
msgstr ""
"セクションとオプションをライトバック時にソートするためなどに、別の辞書型も使"
"えます。"

#: ../../library/configparser.rst:538
msgid ""
"Please note: there are ways to add a set of key-value pairs in a single "
"operation.  When you use a regular dictionary in those operations, the order "
"of the keys will be ordered.  For example:"
msgstr ""
"注意: 一度の操作でキー-値の対を複数追加する方法もあります。そのような操作に普"
"通の辞書を使うと、キーの並びは挿入順になります。例えば:"

#: ../../library/configparser.rst:542
msgid ""
">>> parser = configparser.ConfigParser()\n"
">>> parser.read_dict({'section1': {'key1': 'value1',\n"
"...                                'key2': 'value2',\n"
"...                                'key3': 'value3'},\n"
"...                   'section2': {'keyA': 'valueA',\n"
"...                                'keyB': 'valueB',\n"
"...                                'keyC': 'valueC'},\n"
"...                   'section3': {'foo': 'x',\n"
"...                                'bar': 'y',\n"
"...                                'baz': 'z'}\n"
"... })\n"
">>> parser.sections()\n"
"['section1', 'section2', 'section3']\n"
">>> [option for option in parser['section3']]\n"
"['foo', 'bar', 'baz']"
msgstr ""

#: ../../library/configparser.rst:560
msgid "*allow_no_value*, default value: ``False``"
msgstr "*allow_no_value*, デフォルト値: ``False``"

#: ../../library/configparser.rst:562
msgid ""
"Some configuration files are known to include settings without values, but "
"which otherwise conform to the syntax supported by :mod:`configparser`.  The "
"*allow_no_value* parameter to the constructor can be used to indicate that "
"such values should be accepted:"
msgstr ""
"一部の設定ファイルには値のない設定項目がありますが、それ以外は :mod:"
"`ConfigParser` がサポートする文法に従います。コンストラクタの "
"*allow_no_value* 引数で、そのような値を許可することができます。"

#: ../../library/configparser.rst:567
msgid ""
">>> import configparser\n"
"\n"
">>> sample_config = \"\"\"\n"
"... [mysqld]\n"
"...   user = mysql\n"
"...   pid-file = /var/run/mysqld/mysqld.pid\n"
"...   skip-external-locking\n"
"...   old_passwords = 1\n"
"...   skip-bdb\n"
"...   # we don't need ACID today\n"
"...   skip-innodb\n"
"... \"\"\"\n"
">>> config = configparser.ConfigParser(allow_no_value=True)\n"
">>> config.read_string(sample_config)\n"
"\n"
">>> # Settings with values are treated as before:\n"
">>> config[\"mysqld\"][\"user\"]\n"
"'mysql'\n"
"\n"
">>> # Settings without values provide None:\n"
">>> config[\"mysqld\"][\"skip-bdb\"]\n"
"\n"
">>> # Settings which aren't specified still raise an error:\n"
">>> config[\"mysqld\"][\"does-not-exist\"]\n"
"Traceback (most recent call last):\n"
"  ...\n"
"KeyError: 'does-not-exist'"
msgstr ""

#: ../../library/configparser.rst:597
msgid "*delimiters*, default value: ``('=', ':')``"
msgstr "*delimiters*, デフォルト値: ``('=', ':')``"

#: ../../library/configparser.rst:599
msgid ""
"Delimiters are substrings that delimit keys from values within a section. "
"The first occurrence of a delimiting substring on a line is considered a "
"delimiter.  This means values (but not keys) can contain the delimiters."
msgstr ""
"デリミタはセクション内でキーを値から区切る部分文字列です。行中で最初に現れた"
"区切り部分文字列がデリミタと見なされます。つまり値にはデリミタを含めることが"
"できます (キーには含めることができません)。"

#: ../../library/configparser.rst:603
msgid ""
"See also the *space_around_delimiters* argument to :meth:`ConfigParser."
"write`."
msgstr ""
":meth:`ConfigParser.write` の *space_around_delimiters* 引数も参照してくださ"
"い。"

#: ../../library/configparser.rst:606
msgid "*comment_prefixes*, default value: ``('#', ';')``"
msgstr "*comment_prefixes*, デフォルト値: ``('#', ';')``"

#: ../../library/configparser.rst:608
msgid "*inline_comment_prefixes*, default value: ``None``"
msgstr "*inline_comment_prefixes*, デフォルト値: ``None``"

#: ../../library/configparser.rst:610
msgid ""
"Comment prefixes are strings that indicate the start of a valid comment "
"within a config file. *comment_prefixes* are used only on otherwise empty "
"lines (optionally indented) whereas *inline_comment_prefixes* can be used "
"after every valid value (e.g. section names, options and empty lines as "
"well).  By default inline comments are disabled and ``'#'`` and ``';'`` are "
"used as prefixes for whole line comments."
msgstr ""
"コメント接頭辞は設定ファイル中で有効なコメントの開始を示す文字列です。"
"*comment_prefixes* は他の内容がない行 (インデントは自由) にのみ使用でき、"
"*inline_comment_prefixes* は任意の有効な値 (例えば、セクション名、オプショ"
"ン、空行も可能) の後に使えます。デフォルトではインラインコメントは無効化され"
"ていて、``'#'`` と ``';'`` を行全体のコメントに使用します。"

#: ../../library/configparser.rst:617
msgid ""
"In previous versions of :mod:`configparser` behaviour matched "
"``comment_prefixes=('#',';')`` and ``inline_comment_prefixes=(';',)``."
msgstr ""
"以前のバージョンの :mod:`configparser` の振る舞いは "
"``comment_prefixes=('#',';')`` および ``inline_comment_prefixes=(';',)`` に該"
"当します。"

#: ../../library/configparser.rst:621
msgid ""
"Please note that config parsers don't support escaping of comment prefixes "
"so using *inline_comment_prefixes* may prevent users from specifying option "
"values with characters used as comment prefixes.  When in doubt, avoid "
"setting *inline_comment_prefixes*.  In any circumstances, the only way of "
"storing comment prefix characters at the beginning of a line in multiline "
"values is to interpolate the prefix, for example::"
msgstr ""
"設定パーサーはコメント接頭辞のエスケープをサポートしないので、"
"*inline_comment_prefixes* はユーザーがコメント接頭辞として使われる文字を含む"
"オプション値を指定するのを妨げる可能性があります。疑わしい場合には、"
"*inline_comment_prefixes* を設定しないようにしてください。どのような状況で"
"も、複数行にわたる値で、行の先頭にコメント接頭辞文字を保存する唯一の方法は、"
"次の例のように接頭辞を補間することです::"

#: ../../library/configparser.rst:628
msgid ""
">>> from configparser import ConfigParser, ExtendedInterpolation\n"
">>> parser = ConfigParser(interpolation=ExtendedInterpolation())\n"
">>> # the default BasicInterpolation could be used as well\n"
">>> parser.read_string(\"\"\"\n"
"... [DEFAULT]\n"
"... hash = #\n"
"...\n"
"... [hashes]\n"
"... shebang =\n"
"...   ${hash}!/usr/bin/env python\n"
"...   ${hash} -*- coding: utf-8 -*-\n"
"...\n"
"... extensions =\n"
"...   enabled_extension\n"
"...   another_extension\n"
"...   #disabled_by_comment\n"
"...   yet_another_extension\n"
"...\n"
"... interpolation not necessary = if # is not at line start\n"
"... even in multiline values = line #1\n"
"...   line #2\n"
"...   line #3\n"
"... \"\"\")\n"
">>> print(parser['hashes']['shebang'])\n"
"\n"
"#!/usr/bin/env python\n"
"# -*- coding: utf-8 -*-\n"
">>> print(parser['hashes']['extensions'])\n"
"\n"
"enabled_extension\n"
"another_extension\n"
"yet_another_extension\n"
">>> print(parser['hashes']['interpolation not necessary'])\n"
"if # is not at line start\n"
">>> print(parser['hashes']['even in multiline values'])\n"
"line #1\n"
"line #2\n"
"line #3"
msgstr ""

#: ../../library/configparser.rst:667
msgid "*strict*, default value: ``True``"
msgstr "*strict*, デフォルト値: ``True``"

#: ../../library/configparser.rst:669
msgid ""
"When set to ``True``, the parser will not allow for any section or option "
"duplicates while reading from a single source (using :meth:`~ConfigParser."
"read_file`, :meth:`~ConfigParser.read_string` or :meth:`~ConfigParser."
"read_dict`).  It is recommended to use strict parsers in new applications."
msgstr ""

#: ../../library/configparser.rst:674
msgid ""
"In previous versions of :mod:`configparser` behaviour matched "
"``strict=False``."
msgstr ""
"以前のバージョンの :mod:`configparser` の振る舞いは ``strict=False`` に該当し"
"ます。"

#: ../../library/configparser.rst:678
msgid "*empty_lines_in_values*, default value: ``True``"
msgstr "*empty_lines_in_values*, デフォルト値: ``True``"

#: ../../library/configparser.rst:680
msgid ""
"In config parsers, values can span multiple lines as long as they are "
"indented more than the key that holds them.  By default parsers also let "
"empty lines to be parts of values.  At the same time, keys can be "
"arbitrarily indented themselves to improve readability.  In consequence, "
"when configuration files get big and complex, it is easy for the user to "
"lose track of the file structure.  Take for instance:"
msgstr ""
"設定パーサーでは、キーよりもその値を深くインデントするかぎり、複数行にまたが"
"る値を使えます。デフォルトのパーサーはさらにその値の間に空行を置けます。同時"
"に、キーは読みやすくするため任意にインデントできます。結果として、設定ファイ"
"ルが大きく複雑になったとき、ユーザーがファイル構造を見失いやすいです。この例"
"をご覧ください:"

#: ../../library/configparser.rst:687
msgid ""
"[Section]\n"
"key = multiline\n"
"  value with a gotcha\n"
"\n"
" this = is still a part of the multiline value of 'key'"
msgstr ""

#: ../../library/configparser.rst:695
msgid ""
"This can be especially problematic for the user to see if she's using a "
"proportional font to edit the file.  That is why when your application does "
"not need values with empty lines, you should consider disallowing them.  "
"This will make empty lines split keys every time.  In the example above, it "
"would produce two keys, ``key`` and ``this``."
msgstr ""
"これは特にプロポーショナルフォントを使ってファイルを編集しているユーザーに"
"とって問題になることがあります。だから、アプリケーションの値に空行が必要ない"
"なら、空行を認めないべきです。これによって空行で必ずキーが分かれます。上の例"
"では、2 つのキー、``key`` および ``this`` が作られます。"

#: ../../library/configparser.rst:701
msgid ""
"*default_section*, default value: ``configparser.DEFAULTSECT`` (that is: "
"``\"DEFAULT\"``)"
msgstr ""
"*default_section*, デフォルト値: ``configparser.DEFAULTSECT`` (すなわち: "
"``\"DEFAULT\"``)"

#: ../../library/configparser.rst:704
msgid ""
"The convention of allowing a special section of default values for other "
"sections or interpolation purposes is a powerful concept of this library, "
"letting users create complex declarative configurations.  This section is "
"normally called ``\"DEFAULT\"`` but this can be customized to point to any "
"other valid section name.  Some typical values include: ``\"general\"`` or "
"``\"common\"``.  The name provided is used for recognizing default sections "
"when reading from any source and is used when writing configuration back to "
"a file.  Its current value can be retrieved using the ``parser_instance."
"default_section`` attribute and may be modified at runtime (i.e. to convert "
"files from one format to another)."
msgstr ""
"他のセクションのデフォルト値や補間目的での特別なセクションを認める慣行はこの"
"ライブラリの明確なコンセプトの一つで、ユーザーは複雑で宣言的な設定を作成でき"
"ます。このセクションは通常 ``\"DEFAULT\"`` と呼ばれますが、任意の有効なセク"
"ション名を指すようにカスタマイズできます。典型的な値には ``\"general\"`` や "
"``\"common\"`` があります。与えられた名前はソースを読み込む際にデフォルトセク"
"ションを認識するのに使われ、設定をファイルに書き戻すときにも使われます。現在"
"の値は ``parser_instance.default_section`` 属性から取り出すことができ、実行"
"時 (すなわちファイルを別のフォーマットに変換するとき) に変更することもできま"
"す。"

#: ../../library/configparser.rst:715
msgid "*interpolation*, default value: ``configparser.BasicInterpolation``"
msgstr "*interpolation*, デフォルト値: ``configparser.BasicInterpolation``"

#: ../../library/configparser.rst:717
msgid ""
"Interpolation behaviour may be customized by providing a custom handler "
"through the *interpolation* argument. ``None`` can be used to turn off "
"interpolation completely, ``ExtendedInterpolation()`` provides a more "
"advanced variant inspired by ``zc.buildout``.  More on the subject in the "
"`dedicated documentation section <#interpolation-of-values>`_. :class:"
"`RawConfigParser` has a default value of ``None``."
msgstr ""
"補間の振る舞いは、 *interpolation* 引数を通してカスタムハンドラを与えることで"
"カスタマイズできます。 ``None`` 引数を使うと補間を完全に無効にできます。 "
"``ExtendedInterpolation()`` は、 ``zc.buildout`` に影響を受けたより高度な補間"
"を提供します。この話題に `特化したドキュメントのセクション <#interpolation-"
"of-values>`_ をご覧ください。 :class:`RawConfigParser` のデフォルト値は "
"``None`` です。"

#: ../../library/configparser.rst:724
msgid "*converters*, default value: not set"
msgstr "*converters*, デフォルト値: 未設定"

#: ../../library/configparser.rst:726
msgid ""
"Config parsers provide option value getters that perform type conversion.  "
"By default :meth:`~ConfigParser.getint`, :meth:`~ConfigParser.getfloat`, "
"and :meth:`~ConfigParser.getboolean` are implemented.  Should other getters "
"be desirable, users may define them in a subclass or pass a dictionary where "
"each key is a name of the converter and each value is a callable "
"implementing said conversion.  For instance, passing ``{'decimal': decimal."
"Decimal}`` would add :meth:`!getdecimal` on both the parser object and all "
"section proxies.  In other words, it will be possible to write both "
"``parser_instance.getdecimal('section', 'key', fallback=0)`` and "
"``parser_instance['section'].getdecimal('key', 0)``."
msgstr ""

#: ../../library/configparser.rst:737
msgid ""
"If the converter needs to access the state of the parser, it can be "
"implemented as a method on a config parser subclass.  If the name of this "
"method starts with ``get``, it will be available on all section proxies, in "
"the dict-compatible form (see the ``getdecimal()`` example above)."
msgstr ""
"コンバーターがパーサーの状態にアクセスする必要がある場合、設定パーサーサブク"
"ラスでメソッドとして実装することができます。このメソッドの名前が ``get`` から"
"始まる場合、すべてのセクションプロキシで、辞書と互換性のある形式で利用できま"
"す (上記の ``getdecimal()``  の例を参照)。"

#: ../../library/configparser.rst:742
msgid ""
"More advanced customization may be achieved by overriding default values of "
"these parser attributes.  The defaults are defined on the classes, so they "
"may be overridden by subclasses or by attribute assignment."
msgstr ""
"これらのパーサー引数のデフォルト値を上書きすれば、さらに進んだカスタマイズが"
"できます。デフォルトはクラスで定義されているので、派生クラスや属性の代入で上"
"書きできます。"

#: ../../library/configparser.rst:748
msgid ""
"By default when using :meth:`~ConfigParser.getboolean`, config parsers "
"consider the following values ``True``: ``'1'``, ``'yes'``, ``'true'``, "
"``'on'`` and the following values ``False``: ``'0'``, ``'no'``, ``'false'``, "
"``'off'``.  You can override this by specifying a custom dictionary of "
"strings and their Boolean outcomes. For example:"
msgstr ""
"デフォルトでは、 :meth:`~ConfigParser.getboolean` を使うことで、設定パーサー"
"は以下の値を ``True`` と見なします: ``'1'``, ``'yes'``, ``'true'``, "
"``'on'`` 。以下の値を ``False`` と見なします: ``'0'``, ``'no'``, "
"``'false'``, ``'off'`` 。文字列と対応するブール値のカスタム辞書を指定すること"
"でこれを上書きできます。たとえば:"

#: ../../library/configparser.rst:754
msgid ""
">>> custom = configparser.ConfigParser()\n"
">>> custom['section1'] = {'funky': 'nope'}\n"
">>> custom['section1'].getboolean('funky')\n"
"Traceback (most recent call last):\n"
"...\n"
"ValueError: Not a boolean: nope\n"
">>> custom.BOOLEAN_STATES = {'sure': True, 'nope': False}\n"
">>> custom['section1'].getboolean('funky')\n"
"False"
msgstr ""

#: ../../library/configparser.rst:766
msgid ""
"Other typical Boolean pairs include ``accept``/``reject`` or ``enabled``/"
"``disabled``."
msgstr ""
"ほかの典型的なブール値ペアには ``accept``/``reject`` や ``enabled``/"
"``disabled`` などがあります。"

#: ../../library/configparser.rst:772
msgid ""
"This method transforms option names on every read, get, or set operation.  "
"The default converts the name to lowercase.  This also means that when a "
"configuration file gets written, all keys will be lowercase.  Override this "
"method if that's unsuitable. For example:"
msgstr ""
"このメソッドは読み込み、取得、設定操作のたびにオプション名を変換します。デ"
"フォルトでは名前を小文字に変換します。従って設定ファイルが書き込まれるとき、"
"すべてのキーは小文字になります。それがふさわしくなければ、このメソッドを上書"
"きしてください。例えば:"

#: ../../library/configparser.rst:778
msgid ""
">>> config = \"\"\"\n"
"... [Section1]\n"
"... Key = Value\n"
"...\n"
"... [Section2]\n"
"... AnotherKey = Value\n"
"... \"\"\"\n"
">>> typical = configparser.ConfigParser()\n"
">>> typical.read_string(config)\n"
">>> list(typical['Section1'].keys())\n"
"['key']\n"
">>> list(typical['Section2'].keys())\n"
"['anotherkey']\n"
">>> custom = configparser.RawConfigParser()\n"
">>> custom.optionxform = lambda option: option\n"
">>> custom.read_string(config)\n"
">>> list(custom['Section1'].keys())\n"
"['Key']\n"
">>> list(custom['Section2'].keys())\n"
"['AnotherKey']"
msgstr ""

#: ../../library/configparser.rst:802
msgid ""
"The optionxform function transforms option names to a canonical form. This "
"should be an idempotent function: if the name is already in canonical form, "
"it should be returned unchanged."
msgstr ""

#: ../../library/configparser.rst:809
msgid ""
"A compiled regular expression used to parse section headers.  The default "
"matches ``[section]`` to the name ``\"section\"``.  Whitespace is considered "
"part of the section name, thus ``[  larch  ]`` will be read as a section of "
"name ``\"  larch  \"``.  Override this attribute if that's unsuitable.  For "
"example:"
msgstr ""
"セクションヘッダを解析するのに使われる、コンパイルされた正規表現です。デフォ"
"ルトでは ``[section]`` が ``\"section\"`` という名前にマッチします。空白はセ"
"クション名の一部と見なされるので、``[  larch  ]`` は ``\"  larch  \"`` という"
"名のセクションとして読み込まれます。これがふさわしくない場合、このメソッドを"
"上書きしてください。例えば:"

#: ../../library/configparser.rst:815
msgid ""
">>> import re\n"
">>> config = \"\"\"\n"
"... [Section 1]\n"
"... option = value\n"
"...\n"
"... [  Section 2  ]\n"
"... another = val\n"
"... \"\"\"\n"
">>> typical = configparser.ConfigParser()\n"
">>> typical.read_string(config)\n"
">>> typical.sections()\n"
"['Section 1', '  Section 2  ']\n"
">>> custom = configparser.ConfigParser()\n"
">>> custom.SECTCRE = re.compile(r\"\\[ *(?P<header>[^]]+?) *\\]\")\n"
">>> custom.read_string(config)\n"
">>> custom.sections()\n"
"['Section 1', 'Section 2']"
msgstr ""

#: ../../library/configparser.rst:837
msgid ""
"While ConfigParser objects also use an ``OPTCRE`` attribute for recognizing "
"option lines, it's not recommended to override it because that would "
"interfere with constructor options *allow_no_value* and *delimiters*."
msgstr ""
"ConfigParser オブジェクトはオプション行の認識に ``OPTCRE`` 属性も使いますが、"
"これを上書きすることは推奨されません。上書きするとコンストラクタオプション "
"*allow_no_value* および *delimiters* に干渉します。"

#: ../../library/configparser.rst:843
msgid "Legacy API Examples"
msgstr "レガシーな API の例"

#: ../../library/configparser.rst:845
msgid ""
"Mainly because of backwards compatibility concerns, :mod:`configparser` "
"provides also a legacy API with explicit ``get``/``set`` methods.  While "
"there are valid use cases for the methods outlined below, mapping protocol "
"access is preferred for new projects.  The legacy API is at times more "
"advanced, low-level and downright counterintuitive."
msgstr ""
"主に後方互換性問題の理由から、 :mod:`configparser` は ``get``/``set`` メソッ"
"ドを明示するレガシーな API も提供します。メソッドを以下に示すように使うことも"
"できますが、新しいプロジェクトではマップ型プロトコルでアクセスするのが望まし"
"いです。レガシーな API は時折高度で、低レベルで、まったく直感的ではありませ"
"ん。"

#: ../../library/configparser.rst:851
msgid "An example of writing to a configuration file::"
msgstr "設定ファイルを書き出す例::"

#: ../../library/configparser.rst:853
msgid ""
"import configparser\n"
"\n"
"config = configparser.RawConfigParser()\n"
"\n"
"# Please note that using RawConfigParser's set functions, you can assign\n"
"# non-string values to keys internally, but will receive an error when\n"
"# attempting to write to a file or when you get it in non-raw mode. Setting\n"
"# values using the mapping protocol or ConfigParser's set() does not allow\n"
"# such assignments to take place.\n"
"config.add_section('Section1')\n"
"config.set('Section1', 'an_int', '15')\n"
"config.set('Section1', 'a_bool', 'true')\n"
"config.set('Section1', 'a_float', '3.1415')\n"
"config.set('Section1', 'baz', 'fun')\n"
"config.set('Section1', 'bar', 'Python')\n"
"config.set('Section1', 'foo', '%(bar)s is %(baz)s!')\n"
"\n"
"# Writing our configuration file to 'example.cfg'\n"
"with open('example.cfg', 'w') as configfile:\n"
"    config.write(configfile)"
msgstr ""

#: ../../library/configparser.rst:874
msgid "An example of reading the configuration file again::"
msgstr "設定ファイルを読み込む例::"

#: ../../library/configparser.rst:876
msgid ""
"import configparser\n"
"\n"
"config = configparser.RawConfigParser()\n"
"config.read('example.cfg')\n"
"\n"
"# getfloat() raises an exception if the value is not a float\n"
"# getint() and getboolean() also do this for their respective types\n"
"a_float = config.getfloat('Section1', 'a_float')\n"
"an_int = config.getint('Section1', 'an_int')\n"
"print(a_float + an_int)\n"
"\n"
"# Notice that the next output does not interpolate '%(bar)s' or '%(baz)s'.\n"
"# This is because we are using a RawConfigParser().\n"
"if config.getboolean('Section1', 'a_bool'):\n"
"    print(config.get('Section1', 'foo'))"
msgstr ""

#: ../../library/configparser.rst:892
msgid "To get interpolation, use :class:`ConfigParser`::"
msgstr "補間するには、 :class:`ConfigParser` を使ってください::"

#: ../../library/configparser.rst:894
msgid ""
"import configparser\n"
"\n"
"cfg = configparser.ConfigParser()\n"
"cfg.read('example.cfg')\n"
"\n"
"# Set the optional *raw* argument of get() to True if you wish to disable\n"
"# interpolation in a single get operation.\n"
"print(cfg.get('Section1', 'foo', raw=False))  # -> \"Python is fun!\"\n"
"print(cfg.get('Section1', 'foo', raw=True))   # -> \"%(bar)s is %(baz)s!\"\n"
"\n"
"# The optional *vars* argument is a dict with members that will take\n"
"# precedence in interpolation.\n"
"print(cfg.get('Section1', 'foo', vars={'bar': 'Documentation',\n"
"                                       'baz': 'evil'}))\n"
"\n"
"# The optional *fallback* argument can be used to provide a fallback value\n"
"print(cfg.get('Section1', 'foo'))\n"
"      # -> \"Python is fun!\"\n"
"\n"
"print(cfg.get('Section1', 'foo', fallback='Monty is not.'))\n"
"      # -> \"Python is fun!\"\n"
"\n"
"print(cfg.get('Section1', 'monster', fallback='No such things as "
"monsters.'))\n"
"      # -> \"No such things as monsters.\"\n"
"\n"
"# A bare print(cfg.get('Section1', 'monster')) would raise NoOptionError\n"
"# but we can also use:\n"
"\n"
"print(cfg.get('Section1', 'monster', fallback=None))\n"
"      # -> None"
msgstr ""

#: ../../library/configparser.rst:925
msgid ""
"Default values are available in both types of ConfigParsers.  They are used "
"in interpolation if an option used is not defined elsewhere. ::"
msgstr ""
"どちらの型の ConfigParsers でもデフォルト値が利用できます。使われているオプ"
"ションがどこにも定義されていなければ、そのデフォルト値が補間に使われます。 ::"

#: ../../library/configparser.rst:928
msgid ""
"import configparser\n"
"\n"
"# New instance with 'bar' and 'baz' defaulting to 'Life' and 'hard' each\n"
"config = configparser.ConfigParser({'bar': 'Life', 'baz': 'hard'})\n"
"config.read('example.cfg')\n"
"\n"
"print(config.get('Section1', 'foo'))     # -> \"Python is fun!\"\n"
"config.remove_option('Section1', 'bar')\n"
"config.remove_option('Section1', 'baz')\n"
"print(config.get('Section1', 'foo'))     # -> \"Life is hard!\""
msgstr ""

#: ../../library/configparser.rst:943
msgid "ConfigParser Objects"
msgstr "ConfigParser オブジェクト"

#: ../../library/configparser.rst:953
msgid ""
"The main configuration parser.  When *defaults* is given, it is initialized "
"into the dictionary of intrinsic defaults.  When *dict_type* is given, it "
"will be used to create the dictionary objects for the list of sections, for "
"the options within a section, and for the default values."
msgstr ""
"主要な設定パーサーです。*defaults* が与えられれば、その辞書の持つ初期値で初期"
"化されます。*dict_type* が与えられれば、それがセクションの一覧、セクション中"
"のオプション、およびデフォルト値の辞書オブジェクトを作成するのに使われます。"

#: ../../library/configparser.rst:958
msgid ""
"When *delimiters* is given, it is used as the set of substrings that divide "
"keys from values.  When *comment_prefixes* is given, it will be used as the "
"set of substrings that prefix comments in otherwise empty lines. Comments "
"can be indented.  When *inline_comment_prefixes* is given, it will be used "
"as the set of substrings that prefix comments in non-empty lines."
msgstr ""
"*delimiters* が与えられた場合、キーと値を分割する部分文字列の組み合わせとして"
"使われます。*comment_prefixes* が与えられた場合、他の内容がない行のコメントに"
"接頭する部分文字列の組み合わせとして使われます。コメントはインデントできま"
"す。*inline_comment_prefixes* が与えられた場合、非空行のコメントに接頭する部"
"分文字列としての組み合わせとして使われます。"

#: ../../library/configparser.rst:964
msgid ""
"When *strict* is ``True`` (the default), the parser won't allow for any "
"section or option duplicates while reading from a single source (file, "
"string or dictionary), raising :exc:`DuplicateSectionError` or :exc:"
"`DuplicateOptionError`.  When *empty_lines_in_values* is ``False`` (default: "
"``True``), each empty line marks the end of an option.  Otherwise, internal "
"empty lines of a multiline option are kept as part of the value. When "
"*allow_no_value* is ``True`` (default: ``False``), options without values "
"are accepted; the value held for these is ``None`` and they are serialized "
"without the trailing delimiter."
msgstr ""
"*strict* が ``True`` (デフォルト) であれば、パーサーは単一のソース (ファイ"
"ル、文字列、辞書) 中にセクションやオプションの重複を認めず、 :exc:"
"`DuplicateSectionError` や :exc:`DuplicateOptionError` を送出します。 "
"*empty_lines_in_values* が ``False`` (デフォルト: ``True``) なら、空行はそれ"
"ぞれオプションの終わりを示します。 *allow_no_value* が ``True`` (デフォルト: "
"``False``) なら、値のないオプションが受け付けられます。そのオプションの値は "
"``None`` となり、後端のデリミタを除いてシリアル化されます。"

#: ../../library/configparser.rst:974
msgid ""
"When *default_section* is given, it specifies the name for the special "
"section holding default values for other sections and interpolation purposes "
"(normally named ``\"DEFAULT\"``).  This value can be retrieved and changed "
"at runtime using the ``default_section`` instance attribute. This won't re-"
"evaluate an already parsed config file, but will be used when writing parsed "
"settings to a new config file."
msgstr ""

#: ../../library/configparser.rst:981
msgid ""
"Interpolation behaviour may be customized by providing a custom handler "
"through the *interpolation* argument. ``None`` can be used to turn off "
"interpolation completely, ``ExtendedInterpolation()`` provides a more "
"advanced variant inspired by ``zc.buildout``.  More on the subject in the "
"`dedicated documentation section <#interpolation-of-values>`_."
msgstr ""
"補間の動作は、 *interpolation* 引数を通してカスタムハンドラを与えることでカス"
"タマイズできます。 ``None`` 引数を使うと補間を完全に無効にできます。 "
"``ExtendedInterpolation()`` は、 ``zc.buildout`` に影響を受けたより高度な補間"
"を提供します。この件に `特化したドキュメントのセクション <#interpolation-of-"
"values>`_ を参照してください。"

#: ../../library/configparser.rst:987
msgid ""
"All option names used in interpolation will be passed through the :meth:"
"`optionxform` method just like any other option name reference.  For "
"example, using the default implementation of :meth:`optionxform` (which "
"converts option names to lower case), the values ``foo %(bar)s`` and ``foo "
"%(BAR)s`` are equivalent."
msgstr ""
"補間に使われるすべてのオプション名は、他のオプション名参照と同様に、 :meth:"
"`optionxform` メソッドを通して渡されます。例えば、 :meth:`optionxform` のデ"
"フォルトの実装を使うと、値 ``foo %(bar)s`` と ``foo %(BAR)s`` は等しくなりま"
"す。"

#: ../../library/configparser.rst:993
msgid ""
"When *converters* is given, it should be a dictionary where each key "
"represents the name of a type converter and each value is a callable "
"implementing the conversion from string to the desired datatype.  Every "
"converter gets its own corresponding :meth:`!get*` method on the parser "
"object and section proxies."
msgstr ""

#: ../../library/configparser.rst:999
msgid ""
"When *allow_unnamed_section* is ``True`` (default: ``False``), the first "
"section name can be omitted. See the `\"Unnamed Sections\" section <#unnamed-"
"sections>`_."
msgstr ""

#: ../../library/configparser.rst:1028
msgid "The default *dict_type* is :class:`collections.OrderedDict`."
msgstr "デフォルトの *dict_type* は :class:`collections.OrderedDict` です。"

#: ../../library/configparser.rst:1031 ../../library/configparser.rst:1320
msgid ""
"*allow_no_value*, *delimiters*, *comment_prefixes*, *strict*, "
"*empty_lines_in_values*, *default_section* and *interpolation* were added."
msgstr ""
"*allow_no_value*, *delimiters*, *comment_prefixes*, *strict*, "
"*empty_lines_in_values*, *default_section* および *interpolation* が追加され"
"ました。"

#: ../../library/configparser.rst:1036 ../../library/configparser.rst:1325
msgid "The *converters* argument was added."
msgstr "*converters* 引数が追加されました。"

#: ../../library/configparser.rst:1039
msgid ""
"The *defaults* argument is read with :meth:`read_dict`, providing consistent "
"behavior across the parser: non-string keys and values are implicitly "
"converted to strings."
msgstr ""

#: ../../library/configparser.rst:1044 ../../library/configparser.rst:1328
msgid ""
"The default *dict_type* is :class:`dict`, since it now preserves insertion "
"order."
msgstr ""

#: ../../library/configparser.rst:1048
msgid ""
"Raise a :exc:`MultilineContinuationError` when *allow_no_value* is ``True``, "
"and a key without a value is continued with an indented line."
msgstr ""

#: ../../library/configparser.rst:1052 ../../library/configparser.rst:1332
msgid "The *allow_unnamed_section* argument was added."
msgstr ""

#: ../../library/configparser.rst:1057
msgid "Return a dictionary containing the instance-wide defaults."
msgstr "インスタンス全体で使われるデフォルト値の辞書を返します。"

#: ../../library/configparser.rst:1062
msgid ""
"Return a list of the sections available; the *default section* is not "
"included in the list."
msgstr ""
"利用できるセクションのリストを返します。*default section* はリストに含まれま"
"せん。"

#: ../../library/configparser.rst:1068
msgid ""
"Add a section named *section* to the instance.  If a section by the given "
"name already exists, :exc:`DuplicateSectionError` is raised.  If the "
"*default section* name is passed, :exc:`ValueError` is raised.  The name of "
"the section must be a string; if not, :exc:`TypeError` is raised."
msgstr ""
"*section* という名のセクションをインスタンスに追加します。与えられた名前のセ"
"クション名がすでに存在したら、 :exc:`DuplicateSectionError` が送出されます。 "
"*default section* 名が渡されたら、 :exc:`ValueError` が送出されます。セクショ"
"ンの名前は文字列でなければなりません。そうでなければ、 :exc:`TypeError` が送"
"出されます。"

#: ../../library/configparser.rst:1073
msgid "Non-string section names raise :exc:`TypeError`."
msgstr "文字列でないセクション名は :exc:`TypeError` を送出します。"

#: ../../library/configparser.rst:1079
msgid ""
"Indicates whether the named *section* is present in the configuration. The "
"*default section* is not acknowledged."
msgstr ""
"指名された *section* が設定中に存在するかを示します。*default section* は認識"
"されません。"

#: ../../library/configparser.rst:1085
msgid "Return a list of options available in the specified *section*."
msgstr "指定された *section* 中で利用できるオプションのリストを返します。"

#: ../../library/configparser.rst:1090
msgid ""
"If the given *section* exists, and contains the given *option*, return :"
"const:`True`; otherwise return :const:`False`.  If the specified *section* "
"is :const:`None` or an empty string, DEFAULT is assumed."
msgstr ""
"与えられた *section* が存在し、与えられた *option* を含む場合、 :const:"
"`True` を返します。それ以外の場合には、 :const:`False` を返します。指定され"
"た *section* が :const:`None` または空文字列の場合、 DEFAULT が仮定されます。"

#: ../../library/configparser.rst:1097
msgid ""
"Attempt to read and parse an iterable of filenames, returning a list of "
"filenames which were successfully parsed."
msgstr ""
"ファイル名の iterable を読み込んでパースしようと試みます。正常にパースできた"
"ファイル名のリストを返します。"

#: ../../library/configparser.rst:1100
msgid ""
"If *filenames* is a string, a :class:`bytes` object or a :term:`path-like "
"object`, it is treated as a single filename.  If a file named in *filenames* "
"cannot be opened, that file will be ignored.  This is designed so that you "
"can specify an iterable of potential configuration file locations (for "
"example, the current directory, the user's home directory, and some system-"
"wide directory), and all existing configuration files in the iterable will "
"be read."
msgstr ""
"もし *filenames* が文字列か :class:`bytes` オブジェクトか :term:`path-like "
"object` なら、この引数は1つのファイル名として扱われます。 *filenames* 中に開"
"けないファイルがある場合、そのファイルは無視されます。この挙動は、設定ファイ"
"ルが置かれる可能性のある場所(例えば、 カレントディレクトリ、ホームディレクト"
"リ、システム全体の設定を行うディレクトリ)のイテラブルを指定して、イテラブルの"
"中で存在する全ての設定ファイルを読むことを想定して設計されています。 "

#: ../../library/configparser.rst:1109
msgid ""
"If none of the named files exist, the :class:`ConfigParser` instance will "
"contain an empty dataset.  An application which requires initial values to "
"be loaded from a file should load the required file or files using :meth:"
"`read_file` before calling :meth:`read` for any optional files::"
msgstr ""
"どの設定ファイルも存在しなかった場合、 :class:`ConfigParser` のインスタンス"
"は 空のデータセットを持ちます。初期値の設定ファイルを先に読み込んでおく必要が"
"あるアプリケーションでは、 オプションのファイルを読み込むために :meth:`read` "
"を呼ぶ前に 、まず :meth:`read_file` を用いて必要なファイルを読み込んでくださ"
"い::"

#: ../../library/configparser.rst:1115
msgid ""
"import configparser, os\n"
"\n"
"config = configparser.ConfigParser()\n"
"config.read_file(open('defaults.cfg'))\n"
"config.read(['site.cfg', os.path.expanduser('~/.myapp.cfg')],\n"
"            encoding='cp1250')"
msgstr ""

#: ../../library/configparser.rst:1122
msgid ""
"Added the *encoding* parameter. Previously, all files were read using the "
"default encoding for :func:`open`."
msgstr ""

#: ../../library/configparser.rst:1126
msgid "The *filenames* parameter accepts a :term:`path-like object`."
msgstr ""
"*filenames* 引数が :term:`path-like object` を受け入れるようになりました。"

#: ../../library/configparser.rst:1129
msgid "The *filenames* parameter accepts a :class:`bytes` object."
msgstr ""
"*filenames* 引数が :class:`bytes` オブジェクトを受け入れるようになりました。"

#: ../../library/configparser.rst:1135
msgid ""
"Read and parse configuration data from *f* which must be an iterable "
"yielding Unicode strings (for example files opened in text mode)."
msgstr ""
"設定データを *f* から読み込んで解析します。*f* は Unicode 文字列を yield する"
"イテラブル (例えばテキストモードで開かれたファイル) です。"

#: ../../library/configparser.rst:1138
msgid ""
"Optional argument *source* specifies the name of the file being read.  If "
"not given and *f* has a :attr:`!name` attribute, that is used for *source*; "
"the default is ``'<???>'``."
msgstr ""

#: ../../library/configparser.rst:1142
msgid "Replaces :meth:`!readfp`."
msgstr ":meth:`!readfp` を置き換えます。"

#: ../../library/configparser.rst:1147
msgid "Parse configuration data from a string."
msgstr "設定データを文字列から解析します。"

#: ../../library/configparser.rst:1149
msgid ""
"Optional argument *source* specifies a context-specific name of the string "
"passed.  If not given, ``'<string>'`` is used.  This should commonly be a "
"filesystem path or a URL."
msgstr ""
"オプションの引数 *source* はコンテキストにおける渡された文字列の名前を指定し"
"ます。与えられなければ、``'<string>'`` が使われます。これは一般にファイルシス"
"テムパスや URL にします。"

#: ../../library/configparser.rst:1158
msgid ""
"Load configuration from any object that provides a dict-like ``items()`` "
"method.  Keys are section names, values are dictionaries with keys and "
"values that should be present in the section.  If the used dictionary type "
"preserves order, sections and their keys will be added in order. Values are "
"automatically converted to strings."
msgstr ""
"辞書的な ``items()`` メソッドを提供する任意のオブジェクトから設定を読み込みま"
"す。キーはセクション名で、値はそのセクションに現れるキーと値をもつ辞書です。"
"使われた辞書型が順序を保存するなら、セクションおよびそのキーは順に加えられま"
"す。値は自動で文字列に変換されます。"

#: ../../library/configparser.rst:1164
msgid ""
"Optional argument *source* specifies a context-specific name of the "
"dictionary passed.  If not given, ``<dict>`` is used."
msgstr ""
"オプションの引数 *source* はコンテキストにおける渡された辞書の名前を指定しま"
"す。与えられなければ、``<dict>`` が使われます。"

#: ../../library/configparser.rst:1167
msgid "This method can be used to copy state between parsers."
msgstr "このメソッドを使ってパーサー間で状態をコピーできます。"

#: ../../library/configparser.rst:1174
msgid ""
"Get an *option* value for the named *section*.  If *vars* is provided, it "
"must be a dictionary.  The *option* is looked up in *vars* (if provided), "
"*section*, and in *DEFAULTSECT* in that order.  If the key is not found and "
"*fallback* is provided, it is used as a fallback value.  ``None`` can be "
"provided as a *fallback* value."
msgstr ""
"指名された *section* の *option* の値を取得します。*vars* が提供されるなら、"
"それは辞書でなければならず、(与えられたなら) *vars*, *section*, "
"*DEFAULTSECT* 内からこの順で *option* が探索されます。*fallback* の値として "
"``None`` を与えられます。"

#: ../../library/configparser.rst:1180
msgid ""
"All the ``'%'`` interpolations are expanded in the return values, unless the "
"*raw* argument is true.  Values for interpolation keys are looked up in the "
"same manner as the option."
msgstr ""
"*raw* が真でない時には、全ての ``'%'`` 置換は展開されてから返されます。置換後"
"の値はオプションと同じ順序で探されます。"

#: ../../library/configparser.rst:1184
msgid ""
"Arguments *raw*, *vars* and *fallback* are keyword only to protect users "
"from trying to use the third argument as the *fallback* fallback (especially "
"when using the mapping protocol)."
msgstr ""
"引数 *raw*, *vars* および *fallback* は、(特にマッピングプロトコルを使用する"
"ときに) ユーザーが第 3 引数を *fallback* フォールバックとして使おうとしないよ"
"うに、キーワード専用となりました。"

#: ../../library/configparser.rst:1192
msgid ""
"A convenience method which coerces the *option* in the specified *section* "
"to an integer.  See :meth:`get` for explanation of *raw*, *vars* and "
"*fallback*."
msgstr ""
"指定された *section* 中の *option* を整数に型強制する補助メソッドです。 "
"*raw*, *vars* および *fallback* の説明は :meth:`get` を参照してください。"

#: ../../library/configparser.rst:1199
msgid ""
"A convenience method which coerces the *option* in the specified *section* "
"to a floating-point number.  See :meth:`get` for explanation of *raw*, "
"*vars* and *fallback*."
msgstr ""

#: ../../library/configparser.rst:1206
msgid ""
"A convenience method which coerces the *option* in the specified *section* "
"to a Boolean value.  Note that the accepted values for the option are "
"``'1'``, ``'yes'``, ``'true'``, and ``'on'``, which cause this method to "
"return ``True``, and ``'0'``, ``'no'``, ``'false'``, and ``'off'``, which "
"cause it to return ``False``.  These string values are checked in a case-"
"insensitive manner.  Any other value will cause it to raise :exc:"
"`ValueError`.  See :meth:`get` for explanation of *raw*, *vars* and "
"*fallback*."
msgstr ""
"指定された *section* 中の *option* をブール値に型強制する補助メソッドです。な"
"お、このオプションで受け付けられる値はこのメソッドが ``True`` を返す "
"``'1'``, ``'yes'``, ``'true'``, および ``'on'``,と、このメソッドが ``False`` "
"を返す ``'0'``, ``'no'``, ``'false'``, and ``'off'`` です。その他のいかなる値"
"も :exc:`ValueError` を送出します。 *raw*, *vars* および *fallback* の説明"
"は :meth:`get` を参照してください。"

#: ../../library/configparser.rst:1219
msgid ""
"When *section* is not given, return a list of *section_name*, "
"*section_proxy* pairs, including DEFAULTSECT."
msgstr ""
"*section* が与えられなければ、DEFAULTSECT を含めた *section_name*, "
"*section_proxy* の対のリストを返します。"

#: ../../library/configparser.rst:1222
msgid ""
"Otherwise, return a list of *name*, *value* pairs for the options in the "
"given *section*.  Optional arguments have the same meaning as for the :meth:"
"`get` method."
msgstr ""
"与えられれば、与えられた *section* 中のオプションの *name*, *value* の対のリ"
"ストを返します。オプションの引数は :meth:`get` メソッドに与えるものと同じ意味"
"を持ちます。"

#: ../../library/configparser.rst:1226
msgid ""
"Items present in *vars* no longer appear in the result.  The previous "
"behaviour mixed actual parser options with variables provided for "
"interpolation."
msgstr ""
"*vars* に現れる項目は結果に表れなくなりました。以前の挙動は、実際のパーサーオ"
"プションを補間のために与えられた変数と混合していました。"

#: ../../library/configparser.rst:1234
msgid ""
"If the given section exists, set the given option to the specified value; "
"otherwise raise :exc:`NoSectionError`.  *option* and *value* must be "
"strings; if not, :exc:`TypeError` is raised."
msgstr ""
"与えられたセクションが存在すれば、与えられたオプションを指定された値に設定し"
"ます。そうでなければ :exc:`NoSectionError` を送出します。 *option* および "
"*value* は文字列でなければなりません。そうでなければ :exc:`TypeError` が送出"
"されます。"

#: ../../library/configparser.rst:1241
msgid ""
"Write a representation of the configuration to the specified :term:`file "
"object`, which must be opened in text mode (accepting strings).  This "
"representation can be parsed by a future :meth:`read` call.  If "
"*space_around_delimiters* is true, delimiters between keys and values are "
"surrounded by spaces."
msgstr ""
"設定の表現を指定された :term:`file object` に書き込みます。 *fileobject* は "
"(文字列を受け付ける) テキストモードで開かれていなければなりません。この表現は"
"後で :meth:`read` を呼び出すことでパースできます。 *space_around_delimiters* "
"が真なら、キーと値の間のデリミタはスペースで囲まれます。"

#: ../../library/configparser.rst:1249
msgid ""
"Comments in the original configuration file are not preserved when writing "
"the configuration back. What is considered a comment, depends on the given "
"values for *comment_prefix* and *inline_comment_prefix*."
msgstr ""

#: ../../library/configparser.rst:1257
msgid ""
"Remove the specified *option* from the specified *section*.  If the section "
"does not exist, raise :exc:`NoSectionError`.  If the option existed to be "
"removed, return :const:`True`; otherwise return :const:`False`."
msgstr ""
"指定された *option* を指定された *section* から削除します。セクションが存在し"
"なければ、 :exc:`NoSectionError` を送出します。オプションが存在して削除されれ"
"ば、 :const:`True` を返します。そうでなければ :const:`False` を返します。"

#: ../../library/configparser.rst:1265
msgid ""
"Remove the specified *section* from the configuration.  If the section in "
"fact existed, return ``True``.  Otherwise return ``False``."
msgstr ""
"指定された *section* を設定から削除します。セクションが実際に存在すれば、"
"``True`` を返します。そうでなければ ``False`` を返します。"

#: ../../library/configparser.rst:1271
msgid ""
"Transforms the option name *option* as found in an input file or as passed "
"in by client code to the form that should be used in the internal "
"structures.  The default implementation returns a lower-case version of "
"*option*; subclasses may override this or client code can set an attribute "
"of this name on instances to affect this behavior."
msgstr ""
"入力ファイルに現れた、またはクライアントコードで渡されたオプション名 "
"*option* を内部構造で実際に使われる形式に変換します。デフォルトの実装では "
"*option* の小文字版を返します。派生クラスでこれを上書きするか、クライアント"
"コードでインスタンス上のこの名前の属性を設定して、この動作に影響を与えること"
"ができます。"

#: ../../library/configparser.rst:1277
msgid ""
"You don't need to subclass the parser to use this method, you can also set "
"it on an instance, to a function that takes a string argument and returns a "
"string.  Setting it to ``str``, for example, would make option names case "
"sensitive::"
msgstr ""
"このメソッドを使うためにパーサーを派生クラス化させる必要はなく、インスタンス"
"上で、これを文字列引数をとって文字列を返す関数に設定できます。例えば、これを "
"``str`` に設定すると、オプション名に大文字小文字の区別をつけられます::"

#: ../../library/configparser.rst:1282
msgid ""
"cfgparser = ConfigParser()\n"
"cfgparser.optionxform = str"
msgstr ""

#: ../../library/configparser.rst:1285
msgid ""
"Note that when reading configuration files, whitespace around the option "
"names is stripped before :meth:`optionxform` is called."
msgstr ""
"なお、設定ファイルを読み込むとき、オプション名の周りの空白は :meth:"
"`optionxform` が呼び出される前に取り除かれます。"

#: ../../library/configparser.rst:1291
msgid ""
"A special object representing a section name used to reference the unnamed "
"section (see :ref:`unnamed-sections`)."
msgstr ""

#: ../../library/configparser.rst:1296
msgid ""
"The maximum depth for recursive interpolation for :meth:`~configparser."
"ConfigParser.get` when the *raw* parameter is false.  This is relevant only "
"when the default *interpolation* is used."
msgstr ""

#: ../../library/configparser.rst:1304
msgid "RawConfigParser Objects"
msgstr "RawConfigParser オブジェクト"

#: ../../library/configparser.rst:1315
msgid ""
"Legacy variant of the :class:`ConfigParser`.  It has interpolation disabled "
"by default and allows for non-string section names, option names, and values "
"via its unsafe ``add_section`` and ``set`` methods, as well as the legacy "
"``defaults=`` keyword argument handling."
msgstr ""

#: ../../library/configparser.rst:1336
msgid ""
"Consider using :class:`ConfigParser` instead which checks types of the "
"values to be stored internally.  If you don't want interpolation, you can "
"use ``ConfigParser(interpolation=None)``."
msgstr ""
"代わりに内部に保存する値の型を検査する :class:`ConfigParser` を使うことを検討"
"してください。補間を望まない場合、  ``ConfigParser(interpolation=None)`` を使"
"用できます。"

#: ../../library/configparser.rst:1343
msgid ""
"Add a section named *section* to the instance.  If a section by the given "
"name already exists, :exc:`DuplicateSectionError` is raised.  If the "
"*default section* name is passed, :exc:`ValueError` is raised."
msgstr ""
"インスタンスに *section* という名のセクションを追加します。与えられた名前のセ"
"クションがすでに存在すれば、 :exc:`DuplicateSectionError` が送出されます。 "
"*default section* 名が渡されると、 :exc:`ValueError` が送出されます。"

#: ../../library/configparser.rst:1347
msgid ""
"Type of *section* is not checked which lets users create non-string named "
"sections.  This behaviour is unsupported and may cause internal errors."
msgstr ""
"*section* の型は検査されないため、ユーザーは非文字列の名前付きセクションを作"
"ることができます。この振る舞いはサポートされておらず、内部エラーを起こす可能"
"性があります。"

#: ../../library/configparser.rst:1353
msgid ""
"If the given section exists, set the given option to the specified value; "
"otherwise raise :exc:`NoSectionError`.  While it is possible to use :class:"
"`RawConfigParser` (or :class:`ConfigParser` with *raw* parameters set to "
"true) for *internal* storage of non-string values, full functionality "
"(including interpolation and output to files) can only be achieved using "
"string values."
msgstr ""
"与えられたセクションが存在していれば、オプションを指定された値に設定します。"
"セクションが存在しなければ :exc:`NoSectionError` を発生させます。 :class:"
"`RawConfigParser` (あるいは *raw* パラメータをセットした :class:"
"`ConfigParser`) を文字列型でない値の *内部的な* 格納場所として使うことは可能"
"ですが、すべての機能 (置換やファイルへの出力を含む) がサポートされるのは文字"
"列を値として使った場合だけです。"

#: ../../library/configparser.rst:1360
msgid ""
"This method lets users assign non-string values to keys internally.  This "
"behaviour is unsupported and will cause errors when attempting to write to a "
"file or get it in non-raw mode.  **Use the mapping protocol API** which does "
"not allow such assignments to take place."
msgstr ""
"ユーザーは、このメソッドを使って非文字列の値をキーに代入できます。この振る舞"
"いはサポートされておらず、非rawモードでの値の取得や、ファイルへの書き出しを試"
"みた際にエラーの原因となりえます。このような代入を許さない  **マッピングプロ"
"トコルAPIを使用してください**。"

#: ../../library/configparser.rst:1367
msgid "Exceptions"
msgstr "例外"

#: ../../library/configparser.rst:1371
msgid "Base class for all other :mod:`configparser` exceptions."
msgstr "他の全ての :mod:`configparser` 例外の基底クラスです。"

#: ../../library/configparser.rst:1376
msgid "Exception raised when a specified section is not found."
msgstr "指定したセクションが見つからなかった時に起きる例外です。"

#: ../../library/configparser.rst:1381
msgid ""
"Exception raised if :meth:`~ConfigParser.add_section` is called with the "
"name of a section that is already present or in strict parsers when a "
"section if found more than once in a single input file, string or dictionary."
msgstr ""

#: ../../library/configparser.rst:1385
msgid ""
"Added the optional *source* and *lineno* attributes and parameters to :meth:"
"`!__init__`."
msgstr ""

#: ../../library/configparser.rst:1392
msgid ""
"Exception raised by strict parsers if a single option appears twice during "
"reading from a single file, string or dictionary. This catches misspellings "
"and case sensitivity-related errors, e.g. a dictionary may have two keys "
"representing the same case-insensitive configuration key."
msgstr ""
"strict なパーサーで、単一の入力ファイル、文字列、辞書中に同じオプションが複数"
"回現れたときに送出される例外です。これはミススペルや大文字小文字の区別に関係"
"するエラー、例えば辞書の二つのキーが同じ大文字小文字の区別のない設定キーを表"
"すこと、を捕捉します。"

#: ../../library/configparser.rst:1400
msgid ""
"Exception raised when a specified option is not found in the specified "
"section."
msgstr ""
"指定されたオプションが指定されたセクションに見つからないときに送出される例外"
"です。"

#: ../../library/configparser.rst:1406
msgid ""
"Base class for exceptions raised when problems occur performing string "
"interpolation."
msgstr "文字列の補間中に問題が起きた時に発生する例外の基底クラスです。"

#: ../../library/configparser.rst:1412
msgid ""
"Exception raised when string interpolation cannot be completed because the "
"number of iterations exceeds :const:`MAX_INTERPOLATION_DEPTH`.  Subclass of :"
"exc:`InterpolationError`."
msgstr ""
"繰り返しの回数が :const:`MAX_INTERPOLATION_DEPTH` を超えたために文字列補間が"
"完了しなかったときに送出される例外です。 :exc:`InterpolationError` の派生クラ"
"スです。"

#: ../../library/configparser.rst:1419
msgid ""
"Exception raised when an option referenced from a value does not exist. "
"Subclass of :exc:`InterpolationError`."
msgstr ""
":exc:`InterpolationError` の派生クラスで、値が参照しているオプションが見つか"
"らない場合に発生する例外です。"

#: ../../library/configparser.rst:1425
msgid ""
"Exception raised when the source text into which substitutions are made does "
"not conform to the required syntax.  Subclass of :exc:`InterpolationError`."
msgstr ""
"置換がなされるソーステキストが要求された文法を満たさないときに送出される例外"
"です。 :exc:`InterpolationError` の派生クラスです。"

#: ../../library/configparser.rst:1431
msgid ""
"Exception raised when attempting to parse a file which has no section "
"headers."
msgstr ""
"セクションヘッダを持たないファイルを構文解析しようとした時に起きる例外です。"

#: ../../library/configparser.rst:1437
msgid "Exception raised when errors occur attempting to parse a file."
msgstr "ファイルの構文解析中にエラーが起きた場合に発生する例外です。"

#: ../../library/configparser.rst:1439
msgid ""
"The ``filename`` attribute and :meth:`!__init__` constructor argument were "
"removed.  They have been available using the name ``source`` since 3.2."
msgstr ""

#: ../../library/configparser.rst:1445
msgid ""
"Exception raised when a key without a corresponding value is continued with "
"an indented line."
msgstr ""

#: ../../library/configparser.rst:1451
msgid "Footnotes"
msgstr "脚注"

#: ../../library/configparser.rst:1452
msgid ""
"Config parsers allow for heavy customization.  If you are interested in "
"changing the behaviour outlined by the footnote reference, consult the "
"`Customizing Parser Behaviour`_ section."
msgstr ""
"設定パーサーは大々的にカスタマイズできます。脚注の参照で概説された挙動の変更"
"に関心がある場合、`Customizing Parser Behaviour`_ セクションを参照してくださ"
"い。"

#: ../../library/configparser.rst:16
msgid ".ini"
msgstr ".ini"

#: ../../library/configparser.rst:16
msgid "file"
msgstr "ファイル"

#: ../../library/configparser.rst:16
msgid "configuration"
msgstr "設定"

#: ../../library/configparser.rst:16
msgid "ini file"
msgstr "ini ファイル"

#: ../../library/configparser.rst:16
msgid "Windows ini file"
msgstr "Windows ini ファイル"

#: ../../library/configparser.rst:367
msgid "% (percent)"
msgstr "% (パーセント)"

#: ../../library/configparser.rst:367 ../../library/configparser.rst:400
msgid "interpolation in configuration files"
msgstr ""

#: ../../library/configparser.rst:400
msgid "$ (dollar)"
msgstr "$ (ダラー)"