Syntax
Comments
Comments can be used to document code. A comment is text that is not executed.
Single-line comments start with two slashes (//
).
These comments can go on a line by themselves or they can go directly after a line of code.
Multi-line comments start with a slash and an asterisk (/*
)
and end with an asterisk and a slash (*/
):
Comments may be nested.
Multi-line comments are balanced.
Documentation Comments
Documentation comments (also known as "doc-strings" or "doc-comment") are a special set of comments that can be processed by tools, for example to generate human-readable documentation, or provide documentation in an IDE.
Doc-comments either start with three slashes (///
) on each line,
or are surrounded by /**
and **/
.
Names
Names may start with any upper or lowercase letter (A-Z, a-z)
or an underscore (_
).
This may be followed by zero or more upper and lower case letters,
underscores, and numbers (0-9).
Names may not begin with a number.
Conventions
By convention, variables, constants, and functions have lowercase names; and types have title-case names.
Semicolons
Semicolons (;) are used as separators between declarations and statements. A semicolon can be placed after any declaration and statement, but can be omitted between declarations and if only one statement appears on the line.
Semicolons must be used to separate multiple statements if they appear on the same line.