# 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:

# Rafael Fontenelle <[email protected]>, 2025

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.12\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2025-07-25 16:03+0000\n"

"PO-Revision-Date: 2025-07-18 19:57+0000\n"

"Last-Translator: Rafael Fontenelle <[email protected]>, 2025\n"

"Language-Team: Chinese (China) (https://app.transifex.com/python-doc/teams/5390/zh_CN/)\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Language: zh_CN\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 ""

"此模块提供了它实现一种基本配置语言 :class:`ConfigParser` 类，这种语言所提供的结构与 Microsoft Windows INI "

"文件的类似。 你可以使用这种语言来编写能够由最终用户来自定义的 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 Registry 扩展版本 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 "TOML 是一种具有良好规范的针对应用程序配置文件的格式。 它被专门设计作为 INI 改进版本。"

#: ../../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 shell 的同样可被用于应用程序配置文件的迷你语言。"

#: ../../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 "``json`` 模块实现了 JavaScript 语法的一个子集，它有时被用于配置，但是不支持注释。"

#: ../../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 ""

"[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"

#: ../../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>`_。 "

"总的来说，这种文件由多个节组成，每个节包含多个带有值的键。 :mod:`configparser` 类可以读取和写入这种文件。 "

"让我们先通过程序方式来创建上述的配置文件。"

#: ../../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 ""

">>> 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' # 更改解析器\n"

">>> topsecret['ForwardX11'] = 'no' # same here\n"

">>> config['DEFAULT']['ForwardX11'] = 'yes'\n"

">>> with open('example.ini', 'w') as configfile:\n"

"... config.write(configfile)\n"

"..."

#: ../../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 ""

"如你所见，我们可以把配置解析器当作一个字典来处理。 两者确实存在差异，`将在后文说明 <#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 ""

">>> 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'"

#: ../../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:967

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 ""

"将多个配置读入单个 :class:`ConfigParser` 是可能的，其中最近添加的配置具有最高优先级。 "

"任何冲突的键都会从更近的配置获取并且先前存在的键会被保留。 下面的例子读入一个 ``override.ini`` 文件，它将覆盖任何来自 "

"``example.ini`` 文件的冲突的键。"

#: ../../library/configparser.rst:155 ../../library/configparser.rst:974

msgid ""

"[DEFAULT]\n"

"ServerAliveInterval = -1"

msgstr ""

"[DEFAULT]\n"

"ServerAliveInterval = -1"

#: ../../library/configparser.rst:160 ../../library/configparser.rst:979

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 ""

">>> 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"

#: ../../library/configparser.rst:174

msgid ""

"This behaviour is equivalent to a :meth:`ConfigParser.read` call with "

"several files passed to the *filenames* parameter."

msgstr "此行为等价于一次 :meth:`ConfigParser.read` 调用并向 *filenames* 形参传入多个文件。"

#: ../../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 "配置解析器并不会猜测配置文件中值的类型，而总是将它们在内部存储为字符串。 这意味着如果你需要其他数据类型，你应当自己来转换:"

#: ../../library/configparser.rst:185

msgid ""

">>> int(topsecret['Port'])\n"

"50022\n"

">>> float(topsecret['CompressionLevel'])\n"

"9.0"

msgstr ""

">>> int(topsecret['Port'])\n"

"50022\n"

">>> float(topsecret['CompressionLevel'])\n"

"9.0"

#: ../../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``。 为解决这个问题配置解析器还提供了 "

":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 ""

">>> topsecret.getboolean('ForwardX11')\n"

"False\n"

">>> config['forge.example'].getboolean('ForwardX11')\n"

"True\n"

">>> config.getboolean('forge.example', 'Compression')\n"

"True"

#: ../../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 ""

"除了 :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 "与字典类似，你可以使用某一节的 :meth:`~ConfigParser.get` 方法来提供回退值："

#: ../../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 ""

">>> topsecret.get('Port')\n"

"'50022'\n"

">>> topsecret.get('CompressionLevel')\n"

"'9'\n"

">>> topsecret.get('Cipher')\n"

">>> topsecret.get('Cipher', '3des-cbc')\n"

"'3des-cbc'"

#: ../../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 ""

">>> topsecret.get('CompressionLevel', '3')\n"

"'9'"

#: ../../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 ""

"还需要注意的一点是解析器层级的 :meth:`~ConfigParser.get` 方法提供了自定义的更复杂接口，它被继续维护用于向下兼容。 "

"当使用此方法时，可以通过 ``fallback`` 仅限关键字参数提供一个回退值："

#: ../../library/configparser.rst:246

msgid ""

">>> config.get('forge.example', 'monster',\n"

"... fallback='No such things as monsters')\n"

"'No such things as monsters'"

msgstr ""

">>> config.get('forge.example', 'monster',\n"

"... fallback='No such things as monsters')\n"

"'No such things as monsters'"

#: ../../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 ""

">>> '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"

#: ../../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 ""

"配置文件是由小节组成的，每个小节都有一个 ``[section]`` 标头，加上多个由特定字符串 (默认为 ``=`` 或 ``:`` [1]_) "

"分隔的键/值条目。 在默认情况下，小节名对大小写敏感而键对大小写不敏感 [1]_。 键和值开头和末尾的空格会被移除。 在解释器配置允许时值可以被省略 "

"[1]_，在此情况下键/值分隔符也可以被省略。 值还可以跨越多行，只要值的其他行带有比第一行更深的缩进。 "

"依据解析器的具体模式，空白行可能会被视为多行值的组成部分或是被忽略。"

