C Sharpの基礎 - タプル - 版の履歴

Wiki: /* 複数の値をメソッドから受け取る */

2021-03-12T15:56:08Z

複数の値をメソッドから受け取る

← 古い版		2021年3月13日 (土) 00:56時点における版
184行目:		184行目:
	<br>		<br>
	C# 7以降では、タプルを受け取る時に分解することも可能である。(タプルの要素を個別の変数に代入する)<br>		C# 7以降では、タプルを受け取る時に分解することも可能である。(タプルの要素を個別の変数に代入する)<br>
	<~~source~~ lang="c#">		<syntaxhighlight lang="c#">
	var (p, q) = NewExchange1(2, 3);		var (p, q) = NewExchange1(2, 3);
	WriteLine($"p={p}, q={q}");		WriteLine($"p={p}, q={q}");
	</~~source~~>		</syntaxhighlight>
	<br>		<br>
	また、(p, _)のようにして、タプルとして返された値で使用しない要素を<code>_</code>で削除することもできる。(<code>_</code>は書き込み専用の変数)<br>		また、(p, _)のようにして、タプルとして返された値で使用しない要素を<code>_</code>で削除することもできる。(<code>_</code>は書き込み専用の変数)<br>

Wiki: /* 複数の値をメソッドから受け取る */

2021-03-12T15:55:39Z

複数の値をメソッドから受け取る

← 古い版		2021年3月13日 (土) 00:55時点における版
161行目:		161行目:

	== 複数の値をメソッドから受け取る ==		== 複数の値をメソッドから受け取る ==
	~~ValueTuple構造体を返すメソッドの基本的な呼び出し方は、次のコードのようになる。~~<br>		<code>ValueTuple</code>構造体を返すメソッドの基本的な使用方法は、以下のように記述する。<br>
	<~~source~~ lang="c#">		<syntaxhighlight lang="c#">
	// タプル名なし(既定の名前Item1 / Item2等でアクセスする)		// タプル名なし(既定の名前Item1 / Item2等でアクセスする)
	var tResult1 = NewExchange1(2, 3);		var tResult1 = NewExchange1(2, 3);
170行目:		170行目:
	var tResult2 = NewExchange2(2, 3);		var tResult2 = NewExchange2(2, 3);
	WriteLine($"tResult2.x={tResult2.x}, tResult2.y={tResult2.y}");		WriteLine($"tResult2.x={tResult2.x}, tResult2.y={tResult2.y}");
	</~~source~~>		</syntaxhighlight>
	~~あるいは、次のコードのように、受け取るときに別のタプル名を付けることもできる。~~<br>		<br>
	<~~source~~ lang="c++">		また、以下のように、受け取る時に別のタプル名を付けることもできる。<br>
			<syntaxhighlight lang="c#">
	// タプル名なしで返すメソッド		// タプル名なしで返すメソッド
	(int X, int Y) tResult1 = NewExchange1(2, 3);		(int X, int Y) tResult1 = NewExchange1(2, 3);
	WriteLine($"tResult1.X={tResult1.X}, tResult1.Y={tResult1.Y}");		WriteLine($"tResult1.X={tResult1.X}, tResult1.Y={tResult1.Y}");

	// ~~タプル名付きで返してくるメソッド~~		// タプル名付きで返すメソッド
	(int M, int N) tResult2 = NewExchange2(2, 3);		(int M, int N) tResult2 = NewExchange2(2, 3);
	WriteLine($"tResult1.X={tResult1.M}, tResult1.Y={tResult1.N}");		WriteLine($"tResult1.X={tResult1.M}, tResult1.Y={tResult1.N}");
	</~~source~~>		</syntaxhighlight>
	<br>		<br>
	~~更に、C~~# ~~7では、タプルを受け取るときにいきなり分解することも可能である。~~(タプルの要素を個別の変数に代入する)<br>		C# 7以降では、タプルを受け取る時に分解することも可能である。(タプルの要素を個別の変数に代入する)<br>
	<source lang="c#">		<source lang="c#">
	var (p, q) = NewExchange1(2, 3);		var (p, q) = NewExchange1(2, 3);
