Skip to content

Latest commit

 

History

History
131 lines (82 loc) · 3.31 KB

README.md

File metadata and controls

131 lines (82 loc) · 3.31 KB
Raw

TCC

Tiny C Compiler - C Scripting Everywhere - The Smallest ANSI C compiler

Features:

  • SMALL! You can compile and execute C code everywhere, for example on rescue disks.

  • FAST! tcc generates optimized x86 code. No byte code overhead. Compile, assemble and link about 7 times faster than 'gcc -O0'.

  • UNLIMITED! Any C dynamic library can be used directly. TCC is heading torward full ISOC99 compliance. TCC can of course compile itself.

  • SAFE! tcc includes an optional memory and bound checker. Bound checked code can be mixed freely with standard code.

  • Compile and execute C source directly. No linking or assembly necessary. Full C preprocessor included.

  • C script supported : just add '#!/usr/local/bin/tcc -run' at the first line of your C source, and execute it directly from the command line.

Documentation:

  1. Installation on a i386 Linux host (for Windows read tcc-win32.txt)

    ./configure && make && make test && make install

By default, tcc is installed in /usr/local/bin. ./configure --help shows configuration options.

  1. Introduction

We assume here that you know ANSI C. Look at the example ex1.c to know what the programs look like.

The include file <tcclib.h> can be used if you want a small basic libc include support (especially useful for floppy disks). Of course, you can also use standard headers, although they are slower to compile.

You can begin your C script with '#!/usr/local/bin/tcc -run' on the first line and set its execute bits (chmod a+x your_script). Then, you can launch the C code as a shell or perl script :-) The command line arguments are put in 'argc' and 'argv' of the main functions, as in ANSI C.

  1. Examples

ex1.c: simplest example (hello world). Can also be launched directly as a script: './ex1.c'.

ex2.c: more complicated example: find a number with the four operations given a list of numbers (benchmark).

ex3.c: compute fibonacci numbers (benchmark).

ex4.c: more complicated: X11 program. Very complicated test in fact because standard headers are being used !

ex5.c: 'hello world' with standard glibc headers.

tcc.c: TCC can of course compile itself. Used to check the code generator.

tcctest.c: auto test for TCC which tests many subtle possible bugs. Used when doing 'make test'.

  1. Full Documentation

Please read tcc-doc.html to have all the features of TCC.

Additional information is available for the Windows port in tcc-win32.txt.

License:

TCC is distributed under the GNU Lesser General Public License (see COPYING file).

Fabrice Bellard. Links

TinyCC mailing list

Savannah project page and git repository

OTCC - The smallest self compiling pseudo C compiler

FFASN1 - My small but powerful ASN.1 compiler.

TinyCC fork by Rob Landley

LLVM Compiler Infrastructure

SmartEiffel - With TCC you can compile your Eiffel code faster

C-- - An intermediate language for compilers

The GNU C Compiler

The LCC Compiler

The Small Device C Compiler

Cyclone, A Safe Dialect of C

The D language

Programming in C

The Scriptometer evaluates various scripting languages (including TCC).

License

TCC is distributed under the GNU Lesser General Public License.

Copyright (c) 2001-2009 Fabrice Bellard Fabrice Bellard - http://bellard.org/ - http://www.tinycc.org/