QXmlStreamReader Class

  QXmlStreamReader xml;
  ...
  while (!xml.atEnd()) {
        xml.readNext();
        ... // do processing
  }
  if (xml.hasError()) {
        ... // do error handling
  }

멤버 함수 문서

QXmlStreamReader::QXmlStreamReader()

스트림 리더를 구축합니다.

setDevice() 및 addData()도 참조하세요 .

[explicit] QXmlStreamReader::QXmlStreamReader(QAnyStringView data)

data 에서 읽는 새 스트림 리더를 만듭니다.

addData(), clear() 및 setDevice()도 참조하십시오 .

[explicit] QXmlStreamReader::QXmlStreamReader(QIODevice *device)

device 에서 읽는 새 스트림 리더를 만듭니다.

setDevice() 및 clear()도 참조하세요 .

[explicit] QXmlStreamReader::QXmlStreamReader(const QByteArray &data)

이것은 과부하된 함수입니다.

data 에서 읽는 새 스트림 리더를 만듭니다.

addData(), clear() 및 setDevice()도 참조하세요 .

[noexcept] QXmlStreamReader::~QXmlStreamReader()

리더를 파괴합니다.

void QXmlStreamReader::addData(QAnyStringView data)

독자가 읽을 수 있도록 data 을 추가합니다. 리더에 device()가 있는 경우 이 함수는 아무 작업도 수행하지 않습니다.

readNext() 및 clear()도 참조하십시오 .

void QXmlStreamReader::addData(const QByteArray &data)

과부하가 걸린 기능입니다.

독자가 읽을 data 을 더 추가합니다. 리더에 device()가 있는 경우 이 함수는 아무 작업도 수행하지 않습니다.

readNext() 및 clear()도 참조하세요 .

void QXmlStreamReader::addExtraNamespaceDeclaration(const QXmlStreamNamespaceDeclaration &extraNamespaceDeclaration)

extraNamespaceDeclaration 을 추가합니다. 선언은 현재 요소의 하위 요소에 유효하거나, 요소를 읽기 전에 함수가 호출되는 경우 전체 XML 문서에 유효합니다.

namespaceDeclarations(), addExtraNamespaceDeclarations() 및 setNamespaceProcessing()도 참조하세요 .

void QXmlStreamReader::addExtraNamespaceDeclarations(const QXmlStreamNamespaceDeclarations &extraNamespaceDeclarations)

extraNamespaceDeclarations 에 지정된 선언 벡터를 추가합니다.

namespaceDeclarations() 및 addExtraNamespaceDeclaration()도 참조하세요 .

bool QXmlStreamReader::atEnd() const

독자가 XML 문서의 끝까지 읽었거나 error()이 발생하여 읽기가 중단된 경우 true 을 반환합니다. 그렇지 않으면 false 을 반환합니다.

atEnd() 및 hasError()가 참을 반환하고 error()가 PrematureEndOfDocumentError 를 반환하면 지금까지 XML이 잘 형성되었지만 완전한 XML 문서가 구문 분석되지 않았음을 의미합니다. 다음 XML 청크는 QByteArray 에서 XML을 읽는 경우 addData()로 추가하거나 QIODevice 에서 XML을 읽는 경우 더 많은 데이터가 도착할 때까지 기다렸다가 추가할 수 있습니다. 어느 쪽이든 더 많은 데이터를 사용할 수 있게 되면 atEnd()는 false를 반환합니다.

hasError(), error(), device() 및 QIODevice::atEnd()도 참조하세요 .

QXmlStreamAttributes QXmlStreamReader::attributes() const

StartElement 의 속성을 반환합니다.

qint64 QXmlStreamReader::characterOffset() const

0부터 시작하여 현재 문자 오프셋을 반환합니다.

lineNumber() 및 columnNumber()도 참조하세요 .

void QXmlStreamReader::clear()

리더에서 device() 또는 데이터를 제거하고 내부 상태를 초기 상태로 재설정합니다.

addData()도 참조하세요 .

qint64 QXmlStreamReader::columnNumber() const

0으로 시작하는 현재 열 번호를 반환합니다.

lineNumber() 및 characterOffset()도 참조하세요 .

QIODevice *QXmlStreamReader::device() const

QXmlStreamReader 에 연결된 현재 장치를 반환하거나 장치가 할당되지 않은 경우 nullptr 을 반환합니다.

