XmlStackFrame API Ref

#include <DbXml.hpp>

class DbXml::XmlStackFrame { public: const char *getQueryFile() const; int getQueryLine() const; int getQueryColumn() const; XmlResults query(const std::string &queryString) const; std::string getQueryPlan() const; const XmlStackFrame *getPreviousStackFrame() const; };


Description: XmlStackFrame

The XmlStackFrame class provides stack trace information about an executing query to the methods of XmlDebugListener. XmlStackFrame objects describe a stack frame in the stack trace and includes a pointer to the previous stack frame.


Description: int XmlStackFrame::getQueryColumn() const

Returns the column number of the position in the query represented by this stack frame.


Description: const char * XmlStackFrame::getQueryFile() const

Returns the URI of the query represented by this stack frame.


Description: int XmlStackFrame::getQueryLine() const

Returns the line number of the position in the query represented by this stack frame.


Description: std::string XmlStackFrame::getQueryPlan() const

Returns the query plan of the sub-expression represented by this stack frame.


Description: const XmlStackFrame * XmlStackFrame::getPreviousStackFrame() const

Returns a pointer to the previous stack frame or 0 if this is the first stack frame.


Description: XmlResults XmlStackFrame::query(const std::string &queryString) const

Prepares and executes the query given in the dynamic context of the stack frame. This can be used to examine the value of the context item (".") or variables ("$var") for a given stack frame as well as other parts of the dynamic context. Users may find that the context item and variables present in their original query do not exist during query execution due to optimization performed by DB XML.


APIRef

Copyright (c) 1996-2009 Oracle. All rights reserved.