Special function/variable attribute macros.
More...
Detailed Description
This module contains macros for applying specific attributes to functions and variables to control various optimizer and code generation features of the compiler. Attributes may be placed in the function prototype or variable declaration in any order, and multiple attributes can be specified for a single item via a space separated list.
On incompatible versions of GCC or on other compilers, these macros evaluate to nothing unless they are critical to the code's function and thus must throw a compile error when used.
Define Documentation
#define ATTR_ALIAS |
( |
|
Func | ) |
__attribute__ ((alias( #Func ))) |
Marks a function as an alias for another function.
- Parameters:
-
[in] | Func | Name of the function which the given function name should alias. |
#define ATTR_ALIGNED |
( |
|
Bytes | ) |
__attribute__ ((aligned(Bytes))) |
Indicates the minimum alignment in bytes for a variable or struct element.
- Parameters:
-
[in] | Bytes | Minimum number of bytes the item should be aligned to. |
Forces the compiler to inline the specified function. When applied, the given function will be in-lined under all circumstances.
Indicates that the specified function is constant, in that it has no side effects other than parameter access.
Marks a given function as deprecated, which produces a warning if the function is called.
#define ATTR_INIT_SECTION |
( |
|
SectionIndex | ) |
__attribute__ ((used, naked, section (".init" #SectionIndex ))) |
Places the function in one of the initialization sections, which execute before the main function of the application. Refer to the avr-libc manual for more information on the initialization sections.
- Parameters:
-
[in] | SectionIndex | Initialization section number where the function should be placed. |
Removes any preamble or postamble from the function. When used, the function will not have any register or stack saving code. This should be used with caution, and when used the programmer is responsible for maintaining stack and register integrity.
Forces the compiler to not automatically zero the given global variable on startup, so that the current RAM contents is retained. Under most conditions this value will be random due to the behaviour of volatile memory once power is removed, but may be used in some specific circumstances, like the passing of values back after a system watchdog reset.
Prevents the compiler from considering a specified function for in-lining. When applied, the given function will not be in-lined under any circumstances.
Indicates to the compiler that the function can not ever return, so that any stack restoring or return code may be omitted by the compiler in the resulting binary.
Indicates that the specified parameters of the function are pointers which should never be NULL
. When applied as a 1-based comma separated list the compiler will emit a warning if the specified parameters are known at compiler time to be NULL
at the point of calling the function.
Marks a variable or struct element for packing into the smallest space available, omitting any alignment bytes usually added between fields to optimize field accesses.
Indicates that the specified function is pure, in that it has no side-effects other than global or parameter variable access.
Indicates that the function returns a value which should not be ignored by the user code. When applied, any ignored return value from calling the function will produce a compiler warning.
Marks a function as a weak reference, which can be overridden by other functions with an identical name (in which case the weak reference is discarded at link time).