C# Ref (개발자들에게 어떻게 작동하는가)

ref 매개변수 이해하기

ref 매개변수는 메서드에 전달된 변수에 대한 참조로 작동하는 메서드 매개변수입니다. 표준 값 매개변수와 달리 변수의 복사본만 전달되는 경우와는 달리, ref 매개변수는 호출된 메서드가 원본 변수의 값을 수정할 수 있게 합니다. 이 행동은 메소드가 전달된 변수의 상태를 업데이트해야 할 때 필수적입니다.

매개변수의 값이 메서드 호출 동안 동일한 객체 내에서 유지되는 참조 형 변수가 어떻게 포커스 되는지를 보여주는 ref의 기본 사용법을 설명하는 다음 예시를 고려하십시오:

class Program
{
    static void Main()
    {
        int number = 100;
        ModifyNumber(ref number);
        Console.WriteLine(number); // Output: 200
    }

    // Method that modifies the original number through 'ref'
    static void ModifyNumber(ref int number)
    {
        number = 200; // Modifies the original value
    }
}

class Program
{
    static void Main()
    {
        int number = 100;
        ModifyNumber(ref number);
        Console.WriteLine(number); // Output: 200
    }

    // Method that modifies the original number through 'ref'
    static void ModifyNumber(ref int number)
    {
        number = 200; // Modifies the original value
    }
}

Friend Class Program
	Shared Sub Main()
		Dim number As Integer = 100
		ModifyNumber(number)
		Console.WriteLine(number) ' Output: 200
	End Sub

	' Method that modifies the original number through 'ref'
	Private Shared Sub ModifyNumber(ByRef number As Integer)
		number = 200 ' Modifies the original value
	End Sub
End Class

이 예시에서, Main 메서드는 정수 number를 선언하고 이를 100으로 초기화합니다. 그런 다음 ModifyNumber를 호출하여 number를 ref 매개변수로 전달합니다. ModifyNumber 내부에서 number의 값은 200으로 변경됩니다. number가 참조로 전달되기 때문에, 변화는 Main 메서드의 원본 값에 반영되어 200이 콘솔에 출력됩니다.

ref 매개변수가 작동하는 방식

ref 키워드로 메서드 매개변수를 선언할 때, 해당 매개변수가 복사본이 아닌 원본 변수에 대한 참조임을 컴파일러에게 알리는 것입니다. 이는 실제 값이 아닌 변수의 메모리 주소를 전달하여 달성됩니다. 호출된 메소드와 호출하는 메소드 모두 동일한 메모리 위치에 액세스하므로 매개변수에 대한 변경 사항이 원래 변수에 직접 적용됩니다.

ref을 이해하기 위한 핵심은 값 타입과 참조 타입 모두에서 사용할 수 있음을 인식하는 것입니다. 값 타입은 정수와 구조체처럼 간단한 데이터 타입을 포함하고, 참조 타입은 객체와 배열을 포함합니다. 참조형 변수는 본래 메모리 주소를 저장하고 있지만, ref을 참조형 타입과 함께 사용하는 것은 대상 객체의 내용만이 아니라 실제 참조를 수정할 수 있게 합니다.

ref와 out의 차이점

ref과 out 키워드 모두 원본 변수를 수정할 수 있게 하지만 중요한 차이점이 있습니다. out 매개변수는 메서드에 전달되기 전에 초기화가 필요하지 않습니다. 반면에, ref 매개변수는 변수 전달 전에 초기화 되어야 합니다. 더 나아가, out 매개변수를 사용하는 메서드는 메서드가 반환되기 전에 반드시 값을 지정해야 합니다. 이 요구 사항은 ref 매개변수에는 적용되지 않습니다.

여기서 out 키워드를 사용하는 방법을 알려드립니다:

class Program
{
    static void Main()
    {
        int result;
        CalculateResult(out result);
        Console.WriteLine(result); // Output: 100
    }

    // Method that calculates a result and assigns it via 'out'
    static void CalculateResult(out int calculation)
    {
        calculation = 20 * 5; // Must initialize the out parameter
    }
}

