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

Artikel
10/12/2023

Sertakan header <cliext/utility> STL/CLR untuk menentukan templat pair kelas dan beberapa templat fungsi pendukung.

Sintaks

#include <cliext/utility>

Persyaratan

Header:<cliext/utility>

kumpulan nama XML: cliext

Deklarasi

Kelas	Deskripsi
`pair`	Bungkus sepasang elemen.

Operator	Deskripsi
`operator==` (pasangan)	`pair` perbandingan yang sama.
`operator!=` (pasangan)	`pair` tidak sama dengan perbandingan.
`operator<` (pasangan)	`pair` kurang dari perbandingan.
`operator<=` (pasangan)	`pair` kurang dari atau perbandingan yang sama.
`operator>` (pasangan)	`pair` lebih besar dari perbandingan.
`operator>=` (pasangan)	`pair` lebih besar dari atau perbandingan yang sama.

Fungsi	Deskripsi
`make_pair`	`pair` Buat dari sepasang nilai.

`pair`

Kelas templat menjelaskan objek yang membungkus sepasang nilai.

Sintaks

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

Parameter

Value1
Jenis nilai pertama yang dibungkus.

Value2
Jenis nilai kedua yang dibungkus.

Anggota

Definisi jenis	Deskripsi
`pair::first_type`	Jenis nilai pertama yang dibungkus.
`pair::second_type`	Jenis nilai kedua yang dibungkus.

Objek anggota	Deskripsi
`pair::first`	Nilai pertama yang disimpan.
`pair::second`	Nilai tersimpan kedua.

Fungsi anggota	Deskripsi
`pair::pair`	Membuat `pair` objek.
`pair::swap`	Menukar isi dua `pair` objek.

Operator	Deskripsi
`pair::operator=`	Menggantikan pasangan nilai yang disimpan.

Keterangan

Objek menyimpan sepasang nilai. Anda menggunakan kelas templat ini untuk menggabungkan dua nilai ke dalam satu objek. Selain itu, objek cliext::pair (dijelaskan di sini) hanya menyimpan jenis terkelola; untuk menyimpan sepasang jenis yang tidak dikelola menggunakan std::pair, dideklarasikan dalam <utility>.

`pair::first`

Nilai pertama yang dibungkus.

Sintaks

Value1 first;

Keterangan

Objek menyimpan nilai pertama yang dibungkus.

Contoh

// 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`

Jenis nilai pertama yang dibungkus.

Sintaks

typedef Value1 first_type;

Keterangan

Jenisnya adalah sinonim untuk parameter Value1templat .

Contoh

// 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=`

Menggantikan pasangan nilai yang disimpan.

Sintaks

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

Parameter

right
pair untuk disalin.

Keterangan

Operator anggota menyalin right ke objek, lalu mengembalikan *this. Anda menggunakannya untuk mengganti pasangan nilai yang disimpan dengan salinan pasangan nilai yang disimpan di right.

Contoh

// 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`

Membuat pair objek.

Sintaks

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

Parameter

right
pair untuk menyimpan.

val1
Nilai pertama yang disimpan.

val2
Nilai kedua untuk disimpan.

Keterangan

Konstruktor:

pair();

menginisialisasi pasangan tersimpan dengan nilai default yang dibuat.

Konstruktor:

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

menginisialisasi pasangan tersimpan dengan right.first dan right.second.

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

menginisialisasi pasangan tersimpan dengan right->first dan right->second.

Konstruktor:

pair(Value1 val1, Value2 val2);

menginisialisasi pasangan tersimpan dengan val1 dan val2.

Contoh

// 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`

Nilai kedua yang dibungkus.

Sintaks

Value2 second;

Keterangan

Objek menyimpan nilai kedua yang dibungkus.

Contoh

// 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`

Jenis nilai kedua yang dibungkus.

Sintaks

typedef Value2 second_type;

Keterangan

Jenisnya adalah sinonim untuk parameter Value2templat .

Contoh

// 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`

Menukar isi dua pair objek.

Sintaks

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

Parameter

right
pair untuk menukar konten dengan.

Keterangan

Fungsi anggota menukar pasangan nilai yang disimpan antara *this dan right.

Contoh

// 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 Buat dari sepasang nilai.

Sintaks

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

Parameter

Value1
Jenis nilai pertama yang dibungkus.

