8.19. repr — 替代 repr() 实现 — Python 文档

8.19. 代表 — 替代代表（） 执行

笔记

repr 模块已在 Python 3 中重命名为 reprlib。 2to3 工具将在将您的源代码转换为 Python 3 时自动调整导入。

源代码： :source:`Lib/repr.py`

---

repr 模块提供了一种生成对象表示的方法，对结果字符串的大小有限制。 这在 Python 调试器中使用，并且在其他上下文中也可能有用。

该模块提供了一个类、一个实例和一个函数：

class repr.Repr

提供格式化服务的类，用于实现类似于内置 repr() 的功能； 添加了不同对象类型的大小限制，以避免生成过长的表示。

repr.aRepr

这是 Repr 的一个实例，用于提供下面描述的 repr() 函数。 更改此对象的属性将影响 repr() 和 Python 调试器使用的大小限制。

repr.repr(obj)

这是aRepr的repr()方法。 它返回一个类似于同名内置函数返回的字符串，但对大多数大小有限制。

8.19.1. 再现对象

Repr 实例提供了几个属性，可用于为不同对象类型的表示提供大小限制，以及格式化特定对象类型的方法。

Repr.maxlevel

创建递归表示的深度限制。 默认值为 6。

Repr.maxdict
Repr.maxlist
Repr.maxtuple
Repr.maxset
Repr.maxfrozenset
Repr.maxdeque
Repr.maxarray

限制为命名对象类型表示的条目数。 maxdict 的默认值为 4，maxarray 的默认值为 5，其他的默认值为 6。

2.4 版新功能：maxset、maxfrozenset 和 set。

Repr.maxlong

长整数表示中的最大字符数。 数字从中间丢弃。 默认值为 40。

Repr.maxstring

限制字符串表示中的字符数。 请注意，字符串的“正常”表示被用作字符源：如果表示中需要转义序列，则在缩短表示时这些可能会被破坏。 默认值为 30。

Repr.maxother

此限制用于控制在 Repr 对象上没有可用特定格式设置方法的对象类型的大小。 它的应用方式与 maxstring 类似。 默认值为 20。

Repr.repr(obj)

等效于使用实例强加的格式的内置 repr()。

Repr.repr1(obj, level)

repr() 使用的递归实现。 这使用 obj 的类型来确定要调用的格式化方法，将其传递给 obj 和 level。 特定于类型的方法应该调用 repr1() 来执行递归格式化，在递归调用中使用 level - 1 作为 level 的值。

Repr.repr_TYPE(obj, level)

特定类型的格式化方法被实现为具有基于类型名称的名称的方法。 在方法名称中，TYPE 替换为 string.join(string.split(type(obj).__name__, '_'))。 对这些方法的调度由 repr1() 处理。 需要递归格式化值的特定于类型的方法应该调用 self.repr1(subobj, level - 1)。

8.19.2. 子类化 Repr 对象

Repr.repr1() 使用动态调度允许 Repr 的子类添加对其他内置对象类型的支持或修改已支持类型的处理。 此示例显示如何添加对文件对象的特殊支持：

import repr as reprlib
import sys

class MyRepr(reprlib.Repr):
    def repr_file(self, obj, level):
        if obj.name in ['<stdin>', '<stdout>', '<stderr>']:
            return obj.name
        else:
            return repr(obj)

aRepr = MyRepr()
print aRepr.repr(sys.stdin)          # prints '<stdin>'