begriffs open source - cmsis-freertos/blob - Demo/AVR32_UC3/UTILS/PREPROCESSOR/stringz.h

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