00001 /* 00002 * Copyright (c) 2000, 2020, Oracle and/or its affiliates. 00003 * 00004 * Licensed under the Universal Permissive License v 1.0 as shown at 00005 * http://oss.oracle.com/licenses/upl. 00006 */ 00007 #ifndef COH_STACK_TRACE_ELEMENT_HPP 00008 #define COH_STACK_TRACE_ELEMENT_HPP 00009 00010 #include "coherence/lang.ns" 00011 00012 #include "coherence/lang/interface_spec.hpp" 00013 00014 00015 00016 COH_OPEN_NAMESPACE2(coherence,lang) 00017 00018 00019 /** 00020 * StackTraceElement interface represents a frame within a stack trace. 00021 * 00022 * The information included in the trace is not of a guaranteed format and may 00023 * differ between platforms and debug/release libraries. It is recommended 00024 * that applications only print the element, and not attempt to interpret the 00025 * output. 00026 * 00027 * This interface is also a place holder and may grow over time to include 00028 * certain pre-parsed information, such as file and line numbers, though the 00029 * availability of this information would still not be guaranteed. 00030 * 00031 * @author mf 2008.04.01 00032 */ 00033 class COH_EXPORT StackTraceElement 00034 : public interface_spec<StackTraceElement> 00035 { 00036 // ----- Object interface ----------------------------------------------- 00037 00038 public: 00039 /** 00040 * {@inheritDoc} 00041 */ 00042 virtual TypedHandle<const String> toString() const = 0; 00043 }; 00044 00045 COH_CLOSE_NAMESPACE2 00046 00047 #endif // COH_STACK_TRACE_ELEMENT_HPP