`<cliext/utility>` (STL/CLR)

아티클
10/12/2023

클래스 템플릿 및 여러 지원 함수 템플릿 pair 을 정의하려면 STL/CLR 헤더 <cliext/utility> 를 포함합니다.

구문

#include <cliext/utility>

요구 사항

헤더:<cliext/utility>

네임스페이스: cliext

선언

클래스	설명
`pair`	요소 쌍을 래핑합니다.

Operator	설명
`operator==` (pair)	`pair` 같음 비교입니다.
`operator!=` (pair)	`pair` 비교가 같지 않습니다.
`operator<` (pair)	`pair` 보다 작습니다.
`operator<=` (pair)	`pair` 보다 작거나 같은 비교입니다.
`operator>` (pair)	`pair` 비교보다 큼.
`operator>=` (pair)	`pair` 보다 크거나 같은 비교입니다.

함수	설명
`make_pair`	`pair` 값 쌍에서 만듭니다.

`pair`

템플릿 클래스는 값 쌍을 래핑하는 개체를 설명합니다.

구문

template<typename Value1,
    typename Value2>
    ref class pair;

매개 변수

Value1
첫 번째 래핑된 값의 형식입니다.

Value2
두 번째 래핑된 값의 형식입니다.

멤버

형식 정의	설명
`pair::first_type`	첫 번째 래핑된 값의 형식입니다.
`pair::second_type`	두 번째 래핑된 값의 형식입니다.

Member 개체	설명
`pair::first`	첫 번째 저장된 값입니다.
`pair::second`	두 번째 저장된 값입니다.

멤버 함수	설명
`pair::pair`	`pair` 개체를 생성합니다.
`pair::swap`	두 `pair` 개체의 내용을 바꿉니다.

Operator	설명
`pair::operator=`	저장된 값 쌍을 바꿉니다.

설명

개체는 값 쌍을 저장합니다. 이 템플릿 클래스를 사용하여 두 값을 단일 개체로 결합합니다. 또한 여기에 설명된 개체 cliext::pair 는 관리되는 형식만 저장합니다. 관리되지 않는 형식 쌍을 저장 std::pair하려면 에 선언되어 있습니다 <utility>.

`pair::first`

첫 번째 래핑된 값입니다.

구문

Value1 first;

설명

개체는 첫 번째 래핑된 값을 저장합니다.

예시

// cliext_pair_first.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);

    cliext::pair<wchar_t, int>::first_type first_val = c1.first;
    cliext::pair<wchar_t, int>::second_type second_val = c1.second;
    System::Console::WriteLine("[{0}, {1}]", first_val, second_val);
    return (0);
    }

[x, 3]

`pair::first_type`

첫 번째 래핑된 값의 형식입니다.

구문

typedef Value1 first_type;

설명

이 형식은 템플릿 매개 변수 Value1의 동의어입니다.

예시

// cliext_pair_first_type.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);

    cliext::pair<wchar_t, int>::first_type first_val = c1.first;
    cliext::pair<wchar_t, int>::second_type second_val = c1.second;
    System::Console::WriteLine("[{0}, {1}]", first_val, second_val);
    return (0);
    }

[x, 3]

`pair::operator=`

저장된 값 쌍을 바꿉니다.

구문

pair<Value1, Value2>% operator=(pair<Value1, Value2>% right);

매개 변수

right
pair 복사할 수 있습니다.

설명

멤버 연산자는 개체에 복사한 다음 반환합니다 right *this. 저장된 값 쌍을 저장된 값 right쌍의 복사본으로 바꾸는 데 사용합니다.

예시

// cliext_pair_operator_as.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);

// assign to a new pair
    cliext::pair<wchar_t, int> c2;
    c2 = c1;
    System::Console::WriteLine("[{0}, {1}]", c2.first, c2.second);
    return (0);
    }

[x, 3]
[x, 3]

`pair::pair`

pair 개체를 생성합니다.

구문

pair();
pair(pair<Coll>% right);
pair(pair<Coll>^ right);
pair(Value1 val1, Value2 val2);

