Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2026-01-04 14:32:21 +00:00
Code Issues Projects Releases Packages Wiki Activity

gh-54358: Clarify data chunking in pyexpat (GH-31629)

Browse source 
Co-authored-by: Éric Araujo <merwok@netwok.org>
This commit is contained in:
Stanley 2024-02-23 10:57:08 -08:00 • committed by GitHub
parent 3d8fc06d4f
commit 462a2fc09d
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 6 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

8
Doc/library/pyexpat.rst
View file

@ -214,7 +214,8 @@ XMLParser Objects
:meth:`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.
any time. Note that when it is false, data that does not contain newlines
may be chunked too.
.. attribute:: xmlparser.buffer_used
@ -372,7 +373,10 @@ otherwise stated.
marked content, and ignorable whitespace. Applications which must distinguish
these cases can use the :attr:`StartCdataSectionHandler`,
:attr:`EndCdataSectionHandler`, and :attr:`ElementDeclHandler` callbacks to
collect the required information.
collect the required information. Note that the character data may be
chunked even if it is short and so you may receive more than one call to
:meth:`CharacterDataHandler`. Set the :attr:`buffer_text` instance attribute
to ``True`` to avoid that.
.. method:: xmlparser.UnparsedEntityDeclHandler(entityName, base, systemId, publicId, notationName)