1 /*This file is prepared for Doxygen automatic documentation generation.*/
\r
2 /*! \file *********************************************************************
\r
4 * \brief Preprocessor stringizing utils.
\r
6 * - Compiler: IAR EWAVR32 and GNU GCC for AVR32
\r
7 * - Supported devices: All AVR32 devices can be used.
\r
9 * \author Atmel Corporation: http://www.atmel.com \n
\r
10 * Support and FAQ: http://support.atmel.no/
\r
12 ******************************************************************************/
\r
14 /* Copyright (c) 2007, Atmel Corporation All rights reserved.
\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
19 * 1. Redistributions of source code must retain the above copyright notice,
\r
20 * this list of conditions and the following disclaimer.
\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
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
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
46 /*! \brief Stringize.
\r
48 * Stringize a preprocessing token, this token being allowed to be \#defined.
\r
50 * May be used only within macros with the token passed as an argument if the token is \#defined.
\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
56 #define STRINGZ(x) #x
\r
58 /*! \brief Absolute stringize.
\r
60 * Stringize a preprocessing token, this token being allowed to be \#defined.
\r
62 * No restriction of use if the token is \#defined.
\r
64 * For example, writing ASTRINGZ(PIN0) anywhere with PIN0 \#defined as A0 is
\r
65 * equivalent to writing "A0".
\r
67 #define ASTRINGZ(x) STRINGZ(x)
\r
70 #endif // _STRINGZ_H_
\r