RealView Compilation Tools - ARM Information Center

Compiler-specific Features
See also
• __value_in_regs on page 5-13 in the Compiler User Guide.
4.1.19 __weak
This keyword instructs the compiler to export symbols weakly.
The __weak keyword can be applied to function and variable declarations, and to
function definitions.
Usage
Functions and variable declarations
For declarations, this storage class specifies an extern object declaration
that, even if not present, does not cause the linker to fault an unresolved
reference.
For example:
__weak void f(void);
...
f(); // call f weakly
If the reference to a missing weak function is made from code that
compiles to a branch or branch link instruction, then either:
• The reference is resolved as branching to the next instruction. This
effectively makes the branch a NOP.
• The branch is replaced by a NOP instruction.
Function definitions
Functions defined with __weak export their symbols weakly. A weakly
defined function behaves like a normally defined function unless a non
weakly defined function of the same name is linked into the same image.
If both a non weakly defined function and a weakly defined function exist
in the same image then all calls to the function resolve to call the non
weak function. If multiple weak definitions are available, the linker
chooses one for use by all calls.
Functions declared with __weak and then defined without __weak behave
as non weak functions.
ARM DUI 0348C Copyright © 2007-2010 ARM. All rights reserved. 4-21
ID101213
Non-Confidential,