git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/AVR32_UC3/UTILS/PREPROCESSOR/stringz.h

   1 /*This file is prepared for Doxygen automatic documentation generation.*/\r
   2 /*! \file *********************************************************************\r
   3  *\r
   4  * \brief Preprocessor stringizing utils.\r
   5  *\r
   6  * - Compiler:           IAR EWAVR32 and GNU GCC for AVR32\r
   7  * - Supported devices:  All AVR32 devices can be used.\r
   8  *\r
   9  * \author               Atmel Corporation: http://www.atmel.com \n\r
  10  *                       Support and FAQ: http://support.atmel.no/\r
  11  *\r
  12  ******************************************************************************/\r
  13 \r
  14 /* Copyright (c) 2007, Atmel Corporation All rights reserved.\r
  15  *\r
  16  * Redistribution and use in source and binary forms, with or without\r
  17  * modification, are permitted provided that the following conditions are met:\r
  18  *\r
  19  * 1. Redistributions of source code must retain the above copyright notice,\r
  20  * this list of conditions and the following disclaimer.\r
  21  *\r
  22  * 2. Redistributions in binary form must reproduce the above copyright notice,\r
  23  * this list of conditions and the following disclaimer in the documentation\r
  24  * and/or other materials provided with the distribution.\r
  25  *\r
  26  * 3. The name of ATMEL may not be used to endorse or promote products derived\r
  27  * from this software without specific prior written permission.\r
  28  *\r
  29  * THIS SOFTWARE IS PROVIDED BY ATMEL ``AS IS'' AND ANY EXPRESS OR IMPLIED\r
  30  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF\r
  31  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE EXPRESSLY AND\r
  32  * SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT,\r
  33  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\r
  34  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\r
  35  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\r
  36  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\r
  37  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF\r
  38  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
  39  */\r
  40 \r
  41 \r
  42 #ifndef _STRINGZ_H_\r
  43 #define _STRINGZ_H_\r
  44 \r
  45 \r
  46 /*! \brief Stringize.\r
  47  *\r
  48  * Stringize a preprocessing token, this token being allowed to be \#defined.\r
  49  *\r
  50  * May be used only within macros with the token passed as an argument if the token is \#defined.\r
  51  *\r
  52  * For example, writing STRINGZ(PIN) within a macro \#defined by PIN_NAME(PIN)\r
  53  * and invoked as PIN_NAME(PIN0) with PIN0 \#defined as A0 is equivalent to\r
  54  * writing "A0".\r
  55  */\r
  56 #define STRINGZ(x)                                #x\r
  57 \r
  58 /*! \brief Absolute stringize.\r
  59  *\r
  60  * Stringize a preprocessing token, this token being allowed to be \#defined.\r
  61  *\r
  62  * No restriction of use if the token is \#defined.\r
  63  *\r
  64  * For example, writing ASTRINGZ(PIN0) anywhere with PIN0 \#defined as A0 is\r
  65  * equivalent to writing "A0".\r
  66  */\r
  67 #define ASTRINGZ(x)                               STRINGZ(x)\r
  68 \r
  69 \r
  70 #endif  // _STRINGZ_H_\r