std::multimap::cend

#include <map>

const_iterator cend() const noexcept;

Trả về một const_iterator trỏ đến vị trí sau phần tử cuối cùng trong std::multimap. cend() là viết tắt của "constant end".

Tham số

Không có tham số

Giá trị trả về

• const_iterator: Trả về một const_iterator trỏ đến vị trí sau phần tử cuối cùng trong std::multimap. Đây là một vị trí "past-the-end". const_iterator chỉ cho phép đọc giá trị, không cho phép thay đổi.

Đặc điểm

1. Vị trí "past-the-end": cend() không trỏ đến một phần tử thực sự trong std::multimap, mà là một vị trí sau phần tử cuối cùng. Dereferencing (toán tử * hoặc ->) iterator này sẽ dẫn đến hành vi không xác định (undefined behavior).
2. Chỉ đọc: Iterator trả về bởi cend() là const_iterator, nghĩa là bạn không thể thay đổi giá trị của các phần tử trong std::multimap thông qua iterator này.
3. noexcept: cend() được đánh dấu là noexcept, nghĩa là nó được đảm bảo không ném ra ngoại lệ nào.
4. So sánh với cbegin(): cbegin() trỏ đến phần tử đầu tiên, trong khi cend() trỏ đến vị trí sau phần tử cuối cùng.
5. Phân biệt với end(): end() trả về iterator (có thể đọc và ghi nhưng không được thay đổi key), trong khi cend() trả về const_iterator (chỉ đọc).
6. Không thay đổi std::multimap: Gọi cend() không làm thay đổi nội dung của std::multimap.
7. std::multimap rỗng: Nếu std::multimap rỗng thì cend() sẽ trả về giá trị giống cbegin().
8. Độ phức tạp: O(1) - thời gian hằng số.

Ví dụ

#include <iostream>
#include <map>

int main() {
  std::multimap<std::string, int> mymultimap = {
    {"apple", 1},
    {"banana", 2},
    {"orange", 3},
    {"apple", 4}
  };

  std::cout << "mymultimap contains:\n";
  for (auto cit = mymultimap.cbegin(); cit != mymultimap.cend(); ++cit) {
    std::cout << cit->first << ": " << cit->second << '\n'; // Chỉ đọc giá trị, không thể thay đổi
  }
  // Output:
  // mymultimap contains:
  // apple: 1
  // apple: 4
  // banana: 2
  // orange: 3

  return 0;
}

#include <iostream>
#include <map>

int main() {
  std::multimap<int, std::string> mymultimap;

  // Kiểm tra map có rỗng hay không sử dụng cbegin() và cend()
  if (mymultimap.cbegin() == mymultimap.cend()) {
    std::cout << "multimap is empty\n"; // Output: multimap is empty
  }

  return 0;
}

Các hàm liên quan

end	Trả về một iterator trỏ đến vị trí sau phần tử cuối cùng trong std::multimap
cbegin	Trả về một const_iterator trỏ đến phần tử đầu tiên trong std::multimap