Функции в 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
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). Если вам нужно определить значение по умолчанию во время выполнения, вы можете сделать это с помощью ?? внутри тела функции.


Стрелочные функции и анонимные функции

Когда тело функции содержит только одно выражение, можно использовать сокращённый синтаксис стрелки (=>).

Анонимная функция — это функция без имени, обычно передаваемая как аргумент другой функции.

Пример

void main() {
  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 и замыкание, поэтому несколько счётчиков не влияют друг на друга.

Другие расширения