Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alvarorichard/cortexc
Interpreter is a minimalist yet powerful tool designed to interpret and execute a subset of the C programming language.
https://github.com/alvarorichard/cortexc
binary c education evaluation intepreter interpreter open-source parsing programming-language tokenization zig
Last synced: about 2 months ago
JSON representation
Interpreter is a minimalist yet powerful tool designed to interpret and execute a subset of the C programming language.
- Host: GitHub
- URL: https://github.com/alvarorichard/cortexc
- Owner: alvarorichard
- License: mit
- Created: 2023-07-19T03:01:10.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-03T04:05:33.000Z (11 months ago)
- Last Synced: 2024-05-11T05:45:44.487Z (9 months ago)
- Topics: binary, c, education, evaluation, intepreter, interpreter, open-source, parsing, programming-language, tokenization, zig
- Language: C
- Homepage:
- Size: 23.2 MB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Simple C Interpreter
[](alvarorichard/CortexC/blob/master/LICENSE)
[](https://github.com/alvarorichard/CortexC/graphs/contributors)
[](https://github.com/alvarorichard/CortexC/actions)
[](https://github.com/alvarorichard/CortexC/commit/main)
This repository contains a simple interpreter for a subset of the C language, written in C itself. It includes a tokenizer, a parser, and an evaluator for assembly instructions. The interpreter is capable of interpreting and running simple C programs, but it does not support all features of the C language.
## Overview
The interpreter is divided into several parts:
* Definitions and Enumerations: The code starts with the definition of several constants and structures that are used throughout the program. It also defines a number of enumerations that represent different types of tokens that can be encountered in the input code.
* Tokenization: The next() function is responsible for tokenizing the input code. It reads characters from the input and classifies them into different types of tokens.
* Expression Parsing: The expr() and factor() functions are used for parsing expressions in the input code. However, these functions are not fully implemented in the provided code.
* Program Parsing: The program() function is responsible for parsing the entire program. It repeatedly calls the next() function to get tokens and processes them accordingly.
* Evaluation: The eval() function is an interpreter for the assembly instructions. It reads and executes the instructions one by one.
* Main Function: The main() function is the entry point of the program. It initializes the necessary data structures, reads the input code from a file, calls the program() function to parse the code, and finally calls the eval() function to execute the parsed code.
## How to use the interpreter
To use the interpreter, you need to have a C compiler installed on your system. You can compile the interpreter itself using the following command:
Clone this repository and compile the interpreter using the following command:
```bash
git clone https://github.com/alvarorichard/CortexC.git
```
Navigate to the directory containing the source code:
```bash
cd CortexC
```
Compile the source code using the following command:
```bash
clang main.c -lfunction_parameter -o main
```
Then, you can use the compiled interpreter to interpret and run a C program as follows:
```bash
zig build
```
Please note that the interpreter is quite simple and may not support all features of the C language. Also, the code seems to be incomplete and may not work correctly as is. For example, the expr() and factor() functions are not fully implemented.
## Contributing
Contributions are welcome! If you find a bug or want to add a new feature, feel free to create a pull request.