std::initializer_list::initializer_list

1
initializer_list();
(since C++11)
(until C++14)
1
constexpr initializer_list();
(since C++14)

Constructs an empty initializer list.

Parameters

(none).

Exceptions

noexcept specification:
noexcept

Complexity

Constant.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
#include <iostream>
#include <initializer_list>
  
int main()
{
    std::initializer_list<int> empty_list;
    std::cout << "empty_list.size(): " << empty_list.size() << '\n';
  
    // create initializer lists using list-initialization
    std::initializer_list<int> digits {1, 2, 3, 4, 5};
    std::cout << "digits.size(): " << digits.size() << '\n';
  
    // special rule for auto means 'fractions' has the
    // type std::initializer_list<double>
    auto fractions = {3.14159, 2.71828};
    std::cout << "fractions.size(): " << fractions.size() << '\n';
}

Output:

1
2
3
empty_list.size(): 0
digits.size(): 5
fractions.size(): 2

Notes

Despite a lack of constructors, it is possible to create non-empty initializer lists. Instances of std::initializer_list are implicitly constructed when:

doc_CPP
2025-01-10 15:47:30
Comments
Leave a Comment

Please login to continue.