% values （何处） 格式 是字节对象）。 % 转换规范 格式 被零个或多个元素替换 价值观 . 效果类似于使用 sprintf() 用C语言。

如果 格式 需要一个参数， 价值观 可以是单个非元组对象。 否则， 价值观 必须是一个tuple，其值与format bytes对象指定的项数完全相同，或者是一个映射对象（例如，字典）。

转换说明符包含两个或多个字符，并具有以下组件，这些组件必须按此顺序出现：

1. 这个 '%' 字符，标记说明符的开头。

2. 映射键（可选），由带括号的字符序列组成（例如， (somename) ）

3. 转换标志（可选），影响某些转换类型的结果。

4. 最小字段宽度（可选）。如果指定为 '*' （星号），从中的元组的下一个元素读取实际宽度。 价值观 ，要转换的对象在最小字段宽度和可选精度之后。

5. 精度（可选），作为 '.' （点），然后是精度。如果指定为 '*' （星号），实际精度从中的元组的下一个元素读取。 价值观 ，要转换的值在精度之后。

当右参数是字典（或其他映射类型）时，则字节对象中的格式 must 在字典中包含一个插入括号的映射键 '%' 性格。映射键从映射中选择要格式化的值。例如：

在这种情况下，没有 * 说明符可能以一种格式出现（因为它们需要一个连续的参数列表）。