#: ../../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 ""

"在默认情况下，有效的节名称可以是不包含 '\\\\n' 的任意字符串。 要改变此设定，请参阅 :attr:`ConfigParser.SECTCRE`。"

#: ../../library/configparser.rst:283

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:287 ../../library/configparser.rst:350

msgid "For example:"

msgstr "例如:"

#: ../../library/configparser.rst:289

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 ""

"[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?"

#: ../../library/configparser.rst:335

msgid "Interpolation of values"

msgstr "值的插值"

#: ../../library/configparser.rst:337

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` 还支持插值。 这意味着值可以在被 ``get()`` 调用返回之前进行预处理。"

#: ../../library/configparser.rst:345

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:352

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 ""

"[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%%"

#: ../../library/configparser.rst:363

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 ""

"在上面的例子里，:class:`ConfigParser` 的 *interpolation* 设为 "

"``BasicInterpolation()``，这会将 ``%(home_dir)s`` 求解为 ``home_dir`` 的值 (在这里是 "

"``/Users``)。 ``%(my_dir)s`` 的将被实际求解为 ``/Users/lumberjack``。 "

"所有插值都是按需进行的，这样引用链中使用的键不必以任何特定顺序在配置文件中指明。"

#: ../../library/configparser.rst:370

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_dir)s/Pictures`` 作为 "

"``my_pictures`` 的值，并返回 ``%(home_dir)s/lumberjack`` 作为 ``my_dir`` 的值。"

#: ../../library/configparser.rst:378

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:385

msgid ""

"For example, the configuration specified above with basic interpolation, "

"would look like this with extended interpolation:"

msgstr "例如，上面使用基本插值描述的配置，使用扩展插值将是这个样子:"

#: ../../library/configparser.rst:388

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 ""

"[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"

#: ../../library/configparser.rst:399

msgid "Values from other sections can be fetched as well:"

msgstr "来自其他小节的值也可以被获取:"

#: ../../library/configparser.rst:401

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 ""

"[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}"

#: ../../library/configparser.rst:421

msgid "Mapping Protocol Access"

msgstr "映射协议访问"

#: ../../library/configparser.rst:425

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:430

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:436

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` ABC 规范的。 但是，还是有一些差异应当被纳入考虑:"

#: ../../library/configparser.rst:441

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`` 形式的选项键名称。 也就是说默认使用小写字母键名。 与此同时，对于一个包含键 ``'a'`` "

"的小节，以下两个表达式均将返回 ``True``::"

#: ../../library/configparser.rst:446

msgid ""

"\"a\" in parser[\"section\"]\n"

"\"A\" in parser[\"section\"]"

msgstr ""

"\"a\" in parser[\"section\"]\n"

"\"A\" in parser[\"section\"]"

#: ../../library/configparser.rst:449

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:456

msgid "``DEFAULTSECT`` cannot be removed from the parser:"

msgstr "``DEFAULTSECT`` 无法从解析器中被移除:"

#: ../../library/configparser.rst:458

msgid "trying to delete it raises :exc:`ValueError`,"

msgstr "尝试删除将引发 :exc:`ValueError`，"

#: ../../library/configparser.rst:460

msgid "``parser.clear()`` leaves it intact,"

msgstr "``parser.clear()`` 会保留其原状，"

#: ../../library/configparser.rst:462

msgid "``parser.popitem()`` never returns it."

msgstr "``parser.popitem()`` 绝不会将其返回。"

#: ../../library/configparser.rst:464

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()`` 方法可同时兼容映射协议和经典配置解析器 API。"

#: ../../library/configparser.rst:468

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()`` 兼容映射协议（返回 *section_name*, *section_proxy* 对的列表，包括 "

"DEFAULTSECT）。 但是，此方法也可以附带参数被唤起: ``parser.items(section, raw, vars)``。 "

"这种调用形式返回指定 ``section`` 的 *option*, *value* 对的列表，将展开所有插值（除非提供了 ``raw=True`` "

"选项）。"

#: ../../library/configparser.rst:475

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:481

msgid "Customizing Parser Behaviour"

msgstr "定制解析器行为"

#: ../../library/configparser.rst:483

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:489

msgid ""

"The most common way to change the way a specific config parser works is to "

"use the :meth:`!__init__` options:"

msgstr "改变特定配置解析器行为的最常见方式是使用 :meth:`!__init__` 选项："

#: ../../library/configparser.rst:492

msgid "*defaults*, default value: ``None``"

msgstr "*defaults*，默认值: ``None``"

#: ../../library/configparser.rst:494

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:499

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 "提示：如果你想要为特定的节指定默认值，请在读取实际文件之前 使用 :meth:`~ConfigParser.read_dict`。"

#: ../../library/configparser.rst:502

msgid "*dict_type*, default value: :class:`dict`"

msgstr "*dict_type*，默认值: :class:`dict`"

#: ../../library/configparser.rst:504

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:509

msgid ""

"An alternative dictionary type can be used for example to sort sections and "

"options on write-back."

msgstr "还有其他替换的字典类型可以使用，例如在写回数据时对小节和选项进行排序。"

#: ../../library/configparser.rst:512

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:516

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 ""

">>> 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']"

#: ../../library/configparser.rst:534

msgid "*allow_no_value*, default value: ``False``"

msgstr "*allow_no_value*，默认值: ``False``"

#: ../../library/configparser.rst:536

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:541

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 ""

">>> 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"

">>> # 有值的设置像之前一样处理：\n"

">>> config[\"mysqld\"][\"user\"]\n"