setDevice()도 참조하세요 .

QStringView QXmlStreamReader::documentEncoding() const

tokenType()가 StartDocument 인 경우 이 함수는 XML 선언에 지정된 대로 인코딩 문자열을 반환합니다. 그렇지 않으면 빈 문자열이 반환됩니다.

QStringView QXmlStreamReader::documentVersion() const

tokenType()가 StartDocument 인 경우 이 함수는 XML 선언에 지정된 대로 버전 문자열을 반환합니다. 그렇지 않으면 빈 문자열이 반환됩니다.

QStringView QXmlStreamReader::dtdName() const

tokenType()가 DTD 인 경우 이 함수는 DTD의 이름을 반환합니다. 그렇지 않으면 빈 문자열이 반환됩니다.

QStringView QXmlStreamReader::dtdPublicId() const

tokenType()가 DTD 인 경우 이 함수는 DTD의 공개 식별자를 반환합니다. 그렇지 않으면 빈 문자열이 반환됩니다.

QStringView QXmlStreamReader::dtdSystemId() const

tokenType()가 DTD 인 경우 이 함수는 DTD의 시스템 식별자를 반환합니다. 그렇지 않으면 빈 문자열이 반환됩니다.

QXmlStreamEntityDeclarations QXmlStreamReader::entityDeclarations() const

tokenType()가 DTD 인 경우 이 함수는 DTD의 구문 분석되지 않은 (외부) 엔티티 선언을 반환합니다. 그렇지 않으면 빈 벡터가 반환됩니다.

QXmlStreamEntityDeclarations 클래스는 QXmlStreamEntityDeclaration 의 QList 로 정의됩니다.

int QXmlStreamReader::entityExpansionLimit() const

단일 엔터티가 확장할 수 있는 최대 문자 수를 반환합니다. 단일 엔티티가 지정된 한도를 초과하여 확장되면 문서가 제대로 형성된 것으로 간주되지 않습니다.

setEntityExpansionLimit 를참조하세요 .

QXmlStreamEntityResolver *QXmlStreamReader::entityResolver() const

엔티티 확인자를 반환하거나 엔티티 확인자가 없는 경우 nullptr 을 반환합니다.

setEntityResolver()도 참조하세요 .

QXmlStreamReader::Error QXmlStreamReader::error() const

현재 오류의 유형을 반환하거나 오류가 발생하지 않은 경우 NoError 을 반환합니다.

errorString() 및 raiseError()도 참조하세요 .

QString QXmlStreamReader::errorString() const

raiseError()로 설정한 오류 메시지를 반환합니다.

error(), lineNumber(), columnNumber() 및 characterOffset()도 참조하세요 .

bool QXmlStreamReader::hasError() const

오류가 발생하면 true 를 반환하고, 그렇지 않으면 false 을 반환합니다.

errorString() 및 error()도 참조하세요 .

[since 6.6] bool QXmlStreamReader::hasStandaloneDeclaration() const

이 문서에 명시적인 독립형 선언('yes' 또는 'no' 가능)이 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다;

XML 선언이 구문 분석되지 않은 경우, 이 함수는 false 를 반환합니다.

이 함수는 Qt 6.6에 도입되었습니다.

isStandaloneDocument()도 참조하십시오 .

bool QXmlStreamReader::isCDATA() const

리더가 CDATA 섹션에서 비롯된 문자를 보고하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

isCharacters() 및 text()도 참조하세요 .

bool QXmlStreamReader::isCharacters() const

tokenType()이 Characters 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

isWhitespace() 및 isCDATA()도 참조하세요 .

bool QXmlStreamReader::isComment() const

tokenType()이 Comment 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QXmlStreamReader::isDTD() const

tokenType()이 DTD 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QXmlStreamReader::isEndDocument() const

tokenType()이 EndDocument 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QXmlStreamReader::isEndElement() const

tokenType()이 EndElement 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QXmlStreamReader::isEntityReference() const

tokenType()이 EntityReference 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QXmlStreamReader::isProcessingInstruction() const

tokenType()이 ProcessingInstruction 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QXmlStreamReader::isStandaloneDocument() const

이 문서가 XML 선언에서 독립적으로 선언된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

XML 선언이 구문 분석되지 않은 경우, 이 함수는 false 을 반환합니다.