매개 변수

right
pair 저장합니다.

val1
저장할 첫 번째 값입니다.

val2
저장할 두 번째 값입니다.

설명

생성자:

pair();

는 기본 생성 값을 사용하여 저장된 쌍을 초기화합니다.

생성자:

pair(pair<Value1, Value2>% right);

와 함께 저장된 쌍을 right.first 초기화합니다 right.second.

pair(pair<Value1, Value2>^ right);

와 함께 저장된 쌍을 right->first 초기화합니다 right->second.

생성자:

pair(Value1 val1, Value2 val2);

와 함께 저장된 쌍을 val1 초기화합니다 val2.

예시

// cliext_pair_construct.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
// construct an empty container
    cliext::pair<wchar_t, int> c1;
    System::Console::WriteLine("[{0}, {1}]",
        c1.first == L'\0' ? "\\0" : "??", c1.second);

// construct with a pair of values
    cliext::pair<wchar_t, int> c2(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c2.first, c2.second);

// construct by copying another pair
    cliext::pair<wchar_t, int> c3(c2);
    System::Console::WriteLine("[{0}, {1}]", c3.first, c3.second);

// construct by copying a pair handle
    cliext::pair<wchar_t, int> c4(%c3);
    System::Console::WriteLine("[{0}, {1}]", c4.first, c4.second);

    return (0);
    }

[\0, 0]
[x, 3]
[x, 3]
[x, 3]

`pair::second`

두 번째 래핑된 값입니다.

구문

Value2 second;

설명

개체는 두 번째 래핑된 값을 저장합니다.

예시

// cliext_pair_second.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);

    cliext::pair<wchar_t, int>::first_type first_val = c1.first;
    cliext::pair<wchar_t, int>::second_type second_val = c1.second;
    System::Console::WriteLine("[{0}, {1}]", first_val, second_val);
    return (0);
    }

[x, 3]

`pair::second_type`

두 번째 래핑된 값의 형식입니다.

구문

typedef Value2 second_type;

설명

이 형식은 템플릿 매개 변수 Value2의 동의어입니다.

예시

// cliext_pair_second_type.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);

    cliext::pair<wchar_t, int>::first_type first_val = c1.first;
    cliext::pair<wchar_t, int>::second_type second_val = c1.second;
    System::Console::WriteLine("[{0}, {1}]", first_val, second_val);
    return (0);
    }

[x, 3]

`pair::swap`

두 pair 개체의 내용을 바꿉니다.

구문

void swap(pair<Value1, Value2>% right);

매개 변수

right
pair 을 사용하여 콘텐츠를 교환합니다.

설명

멤버 함수는 저장된 값 쌍을 간에 *this 교환합니다 right.

예시

// cliext_pair_swap.cpp
// compile with: /clr
#include <cliext/adapter>
#include <cliext/deque>

typedef cliext::collection_adapter<
    System::Collections::ICollection> Mycoll;
int main()
    {
    cliext::deque<wchar_t> d1;
    d1.push_back(L'a');
    d1.push_back(L'b');
    d1.push_back(L'c');
    Mycoll c1(%d1);

// display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

// construct another container with repetition of values
    cliext::deque<wchar_t> d2(5, L'x');
    Mycoll c2(%d2);
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

// swap and redisplay
    c1.swap(c2);
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }

a b c
x x x x x
x x x x x
a b c

`make_pair`

pair 값 쌍에서 만듭니다.

구문

template<typename Value1,
    typename Value2>
    pair<Value1, Value2> make_pair(Value1 first, Value2 second);

매개 변수

Value1
첫 번째 래핑된 값의 형식입니다.

Value2
두 번째 래핑된 값의 형식입니다.

first
래핑할 첫 번째 값입니다.

second
래핑할 두 번째 값입니다.

설명

함수 템플릿은 .를 반환합니다 pair<Value1, Value2>(first, second). 이 값을 사용하여 값 쌍에서 개체를 생성 pair<Value1, Value2> 합니다.

