mirror of
https://github.com/TinyCC/tinycc.git
synced 2025-11-16 04:24:45 +00:00
- include/stddef.h, tcctest.c Revert "tests/tcctest.c: include stdint.h" This reverts commit8f23997ca7We don't want tcctest.c to rely on system include files - libtcc.c: Revert "libtcc.c: Remove unused defines free and realloc" To be unused is the point why they do exist This reverts commit2f88764100. - tcc.c: fix formatting of commite73529865d- tccpp.c: parse_include(): print skipped include files too (with tcc -vv[v] file) next_nomacro(): faster L"str" parsing - tccgen.c: fix c2y if declaration: * accept like GCC: if (int a = 0, b, c = x; c) * accept as "TCC extension": if (int a = 0, b, c = x) * "speak tcc" with symbol/function names - README: cleanup
94 lines
2.8 KiB
Plaintext
94 lines
2.8 KiB
Plaintext
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 machine code for i386, x86_64, arm, aarch64 or
|
|
riscv64. Compiles and links about 10 times faster than 'gcc -O0'.
|
|
|
|
- UNLIMITED! Any C dynamic library can be used directly. TCC is
|
|
heading toward 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 Linux, BSD variants or macOS hosts:
|
|
|
|
./configure
|
|
make
|
|
make test
|
|
make install
|
|
|
|
Notes: On BSD hosts, gmake should be used instead of make.
|
|
For Windows read tcc-win32.txt.
|
|
|
|
makeinfo must be installed to compile the doc. By default, tcc is
|
|
installed in /usr/local/bin. ./configure --help shows configuration
|
|
options.
|
|
|
|
|
|
2) 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.
|
|
|
|
3) 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 ! As for ex1.c, can also be launched
|
|
directly as a script: './ex4.c'.
|
|
|
|
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'.
|
|
|
|
4) Full Documentation
|
|
|
|
Please read tcc-doc.html to have all the features of TCC. Additional
|
|
information for the Windows port is in tcc-win32.txt.
|
|
|
|
License:
|
|
-------
|
|
|
|
TCC is distributed under the GNU Lesser General Public License (see
|
|
COPYING file).
|
|
|
|
Fabrice Bellard.
|