00001 /* 00002 * StackTraceElement.hpp 00003 * 00004 * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved. 00005 * 00006 * Oracle is a registered trademarks of Oracle Corporation and/or its 00007 * affiliates. 00008 * 00009 * This software is the confidential and proprietary information of Oracle 00010 * Corporation. You shall not disclose such confidential and proprietary 00011 * information and shall use it only in accordance with the terms of the 00012 * license agreement you entered into with Oracle. 00013 * 00014 * This notice may not be removed or altered. 00015 */ 00016 #ifndef COH_STACK_TRACE_ELEMENT_HPP 00017 #define COH_STACK_TRACE_ELEMENT_HPP 00018 00019 #include "coherence/lang.ns" 00020 00021 #include "coherence/lang/interface_spec.hpp" 00022 00023 00024 00025 COH_OPEN_NAMESPACE2(coherence,lang) 00026 00027 00028 /** 00029 * StackTraceElement interface represents a frame within a stack trace. 00030 * 00031 * The information included in the trace is not of a guaranteed format and may 00032 * differ between platforms and debug/release libraries. It is recommended 00033 * that applications only print the element, and not attempt to interpret the 00034 * output. 00035 * 00036 * This interface is also a place holder and may grow over time to include 00037 * certain pre-parsed information, such as file and line numbers, though the 00038 * availability of this information would still not be guaranteed. 00039 * 00040 * @author mf 2008.04.01 00041 */ 00042 class COH_EXPORT StackTraceElement 00043 : public interface_spec<StackTraceElement> 00044 { 00045 // ----- Object interface ----------------------------------------------- 00046 00047 public: 00048 /** 00049 * {@inheritDoc} 00050 */ 00051 virtual TypedHandle<const String> toString() const = 0; 00052 }; 00053 00054 COH_CLOSE_NAMESPACE2 00055 00056 #endif // COH_STACK_TRACE_ELEMENT_HPP