예시

// cliext_make_pair.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);

    c1 = cliext::make_pair(L'y', 4);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);
    return (0);
    }

[x, 3]
[y, 4]

`operator!=` (pair)

pair 비교가 같지 않습니다.

구문

template<typename Value1,
    typename Value2>
    bool operator!=(pair<Value1, Value2>% left,
        pair<Value1, Value2>% right);

매개 변수

left
비교할 왼쪽 pair 입니다.

right
비교할 권리 pair 입니다.

설명

연산자 함수는 .를 반환합니다 !(left == right). 두 개체가 요소별로 비교될 때 pair 와 right 같은 순서가 지정되지 않았는지 여부를 left 테스트하는 데 사용합니다.

예시

// cliext_pair_operator_ne.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);
    cliext::pair<wchar_t, int> c2(L'x', 4);
    System::Console::WriteLine("[{0}, {1}]", c2.first, c2.second);

    System::Console::WriteLine("[x 3] != [x 3] is {0}",
        c1 != c1);
    System::Console::WriteLine("[x 3] != [x 4] is {0}",
        c1 != c2);
    return (0);
    }

[x, 3]
[x, 4]
[x 3] != [x 3] is False
[x 3] != [x 4] is True

`operator<`

pair 보다 작습니다.

구문

template<typename Value1,
    typename Value2>
    bool operator<(pair<Value1, Value2>% left,
        pair<Value1, Value2>% right);

매개 변수

left
비교할 왼쪽 pair 입니다.

right
비교할 권리 pair 입니다.

설명

연산자 함수는 .를 반환합니다 left.first < right.first || !(right.first < left.first && left.second < right.second. 두 개체가 요소별로 비교될 때 pair 이전 right 순서가 지정되었는지 여부를 left 테스트하는 데 사용합니다.

예시

// cliext_pair_operator_lt.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);
    cliext::pair<wchar_t, int> c2(L'x', 4);
    System::Console::WriteLine("[{0}, {1}]", c2.first, c2.second);

    System::Console::WriteLine("[x 3] < [x 3] is {0}",
        c1 < c1);
    System::Console::WriteLine("[x 3] < [x 4] is {0}",
        c1 < c2);
    return (0);
    }

[x, 3]
[x, 4]
[x 3] < [x 3] is False
[x 3] < [x 4] is True

`operator<=`

pair 보다 작거나 같은 비교입니다.

구문

template<typename Value1,
    typename Value2>
    bool operator<=(pair<Value1, Value2>% left,
        pair<Value1, Value2>% right);

매개 변수

left
비교할 왼쪽 pair 입니다.

right
비교할 권리 pair 입니다.

설명

연산자 함수는 .를 반환합니다 !(right < left). 두 개체가 요소별로 비교된 후 right pair 정렬되지 않는지 여부를 left 테스트하는 데 사용합니다.

예시

// cliext_pair_operator_le.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);
    cliext::pair<wchar_t, int> c2(L'x', 4);
    System::Console::WriteLine("[{0}, {1}]", c2.first, c2.second);

    System::Console::WriteLine("[x 3] <= [x 3] is {0}",
        c1 <= c1);
    System::Console::WriteLine("[x 4] <= [x 3] is {0}",
        c2 <= c1);
    return (0);
    }

[x, 3]
[x, 4]
[x 3] <= [x 3] is True
[x 4] <= [x 3] is False

`operator==`

pair 같음 비교입니다.

구문

template<typename Value1,
    typename Value2>
    bool operator==(pair<Value1, Value2>% left,
        pair<Value1, Value2>% right);

매개 변수

left
비교할 왼쪽 pair 입니다.

right
비교할 권리 pair 입니다.

설명

연산자 함수는 .를 반환합니다 left.first == right.first && left.second == right.second. 두 개체가 요소별로 비교될 때 pair 와 right 같은 순서가 지정되는지 여부를 left 테스트하는 데 사용합니다.

예시

