User manual

MPLAB
®
XC8 C Compiler User’s Guide
DS52053B-page 516  2012 Microchip Technology Inc.
read-modify-write problems...................................... 69
read-only variables................................................. 161
REAL ICE debugger............................................... 142
REALICE, see debuggers
rebuilding projects.................................................... 79
reentrant functions ......................................... 169
, 192
registers
allocation to..................................................... 178
in assembly code ............................................ 252
special function ............................................... 252
used by functions...................................... 65
, 181
registry ..................................................................... 73
regsused pragma directive..................................... 219
relative jump........................................................... 251
reloc PSECT flag............................................ 231, 258
relocatable object files............................................ 285
replacing library modules ....................................... 237
REPT directive ....................................................... 263
reserving memory..............................65
, 101, 111, 112
reset ....................................................................... 162
code executed after .....................57, 83, 194, 197
determining cause........................................... 197
vector .............................................................. 101
reset_vec label....................................................... 194
reset_vec psect ...................................................... 234
reset_wrap psect.................................................... 234
RETLW instruction ................................................. 173
return values, see function, return values
rotate operator.................................................. 59
, 180
round function ........................................................ 356
runtime environment............................................... 112
runtime startup code .........................82
, 194, 233, 285
assembly listing................................................. 99
preserving variables........................................ 162
variable initialization........................................ 195
runtime startup module........................................... 113
S
safeguarding code............................................ 58, 114
scale value ............................................................. 256
search path, see header files
sections, see psects
segment selector.................................................... 280
serial numbers................................................ 114
, 310
embedding ...................................................... 310
SET directive.................................................. 249
, 259
setjmp function....................................................... 357
SFRs ...................................................................... 137
accessing in assembly.................................... 205
accessing in inline assembly........................... 206
SFRx class ............................................................. 237
shadow registers.................................................... 191
shift operator .......................................................... 481
short int types......................................................... 143
sign bit.................................................................... 146
SIGNAT directive.....................................201
, 238, 265
signatures....................................................... 238
, 265
silicon errata........................................................... 103
sin function ............................................................. 357
single step compilation....................................... 77
, 78
sinh function ........................................................... 327
size limits..................................................................63
auto variables..................................................172
const variables ................................................174
non-auto variables...........................................167
size of types ........................................... 102
, 143, 147
size PSECT flag .....................................................258
SLEEP macro.........................................................358
smallconst psect.....................................................234
software stack ........................................................134
source files ...............................................................74
source-level debugging .......................................... 300
sources directory.................................................... 197
SPACE control .......................................................267
space PSECT flag..................................................258
special function registers, see SFRs
special type qualifiers.............................................162
sports cars.............................................................. 251
sprintf function........................................................358
sqrt function............................................................359
srand function.........................................................360
sscanf function ....................................................... 360
stack.......................................................................134
depth ............................................................... 274
hardware .........................................................169
overflow..................................................... 69
, 134
standard library files
start label........................................................ 194, 197
start record .............................................................255
start_initialization....................................................194
startup module.................................................. 82
, 113
startup.as, see startup module
static functions................................................ 182
, 204
static variables........................................ 167
, 195, 204
STATUS register, preserving .................................197
STD mode, see compiler operating mode
storage duration .....................................................165
STRCODE class.....................................................236
string (strxxx) functions .................................. 361
–371
STRING class......................................................... 236
string literals ...........................................................160
assembly......................................................... 250
concatenation..................................................160
packing............................................................311
storage location....................................... 160
, 311
type of .............................................................160
strings psect ...........................................................234
stringtext psect .......................................................235
struct types, see structures
structure bit-fields...................................................150
structure qualifiers..................................................149
structures................................................................149
bit-fields in................................................. 51
, 150
maximum size of .............................................167
SUBTITLE control ..................................................267
supported devices, see device, support
switch pragma directive..........................................219
switch statement.....................................................219
switch statements................................................... 180
symbol files........................................95
, 280, 283, 300
symbol tables ......................................................... 283