## javax.xml.xquery
Class XQStackTraceElement

    java.lang.Object
      javax.xml.xquery.XQStackTraceElement

All Implemented Interfaces:
  Serializable

    public class XQStackTraceElement

extends Object
implements Serializable

This class represents a frame in a stack trace, akin to the `java.lang.StackTraceElement` but for XQuery callstacks instead of Java.

See Also:
  ``XQQueryException.getQueryStackTrace``, Serialized Form

Constructor Summary
`XQStackTraceElement(String moduleURI, int line, int column, int position, QName function, XQStackTraceVariable[] variables)` Construct an `XQStackTraceElement` object representing a frame in a stack trace.

Method Summary
`int` `getColumnNumber()` Gets the column number in the query string containing the execution point represented by this stack trace element.
`QName` `getFunctionQName()` Gets the `QName` of the function in which the error occurred, or `null` if it occurred outside an enclosing function (in a main module).
`int` `getLineNumber()` Gets the line number in the query string containing the execution point represented by this stack trace element.
`String` `getModuleURI()` Gets the module URI containing the execution point represented by this stack trace element.
`int` `getPosition()` Gets the character position in the query string containing the execution point represented by this stack trace element.
`XQStackTraceVariable[]` `getVariables()` Gets the variables in scope at this execution point, or `null` if no variable value retrieval is possible.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### XQStackTraceElement

    public XQStackTraceElement(String moduleURI,
                               int line,
                               int column,
                               int position,
                               QName function,
                               XQStackTraceVariable[] variables)

  Construct an `XQStackTraceElement` object representing a frame in a stack trace.

  Parameters:
    `moduleURI` - the module URI containing the execution point representing the stack trace element. `null` when it is the main module or when the module is unknown
    `line` - the line number in the query string where the error occured. Line numbering starts at `1`. `-1` if unknown
    `column` - the column number in the query string where the error occured. Column numbering starts at `1`. `-1` if unknown
    `position` - the position in the query string where the error occured. This is a `0` based position. `-1`if unknown``
    `function` - the `QName` of the function in which the exception occurred, or `null` if it occurred outside an enclosing function
    `variables` - the variables in scope at this execution point, or `null` if no variable value retrieval is possible

Method Detail

### getModuleURI

    public String getModuleURI()

  Gets the module URI containing the execution point represented by this stack trace element. `null` when it is the main module or when the module is unknown.

  Returns:
    the module URI containing the excution point represented by the stack trace element or `null`

### getPosition

    public int getPosition()

  Gets the character position in the query string containing the execution point represented by this stack trace element.

  This is a `0` based position. `-1` if unknown.

  Returns:
    the character position in the query string containing the execution point represented by the stack trace element

### getLineNumber

    public int getLineNumber()

  Gets the line number in the query string containing the execution point represented by this stack trace element.

  Line numbering starts at `1`. `-1` is returned if the line number is unknown. If the implementation does not support this method, it must return `-1`

  Returns:
    the line number in the query string containing the execution point represented by the stack trace element

### getColumnNumber

    public int getColumnNumber()

  Gets the column number in the query string containing the execution point represented by this stack trace element.

  Column numbering starts at `1`. `-1` is returned if the column number is unknown. If the implementation does not support this method, it must return `-1`

  Returns:
    the column number in the query string containing the execution point represented by the stack trace element

### getFunctionQName

    public QName getFunctionQName()

  Gets the `QName` of the function in which the error occurred, or `null` if it occurred outside an enclosing function (in a main module).

  Returns:
    the `QName` of the function in which the error occurred for this stack element or `null` if it occurred outside an enclosing function

### getVariables

    public XQStackTraceVariable[] getVariables()

  Gets the variables in scope at this execution point, or `null` if no variable value retrieval is possible.

  Returns:
    the variables in scope at this execution point, or `null` if no variable value retrieval is possible.

Copyright (c) 2004-2010 Saxonica Limited. All rights reserved.