基础开发语法

基础通用开发语法

由于各端平台所使用的基础开发语言存在较大差异性、在对基础语法进行统一编排后；虽然大致开发语法是一样的、但针对不同平台的实现仍然保留了部分源语言特性、以方便后期升级更新；因此针对不同的应用请阅读对应的开发文档、本文只对通用的开发语法做出说明。

开发规范

当我们编写应用程序时，应注意以下几点：

大小写敏感 在编写代码时、大小写字母是不一样的标记；例如：变量A与a是两个不同的标识符。
语句结束标记 在轻舟中使用换行符结束一句代码；即一行代码即为一句代码、不支持特殊换行处理。
数据值比较 比较数据值是否相等；在小程序与网站开发时、可以通过“==”双等于符号进行比较；但在安卓与桌面软件开发中、比较基础数据类型或对象引用；可采用双等号。但比较文本字符串类型是否相等时、必须使用静态函数“取相等”比较、不能使用 "==" 双等于符号比较。
窗口代码与界面对应 窗口代码文件名称必须与设计界面一一对应。

注释

轻舟与 VisualBasic 的注释一样、采用单引号开始、换行符结束、支持单行与多行注释格式、注释不参与编译、仅对程序代码做出解释说明；单行注释代码示例：

' 这是一行普通的注释内容
变量 a 为 文本型

多行注释格式：

''
' 这是一个多行注释内容、多行注释内容以两个单引号开始、两个单引号结束
' 由两个单引号包裹的内容、即为注释内容；在编写代码时会提示该内容
''
函数 获取数据()
    返回 "value"
结束 函数

注释内容在编写代码时会自动提示。

标识符

在代码中所有的变量名称、方法、事件名都被称为标识符。在对变量函数、方法命名时；需要注意以下几点：

所有的标识符都只能以中文汉字、拼音字母或下划线(_)开始作为第一个字符
首字符之后可以由中文汉字、拼音、下划线(_)或数字组成、不能包含任何特殊符号
标识符不能含有操作符号、运算符号、或标点符号
所有的关键字与内置函数不能用作标识符
标识符是大小写敏感的
合法的标识符例如：a、a1、网页地址、网页地址2、按钮_确定
非法的标识符例如：123、123abc、#*aaa、55%、

变量

变量是指在代码中用于临时储存数据、并且该数据可以被修改的标记；在轻舟中支持以下三种变量：

窗口变量 也称为页面成员变量、可在整个窗口或当前页面代码中使用。
局部变量 只能在函数或事件内部定义、使用。
全局变量(模块) 使用公用模块声明、并使用使用静态修饰符修饰、可以在整个应用中使用。

修饰符

像其他语言一样、轻舟可以使用修饰符来设置代码中变量与方法的作用域、也称为可访问域；例如给模块中的函数添加“静态”修饰符、那么在代码中就可以直接通过模块名称调用被该关键字修饰的函数；目前轻舟支持的修饰符如下：

安卓与视窗
- 私有
- 静态
微信小程序
- 静态

注：后端API应用不支持修饰符

@

代码中特殊标记符；目前有两个功能：

@{ }

原生代码嵌入语句、使用该操作符号可在代码中直接嵌入原生代码；例如在安卓与视窗程序代码中；可以通过 @{ } 包裹原生代码后直接在程序中使用；例如：

事件 按钮2.被单击(来源对象 为 视图)
    ' 使用原生代码对指定数组进行排序
    变量 array = { 12,25,34,66,54 }
    @{
        for(int i = 0; i < array.length - 1; i++)
        {
            for(int j = 0; j < array.length - 1 - i; j++)
            {
                if(array[j] > array[j + 1])
                {
                    int temp = array[j];
                    array[j] = array[j + 1];
                    array[j + 1] = temp;
                }
            }
        }
    }
    标签1.标题 = 到文本(array)
结束 事件

@[标记]
- 指定文件父类或源类型；例如在安卓与视窗中；可以通过该符号+特点关键字指定窗口的父类；例如：
- ```
@父类 = 基础窗口其他
```

模板字符串

模板字符串又称为字符串内插标记、在轻舟中以“$”符号开头的字符串文本、将被识别为内插字符串、内插字符串允许在字符串类插入指定变量或不包含运算符的表达式、该功能常常在格式化输出文本内容时会被用到、例如：

事件 按钮1.被单击(源对象 为 视图)
    变量 a = 100
    标签1.标题 = $"50乘以2等于：{a}"
    标签2.标题 = $"今天是{取年()}年{取月()}月{取日()}日"
结束 事件

在上方代码中、修改标签1的标题时、目标字符串文本我们使用了“$”标识符、然后在字符串内部；通过花括号包裹变量a、当程序运行后、其 a 的值将等于变量值100 。其实简单的来说就是针对连接字符串变得更方便、因为上方的代码也等同于：

事件 按钮1.被单击(源对象 为 视图)
    变量 a = 100
    标签1.标题 = "50乘以2等于：" + a
    标签2.标题 = "今天是" + 取年() + "年" + 取月() + "月" + 取日() + "日"
结束 事件

注：模板字符串不支持插入数组、也不支持运算符号、不支持处理字符串中本身含有花括号的字符串。

文本字符串比较相等

在安卓与桌面软件开发中、比较两个文本字符串变量是否相等、不能使用“==”、也不能使用“=”符号、只能使用“取相等”函数。

其它

其他非通用开发语法请阅读对应开发文档。