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

Článek
10/12/2023

Zahrňte hlavičku <cliext/utility> STL/CLR, která definuje šablonu pair třídy a několik podpůrných šablon funkcí.

Syntaxe

#include <cliext/utility>

Požadavky

Header:<cliext/utility>

Obor názvů: cliext

Deklarace

Třída	Popis
`pair`	Zabalte dvojici prvků.

Operátor	Popis
`operator==` (pár)	`pair` stejné porovnání.
`operator!=` (pár)	`pair` nerovná se porovnávání.
`operator<` (pár)	`pair` menší než porovnání.
`operator<=` (pár)	`pair` menší než nebo rovno porovnání.
`operator>` (pár)	`pair` větší než porovnání.
`operator>=` (pár)	`pair` větší než nebo rovno porovnání.

Function	Popis
`make_pair`	`pair` Vytvořte z dvojice hodnot.

`pair`

Třída šablony popisuje objekt, který zabalí dvojici hodnot.

Syntaxe

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

Parametry

Value1
Typ první zabalené hodnoty.

Value2
Typ druhé zabalené hodnoty.

Členové

Definice typu	Popis
`pair::first_type`	Typ první zabalené hodnoty.
`pair::second_type`	Typ druhé zabalené hodnoty.

Objekt člena	Popis
`pair::first`	První uložená hodnota.
`pair::second`	Druhá uložená hodnota.

Členová funkce	Popis
`pair::pair`	`pair` Vytvoří objekt.
`pair::swap`	Prohodí obsah dvou `pair` objektů.

Operátor	Popis
`pair::operator=`	Nahradí uloženou dvojici hodnot.

Poznámky

Objekt ukládá dvojici hodnot. Tuto třídu šablony použijete ke sloučení dvou hodnot do jednoho objektu. cliext::pair Objekt (popsaný zde) také ukládá pouze spravované typy; k uložení dvojice nespravovaných typů použití std::pair, deklarované v <utility>.

`pair::first`

První zabalená hodnota.

Syntaxe

Value1 first;

Poznámky

Objekt ukládá první zabalenou hodnotu.

Příklad

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

Typ první zabalené hodnoty.

Syntaxe

typedef Value1 first_type;

Poznámky

Typ je synonymem pro parametr Value1šablony .

Příklad

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

Nahradí uloženou dvojici hodnot.

Syntaxe

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

Parametry

right
pair kopírovat.

Poznámky

Operátor člena zkopíruje right objekt a pak vrátí *this. Slouží k nahrazení uložené dvojice hodnot kopií uložené dvojice hodnot v rightsouboru .

Příklad

// 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 Vytvoří objekt.

Syntaxe

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

Parametry

right
pair ukládat.

val1
První hodnota, kterou chcete uložit.

val2
Druhá hodnota k uložení.

Poznámky

Konstruktor:

pair();

inicializuje uloženou dvojici s výchozími vytvořenými hodnotami.

Konstruktor:

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

inicializuje uloženou dvojici s right.first a right.second.

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

inicializuje uloženou dvojici s right->first a right->second.

Konstruktor:

pair(Value1 val1, Value2 val2);

inicializuje uloženou dvojici s val1 a val2.

Příklad

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

Druhá zabalená hodnota.

Syntaxe

Value2 second;

Poznámky

Objekt ukládá druhou zalomenou hodnotu.

Příklad

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

Typ druhé zabalené hodnoty.

Syntaxe

typedef Value2 second_type;

Poznámky

Typ je synonymem pro parametr Value2šablony .

Příklad

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

Prohodí obsah dvou pair objektů.

Syntaxe

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

Parametry

right
pair prohození obsahu.

Poznámky

Členová funkce prohodí uloženou dvojici hodnot mezi *this hodnotami a right.

Příklad

// 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 Vytvořte z dvojice hodnot.

Syntaxe

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

Parametry

Value1
Typ první zabalené hodnoty.

