diff options
Diffstat (limited to 'cppuhelper/inc/cppuhelper/exc_hlp.hxx')
-rw-r--r-- | cppuhelper/inc/cppuhelper/exc_hlp.hxx | 94 |
1 files changed, 0 insertions, 94 deletions
diff --git a/cppuhelper/inc/cppuhelper/exc_hlp.hxx b/cppuhelper/inc/cppuhelper/exc_hlp.hxx deleted file mode 100644 index 9c110ee6c018..000000000000 --- a/cppuhelper/inc/cppuhelper/exc_hlp.hxx +++ /dev/null @@ -1,94 +0,0 @@ -/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ -/* - * This file is part of the LibreOffice project. - * - * This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * This file incorporates work covered by the following license notice: - * - * Licensed to the Apache Software Foundation (ASF) under one or more - * contributor license agreements. See the NOTICE file distributed - * with this work for additional information regarding copyright - * ownership. The ASF licenses this file to you under the Apache - * License, Version 2.0 (the "License"); you may not use this file - * except in compliance with the License. You may obtain a copy of - * the License at http://www.apache.org/licenses/LICENSE-2.0 . - */ - -#ifndef _CPPUHELPER_EXC_HLP_HXX_ -#define _CPPUHELPER_EXC_HLP_HXX_ - -#include <com/sun/star/uno/Any.hxx> -#include "cppuhelperdllapi.h" - -namespace cppu -{ - -/** This function throws the exception given by rExc. The given value has to - be of typeclass EXCEPTION and must be dervived from or of - type com.sun.star.uno.Exception. - - @param rExc - exception to be thrown. -*/ -CPPUHELPER_DLLPUBLIC void SAL_CALL throwException( const ::com::sun::star::uno::Any & rExc ) - SAL_THROW( (::com::sun::star::uno::Exception) ); - -/** Use this function to get the dynamic type of a caught C++-UNO exception; - completes the above function throwing exceptions generically. - - @code - try - { - ... - } - catch (::com::sun::star::uno::RuntimeException &) - { - // you ought not handle RuntimeExceptions: - throw; - } - catch (::com::sun::star::uno::Exception &) - { - ::com::sun::star::uno::Any caught( ::cppu::getCaughtException() ); - ... - } - @endcode - - Restrictions: - - use only for caught C++-UNO exceptions (UNOIDL defined) - - only as first statement in a catch block! - - don't do a C++ rethrow (throw;) after you have called this function - - call getCaughtException() just once in your catch block! - (function internally uses a C++ rethrow) - - @return - caught UNO exception - - @attention Caution! - This function is limited to the same C++ compiler runtime library. - E.g. for MSVC, this means that the catch handler code (the one - that calls getCaughtException()) needs to use the very same - C++ runtime library, e.g. msvcrt.dll as cppuhelper, e.g. - cppuhelper3MSC.dll and the bridge library, e.g. msci_uno.dll. - This is the case if all of them are compiled with the same - compiler version. - Background: The msci_uno.dll gets a rethrown exception out - of the internal msvcrt.dll thread local storage (tls). - Thus you _must_ not use this function if your code needs to run - in newer UDK versions without being recompiled, because those - newer UDK (-> OOo versions) potentially use newer C++ runtime - libraries which most often become incompatible! - - But this function ought to be usable for most OOo internal C++-UNO - development, because the whole OOo code base is compiled using the - same C++ compiler (and linking against one runtime library). -*/ -CPPUHELPER_DLLPUBLIC ::com::sun::star::uno::Any SAL_CALL getCaughtException(); - -} - -#endif - -/* vim:set shiftwidth=4 softtabstop=4 expandtab: */ |