长度修改器 (h ， l 或 L ）可能存在，但会被忽略，因为这对于Python来说是不必要的——例如。 %ld 相同

1. 替代形式导致前导八进制说明符 ('0o' ）在第一个数字之前插入。

2. 替代形式导致前导 '0x' 或 '0X' （取决于 'x' 或 'X' 格式）插入第一个数字之前。

3. 替代形式使结果始终包含小数点，即使后面没有数字。

   精度决定小数点后的位数，默认为6。

4. 替代形式会导致结果始终包含小数点，并且尾随的零不会像原来那样被删除。

   精度决定小数点前后的有效位数，默认为6。

5. 如果精度是 N ，输出被截断为 N 字符。

6. b'%s' 已弃用，但在3.x系列中不会删除。

7. b'%r' 已弃用，但在3.x系列中不会删除。

对象允许python代码访问支持 不复制。

创建一个 参考文献 obj . obj 必须支持缓冲区协议。支持缓冲区协议的内置对象包括 和 .

A 有一个概念 要素 ，它是由原始对象处理的原子内存单元 obj . 对于许多简单类型，例如 和 ，元素是单个字节，但其他类型如 可能有更大的元素。

0 ，长度为1。如果 view.ndim = 1 ，长度等于视图中的元素数。对于更高的维度，长度等于视图的嵌套列表表示的长度。这个 属性将给出单个元素中的字节数。

A 支持切片和索引以公开其数据。一维切片将导致子视图：

如果 是中的本机格式说明符之一 模块，也支持使用整数或整数元组进行索引，并返回单个 要素 类型正确。一维内存视图可以用一个整数或一个整数元组进行索引。多维内存视图可以用精确的元组索引 ndim 整数在哪里 ndim 是维度数。零维内存视图可以用空元组进行索引。

以下是非字节格式的示例：

如果基础对象是可写的，则memoryView支持一维切片分配。不允许调整大小：：

格式为“b”、“b”或“c”的可散列（只读）类型的一维内存视图也可以散列。hash定义为 hash(m) == hash(m.tobytes()) ：：

在 3.3 版更改: 现在可以切片一维记忆视图。格式为“b”、“b”或“c”的一维内存视图现在可以散列。

在 3.5 版更改: 现在可以用整数元组为memoryview建立索引。

记忆视图和 如果导出器的形状是等效的，并且当操作数各自的格式代码被解释为 语法。

如果 模块，则对象将始终比较为不相等（即使格式字符串和缓冲区内容相同）：：

在 3.3 版更改: 以前的版本比较了原始内存，忽略了项格式和逻辑数组结构。

以字节串的形式返回缓冲区中的数据。这相当于调用 memoryView上的构造函数。：：

对于非连续数组，结果等于将所有元素转换为字节的扁平列表表示形式。 支持所有格式字符串，包括不在 模块语法。

3.8 新版功能: 秩序 可以是'C'、'F'、'A'。什么时候？ 秩序 为“c”或“f”，原始数组的数据转换为C或Fortran顺序。对于连续视图，“a”返回物理内存的精确副本。特别是，在内存中保留了FORTRAN顺序。对于非连续视图，首先将数据转换为C。 order=None

返回一个字符串对象，该对象包含缓冲区中每个字节的两个十六进制数字。：：

以元素列表的形式返回缓冲区中的数据。：：

释放由memoryView对象公开的基础缓冲区。许多对象在其上保留视图时会采取特殊操作（例如， 会暂时禁止调整大小）；因此，调用release（）可以很方便地尽快删除这些限制（并释放任何悬空资源）。

调用此方法后，对视图的任何进一步操作都将引发 （除外） 自身，可多次调用）：：

上下文管理协议可以用于类似的效果，使用 with 声明：

目标格式仅限于中的单个元素本机格式 语法。其中一种格式必须是字节格式（“b”、“b”或“c”）。结果的字节长度必须与原始长度相同。

将1d/长转换为1d/无符号字节：：

将1d/无符号字节强制转换为1d/字符：：

将1d/字节转换为3d/整数转换为1d/有符号字符：

将1d/无符号长转换为2d/无符号长：

在 3.5 版更改: 当强制转换为字节视图时，源格式不再受到限制。

还有几个只读属性可用：

这是数组将在连续表示中使用的字节空间量。它不一定等于 len(m) ：：

指示内存是否为只读的布尔值。

模块样式）。可以从具有任意格式字符串的导出器创建memoryView，但某些方法（例如 ）仅限于本机单个元素格式。

memoryView的每个元素的字节大小：

一个整数，指示内存表示的多维数组的维数。

整数的一个元组，其长度为 以n维数组的形式给出存储器的形状。

整数的一个元组，其长度为 为数组的每个维度提供访问每个元素的字节大小。

内部用于PIL样式数组。该值仅供参考。

指示内存是否为C的布尔值。 - .

指示内存是否为Fortran的布尔值 .

A set 对象是distinct的无序集合 物体。常见的用途包括成员资格测试、从序列中删除重复项以及计算数学运算，如交集、并集、差分和对称差分。（对于其他容器，请参见内置的 ， 和 课程，以及 模块。

.作为无序集合，集合不记录元素位置或插入顺序。因此，集合不支持索引、切片或其他类似序列的行为。

目前有两种内置的集合类型， 和 . 这个 类型是可变的---可以使用如下方法更改内容 add() 和 remove() . 因为它是可变的，所以它没有hash值，不能用作字典键或另一个集合的元素。这个 类型不可变且 ---其内容创建后不能更改，因此可以用作字典键或其他集合的元素。

非空集（非冻结集）可以通过在大括号内放置以逗号分隔的元素列表来创建，例如： {{'jack', 'sjoerd'}} ，除了 构造函数。

两个类的构造函数的工作原理相同：

返回其元素取自的新集合或冻结集合对象 可迭代的 . 集合的元素必须是 . 要表示集合的集合，内部集合必须 物体。如果 可迭代的 未指定，将返回新的空集。

可以通过多种方式创建集合：

实例 和 提供以下操作：

返回集合中的元素数 s （基数） s ）

返回 True 如果集合中没有与 other . 当且仅当集合的交集为空集合时，集合才是不相交的。

测试集合中的每个元素是否都在 other .

测试中的每个元素 other 在集合中。

返回包含集合和所有其他元素的新集合。

返回一个新集合，其中包含集合和所有其他集合的公共元素。

返回一个新集合，集合中的元素不在其他集合中。

返回包含集合或中元素的新集合 other 但并非两者兼而有之。

注：非操作员版本 ， ， ， ， 和 方法将接受任何ITerable作为参数。相反，它们基于运算符的对应项要求将参数设置为集合。这排除了容易出错的结构，例如 set('abc') & 'cbs' 有利于提高可读性

支持设置为设置比较。如果且仅当每个集合的每个元素都包含在另一个集合中（每个元素都是另一个集合的子集），则两个集合相等。如果且仅当第一个集合是第二个集合的适当子集（是子集，但不相等），则集合小于另一个集合。当且仅当第一个集合是第二个集合的适当超集（是超集，但不等于）时，集合大于另一个集合。

实例 与 基于他们的成员。例如， set('abc')

子集和相等比较不能概括为总排序函数。例如，任意两个非空的不相交集不相等，也不是彼此的子集，因此 all 以下返回的 False ： a<b ， a==b 或

由于集合只定义部分排序（子集关系），因此 方法未定义集合列表。

集合元素（如字典键）必须 .

混合的二元运算 实例与 返回第一个操作数的类型。例如：

下表列出了可用于 不适用于 ：

更新集合，添加所有其他元素。

更新集合，只保留其中的元素和所有其他元素。

更新集合，删除在其他集合中找到的元素。

更新集合，只保留在任一集合中找到的元素，而不同时保留在两者中。

添加元素 elem 到集合。

移除元素 elem 从集合。引发 如果 elem 不包含在集合中。

移除元素 elem 如果存在的话。

从集合中移除并返回任意元素。引发 如果集合为空。

从集合中移除所有元素。

注意，非操作员版本的 ， ， 和 方法将接受任何ITerable作为参数。

注意， elem 参数 __contains__() ， 和 方法可以是一组。为了支持搜索等效冻结集，从创建临时冻结集 elem .

A 对象映射 任意对象的值。映射是可变对象。当前只有一种标准映射类型，即 dictionary . （对于其他容器，请参见内置的 ， 和 课程，以及 模块。

字典的键是 几乎 任意值。不是的值 也就是说，包含列表、字典或其他可变类型（按值而不是按对象标识进行比较）的值不能用作键。用于键的数字类型遵循数字比较的常规规则：如果两个数字比较相等（例如 1 和 1.0 ）然后可以互换使用它们来索引同一个字典条目。（但是请注意，由于计算机将浮点数字存储为近似值，因此将它们用作字典键通常是不明智的。）

返回从可选位置参数和可能为空的关键字参数集初始化的新字典。

可以通过以下几种方式创建词典：

如果没有指定位置参数，则创建空字典。如果给定了位置参数并且它是映射对象，则将使用与映射对象相同的键值对创建字典。否则，位置参数必须是 对象。iterable中的每个项本身必须是一个iterable，只有两个对象。每个项的第一个对象将成为新字典中的键，第二个对象将成为相应的值。如果键出现多次，则该键的最后一个值将成为新字典中的对应值。

如果给定关键字参数，则关键字参数及其值将添加到从位置参数创建的字典中。如果已存在要添加的键，则关键字参数中的值将替换位置参数中的值。

如第一个示例所示，提供关键字参数只对有效的Python标识符的键有效。否则，可以使用任何有效密钥。

这些是字典支持的操作（因此，自定义映射类型也应该支持）：

返回字典中使用的所有键的列表 d .

返回字典中的项数 d .

返回的项 d 带钥匙 key .提高 如果 key 不在地图上。

0

返回对字典键的迭代器。这是一个快捷方式 iter(d.keys()) .

使用键从创建新词典 可迭代的 和值设置为 value .

是返回新字典的类方法。 价值 默认为 None . 所有的值都只引用一个实例，因此对于 价值 是可变对象，如空列表。要获得不同的值，请使用 相反。

返回字典键的新视图。查看 .

如果 key 在字典中，移除并返回其值，否则返回 default . 如果 default 没有给予和 key 不在字典中，a 提高了。

对于破坏性地迭代字典非常有用，这在集合算法中经常使用。如果字典为空，则调用 提高 .

在 3.7 版更改: 后进先出订单现已得到保证。在以前的版本中， 将返回任意键/值对。

使用来自的键/值对更新字典 other ，覆盖现有密钥。返回 None .

接受另一个字典对象或键/值对的iterable（作为元组或长度为2的其他iterable）。如果指定了关键字参数，则字典将使用这些键/值对进行更新：

返回字典值的新视图。见 .

使用合并的键和值创建新词典 d 和 其他 ，必须都是字典。价值观 其他 优先考虑 d 和 其他 共享密钥。

更新字典 d 键和值来自 其他 ，可以是 或 键/值对的。价值观 其他 优先考虑 d 和 其他 共享密钥。

字典只有在具有相同的条件下才具有相等的比较 (key, value) 成对（不考虑顺序）。顺序比较（“<”、“<=”、“>=”、“>”）提升 .

词典保留插入顺序。请注意，更新密钥不会影响顺序。删除后添加的键将插入到末尾。：：

在 3.7 版更改: 字典顺序保证为插入顺序。这个行为是3.6中的cpython的一个实现细节。

字典和字典视图是可逆的。地址：

在 3.8 版更改: 字典现在是可逆的。

Python 的 语句支持由上下文管理器定义的运行时上下文的概念。这是使用一对方法实现的，这些方法允许用户定义的类定义在执行语句体之前输入的运行时上下文，并在语句结束时退出：

输入运行时上下文并返回此对象或与运行时上下文相关的其他对象。此方法返回的值绑定到 as 条款 使用此上下文管理器的语句。

返回自身的上下文管理器的示例是 . 文件对象从回车返回到允许 将用作

返回相关对象的上下文管理器的示例是 .这些管理器将活动的十进制上下文设置为原始十进制上下文的副本，然后返回副本。这允许对正文中的当前十进制上下文进行更改 不影响代码的语句 with 语句。

退出运行时上下文并返回一个布尔标志，指示是否应取消发生的任何异常。如果在执行 语句中，参数包含异常类型、值和回溯信息。否则，这三个参数都是 None .

从该方法返回真值将导致 语句来抑制异常并继续执行 with 语句。否则，在该方法完成执行后，异常将继续传播。在执行此方法期间发生的异常将替换在

传入的异常决不应显式重新引发-相反，此方法应返回一个错误值，以指示该方法已成功完成，并且不希望抑制引发的异常。这允许上下文管理代码轻松检测 方法实际上失败了。

python定义了几个上下文管理器，以支持简单的线程同步、文件或其他对象的快速关闭以及活动十进制算术上下文的简单操作。除了上下文管理协议的实现之外，不专门处理特定类型。见 一些例子的模块。

方法，而不是由未修饰的生成器函数生成的迭代器。

注意，在python/c api中的python对象的类型结构中，这些方法都没有特定的槽。想要定义这些方法的扩展类型必须将它们作为普通的Python可访问方法提供。与设置运行时上下文的开销相比，单个类字典查找的开销可以忽略不计。

的核心内置类型 是 和 。

解释器支持其他几种对象。其中大多数只支持一个或两个操作。

实现将一些特殊的只读属性添加到几个与之相关的对象类型中。其中一些不是由 内置功能。

用于存储对象（可写）属性的字典或其他映射对象。

类、函数、方法、描述符或生成器实例的名称。

这个 类、函数、方法、描述符或生成器实例的。

此属性是在方法解析期间查找基类时考虑的类的元组。

此方法可以由元类重写，以自定义其实例的方法解析顺序。它在类实例化时调用，其结果存储在 .

每个类都保留对其直接子类的弱引用列表。此方法返回所有仍处于活动状态的引用的列表。该列表按定义顺序排列。示例：：