`<initializer_list>`

[added with C++11]

Include the standard header <initializer_list> to define template class initializer_list, which describes a brace-enclosed list of initializers, plus two support functions.

namespace std {
template<class Ty>
    class initializer_list;

template<class Ty>
    const Ty *begin(initializer_list<Ty> init) noexcept;
template<class Ty>
    const Ty *end(initializer_list<Ty> init) noexcept;
}  // namespace std

`begin`

template<class Ty>
    const Ty *begin(initializer_list<Ty> init) noexcept;

The function returns a pointer to the first element of the sequence controlled by the initializer_list object.

`end`

template<class Ty>
    const Ty *end(initializer_list<Ty> init) noexcept;

The function returns a pointer just past the last element of the sequence controlled by the initializer_list object.

`initializer_list`

begin · const_iterator · const_reference · end · initializer_list · iterator · reference · size · size_type · value_type

template<class Ty>
    class initializer_list {
public:
    typedef size_t size_type;
    typedef Ty& reference;
    typedef const Ty& const_reference;
    typedef const Ty *iterator;
    typedef const Ty *const_iterator;
    typedef Ty value_type;

    initializer_list() noexcept;

    const Ty *begin() const noexcept;
    const Ty *end() const noexcept;

    size_type size() const noexcept;
    };

The template class describes an object that controls a sequence of length N of elements of type Ty. The object effectively stores a pair of pointers delimiting the sequence. The translator replaces a brace-enclosed list of expressions convertible to Ty with an object of type initializer_list<Ty> that designates an array of type const Ty[N} containing the expression values.

`initializer_list::begin`

const Ty *begin() const noexcept;

The member functions return a const pointer that points at the first element of the sequence (or just beyond the end of an empty sequence).

`initializer_list::const_iterator`

typedef const Ty *const_iterator;

The type describes an object that can server as a constant random-access iterator for the controlled sequence.

`initializer_list::const_reference`

typedef const Ty& const_reference;

The type describes an object that can serve as a constant reference to an element of the controlled sequence.

`initializer_list::end`

reference end() const noexcept;

The member functions return a random-access iterator that points just beyond the end of the sequence.

`initializer_list::initializer_list`

initializer_list() noexcept;

The default constructor initializes the object so that it designates an empty controlled sequence. How the translator constructs an object that designates a non-empty controlled sequence is unspecified.

`initializer_list::iterator`

typedef const Ty *iterator;

The type describes an object that can server as a random-access iterator for the controlled sequence.

`initializer_list::reference`

typedef Ty& reference;

The type describes an object that can serve as a reference to an element of the controlled sequence.

`initializer_list::size`

size_type size() const noexcept;

The member function returns N.

`initializer_list::size_type`

typedef size_t size_type;

The unsigned integer type describes an object that can represent the length of any controlled sequence. It is a synonym for the type size_t.

`initializer_list::value_type`

typedef Ty value_type;

The type is a synonym for the template parameter Ty.

See also the Table of Contents and the Index.