MY-BASIC 项目教程

MY-BASIC 项目教程

my_basic A lightweight BASIC interpreter written in standard C in dual files. Aims to be embeddable, extendable and portable. 项目地址: https://gitcode.com/gh_mirrors/my/my_basic

1. 项目的目录结构及介绍

MY-BASIC 项目的目录结构如下：

my_basic/
├── core/
│   ├── my_basic.c
│   ├── my_basic.h
│   └── ...
├── shell/
│   ├── main.c
│   └── ...
├── github/
│   └── workflows/
├── output/
├── resource/
├── sample/
├── LICENSE
├── README.md
├── makefile
├── my_basic.sln
├── my_basic.vcproj
└── ...

目录结构介绍

• core/: 包含 MY-BASIC 解释器的核心代码文件 my_basic.c 和 my_basic.h，这些文件是解释器的核心实现。
• shell/: 包含解释器的启动文件 main.c，用于启动解释器的交互模式或执行脚本文件。
• github/workflows/: 包含 GitHub Actions 的工作流配置文件，用于自动化构建和测试。
• output/: 用于存放编译后的输出文件。
• resource/: 可能包含项目所需的资源文件。
• sample/: 包含示例代码文件，展示如何使用 MY-BASIC 编写脚本。
• LICENSE: 项目的开源许可证文件，采用 MIT 许可证。
• README.md: 项目的介绍文档，包含项目的概述、安装方法、使用说明等。
• makefile: 用于在 Linux 系统上编译项目的 Makefile 文件。
• my_basic.sln: 用于在 Windows 系统上使用 Visual Studio 编译项目的解决方案文件。
• my_basic.vcproj: 用于在 Windows 系统上使用 Visual Studio 编译项目的项目文件。

2. 项目的启动文件介绍

MY-BASIC 项目的启动文件位于 shell/main.c。该文件负责启动解释器的交互模式或执行脚本文件。

启动文件介绍

• main.c: 该文件是解释器的入口点，负责初始化解释器、加载脚本文件并执行。它支持三种运行模式：
  1. 交互模式: 直接运行 main.c 编译后的可执行文件，进入交互模式，用户可以在命令行中输入 BASIC 代码并立即执行。
  2. 脚本模式: 通过命令行参数传递一个脚本文件路径，解释器会加载并执行该脚本文件。
  3. 表达式模式: 通过命令行参数传递 -e 选项，后跟一个 BASIC 表达式，解释器会立即计算并输出结果。

3. 项目的配置文件介绍

MY-BASIC 项目没有传统的配置文件，但可以通过修改 core/my_basic.h 文件中的宏定义来定制解释器的行为。

配置文件介绍

• my_basic.h: 该文件包含解释器的配置宏定义，可以通过修改这些宏来定制解释器的行为，例如：
  • 内存分配器: 可以通过宏定义自定义内存分配器。
  • 输出重定向: 可以通过宏定义重定向 PRINT 和 INPUT 的输出和输入。
  • 数据类型定义: 可以通过宏定义自定义整数和浮点数的数据类型。

通过修改 my_basic.h 文件中的宏定义，可以灵活地定制 MY-BASIC 解释器的行为，以适应不同的应用场景。

my_basic A lightweight BASIC interpreter written in standard C in dual files. Aims to be embeddable, extendable and portable. 项目地址: https://gitcode.com/gh_mirrors/my/my_basic