std::experimental::ranges::identity - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::experimental::ranges::identity

From cppreference.com
< cpp‎ | experimental‎ | ranges

Defined in header `<experimental/ranges/functional>` |  |
struct identity; |  | (ranges TS)

ranges::identity is a function object type whose operator() returns its argument unchanged. It is used as the default projection for all Ranges TS algorithms.

### [edit] Member types

Member type | Definition
`is_transparent` | /* unspecified */

### [edit] Member functions

operator() | returns the argument unchanged (public member function)

## std::experimental::ranges::identity::operator()

template< class T> constexpr T&& operator()( T&& t ) const; |  |

Returns std::forward<T>(t).

### Parameters

t | - | argument to return

### Return value

std::forward<T>(t).

### Exceptions

`noexcept` specification:
noexcept

### [edit] Notes

The member type `is_transparent` indicates to the caller that this function object is a transparent function object: it accepts arguments of arbitrary types and uses perfect forwarding, which avoids unnecessary copying and conversion when the function object is used in heterogeneous context, or with rvalue arguments. In particular, template functions such as std::set::find and std::set::lower_bound make use of this member type on their `Compare` types.

### [edit] Example

| This section is incomplete Reason: no example

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/experimental/ranges/functional/identity&oldid=91319"
Categories:

- unconditionally noexcept
- Todo no example

Hidden categories:

- Pages with unreviewed unconditional noexcept template
- Pages with unreviewed noexcept template