4 * \brief Preprocessor stringizing utils.
\r
6 * Copyright (c) 2010-2012 Atmel Corporation. All rights reserved.
\r
12 * Redistribution and use in source and binary forms, with or without
\r
13 * modification, are permitted provided that the following conditions are met:
\r
15 * 1. Redistributions of source code must retain the above copyright notice,
\r
16 * this list of conditions and the following disclaimer.
\r
18 * 2. Redistributions in binary form must reproduce the above copyright notice,
\r
19 * this list of conditions and the following disclaimer in the documentation
\r
20 * and/or other materials provided with the distribution.
\r
22 * 3. The name of Atmel may not be used to endorse or promote products derived
\r
23 * from this software without specific prior written permission.
\r
25 * 4. This software may only be redistributed and used in connection with an
\r
26 * Atmel microcontroller product.
\r
28 * THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR IMPLIED
\r
29 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
\r
30 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE
\r
31 * EXPRESSLY AND SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR
\r
32 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
\r
33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
\r
34 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
\r
35 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
\r
36 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
\r
37 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
\r
38 * POSSIBILITY OF SUCH DAMAGE.
\r
48 * \defgroup group_sam_utils_stringz Preprocessor - Stringize
\r
50 * \ingroup group_sam_utils
\r
55 /*! \brief Stringize.
\r
57 * Stringize a preprocessing token, this token being allowed to be \#defined.
\r
59 * May be used only within macros with the token passed as an argument if the token is \#defined.
\r
61 * For example, writing STRINGZ(PIN) within a macro \#defined by PIN_NAME(PIN)
\r
62 * and invoked as PIN_NAME(PIN0) with PIN0 \#defined as A0 is equivalent to
\r
65 #define STRINGZ(x) #x
\r
67 /*! \brief Absolute stringize.
\r
69 * Stringize a preprocessing token, this token being allowed to be \#defined.
\r
71 * No restriction of use if the token is \#defined.
\r
73 * For example, writing ASTRINGZ(PIN0) anywhere with PIN0 \#defined as A0 is
\r
74 * equivalent to writing "A0".
\r
76 #define ASTRINGZ(x) STRINGZ(x)
\r
82 #endif // _STRINGZ_H_
\r