C# Academy · Урок

Кортежи как возвращаемые значения методов

Возвращайте несколько результатов без параметров out.

«Кортежи как возвращаемые значения методов» — бесплатный урок C# Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения C# Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс C# Academy содержит 4 уроков всего.

Возврат нескольких значений

Метод может вернуть только один результат, но кортеж позволяет объединить в нём несколько значений и служит удобной альтернативой параметрам out.

using System;

class Program
{
    static (int, int) Divide(int a, int b) => (a / b, a % b);

    static void Main()
    {
        var result = Divide(17, 5);
        Console.WriteLine(result.Item1 + " r " + result.Item2);
    }
}

Именованные типы возвращаемых кортежей

Имена возвращаемых элементов делают метод самодокументируемым, а место вызова — понятным для чтения.

using System;

class Program
{
    static (int Quotient, int Remainder) Divide(int a, int b)
    {
        return (a / b, a % b);
    }

    static void Main()
    {
        var r = Divide(17, 5);
        Console.WriteLine("Q=" + r.Quotient + ", R=" + r.Remainder);
    }
}

Деструктуризация возвращаемого значения

Вызывающий код может сразу деструктурировать возвращённый кортеж в отдельные переменные.

using System;

class Program
{
    static (double Min, double Max) Bounds(double[] data)
    {
        double min = data[0], max = data[0];
        foreach (var d in data)
        {
            if (d < min) min = d;
            if (d > max) max = d;
        }
        return (min, max);
    }

    static void Main()
    {
        var (lo, hi) = Bounds(new double[] { 3, 7, 1, 9, 4 });
        Console.WriteLine("min=" + lo + ", max=" + hi);
    }
}

Альтернатива с параметром out

До появления кортежей дополнительные значения возвращали через параметры out. Этот подход работает, но его сложнее объявлять и использовать.

using System;

class Program
{
    static int Divide(int a, int b, out int remainder)
    {
        remainder = a % b;
        return a / b;
    }

    static void Main()
    {
        int rem;
        int q = Divide(17, 5, out rem);
        Console.WriteLine("Q=" + q + ", R=" + rem);
    }
}

Кортежи и out: читаемость

При возврате кортежа все результаты находятся в возвращаемом значении и естественно читаются вместе с деструктуризацией, поэтому в простых случаях кортежи обычно предпочтительнее out.

using System;

class Program
{
    static (int Sum, int Count) Stats(int[] nums)
    {
        int sum = 0;
        foreach (var n in nums) sum += n;
        return (sum, nums.Length);
    }

    static void Main()
    {
        var (sum, count) = Stats(new[] { 2, 4, 6 });
        Console.WriteLine("Sum=" + sum + ", Count=" + count);
    }
}

Возврат статуса и значения

Распространённый шаблон — вернуть флаг успешного выполнения вместе с результатом, подобно шаблону TryParse, но объединить их в один кортеж.

using System;

class Program
{
    static (bool Ok, int Value) ParseAge(string s)
    {
        if (int.TryParse(s, out int n) && n >= 0)
            return (true, n);
        return (false, 0);
    }

    static void Main()
    {
        var r = ParseAge("42");
        Console.WriteLine(r.Ok ? "Parsed " + r.Value : "Invalid");
    }
}

Когда параметр out всё ещё полезен

out по-прежнему уместен во встроенном шаблоне TryParse (int.TryParse), где один логический результат и одно значение out являются привычным соглашением.

using System;

class Program
{
    static void Main()
    {
        if (int.TryParse("100", out int value))
            Console.WriteLine("Got " + value);
        else
            Console.WriteLine("Not a number");
    }
}

Возврат нескольких именованных полей

Кортежи позволяют возвращать несколько результатов, не заставляя вас создавать специальный одноразовый класс.

using System;

class Program
{
    static (int Min, int Max, double Avg) Analyze(int[] nums)
    {
        int min = nums[0], max = nums[0], sum = 0;
        foreach (var n in nums)
        {
            if (n < min) min = n;
            if (n > max) max = n;
            sum += n;
        }
        return (min, max, (double)sum / nums.Length);
    }

    static void Main()
    {
        var a = Analyze(new[] { 4, 8, 2, 6 });
        Console.WriteLine("min=" + a.Min + ", max=" + a.Max + ", avg=" + a.Avg);
    }
}

Когда предпочтительнее класс

Если сгруппированные данные имеют поведение, широко используются или требуют проверки, определите класс или запись вместо того, чтобы повсюду возвращать кортеж.

using System;

class Program
{
    // Fine as a tuple: small, local, no behavior
    static (int W, int H) ParseSize(string s)
    {
        var parts = s.Split('x');
        return (int.Parse(parts[0]), int.Parse(parts[1]));
    }

    static void Main()
    {
        var (w, h) = ParseSize("16x9");
        Console.WriteLine(w + " by " + h);
    }
}

Цепочка возвращаемых кортежей

Возвращённый кортеж можно передать непосредственно в другое вычисление, деструктурировав его на месте.

using System;

class Program
{
    static (int, int) Split(int total) => (total / 2, total - total / 2);

    static void Main()
    {
        var (a, b) = Split(7);
        Console.WriteLine("Halves: " + a + " + " + b + " = " + (a + b));
    }
}

Собираем всё вместе

Именованный кортеж — современный и понятный способ вернуть из метода несколько связанных значений без лишних формальностей.

using System;

class Program
{
    static (bool Found, int Index) Search(int[] arr, int target)
    {
        for (int i = 0; i < arr.Length; i++)
            if (arr[i] == target) return (true, i);
        return (false, -1);
    }

    static void Main()
    {
        var r = Search(new[] { 5, 8, 12 }, 8);
        Console.WriteLine(r.Found ? "At index " + r.Index : "Not found");
    }
}

Быстрая проверка

Проверьте, насколько хорошо вы понимаете возвращаемые значения-кортежи.

Итоги

Возврат кортежа позволяет методу передать сразу несколько значений и в большинстве случаев служит более удобной альтернативой out. Для ясности давайте элементам имена и позволяйте вызывающему коду деструктурировать их. Оставляйте out для традиционного шаблона TryParse, а класс или запись выбирайте, когда данные имеют поведение или широко используются повторно.

using System;

class Program
{
    static (int Sum, int Max) Go(int[] n)
    {
        int s = 0, m = n[0];
        foreach (var x in n) { s += x; if (x > m) m = x; }
        return (s, m);
    }

    static void Main()
    {
        var (sum, max) = Go(new[] { 3, 9, 5 });
        Console.WriteLine(sum + " / " + max);
    }
}

Часто задаваемые вопросы

Урок «Кортежи как возвращаемые значения методов» бесплатный?

Да — полный текст урока «Кортежи как возвращаемые значения методов» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс C# Academy, подпишись на CoddyKit PRO. Курс C# Academy содержит 4 уроков всего.

Чему я научусь в уроке «Кортежи как возвращаемые значения методов»?

Возвращайте несколько результатов без параметров out. Ты практикуешь C# Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать C# Academy?

Предыдущий опыт не требуется. C# Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.

Сколько времени занимает урок «Кортежи как возвращаемые значения методов»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке C# Academy?

Да. Каждый урок C# Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

Основы кортежей значений
Именованные элементы кортежей
Декомпозиция
Кортежи как возвращаемые значения методов

← Назад к C# Academy