hasStandaloneDeclaration()도 참조하세요 .

bool QXmlStreamReader::isStartDocument() const

tokenType()이 StartDocument 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QXmlStreamReader::isStartElement() const

tokenType()이 StartElement 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QXmlStreamReader::isWhitespace() const

독자가 공백으로만 구성된 문자를 보고하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

isCharacters() 및 text()도 참조하세요 .

qint64 QXmlStreamReader::lineNumber() const

1로 시작하는 현재 줄 번호를 반환합니다.

columnNumber() 및 characterOffset()도 참조하세요 .

QStringView QXmlStreamReader::name() const

StartElement, EndElement 또는 EntityReference 의 로컬 이름을 반환합니다.

namespaceUri() 및 qualifiedName()도 참조하세요 .

QXmlStreamNamespaceDeclarations QXmlStreamReader::namespaceDeclarations() const

tokenType()가 StartElement 인 경우 이 함수는 요소의 네임스페이스 선언을 반환합니다. 그렇지 않으면 빈 벡터가 반환됩니다.

QXmlStreamNamespaceDeclarations 클래스는 QXmlStreamNamespaceDeclaration 의 QList 로 정의됩니다.

addExtraNamespaceDeclaration() 및 addExtraNamespaceDeclarations()도 참조하세요 .

QStringView QXmlStreamReader::namespaceUri() const

StartElement 또는 EndElement 의 네임스페이스Uri를 반환합니다.

name() 및 qualifiedName()도 참조하세요 .

QXmlStreamNotationDeclarations QXmlStreamReader::notationDeclarations() const

tokenType()가 DTD 인 경우 이 함수는 DTD의 표기법 선언을 반환합니다. 그렇지 않으면 빈 벡터가 반환됩니다.

QXmlStreamNotationDeclarations 클래스는 QXmlStreamNotationDeclaration 의 QList 로 정의됩니다.

QStringView QXmlStreamReader::prefix() const

StartElement 또는 EndElement 의 접두사를 반환합니다.

name() 및 qualifiedName()도 참조하세요 .

QStringView QXmlStreamReader::processingInstructionData() const

ProcessingInstruction 의 데이터를 반환합니다.

QStringView QXmlStreamReader::processingInstructionTarget() const

ProcessingInstruction 의 대상을 반환합니다.

QStringView QXmlStreamReader::qualifiedName() const

StartElement 또는 EndElement 의 정규화된 이름을 반환합니다;

정규화된 이름은 XML 데이터에 있는 요소의 원시 이름입니다. 네임스페이스 접두사, 콜론, 요소의 로컬 이름으로 구성됩니다. 네임스페이스 접두사는 고유하지 않으므로(동일한 접두사가 다른 네임스페이스를 가리킬 수 있고 다른 접두사가 동일한 네임스페이스를 가리킬 수 있음), qualifiedName()을 사용하지 말고 확인된 namespaceUri()과 속성의 로컬 name()을 사용해야 합니다.

name(), prefix() 및 namespaceUri()도 참조하세요 .

void QXmlStreamReader::raiseError(const QString &message = QString())

선택적 오류와 함께 사용자 정의 오류를 발생시킵니다 message.

error() 및 errorString()도 참조하세요 .

QString QXmlStreamReader::readElementText(QXmlStreamReader::ReadElementTextBehaviour behaviour = ErrorOnUnexpectedElement)

StartElement 을 읽었을 때 호출하는 편의 함수입니다. 해당 EndElement 까지 읽고 그 사이의 모든 텍스트를 반환합니다. 오류가 없는 경우, 이 함수를 호출한 후 현재 토큰( tokenType() 참조)은 EndElement 입니다.

이 함수는 Characters 또는 EntityReference 토큰을 읽으면 text()를 연결하지만 ProcessingInstruction 및 Comment 은 건너뜁니다. 현재 토큰이 StartElement 이 아닌 경우 빈 문자열이 반환됩니다.

behaviour 은 EndElement 에 도달하기 전에 다른 것을 읽을 경우 어떤 일이 발생하는지 정의합니다. 이 함수는 하위 요소의 텍스트를 포함하거나(예: HTML에 유용), 하위 요소를 무시하거나, UnexpectedElementError 을 발생시키고 지금까지 읽은 내용을 반환할 수 있습니다(기본값).

