Pine Script的注释(Comments)语句以双斜线(//)开头,用于在脚本中添加注释文字和解释说明。注释可以出现在代码行的末尾,也可以写成单独的一行,有助于更好地描述代码的功能和用途。以下是一个示例脚本,其中包括注释语句。
添加注释/取消注释的快捷键 :在Pine Editor页面,可以使用快捷键“Ctrl+/”(电脑为Windows操作系统)或“Command+/”(电脑为Mac操作系统)来添加注释或取消注释。
在将一条语句进行多行续写的情况下,不能在行内插入注释。
在Pine Script中,代码缩进有以下两种情况。
(1)在将一条语句进行多行续写时,续行前面需要有缩进空格,但是空格数量不能是4的倍数。
例如下面一条语句:
可以将上面的语句多行续写为:
(2)if语句、for语句或用户自定义函数的局部程序块(Local Block)内的语句需要缩进,且缩进的空格数必须是4的倍数。对于用户自定义函数,局部程序块在操作符“=>”的后面。
如图3-1所示,红框内的脚本使用了用户自定义函数、for语句和if语句,在其所有局部程序块内都缩进了4的倍数的空格。
图3-1 局部程序块内需要缩进4的倍数的空格脚本
多行续写(Line wrapping)即一条语句写多行,它适用于当一条Pine Script语句过长时,为提高可读性而将该语句写在多行。
Pine Script多行续写的书写格式为:首行需要顶格书写,续行前面要有空格。但是,续行前面的空格数量不能是4的倍数。
首行缩进4的倍数的空格脚本的书写格式,专用在条件语句(包括if和switch)、循环语句(包括for和while)或者用户自定义函数的局部程序块中。
Pine Editor编辑器会自动将“Tab”(即按一次Tab键)替换为4个空格。
下面是一个较长的plot语句,可以多行续写为:
用户自定义函数的多行续写
在Pine Script中,用户自定义函数的函数体(Function body)内的语句也可以多行续写。由于语法要求用户自定义函数的函数体内的语句必须以缩进(4个空格)开头,因此在多行续写时,续写语句必须缩进更多空格,但空格数不能是4的倍数。
例如:
上述语句与下面语句(不使用多行书写的情况)等价:
Pine Script允许将多条语句写在同一行,语句之间需要用逗号分隔,例如以下脚本:
可以将以上第5~7行语句合并写在同一行,如以下脚本的第4行所示:
本章介绍了Pine Script语法基础中的书写格式,包括注释规则、代码缩进、多行续写和一行写多条语句的语法格式。正确掌握语法基础和书写格式是学习任何计算机语言的前提条件。遵循计算机语言的语法基础和书写格式进行编程,不仅有助于保持代码的清晰度和易读性,还有助于提高程序质量和编写效率。