Value2
Jenis nilai kedua yang dibungkus.

first
Nilai pertama yang akan dibungkus.

second
Nilai kedua untuk dibungkus.

Keterangan

Templat fungsi mengembalikan pair<Value1, Value2>(first, second). Anda menggunakannya untuk membuat pair<Value1, Value2> objek dari sepasang nilai.

Contoh

// 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!=` (pasangan)

pair tidak sama dengan perbandingan.

Sintaks

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

Parameter

left
Kiri pair untuk membandingkan.

right
Hak pair untuk membandingkan.

Keterangan

Fungsi operator mengembalikan !(left == right). Anda menggunakannya untuk menguji apakah left tidak diurutkan sama seperti right ketika dua pair objek dibandingkan elemen berdasarkan elemen.

Contoh

// 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 kurang dari perbandingan.

Sintaks

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

Parameter

left
Kiri pair untuk membandingkan.

right
Hak pair untuk membandingkan.

Keterangan

Fungsi operator mengembalikan left.first < right.first || !(right.first < left.first && left.second < right.second. Anda menggunakannya untuk menguji apakah left diurutkan sebelumnya right ketika dua pair objek dibandingkan elemen berdasarkan elemen.

Contoh

// 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 kurang dari atau perbandingan yang sama.

Sintaks

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

Parameter

left
Kiri pair untuk membandingkan.

right
Hak pair untuk membandingkan.

Keterangan

Fungsi operator mengembalikan !(right < left). Anda menggunakannya untuk menguji apakah left tidak diurutkan setelah right ketika dua pair objek dibandingkan elemen berdasarkan elemen.

Contoh

// 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 perbandingan yang sama.

Sintaks

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

Parameter

left
Kiri pair untuk membandingkan.

right
Hak pair untuk membandingkan.

Keterangan

Fungsi operator mengembalikan left.first == right.first && left.second == right.second. Anda menggunakannya untuk menguji apakah left diurutkan sama seperti right ketika dua pair objek dibandingkan elemen berdasarkan elemen.

Contoh

// 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 lebih besar dari perbandingan.

Sintaks

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

Parameter

left
Kiri pair untuk membandingkan.

right
Hak pair untuk membandingkan.

Keterangan

Fungsi operator mengembalikan right < left. Anda menggunakannya untuk menguji apakah left diurutkan setelah right ketika dua pair objek dibandingkan elemen berdasarkan elemen.

Contoh

// 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 lebih besar dari atau perbandingan yang sama.

Sintaks

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

Parameter

left
Kiri pair untuk membandingkan.

right
Hak pair untuk membandingkan.

Keterangan

Fungsi operator mengembalikan !(left < right). Anda menggunakannya untuk menguji apakah left tidak diurutkan sebelumnya right ketika dua pair objek dibandingkan elemen berdasarkan elemen.

Contoh

// 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

Bagikan melalui

<cliext/utility> (STL/CLR)

Sintaks

Persyaratan

Deklarasi

pair

Sintaks

Parameter

Anggota

Keterangan

pair::first

Sintaks

Keterangan

Contoh

pair::first_type

Sintaks

Keterangan

Contoh

pair::operator=

Sintaks

Parameter

Keterangan

Contoh

pair::pair

Sintaks

Parameter

Keterangan

Contoh

pair::second

Sintaks

Keterangan

Contoh

pair::second_type

Sintaks

Keterangan

Contoh

pair::swap

Sintaks

Parameter

Keterangan

Contoh

make_pair

Sintaks

Parameter

Keterangan

Contoh

operator!= (pasangan)

Sintaks

Parameter

Keterangan

Contoh

operator<

Sintaks

Parameter

Keterangan

Contoh

operator<=

Sintaks

Parameter

Keterangan

Contoh

operator==

Sintaks

Parameter

Keterangan

Contoh

pair::operator>

Sintaks

Parameter

Keterangan

Contoh

operator>=

Sintaks

Parameter

Keterangan

Contoh

Saran dan Komentar

Sumber Daya Tambahan:

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

`pair`

`pair::first`

`pair::first_type`

`pair::operator=`

`pair::pair`

`pair::second`

`pair::second_type`

`pair::swap`

`make_pair`

`operator!=` (pasangan)

`operator<`

`operator<=`

`operator==`

`pair::operator>`

`operator>=`