Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
std::map::empty(3)	      C++ Standard Libary	    std::map::empty(3)

NAME
       std::map::empty - std::map::empty

Synopsis
	  bool empty() const;			      (until C++11)
	  bool empty() const noexcept;		      (since C++11)
						      (until C++20)
	  [[nodiscard]]	bool empty() const noexcept;  (since C++20)

	  Checks  if  the  container  has no elements, i.e. whether begin() ==
       end().

Parameters
	  (none)

Return value
	  true if the container	is empty, false	otherwise

Complexity
	  Constant.

Example
	  The following	code uses empty	to check if a std::map<int, int>  con-
       tains any
	  elements:

       // Run this code

	#include <map>
	#include <iostream>
	#include <utility>

	int main()
	{
	    std::map<int,int> numbers;
	    std::cout << std::boolalpha;
	    std::cout  << "Initially, numbers.empty(): " << numbers.empty() <<
       '\n';

	    numbers.emplace(42,	13);
	    numbers.insert(std::make_pair(13317, 123));
	    std::cout << "After	adding elements, numbers.empty():  "  <<  num-
       bers.empty() << '\n';
	}

Output:
	Initially, numbers.empty(): true
	After adding elements, numbers.empty():	false

See also
	  size	  returns the number of	elements
		  (public member function)
	  empty	  checks whether the container is empty
	  (C++17) (function template)

http://cppreference.com		  2022.07.31		    std::map::empty(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::map::empty&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help