std::reference_wrapper

 

C++

Язык

Понятия (концепции)

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод / вывод

Локализация

Регулярные выражения (C++11)

Атомарные примитивы (C++11)

Потоки (C++11)

 

Утилиты библиотеки

Поддежка типов (базовые типы, RTTI, type traits)

Динамическое управление памятью

Обработка ошибок

Управление жизненным циклом программы

Функции с переменным числом аргументов

Дата и время

Функциональные объекты

initializer_list (C++11)

bitset

hash (C++11)

Реляционные операторы

rel_ops::operator!= rel_ops::operator> rel_ops::operator<= rel_ops::operator>=

Пары и кортежи

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

Обмен, передача и перемещение

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

declval (C++11)

 

Функция объектов

Функция обертки Оригинал: Function wrappers Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
function (C++11)
mem_fn (C++11)
bad_function_call (C++11)
Привязка Оригинал: Bind Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
bind (C++11)
is_bind_expression (C++11)
is_placeholder (C++11)
_1, _2, _3, ... (C++11)
Ссылка обертки Оригинал: Reference wrappers Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
reference_wrapper (C++11)
ref cref (C++11) (C++11)
Оператор обертки Оригинал: Operator wrappers Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
plus minus negate multiplies divides modulus logical_and logical_or logical_not	equal_to not_equal_to greater less greater_equal less_equal bit_and bit_or bit_xor
Negators Оригинал: Negators Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
unary_negate binary_negate	not1 not2
Устаревшие связующих и адаптеры Оригинал: Deprecated binders and adaptors Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
unary_function (устарело)
binary_function (устарело)
ptr_fun (устарело)
pointer_to_unary_function (устарело)
pointer_to_binary_function (устарело)
mem_fun (устарело)
mem_fun_t mem_fun1_t const_mem_fun_t const_mem_fun1_t (устарело) (устарело) (устарело) (устарело)
mem_fun_ref (устарело)
mem_fun_ref_t mem_fun1_ref_t const_mem_fun_ref_t const_mem_fun1_ref_t (устарело) (устарело) (устарело) (устарело)
binder1st binder2nd (устарело) (устарело)
bind1st bind2nd (устарело) (устарело)

 

std::reference_wrapper

Функции-члены

reference_wrapper::reference_wrapper

reference_wrapper::operator=

reference_wrapper::get reference_wrapper::operator T&

reference_wrapper::operator()

 

Определено в заголовочном файле <functional>
template< class T > class reference_wrapper;		(начиная с C++11)

std::reference_wrapper класса шаблона CopyConstructible и CopyAssignable оберткой ссылку на объект или ссылку на функцию типа T. Экземпляры std::reference_wrapper являются объектами (могут быть скопированы или храниться в контейнерах), но они неявно преобразуются в T&, так что они могут быть использованы в качестве аргументов функций, которые принимают базового типа по ссылке.

Оригинал:

Class template std::reference_wrapper is a CopyConstructible and CopyAssignable wrapper around a reference to object or reference to function of type T. Instances of std::reference_wrapper are objects (can be copied or stored in containers), but they are implicitly convertible to T&, so that they can be used as arguments with the functions that take the underlying type by reference.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Вспомогательные функции std::ref и std::cref часто используются для создания объектов std::reference_wrapper.

Оригинал:

Helper functions std::ref and std::cref are often used to generate std::reference_wrapper objects.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

std::reference_wrapper также используется для передачи объектов в std::bind или конструктор std::thread по ссылке.

Оригинал:

std::reference_wrapper is also used to pass objects to std::bind or to the constructor of std::thread by reference.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Типы-члены

