User manual

MPLAB
®
XC8 C Compiler User’s Guide
DS52053B-page 508  2012 Microchip Technology Inc.
#asm directive ........................................................ 202
#define directive ....................................................... 94
#endasm directive.................................................. 202
#include directive ........................................74
, 95, 114
#pragma
addrqual.......................................................... 215
inline................................................................215
interrupt_level ................................................. 215
intrinsic............................................................ 215
printf_check..................................................... 216
psect ............................................................... 216
regsused ......................................................... 219
switch.............................................................. 219
#undef directive........................................................ 98
% macro argument prefix ....................................... 262
% message format placeholder character................ 88
%%u psect pragma placeholder............................. 216
- suboption ............................................................... 91
+ suboption............................................................... 91
<> macro argument characters ...................... 249
, 262
$ assembly label character..................................... 251
$ location counter symbol....................................... 251
Numerics
0b binary radix specifier ......................................... 158
A
abs function............................................................ 317
abs PSECT flag.............................................. 206
, 256
ABS1 class............................................................. 237
absolute functions .....................................25, 184, 218
absolute object files................................................ 281
absolute psects .......................................206, 256, 258
absolute variables ............. 25
, 137, 174, 175–176, 261
acos function ..........................................................318
activation, see compiler installation & activation
addressable unit, see delta PSECT flag
addrqual pragma directive...................................... 215
advisory messages........................................... 87
, 107
alignment
of HEX file records .......................................... 113
of psects, see reloc PSECT flag
all suboption ............................................................. 91
anonymous unions................................................. 151
ANSI C standard ...................................................... 14
conformance ........................................... 115
, 131
divergence ...................................................... 131
implementation-defined behaviour...131, 479–486
arrays ..................................................................... 167
and pointer sizes............................................. 153
as dummy pointer targets ............................... 156
maximum size of............................................. 167
ASCII characters ............................................ 144
, 249
extended ......................................................... 160
asctime function ..................................................... 319
asin function ........................................................... 319
asm C statement .............................................. 38, 202
ASMOPT control .................................................... 266
aspic.h header file.................................................. 205
assembler application..................................... 241
–268
disabling messages ........................................ 244
maximum number of errors .............................245
usage ..............................................................241
assembler controls ......................................... 265–267
assembler directives....................................... 254
–265
assembler macros.................................................. 262
disabling in listing............................................267
expanding in listings................................ 243
, 266
repeat with argument ......................................264
repeating .........................................................263
suppressing comments ...................................262
unnamed ......................................................... 263
assembler optimizations.........................................268
assembler optimizer
and list files .....................................................269
enabling........................................... 108
, 243, 266
selectively disabling ........................................266
stack depth considerations..............................274
assembler options .......................................... 242
–245
assembler-generated symbols ...............................251
assembly code
called by C ......................................................200
generating from C .............................................98
interaction with C.............................................203
mixing with C....................................... 53
, 54, 200
optimizations ...................................................108
preprocessing............................................ 97
, 210
stack overflow ...................................................69
writing.......................................................... 53–55
assembly constants................................................ 250
assembly files................................................... 73, 200
assembly language
absolute variables ........................................... 261
accessing C objects ........................................204
character set ...................................................249
comments........................................................249
common errors ............................................ 55
, 70
conditional.......................................................261
data types........................................................251
delimiters......................................................... 249
differences in...................................................246
expressions .....................................................253
include files .....................................................266
initializing locations .........................................260
label scope.............................................. 253
, 255
labels....................................................... 249
, 252
line numbers....................................................244
location counter...............................................251
operators......................................................... 253
pseudo-ops .....................................................254
registers ............................................ 55
, 205, 252
relative jumps..................................................251
repeating instructions......................................263
reserving memory ................................... 206
, 261
statement formats ...........................................249
strings..............................................................250
volatile objects.................................................250
assembly list files .................. 64, 85, 99, 243, 269–275
blank lines .......................................................267
content ............................................................269
excluding conditional code..............................267