IsEmptyElement
This method allows the client to determine the difference between elements that have a closing tag, but do not contain content, and elements that do not have a closing tag.
Syntax
BOOL IsEmptyElement ();
Return Value
Returns TRUE if the current element ends with />; otherwise, returns FALSE.
Remarks
IsEmptyElement returns FALSE for the following element:
<element attribute="123"></element>
IsEmptyElement returns TRUE for the following element:
<element attribute="123"/>
Note that when writing elements, an XmlNodeType_EndElement node is not generated for empty element start tags.
If the method is not applicable, it will return FALSE.
You should save the value of IsEmptyElement before processing attributes, or call MoveToElement to make IsEmptyElement valid after processing attributes.
IsEmptyElement returns FALSE when XmlReader is positioned on an attribute node, even if attribute's parent element is empty.
The following code tests whether the reader is currently on an empty element:
if (FAILED(hr = pReader->GetPrefix(&pwszPrefix, &cwchPrefix))) {
wprintf(L"Error getting prefix, error is %08.8lx", hr);
return -1;
}
if (FAILED(hr = pReader->GetLocalName(&pwszLocalName, NULL))) {
wprintf(L"Error getting local name, error is %08.8lx", hr);
return -1;
}
if (cwchPrefix > 0)
wprintf(L"Element: %s:%s\n", pwszPrefix, pwszLocalName);
else
wprintf(L"Element: %s\n", pwszLocalName);
if (FAILED(hr = WriteAttributes(pReader))) {
wprintf(L"Error writing attributes, error is %08.8lx", hr);
return -1;
}
if (FAILED(hr = pReader->MoveToElement())) {
wprintf(L"Error moving to the element that owns the current attribute node, error is %08.8lx", hr);
return -1;
}
// fEmptyElement is a saved value of pReader->IsEmptyElement()
// as it was before WriteAttributes(pReader))
if(fEmptyElement)
wprintf(L" (empty)");
Requirements
Header: XmlLite.h
Library: XmlLite.lib