Возврат нескольких значений из функции: out-параметры и кортежи

1. Введение

Давайте представим, что у нас есть функция, которая по переданному пользователю (например, по имени) должна вернуть сразу и возраст, и дату регистрации, и флаг-активности. В C и ранних версиях C# считалось нормальным делать возвращаемым типом только одно значение. Что делать, если значений несколько? Этот вопрос дал жизнь разным подходам, каждый из которых имеет свои плюсы и минусы.
В предыдущих лекциях мы уже познакомились с кортежами. Сейчас изучим out-параметры и сравним эти два подхода.

Самые популярные подходы:

• Использовать out-параметры.
• Возвращать какой-нибудь объект с нужными полями (анонимный тип или пользовательский класс).
• Вернуть кортеж (ValueTuple).

В этой лекции мы подробно рассмотрим два из этих подходов – out-параметры и кортежи, и сравним их "лицом к лицу", чтобы понять преимущества каждого для возврата нескольких значений из функции.

2. out-параметры: привет из прошлого

Когда видишь функцию типа:

void GetUserInfo(string userName, out int age, out DateTime registrationDate, out bool isActive)
{
    // здесь вычисления
    age = 42;
    registrationDate = new DateTime(2010, 1, 1);
    isActive = true;
}

то хочется спросить: это функция или небольшой филиал автомойки? Столько всего возвращается наружу, и всё мимо основного возвращаемого значения!

Как это работает

Вызывающий код должен заранее объявить переменные, которые функция заполнит:

int age;
DateTime reg;
bool isActive;

GetUserInfo("Bob", out age, out reg, out isActive);

// Теперь все переменные заполнены
Console.WriteLine($"{age}, {reg}, {isActive}");

Минусы out-подхода

• Сложнее читать: Сигнатура метода разрастается вширь, смысл возвращаемых данных не всегда ясен из имени параметров.
• Неудобство при цепочках вызовов: Такой метод нельзя легко вставить в цепочку (например, передать результат сразу в другой метод).
• Мутирует переданные переменные: Метод обязан модифицировать существующие переменные; если забыть про out — будет ошибка компиляции.
• Задержка при инициализации: Компилятор заставляет вас объявить внешние переменные, даже если вы хотите использовать результат только раз.
• Ограниченная читабельность в больших методах: Если out-параметров много, легко запутаться, что за чем идёт и для чего нужно.

Вот где кортежи начинают светиться своей звёздной аурой.

3. Кортежи — эволюция подхода

Сравним на примере

С помощью кортежа:

public (int Age, DateTime RegistrationDate, bool IsActive) GetUserInfo(string userName)
{
    // эмуляция поиска в базе
    return (42, new DateTime(2010, 1, 1), true);
}

Использование:

// Получаем сразу все значения и даём имена переменным
var (age, regDate, isActive) = GetUserInfo("Bob");
Console.WriteLine($"{age}, {regDate}, {isActive}");

Без лишних объявлений, без out, всё максимально читабельно!

Таблица сравнений: out vs tuple

Кортежи VS. out — что происходит под капотом

С out-параметрами функция на самом деле работает с памятью вне своей "территории": если несколько упростить, она изменяет переменные, которые были созданы где-то ещё. Это требует осторожности, потому что можно нечаянно "замусорить" состояние переменных (спасибо компилятору за обязательное присваивание!).

Кортеж же — это структура данных, которую функция создала, полностью инициализировала и вернула наружу. Таким образом, всё — единая посылка, которую вы не потеряете в пути и не забудете про неё.

Чтение и сопровождение кода

Согласитесь — когда через неделю изучаете чужой код, хочется видеть:

(var age, var city, var isActive) = GetUserInfo("Anna");

а не

int age;
string city;
bool isActive;
GetUserInfo("Anna", out age, out city, out isActive);

Кортежи делают сигнатуры методов менее шумными, а результат их использования — интуитивно понятным.

4. Ситуации, где кортежи особенно хороши

1. Когда нужно вернуть результат и сообщение об ошибке

public (bool Success, string ErrorMessage) TryProcess(string data)
{
    if (string.IsNullOrEmpty(data))
        return (false, "Нет данных");

    // обработка данных...
    return (true, "");
}

var (ok, error) = TryProcess(input);
if (!ok)
    Console.WriteLine($"Ошибка: {error}");

2. Для функций, возвращающих множество результатов поиска

public (User? FoundUser, int Index) FindUserByName(User[] users, string name)
{
    for (int i = 0; i < users.Length; i++)
    {
        if (users[i].Name == name)
            return (users[i], i);
    }
    return (null, -1);
}

3. Для “пар” значений: расчет минимума и максимума

public (int min, int max) FindMinMax(int[] numbers)
{
    int min = numbers[0], max = numbers[0];
    foreach (var n in numbers)
    {
        if (n < min) min = n;
        if (n > max) max = n;
    }
    return (min, max);
}

var (minValue, maxValue) = FindMinMax(arr);

2

Задача

C# SELF, 11 уровень, 3 лекция

Недоступна

Создание функции с использованием кортежа

Создание функции с использованием кортежа

Открыть

2

Задача

C# SELF, 11 уровень, 3 лекция

Недоступна

Расчёт минимума и максимума через кортеж

Расчёт минимума и максимума через кортеж

Открыть