Oracle Coherence for C++ API
Release 3.7.1.0
E22845-01

StackTraceElement Class Reference

#include <coherence/lang/StackTraceElement.hpp>

Inherits Object.

Detailed Description

StackTraceElement interface represents a frame within a stack trace.

The information included in the trace is not of a guaranteed format and may differ between platforms and debug/release libraries. It is recommended that applications only print the element, and not attempt to interpret the output.

This interface is also a place holder and may grow over time to include certain pre-parsed information, such as file and line numbers, though the availability of this information would still not be guaranteed.

Author:: mf 2008.04.01

Public Types

typedef spec::Handle Handle

StackTraceElement Handle definition.

typedef spec::View View

StackTraceElement View definition.

typedef spec::Holder Holder

StackTraceElement Holder definition.

Public Member Functions

virtual void toStream (std::ostream &out) const =0

Output a human-readable description of this Object to the given stream.

coherence::lang::operator<<(std::ostream, Object::View) is defined and will call into the toStream method, to output Objects. If a managed String object is desired, the COH_TO_STRING macro can be used to build up a String from streamable contents.

 Object::View vKey   = ...
 Object::View vValue = ...
 std::cout << vKey << " = " << vValue << std::endl;

 String::Handle hs = COH_TO_STRING(vKey << " = " << vValue);

Parameters:

out

the stream used to output the description

The documentation for this class was generated from the following file:

coherence/lang/StackTraceElement.hpp