Базовый синтаксис Dart
У каждого языка программирования есть свой набор базовых правил, и Dart не исключение.
В этой главе представлены базовая структура программ на Dart, синтаксис комментариев, разница между инструкциями и выражениями, а также соглашения об именовании идентификаторов.
Структура программы и функция main()
Суффикс имени файла Dart —.dart..., каждая программа Dart должна иметь точку входа — функцию main().
Выполнение программы начинается с первой строки функции main() и заканчивается на закрывающей фигурной скобке в последней строке.
Пример
Структура простейшей программы на Dart:
void main() {
// Напишите здесь свой код
print('Добро пожаловать в EXAMPLE Dart Tutorial!');
}
欢迎来到 EXAMPLE Dart 教程!
Давайте разберём каждую часть этого кода:
| Элементы кода | Описание |
|---|---|
| void | Тип возвращаемого значения; void означает, что функция не возвращает никакого значения |
| main | Имя функции; это имя функции входа, заданное Dart, и его нельзя изменить |
| () | Список параметров; main() может не принимать параметров или принимать аргументы командной строки |
| { } | Тело функции; код внутри фигурных скобок — это то, что выполняет функция |
| print() | Встроенная функция, используемая для вывода текста в консоль |
| ; | Терминатор инструкции; каждая инструкция в Dart должна заканчиваться точкой с запятой |
Dart строго требует, чтобы каждая инструкция заканчивалась точкой с запятой (;). Забыть точку с запятой — самая распространённая синтаксическая ошибка среди новичков. К счастью, плагин Dart в VS Code автоматически указывает, где пропущены точки с запятой.
Функция main() с аргументами командной строки
Функция main() может принимать список строк в качестве аргументов командной строки:
Пример
void main(List<String> args) {
// Вывести количество аргументов
print('Количество аргументов: ${args.length}');
// Перебрать и вывести каждый аргумент
for (var i = 0; i < args.length; i++) {
print('Аргумент $i: ${args[i]}');
}
}
$ dart run hello.dart example dart 教程 参数个数:3 参数 0: example 参数 1: dart 参数 2: 教程
Здесь используется тип List и цикл for, которые мы подробно рассмотрим в следующих главах.
Синтаксис комментариев
Комментарии — это пояснения к коду; компилятор игнорирует содержимое комментариев.
Хорошие комментарии помогают другим (включая вас самих через несколько месяцев) быстрее понять замысел кода.
Dart поддерживает три стиля комментариев:
| Type | Синтаксис | Применимые сценарии |
|---|---|---|
| Однострочный комментарий | // содержимое комментария | Кратко объяснить назначение строки кода |
| Многострочный комментарий | /* Содержимое комментария */ | Подробное объяснение, занимающее несколько строк |
| Документирующий комментарий | /// Документирующие комментарии | Генерировать документацию API для функций и классов |
Пример
/// Документирующие комментарии можно использовать для создания HTML-документации с помощью команды [dart doc]
void main() {
// Однострочный комментарий: выводит приветственное сообщение
print('Добро пожаловать в изучение Dart!'); // Однострочный комментарий: это тоже допустимо
/*
* Многострочный комментарий: подходит для длинных пояснений
* Вторая строка комментария
* Третья строка комментария
*/
print('ПРИМЕР Учебник - Основы синтаксиса Dart');
}
欢迎学习 Dart! EXAMPLE 教程 - Dart 基础语法
Принцип комментариев — "объяснять почему, а не что". Сам код уже показывает, что он делает; комментарии должны объяснять, почему он написан именно так, или предоставлять справочную информацию, которую код не может выразить.
Инструкции и выражения
В Dart код состоит из инструкций и выражений.
Понимание разницы между ними помогает лучше организовать логику кода.
Выражение
Выражение — это фрагмент кода, который можно вычислить, и оно выдаёт значение.
Пример
// Каждая из следующих строк — это выражение; все они дают значение.
42; // Литеральное выражение, значение — 42
3 + 5; // Арифметическое выражение, значение равно 8
'Hello'.length; // Выражение доступа к свойству, значение равно 5
(10 > 5); // Выражение отношения, значение равно true
}
Инструкция
Инструкция — это команда, которая выполняет действие и не возвращает значение.
Пример
// Инструкция объявления переменной: объявляет переменную и присваивает значение
var name = 'EXAMPLE';
// Инструкция вызова функции: вызывает print() для выполнения действия вывода
print(name);
// Инструкция потока управления: определяет, какой код выполнять, в зависимости от условий
if (name.length > 3) {
print('Name length is greater than 3');
}
}
EXAMPLE 名称长度大于 3
Кратко:Выражения порождают значения, инструкции выполняют действия.
Выражения можно использовать там, где требуется значение, но инструкции использовать нельзя.
Распространенное заблуждение — считать весь код «инструкциями». На самом деле многие конструкции в Dart (например, вызовы функций и присваивания переменным) сами являются выражениями, что означает, что их можно вкладывать друг в друга. Это общая характеристика Dart и других языков семейства C.
Соглашения об именовании идентификаторов
Идентификатор — это имя, которое вы даете элементам кода, таким как переменные, функции и классы.
В Dart есть некоторые правила и соглашения для идентификаторов:
Правила именования (обязательны для соблюдения)
Идентификаторы могут состоять только из букв, цифр, знаков подчеркивания (_) и знаков доллара ($).
Идентификаторы не могут начинаться с цифры.
Идентификаторы не могут быть зарезервированными ключевыми словами Dart (такими как class, if, var и т. д.).
Соглашения об именовании (рекомендуемые)
| Элементы кода | Соглашения об именовании | Пример |
|---|---|---|
| Имя класса | UpperCamelCase | StudentInfo、HttpClient |
| Перечисляемый тип | UpperCamelCase | Color、Status |
| Имена библиотек и файлов | lowercase_with_underscores | my_utils、user_service |
| Имя переменной | lowerCamelCase | userName、maxCount |
| Имя функции | lowerCamelCase | getUserInfo()、calculateTotal() |
| Имя константы | lowerCamelCase | piValue、defaultPort |
| Закрытые члены | Префикс с подчеркиванием | _internalState、_privateMethod() |
Пример
Практическое применение различных стилей именования:
class UserAccount {
// Публичные члены: lowerCamelCase
String userName;
// Приватные члены: префикс с подчеркиванием (доступны только внутри этого файла)
String _password;
// конструктор
UserAccount(this.userName, this._password);
// Публичные методы: lower camelCase
bool verifyPassword(String input) {
return input == _password;
}
// Приватные методы: префикс с подчёркиванием
void _encryptPassword() {
// Логика шифрования...
}
}
// Функция входа: нижний регистр
void main() {
// Имена переменных: lower camelCase
var userAccount = UserAccount('example', '123456');
// Константы: lower camelCase (стиль Dart)
const maxLoginAttempts = 3;
print('Имя пользователя: ${userAccount.userName}');
print('Максимальное число попыток входа: $maxLoginAttempts');
}
用户名: example 最大登录尝试次数: 3
В соглашениях об именовании Dart константы используют lowerCamelCase, а не стиль со всеми заглавными буквами и подчёркиваниями (UPPER_CASE), распространённый в других языках. Это уникальный стиль сообщества Dart, поэтому обязательно помните о нём.
