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()가 true를 반환하고 error()가 PrematureEndOfDocumentError 를 반환하는 경우, 이는 지금까지 XML이 유효한 형식을 갖추고 있지만 완전한 XML 문서가 아직 파싱되지 않았음을 의미합니다. XML이 QByteArray 에서 읽혀지고 있는 경우 addData()을 사용하여 다음 XML 청크를 추가할 수 있으며, XML이 QIODevice 에서 읽혀지고 있는 경우 추가 데이터가 도착할 때까지 기다리면 됩니다. 어느 경우든, 추가 데이터가 준비되면 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

이 문서에 명시적인 독립 문서 선언이 있는 경우 true 를 반환합니다(‘yes’ 또는 ‘no’일 수 있음). 그렇지 않은 경우 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 선언에서 독립형(standalone)으로 선언된 경우 ` 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 의 namespaceUri를 반환합니다.

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()을 사용해서는 안 되며, 대신 resolved 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()

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

한 가지 예외를 제외하고, readNext()가 error()를 반환하면 더 이상 XML 스트림을 읽을 수 없습니다. 이 경우 atEnd()는 true 를, hasError()는 true 를 반환하며, 이 함수는 QXmlStreamReader::Invalid 를 반환합니다.

단, error()이 PrematureEndOfDocumentError 를 반환하는 경우는 예외입니다. 이 오류는 형식적으로 올바른 XML 청크의 끝 부분에 도달했으나, 해당 청크가 완전한 XML 문서를 나타내지 않을 때 보고됩니다. 이 경우, 스트림이 QByteArray 에서 읽혀지는 중이라면 addData()를 호출하여 다음 XML 청크를 추가하거나, 스트림이 device()에서 읽혀지는 중이라면 더 많은 데이터가 도착할 때까지 기다림으로써 파싱을 재개할 수 있습니다.

tokenType() 및 tokenString()도 참조하십시오 .

bool QXmlStreamReader::readNextStartElement()

현재 요소 내에서 다음 시작 요소까지 읽습니다. 시작 요소에 도달하면 ` true `를 반환합니다. 끝 요소에 도달했거나 오류가 발생한 경우 `false`를 반환합니다.

현재 요소는 가장 최근에 구문 분석된 시작 요소와 일치하며, 아직 일치하는 종료 요소에 도달하지 않은 요소입니다. 파서가 종료 요소에 도달하면 현재 요소는 상위 요소가 됩니다.

이 함수는 XML 요소 파싱에만 관심이 있을 때 사용하기 편리한 함수입니다. QXmlStream Bookmarks 예제에서는 이 함수를 광범위하게 사용합니다.

readNext()도 참조하십시오 .

[since 6.10] QString QXmlStreamReader::readRawInnerData()

현재 요소의 원시 내부 XML 내용을 읽어서 반환합니다. 이 함수는 중첩된 태그, 텍스트, 주석, 처리 지시문, CDATA 섹션 및 기타 마크업을 포함하여 요소 내에 삽입된 전체 내용을 원본 XML 구조를 유지한 채로 가져오는 데 유용합니다.

현재 요소는 가장 최근에 구문 분석된 시작 요소와 일치하며, 아직 일치하는 종료 요소에 도달하지 않은 요소입니다. 파서가 종료 요소에 도달하면 현재 요소는 상위 요소가 됩니다.

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

void QXmlStreamReader::setDevice(QIODevice *device)

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

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

void QXmlStreamReader::setEntityExpansionLimit(int limit)

단일 엔티티가 확장될 수 있는 최대 문자 수를 ` limit`로 설정합니다. 단일 엔티티가 지정된 제한을 초과하여 확장될 경우, 해당 문서는 올바른 형식을 갖춘 것으로 간주되지 않습니다.

이 제한은 알 수 없는 XML 문서를 로드할 때 재귀적 엔티티 확장이 사용 가능한 메모리를 모두 소진시켜 서비스 거부(DoS) 공격이 발생하는 것을 방지하기 위해 마련되었습니다.

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

최소값은 1이며, 이는 내장 XML 엔티티(< 등)를 지원하기 위함입니다.

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()도 참조하십시오 .