Microsoft MVP성태의 닷넷 이야기
.NET Framework: 1111. C# - FormattableString 타입 [링크 복사], [링크+제목 복사],
조회: 17359
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)

C# - FormattableString 타입

C#의 언어 발전을 보면, 참 재미있는 현상을 하나 볼 수 있습니다.

가령, 어떤 기능이 추가되면, 그로 인해 또 다른 기능이 필요해진다는 점입니다. 예를 들어 지난번 Lambda 개선도 그 한 예입니다. 메서드를 람다 식으로 정의할 수 있도록 해줬더니, 람다 식을 정적(static) 메서드로도 지원해야 하고, 특성도 지정할 수 있게 바꿔야 하는 것입니다.

FormattableString도 그와 같은 연유로 나온 것입니다. 일반적이었다면 이것은 필요 없는 타입입니다. 그런데, 문자열 보간 문법이 C# 6에 추가되면서 "추가되어야만" 했던 기능입니다. 이 타입에 대한 자세한 설명을 다음의 책이 하고 있습니다.

C#을 다루는 기술 - 9.3 FormattableString을 사용한 현지화 (371페이지)
; http://www.yes24.com/Product/Goods/101511486

이에 대해 간략하게 정리를 해볼까요? ^^

일단, 보간 문법이 String.Format으로 바뀐다는 사실은 익히 알고 있을 것입니다.

// C# 5.0 이전에는 string.Format으로 처리
string text = string.Format("{0}", DateTime.Now);

// C# 6.0 이후부터 문자열 보간 지원
// 보간 문자열을 C# 컴파일러는 string.Format으로 변경
string text = $"{DateTime.Now}";

그런데, 여기엔 작은 문제가 하나 있습니다. 보간 문자열을 지원하기 전에는, 문자열에 대해 Localization을 하고 싶다면 string.Format에 CultureInfo를 받아들이는 오버로드 메서드를 사용하면 됐습니다.

public static string Format(IFormatProvider? provider, string format, object? arg0)
public static string Format(string format, object? arg0)

반면, 문자열 보간에서는 저 "IFormatProvider? provider"를 받아들일 수 있는 방법이 없는 것입니다. 이로 인해 마이크로소프트는 보간 문자열을 위한 CultureInfo를 반영할 수 있도록 .NET 4.6/.NET Standard 1.3부터 FormattableString을 만들었고, C# 컴파일러에서도 다시 이를 지원하기 위한 변경을 추가합니다. 즉, 보간 문자열을 string 타입으로도 받을 수 있지만, FormattableString 타입으로도 받을 수 있게 한 것입니다.

// C# 컴파일러는, 보간 문자열의 반환 타입이 string이라면 string.Format으로 변경
string text1 = $"test: {v.ToString()}, {subText.ToString()}";

// 만약 보간 문자열의 반환 타입이 FormattableString이라면 (string.Format으로 처리하지 않고) FormattableString 인스턴스를 반환
FormattableString text2 = $"test: {v.ToString()}, {subText.ToString()}";

// 만약 var로 추론하는 경우라면 string으로 판단해 string.Format 처리
var text3 = $"test: {v.ToString()}, {subText.ToString()}";

// FormattableString은 IFormattable을 상속한 추상 클래스이고,
// 정확한 반환 타입은 FormattableString을 상속한 System.Runtime.CompilerServices.FormattableStringFactory.ConcreteFormattableString
IFormattable text4 = $"test: {v.ToString()}, {subText.ToString()}";

뭐랄까, 이것은 마치 람다 표현식이 대입이 되는 대상 타입에 따라 ExpressionTree 또는 Delegate로 처리되는 것과 유사합니다. 이렇게 FormattableString으로 받게 되면 이후 "문자열 보간"에서는 지원하지 못했던 Localization을 다음과 같이 처리할 수 있습니다.

// 중립 처리
string t1 = FormattableString.Invariant(text2);      
string t2 = text2.ToString(CultureInfo.InvariantCulture); // t1 == t2

// Localization 명시
string t3 = text2.ToString(CultureInfo.GetCultureInfo("en-US"));

// 현재 스레드의 Localization 처리
string t4 = FormattableString.CurrentCulture(text2);     
string t5 = text2.ToString(); // t4 == t5

얼핏 보면, FormattableString의 등장으로 인해 사용법이 더 복잡해진 것 같은데요, 그래도 간략화하면 이전의 string.Format과 유사한 정도로 단순해집니다.

{
    DateTime now = DateTime.UtcNow;

    // string.Format에서 중립 처리
    string text1 = string.Format(CultureInfo.InvariantCulture, "{0:yyyy-MM-dd}", now);

    // FormattableString에서 중립 처리
    string text2 = FormattableString.Invariant($"{now:yyyy-MM-dd}");
    string text3 = $"{now:yyyy-MM-dd}".ToString(CultureInfo.InvariantCulture);
              // = ((FormattableString)$"{now:yyyy-MM-dd}").ToString(CultureInfo.InvariantCulture);
} 

그나저나, "https://miriam40.github.io/2019/07/15/5-post/" 글에 보면, effective C#의 예제라면서 다음의 코드를 소개하는데요,

public static string ToGerman(FormattableString src)
{
   return string.Format(CultureInfo.CreateSpecificCulture("de-de"), src.Format, src.GetArguments());
}

public static string ToGerman(FormattableString src)
{
   return string.Format(CultureInfo.CreateSpecificCulture("fr-CA"), src.Format, src.GetArguments());
}

좀 복잡하게 해서 그렇지, 이것 역시 다음과 같이 단순화할 수 있습니다.

