Share via


GetLinePosition

 

Gets the line position where the reader is positioned in the document.

Syntax

  
HRESULT GetLinePosition ([out] UINT * pcwchLinePosition);  

Arguments

pcwchLinePosition
Returns the line position.

Return Value

Returns S_OK if no error is generated.

Remarks

This method is most useful for reporting the position on the line if an error occurs.

The starting number is 1. For example, if the XML document is <root/> and the reader is on <, the line number is 1 and the line position is 1.

When you are about to read a node that contains whitespace and text, this method returns the position of the first non-whitespace text. This may not be what you expect; you may expect the position of the first character of the node. However, XmlLite's focus is on high performance, and for performance the reader advances to the first non-whitespace text. This method returns the line position where the reader is positioned in the document, not the first position of the next node.

Requirements

Header: XmlLite.h

Library: XmlLite.lib

See Also

GetLineNumber