An XML packet reader that reads a single container. More...
#include <nxmlpacketreaders.h>
Public Member Functions | |
NXMLContainerReader () | |
Creates a new container reader. | |
virtual NPacket * | getPacket () |
Returns the newly allocated packet that has been read by this element reader. |
An XML packet reader that reads a single container.
regina::NXMLContainerReader::NXMLContainerReader | ( | ) | [inline] |
Creates a new container reader.
NPacket * regina::NXMLContainerReader::getPacket | ( | ) | [inline, virtual] |
Returns the newly allocated packet that has been read by this element reader.
Deallocation of this new packet is not the responsibility of this class. Once this routine gives a non-zero return value, it should continue to give the same non-zero return value from this point onwards.
If this routine is ever to give a non-zero return value, it must be giving that non-zero return value by the time the first child packet or packet tag is encountered; otherwise child packets will not be inserted into the packet tree and/or packet tags will not be added.
The newly allocated packet should not be given a packet label. This will be done by NXMLPacketReader::endSubElement().
The newly allocated packet may or may not be inserted in the packet tree structure; this does not matter (although if it is inserted it must be inserted in the correct place).
The newly allocated packet should not be given any associated packet tags. This will be done by NXMLPacketReader::startSubElement().
The default implementation returns 0.
Reimplemented from regina::NXMLPacketReader.