mirror of
https://github.com/VCMP-SqMod/SqMod.git
synced 2025-06-20 17:17:13 +02:00
Update POCO library.
This commit is contained in:
78
vendor/POCO/XML/include/Poco/SAX/InputSource.h
vendored
78
vendor/POCO/XML/include/Poco/SAX/InputSource.h
vendored
@ -28,46 +28,46 @@ namespace XML {
|
||||
|
||||
|
||||
class XML_API InputSource
|
||||
/// This class allows a SAX application to encapsulate information about an input
|
||||
/// source in a single object, which may include a public identifier, a system
|
||||
/// identifier, a byte stream (possibly with a specified encoding), and/or a character
|
||||
/// This class allows a SAX application to encapsulate information about an input
|
||||
/// source in a single object, which may include a public identifier, a system
|
||||
/// identifier, a byte stream (possibly with a specified encoding), and/or a character
|
||||
/// stream.
|
||||
///
|
||||
/// There are two places that the application can deliver an input source to the
|
||||
/// parser: as the argument to the Parser.parse method, or as the return value of the
|
||||
///
|
||||
/// There are two places that the application can deliver an input source to the
|
||||
/// parser: as the argument to the Parser.parse method, or as the return value of the
|
||||
/// EntityResolver::resolveEntity() method.
|
||||
///
|
||||
/// The SAX parser will use the InputSource object to determine how to read XML input.
|
||||
/// If there is a character stream available, the parser will read that stream directly,
|
||||
/// disregarding any text encoding declaration found in that stream. If there is no character
|
||||
/// stream, but there is a byte stream, the parser will use that byte stream, using the
|
||||
/// encoding specified in the InputSource or else (if no encoding is specified) autodetecting
|
||||
/// the character encoding using an algorithm such as the one in the XML specification.
|
||||
/// If neither a character stream nor a byte stream is available, the parser will attempt
|
||||
///
|
||||
/// The SAX parser will use the InputSource object to determine how to read XML input.
|
||||
/// If there is a character stream available, the parser will read that stream directly,
|
||||
/// disregarding any text encoding declaration found in that stream. If there is no character
|
||||
/// stream, but there is a byte stream, the parser will use that byte stream, using the
|
||||
/// encoding specified in the InputSource or else (if no encoding is specified) autodetecting
|
||||
/// the character encoding using an algorithm such as the one in the XML specification.
|
||||
/// If neither a character stream nor a byte stream is available, the parser will attempt
|
||||
/// to open a URI connection to the resource identified by the system identifier.
|
||||
///
|
||||
/// An InputSource object belongs to the application: the SAX parser shall never modify it in
|
||||
/// any way (it may modify a copy if necessary). However, standard processing of both byte and
|
||||
/// character streams is to close them on as part of end-of-parse cleanup, so applications should
|
||||
///
|
||||
/// An InputSource object belongs to the application: the SAX parser shall never modify it in
|
||||
/// any way (it may modify a copy if necessary). However, standard processing of both byte and
|
||||
/// character streams is to close them on as part of end-of-parse cleanup, so applications should
|
||||
/// not attempt to re-use such streams after they have been handed to a parser.
|
||||
{
|
||||
public:
|
||||
InputSource();
|
||||
/// Zero-argument default constructor.
|
||||
|
||||
|
||||
InputSource(const XMLString& systemId);
|
||||
/// Creates a new input source with a system identifier.
|
||||
/// Applications may use setPublicId to include a public identifier as well,
|
||||
/// Applications may use setPublicId to include a public identifier as well,
|
||||
/// or setEncoding to specify the character encoding, if known.
|
||||
///
|
||||
/// If the system identifier is a URL, it must be fully resolved (it may not
|
||||
///
|
||||
/// If the system identifier is a URL, it must be fully resolved (it may not
|
||||
/// be a relative URL).
|
||||
|
||||
|
||||
InputSource(XMLByteInputStream& istr);
|
||||
/// Creates a new input source with a byte stream.
|
||||
///
|
||||
///
|
||||
/// Application writers should use setSystemId() to provide a base for resolving
|
||||
/// relative URIs, may use setPublicId to include a public identifier, and may use
|
||||
/// relative URIs, may use setPublicId to include a public identifier, and may use
|
||||
/// setEncoding to specify the object's character encoding.
|
||||
|
||||
~InputSource();
|
||||
@ -76,34 +76,34 @@ public:
|
||||
void setPublicId(const XMLString& publicId);
|
||||
/// Set the public identifier for this input source.
|
||||
///
|
||||
/// The public identifier is always optional: if the application writer includes one,
|
||||
/// The public identifier is always optional: if the application writer includes one,
|
||||
/// it will be provided as part of the location information.
|
||||
|
||||
|
||||
void setSystemId(const XMLString& systemId);
|
||||
/// Set the system identifier for this input source.
|
||||
///
|
||||
/// The system identifier is optional if there is a byte stream or a character stream,
|
||||
/// but it is still useful to provide one, since the application can use it to resolve
|
||||
/// relative URIs and can include it in error messages and warnings (the parser will
|
||||
/// attempt to open a connection to the URI only if there is no byte stream or character
|
||||
/// The system identifier is optional if there is a byte stream or a character stream,
|
||||
/// but it is still useful to provide one, since the application can use it to resolve
|
||||
/// relative URIs and can include it in error messages and warnings (the parser will
|
||||
/// attempt to open a connection to the URI only if there is no byte stream or character
|
||||
/// stream specified).
|
||||
///
|
||||
/// If the application knows the character encoding of the object pointed to by the system
|
||||
///
|
||||
/// If the application knows the character encoding of the object pointed to by the system
|
||||
/// identifier, it can register the encoding using the setEncoding method.
|
||||
///
|
||||
///
|
||||
/// If the system identifier is a URL, it must be fully resolved (it may not be a relative URL).
|
||||
|
||||
const XMLString& getPublicId() const;
|
||||
/// Get the public identifier for this input source.
|
||||
|
||||
|
||||
const XMLString& getSystemId() const;
|
||||
/// Get the system identifier for this input source.
|
||||
|
||||
void setByteStream(XMLByteInputStream& istr);
|
||||
/// Set the byte stream for this input source.
|
||||
/// The SAX parser will ignore this if there is also a character stream specified, but it
|
||||
/// The SAX parser will ignore this if there is also a character stream specified, but it
|
||||
/// will use a byte stream in preference to opening a URI connection itself.
|
||||
|
||||
|
||||
XMLByteInputStream* getByteStream() const;
|
||||
/// Get the byte stream for this input source.
|
||||
|
||||
@ -115,9 +115,9 @@ public:
|
||||
|
||||
void setEncoding(const XMLString& encoding);
|
||||
/// Set the character encoding, if known.
|
||||
/// The encoding must be a string acceptable for an XML encoding declaration
|
||||
/// The encoding must be a string acceptable for an XML encoding declaration
|
||||
/// (see section 4.3.3 of the XML 1.0 recommendation).
|
||||
|
||||
|
||||
const XMLString& getEncoding() const;
|
||||
/// Get the character encoding for a byte stream or URI.
|
||||
|
||||
|
Reference in New Issue
Block a user