C3 is a C-like language striving to be an evolution of C, rather than a completely new language. As an alternative in the C/C++ niche it aims to be fast and close to the metal.
The manual for C3 can be found at www.c3-lang.org.
Thanks to full ABI compatibility with C, it's possible to mix C and C3 in the same project with no effort. As a demonstration, vkQuake was compiled with a small portion of the code converted to C3 and compiled with the c3c compiler. (The fork can be found at https://github.com/c3lang/vkQuake)
- Procedural "get things done"-type of language.
- Try to stay close to C - only change what's really necessary.
- C ABI compatibility and excellent C integration.
- Learning C3 should be easy for a C programmer.
- Data is inert.
- Avoid "big ideas" & the "more is better" fallacy.
- Introduce some higher level conveniences where the value is great.
C3 owes its inspiration to the C2 language: to iterate on top of C without trying to be a whole new language.
The following code shows generic modules (more examples can be found at http://www.c3-lang.org/examples/).
module stack <Type>;
// Above: the parameterized type is applied to the entire module.
struct Stack
{
usize capacity;
usize size;
Type* elems;
}
// The type methods offers dot syntax calls,
// so this function can either be called
// Stack.push(&my_stack, ...) or
// my_stack.push(...)
fn void Stack.push(Stack* this, Type element)
{
if (this.capacity == this.size)
{
this.capacity *= 2;
this.elems = mem::realloc(this.elems, Type.sizeof * this.capacity);
}
this.elems[this.size++] = element;
}
fn Type Stack.pop(Stack* this)
{
assert(this.size > 0);
return this.elems[--this.size];
}
fn bool Stack.empty(Stack* this)
{
return !this.size;
}
Testing it out:
import stack;
// Define our new types, the first will implicitly create
// a complete copy of the entire Stack module with "Type" set to "int"
define IntStack = Stack<int>;
// The second creates another copy with "Type" set to "double"
define DoubleStack = Stack<double>;
// If we had added "define IntStack2 = Stack<int>"
// no additional copy would have been made (since we already
// have an parameterization of Stack<int>) so it would
// be same as declaring IntStack2 an alias of IntStack
// Importing an external C function is straightforward
// here is an example of importing libc's printf:
extern fn int printf(char* format, ...);
fn void test()
{
IntStack stack;
// Note that C3 uses zero initialization by default
// so the above is equivalent to IntStack stack = {};
stack.push(1);
// The above can also be written IntStack.push(&stack, 1);
stack.push(2);
// Prints pop: 2
printf("pop: %d\n", stack.pop());
// Prints pop: 1
printf("pop: %d\n", stack.pop());
DoubleStack dstack;
dstack.push(2.3);
dstack.push(3.141);
dstack.push(1.1235);
// Prints pop: 1.1235
printf("pop: %f\n", dstack.pop());
}
- No mandatory header files
- New semantic macro system
- Module based name spacing
- Subarrays (slices)
- Compile time reflection
- Enhanced compile time execution
- Generics based on generic modules
- "Result"-based zero overhead error handling
- Defer
- Value methods
- Associated enum data
- No preprocessor
- Less undefined behaviour and runtime checks in "safe" mode
- Limited operator overloading to enable userland dynamic arrays
- Optional pre and post conditions
The current version of the compiler is alpha release 0.3.
It's possible to try out the current C3 compiler in the browser: https://ide.judge0.com/ – this is courtesy of the developer of Judge0.
Design work on C3 complete aside from fleshing out details, such as inline asm. As the standard library work progresses, changes and improvements to the language will happen continuously. Follow the issues here.
If you have suggestions on how to improve the language, either file an issue or discuss C3 on its dedicated Discord: https://discord.gg/qN76R87.
The compiler is currently verified to compile on Linux, Windows and MacOS.
- If you wish to contribute with ideas, please file issues or discuss on Discord.
- Interested in contributing to the stdlib? Please get in touch on Discord.
- Compilation instructions for other Linux and Unix variants are appreciated.
- Would you like to contribute bindings to some library? It would be nice to have support for SDL, Raylib and more.
- Build something with C3 and show it off and give feedback. The language is still open for significant tweaks.
- Start work on the C -> C3 converter which takes C code and does a "best effort" to translate it to C3. The first version only needs to work on C headers.
- Do you have some specific area you have deep knowledge of and could help make C3 even better at doing? File or comment on issues.
- Make sure you have Visual Studio 17 2022 installed or alternatively install the "Buildtools for Visual Studio" (https://aka.ms/vs/17/release/vs_BuildTools.exe) and then select "Desktop development with C++" (there is also
c3c/resources/install_win_reqs.bat
to automate this) - Download the zip file: https://github.com/c3lang/c3c/releases/download/latest/c3-windows.zip (debug version here)
- Unzip exe and standard lib.
- Run
c3c.exe
.
- Download tar file: https://github.com/c3lang/c3c/releases/download/latest/c3-linux.tar.gz (debug version here)
- Unpack executable and standard lib.
- Run
./c3c
.
- Make sure you have XCode with command line tools installed.
- Download the zip file: https://github.com/c3lang/c3c/releases/download/latest/c3-macos.zip (debug version here)
- Unzip executable and standard lib.
- Run
./c3c
.
There is an AUR package for the c3c compiler : c3c-git
You can use your AUR package manager or clone it manually:
git clone https://aur.archlinux.org/c3c-git.git
cd c3c-git
makepkg -si
You can build c3c
using either an Ubuntu 18.04 or 20.04 container:
./build-with-docker.sh 18
Replace 18
with 20
to build through Ubuntu 20.04.
For a release build specify:
./build-with-docker.sh 20 Release
A c3c
executable will be found under bin/
.
- Install CMake:
brew install cmake
- Install LLVM 13:
brew install llvm
- Clone the C3C github repository:
git clone https://github.com/c3lang/c3c.git
- Enter the C3C directory
cd c3c
. - Create a build directory
mkdir build
- Change directory to the build directory
cd build
- Set up CMake build for debug:
cmake ..
- Build:
cmake --build .
Create a main.c3
file with:
module hello_world;
import std::io;
fn void main()
{
io::println("Hello, world!");
}
Make sure you have the standard libraries at either ../lib/std/
or /lib/std/
.
Then run
c3c compile main.c3
The generated binary will by default be named after the module that contains the main
function. In our case that is hello_world
, so the resulting binary will be
called hello_world
or hello_world.exe
depending on platform.
- Make sure you have Visual Studio 17 2022 installed or alternatively install the "Buildtools for Visual Studio" (https://aka.ms/vs/17/release/vs_BuildTools.exe) and then select "Desktop development with C++" (there is also
c3c/resources/install_win_reqs.bat
to automate this) - Install CMake
- Clone the C3C github repository:
git clone https://github.com/c3lang/c3c.git
- Enter the C3C directory
cd c3c
. - Set up the CMake build
cmake -B build -G "Visual Studio 17 2022" -A x64 -DCMAKE_BUILD_TYPE=Release
- Build:
cmake --build build --config Release
- You should now have the c3c.exe
You should now have a c3c
executable.
You can try it out by running some sample code: c3c.exe compile ../resources/examples/hash.c3
Note that if you run into linking issues when building, make sure that you are using the latest version of VS17.
- Make sure you have a C compiler that handles C11 and a C++ compiler, such as GCC or Clang. Git also needs to be installed.
- Install CMake:
sudo apt install cmake
- Install LLVM 13 (or greater: C3C supports LLVM 13-16):
sudo apt-get install clang-13 zlib1g zlib1g-dev libllvm13 llvm-13 llvm-13-dev llvm-13-runtime liblld-13-dev liblld-13
- Clone the C3C github repository:
git clone https://github.com/c3lang/c3c.git
- Enter the C3C directory
cd c3c
. - Create a build directory
mkdir build
- Change directory to the build directory
cd build
- Set up CMake build:
cmake ..
- Build:
cmake --build .
You should now have a c3c
executable.
You can try it out by running some sample code: ./c3c compile ../resources/examples/hash.c3
- Install CMake.
- Install or compile LLVM and LLD libraries (version 13+ or higher)
- Clone the C3C github repository:
git clone https://github.com/c3lang/c3c.git
- Enter the C3C directory
cd c3c
. - Create a build directory
mkdir build
- Change directory to the build directory
cd build
- Set up CMake build for debug:
cmake ..
. At this point you may need to manually provide the link path to the LLVM CMake directories, e.g.cmake -DLLVM_DIR=/usr/local/opt/llvm/lib/cmake/llvm/ ..
- Build:
cmake --build .
The C3 compiler is licensed under LGPL 3.0, the standard library itself is MIT licensed.
Editor plugins can be found at https://github.com/c3lang/editor-plugins.