CodeGym /課程 /C# SELF /值元組 (Value Tuples) 入門

值元組 (Value Tuples) 入門

C# SELF
等級 11, 課堂 1
開放

1. 前言

寫程式就像打包行李:通常你不只要帶一樣東西,常常要同時帶好幾樣。比如說襪子跟手機充電器。而且你也不會為了暫時放兩三樣東西就去買個新行李箱 class(class 我們之後會學)。有時候你只是想從 function 一次回傳兩三個值。那該怎麼辦?

有幾個老派的做法。比如回傳陣列(int[] arr = {a, b};),或是寫個 class 只為了一個 function 用的欄位。還有其他更複雜的方式,我們之後會學(像是 out 參數或用全域變數傳值)。但你一定想現在就有個簡單、現代又不囉嗦的解法吧!

這時候 C# 7 推出了 值元組(Value Tuple):超方便又簡潔的語法,讓你可以臨時把不同型別的值打包成一組,不用自己搞一個新的資料型別。這不只方便,還讓你的 code 看起來超有型。

2. 認識元組 (Value Tuples)

元組就像程式設計師的魔法袋,可以把幾個不同的值塞進同一個「包包」一起帶著走。你可以把它想成寫便條紙,不用為每個小東西都開一個新資料夾!

Value Tuple(System.ValueTuple)是一種變色龍結構,可以裝 2 到 8 個完全不同型別的元素。你想把數字、字串、布林值塞一起?沒問題!元組完全不挑食。

不同型別元組的建立範例


// tuple — 這是 (int, string, bool) - 等級、暱稱、線上
var tuple = (42, "酷玩家_2024", true);

看到沒?不用 class、不用多餘的儀式!直接用括號逗號包起來就好。這就像程式界的速食店:快、方便,剛好解決你當下的需求。
最棒的是,元組可以「現做現用」,直接在 code 裡組出來。超適合那種你只是想臨時傳資料或打包一下的情境。幹嘛大費周章寫 class,能優雅簡單就解決?

3. 元組語法與基本宣告

先從最簡單的來:沒有元素名稱。

var point = (10, 20);
Console.WriteLine(point.Item1); // 10
Console.WriteLine(point.Item2); // 20
沒有名字的元組:用 Item1, Item2 取值

這裡 point 是兩個元素的元組(int, int)。取值用 Item1、Item2 這些欄位(最多到 Item7)。如果元素超過,從第八個開始會包在 Rest 欄位(這個我們等下講)。這裡的 point.Item1 跟 point.Item2 是 ValueTuple<int, int> 結構自動產生的欄位名稱。

為什麼用 var?


(int, int) point = (10, 20);
你也可以明確指定型別

小建議: 用 var 很方便,C# 會自動推斷型別。但如果你想強調自己在用元組,也可以明寫型別。

4. 元組元素命名

說真的,Item1 跟 Item2 這種名字很難懂。可以更好!你可以給元素取名字:

var person = (Name: "愛麗絲", Age: 20);
Console.WriteLine(person.Name); // 愛麗絲
Console.WriteLine(person.Age);  // 20
有名字的元組

現在每個元素都有意義的名字。超棒!這樣不只自己看得懂,IDE 自動補齊也很方便。

可以混用有名字跟沒名字嗎?

可以,C# 允許,但如果元組超過兩個元素或每個值意義不同,最好都給名字:

var data = (42, Name: "鮑勃", true);
Console.WriteLine(data.Item1); // 42
Console.WriteLine(data.Name);  // 鮑勃
Console.WriteLine(data.Item3); // true

5. 方法回傳和接收元組

最常見的情境:你想從方法一次回傳多個值。比如你要解析字串時同時拿到數字跟成功狀態。

範例:計算兩數的和與積

想像你要寫個 function,接收兩個數字,同時回傳它們的和跟積。如果沒元組,你要嘛用 out 參數(這個我們之後會學),要嘛寫個 class 或 struct 只為這個目的(這就違背了 Value Tuples「臨時打包不同型別值,不用自己搞型別」的精神)。

用元組從方法回傳多個值:


// 方法回傳兩個值的元組:和與積
(int sum, int product) CalculateSumAndProduct(int a, int b)
{
    return (a + b, a * b);
}

// 呼叫方法
var calculationResult = CalculateSumAndProduct(10, 5);

// 輸出結果
Console.WriteLine($"和: {calculationResult.sum}");
Console.WriteLine($"積: {calculationResult.product}");

6. 元組的限制與特性

看起來很完美的東西,還是有些眉角。我們來看看。

元素數量

C# 的元組最多直接支援 7 個元素。超過的話,第八個開始會包在巢狀元組(Rest)。但如果你真的需要這樣,可能該考慮寫個 struct 或 class。

var bigTuple = (1, 2, 3, 4, 5, 6, 7, 8);

// .NET 會自動把第八個包進巢狀元組
Console.WriteLine(bigTuple.Item8); // 8

可變性

ValueTuple 是可變結構!你可以在建立後改任何欄位(但別太常這樣,免得 code 變魔法)。

var t = (a: 1, b: 2);
t.a = 5; // 這樣可以!

7. 元組在實務專案和面試的用途

元組讓你可以快速、輕鬆地從方法回傳多個值,不用多寫 class 或 struct。超適合臨時打包資料——像是查詢或過濾集合、寫測試、或任何暫時運算。

而且元組很適合把結果直接解構到多個變數(比如 LINQ 查詢後),讓 code 更直觀又簡潔。

面試 junior 工程師時常會問:「怎麼從方法一次回傳多個值?」——最理想的答案就是用 ValueTuple。要記得,這是支援命名元素和解構的 struct,不像舊的參考型 Tuple<T1, T2>。

但如果你要處理長期保存或商業邏輯的資料,或是回傳欄位太多(超過七個),還是建議寫個有意義屬性的 class 或 struct。

8. 常見錯誤與陷阱

錯誤一:元組元素名稱拼錯。
Item1、Item2 跟命名元素都存在 ValueTuple 型別裡。如果你名字寫錯,code 會編譯過,但執行時或 IDE 找不到這個屬性才會出錯。一定要確認名字完全正確!

錯誤二:解構時名字不會保留。
當你用 var (first, second) = tuple; 解構沒命名的元組時,新的變數 first 跟 second 只是區域變數,原本的 Item1/Item2 還是沒名字。為了避免混亂,最好一開始就給元組明確的名字:

var tuple = (X: 5, Y: 10);
var (x, y) = tuple;  // x == 5, y == 10

錯誤三:忽略 struct 的語意。
ValueTuple 是 struct,所以傳進方法或賦值時會被複製。你在 function 裡改它,只會改到本地 copy,不會動到原本的元組。如果你希望元素「原地」被改,一定要用回傳值或用參考型別。

2
任務
C# SELF, 等級 11, 課堂 1
上鎖
建立一個簡單的元組並操作它
建立一個簡單的元組並操作它
2
任務
C# SELF, 等級 11, 課堂 1
上鎖
從方法返回 Tuple
從方法返回 Tuple
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION