Tuple 클래스

정의

튜플 개체를 작성하는 정적 메서드를 제공합니다.Provides static methods for creating tuple objects.

public ref class Tuple abstract sealed
public static class Tuple
type Tuple = class
Public Class Tuple
상속
Tuple

예제

다음 예에서는 20 미만의 소수를 포함 하는 8 튜플 (octuple)을 만듭니다.The following example creates an 8-tuple (octuple) that contains prime numbers that are less than 20.

var primes = Tuple.Create(2, 3, 5, 7, 11, 13, 17, 19);
Console.WriteLine("Prime numbers less than 20: " + 
                  "{0}, {1}, {2}, {3}, {4}, {5}, {6}, and {7}",
                  primes.Item1, primes.Item2, primes.Item3, 
                  primes.Item4, primes.Item5, primes.Item6,
                  primes.Item7, primes.Rest.Item1);
// The example displays the following output:
//    Prime numbers less than 20: 2, 3, 5, 7, 11, 13, 17, and 19
Dim primes = Tuple.Create(2, 3, 5, 7, 11, 13, 17, 19)
Console.WriteLine("Prime numbers less than 20: " + 
                  "{0}, {1}, {2}, {3}, {4}, {5}, {6}, and {7}",
                  primes.Item1, primes.Item2, primes.Item3, 
                  primes.Item4, primes.Item5, primes.Item6,
                  primes.Item7, primes.Rest.Item1)
' The example displays the following output:
'     Prime numbers less than 20: 2, 3, 5, 7, 11, 13, 17, and 19

설명

튜플은 특정 수와 요소의 시퀀스를 포함 하는 데이터 구조입니다.A tuple is a data structure that has a specific number and sequence of elements. 튜플의 예는 세 개의 요소 (3-튜플 또는 3 개)가 있는 데이터 구조로, 첫 번째 요소에서 사람의 이름과 같은 식별자, 두 번째 요소의 연도 및 세 번째 요소의 해당 연도에 대 한 사용자의 수입을 저장 하는 데 사용 됩니다.An example of a tuple is a data structure with three elements (known as a 3-tuple or triple) that is used to store an identifier such as a person's name in the first element, a year in the second element, and the person's income for that year in the third element. .NET Framework는 1 ~ 7 개의 요소로 튜플을 직접 지원 합니다.The .NET Framework directly supports tuples with one to seven elements. 또한 개체의 속성에 튜플 개체를 중첩 하 여 8 개 이상의 요소로 튜플을 만들 수 있습니다 Rest Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> .In addition, you can create tuples of eight or more elements by nesting tuple objects in the Rest property of a Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> object.

