[C#] 튜플 : 여러 값을 한 번에 반환하기

[C#] 튜플 : 여러 값을 한 번에 반환하기

안녕하세요. 이번 글에서는 C#의 튜플(Tuple)에 대해 알아보겠습니다.

메서드에서 값을 두 개 이상 돌려주고 싶을 때, 예전에는 out 매개변수를 쓰거나 결과를 담는 클래스를 따로 만들어야 했습니다. C# 7.0부터는 (int, string) 같은 값 튜플(ValueTuple) 문법으로 여러 값을 간단히 묶을 수 있습니다.

기본 사용법

괄호 안에 값을 나열하면 튜플이 만들어지고, 각 요소에 이름을 붙이면 Item1, Item2 대신 이름으로 접근할 수 있습니다.

using System;

class Program
{
    static void Main()
    {
        // 이름 없는 튜플
        var t1 = (1, "apple");
        Console.WriteLine(t1.Item1);    // 1
        Console.WriteLine(t1.Item2);    // apple

        // 이름 있는 튜플
        (int Id, string Name) t2 = (2, "banana");
        Console.WriteLine(t2.Id);       // 2
        Console.WriteLine(t2.Name);     // banana

        // 값 쪽에 이름을 붙여도 됨
        var t3 = (Id: 3, Name: "cherry");
        Console.WriteLine(t3.Name);     // cherry
    }
}

여러 값 반환하기

튜플은 메서드의 반환 타입으로 가장 많이 쓰입니다. out 매개변수 없이 결과를 한 번에 돌려줄 수 있습니다.

using System;
using System.Collections.Generic;

class Program
{
    static (int Min, int Max) GetRange(IEnumerable<int> numbers)
    {
        int min = int.MaxValue;
        int max = int.MinValue;
        foreach (int n in numbers)
        {
            if (n < min) min = n;
            if (n > max) max = n;
        }
        return (min, max);
    }

    static void Main()
    {
        var range = GetRange(new[] { 5, 2, 9, 1, 7 });
        Console.WriteLine($"{range.Min} ~ {range.Max}");   // 1 ~ 9
    }
}

분해(Deconstruction)와 무시(Discard)

튜플은 여러 변수로 한 번에 풀어낼 수 있습니다. 필요 없는 값은 _(discard)로 버립니다.

static (int Min, int Max) GetRange(int[] numbers) => (numbers.Min(), numbers.Max());

// 변수로 분해
var (min, max) = GetRange(new[] { 5, 2, 9, 1, 7 });
Console.WriteLine(min);     // 1

// 이미 선언한 변수에 대입
int lo, hi;
(lo, hi) = GetRange(new[] { 3, 4 });

// 필요 없는 값은 무시
var (_, onlyMax) = GetRange(new[] { 5, 2, 9 });
Console.WriteLine(onlyMax); // 9

// 두 변수 값 교환
int a = 1, b = 2;
(a, b) = (b, a);

위 코드의 Min(), Max()는 System.Linq 네임스페이스가 필요합니다.

비교와 Dictionary 키

값 튜플은 요소를 하나씩 비교하는 == / != 연산자를 지원하고, Equals와 GetHashCode도 요소 값 기준으로 동작합니다. 그래서 여러 값을 묶은 Dictionary 키로도 쓸 수 있습니다.

var p1 = (X: 1, Y: 2);
var p2 = (X: 1, Y: 2);
Console.WriteLine(p1 == p2);    // True

var map = new Dictionary<(int X, int Y), string>();
map[(0, 0)] = "origin";
Console.WriteLine(map[(0, 0)]);  // origin

주의할 점

  • 값 튜플은 struct(ValueTuple)이며 요소는 필드라서 수정할 수 있습니다. 복사본을 수정해도 원본에는 영향이 없습니다.
  • 요소 이름은 컴파일러가 관리하며, 리플렉션이나 런타임 정보에는 Item1, Item2로만 남습니다.
  • 요소가 많아지거나 여러 곳에서 의미를 가지는 데이터라면 record나 클래스를 정의하는 편이 읽기 좋습니다.
  • System.Tuple 클래스(Tuple<T1, T2>)는 참조 타입이며 읽기 전용입니다. 새 코드에서는 보통 값 튜플을 사용합니다.

참고

이상으로 C# 튜플에 대해 간단히 알아보았습니다.