Value2
Typ druhé zabalené hodnoty.

first
První hodnota, která se má zabalit.

second
Druhá hodnota, která se má zabalit.

Poznámky

Šablona funkce vrátí pair<Value1, Value2>(first, second). Použijete ho k vytvoření objektu pair<Value1, Value2> z dvojice hodnot.

Příklad

// 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!=` (pár)

pair nerovná se porovnávání.

Syntaxe

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

Parametry

left
Zbývá pair porovnat.

right
Přímo pair k porovnání.

Poznámky

Funkce operátoru vrátí !(left == right). Použijete ho k otestování, zda left není seřazeno stejně jako right když jsou dva pair objekty porovnávány elementem.

Příklad

// 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 menší než porovnání.

Syntaxe

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

Parametry

left
Zbývá pair porovnat.

right
Přímo pair k porovnání.

Poznámky

Funkce operátoru vrátí left.first < right.first || !(right.first < left.first && left.second < right.second. Použijete ho k otestování, zda left je seřazena před right , když jsou tyto dva pair objekty porovnávány elementem.

Příklad

// 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 menší než nebo rovno porovnání.

Syntaxe

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

Parametry

left
Zbývá pair porovnat.

right
Přímo pair k porovnání.

Poznámky

Funkce operátoru vrátí !(right < left). Použijete ho k otestování, zda left není seřazena za right , když jsou dva pair objekty porovnávány elementem.

Příklad

// 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 stejné porovnání.

Syntaxe

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

Parametry

left
Zbývá pair porovnat.

right
Přímo pair k porovnání.

Poznámky

Funkce operátoru vrátí left.first == right.first && left.second == right.second. Použijete ho k otestování, zda left je seřazeno stejně jako right když jsou tyto dva pair objekty porovnávány elementem.

Příklad

// 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 větší než porovnání.

Syntaxe

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

Parametry

left
Zbývá pair porovnat.

right
Přímo pair k porovnání.

Poznámky

Funkce operátoru vrátí right < left. Použijete ho k otestování, zda left je seřazena za right , když jsou dva pair objekty porovnávány elementem.

Příklad

// 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 větší než nebo rovno porovnání.

Syntaxe

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

Parametry

left
Zbývá pair porovnat.

right
Přímo pair k porovnání.

Poznámky

Funkce operátoru vrátí !(left < right). Použijete ho k otestování, zda left není seřazena před right tím, když jsou tyto dva pair objekty porovnávány elementem.

Příklad

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

Sdílet prostřednictvím

<cliext/utility> (STL/CLR)

Syntaxe

Požadavky

Deklarace

pair

Syntaxe

Parametry

Členové

Poznámky

pair::first

Syntaxe

Poznámky

Příklad

pair::first_type

Syntaxe

Poznámky

Příklad

pair::operator=

Syntaxe

Parametry

Poznámky

Příklad

pair::pair

Syntaxe

Parametry

Poznámky

Příklad

pair::second

Syntaxe

Poznámky

Příklad

pair::second_type

Syntaxe

Poznámky

Příklad

pair::swap

Syntaxe

Parametry

Poznámky

Příklad

make_pair

Syntaxe

Parametry

Poznámky

Příklad

operator!= (pár)

Syntaxe

Parametry

Poznámky

Příklad

operator<

Syntaxe

Parametry

Poznámky

Příklad

operator<=

Syntaxe

Parametry

Poznámky

Příklad

operator==

Syntaxe

Parametry

Poznámky

Příklad

pair::operator>

Syntaxe

Parametry

Poznámky

Příklad

operator>=

Syntaxe

Parametry

Poznámky

Příklad

Váš názor

Další materiály

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

`pair`

`pair::first`

`pair::first_type`

`pair::operator=`

`pair::pair`

`pair::second`

`pair::second_type`

`pair::swap`

`make_pair`

`operator!=` (pár)

`operator<`

`operator<=`

`operator==`

`pair::operator>`

`operator>=`