User manual

 2012 Microchip Technology Inc. DS52053B-page 3
MPLAB
®
XC8 C COMPILER
USER’S GUIDE
Table of Contents
Preface ........................................................................................................................... 7
Chapter 1. Compiler Overview
1.1 Introduction ................................................................................................... 11
1.2 Compiler Description and Documentation .................................................... 11
1.3 Device Description ....................................................................................... 12
Chapter 2. Common C Interface
2.1 Introduction ................................................................................................... 13
2.2 Background – The Desire for Portable Code ............................................... 13
2.3 Using the CCI ............................................................................................... 16
2.4 ANSI Standard Refinement .......................................................................... 17
2.5 ANSI Standard Extensions ........................................................................... 25
2.6 Compiler Features ........................................................................................ 39
Chapter 3. How To’s
3.1 Introduction ................................................................................................... 41
3.2 Installing and Activating the Compiler .......................................................... 41
3.3 Invoking the Compiler ................................................................................... 43
3.4 Writing Source Code .................................................................................... 46
3.5 Getting My Application to Do What I Want ................................................... 56
3.6 Understanding the Compilation Process ...................................................... 60
3.7 Fixing Code That Does Not Work ................................................................. 67
Chapter 4. XC8 Command-line Driver
4.1 Introduction ................................................................................................... 71
4.2 Invoking the Compiler ................................................................................... 72
4.3 The Compilation Sequence .......................................................................... 75
4.4 Runtime Files ............................................................................................... 81
4.5 Compiler Output ........................................................................................... 84
4.6 Compiler Messages ...................................................................................... 86
4.7 XC8 Driver Options ...................................................................................... 91
4.8 Option Descriptions ...................................................................................... 92
4.9 MPLAB IDE V8 Universal Toolsuite Equivalents ........................................ 117
4.10 MPLAB X Universal Toolsuite Equivalents ............................................... 124
Chapter 5. C Language Features
5.1 Introduction ................................................................................................. 131
5.2 ANSI C Standard Issues ............................................................................ 131
5.3 Device-Related Features ............................................................................ 133
5.4 Supported Data Types and Variables ........................................................ 143
5.5 Memory Allocation and Access .................................................................. 165