QXmlStreamReader::TokenType QXmlStreamReader::readNext()

다음 토큰을 읽고 그 유형을 반환합니다.

한 가지 예외를 제외하고, error()가 readNext()에 의해 보고되면 XML 스트림을 더 이상 읽을 수 없습니다. 그런 다음 atEnd()는 true, hasError()는 true, 이 함수는 QXmlStreamReader::Invalid 를 반환합니다.

error()가 PrematureEndOfDocumentError 을 반환하는 경우는 예외입니다. 이 오류는 잘 구성된 XML 청크의 끝에 도달했지만 청크가 완전한 XML 문서를 나타내지 않을 때 보고됩니다. 이 경우 QByteArray 에서 스트림을 읽고 있는 경우 addData()를 호출하여 다음 XML 청크를 추가하거나 device()에서 스트림을 읽고 있는 경우 더 많은 데이터가 도착할 때까지 기다렸다가 구문 분석을 다시 시작할 수 있습니다.

tokenType() 및 tokenString()도 참조하세요 .

bool QXmlStreamReader::readNextStartElement()

현재 요소 내의 다음 시작 요소까지 읽습니다. 시작 요소에 도달하면 true 을 반환합니다. 끝 요소에 도달했거나 오류가 발생하면 false가 반환됩니다.

현재 요소는 가장 최근에 구문 분석된 시작 요소와 일치하는 요소 중 아직 일치하는 끝 요소에 도달하지 않은 요소입니다. 구문 분석기가 끝 요소에 도달하면 현재 요소가 부모 요소가 됩니다.

이 기능은 XML 요소 구문 분석에만 관심이 있을 때 편리한 기능입니다. QXmlStream 북마크 예제에서는 이 함수를 광범위하게 사용합니다.

readNext()도 참조하세요 .

void QXmlStreamReader::setDevice(QIODevice *device)

현재 디바이스를 device 로 설정합니다. 디바이스를 설정하면 스트림이 초기 상태로 초기화됩니다.

device() 및 clear()도 참조하세요 .

void QXmlStreamReader::setEntityExpansionLimit(int limit)

단일 엔터티가 확장할 수 있는 최대 문자 수를 limit 으로 설정합니다. 단일 엔터티가 지정된 제한을 초과하여 확장되면 문서가 제대로 형성된 것으로 간주되지 않습니다.

이 제한은 재귀적 엔티티 확장이 사용 가능한 메모리를 모두 소진할 수 있는 알 수 없는 XML 문서를 로드할 때 DoS 공격을 방지하기 위한 것입니다.

이 속성의 기본값은 4096자입니다.

entityExpansionLimit 을참조하세요 .

void QXmlStreamReader::setEntityResolver(QXmlStreamEntityResolver *resolver)

resolver 을 새로운 entityResolver()로 만듭니다.

스트림 리더는 리졸버의 소유권을 갖지 않습니다. 스트림 리더 객체의 전체 수명 기간 동안 또는 다른 리졸버 또는 nullptr 이 설정될 때까지 리졸버가 유효한지 확인하는 것은 호출자의 책임입니다.

entityResolver()도 참조하세요 .

void QXmlStreamReader::skipCurrentElement()

현재 요소의 끝 부분까지 읽으며 하위 노드를 건너뜁니다. 이 함수는 알 수 없는 요소를 건너뛸 때 유용합니다.

현재 요소는 가장 최근에 구문 분석된 시작 요소와 일치하는 요소 중 아직 일치하는 끝 요소에 도달하지 않은 요소입니다. 구문 분석기가 끝 요소에 도달하면 현재 요소가 부모 요소가 됩니다.

QStringView QXmlStreamReader::text() const

Characters, Comment, DTD, 또는 EntityReference 의 텍스트를 반환합니다.

QString QXmlStreamReader::tokenString() const

리더의 현재 토큰을 문자열로 반환합니다.

tokenType()도 참조하세요 .

QXmlStreamReader::TokenType QXmlStreamReader::tokenType() const

현재 토큰의 유형을 반환합니다.

현재 토큰은 isStartDocument(), isEndDocument(), isStartElement(), isEndElement(), isCharacters(), isComment(), isDTD(), isEntityReference() 및 isProcessingInstruction() 편의 함수로도 쿼리할 수 있습니다.

tokenString()도 참조하세요 .