https://github.com/hirbodbehnam/cminusllvm

C-Minus Language with Flex/Bison and LLVM 15
https://github.com/hirbodbehnam/cminusllvm

bison compiler flex llvm

Last synced: 24 days ago
JSON representation

C-Minus Language with Flex/Bison and LLVM 15

• Host: GitHub
• URL: https://github.com/hirbodbehnam/cminusllvm
• Owner: HirbodBehnam
• License: mit
• Created: 2024-07-09T11:57:08.000Z (4 months ago)
• Default Branch: master
• Last Pushed: 2024-07-27T13:34:14.000Z (3 months ago)
• Last Synced: 2024-10-01T03:40:55.203Z (about 1 month ago)
• Topics: bison, compiler, flex, llvm
• Language: C++
• Homepage:
• Size: 2.11 MB
• Stars: 2
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.MD
  • License: LICENSE

Awesome Lists containing this project

README

        
# C Minus Compiler

C Minus is a very simple language which we implemented the frontend and IR generator of it in Python with a self made IR [here](https://github.com/bigwhoman/C-Minus-Compiler) for the project of compiler course in Sharif University of Technology, lectured by Dr. Ghasemsani. However, because the IR was a self made thing, we could only run it via an interpreter. Instead, I challenged myself to write the project in Flex/Bison/LLVM in order to learn them and have fun.

## Compiling

To compile this compiler, you need Flex, Bison and LLVM-15. You can get them all with the following command in Ubuntu/Debian:

```bash

apt install flex bison clang-15 llvm-15 build-essential g++-12

```

Note: You might also need g++-12 because llvm-15 uses it.

Then simply execute `make` command to build the compiler. The compiler will accept the input source filename as the first argument. This will cause the IR to be outputted in the stdout. If you want it to be outputted in a file, you can pass the output filename as the second argument.

The IR can be compiled with `clang-15 output.ll` command to an executable.

### Tests

Tests can be run via `make verify-all` command. If any of the tests fail, the testing will stop on that test. Otherwise, a green message that reads `All tests passed!` will appear. Tests are simply just an input program and an expected output that should be generated after the program is ran.

## Limitations

### Semantic Analyzer

Currently, the compiler does not have an semantic analyzer which means that most of errors are either not caught at all or result in an assertion failure that results in compiler aborting.

### Optimizer

Literally the amount of optimizations done for the IR is fucking zero. Even the constant folding is turned off. You can turn on the constant folding by changing `the_builder` initialization with this line:

```cpp

builder(std::make_unique>(*the_context))

```

## Language Specification

The language specification (the assignments) is placed in the `spec` folder.

Alongside the specification, there is also an addition: The `input()` function. This function will simply read an integer from stdin. For example, this program can be used to calculate the square of a number:

```c

int main(void){

	int a;

	a = input();

	output(a * a);

}

```