Функции в Dart
Функция — это базовая единица организации кода; она инкапсулирует часть повторно используемой логики, которую можно вызвать при необходимости.
Система функций Dart очень гибкая: она поддерживает такие возможности, как именованные параметры, необязательные параметры, стрелочные функции и функции высшего порядка.
Определение функции и возвращаемое значение
Функция состоит из типа возвращаемого значения, имени функции, списка параметров и тела функции.
Пример
// String — тип возвращаемого значения, greet — имя функции, (String name) — список параметров
String greet(String name) {
return 'Hello, $name! Welcome to EXAMPLE.';
}
// Функции без возвращаемого значения используют void
void printWelcome() {
print('=== ПРИМЕР: Учебник по Dart ===');
}
void main() {
printWelcome();
// Вызовите функцию и получите возвращаемое значение
String message = greet('Сяо Мин');
print(message);
}
=== EXAMPLE Dart 教程 === 你好,小明!欢迎来到 EXAMPLE。
Возвращаемое значение
Каждая функция имеет возвращаемое значение.
Если нет явного return, функция неявно возвращает null (но в условиях null safety это привело бы к несоответствию типов, поэтому обычно используется void, чтобы указать отсутствие возвращаемого значения).
Пример
int add(int a, int b) {
return a + b;
}
// Используйте стрелочный синтаксис как сокращение для функций с одним выражением
int multiply(int a, int b) => a * b;
// void означает отсутствие значимого возвращаемого значения
void log(String msg) {
print('[EXAMPLE Log] $msg');
}
void main() {
print('3 + 5 = ${add(3, 5)}');
print('3 × 5 = ${multiply(3, 5)}');
log('Изучение функций завершено');
}
3 + 5 = 8 3 × 5 = 15 [EXAMPLE 日志] 函数学习完成
Именованные параметры и необязательные параметры
Параметры Dart делятся на два типа: обязательные параметры и необязательные параметры.
Необязательные параметры далее делятся на именованные параметры и позиционные параметры.
Именованные параметры
Именованные параметры заключаются в фигурные скобки {}, и при вызове они передаются по имени параметра, поэтому порядок может быть произвольным.
Пример
// Ключевое слово required отмечает их как обязательные
String createUser({
required String name, // Обязательный именованный параметр
int age = 0, // Необязательный, по умолчанию 0
String? email, // Необязательный, может быть null
bool isVip = false, // Необязательный, по умолчанию false
}) {
var info = 'Имя пользователя: $name, Возраст: $age';
if (email != null) {
info += ', Эл. почта: $email';
}
if (isVip) {
info += ' [VIP-пользователь]';
}
return info;
}
void main() {
// Именованные параметры: передаются по имени параметра, порядок не важен
print(createUser(name: 'пример', age: 10));
print(createUser(name: 'admin', email: 'admin@example.com', isVip: true));
// Обязательные параметры нельзя опускать
// createUser(); // Ошибка: отсутствует обязательный параметр name
}
用户名: example, 年龄: 10 用户名: admin, 邮箱: admin@example.com [VIP用户]
Позиционные параметры
Позиционные параметры заключаются в квадратные скобки [], и при вызове они передаются по порядку.
Пример
String buildUrl(String host, [String path = '/', int port = 80]) {
return 'http://$host:$port$path';
}
void main() {
// Передавайте только обязательные параметры; необязательные параметры используют значения по умолчанию
print(buildUrl('www.example.com'));
Передайте 2 параметра
print(buildUrl('www.example.com', '/dart'));
// Передать 3 параметра
print(buildUrl('localhost', '/api', 8080));
}
http://www.example.com:80/ http://www.example.com:80/dart http://localhost:8080/api
Именованные параметры против позиционных параметров: как выбрать
| Сценарии | Рекомендуемый подход | Причина |
|---|---|---|
| Много параметров (более 3) | Именованные параметры | Имена параметров говорят сами за себя в месте вызова, поэтому трудно передать их в неправильном порядке. |
| Смысл параметра неясен | Именованные параметры | Значения вроде true/false не объясняют своего назначения; добавление имени делает их понятнее. |
| Мало параметров и понятный смысл | Позиционные параметры | Например, add(1, 2) — кратко и ясно. |
| Создание Flutter Widget | Именованные параметры | Стандартный стиль Flutter |
Функция не может одновременно использовать необязательные позиционные параметры и необязательные именованные параметры. Можно выбрать только один.
Значения параметров по умолчанию
Необязательным параметрам можно задать значения по умолчанию, которые используются, когда вызывающий код не передаёт этот параметр.
Пример
String formatMessage(
String content, {
String prefix = '[EXAMPLE]',
String suffix = '',
bool uppercase = false,
}) {
var result = '$prefix $content $suffix';
return uppercase ? result.toUpperCase() : result;
}
void main() {
// Использовать все значения по умолчанию
print(formatMessage('Учебник Dart обновлён'));
// Переопределить некоторые значения по умолчанию
print(formatMessage('Важное уведомление', prefix: '[Объявление]', suffix: '!!!'));
// Переопределить значения по умолчанию + включить uppercase
print(formatMessage('ошибка', prefix: [Error], uppercase: истина));
}
[EXAMPLE] Dart 教程更新了 [公告] 重要通知 !!! [错误] ERROR
Значения по умолчанию должны быть константами времени компиляции. То есть значением по умолчанию не может быть DateTime.now() или возвращаемое значение функции (если только функция не является const). Если вам нужно определить значение по умолчанию во время выполнения, вы можете сделать это с помощью ?? внутри тела функции.
Стрелочные функции и анонимные функции
Когда тело функции содержит только одно выражение, можно использовать сокращённый синтаксис стрелки (=>).
Анонимная функция — это функция без имени, обычно передаваемая как аргумент другой функции.
Пример
var numbers = [1, 2, 3, 4, 5];
// Анонимная функция (полный синтаксис)
numbers.forEach((number) {
print(ПРИМЕР число: $number);
});
print('---');
// Стрелочная функция (сокращённая запись для одного выражения)
var doubled = numbers.map((n) => n * 2);
print(Удвоено: $doubled);
// Использование стрелочных функций в определениях функций
// Когда тело функции содержит только один оператор return, можно использовать => как сокращённую запись
int square(int x) => x * x;
print(5 в квадрате: ${square(5)});
// Сохранение анонимной функции в переменной
var sayHello = (String name) => Привет, $name!;
print(sayHello('пример'));
}
EXAMPLE 数字: 1 EXAMPLE 数字: 2 EXAMPLE 数字: 3 EXAMPLE 数字: 4 EXAMPLE 数字: 5 --- 翻倍: (2, 4, 6, 8, 10) 5 的平方: 25 你好,example!
Функции высшего порядка и замыкания
Функция высшего порядка — это функция, которая может принимать функцию в качестве аргумента или возвращать функцию в качестве результата.
Замыкание — это функция, которая может обращаться к переменным в своей лексической области видимости, даже когда функция вызывается вне этой области.
Функции высшего порядка
Пример
List<int> filterList(
List<int> items, bool Function(int) predicate) {
return items.where(predicate).toList();
}
// Функция высшего порядка: возвращает функцию
Function makeMultiplier(int factor) {
// Возвращает замыкание: запоминает внешний factor
return (int n) => n * factor;
}
void main() {
var numbers = [10, 15, 20, 25, 30];
// Передать анонимную функцию в качестве условия фильтрации
var bigNumbers = filterList(numbers, (n) => n > 18);
print(ПРИМЕР числа больше 18: $bigNumbers);
// Получить возвращаемую функцию
var doubleIt = makeMultiplier(2);
var tripleIt = makeMultiplier(3);
print('5 × 2 = ${doubleIt(5)}');
print('5 × 3 = ${tripleIt(5)}');
}
EXAMPLE 大于18的数: [20, 25, 30] 5 × 2 = 10 5 × 3 = 15
Замыкание
Замыкание — это функциональный объект, который может обращаться к переменным в своей лексической области видимости, даже когда функция вызывается вне исходной области видимости.
Пример
Функция makeCounter() {
int count = 0; // Эта переменная "захватывается" возвращаемой функцией
return () {
count++;
return count;
};
}
void main() {
// counterA и counterB имеют собственный независимый count
var counterA = makeCounter();
var counterB = makeCounter();
print(ПРИМЕР Счётчик A: ${counterA()}); // 1
print(ПРИМЕР Счётчик A: ${counterA()}); // 2
print(ПРИМЕР Счётчик B: ${counterB()}); // 1 (независимый count)
print(ПРИМЕР Счётчик A: ${counterA()}); // 3
}
EXAMPLE 计数器 A: 1 EXAMPLE 计数器 A: 2 EXAMPLE 计数器 B: 1 EXAMPLE 计数器 A: 3
Другие расширенияСуть замыканий в том, что внутренняя функция "запоминает" переменные внешней функции, даже после того, как внешняя функция завершила выполнение. Каждый вызов makeCounter() создаёт совершенно новую переменную count и замыкание, поэтому несколько счётчиков не влияют друг на друга.