class Program
{
    static void Main()
    {
        int result;
        CalculateResult(out result);
        Console.WriteLine(result); // Output: 100
    }

    // Method that calculates a result and assigns it via 'out'
    static void CalculateResult(out int calculation)
    {
        calculation = 20 * 5; // Must initialize the out parameter
    }
}

Friend Class Program
	Shared Sub Main()
		Dim result As Integer = Nothing
		CalculateResult(result)
		Console.WriteLine(result) ' Output: 100
	End Sub

	' Method that calculates a result and assigns it via 'out'
	Private Shared Sub CalculateResult(ByRef calculation As Integer)
		calculation = 20 * 5 ' Must initialize the out parameter
	End Sub
End Class

이 경우, CalculateResult은 메서드 내에서 calculation을 초기화하고, Main는 결과를 반영합니다.

메소드 오버로딩에서 ref의 실용적인 사용

ref은 메서드 서명이 ref 키워드에 의해 변경되어 메서드 오버로딩에 사용될 수도 있습니다. 메서드 서명은 메서드 이름과 참조로 (ref), 값으로, 또는 out 매개변수로서 매개변수 타입을 포함합니다.

ref 및 값 매개변수에 기반하여 메서드를 오버로딩하는 것을 고려하십시오:

class Program
{
    static void Main()
    {
        int normalParameter = 10, refParameter = 10;
        IncrementValue(normalParameter);
        IncrementValue(ref refParameter);
        Console.WriteLine($"Normal: {normalParameter}, Ref: {refParameter}"); // Output: Normal: 10, Ref: 11
    }

    // Method that increments a copy of the integer
    static void IncrementValue(int number)
    {
        number++;
    }

    // Method that increments the original integer using 'ref'
    static void IncrementValue(ref int number)
    {
        number++;
    }
}

class Program
{
    static void Main()
    {
        int normalParameter = 10, refParameter = 10;
        IncrementValue(normalParameter);
        IncrementValue(ref refParameter);
        Console.WriteLine($"Normal: {normalParameter}, Ref: {refParameter}"); // Output: Normal: 10, Ref: 11
    }

    // Method that increments a copy of the integer
    static void IncrementValue(int number)
    {
        number++;
    }

    // Method that increments the original integer using 'ref'
    static void IncrementValue(ref int number)
    {
        number++;
    }
}

Friend Class Program
	Shared Sub Main()
		Dim normalParameter As Integer = 10, refParameter As Integer = 10
		IncrementValue(normalParameter)
		IncrementValue(refParameter)
		Console.WriteLine($"Normal: {normalParameter}, Ref: {refParameter}") ' Output: Normal: 10, Ref: 11
	End Sub

	' Method that increments a copy of the integer
'INSTANT VB TODO TASK: VB does not allow method overloads which differ only in parameter ByVal/ByRef:
'ORIGINAL LINE: static void IncrementValue(int number)
	Private Shared Sub IncrementValue(ByVal number As Integer)
		number += 1
	End Sub

	' Method that increments the original integer using 'ref'
'INSTANT VB TODO TASK: VB does not allow method overloads which differ only in parameter ByVal/ByRef:
'ORIGINAL LINE: static void IncrementValue(ref int number)
	Private Shared Sub IncrementValue(ByRef number As Integer)
		number += 1
	End Sub
End Class

여기서, IncrementValue은 하나의 버전이 일반 매개변수를 받고, 하나가 ref 매개변수를 받는 두 가지 버전으로 오버로딩됩니다. ref 버전은 원본 변수를 증가시키는 반면, 일반 버전은 복사본만 변경합니다.

IronPDF 소개

IronPDF .NET용 PDF Solutions는 PDF 문서 작업을 위한 포괄적인 .NET 라이브러리입니다. 주로 C#으로 구축되었으며 HTML 콘텐츠로부터의 PDF 생성을 단순화하는 데 중점을 두고 있습니다. Chrome 렌더링 엔진을 활용하여, IronPDF는 HTML, CSS, JavaScript 및 이미지 컨텐츠의 세부사항을 포착하는 고품질의 픽셀 완전한 PDF 문서를 제공합니다.

