SW006015 Microchip Technology, SW006015 Datasheet - Page 16

• Manufacturer Part Number: SW006015
• Description: C COMPILER MPLAB C32
• Manufacturer: Microchip Technology
• Type: Compilerr
• Series: PIC32r

Specifications of SW006015

• Supported Families: PIC32MX5, MX6, And MX7
• Core Architecture: PIC
• Kit Contents: Software And Docs
• Mcu Supported Families: PIC32 MCUs
• Tool Function: Compiler
• Supported Devices: PIC32 MCUs
• Tool Type: Compiler
• Processor Series: PIC32
• Lead Free Status / RoHS Status: Not applicable / Not applicable
• For Use With/related Products: PIC32
• Lead Free Status / Rohs Status: Lead free / RoHS Compliant

MPLAB
C32 C Compiler User’s Guide
®
at_vector
Place the body of the function at the indicated exception vector address. See Chapter
3. “Interrupts” and Section 3.5 “Exception Handlers”.
naked
Generate no prologue or epilogue code for the function.
section (“name”)
Place the function into the named section.
For example,
void __attribute__ ((section (“.wilma”))) baz () {return;}
Function baz will be placed in section .wilma.
The -ffunction-sections command line option has no effect on functions defined
with a section attribute.
unique_section
Place the function in a uniquely named section, just as if -ffunction-sections had
been specified. If the function also has a section attribute, use that section name as
the prefix for generating the unique section name.
For example,
void __attribute__ ((section (“.fred”), unique_section) foo (void) {return;}
Function foo will be placed in section .fred.foo.
noreturn
Indicate to the compiler that the function will never return. In some situations, this can
allow the compiler to generate more efficient code in the calling function since
optimizations can be performed without regard to behavior if the function ever did
return. Functions declared as noreturn should always have a return type of void.
noinline
The function will never be considered for inlining.
pure
If a function has no side effects other than its return value, and the return value is
dependent only on parameters and/or (nonvolatile) global variables, the compiler can
perform more aggressive optimizations around invocations of that function. Such
functions can be indicated with the pure attribute.
const
If a pure function determines its return value exclusively from its parameters (i.e., does
not examine any global variables), it may be declared const, allowing for even more
aggressive optimization. Note that a function which de-references a pointer argument
is not const since the pointer de-reference uses a value which is not an parameter,
even though the pointer itself is a parameter.
format (type, format_index, first_to_check)
The format attribute indicates that the function takes a printf, scanf, strftime,
or strfmon style format string and arguments and that the compiler should type check
those arguments against the format string, just as it does for the standard library
functions.
The type parameter is one of printf, scanf, strftime or strfmon (optionally with
surrounding double underscores, e.g., __printf__) and determines how the format
string will be interpreted.
The format_index parameter specifies which function parameter is the format string.
Function parameters are numbered from the left-most parameter, starting from 1.
© 2007 Microchip Technology Inc.
DS51686A-page 12