std::span<T,Extent>::empty

 

C++

Compiler support

Freestanding and hosted

Language

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Metaprogramming library (C++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (C++17)

Regular expressions library (C++11)

Concurrency support library (C++11)

Technical specifications

Symbols index

External libraries

 

Containers library

Sequence

array (C++11)

vector

deque

forward_list (C++11)

list

Associative

set

multiset

map

multimap

Unordered associative

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Adaptors

stack

queue

priority_queue

Views

span (C++20)

 

std::span

Member functions

span::span

span::operator=

Element access

span::front

span::back

span::operator[]

span::data

Iterators

span::begin

span::end

span::rbegin

span::rend

Observers

span::empty

span::size

span::size_bytes

Subviews

span::first

span::last

span::subspan

Non-member functions

as_bytesas_writable_bytes

Non-member constant

dynamic_extent

Deduction guides

 

[[nodiscard]] constexpr bool empty() const noexcept;

Checks if the span is empty.

Parameters

(none)

Return value

true if the span is empty (i.e., size() == 0); false otherwise.

Example

Run this code

#include <span>
#include <iostream>
#include <iomanip>
 
int main()
{
    std::span<const char> span{ "ABCDEF" };
 
    while (!span.empty()) {
        std::cout << std::quoted(span.data()) << '\n';
        span = span.last(span.size() - 1);
    }
}

Output:

"ABCDEF"
"BCDEF"
"CDEF"
"DEF"
"EF"
"F"
""

See also

size	returns the number of elements in the sequence (public member function)