188行目:		189行目:
	</source>		</source>
	<br>		<br>
	また、(p, _)~~のようにして、タプルとして返された値で使わない要素を「_」で示すこともできる。~~(~~「_」は書き込み専用の変数~~)<br>		また、(p, _)のようにして、タプルとして返された値で使用しない要素を<code>_</code>で削除することもできる。(<code>_</code>は書き込み専用の変数)<br>
	<~~source~~ lang="c#">		<syntaxhighlight lang="c#">
	var (p, _) = NewExchange1(2, 3);		var (p, _) = NewExchange1(2, 3);
	WriteLine($"p={p}");		WriteLine($"p={p}");
	</~~source~~>		</syntaxhighlight>
	<br><br>		<br><br>

	__FORCETOC__		__FORCETOC__
	[[カテゴリ:C_Sharp]]		[[カテゴリ:C_Sharp]]

Wiki: /* 複数の値をまとめてメソッドから返す */

2021-03-12T15:44:43Z

複数の値をまとめてメソッドから返す

← 古い版		2021年3月13日 (土) 00:44時点における版
131行目:		131行目:

	== 複数の値をまとめてメソッドから返す ==		== 複数の値をまとめてメソッドから返す ==
	~~前述したValueTuple構造体を返すメソッドは、タプル構文を使うと次のように簡潔に書ける。~~<br>		<code>ValueTuple</code>構造体を返すメソッドは、タプル構文を使用することで簡潔に記述できる。<br>
	~~ValueTuple~~<int, int>~~という型の宣言は、タプル構文では~~(int, int)と同義である。<br>		<br>
	~~タプルを生成するValueTuple~~.Create(y, x)~~式は、タプル構文では~~(y, x)~~と書くだけでよい。~~<br>		例えば、ValueTuple<int, int>型は、タプル構文では(int, int)と同義である。<br>
	<~~source~~ lang="c#">		また、タプルを生成するValueTuple.Create(y, x)は、タプル構文では(y, x)と記述するだけでよい。<br>
	~~タプル構文でタプル名を付けずに2つの値を返す例~~		<br>
	// ~~ValueTuple構造体を直接使う書き方(前述)~~		以下の例では、タプル構文でタプル名を付けずに2つの値を返している。<br>
			以下のように記述する場合、戻り値を受け取る側では、タプル内の要素を<code>Item1</code>および<code>Item2</code>という既定の名前で参照できる。<br>
			<syntaxhighlight lang="c#">
			// ValueTuple構造体を直接記述する
	static ValueTuple<int, int> NewExchange1(int x, int y) => ValueTuple.Create(y, x);		static ValueTuple<int, int> NewExchange1(int x, int y) => ValueTuple.Create(y, x);

	// ~~タプル構文を使って上と同義のコードを書く~~		// 上と同義の処理を、タプル構文を使用して記述する
	static (int, int) NewExchange1(int x, int y) => (y, x);		static (int, int) NewExchange1(int x, int y) => (y, x);
	</~~source>~~		</syntaxhighlight>
	~~上のように記述した場合、戻り値を受け取った側では、タプル内の要素をItem1 / Item2という既定の名前で参照できる。<br~~>
	<br>		<br>
	~~次のコードのようにしてタプル名を付けると、戻り値を受け取った側ではタプル内の要素をタプル名で参照できる。~~<br>		以下のように、タプル名を付けることにより、戻り値を受け取る側ではタプル内の要素をタプル名で参照できる。<br>
	~~なお、タプル名はTupleElementNames属性~~(System.Runtime.~~CompilerServices名前空間~~)~~によって実現されているが、~~<br>		<br>
			なお、タプル名は<code>TupleElementNames</code>属性(<code>System.Runtime.CompilerServices</code>名前空間)により実現されているが、<br>
	この属性を直接コーディングすることはできない。(タプル構文が強制される)<br>		この属性を直接コーディングすることはできない。(タプル構文が強制される)<br>
	<~~source~~ lang="c#">		<br>
	~~タプル構文でタプル名を付けて2つの値を返す例~~		以下の例では、タプル構文でタプル名を付けて2つの値を返している。<br>
			戻り値を受け取る側では、タプル内の要素をxおよびyというタプル名で参照できる。<br>
			<syntaxhighlight lang="c#">
	static (int x, int y) NewExchange2(int x, int y) => (y, x);		static (int x, int y) NewExchange2(int x, int y) => (y, x);
	</~~source~~>		</syntaxhighlight>
	~~上のように記述した場合、戻り値を受け取った側では、タプル内の要素をx / yというタプル名で参照できる。~~<br>		<br>
	適切なタプル名を付けておくことで、可読性が良くなる。<br>		適切なタプル名を付けておくことで、可読性が良くなる。<br>
	<br><br>		<br><br>