튜플은 일반적으로 다음과 같은 네 가지 방법으로 사용 됩니다.Tuples are commonly used in four ways:

  • 단일 데이터 집합을 나타냅니다.To represent a single set of data. 예를 들어 튜플은 데이터베이스 레코드를 나타낼 수 있으며 해당 구성 요소는 레코드의 개별 필드를 나타낼 수 있습니다.For example, a tuple can represent a database record, and its components can represent individual fields of the record.

  • 데이터 집합에 쉽게 액세스 하 고 조작할 수 있도록 합니다.To provide easy access to, and manipulation of, a data set.

  • out매개 변수 (c #의 경우) 또는 ByRef 매개 변수 (Visual Basic)를 사용 하지 않고 메서드에서 여러 값을 반환 합니다.To return multiple values from a method without using out parameters (in C#) or ByRef parameters (in Visual Basic).

  • 단일 매개 변수를 통해 여러 값을 메서드에 전달 하려면입니다.To pass multiple values to a method through a single parameter. 예를 들어 Thread.Start(Object) 메서드는 시작 시 스레드가 실행 하는 메서드에 하나의 값을 제공할 수 있는 단일 매개 변수를 포함 합니다.For example, the Thread.Start(Object) method has a single parameter that lets you supply one value to the method that the thread executes at startup time. 개체를 메서드 인수로 제공 하는 경우 Tuple<T1,T2,T3> 세 개의 데이터 항목을 사용 하 여 스레드의 시작 루틴을 제공할 수 있습니다.If you supply a Tuple<T1,T2,T3> object as the method argument, you can supply the thread's startup routine with three items of data.

Tuple클래스 자체가 튜플을 나타내지 않는 경우The Tuple class does not itself represent a tuple. 대신 .NET Framework에서 지 원하는 튜플 형식의 인스턴스를 만드는 정적 메서드를 제공 하는 클래스입니다.Instead, it is a class that provides static methods for creating instances of the tuple types that are supported by the .NET Framework. 각 튜플 구성 요소의 형식을 명시적으로 지정 하지 않고도 튜플 개체를 인스턴스화하기 위해 호출할 수 있는 도우미 메서드를 제공 합니다.It provides helper methods that you can call to instantiate tuple objects without having to explicitly specify the type of each tuple component.

클래스 생성자를 호출 하 여 튜플 클래스의 인스턴스를 만들 수 있지만이 작업을 수행 하는 코드는 복잡할 수 있습니다.Although you can create an instance of a tuple class by calling its class constructor, the code to do so can be cumbersome. 다음 예제에서는 클래스 생성자를 사용 하 여 1950에서 2000 까지의 각 인구 조사에 대 한 뉴욕 도시 인구 데이터를 포함 하는 7-튜플 또는 7 중를 만듭니다.The following example uses a class constructor to create a 7-tuple or septuple that contains population data for New York City for each census from 1950 through 2000.

// Create a 7-tuple.
var population = new Tuple<string, int, int, int, int, int, int>(
                           "New York", 7891957, 7781984, 
                           7894862, 7071639, 7322564, 8008278);
// Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7);
// The example displays the following output:
//       Population of New York in 2000: 8,008,278
' Create a 7-tuple.
Dim population As New Tuple(Of String, Integer, Integer, Integer, Integer, Integer, Integer) _
                           ("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278)
' Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7)
' The example displays the following output:
'        Population of New York in 2000: 8,008,278

다음 예제와 같이 도우미 메서드를 사용 하 여 동일한 튜플 개체를 만드는 것이 더 간단 합니다.Creating the same tuple object by using a helper method is more straightforward, as the following example shows.

// Create a 7-tuple.
var population = Tuple.Create("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278);
// Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7);
// The example displays the following output:
//       Population of New York in 2000: 8,008,278
' Create a 7-tuple.
Dim population = Tuple.Create("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278)
' Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7)
' The example displays the following output:
'        Population of New York in 2000: 8,008,278

Create도우미 메서드는 1 ~ 8 개의 구성 요소 (즉, octuples 통해 단일 항목)가 있는 튜플 개체를 직접 만들 수 있도록 지원 합니다.The Create helper methods directly support the creation of tuple objects that have from one to eight components (that is, singletons through octuples). 튜플에 포함할 수 있는 구성 요소 수에 대 한 실질적인 제한은 없지만 도우미 메서드를 사용 하 여 9 개 이상의 구성 요소가 있는 튜플을 만들 수는 없습니다.Although there is no practical limit to the number of components a tuple may have, helper methods are not available to create a tuple with nine or more components. 이러한 튜플을 만들려면 생성자를 호출 해야 합니다 Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> .To create such a tuple, you must call the Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> constructor.

참고

튜플을 사용 하는 추가 정보 및 예제는 .NET Framework에서 개별 튜플 형식에 대 한 설명서를 참조 하세요.For additional information and examples that use tuples, see the documentation for the individual tuple types in the .NET Framework. 이러한 항목은이 항목의 끝 부분에 있는 참고 항목 섹션에 나열 되어 있습니다.These are listed in the See Also section at the end of this topic.

메서드

Create<T1,T2,T3,T4,T5,T6,T7,T8>(T1, T2, T3, T4, T5, T6, T7, T8)

8개의 요소로 구성된 새 튜플을 만듭니다.Creates a new 8-tuple, or octuple.

Create<T1,T2,T3,T4,T5,T6,T7>(T1, T2, T3, T4, T5, T6, T7)

7개의 요소로 구성된 새 튜플 또는 7중을 만듭니다.Creates a new 7-tuple, or septuple.

Create<T1,T2,T3,T4,T5,T6>(T1, T2, T3, T4, T5, T6)

6개의 요소로 구성된 새 튜플 또는 6중을 만듭니다.Creates a new 6-tuple, or sextuple.

Create<T1,T2,T3,T4,T5>(T1, T2, T3, T4, T5)

5개의 요소로 구성된 새 튜플 또는 5중을 만듭니다.Creates a new 5-tuple, or quintuple.

Create<T1,T2,T3,T4>(T1, T2, T3, T4)

4개의 요소로 구성된 새 튜플 또는 4중을 만듭니다.Creates a new 4-tuple, or quadruple.

Create<T1,T2,T3>(T1, T2, T3)

3개의 요소로 구성된 새 튜플 또는 3중을 만듭니다.Creates a new 3-tuple, or triple.

Create<T1,T2>(T1, T2)

2개의 요소로 구성된 새 튜플 또는 쌍을 만듭니다.Creates a new 2-tuple, or pair.

Create<T1>(T1)

1개의 요소로 구성된 새 튜플 또는 singleton을 만듭니다.Creates a new 1-tuple, or singleton.

적용 대상

추가 정보