Skip to content

Latest commit

 

History

History
132 lines (97 loc) · 5.76 KB

readme.markdown

File metadata and controls

132 lines (97 loc) · 5.76 KB

Fedjmike's C Compiler

Dependencies: C standard library, a POSIX cc for assembly and linking.

Features

The compiler implements a language quite similar to C, but there are some major differences. The following list is probably not exhaustive, but attempts to be.

  • Features added:
    • Lambdas
    • Simple module system
    • bool type, true and false are boolean literals
  • Different semantics:
    • Unified variable/typedef/struct/union/enum namespace
    • Logical operators (||, &&, and !) return bool
    • va_* are implemented as builtins, and including stdarg.h has no effect
    • The types usually defined by stdint.h are also builtins
    • Empty prototype parentheses means zero arguments (as in C++)
    • Operator precedence simplified
    • Ternary (?:) can return lvalues (as in C++)
    • Comma (,) can return a constant expression
    • Enums are always complete types and can be forward referenced
    • String literals are const char*
  • The features of C99 and C11 supported:
    • Anonymous structs/unions
    • Compound literals and designated initializers
    • Intermingled code/declarations including for-loop declarations
    • C++ comments
  • Features removed:
    • Preprocessor (treated as line comments)
    • switch
    • Bitfields
    • Implicit casts / coercion between integral types
    • goto and labels
  • No support for (yet?):
    • Floating point types
    • Unsigned integers
    • short and long
    • Wide characters
    • volatile qualifier
    • register storage class

The compiler is self hosting, on branch selfhosting (see Building). As the compiler matures experimental additions to the language considered are:

  • Type polymorphism as in ML/Haskell
  • Closures
  • Option types (option in ML, Maybe in Haskell)
  • Algebraic types (a more general solution to option types)

Extensions

[] (parameters, ...) {body}
[] (parameters, ...) (expression)

The syntax for lambdas is similar to that in C++. Closures are not implemented yet, so the opening square brackets must be empty.

A second form with parentheses instead of curly braces is also allowed. This takes a single expression which is the return value of the function.

In either case the result of the expression is a function pointer whose return type is inferred from any and all return expressions in the body. This differs from C++, where there is a special implementation defined type incompatible with normal functions.

See <fcc>/tests/lambda.c and swap.c.

Output

The compiler generates assembly for x86 (32-bit) CPUs. 64-bit AMD64 is experimental. The compiler does very little optimization before emitting straight to assembly.

To run the 32-bit code on a 64-bit OS, you will probably need to install 32-bit runtime libraries (try sudo apt-get install gcc-multilib).

The ABI is largely compatible GCC and Clang's. This means that most code compiled with one compiler can be successfully linked and run with code compiled with another. However, passing and returning structs as values will often not work, for reasons I'm not totally clear on.

Building

Building the compiler is simple, just call make in the root directory:

cd <fcc>
make CC=clang

This puts an fcc binary in <fcc>/bin/$CONFIG

Makefile parameters (all optional):

  • OS=[linux windows], default: linux
  • ARCH=[32 64], default: 32
  • CONFIG=[debug profiling release], default: release
  • CC=[path to C11 compiler], default: gcc
  • FCC=[path to FCC binary], default: bin/$CONFIG/fcc
  • VALGRIND, default: true (if Valgrind is found)

Makefile targets:

  • all clean print tests print-tests selfhost

The selfhost target fully compiles FCC using an existing copy, bin/$CONFIG/fcc. The result goes in bin/self/fcc. As the language accepted by the compiler differs slightly to C, only the selfhosting branch will compile under both FCC and a regular C compiler. The modifications required to be a polyglot are quite minimal, mostly just concerning the module system and explicit type coercion.

If found on the system the compiler will be run against Valgrind when building tests. To disable this, set VALGRIND="".

Use the FCC parameter to choose which copy of FCC to run the tests against. Simply specifying FCC=bin/self/fcc as a parameter for the tests-all target will trigger a self-host. Remember to do this only on the selfhosting branch.

Running

The command line interface is similar to that of a POSIX C compiler, such as GCC.

Usage: fcc [--help] [--version] [-csS] [-I <dir>] [-o <file>] <files...>

  • -I <dir> Add a directory to be searched for headers
  • -c Compile and assemble only, do not link
  • -S Compile only, do not assemble or link
  • -s Keep temporary assembly output after compilation
  • -o <file> Output into a specific file
  • --help Display command line information
  • --version Display version information

License

Unless otherwise stated, a source file in this package is under the GNU GPL V3 license.

Fedjmike's C Compiler Copyright (C) 2012-2015 Sam Nipps

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.