Wiki: /* TupleクラスとValueTuple構造体 */

2021-03-12T15:35:21Z

TupleクラスとValueTuple構造体

← 古い版		2021年3月13日 (土) 00:35時点における版
119行目:		119行目:
	Tupleクラスは.NET Fremework 4.0からあり、ValueTuple構造体は.NET Fremework 4.7で導入された。<br>		Tupleクラスは.NET Fremework 4.0からあり、ValueTuple構造体は.NET Fremework 4.7で導入された。<br>
	これら2つはよく似ており、例えば、2つの値をまとめて返すメソッドを次のコードのように記述できる。<br>		これら2つはよく似ており、例えば、2つの値をまとめて返すメソッドを次のコードのように記述できる。<br>
	<~~source~~ lang="c#">		<syntaxhighlight lang="c#">
	// Tupleクラス(.NET Fremework 4.0以降)		// Tupleクラス(.NET Fremework 4.0以降)
	static Tuple<int, int> OldExchange(int x, int y) => Tuple.Create(y, x);		static Tuple<int, int> OldExchange(int x, int y) => Tuple.Create(y, x);
127行目:		127行目:
	static (int, int) NewExchange(int x, int y) => (y, x);		static (int, int) NewExchange(int x, int y) => (y, x);
	static (int x, int y) NewExchange(int x, int y) => (y, x);		static (int x, int y) NewExchange(int x, int y) => (y, x);
	</~~source~~>		</syntaxhighlight>
	<br><br>		<br><br>

Wiki: /* TupleクラスとValueTuple構造体の比較 */

2021-03-12T15:33:08Z

TupleクラスとValueTuple構造体の比較

← 古い版		2021年3月13日 (土) 00:33時点における版
65行目:		65行目:
	<code>ValueTuple</code>構造体は、null非許容の値型であるため、<code>null</code>で初期化できない。<br>		<code>ValueTuple</code>構造体は、null非許容の値型であるため、<code>null</code>で初期化できない。<br>
	<syntaxhighlight lang="c#">		<syntaxhighlight lang="c#">
	// ~~null非許容の値型であるため、nullを~~ '(int, string)' に変換できません		// ValueTuple構造体は、null非許容の値型であるため、nullを '(int, string)' に変換できません
	(int, string) vt = null;		(int, string) vt = null;

74行目:		74行目:
	==== メンバの種類 ====		==== メンバの種類 ====
	<code>ValueTuple</code>構造体のメンバはフィールドであるため、以下の2つの特徴がある。<br>		<code>ValueTuple</code>構造体のメンバはフィールドであるため、以下の2つの特徴がある。<br>
	* out / ~~refキーワードの引数に渡すことができる。~~		* <code>out</code> / <code>ref</code>キーワードの引数に渡すことができる。
	* プロパティを前提としたFWでは使用できない。(例. バインディング等)		* プロパティを前提としたFWでは使用できない。(例. バインディング等)
	<syntaxhighlight lang="c#">		<syntaxhighlight lang="c#">
81行目:		81行目:

	var t = Tuple.Create(1, "a");		var t = Tuple.Create(1, "a");
	// Add(ref t.Item1); // プロパティまたはインデクサをout / refキーワードの引数に渡すことはできない		// Add(ref t.Item1); // コンパイルエラー
			// プロパティまたはインデクサをout / refキーワードの引数に渡すことはできない
	</syntaxhighlight>		</syntaxhighlight>
	<br>		<br>
