52 lines
1.0 KiB
Plaintext
52 lines
1.0 KiB
Plaintext
[[painless-comments]]
|
|
=== Comments
|
|
|
|
Use the `//` token anywhere on a line to specify a single-line comment. All
|
|
characters from the `//` token to the end of the line are ignored. Use an
|
|
opening `/*` token and a closing `*/` token to specify a multi-line comment.
|
|
Multi-line comments can start anywhere on a line, and all characters in between
|
|
the `/*` token and `*/` token are ignored. Comments can be included anywhere
|
|
within a script.
|
|
|
|
*Grammar*
|
|
[source,ANTLR4]
|
|
----
|
|
SINGLE_LINE_COMMENT: '//' .*? [\n\r];
|
|
MULTI_LINE_COMMENT: '/*' .*? '*/';
|
|
----
|
|
|
|
*Examples*
|
|
|
|
* Single-line comments.
|
|
+
|
|
[source,Painless]
|
|
----
|
|
// single-line comment
|
|
|
|
int value; // single-line comment
|
|
----
|
|
+
|
|
* Multi-line comments.
|
|
+
|
|
[source,Painless]
|
|
----
|
|
/* multi-
|
|
line
|
|
comment */
|
|
|
|
int value; /* multi-
|
|
line
|
|
comment */ value = 0;
|
|
|
|
int value; /* multi-line
|
|
comment */
|
|
|
|
/* multi-line
|
|
comment */ int value;
|
|
|
|
int value; /* multi-line
|
|
comment */ value = 0;
|
|
|
|
int value; /* multi-line comment */ value = 0;
|
|
----
|