[C#] ref, out, in : 매개변수를 참조로 전달하기

[C#] ref, out, in : 매개변수를 참조로 전달하기

안녕하세요. 이번 글에서는 C#의 매개변수 한정자 ref, out, in에 대해 알아보겠습니다.

C#에서 메서드에 인자를 넘기면 기본적으로 값이 복사되어 전달됩니다. 그래서 메서드 안에서 매개변수를 바꿔도 호출한 쪽의 변수는 그대로입니다. 두 변수의 값을 맞바꾸거나, 메서드에서 결과를 여러 개 돌려받거나, 큰 구조체를 복사 없이 넘기고 싶을 때는 변수 자체를 참조로 전달해야 합니다. 이때 쓰는 키워드가 ref, out, in입니다.

한눈에 보기

한정자호출 전 초기화메서드 안에서주 용도
(없음)필요복사본을 다룸 (원본 영향 없음)일반적인 값 전달
ref필요읽기·쓰기 가능 (원본 변경)원본 변수를 직접 수정
out불필요반환 전에 반드시 값 할당결과를 추가로 돌려받기
in필요읽기 전용 (수정 불가)큰 struct를 복사 없이 전달

세 키워드 모두 변수를 참조로 넘긴다는 점은 같고, 누가 값을 채우는지와 수정할 수 있는지가 다릅니다.

기본 : 값으로 전달

먼저 한정자 없이 두 값을 바꾸는 메서드를 만들어 보겠습니다.

using System;

class Program
{
    static void Swap(int a, int b)
    {
        int temp = a;
        a = b;
        b = temp;
    }

    static void Main()
    {
        int x = 1, y = 2;
        Swap(x, y);
        Console.WriteLine($"x = {x}, y = {y}");    // x = 1, y = 2
    }
}

Swap 안의 a, b는 x, y의 복사본이므로 메서드 안에서 값을 바꿔도 x, y에는 아무 영향이 없습니다.

ref : 원본 변수를 직접 수정

매개변수 앞에 ref를 붙이면 변수 자체가 전달됩니다. 메서드 선언뿐 아니라 호출하는 쪽에도 ref를 써야 하며, 넘기는 변수는 미리 초기화되어 있어야 합니다.

static void Swap(ref int a, ref int b)
{
    int temp = a;
    a = b;
    b = temp;
}

static void Main()
{
    int x = 1, y = 2;
    Swap(ref x, ref y);
    Console.WriteLine($"x = {x}, y = {y}");    // x = 2, y = 1

    int z;
    // Swap(ref z, ref y);   // 오류 CS0165: 할당되지 않은 지역 변수 'z'를 사용했습니다.
}

호출 쪽에도 ref를 적게 한 것은, 코드를 읽는 사람이 “이 호출은 변수 값을 바꿀 수 있다”는 것을 바로 알 수 있게 하기 위해서입니다.

out : 결과를 추가로 돌려받기

out은 메서드가 값을 채워서 돌려주는 매개변수입니다. 호출 전에 초기화하지 않아도 되는 대신, 메서드는 반환하기 전에 out 매개변수에 반드시 값을 할당해야 합니다. 대표적인 예가 int.TryParse입니다.

static bool TryDivide(int a, int b, out int quotient, out int remainder)
{
    if (b == 0)
    {
        quotient = 0;       // 실패해도 out 매개변수는 모두 할당해야 함
        remainder = 0;
        return false;
    }
    quotient = a / b;
    remainder = a % b;
    return true;
}

static void Main()
{
    // 변수를 미리 선언하는 방식
    int q, r;
    if (TryDivide(17, 5, out q, out r))
        Console.WriteLine($"몫 {q}, 나머지 {r}");      // 몫 3, 나머지 2

    // 호출하면서 바로 선언 (C# 7.0 이상)
    if (int.TryParse("123", out int number))
        Console.WriteLine(number + 1);               // 124

    // 필요 없는 값은 _ 로 버림
    if (TryDivide(17, 5, out _, out int rest))
        Console.WriteLine($"나머지만: {rest}");       // 나머지만: 2
}

out int number처럼 호출하면서 변수를 바로 선언할 수 있고(out var도 가능), 쓰지 않을 결과는 out _(무시 항목)로 버릴 수 있습니다. 반환값이 여러 개인 경우 튜플을 쓰는 방법도 있지만, “성공 여부 + 결과” 형태의 TryXxx 패턴에는 out이 널리 쓰입니다.

in : 읽기 전용 참조로 전달

in(C# 7.2 이상)은 참조로 넘기되 메서드 안에서 수정할 수 없게 막는 한정자입니다. 크기가 큰 struct를 값으로 넘기면 호출할 때마다 전체가 복사되는데, in을 쓰면 복사 없이 읽기만 할 수 있습니다.

readonly struct Matrix4
{
    public readonly double M11, M12, M13, M14;
    public readonly double M21, M22, M23, M24;
    public readonly double M31, M32, M33, M34;
    public readonly double M41, M42, M43, M44;

    public Matrix4(double diag)
    {
        M11 = M22 = M33 = M44 = diag;
        M12 = M13 = M14 = M21 = M23 = M24 = 0;
        M31 = M32 = M34 = M41 = M42 = M43 = 0;
    }
}

static double Trace(in Matrix4 m)
{
    // m = new Matrix4(2);   // 오류 CS8331: 읽기 전용 변수이므로 할당할 수 없습니다.
    return m.M11 + m.M22 + m.M33 + m.M44;
}

static void Main()
{
    var m = new Matrix4(1.5);
    Console.WriteLine(Trace(in m));   // 6
    Console.WriteLine(Trace(m));      // 6  (호출 쪽 in은 생략 가능)
}

ref, out과 달리 호출 쪽의 in은 생략할 수 있습니다. 또 in 매개변수에는 상수나 식(예: Trace(new Matrix4(2)))도 넘길 수 있는데, 이 경우 컴파일러가 임시 변수를 만들어 그 참조를 전달합니다.

in은 readonly struct와 함께 쓰는 것이 좋습니다. readonly가 아닌 struct의 메서드를 호출하면 원본이 바뀌지 않도록 컴파일러가 방어적 복사(defensive copy)를 만들어, 복사를 줄이려던 의도가 무색해질 수 있습니다. int, double 같은 작은 타입에는 in을 쓸 이유가 거의 없습니다.

참조 타입에 ref를 붙이면

class 같은 참조 타입은 원래 객체의 참조가 전달되므로 ref 없이도 객체의 내용은 바꿀 수 있습니다. ref가 필요한 경우는 변수가 가리키는 객체 자체를 바꿀 때입니다.

using System.Collections.Generic;

static void AddItem(List<int> list)
{
    list.Add(100);              // 같은 객체를 수정 → 호출 쪽에 반영됨
    list = new List<int>();     // 복사된 참조만 바뀜 → 호출 쪽에 반영 안 됨
}

static void Reset(ref List<int> list)
{
    list = new List<int> { 0 }; // 호출 쪽 변수가 새 객체를 가리킴
}

static void Main()
{
    var nums = new List<int> { 1, 2 };

    AddItem(nums);
    Console.WriteLine(string.Join(", ", nums));   // 1, 2, 100

    Reset(ref nums);
    Console.WriteLine(string.Join(", ", nums));   // 0
}

“참조 타입을 넘기는 것”과 “참조로 넘기는 것(ref)”은 다른 개념입니다. 앞의 것은 참조 값을 복사해서 넘기고, 뒤의 것은 변수 자체를 넘깁니다.

주의할 점

  • async 메서드와 반복기(yield return) 메서드에는 ref, out, in 매개변수를 쓸 수 없습니다.
  • 프로퍼티는 변수가 아니므로 ref나 out 인자로 넘길 수 없습니다. 필드나 지역 변수에 담아서 넘깁니다.
  • ref, out, in만 다른 오버로드는 만들 수 없습니다. 예를 들어 Foo(ref int)와 Foo(out int)를 함께 선언하면 컴파일 오류입니다. (한정자가 없는 Foo(int)와 Foo(ref int)는 함께 선언할 수 있습니다.)
  • 람다 식이나 로컬 함수 안에서 바깥의 ref, out, in 매개변수를 캡처할 수 없습니다.
  • out은 결과를 여러 개 돌려줄 때 편하지만, 결과가 많아지면 튜플이나 별도 클래스/record로 묶는 편이 읽기 쉽습니다.

참고

이상으로 C# ref, out, in 매개변수에 대해 간단히 알아보았습니다.