summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libpyexpat.tex
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2002-07-17 20:31:52 (GMT)
committerFred Drake <fdrake@acm.org>2002-07-17 20:31:52 (GMT)
commitf0b095d804389625e17e7352c984acf34170167a (patch)
treed8a240a54145b99e37739ba3d1e0d28ea3fc4f59 /Doc/lib/libpyexpat.tex
parent5c3ed3db9a9f5bd07a8db919b40d02bcbf5d1a3f (diff)
downloadcpython-f0b095d804389625e17e7352c984acf34170167a.zip
cpython-f0b095d804389625e17e7352c984acf34170167a.tar.gz
cpython-f0b095d804389625e17e7352c984acf34170167a.tar.bz2
Added documentation for the buffer_text and related attributes of the
xmlparser object provided by pyexpat, new in Python 2.3.
Diffstat (limited to 'Doc/lib/libpyexpat.tex')
-rw-r--r--Doc/lib/libpyexpat.tex23
1 files changed, 23 insertions, 0 deletions
diff --git a/Doc/lib/libpyexpat.tex b/Doc/lib/libpyexpat.tex
index 46cf880..abad8dd 100644
--- a/Doc/lib/libpyexpat.tex
+++ b/Doc/lib/libpyexpat.tex
@@ -159,6 +159,29 @@ values of this parser.
\class{xmlparser} objects have the following attributes:
+\begin{memberdesc}[xmlparser]{buffer_size}
+The size of the buffer used when \member{buffer_text} is true. This
+value cannot be changed at this time.
+\versionadded{2.3}
+\end{memberdesc}
+
+\begin{memberdesc}[xmlparser]{buffer_text}
+Setting this to true causes the \class{xmlparser} object to buffer
+textual content returned by Expat to avoid multiple calls to the
+\method{CharacterDataHandler()} callback whenever possible. This can
+improve performance substantially since Expat normally breaks
+character data into chunks at every line ending. This attribute is
+false by default, and may be changed at any time.
+\versionadded{2.3}
+\end{memberdesc}
+
+\begin{memberdesc}[xmlparser]{buffer_used}
+If \member{buffer_text} is enabled, the number of bytes stored in the
+buffer. These bytes represent UTF-8 encoded text. This attribute has
+no meaningful interpretation when \member{buffer_text} is false.
+\versionadded{2.3}
+\end{memberdesc}
+
\begin{memberdesc}[xmlparser]{ordered_attributes}
Setting this attribute to a non-zero integer causes the attributes to
be reported as a list rather than a dictionary. The attributes are