типа Оригинал: type Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.	definition
type	T
result_type	Тип возвращаемого T если T является функцией. В противном случае, не определен Оригинал: The return type of T if T is a function. Otherwise, not defined Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
argument_type	1) если T является функцией или указателем на функцию, которая принимает один аргумент типа A1, то argument_type является A1. 2) если T является указателем на функцию-член класса T0, который не принимает аргументов, то argument_type является T0*, возможно, CV-qualified 3) если T это класс с T::argument_type член типа, то argument_type является псевдонимом этого Оригинал: 1) if T is a function or pointer to function that takes one argument of type A1, then argument_type is A1. 2) if T is a pointer to member function of class T0 that takes no arguments, then argument_type is T0*, possibly cv-qualified 3) if T is a class type with a member type T::argument_type, then argument_type is an alias of that Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
first_argument_type	1) если T является функцией или указателем на функцию, которая принимает два аргумента типа с A1 и A2, то first_argument_type является A1. 2) если T является указателем на функцию-член класса T0, которая принимает один аргумент, то first_argument_type является T0*, возможно, CV-qualified 3) если T это класс с T::first_argument_type член типа, то first_argument_type является псевдонимом этого Оригинал: 1) if T is a function or pointer to function that takes two arguments of type s A1 and A2, then first_argument_type is A1. 2) if T is a pointer to member function of class T0 that takes one argument, then first_argument_type is T0*, possibly cv-qualified 3) if T is a class type with a member type T::first_argument_type, then first_argument_type is an alias of that Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
second_argument_type	1) если T является функцией или указателем на функцию, которая принимает два аргумента типа с A1 и A2, то second_argument_type является A2. 2) если T является указателем на функцию-член класса T0, которая принимает один аргумент A1, то second_argument_type является A1, возможно, CV-qualified 3) если T это класс с T::second_argument_type член типа, то first_argument_type является псевдонимом этого Оригинал: 1) if T is a function or pointer to function that takes two arguments of type s A1 and A2, then second_argument_type is A2. 2) if T is a pointer to member function of class T0 that takes one argument A1, then second_argument_type is A1, possibly cv-qualified 3) if T is a class type with a member type T::second_argument_type, then first_argument_type is an alias of that Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Функции-члены

(конструктор)	содержит ссылку на новый объект std::reference_wrapper Оригинал: stores a reference in a new std::reference_wrapper object Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-член)
operator=	повторную привязку std::reference_wrapper Оригинал: rebinds a std::reference_wrapper Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-член)
get operator T&	доступ к сохраненной ссылке Оригинал: accesses the stored reference Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-член)
operator()	вызывает хранимую функцию Оригинал: calls the stored function Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-член)

Пример

Демонстрирует использование reference_wrapper в качестве контейнера ссылок, которые позволяют получить доступ к той же контейнере с помощью нескольких индексов

Оригинал:

Demonstrates the use of reference_wrapper as a container of references, which makes it possible to access the same container using multiple indexes

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Запустить этот код

#include <algorithm>
#include <list>
#include <vector>
#include <iostream>
#include <functional>
 
int main()
{
    std::list<int> l = {-4, -3, -2, -1, 0, 1, 2, 3, 4};
 
    std::vector<std::reference_wrapper<int>> v(l.begin(), l.end());
    std::random_shuffle(v.begin(), v.end());
 
    std::vector<std::reference_wrapper<int>> v2(v.begin(), v.end());
    std::partition(v2.begin(), v2.end(), [](int n){return n<0;});
 
    std::cout << "Contents of the list: ";
    for(int n: l) {
        std::cout << n << ' ';
    }
    std::cout << '\n';
 
    std::cout << "Contents of the list, shuffled: ";
    for(int i: v) {
        std::cout << i << ' ';
    }
    std::cout << '\n';
 
    std::cout << "Shuffled elements, partitioned: ";
    for(int i: v2) {
        std::cout << i << ' ';
    }
    std::cout << '\n';
}

Вывод:

Contents of the list: -4 -3 -2 -1 0 1 2 3 4
Contents of the list, shuffled: 0 -1 3 4 -4 1 -2 -3 2
Shuffled elements, partitioned: -3 -1 -2 -4 4 1 3 0 2

См. также

ref cref (C++11) (C++11)	создает std::reference_wrapper с типом выводится из своих аргументов Оригинал: creates a std::reference_wrapper with a type deduced from its argument Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (шаблон функции)
bind (C++11)	связывает один или несколько аргументов функции-объекта (шаблон функции)