#include <coherence/lang/StackTraceElement.hpp>
Inherits Object.
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.
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 TypedHandle < const String > | toString () const =0 |
Output a human-readable description of this Object to the given stream. Note that when overriding this method the return type must be TypedHandle<const String> rather then String::View. These two types are assignment compatible but not equivalent and declaring the override with String::View will not be a compatible override. coherence::lang::operator<<(std::ostream, Object::View) is defined and will call into the toString 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 and is generally how toString() will be implemented.
Object::View vKey = ... Object::View vValue = ... std::cout << vKey << " = " << vValue << std::endl; String::View vs = COH_TO_STRING(vKey << " = " << vValue); The COH_TO_STRING macro is also the most common way to implement the toString method. For example:
virtual TypedHandle<const String> Person::toString() const { return COH_TO_STRING("Name: " << f_sName << " SSN: " << f_nSSN); }
|