array::if_contains

## `array::if_contains`

Return a pointer to an element if it exists.

### Synopsis

    value const*
    if_contains(
        std::size_t pos) const noexcept; (1)

    value*
    if_contains(
        std::size_t pos) noexcept; (2)

### Description

This function returns a pointer to the element at index `pos` when the index is less then the size of the container. Otherwise it returns null.

### Example

    if( auto p = arr.if_contains( 1 ) )
        std::cout << *p;

### Complexity

Constant.

### Exception Safety

No-throw guarantee.

### Parameters

Name | Description
--- | ---
`pos` | The index of the element to return.

Edit this page