std::multimap::cbegin

#include <map>

const_iterator cbegin() const noexcept;

Trả về một const_iterator trỏ đến phần tử đầu tiên trong std::multimap. cbegin() là viết tắt của "constant begin".

Tham số

Không có tham số

Giá trị trả về

• const_iterator: Trả về một const_iterator trỏ đến phần tử đầu tiên trong std::multimap. const_iterator chỉ cho phép đọc giá trị, không cho phép thay đổi.

Đặc điểm

1. Trỏ đến phần tử đầu tiên (key nhỏ nhất): cbegin() luôn trả về const_iterator trỏ đến phần tử đầu tiên trong std::multimap theo thứ tự đã sắp xếp (theo key).
2. Có thể dereference: Bạn có thể dereference (sử dụng toán tử * hoặc ->) iterator trả về bởi cbegin() để truy cập key-value của phần tử đầu tiên (nhưng không thể thay đổi giá trị đó).
3. Chỉ đọc: Iterator trả về bởi cbegin() là const_iterator, nghĩa là bạn không thể sử dụng nó để sửa đổi giá trị của các phần tử trong std::multimap.
4. noexcept: cbegin() được đánh dấu là noexcept, nghĩa là nó được đảm bảo không ném ra ngoại lệ nào.
5. Kết hợp với cend(): cbegin() thường được sử dụng cùng với cend() để duyệt qua toàn bộ std::multimap. cend() trả về const_iterator trỏ đến phần tử "past-the-end".
6. Phân biệt với begin(): begin() trả về iterator (có thể đọc và ghi nhưng bạn không được phép thay đổi giá trị key), trong khi cbegin() trả về const_iterator (chỉ đọc).
7. Không thay đổi std::multimap: Gọi cbegin() không làm thay đổi nội dung của std::multimap.
8. std::multimap rỗng: Nếu std::multimap rỗng thì cbegin() sẽ trả về giá trị giống cend().
9. Độ 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>
#include <algorithm>

int main() {
  std::multimap<int, std::string> mymultimap = {
    {3, "three"},
    {1, "one"},
    {4, "four"},
    {2, "two"},
    {2, "another two"}
  };

  // Tìm key nhỏ nhất sử dụng cbegin()
  auto it = mymultimap.cbegin();

  if (it != mymultimap.cend()) {
      std::cout << "Smallest key: " << it->first << '\n'; // Output: Smallest key: 1
  }

  return 0;
}

Các hàm liên quan

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