Teuchos Package Browser (Single Doxygen Collection) Version of the Day
Loading...
Searching...
No Matches
Teuchos_TypeNameTraits.cpp
Go to the documentation of this file.
1// @HEADER
2// ***********************************************************************
3//
4// Teuchos: Common Tools Package
5// Copyright (2004) Sandia Corporation
6//
7// Under terms of Contract DE-AC04-94AL85000, there is a non-exclusive
8// license for use of this work by or on behalf of the U.S. Government.
9//
10// Redistribution and use in source and binary forms, with or without
11// modification, are permitted provided that the following conditions are
12// met:
13//
14// 1. Redistributions of source code must retain the above copyright
15// notice, this list of conditions and the following disclaimer.
16//
17// 2. Redistributions in binary form must reproduce the above copyright
18// notice, this list of conditions and the following disclaimer in the
19// documentation and/or other materials provided with the distribution.
20//
21// 3. Neither the name of the Corporation nor the names of the
22// contributors may be used to endorse or promote products derived from
23// this software without specific prior written permission.
24//
25// THIS SOFTWARE IS PROVIDED BY SANDIA CORPORATION "AS IS" AND ANY
26// EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28// PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SANDIA CORPORATION OR THE
29// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
30// EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
31// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
32// PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
33// LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
34// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
35// SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36//
37// Questions? Contact Michael A. Heroux (maherou@sandia.gov)
38//
39// ***********************************************************************
40// @HEADER
41
43#include "Teuchos_Assert.hpp"
44
45// Define this if you want to force name demangling if supported
46//#define HAVE_TEUCHOS_DEMANGLE
47
48#if defined(HAVE_GCC_ABI_DEMANGLE) && defined(HAVE_TEUCHOS_DEMANGLE)
49# include <cxxabi.h>
50#endif
51
52
53std::string Teuchos::demangleName( const std::string &mangledName )
54{
55#if defined(HAVE_GCC_ABI_DEMANGLE) && defined(HAVE_TEUCHOS_DEMANGLE)
56 int status;
57 char* _demangledName = abi::__cxa_demangle (mangledName.c_str (), 0, 0, &status);
58 if (status != 0 || 0 == _demangledName) {
59#ifdef TEUCHOS_DEBUG
60 // In a debug build, we check if demangling succeeded.
61 std::string nullstr ("NULL");
62 const char* demangle_output = _demangledName ? _demangledName : nullstr.c_str ();
63 using std::endl;
64#endif // TEUCHOS_DEBUG
65 if (_demangledName != NULL) {
66 // The C library standard requires that free() do the right
67 // thing with NULL input, but it doesn't hurt to check.
68 free (_demangledName);
69 }
70#ifdef TEUCHOS_DEBUG
72 true, std::logic_error,
73 "Error, name demangling with g++ has been enabled but the function "
74 "abi::__cxa_demangle(" << mangledName << ") returned returnVal = " <<
75 demangle_output <<" and status = " << status << "." << endl << "This "
76 "suggests that name demangling may be broken on this platform." << endl
77 << "You may prevent this exception from being thrown in the future by "
78 "turning off name demangling for this build at configure time." << endl
79 << "Do this by setting the CMake configuration option "
80 "Teuchos_ENABLE_GCC_DEMANGLE to OFF." << endl << "Add the following to "
81 "your list of CMake options:" << endl << endl <<
82 " -D Teuchos_ENABLE_GCC_DEMANGLE:BOOL=OFF" << endl);
83#else // NOT TEUCHOS_DEBUG
84 return (mangledName + "<demangle-failed>");
85#endif // TEUCHOS_DEBUG
86 }
87 const std::string demangledName (_demangledName);
88 free (_demangledName); // We have to free this before we return!
89 return demangledName;
90#else
91 return mangledName;
92#endif
93}
Defines basic traits returning the name of a type in a portable and readable way.
#define TEUCHOS_TEST_FOR_EXCEPTION(throw_exception_test, Exception, msg)
Macro for throwing an exception with breakpointing to ease debugging.
TEUCHOSCORE_LIB_DLL_EXPORT std::string demangleName(const std::string &mangledName)
Demangle a C++ name if valid.