添加项目简介

Author: DawnNights

README.md

@@ -1,2 +1,222 @@
+
 # MyScript
-An interpreter written in v.
+
+`MyScript`是一门基于[`V`](https://github.com/vlang/v)语言实现的脚本语言。
+
+该项目并不具备实用价值，只是本菜鸟处出于兴趣对编译原理基础知识的一些实践，特性尚未完善，bug多的飞起，需要很多时间慢慢打磨。以下是`MyScript`内容的介绍：
+
+## 基本类型
+
+`MyScript`是一门动态类型，脚本型语言，以下是内置的基本类型：
+
+### bool 布尔类型
+- `bool`类型的值只能是`true`或`false`，表示逻辑上的真与假。
+- 示例:
+  ```v
+  i_love_you 	= true;
+  you_love_me = false;
+  ```
+
+### int 整数类型
+- `int`类型表示有符号64位整数。
+
+- 示例:
+  ```v
+  age = 25;
+  count = -42;
+  ```
+
+### float 小数类型
+- `float`类型表示64位浮点数。
+
+- 示例:
+  ```v
+  height = 5.9;
+  weight = -70.5;
+  ```
+
+### range 范围类型
+- `range`类型表示一段连续的数值范围。
+- 例如：`0..9`表示从0到8（包含0但不包含9）的整数范围。
+- 示例:
+  ```v
+  range1 = 0..5;  	# 表示 0, 1, 2, 3, 4
+  range2 = -3..3;  # 表示 -3, -2, -1, 0, 1, 2
+  ```
+
+### char 字符类型
+
+- 字符对象由一对反引号表示，反引号内有且只有一个Unicode字符。
+
+- 示例:
+
+  ```v
+  letter 	= `A`;
+  digit 	= `5`;
+  chinese = `爱`;
+  ```
+
+### string 字符串类型
+
+- 字符串对象由一对双引号或单引号表示，采用UTF-8编码。
+
+- 字符串中的每个字符都有对应的位置值，称为索引，索引从0开始。
+
+- 字符串的索引也可以是`range`类型的值。
+
+  ```v
+  name = "马冬梅";
+  name[0];  	# `马`
+  word = '我爱你中国';
+  word[0..3]	# "我爱你"
+  ```
+
+### function 函数类型
+- 在`MyScript`中, 通过`fn`关键字来定义一个函数对象。
+
+- 示例:
+  ```v
+  fn hello() {
+    print('hello, world');
+  }
+  
+  add = fn (a, b) {
+    return a + b;
+  }
+  
+  hello();
+  print(add(10, 8));
+  ```
+
+- 函数支持闭包，上级环境和闭包函数环境是两个单独的作用域。
+
+- 示例:
+
+  ```
+  var = 123;
+  print(var);		# 此时 var 为 123
+  
+  fn test() {
+  	var = 456;
+  	print(var);	# 此时 var 为 456
+  }
+  
+  test();
+  print(var);		# 此时 var 为 123
+  ```
+
+- `MyScript`实现了一些内置函数，包括:
+
+  | 函数定义                       | 函数作用                                   |
+  | :----------------------------- | :----------------------------------------- |
+  | fn len(arg object) int         | 计算指定对象(string\|list\|table)的长度    |
+  | fn type(arg object) string     | 获取对象类型的字符串                       |
+  | fn bool(arg object) bool       | 将对象转换为 bool 对象并返回               |
+  | fn char(arg object) bool       | 将对象转换为 char 对象并返回               |
+  | fn float(arg object) bool      | 将对象转换为 float 对象并返回              |
+  | fn int(arg object) bool        | 将对象转换为 int 对象并返回                |
+  | fn list(arg object) bool       | 将对象转换为 list 对象并返回               |
+  | fn string(object) string       | 将对象转换为 string 对象并返回             |
+  | fn clone(arg object) object    | 将对象拷贝一份并返回                       |
+  | fn print(args ...object)       | 打印不定长度的对象，分隔符为空格           |
+  | fn println(args ...object)     | 打印不定长度的对象，分隔符为换行符         |
+  | fn input(prompt string) string | 从控制台获取一段输入，prompt参数为提示内容 |
+
+  
+
+### list 列表类型
+
+- 列表对象由一对中括号"[]"表示，元素间用逗号分隔，每个元素可以是不同类型。
+- 列表中的每个元素都有对应索引，索引从0开始。
+- 可以通过索引获取或重新赋值列表中的元素。
+- 示例:
+  ```v
+  list = [1, 'two', 3.0, true];
+  
+  print(nums[1]);		# 2
+  nums[3] = `4`;  	# nums 变为 [1, 'two', 3.0, `4`];
+  ```
+
+### table 字典类型
+- 字典对象由一对大括号"{}"表示，键值对用冒号(:)分隔，键只能是`int`, `string`, `char`类型，值可以是任何类型。
+- 字典对象的键值对间用逗号(,)分隔。
+- 示例:
+  ```v
+  person = {
+    'name': 'Bob',
+    'age': 30,
+    'is_student': false
+  }
+  
+  name = person['name'];  # 'Bob'
+  person['age'] = 31;  	# 修改age的值
+  ```
+
+### null 空类型
+- `null`表示空对象，可以用来删除一个变量。
+- 示例:
+  ```v
+  value = 123;
+  print(value);	# 123
+  value = null;
+  print(value);	# ERROR: 标识符 "value" 没有绑定的值
+  ```
+
+- `null`同样可以用来删除`list`对象和`table`对象中的元素。
+
+- 示例:
+
+  ```
+  list = [0, 1, 2, 3];
+  list[-1] = null;			# 此时 list 为 [0, 1, 2]
+  
+  table = {'name': '张三', 'age': 33};
+  table['age'] = null;		# 此时 table 为 {'age': 33}
+  ```
+
+  
+
+## 流程控制
+
+### if条件语句
+
+```
+num = 10;
+if (num == 10) {
+	print('num 的值等于10');
+} else {
+	print('num 的值不等于10');
+}
+```
+
+条件赋值(if表达式)
+
+```
+love_you = false
+word = if (love_you) { '喜欢你' } else { '讨厌你' }	# '讨厌你'
+```
+
+### for遍历语句
+
+```
+for (v in 0..5) {
+	# 此时 v 的值依次为: 0, 1, 2, 3, 4
+}
+
+for (v in [true, '你好', 123.44]) {
+	# 此时 v 的值依次为: true, '你好', 123.44
+}
+
+for (v in {'name': '张三', 'age': 33}) {
+	# 此时 v 的值依次为: 'name', 'age'
+}
+```
+
+### while循环语句
+
+```
+while (condition) {
+	# 当 condition 为 true 时该代码块会循环执行
+}
+```
+