Obsolete Members for QDomDocument

Los siguientes miembros de la clase QDomDocument son obsoletos. Se proporcionan para que el código fuente antiguo siga funcionando. Desaconsejamos su uso en código nuevo.

Funciones públicas

Documentación de funciones miembro

[deprecated in 6.8] bool QDomDocument::setContent(QIODevice *dev, QString *errorMsg, int *errorLine = nullptr, int *errorColumn = nullptr)

Esta función está obsoleta desde la versión 6.8. Desaconsejamos su uso en código nuevo.

Utilice en su lugar la sobrecarga que devuelve ParseResult.

Esta función lee el documento XML desde el dispositivo IO dev, devolviendo true si el contenido ha sido analizado con éxito; en caso contrario devuelve false.

No se realiza ningún procesamiento del espacio de nombres.

[deprecated in 6.8] bool QDomDocument::setContent(const QByteArray &buffer, QString *errorMsg, int *errorLine = nullptr, int *errorColumn = nullptr)

Esta función está obsoleta desde la versión 6.8. Desaconsejamos su uso en código nuevo.

Utilice en su lugar la sobrecarga que devuelve ParseResult.

Esta función lee el documento XML de la matriz de bytes buffer, devolviendo true si el contenido se ha analizado correctamente; en caso contrario devuelve false.

No se realiza ningún procesamiento del espacio de nombres.

[deprecated in 6.8] bool QDomDocument::setContent(const QString &text, QString *errorMsg, int *errorLine = nullptr, int *errorColumn = nullptr)

Esta función está obsoleta desde la versión 6.8. Desaconsejamos su uso en código nuevo.

Utilice en su lugar la sobrecarga que devuelve ParseResult.

Esta función lee el documento XML de la cadena text, devolviendo true si el contenido se ha analizado correctamente; en caso contrario devuelve false. Dado que text ya es una cadena Unicode, no se realiza ninguna detección de codificación.

Tampoco se procesa el espacio de nombres.

[deprecated in 6.8] bool QDomDocument::setContent(QIODevice *dev, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Esta función está obsoleta desde la versión 6.8. Desaconsejamos su uso en código nuevo.

Utilice en su lugar la sobrecarga que toma ParseOptions.

Esta función lee el documento XML del dispositivo IO dev, devolviendo true si el contenido ha sido analizado con éxito; en caso contrario devuelve false.

[deprecated in 6.8] bool QDomDocument::setContent(QXmlStreamReader *reader, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Esta función está obsoleta desde la versión 6.8. Desaconsejamos su uso en código nuevo.

Utilice en su lugar la sobrecarga que toma ParseOptions.

Esta función lee el documento XML de QXmlStreamReader reader y lo analiza. Devuelve true si el contenido se ha analizado correctamente; en caso contrario, devuelve false.

Si namespaceProcessing es true, el analizador reconoce los espacios de nombres en el archivo XML y establece el nombre del prefijo, el nombre local y el URI del espacio de nombres en los valores apropiados. Si namespaceProcessing es false, el analizador no procesa los espacios de nombres cuando lee el archivo XML.

Si se produce un error de análisis, el mensaje de error se coloca en *errorMsg , el número de línea en *errorLine y el número de columna en *errorColumn (a menos que el puntero asociado se establezca en nullptr).

Véase también QXmlStreamReader.

[deprecated in 6.8] bool QDomDocument::setContent(const QByteArray &data, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Esta función está obsoleta desde la versión 6.8. Desaconsejamos su uso en código nuevo.

Utilice en su lugar la sobrecarga que toma ParseOptions.

Esta función analiza el documento XML a partir de la matriz de bytes data y lo establece como contenido del documento. Intenta detectar la codificación del documento tal y como exige la especificación XML.

Si namespaceProcessing es verdadero, el analizador reconoce los espacios de nombres en el archivo XML y establece el nombre del prefijo, el nombre local y el URI del espacio de nombres con los valores apropiados. Si namespaceProcessing es falso, el analizador no procesa los espacios de nombres cuando lee el archivo XML.

Si se produce un error de análisis, esta función devuelve false y el mensaje de error se coloca en *errorMsg , el número de línea en *errorLine y el número de columna en *errorColumn (a menos que el puntero asociado se establezca en nullptr); de lo contrario, esta función devuelve true.

Si namespaceProcessing es verdadero, la función QDomNode::prefix() devuelve una cadena para todos los elementos y atributos. Devuelve una cadena vacía si el elemento o atributo no tiene prefijo.

Los nodos de texto formados únicamente por espacios en blanco se eliminan y no aparecen en QDomDocument.

Si namespaceProcessing es falso, las funciones QDomNode::prefix(), QDomNode::localName() y QDomNode::namespaceURI() devuelven una cadena vacía.

Las referencias a entidades se tratan del siguiente modo:

• Se incluyen las referencias a entidades generales internas y a entidades de caracteres que aparecen en el contenido. El resultado es un nodo QDomText con las referencias sustituidas por sus correspondientes valores de entidad.
• Se incluyen las referencias a entidades paramétricas que aparecen en el subconjunto interno. El resultado es un nodo QDomDocumentType que contiene declaraciones de entidades y notaciones con las referencias sustituidas por sus correspondientes valores de entidad.
• Cualquier referencia de entidad general analizada que no esté definida en el subconjunto interno y que aparezca en el contenido se representa como un nodo QDomEntityReference.
• Cualquier referencia de entidad analizada que no esté definida en el subconjunto interno y que aparezca fuera del contenido se sustituye por una cadena vacía.
• Cualquier referencia de entidad no analizada se sustituye por una cadena vacía.

Véase también QDomNode::namespaceURI(), QDomNode::localName(), QDomNode::prefix(), QString::isNull() y QString::isEmpty().

[deprecated in 6.8] bool QDomDocument::setContent(const QString &text, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Esta función está obsoleta desde la versión 6.8. Desaconsejamos su uso en código nuevo.

Utilice en su lugar las sobrecargas que toman ParseOptions.

Esta función lee el documento XML de la cadena text, devolviendo true si el contenido se ha analizado correctamente; en caso contrario devuelve false. Dado que text ya es una cadena Unicode, no se realiza ninguna detección de codificación.