QXmlInputSource Class

Dokumentation der Mitgliedsfunktionen

QXmlInputSource::QXmlInputSource()

Konstruiert eine Eingabequelle, die keine Daten enthält.

Siehe auch setData().

[explicit] QXmlInputSource::QXmlInputSource(QIODevice *dev)

Konstruiert eine Eingabequelle und holt die Daten vom Gerät dev. Wenn dev nicht geöffnet ist, wird es im Nur-Lese-Modus geöffnet. Wenn dev gleich 0 ist oder es nicht möglich ist, von dem Gerät zu lesen, enthält die Eingabequelle keine Daten.

Siehe auch setData(), fetchData(), und QIODevice.

[virtual noexcept] QXmlInputSource::~QXmlInputSource()

Zerstörer.

[virtual] QString QXmlInputSource::data() const

Gibt die Daten zurück, die die Eingabequelle enthält, oder einen leeren String, wenn die Eingabequelle keine Daten enthält.

Siehe auch setData(), QXmlInputSource(), und fetchData().

[virtual] void QXmlInputSource::fetchData()

Diese Funktion liest weitere Daten aus dem Gerät, die während der Konstruktion eingestellt wurden. Wenn die Eingabequelle bereits Daten enthielt, löscht diese Funktion diese Daten zuerst.

Das Objekt enthält nach einem Aufruf dieser Funktion keine Daten, wenn das Objekt ohne ein Gerät konstruiert wurde, von dem Daten gelesen werden können, oder wenn diese Funktion nicht in der Lage war, weitere Daten von dem Gerät zu holen.

Es gibt zwei Gelegenheiten, bei denen ein Fetch implizit durch einen anderen Funktionsaufruf durchgeführt wird: während der Konstruktion (damit das Objekt mit einigen Anfangsdaten beginnt, sofern vorhanden) und während eines Aufrufs von next() (wenn die Daten ausgegangen sind).

Sie brauchen diese Funktion normalerweise nicht zu verwenden, wenn Sie next() benutzen.

Siehe auch data(), next(), und QXmlInputSource().

[virtual protected] QString QXmlInputSource::fromRawData(const QByteArray &data, bool beginning = false)

Diese Funktion liest die XML-Datei von data und versucht, die Kodierung zu erkennen. Sie wandelt die Rohdaten data in eine QString um und gibt sie zurück. Sie versucht ihr Bestes, um die richtige Kodierung für die XML-Datei zu erhalten.

Wenn beginning wahr ist, geht diese Funktion davon aus, dass die Daten am Anfang eines neuen XML-Dokuments beginnen und sucht nach einer Kodierungsdeklaration. Wenn beginning falsch ist, konvertiert sie die Rohdaten unter Verwendung der aus früheren Aufrufen ermittelten Kodierung.

[virtual] QChar QXmlInputSource::next()

Gibt das nächste Zeichen der Eingabequelle zurück. Wenn diese Funktion das Ende der verfügbaren Daten erreicht, gibt sie QXmlInputSource::EndOfData zurück. Wenn Sie danach next() aufrufen, versucht sie, durch den Aufruf von fetchData() weitere Daten zu holen. Wenn der Aufruf fetchData() zu neuen Daten führt, gibt diese Funktion das erste Zeichen dieser Daten zurück; andernfalls gibt sie QXmlInputSource::EndOfDocument zurück.

Leseprogramme wie QXmlSimpleReader gehen davon aus, dass das Ende des XML-Dokuments erreicht ist, wenn diese Funktion QXmlInputSource::EndOfDocument zurückgibt, und prüfen, ob die übergebene Eingabe wohlgeformt ist. Daher ist es wichtig, bei der Neuimplementierung dieser Funktion sicherzustellen, dass dieses Verhalten dupliziert wird.

Siehe auch reset(), fetchData(), QXmlSimpleReader::parse(), und QXmlSimpleReader::parseContinue().

[virtual] void QXmlInputSource::reset()

Diese Funktion setzt die von next() verwendete Position auf den Anfang der von data() zurückgegebenen Daten. Dies ist nützlich, wenn Sie die Eingabequelle für mehr als einen Parse verwenden wollen.

Siehe auch next().

[virtual] void QXmlInputSource::setData(const QString &dat)

Setzt die Daten der Eingabequelle auf dat.

Wenn die Eingabequelle bereits Daten enthält, löscht diese Funktion zuerst diese Daten.

Siehe auch data().

[virtual] void QXmlInputSource::setData(const QByteArray &dat)

Dies ist eine überladene Funktion.

Die Daten dat werden durch den richtigen Text-Codec geleitet, bevor sie gesetzt werden.