이 라이브러리는 다양한 .NET 환경을 지원하는 다재다능한 라이브러리로, .NET Framework, .NET Core 및 .NET Standard를 포함하며 데스크탑에서 웹 기반 시스템에 이르기까지 다양한 애플리케이션에 적합합니다. IronPDF는 PDF 생성 지원뿐만 아니라 PDF 수정, 보안, 그리고 다른 형식으로의 변환 기능도 제공합니다.

이 기능은 텍스트 및 이미지 추출, 양식 작성, 디지털 서명 적용까지 확대되어 .NET 애플리케이션 내에서 PDF 문서의 포괄적인 처리를 보장합니다.

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Set your IronPDF license key
        License.LicenseKey = "License-Key";

        // Initialize the value
        int totalSales = 150;

        // Modify the value within the method using 'ref'
        AddMonthlyBonus(ref totalSales);

        // Use IronPDF to generate a PDF report
        var Renderer = new ChromePdfRenderer();
        var PDF = Renderer.RenderHtmlAsPdf($"<h1>Monthly Sales Report</h1><p>Total Sales, including bonus: {totalSales}</p>");

        // Save the PDF to a file
        PDF.SaveAs("MonthlySalesReport.pdf");

        // Confirm the PDF has been generated
        Console.WriteLine("PDF generated successfully. Check your project directory.");
    }

    // Method that adds a monthly bonus to sales using 'ref'
    static void AddMonthlyBonus(ref int sales)
    {
        // Assume a bonus of 10% of the sales
        sales += (int)(sales * 0.1);
    }
}

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Set your IronPDF license key
        License.LicenseKey = "License-Key";

        // Initialize the value
        int totalSales = 150;

        // Modify the value within the method using 'ref'
        AddMonthlyBonus(ref totalSales);

        // Use IronPDF to generate a PDF report
        var Renderer = new ChromePdfRenderer();
        var PDF = Renderer.RenderHtmlAsPdf($"<h1>Monthly Sales Report</h1><p>Total Sales, including bonus: {totalSales}</p>");

        // Save the PDF to a file
        PDF.SaveAs("MonthlySalesReport.pdf");

        // Confirm the PDF has been generated
        Console.WriteLine("PDF generated successfully. Check your project directory.");
    }

    // Method that adds a monthly bonus to sales using 'ref'
    static void AddMonthlyBonus(ref int sales)
    {
        // Assume a bonus of 10% of the sales
        sales += (int)(sales * 0.1);
    }
}

Imports IronPdf
Imports System

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Set your IronPDF license key
		License.LicenseKey = "License-Key"

		' Initialize the value
		Dim totalSales As Integer = 150

		' Modify the value within the method using 'ref'
		AddMonthlyBonus(totalSales)

		' Use IronPDF to generate a PDF report
		Dim Renderer = New ChromePdfRenderer()
		Dim PDF = Renderer.RenderHtmlAsPdf($"<h1>Monthly Sales Report</h1><p>Total Sales, including bonus: {totalSales}</p>")

		' Save the PDF to a file
		PDF.SaveAs("MonthlySalesReport.pdf")

		' Confirm the PDF has been generated
		Console.WriteLine("PDF generated successfully. Check your project directory.")
	End Sub

	' Method that adds a monthly bonus to sales using 'ref'
	Private Shared Sub AddMonthlyBonus(ByRef sales As Integer)
		' Assume a bonus of 10% of the sales
		sales += CInt(Math.Truncate(sales * 0.1))
	End Sub
End Class

결론

C#에서 ref 키워드를 이해하는 것은 방법 간에 데이터가 전달되는 방식을 관리하기 위한 유용한 도구를 제공합니다. 매개변수로 전달된 원본 값들을 직접 수정할 수 있게 함으로써, ref은 메서드를 보다 유연하고 강력하게 만들 수 있습니다.

ref을 다루면서 경험이 쌓이면, 프로그래밍 요구사항을 충족하기 위해 언제 어떻게 효과적으로 사용할지에 대한 더 나은 이해를 하게 될 것입니다. IronPDF는 PDF 기능을 시작하기 위한 무료 체험을 제공하며 가격은 $999부터 시작합니다.