From f0b095d804389625e17e7352c984acf34170167a Mon Sep 17 00:00:00 2001 From: Fred Drake Date: Wed, 17 Jul 2002 20:31:52 +0000 Subject: Added documentation for the buffer_text and related attributes of the xmlparser object provided by pyexpat, new in Python 2.3. --- Doc/lib/libpyexpat.tex | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) 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 -- cgit v0.12