LabWindows/CVI

CVIXMLGetElementTagLength

CVIXMLStatus CVIXMLGetElementTagLength (CVIXMLElement element, int *length);

Purpose

Gets the length of the tag of an element. This can be used to allocate memory before getting the tag of the element.

Parameters

Input
Name Type Description
element CVIXMLElement The element handle must be a valid CVIXMLElement.
Output
Name Type Description
length int On output, contains the length of the element's tag in bytes. The length does not include the terminating NUL-byte.

Return Value

Name Type Description
status CVIXMLStatus Indicates whether the function was successful.

A zero indicates success.

You can call CVIXMLGetErrorString to obtain textual descriptions of error codes. Among the more commonly encountered errors are:

E_OUTOFMEMORY Out of memory.
E_INVALIDARG Invalid argument to a function.

Additional Information

Library: CVIXML

Include file: toolbox\cvixml.h

LabWindows/CVI compatibility: LabWindows/CVI 7.0 and later

Examples

Refer to the following examples that use the CVIXMLGetElementTagLength function:

  • apps\xmlTree\xmlTree.cws

    Open example
  • toolbox\XMLSample.cws

    Open example