NS-MIRACLE library: nsmiracle/deprecated.h Source File

00001 /*
00002  * Copyright (c) 2006 Regents of the SIGNET lab, University of Padova.
00003  * All rights reserved.
00004  *
00005  * Redistribution and use in source and binary forms, with or without
00006  * modification, are permitted provided that the following conditions
00007  * are met:
00008  * 1. Redistributions of source code must retain the above copyright
00009  *    notice, this list of conditions and the following disclaimer.
00010  * 2. Redistributions in binary form must reproduce the above copyright
00011  *    notice, this list of conditions and the following disclaimer in the
00012  *    documentation and/or other materials provided with the distribution.
00013  * 3. Neither the name of the University of Padova (SIGNET lab) nor the 
00014  *    names of its contributors may be used to endorse or promote products 
00015  *    derived from this software without specific prior written permission.
00016  *
00017  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
00018  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 
00019  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
00020  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 
00021  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
00022  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
00023  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
00024  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
00025  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 
00026  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
00027  * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00028  */
00029 
00030 
00043 #ifndef NSMIRACLE_DEPRECATED_H
00044 #define NSMIRACLE_DEPRECATED_H
00045 
00046 #include<iostream>
00047 
00048 
00049 #define RETVAL_NOT_IMPLEMENTED 5432
00050 
00051 
00052 #define PRINT_WARNING_DEPRECATED_FUNCTION {                             \
00053     static bool print_warning_deprecated_function = true;               \
00054       if (print_warning_deprecated_function)    {                       \
00055         cerr << "WARNING: method " << __PRETTY_FUNCTION__                       \
00056              << "() is deprecated " << endl;                            \
00057         print_warning_deprecated_function = false;                      \
00058       }                                                                 \
00059   }
00060 
00061 
00062 
00063 
00064 #ifdef __STRING
00065 #define WARNING_MSG_DEPRECATED_VIRTUAL_METHOD(X,Y) "WARNING: deprecated virtual method " __STRING(X) " is being used instead of " __STRING(Y)
00066 #else //  __STRING is undefined !!!
00067 #define WARNING_MSG_DEPRECATED_VIRTUAL_METHOD "WARNING: a deprecated virtual method is being used instead of a new one "
00068 #endif // __STRING
00069 
00070 
00071 
00072 #define RUN_DEPRECATED_OR_NEW_VIRTUAL_METHOD(X,Y) {     \
00073     static bool print_warning_deprecated_virtual_method = true;         \
00074     int retval=(Y);                                                     \
00075     if ( retval ==  RETVAL_NOT_IMPLEMENTED ) {                          \
00076         retval = (X);                                                   \
00077         if (( retval !=  RETVAL_NOT_IMPLEMENTED )                     \
00078              && print_warning_deprecated_virtual_method)        {       \
00079            cerr << WARNING_MSG_DEPRECATED_VIRTUAL_METHOD(X,Y) << endl;   \
00080            print_warning_deprecated_virtual_method = false;             \
00081         }                                                               \
00082       }                                                                 \
00083   }
00084 
00085 
00086 
00087 
00088 
00089 
00090 
00091 #endif // NSMIRACLE_DEPRECATED_H