# lcc

**Repository Path**: welightyear/lcc

## Basic Information

- **Project Name**: lcc
- **Description**: No description available
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-05
- **Last Updated**: 2025-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# lcc: A Based Of LLVM C Compiler

This is the source code Tutorial. Lcc is based llvm c99 compiler. You can click [this][1] to visit my video and this compiler tutorial.

This project will implement almost all ISO C99 syntax and can work on Windows, Linux and Mac OS X.

ISO C 99 Doc link (pdf file): [C99](https://www.open-std.org/jtc1/sc22/wg14/www/docs/n1256.pdf)

## Current Status: 

|  Module     | Status     |     
|  ----       |------------|   
| Preprocess  | working... |   
| Lexer       | 100%       |      
| Parser      | 100%       |       
| Semantics   | 5%         |       
| CodeGen     | working... |    

## Test Status:

catch2 will be integrated in the future


## Compile and Run

### Install the latest LLVM library or Build LLVM manually

一：Install the latest LLVM library

```   
Mac:
----------------------
1, install homebrew 
reference: https://brew.sh/
or reference: https://brew.idayer.com/

2, brew install llvm

Linux:
----------------------
1, sudo apt-get update
2, sudo apt-get -y install llvm-12

Windows:
----------------------
reference:  https://blog.csdn.net/kingfox/article/details/117450533
```

二：Build LLVM manually

```
git clone https://github.com/llvm/llvm-project.git
cd llvm-project/llvm  && mkdir llvm_install_dir && mkdir build
cd build
cmake -GNinja -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=../llvm_install_dir ../llvm
```


### How to use lcc

一：Compile

```
1, git clone git@github.com:iiicp/lcc.git
2, cd lcc && mkdir build && cd build 
3, cmake -GNinja -DLLVM_DIR="Path to Your LLVM CMake dir" ..
4, ninja 
```

二：Run

lcc support --dumpTokens and --dumpAst command line options
```  
./lcc --help
./lcc -emit-tokens ../tests/c/stmt.c
./lcc -emit-ast ../tests/c/stmt.c 
```

## lcc unsupported c99 language features

1. unicode char     
2. _Complex      
3. direct-declarator ( identifier-list{opt} )     
eg: int f(a, b) int a,b {return a+b;}


## Reference   

- [cld](https://github.com/zero9178/cld)        
- [chibicc](https://github.com/rui314/chibicc)        
- [ucc](https://github.com/sheisc/ucc162.3)   

[1]: https://space.bilibili.com/181099947