diff options
author | Fred Drake <fdrake@acm.org> | 2002-07-17 20:31:52 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 2002-07-17 20:31:52 (GMT) |
commit | f0b095d804389625e17e7352c984acf34170167a (patch) | |
tree | d8a240a54145b99e37739ba3d1e0d28ea3fc4f59 /Doc/lib/libpyexpat.tex | |
parent | 5c3ed3db9a9f5bd07a8db919b40d02bcbf5d1a3f (diff) | |
download | cpython-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.tex | 23 |
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 |