88行目:		89行目:
	<code>ValueTuple</code>構造体のメンバはフィールドであるため、ミュータブルである。<br>		<code>ValueTuple</code>構造体のメンバはフィールドであるため、ミュータブルである。<br>
	<syntaxhighlight lang="c#">		<syntaxhighlight lang="c#">
	// 割り当て可能		// ValueTuple構造体割り当て可能
	var vt = (1, "a");		var vt = (1, "a");
	vt.Item1 = 2;		vt.Item1 = 2;

	// ~~Tuple<int, string>.Item1(プロパティまたはインデクサ)は読み取り専用であるため、割り当てることはできない~~		// Tupleクラス割り当て不可
	var t = Tuple.Create(1, "a");		var t = Tuple.Create(1, "a");
	// t.Item1 = 2;		// t.Item1 = 2; // コンパイルエラー
			// Tuple<int, string>.Item1(プロパティまたはインデクサ)は読み取り専用であるため、割り当てることはできない

	// ~~<anonymous type: int Item1, string Item2>.Item1(プロパティまたはインデクサ)は読み取り専用であるため、割り当てることはできない~~		// 匿名型割り当て不可
	var a = new { Item1 = 1, Item2 = "a" };		var a = new { Item1 = 1, Item2 = "a" };
	// a.Item1 = 2;		// a.Item1 = 2; // コンパイルエラー
			// <anonymous type: int Item1, string Item2>.Item1(プロパティまたはインデクサ)は読み取り専用であるため、割り当てることはできない
	</syntaxhighlight>		</syntaxhighlight>
	<br>		<br>

Wiki: /* TupleクラスとValueTuple構造体 */

2021-03-12T15:27:16Z

TupleクラスとValueTuple構造体

← 古い版		2021年3月13日 (土) 00:27時点における版
122行目:		122行目:
	// ValueTuple構造体(.NET Fremework 4.7以降)		// ValueTuple構造体(.NET Fremework 4.7以降)
	static ValueTuple<int, int> NewExchange(int x, int y) => ValueTuple.Create(y, x);		static ValueTuple<int, int> NewExchange(int x, int y) => ValueTuple.Create(y, x);
			static (int, int) NewExchange(int x, int y) => (y, x);
			static (int x, int y) NewExchange(int x, int y) => (y, x);
	</source>		</source>
	<br><br>		<br><br>

Wiki: /* TupleクラスとValueTuple構造体の比較 */

2021-03-12T15:17:42Z

TupleクラスとValueTuple構造体の比較

@@ 30行目: / 30行目: @@
 |}
 </center>
 <br><br>

Wiki: /* 概要 */

2021-03-12T14:39:52Z

概要

@@ 1行目: / 1行目: @@
 == 概要 ==
 専用のクラスや構造体を定義するほどのことでもないが、複数のオブジェクトを一時的に1つに纏めたい時がある。<br>
 例えば、今までは、メソッドは1つのオブジェクトしか返せなかったので、複数の結果を返す場合は、複数の結果を格納するためだけに型を定義したり、<br>
 あるいは、out引数を使用していた。<br>
 <br>
