增加空格
等号左右、逗号后面、运算符左右,推荐增加一个空格,这样可以使得代码更加美观可读。
-
赋值语句的等号左右各留一个空格
s a = "你好" // = 两边有空格 ss b = 123 // = 两边有空格 sss c = false // = 两边有空格
-
函数有多个参数时,参数逗号后面增加一个空格
s a = "a.b.c.d" sl(a, ".", c) syso(c)
-
运算符左右增加空格
s a = 1 s b = 2 s c = 3 s(a + b / c, d) syso(d)
-
句末注释,
//
左右增加空格sqlite(sss.db, "test_data.db") // 连接到数据库,如果数据库文件不存在,则自动创建 sql(sss.db, "SELECT * FROM my_table", a) // 执行自定义 SQL 语句
-
单行注释,
//
后增加空格// 需要打开的网址 s url = "https://www/apee.top" // 使用系统默认的浏览器打开网址 hws(url)
-
注释中的中英文混排
中英文之间不添加空格。
注意:使用
.
进行注释时同样遵循此规范。
变量命名
目前流行的几种变量命名风格:
- 小驼峰:
getBookName
- 大驼峰:
GetBookName
- 小蛇式:
get_book_name
- 大蛇式:
GET_BOOK_NAME
根据笔者的裕语言开发习惯,结合 iApp 默认的编辑器,以及保持和 Java 语言的协调,推荐使用大驼峰。
sss input_type = "url"
sss input_text = "https://iapp.apee.top"
sss input_default_text = "请输入网址"
sss open_color = true
对于常量,比如程序的配置属性,可使用大蛇式。
sss VERSION = "1.0" // 软件版本
当变量名称和裕语言函数名称重合时,虽然不影响使用,但影响浏览,笔者建议在名称前加上下划线,如 _f
、_w
等。
标点符号
由于 iApp 编辑器特性,在 iApp 编辑器中,统一不使用中文符号,需按下面的示例替换:
- 中文冒号,改为英文冒号加空格
- 中文句号,改为英文句号加空格(结尾不需要)
- 其他符号根据实际情况,替换为同样的英文符号,并按需添加空格
错误示例
f
和 (
之间不能有空格。
f (a > 100)
{
tw("a比100大")
}