X7ROOT File Manager
Current Path:
/usr/share/doc/python2-docs/html/library
usr
/
share
/
doc
/
python2-docs
/
html
/
library
/
π
..
π
2to3.html
(58.11 KB)
π
__builtin__.html
(10.81 KB)
π
__future__.html
(14.34 KB)
π
__main__.html
(7.34 KB)
π
_winreg.html
(63.12 KB)
π
abc.html
(25.22 KB)
π
aepack.html
(13.83 KB)
π
aetools.html
(16 KB)
π
aetypes.html
(20.53 KB)
π
aifc.html
(24.48 KB)
π
al.html
(18.23 KB)
π
allos.html
(34.47 KB)
π
anydbm.html
(17.7 KB)
π
archiving.html
(9.84 KB)
π
argparse.html
(257.44 KB)
π
array.html
(31.11 KB)
π
ast.html
(37.27 KB)
π
asynchat.html
(33.13 KB)
π
asyncore.html
(39.68 KB)
π
atexit.html
(18.02 KB)
π
audioop.html
(33.45 KB)
π
autogil.html
(8.53 KB)
π
base64.html
(21.35 KB)
π
basehttpserver.html
(36.56 KB)
π
bastion.html
(11.52 KB)
π
bdb.html
(40.42 KB)
π
binascii.html
(22.46 KB)
π
binhex.html
(11.04 KB)
π
bisect.html
(24.09 KB)
π
bsddb.html
(27.92 KB)
π
bz2.html
(28.37 KB)
π
calendar.html
(40.78 KB)
π
carbon.html
(50.78 KB)
π
cd.html
(29.33 KB)
π
cgi.html
(54.61 KB)
π
cgihttpserver.html
(13.7 KB)
π
cgitb.html
(11.98 KB)
π
chunk.html
(15.53 KB)
π
cmath.html
(27.7 KB)
π
cmd.html
(28.36 KB)
π
code.html
(26.33 KB)
π
codecs.html
(115.49 KB)
π
codeop.html
(15.53 KB)
π
collections.html
(144.19 KB)
π
colorpicker.html
(7.85 KB)
π
colorsys.html
(11.64 KB)
π
commands.html
(15.15 KB)
π
compileall.html
(18.18 KB)
π
compiler.html
(74.12 KB)
π
configparser.html
(66.16 KB)
π
constants.html
(13.65 KB)
π
contextlib.html
(22.24 KB)
π
cookie.html
(40.87 KB)
π
cookielib.html
(88.9 KB)
π
copy.html
(12.7 KB)
π
copy_reg.html
(14.35 KB)
π
crypt.html
(10.4 KB)
π
crypto.html
(7.58 KB)
π
csv.html
(74.66 KB)
π
ctypes.html
(258.37 KB)
π
curses.ascii.html
(24.29 KB)
π
curses.html
(163.58 KB)
π
curses.panel.html
(15.45 KB)
π
custominterp.html
(7.84 KB)
π
datatypes.html
(17.59 KB)
π
datetime.html
(247.5 KB)
π
dbhash.html
(16.43 KB)
π
dbm.html
(13.19 KB)
π
debug.html
(10.45 KB)
π
decimal.html
(217.1 KB)
π
development.html
(14.48 KB)
π
difflib.html
(89.82 KB)
π
dircache.html
(12.01 KB)
π
dis.html
(82.18 KB)
π
distribution.html
(7.5 KB)
π
distutils.html
(9.91 KB)
π
dl.html
(17.25 KB)
π
doctest.html
(181.53 KB)
π
docxmlrpcserver.html
(17.16 KB)
π
dumbdbm.html
(15.18 KB)
π
dummy_thread.html
(9.83 KB)
π
dummy_threading.html
(8.72 KB)
π
easydialogs.html
(32.35 KB)
π
email-examples.html
(46.31 KB)
π
email.charset.html
(28.73 KB)
π
email.encoders.html
(12.55 KB)
π
email.errors.html
(17.53 KB)
π
email.generator.html
(22.6 KB)
π
email.header.html
(28.43 KB)
π
email.html
(54.42 KB)
π
email.iterators.html
(12.33 KB)
π
email.message.html
(68.54 KB)
π
email.mime.html
(30.91 KB)
π
email.parser.html
(34.32 KB)
π
email.utils.html
(26.44 KB)
π
ensurepip.html
(17.9 KB)
π
errno.html
(39.3 KB)
π
exceptions.html
(62.2 KB)
π
fcntl.html
(25.63 KB)
π
filecmp.html
(23.43 KB)
π
fileformats.html
(9.43 KB)
π
fileinput.html
(26.44 KB)
π
filesys.html
(10.61 KB)
π
fl.html
(55.2 KB)
π
fm.html
(12.7 KB)
π
fnmatch.html
(15.88 KB)
π
formatter.html
(36.5 KB)
π
fpectl.html
(16.48 KB)
π
fpformat.html
(11.19 KB)
π
fractions.html
(24.3 KB)
π
framework.html
(36.07 KB)
π
frameworks.html
(7.37 KB)
π
ftplib.html
(48.42 KB)
π
functions.html
(200.82 KB)
π
functools.html
(28.95 KB)
π
future_builtins.html
(14.14 KB)
π
gc.html
(27.76 KB)
π
gdbm.html
(17.39 KB)
π
gensuitemodule.html
(12.28 KB)
π
getopt.html
(24.69 KB)
π
getpass.html
(11.16 KB)
π
gettext.html
(82.98 KB)
π
gl.html
(23.77 KB)
π
glob.html
(14.09 KB)
π
grp.html
(11.05 KB)
π
gzip.html
(20.09 KB)
π
hashlib.html
(24.87 KB)
π
heapq.html
(34.07 KB)
π
hmac.html
(14.04 KB)
π
hotshot.html
(19.67 KB)
π
htmllib.html
(27.03 KB)
π
htmlparser.html
(41.44 KB)
π
httplib.html
(69.27 KB)
π
i18n.html
(9.81 KB)
π
ic.html
(18.22 KB)
π
idle.html
(41.16 KB)
π
imageop.html
(15.72 KB)
π
imaplib.html
(57.14 KB)
π
imgfile.html
(12.43 KB)
π
imghdr.html
(11.95 KB)
π
imp.html
(36.72 KB)
π
importlib.html
(8.72 KB)
π
imputil.html
(32.78 KB)
π
index.html
(77.23 KB)
π
inspect.html
(55.49 KB)
π
internet.html
(25.53 KB)
π
intro.html
(9.13 KB)
π
io.html
(111.04 KB)
π
ipc.html
(16.21 KB)
π
itertools.html
(122.46 KB)
π
jpeg.html
(13.43 KB)
π
json.html
(71.95 KB)
π
keyword.html
(8.02 KB)
π
language.html
(11.41 KB)
π
linecache.html
(11.15 KB)
π
locale.html
(60.13 KB)
π
logging.config.html
(78.17 KB)
π
logging.handlers.html
(78.31 KB)
π
logging.html
(107.67 KB)
π
mac.html
(22.83 KB)
π
macos.html
(15.75 KB)
π
macosa.html
(13.75 KB)
π
macostools.html
(16.5 KB)
π
macpath.html
(8.19 KB)
π
mailbox.html
(167.11 KB)
π
mailcap.html
(13.8 KB)
π
markup.html
(19.4 KB)
π
marshal.html
(19 KB)
π
math.html
(42.98 KB)
π
md5.html
(14.77 KB)
π
mhlib.html
(23.56 KB)
π
mimetools.html
(20.71 KB)
π
mimetypes.html
(29.92 KB)
π
mimewriter.html
(15.7 KB)
π
mimify.html
(14.92 KB)
π
miniaeframe.html
(12.8 KB)
π
misc.html
(7.07 KB)
π
mm.html
(9.35 KB)
π
mmap.html
(30.11 KB)
π
modulefinder.html
(17.67 KB)
π
modules.html
(8.81 KB)
π
msilib.html
(56.5 KB)
π
msvcrt.html
(20.73 KB)
π
multifile.html
(25.64 KB)
π
multiprocessing.html
(404.82 KB)
π
mutex.html
(11.86 KB)
π
netdata.html
(17.95 KB)
π
netrc.html
(13.69 KB)
π
new.html
(12.87 KB)
π
nis.html
(11.23 KB)
π
nntplib.html
(44.62 KB)
π
numbers.html
(39.68 KB)
π
numeric.html
(13.96 KB)
π
operator.html
(91.43 KB)
π
optparse.html
(244.25 KB)
π
os.html
(234.57 KB)
π
os.path.html
(42.38 KB)
π
ossaudiodev.html
(44.53 KB)
π
othergui.html
(9.18 KB)
π
parser.html
(41.56 KB)
π
pdb.html
(37.7 KB)
π
persistence.html
(15.31 KB)
π
pickle.html
(107.11 KB)
π
pickletools.html
(11.21 KB)
π
pipes.html
(19.22 KB)
π
pkgutil.html
(26.73 KB)
π
platform.html
(30.86 KB)
π
plistlib.html
(17.91 KB)
π
popen2.html
(26.95 KB)
π
poplib.html
(23.75 KB)
π
posix.html
(16.24 KB)
π
posixfile.html
(20.89 KB)
π
pprint.html
(31.45 KB)
π
profile.html
(71.08 KB)
π
pty.html
(9.96 KB)
π
pwd.html
(12.1 KB)
π
py_compile.html
(11.65 KB)
π
pyclbr.html
(15.44 KB)
π
pydoc.html
(13.33 KB)
π
pyexpat.html
(78.99 KB)
π
python.html
(12.55 KB)
π
queue.html
(26.23 KB)
π
quopri.html
(12.44 KB)
π
random.html
(41.72 KB)
π
re.html
(152.33 KB)
π
readline.html
(36.51 KB)
π
repr.html
(21.27 KB)
π
resource.html
(27.62 KB)
π
restricted.html
(12.08 KB)
π
rexec.html
(39.62 KB)
π
rfc822.html
(45.32 KB)
π
rlcompleter.html
(14.12 KB)
π
robotparser.html
(13.09 KB)
π
runpy.html
(21.41 KB)
π
sched.html
(19.41 KB)
π
scrolledtext.html
(9.5 KB)
π
select.html
(43.06 KB)
π
sets.html
(39.21 KB)
π
sgi.html
(10.13 KB)
π
sgmllib.html
(33.66 KB)
π
sha.html
(12.76 KB)
π
shelve.html
(29.25 KB)
π
shlex.html
(34.21 KB)
π
shutil.html
(44.39 KB)
π
signal.html
(33.23 KB)
π
simplehttpserver.html
(19.87 KB)
π
simplexmlrpcserver.html
(36.91 KB)
π
site.html
(26.26 KB)
π
smtpd.html
(13.27 KB)
π
smtplib.html
(45.95 KB)
π
sndhdr.html
(10.74 KB)
π
socket.html
(113.69 KB)
π
socketserver.html
(74.64 KB)
π
someos.html
(16.09 KB)
π
spwd.html
(10.9 KB)
π
sqlite3.html
(146.5 KB)
π
ssl.html
(197.71 KB)
π
stat.html
(33.79 KB)
π
statvfs.html
(11.06 KB)
π
stdtypes.html
(291.16 KB)
π
string.html
(117.4 KB)
π
stringio.html
(19.59 KB)
π
stringprep.html
(17.31 KB)
π
strings.html
(15.53 KB)
π
struct.html
(43.84 KB)
π
subprocess.html
(107.86 KB)
π
sun.html
(7.08 KB)
π
sunau.html
(29.31 KB)
π
sunaudio.html
(18.79 KB)
π
symbol.html
(7.95 KB)
π
symtable.html
(25.26 KB)
π
sys.html
(108.39 KB)
π
sysconfig.html
(25.68 KB)
π
syslog.html
(19.27 KB)
π
tabnanny.html
(11.13 KB)
π
tarfile.html
(86.65 KB)
π
telnetlib.html
(27.13 KB)
π
tempfile.html
(31.16 KB)
π
termios.html
(16.9 KB)
π
test.html
(55.69 KB)
π
textwrap.html
(29.43 KB)
π
thread.html
(20.98 KB)
π
threading.html
(84.62 KB)
π
time.html
(62.3 KB)
π
timeit.html
(39.58 KB)
π
tix.html
(49.4 KB)
π
tk.html
(25.95 KB)
π
tkinter.html
(82.34 KB)
π
token.html
(20.51 KB)
π
tokenize.html
(20.12 KB)
π
trace.html
(28 KB)
π
traceback.html
(39.94 KB)
π
ttk.html
(105.97 KB)
π
tty.html
(9.52 KB)
π
turtle.html
(225.08 KB)
π
types.html
(29.13 KB)
π
undoc.html
(24.1 KB)
π
unicodedata.html
(19.71 KB)
π
unittest.html
(219.75 KB)
π
unix.html
(10.96 KB)
π
urllib.html
(66.67 KB)
π
urllib2.html
(110.72 KB)
π
urlparse.html
(42.46 KB)
π
user.html
(12.41 KB)
π
userdict.html
(31.32 KB)
π
uu.html
(11.53 KB)
π
uuid.html
(29.43 KB)
π
warnings.html
(49.76 KB)
π
wave.html
(24.31 KB)
π
weakref.html
(37.9 KB)
π
webbrowser.html
(25.94 KB)
π
whichdb.html
(9.28 KB)
π
windows.html
(9.59 KB)
π
winsound.html
(19.99 KB)
π
wsgiref.html
(86.31 KB)
π
xdrlib.html
(32.24 KB)
π
xml.dom.html
(95.58 KB)
π
xml.dom.minidom.html
(42.22 KB)
π
xml.dom.pulldom.html
(13.51 KB)
π
xml.etree.elementtree.html
(109.18 KB)
π
xml.html
(17.58 KB)
π
xml.sax.handler.html
(40.9 KB)
π
xml.sax.html
(22.91 KB)
π
xml.sax.reader.html
(43.75 KB)
π
xml.sax.utils.html
(15.71 KB)
π
xmlrpclib.html
(67.57 KB)
π
zipfile.html
(60.77 KB)
π
zipimport.html
(22.24 KB)
π
zlib.html
(30.5 KB)
Editing: repr.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="X-UA-Compatible" content="IE=Edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>8.19. repr β Alternate repr() implementation — Python 2.7.16 documentation</title> <link rel="stylesheet" href="../_static/classic.css" type="text/css" /> <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script> <script type="text/javascript" src="../_static/jquery.js"></script> <script type="text/javascript" src="../_static/underscore.js"></script> <script type="text/javascript" src="../_static/doctools.js"></script> <script type="text/javascript" src="../_static/sidebar.js"></script> <link rel="search" type="application/opensearchdescription+xml" title="Search within Python 2.7.16 documentation" href="../_static/opensearch.xml"/> <link rel="author" title="About these documents" href="../about.html" /> <link rel="index" title="Index" href="../genindex.html" /> <link rel="search" title="Search" href="../search.html" /> <link rel="copyright" title="Copyright" href="../copyright.html" /> <link rel="next" title="9. Numeric and Mathematical Modules" href="numeric.html" /> <link rel="prev" title="8.18. pprint β Data pretty printer" href="pprint.html" /> <link rel="shortcut icon" type="image/png" href="../_static/py.png" /> <link rel="canonical" href="https://docs.python.org/2/library/repr.html" /> <script type="text/javascript" src="../_static/copybutton.js"></script> </head><body> <div class="related" role="navigation" aria-label="related navigation"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="../genindex.html" title="General Index" accesskey="I">index</a></li> <li class="right" > <a href="../py-modindex.html" title="Python Module Index" >modules</a> |</li> <li class="right" > <a href="numeric.html" title="9. Numeric and Mathematical Modules" accesskey="N">next</a> |</li> <li class="right" > <a href="pprint.html" title="8.18. pprint β Data pretty printer" accesskey="P">previous</a> |</li> <li><img src="../_static/py.png" alt="" style="vertical-align: middle; margin-top: -1px"/></li> <li><a href="https://www.python.org/">Python</a> »</li> <li> <a href="../index.html">Python 2.7.16 documentation</a> » </li> <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> »</li> <li class="nav-item nav-item-2"><a href="datatypes.html" accesskey="U">8. Data Types</a> »</li> </ul> </div> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body" role="main"> <div class="section" id="repr-alternate-repr-implementation"> <h1>8.19. <a class="reference internal" href="functions.html#repr" title="repr"><code class="xref py py-mod docutils literal notranslate"><span class="pre">repr</span></code></a> β Alternate <a class="reference internal" href="functions.html#repr" title="repr"><code class="xref py py-func docutils literal notranslate"><span class="pre">repr()</span></code></a> implementation<a class="headerlink" href="#repr-alternate-repr-implementation" title="Permalink to this headline">ΒΆ</a></h1> <div class="admonition note"> <p class="first admonition-title">Note</p> <p class="last">The <a class="reference internal" href="functions.html#repr" title="repr"><code class="xref py py-mod docutils literal notranslate"><span class="pre">repr</span></code></a> module has been renamed to <code class="xref py py-mod docutils literal notranslate"><span class="pre">reprlib</span></code> in Python 3. The <a class="reference internal" href="../glossary.html#term-2to3"><span class="xref std std-term">2to3</span></a> tool will automatically adapt imports when converting your sources to Python 3.</p> </div> <p><strong>Source code:</strong> <a class="reference external" href="https://github.com/python/cpython/tree/2.7/Lib/repr.py">Lib/repr.py</a></p> <hr class="docutils" /> <p>The <a class="reference internal" href="functions.html#repr" title="repr"><code class="xref py py-mod docutils literal notranslate"><span class="pre">repr</span></code></a> module provides a means for producing object representations with limits on the size of the resulting strings. This is used in the Python debugger and may be useful in other contexts as well.</p> <p>This module provides a class, an instance, and a function:</p> <dl class="class"> <dt id="repr.Repr"> <em class="property">class </em><code class="descclassname">repr.</code><code class="descname">Repr</code><a class="headerlink" href="#repr.Repr" title="Permalink to this definition">ΒΆ</a></dt> <dd><p>Class which provides formatting services useful in implementing functions similar to the built-in <a class="reference internal" href="functions.html#func-repr"><span class="std std-ref">repr()</span></a>; size limits for different object types are added to avoid the generation of representations which are excessively long.</p> </dd></dl> <dl class="data"> <dt id="repr.aRepr"> <code class="descclassname">repr.</code><code class="descname">aRepr</code><a class="headerlink" href="#repr.aRepr" title="Permalink to this definition">ΒΆ</a></dt> <dd><p>This is an instance of <a class="reference internal" href="#repr.Repr" title="repr.Repr"><code class="xref py py-class docutils literal notranslate"><span class="pre">Repr</span></code></a> which is used to provide the <a class="reference internal" href="#repr.repr" title="repr.repr"><code class="xref py py-func docutils literal notranslate"><span class="pre">repr()</span></code></a> function described below. Changing the attributes of this object will affect the size limits used by <a class="reference internal" href="#repr.repr" title="repr.repr"><code class="xref py py-func docutils literal notranslate"><span class="pre">repr()</span></code></a> and the Python debugger.</p> </dd></dl> <dl class="function"> <dt id="repr.repr"> <code class="descclassname">repr.</code><code class="descname">repr</code><span class="sig-paren">(</span><em>obj</em><span class="sig-paren">)</span><a class="headerlink" href="#repr.repr" title="Permalink to this definition">ΒΆ</a></dt> <dd><p>This is the <a class="reference internal" href="#repr.Repr.repr" title="repr.Repr.repr"><code class="xref py py-meth docutils literal notranslate"><span class="pre">repr()</span></code></a> method of <code class="docutils literal notranslate"><span class="pre">aRepr</span></code>. It returns a string similar to that returned by the built-in function of the same name, but with limits on most sizes.</p> </dd></dl> <div class="section" id="repr-objects"> <span id="id1"></span><h2>8.19.1. Repr Objects<a class="headerlink" href="#repr-objects" title="Permalink to this headline">ΒΆ</a></h2> <p><a class="reference internal" href="#repr.Repr" title="repr.Repr"><code class="xref py py-class docutils literal notranslate"><span class="pre">Repr</span></code></a> instances provide several attributes which can be used to provide size limits for the representations of different object types, and methods which format specific object types.</p> <dl class="attribute"> <dt id="repr.Repr.maxlevel"> <code class="descclassname">Repr.</code><code class="descname">maxlevel</code><a class="headerlink" href="#repr.Repr.maxlevel" title="Permalink to this definition">ΒΆ</a></dt> <dd><p>Depth limit on the creation of recursive representations. The default is <code class="docutils literal notranslate"><span class="pre">6</span></code>.</p> </dd></dl> <dl class="attribute"> <dt id="repr.Repr.maxdict"> <code class="descclassname">Repr.</code><code class="descname">maxdict</code><a class="headerlink" href="#repr.Repr.maxdict" title="Permalink to this definition">ΒΆ</a></dt> <dt id="repr.Repr.maxlist"> <code class="descclassname">Repr.</code><code class="descname">maxlist</code><a class="headerlink" href="#repr.Repr.maxlist" title="Permalink to this definition">ΒΆ</a></dt> <dt id="repr.Repr.maxtuple"> <code class="descclassname">Repr.</code><code class="descname">maxtuple</code><a class="headerlink" href="#repr.Repr.maxtuple" title="Permalink to this definition">ΒΆ</a></dt> <dt id="repr.Repr.maxset"> <code class="descclassname">Repr.</code><code class="descname">maxset</code><a class="headerlink" href="#repr.Repr.maxset" title="Permalink to this definition">ΒΆ</a></dt> <dt id="repr.Repr.maxfrozenset"> <code class="descclassname">Repr.</code><code class="descname">maxfrozenset</code><a class="headerlink" href="#repr.Repr.maxfrozenset" title="Permalink to this definition">ΒΆ</a></dt> <dt id="repr.Repr.maxdeque"> <code class="descclassname">Repr.</code><code class="descname">maxdeque</code><a class="headerlink" href="#repr.Repr.maxdeque" title="Permalink to this definition">ΒΆ</a></dt> <dt id="repr.Repr.maxarray"> <code class="descclassname">Repr.</code><code class="descname">maxarray</code><a class="headerlink" href="#repr.Repr.maxarray" title="Permalink to this definition">ΒΆ</a></dt> <dd><p>Limits on the number of entries represented for the named object type. The default is <code class="docutils literal notranslate"><span class="pre">4</span></code> for <a class="reference internal" href="#repr.Repr.maxdict" title="repr.Repr.maxdict"><code class="xref py py-attr docutils literal notranslate"><span class="pre">maxdict</span></code></a>, <code class="docutils literal notranslate"><span class="pre">5</span></code> for <a class="reference internal" href="#repr.Repr.maxarray" title="repr.Repr.maxarray"><code class="xref py py-attr docutils literal notranslate"><span class="pre">maxarray</span></code></a>, and <code class="docutils literal notranslate"><span class="pre">6</span></code> for the others.</p> <div class="versionadded"> <p><span class="versionmodified">New in version 2.4: </span><a class="reference internal" href="#repr.Repr.maxset" title="repr.Repr.maxset"><code class="xref py py-attr docutils literal notranslate"><span class="pre">maxset</span></code></a>, <a class="reference internal" href="#repr.Repr.maxfrozenset" title="repr.Repr.maxfrozenset"><code class="xref py py-attr docutils literal notranslate"><span class="pre">maxfrozenset</span></code></a>, and <a class="reference internal" href="stdtypes.html#set" title="set"><code class="xref py py-attr docutils literal notranslate"><span class="pre">set</span></code></a>.</p> </div> </dd></dl> <dl class="attribute"> <dt id="repr.Repr.maxlong"> <code class="descclassname">Repr.</code><code class="descname">maxlong</code><a class="headerlink" href="#repr.Repr.maxlong" title="Permalink to this definition">ΒΆ</a></dt> <dd><p>Maximum number of characters in the representation for a long integer. Digits are dropped from the middle. The default is <code class="docutils literal notranslate"><span class="pre">40</span></code>.</p> </dd></dl> <dl class="attribute"> <dt id="repr.Repr.maxstring"> <code class="descclassname">Repr.</code><code class="descname">maxstring</code><a class="headerlink" href="#repr.Repr.maxstring" title="Permalink to this definition">ΒΆ</a></dt> <dd><p>Limit on the number of characters in the representation of the string. Note that the βnormalβ representation of the string is used as the character source: if escape sequences are needed in the representation, these may be mangled when the representation is shortened. The default is <code class="docutils literal notranslate"><span class="pre">30</span></code>.</p> </dd></dl> <dl class="attribute"> <dt id="repr.Repr.maxother"> <code class="descclassname">Repr.</code><code class="descname">maxother</code><a class="headerlink" href="#repr.Repr.maxother" title="Permalink to this definition">ΒΆ</a></dt> <dd><p>This limit is used to control the size of object types for which no specific formatting method is available on the <a class="reference internal" href="#repr.Repr" title="repr.Repr"><code class="xref py py-class docutils literal notranslate"><span class="pre">Repr</span></code></a> object. It is applied in a similar manner as <a class="reference internal" href="#repr.Repr.maxstring" title="repr.Repr.maxstring"><code class="xref py py-attr docutils literal notranslate"><span class="pre">maxstring</span></code></a>. The default is <code class="docutils literal notranslate"><span class="pre">20</span></code>.</p> </dd></dl> <dl class="method"> <dt id="repr.Repr.repr"> <code class="descclassname">Repr.</code><code class="descname">repr</code><span class="sig-paren">(</span><em>obj</em><span class="sig-paren">)</span><a class="headerlink" href="#repr.Repr.repr" title="Permalink to this definition">ΒΆ</a></dt> <dd><p>The equivalent to the built-in <a class="reference internal" href="functions.html#func-repr"><span class="std std-ref">repr()</span></a> that uses the formatting imposed by the instance.</p> </dd></dl> <dl class="method"> <dt id="repr.Repr.repr1"> <code class="descclassname">Repr.</code><code class="descname">repr1</code><span class="sig-paren">(</span><em>obj</em>, <em>level</em><span class="sig-paren">)</span><a class="headerlink" href="#repr.Repr.repr1" title="Permalink to this definition">ΒΆ</a></dt> <dd><p>Recursive implementation used by <a class="reference internal" href="#repr.Repr.repr" title="repr.Repr.repr"><code class="xref py py-meth docutils literal notranslate"><span class="pre">repr()</span></code></a>. This uses the type of <em>obj</em> to determine which formatting method to call, passing it <em>obj</em> and <em>level</em>. The type-specific methods should call <a class="reference internal" href="#repr.Repr.repr1" title="repr.Repr.repr1"><code class="xref py py-meth docutils literal notranslate"><span class="pre">repr1()</span></code></a> to perform recursive formatting, with <code class="docutils literal notranslate"><span class="pre">level</span> <span class="pre">-</span> <span class="pre">1</span></code> for the value of <em>level</em> in the recursive call.</p> </dd></dl> <dl class="method"> <dt> <code class="descclassname">Repr.</code><code class="descname">repr_TYPE</code><span class="sig-paren">(</span><em>obj</em>, <em>level</em><span class="sig-paren">)</span></dt> <dd><p>Formatting methods for specific types are implemented as methods with a name based on the type name. In the method name, <strong>TYPE</strong> is replaced by <code class="docutils literal notranslate"><span class="pre">string.join(string.split(type(obj).__name__,</span> <span class="pre">'_'))</span></code>. Dispatch to these methods is handled by <a class="reference internal" href="#repr.Repr.repr1" title="repr.Repr.repr1"><code class="xref py py-meth docutils literal notranslate"><span class="pre">repr1()</span></code></a>. Type-specific methods which need to recursively format a value should call <code class="docutils literal notranslate"><span class="pre">self.repr1(subobj,</span> <span class="pre">level</span> <span class="pre">-</span> <span class="pre">1)</span></code>.</p> </dd></dl> </div> <div class="section" id="subclassing-repr-objects"> <span id="subclassing-reprs"></span><h2>8.19.2. Subclassing Repr Objects<a class="headerlink" href="#subclassing-repr-objects" title="Permalink to this headline">ΒΆ</a></h2> <p>The use of dynamic dispatching by <a class="reference internal" href="#repr.Repr.repr1" title="repr.Repr.repr1"><code class="xref py py-meth docutils literal notranslate"><span class="pre">Repr.repr1()</span></code></a> allows subclasses of <a class="reference internal" href="#repr.Repr" title="repr.Repr"><code class="xref py py-class docutils literal notranslate"><span class="pre">Repr</span></code></a> to add support for additional built-in object types or to modify the handling of types already supported. This example shows how special support for file objects could be added:</p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">repr</span> <span class="k">as</span> <span class="nn">reprlib</span> <span class="kn">import</span> <span class="nn">sys</span> <span class="k">class</span> <span class="nc">MyRepr</span><span class="p">(</span><span class="n">reprlib</span><span class="o">.</span><span class="n">Repr</span><span class="p">):</span> <span class="k">def</span> <span class="nf">repr_file</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">obj</span><span class="p">,</span> <span class="n">level</span><span class="p">):</span> <span class="k">if</span> <span class="n">obj</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="p">[</span><span class="s1">'<stdin>'</span><span class="p">,</span> <span class="s1">'<stdout>'</span><span class="p">,</span> <span class="s1">'<stderr>'</span><span class="p">]:</span> <span class="k">return</span> <span class="n">obj</span><span class="o">.</span><span class="n">name</span> <span class="k">else</span><span class="p">:</span> <span class="k">return</span> <span class="nb">repr</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span> <span class="n">aRepr</span> <span class="o">=</span> <span class="n">MyRepr</span><span class="p">()</span> <span class="nb">print</span> <span class="n">aRepr</span><span class="o">.</span><span class="n">repr</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">stdin</span><span class="p">)</span> <span class="c1"># prints '<stdin>'</span> </pre></div> </div> </div> </div> </div> </div> </div> <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> <div class="sphinxsidebarwrapper"> <h3><a href="../contents.html">Table Of Contents</a></h3> <ul> <li><a class="reference internal" href="#">8.19. <code class="docutils literal notranslate"><span class="pre">repr</span></code> β Alternate <code class="docutils literal notranslate"><span class="pre">repr()</span></code> implementation</a><ul> <li><a class="reference internal" href="#repr-objects">8.19.1. Repr Objects</a></li> <li><a class="reference internal" href="#subclassing-repr-objects">8.19.2. Subclassing Repr Objects</a></li> </ul> </li> </ul> <h4>Previous topic</h4> <p class="topless"><a href="pprint.html" title="previous chapter">8.18. <code class="docutils literal notranslate"><span class="pre">pprint</span></code> β Data pretty printer</a></p> <h4>Next topic</h4> <p class="topless"><a href="numeric.html" title="next chapter">9. Numeric and Mathematical Modules</a></p> <div role="note" aria-label="source link"> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="../_sources/library/repr.rst.txt" rel="nofollow">Show Source</a></li> </ul> </div> <div id="searchbox" style="display: none" role="search"> <h3>Quick search</h3> <div class="searchformwrapper"> <form class="search" action="../search.html" method="get"> <input type="text" name="q" /> <input type="submit" value="Go" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> </div> </div> <script type="text/javascript">$('#searchbox').show(0);</script> </div> </div> <div class="clearer"></div> </div> <div class="related" role="navigation" aria-label="related navigation"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="../genindex.html" title="General Index" >index</a></li> <li class="right" > <a href="../py-modindex.html" title="Python Module Index" >modules</a> |</li> <li class="right" > <a href="numeric.html" title="9. Numeric and Mathematical Modules" >next</a> |</li> <li class="right" > <a href="pprint.html" title="8.18. pprint β Data pretty printer" >previous</a> |</li> <li><img src="../_static/py.png" alt="" style="vertical-align: middle; margin-top: -1px"/></li> <li><a href="https://www.python.org/">Python</a> »</li> <li> <a href="../index.html">Python 2.7.16 documentation</a> » </li> <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> »</li> <li class="nav-item nav-item-2"><a href="datatypes.html" >8. Data Types</a> »</li> </ul> </div> <div class="footer"> © <a href="../copyright.html">Copyright</a> 1990-2019, Python Software Foundation. <br /> The Python Software Foundation is a non-profit corporation. <a href="https://www.python.org/psf/donations/">Please donate.</a> <br /> Last updated on Mar 27, 2019. <a href="../bugs.html">Found a bug</a>? <br /> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.7.6. </div> </body> </html>
Upload File
Create Folder