static string ToGerman(FormattableString src)
{
    return src.ToString(CultureInfo.GetCultureInfo("de-de"));
}

static string ToFrench(FormattableString src)
{
    return src.ToString(CultureInfo.GetCultureInfo("fr-CA"));
}




위의 소스 코드에서 FormattableString의 Format과 GetArguments() 메서드를 볼 수 있는데요, 사실 C# 컴파일러는 FormattableString으로 반환해야 하는 보간 문자열을 만나면 string.Format이 아닌, 포맷 문자열과 인자 목록을 별도로 취해 FormattableString으로 넘겨주는 역할을 합니다.

string name = "World";
FormattableString text = $"Hello {name}";

// 아래와 같이 처리
ConcreteFormattableString
    Format = "Hello {0}";
    Arguments = object [] { name };

그러니까, 최종 문자열이 반환되기보다는 중간 처리 결과를 보관하고 있으므로 일종의 "지연 연산"과 같은 기능을 하는 것입니다. 그리고, LINQ 쿼리에서 Expression Tree로 받아 SQL 쿼리를 생성했던 것처럼, 위와 같은 특성으로 FormattableString 역시 그와 유사한 전처리를 할 수 있는 여지가 있습니다.

"C#을 다루는 기술" 책에서는 FormattableString의 그런 특성을 반영해, raw query를 Parameterized Query로 자동으로 변형해 주는 코드를 보여줍니다. (관심있으신 분은 책 구매로... ^^)

그런데 만약, C# 컴파일러 개발진이 문자열 보간에 CultureInfo를 받아들일 수 있는 쪽으로 보완을 했다면 어땠을까요? ^^

// 컴파일되지 않음!
string text = $(CultureInfo.GetCultureInfo("de-de"))"{DateTime.Now}";

만약 저런 형식을 허용했다면 FormattableString은 나오지 않았을지도 모를 일입니다. ^^




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 8/31/2021]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13945정성태6/7/2025426오류 유형: 960. 파이썬 + conda - mysqlclient 사용 시 "NameError: name '_mysql' is not defined" 에러
13944정성태6/7/2025457오류 유형: 959. The trust relationship between this workstation and the primary domain failed. - 네 번째 이야기
13943정성태6/6/2025651개발 환경 구성: 748. Windows + Foundry Local - 로컬에서 AI 모델 활용
13942정성태6/5/2025861오류 유형: 958. winget 설치 시 "0x80d02002 : unknown error"
13941정성태6/2/20251023닷넷: 2334. C# - cpuid 명령어를 이용한 CPU 제조사 문자열 가져오기파일 다운로드1
13940정성태6/1/20251406C/C++: 188. C++의 32비트 + Release 어셈블리 코드를 .NET으로 포팅할 때 주의할 점파일 다운로드1
13939정성태5/29/20251694오류 유형: 957. NVIDIA Triton Inference Server - version `GLIBCXX_3.4.32' not found (required by /opt/tritonserver/backends/python/triton_python_backend_stub)
13938정성태5/29/20251435개발 환경 구성: 747. 파이썬 - WSL/docker에 구성한 Triton 예제 개발 환경
13937정성태5/24/20251355개발 환경 구성: 746. Windows + WSL2 환경에서 (tensorflow 등의) NVIDIA GPU 인식
13936정성태5/23/20251187개발 환경 구성: 745. Linux / WSL 환경에 Miniconda 설치하기
13935정성태5/20/20251230파이썬 - pip 사용 시 "ImportError: cannot import name 'html5lib' from 'pip._vendor'" 오류
13934정성태5/20/20251709스크립트: 77. 파이썬 - 'urllib.request' 모듈의 명시적/암시적 로딩 차이
13933정성태5/19/20251287오류 유형: 956. Visual Studio 2022가 17.12 버전부터 업데이트 되지 않는다면?
13932정성태5/18/20251499스크립트: 76. 파이썬 - Version 문자열 다루기(semver 패키지)
13931정성태5/17/20251791스크립트: 75. 파이썬 - Cython 기본 예제 및 컴파일
13930정성태5/17/20251489개발 환경 구성: 744. 파이썬 - Windows embeddable package 환경에서 외부 패키지 사용하는 방법(ex: UFO² 환경 구성)
13929정성태5/16/20251508오류 유형: 955. 파이썬 - "Windows embeddable package" REPL 환경에서 "NameError: name 'exit' is not defined"
13928정성태5/15/20251553오류 유형: 954. UFO² - "'Invalid URL (POST /v1/chat/completions/chat/completions)'"
13927정성태5/15/20251545오류 유형: 953. OpenAI - The API request of HOST_AGENT failed: OpenAI API request exceeded rate limit: Error code: 429
13926정성태5/14/20251907개발 환경 구성: 743. LLM과 윈도우의 만남 - Desktop AgentOS UFO² 기본 환경 구성
13925정성태5/12/20252006닷넷: 2333. C# - (Console 유형의 프로젝트에서) Clipboard 연동파일 다운로드1
13924정성태5/8/20251757닷넷: 2332. C# - (JetBrains Omea Reader 대상으로) 런타임 시에 메서드 가로채기 [2]파일 다운로드1
13923정성태5/5/20251503스크립트: 74. 파이썬 - C# - Python.NET의 RunSimpleScript, Exec, Eval 차이점파일 다운로드1
13922정성태5/3/20251751스크립트: 73. 파이썬 - Windows embeddable package 버전에서 tkinter 환경 구성
13921정성태5/3/20252264오류 유형: 952. 듀얼 채널 메모리 정렬을 지키지 않은 컴퓨터의 Windows 비정상 종료 현상(Blue Screen) [2]
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...