-.NET Framework 4.7で導入されたValueTuple構造体(System名前空間)とVisual Studio 2017(C#7)で導入されたタプル構文を使えば、<br>
+.NET Framework 4.7で導入されたValueTuple構造体(System名前空間)とVisual Studio 2017(C# 7)で導入されたタプル構文を使えば、<br>
 簡単に複数の結果を一時的に1つに纏められる。<br>
 ここでは、それらの新しい機能のうち、メソッドから複数の結果を返す方法について解説する。<br>
 <br><br>

Wiki: Wiki がページ「C Sharpの基礎 - ValueTuple」を「C Sharpの基礎 - タプル」に、リダイレクトを残さずに移動しました

2021-03-05T05:13:46Z

Wiki がページ「C Sharpの基礎 - ValueTuple」を「C Sharpの基礎 - タプル」に、リダイレクトを残さずに移動しました

← 古い版		2021年3月5日 (金) 14:13時点における版
(相違点なし)

Wiki: Wiki がページ「ValueTupleの使用方法」を「C Sharpの基礎 - ValueTuple」に、リダイレクトを残さずに移動しました

2020-04-21T13:46:53Z

Wiki がページ「ValueTupleの使用方法」を「C Sharpの基礎 - ValueTuple」に、リダイレクトを残さずに移動しました

← 古い版	2020年4月21日 (火) 22:46時点における版
(相違点なし)

Wiki: ページの作成:「== 概要 == 専用のクラスや構造体を定義するほどのことでもないが、複数のオブジェクトを一時的に1つに纏めたい時がある。
2020-01-06T23:01:22Z

ページの作成:「== 概要 == 専用のクラスや構造体を定義するほどのことでもないが、複数のオブジェクトを一時的に1つに纏めたい時がある。<br…」

新規ページ
== 概要 ==
専用のクラスや構造体を定義するほどのことでもないが、複数のオブジェクトを一時的に1つに纏めたい時がある。 
例えば、今までは、メソッドは1つのオブジェクトしか返せなかったので、複数の結果を返す場合は、複数の結果を格納するためだけに型を定義したり、 
あるいは、out引数を使用していた。 
 
.NET Framework 4.7で導入されたValueTuple構造体(System名前空間)とVisual Studio 2017(C#7)で導入されたタプル構文を使えば、 
簡単に複数の結果を一時的に1つに纏められる。 
ここでは、それらの新しい機能のうち、メソッドから複数の結果を返す方法について解説する。 
 

== TupleクラスとValueTuple構造体 ==
Tupleクラスは.NET Fremework 4.0からあり、ValueTuple構造体は.NET Fremework 4.7で導入された。 
これら2つはよく似ており、例えば、2つの値をまとめて返すメソッドを次のコードのように記述できる。 
<source lang="c#">
// Tupleクラス(.NET Fremework 4.0以降)
static Tuple<int, int> OldExchange(int x, int y) => Tuple.Create(y, x);

// ValueTuple構造体(.NET Fremework 4.7以降)
static ValueTuple<int, int> NewExchange(int x, int y) => ValueTuple.Create(y, x);
</source>
 

== 複数の値をまとめてメソッドから返す ==
前述したValueTuple構造体を返すメソッドは、タプル構文を使うと次のように簡潔に書ける。 
ValueTuple<int, int>という型の宣言は、タプル構文では(int, int)と同義である。 
タプルを生成するValueTuple.Create(y, x)式は、タプル構文では(y, x)と書くだけでよい。 
<source lang="c#">
タプル構文でタプル名を付けずに2つの値を返す例
// ValueTuple構造体を直接使う書き方(前述)
static ValueTuple<int, int> NewExchange1(int x, int y) => ValueTuple.Create(y, x);

// タプル構文を使って上と同義のコードを書く
static (int, int) NewExchange1(int x, int y) => (y, x);
</source>
上のように記述した場合、戻り値を受け取った側では、タプル内の要素をItem1 / Item2という既定の名前で参照できる。 
 
次のコードのようにしてタプル名を付けると、戻り値を受け取った側ではタプル内の要素をタプル名で参照できる。 
なお、タプル名はTupleElementNames属性(System.Runtime.CompilerServices名前空間)によって実現されているが、 
この属性を直接コーディングすることはできない。(タプル構文が強制される) 
<source lang="c#">
タプル構文でタプル名を付けて2つの値を返す例
static (int x, int y) NewExchange2(int x, int y) => (y, x);
</source>
上のように記述した場合、戻り値を受け取った側では、タプル内の要素をx / yというタプル名で参照できる。 
適切なタプル名を付けておくことで、可読性が良くなる。 
 

== 複数の値をメソッドから受け取る ==
ValueTuple構造体を返すメソッドの基本的な呼び出し方は、次のコードのようになる。 
<source lang="c#">
// タプル名なし(既定の名前Item1 / Item2等でアクセスする)
var tResult1 = NewExchange1(2, 3);
WriteLine($"tResult1.Item1={tResult1.Item1}, tResult1.Item2={tResult1.Item2}");

// タプル名付き
var tResult2 = NewExchange2(2, 3);
WriteLine($"tResult2.x={tResult2.x}, tResult2.y={tResult2.y}");
</source>
あるいは、次のコードのように、受け取るときに別のタプル名を付けることもできる。 
<source lang="c++">
// タプル名なしで返すメソッド
(int X, int Y) tResult1 = NewExchange1(2, 3);
WriteLine($"tResult1.X={tResult1.X}, tResult1.Y={tResult1.Y}");

// タプル名付きで返してくるメソッド
(int M, int N) tResult2 = NewExchange2(2, 3);
WriteLine($"tResult1.X={tResult1.M}, tResult1.Y={tResult1.N}");
</source>
 
更に、C# 7では、タプルを受け取るときにいきなり分解することも可能である。(タプルの要素を個別の変数に代入する) 
<source lang="c#">
var (p, q) = NewExchange1(2, 3);
WriteLine($"p={p}, q={q}");
</source>
 
また、(p, _)のようにして、タプルとして返された値で使わない要素を「_」で示すこともできる。(「_」は書き込み専用の変数) 
<source lang="c#">
var (p, _) = NewExchange1(2, 3);
WriteLine($"p={p}");
</source>
 

FORCETOC
[[カテゴリ:C_Sharp]]