std::ranges::empty
cppreference.net에서 가져옴
| 헤더 <ranges>
|
||
| 에 정의됨 <iterator>
|
||
inline namespace /*unspecified*/ {
inline constexpr auto empty = /*unspecified*/;
}
|
헤더 에 정의됨 (C++20부터) |
|
| (사용자 지정 포인트 객체) |
||
template< class T >
requires /* see below */
constexpr bool empty( T&& t );
|
호출 시그니처 | |
(C++20부터)t에 요소가 있는지 여부를 결정합니다.
ranges::empty에 대한 호출은 다음에 대해 표현식 동등합니다:
bool(t.empty()), 단 해당 표현식이 유효해야 합니다.- 그렇지 않으면
(ranges::size(t) == 0), 단 해당 표현식이 유효해야 합니다. - 그렇지 않으면
bool(ranges::begin(t) == ranges::end(t)), 단 해당 표현식이 유효하고decltype(ranges::begin(t))가 std::forward_iterator 모델을 만족해야 합니다.
다른 모든 경우, ranges::empty에 대한 호출은 ill-formed이며, 대체 실패가 발생할 수 있습니다. 이는 ranges::empty(t)가 템플릿 인스턴스화의 즉시 컨텍스트에 나타날 때 발생합니다.
커스터마이제이션 포인트 객체
ranges::empty
라는 이름은
커스터마이제이션 포인트 객체
를 나타내며,
이는 리터럴
LiteralType
semiregular
클래스 타입의 const
FunctionObject
입니다. 자세한 내용은
CustomizationPointObject
를 참조하십시오.
예제
이 코드 실행
#include <iostream> #include <ranges> #include <vector> template<std::ranges::input_range R> void print(char id, R&& r) { if (std::ranges::empty(r)) { std::cout << '\t' << id << ") Empty\n"; return; } std::cout << '\t' << id << ") Elements:"; for (const auto& element : r) std::cout << ' ' << element; std::cout << '\n'; } int main() { { auto v = std::vector<int>{1, 2, 3}; std::cout << "(1) ranges::empty uses std::vector::empty:\n"; print('a', v); v.clear(); print('b', v); } { std::cout << "(2) ranges::empty uses ranges::size(initializer_list):\n"; auto il = {7, 8, 9}; print('a', il); print('b', std::initializer_list<int>{}); } { std::cout << "(2) ranges::empty on a raw array uses ranges::size:\n"; int array[] = {4, 5, 6}; // array has a known bound print('a', array); } { struct Scanty : private std::vector<int> { using std::vector<int>::begin; using std::vector<int>::end; using std::vector<int>::push_back; // Note: both empty() and size() are hidden }; std::cout << "(3) calling ranges::empty on an object w/o empty() or size():\n"; Scanty y; print('a', y); y.push_back(42); print('b', y); } }
출력:
(1) ranges::empty uses std::vector::empty:
a) Elements: 1 2 3
b) Empty
(2) ranges::empty uses ranges::size(initializer_list):
a) Elements: 7 8 9
b) Empty
(2) ranges::empty on a raw array uses ranges::size:
a) Elements: 4 5 6
(3) calling ranges::empty on an object w/o empty() or size():
a) Empty
b) Elements: 42
참고 항목
|
(C++17)
|
컨테이너가 비어 있는지 확인합니다
(함수 템플릿) |