// cliext_pair_operator_eq.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);
    cliext::pair<wchar_t, int> c2(L'x', 4);
    System::Console::WriteLine("[{0}, {1}]", c2.first, c2.second);

    System::Console::WriteLine("[x 3] == [x 3] is {0}",
        c1 == c1);
    System::Console::WriteLine("[x 3] == [x 4] is {0}",
        c1 == c2);
    return (0);
    }

[x, 3]
[x, 4]
[x 3] == [x 3] is True
[x 3] == [x 4] is False

`pair::operator>`

pair 비교보다 큼.

구문

template<typename Value1,
    typename Value2>
    bool operator>(pair<Value1, Value2>% left,
        pair<Value1, Value2>% right);

매개 변수

left
비교할 왼쪽 pair 입니다.

right
비교할 권리 pair 입니다.

설명

연산자 함수는 .를 반환합니다 right < left. 두 개체가 요소별로 비교된 후 right pair 순서가 지정되는지 여부를 left 테스트하는 데 사용합니다.

예시

// cliext_pair_operator_gt.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);
    cliext::pair<wchar_t, int> c2(L'x', 4);
    System::Console::WriteLine("[{0}, {1}]", c2.first, c2.second);

    System::Console::WriteLine("[x 3] > [x 3] is {0}",
        c1 > c1);
    System::Console::WriteLine("[x 4] > [x 3] is {0}",
        c2 > c1);
    return (0);
    }

[x, 3]
[x, 4]
[x 3] > [x 3] is False
[x 4] > [x 3] is True

`operator>=`

pair 보다 크거나 같은 비교입니다.

구문

template<typename Value1,
    typename Value2>
    bool operator>=(pair<Value1, Value2>% left,
        pair<Value1, Value2>% right);

매개 변수

left
비교할 왼쪽 pair 입니다.

right
비교할 권리 pair 입니다.

설명

연산자 함수는 .를 반환합니다 !(left < right). 두 pair 개체가 요소별로 비교될 때 이전에 right 순서가 지정되지 않았는지 여부를 left 테스트하는 데 사용합니다.

예제

// cliext_pair_operator_ge.cpp
// compile with: /clr
#include <cliext/utility>

int main()
    {
    cliext::pair<wchar_t, int> c1(L'x', 3);
    System::Console::WriteLine("[{0}, {1}]", c1.first, c1.second);
    cliext::pair<wchar_t, int> c2(L'x', 4);
    System::Console::WriteLine("[{0}, {1}]", c2.first, c2.second);

    System::Console::WriteLine("[x 3] >= [x 3] is {0}",
        c1 >= c1);
    System::Console::WriteLine("[x 3] >= [x 4] is {0}",
        c1 >= c2);
    return (0);
    }

[x, 3]
[x, 4]
[x 3] >= [x 3] is True
[x 3] >= [x 4] is False

다음을 통해 공유

<cliext/utility> (STL/CLR)

구문

요구 사항

선언

pair

구문

매개 변수

멤버

설명

pair::first

구문

설명

예시

pair::first_type

구문

설명

예시

pair::operator=

구문

매개 변수

설명

예시

pair::pair

구문

매개 변수

설명

예시

pair::second

구문

설명

예시

pair::second_type

구문

설명

예시

pair::swap

구문

매개 변수

설명

예시

make_pair

구문

매개 변수

설명

예시

operator!= (pair)

구문

매개 변수

설명

예시

operator<

구문

매개 변수

설명

예시

operator<=

구문

매개 변수

설명

예시

operator==

구문

매개 변수

설명

예시

pair::operator>

구문

매개 변수

설명

예시

operator>=

구문

매개 변수

설명

예제

피드백

추가 리소스

`<cliext/utility>` (STL/CLR)

`pair`

`pair::first`

`pair::first_type`

`pair::operator=`

`pair::pair`

`pair::second`

`pair::second_type`

`pair::swap`

`make_pair`

`operator!=` (pair)

`operator<`

`operator<=`

`operator==`

`pair::operator>`

`operator>=`