std::map<Key,T,Compare,Allocator>::end, std::map<Key,T,Compare,Allocator>::cend

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

容器库

序列

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

deque

forward_list (C++11)

list

关联容器

set

multiset

map

multimap

无序关联容器

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

容器适配器

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

视图

span (C++20)

mdspan (C++23)

表格

迭代器失效

成员函数表格

非成员函数表格

 

std::map

成员函数
map::map map::~map	map::operator= map::get_allocator
元素访问
map::at	map::operator[]
迭代器
map::beginmap::cbegin (C++11) map::endmap::cend (C++11)	map::rbeginmap::crbegin (C++11) map::rendmap::crend (C++11)
容量
map::size map::max_size	map::empty
修改器
map::clear map::insert map::erase map::swap map::extract (C++17) map::merge (C++17)	map::insert_range (C++23) map::insert_or_assign (C++17) map::emplace (C++11) map::emplace_hint (C++11) map::try_emplace (C++17)
查找
map::count map::find map::contains (C++20)	map::equal_range map::lower_bound map::upper_bound
观察器
map::key_comp	map::value_comp
非成员函数
operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)	std::swap(std::map) erase_if(std::map) (C++20)
推导指引 (C++17)

 

iterator end();	(1)	(C++11 起为 noexcept)
const_iterator end() const;	(2)	(C++11 起为 noexcept)
const_iterator cend() const noexcept;	(3)	(C++11 起)

返回指向 map 末元素后一元素的迭代器。

此元素表现为占位符；试图访问它导致未定义行为。

参数

（无）

返回值

指向后随最后元素的迭代器。

复杂度

常数。

注解

libc++ 将 cend() 向后移植到 C++98 模式。

示例

运行此代码

#include <iostream>
#include <map>
 
int main()
{
    std::map<int, float> num_map;
    num_map[4] = 4.13;
    num_map[9] = 9.24;
    num_map[1] = 1.09;
    // 调用 num_map.begin() 和 num_map.end()
    for (auto it = num_map.begin(); it != num_map.end(); ++it)
        std::cout << it->first << ", " << it->second << '\n';
}

输出：

1, 1.09
4, 4.13
9, 9.24

使用自定义比较函数的示例

运行此代码

#include <cmath>
#include <iostream>
#include <map>
 
struct Point { double x, y; };
 
// 比较两个 Point 指针的 x 坐标。
struct PointCmp
{
    bool operator()(const Point* lhs, const Point* rhs) const
    {
        return lhs->x < rhs->x; 
    }
};
 
int main()
{
    // 注意尽管 x 坐标乱序，亦将按照递增的 x 坐标迭代 map。
    Point points[3] = {{2, 0}, {1, 0}, {3, 0}};
 
    // mag 是发送结点地址到其在 x-y 平面中长度的 map
    // 尽管键为指向 Point 的指针，我们希望按照点的 x 坐标而非点的地址为 map 赋序。
    // 通过用 PointCmp 类的比较方法进行。
    std::map<Point*, double, PointCmp> mag(
        {{points, 2}, {points + 1, 1}, {points + 2, 3}}
    );
 
    // 从 0 到长度更改每个 y 坐标
    for (auto iter = mag.begin(); iter != mag.end(); ++iter)
    {
        auto cur = iter->first; // 指向 Node 的指针
        cur->y = mag[cur]; // 亦能用 cur->y = iter->second;
    }
 
    // 更新并打印每个节点的长度。
    for (auto iter = mag.begin(); iter != mag.end(); ++iter)
    {
        auto cur = iter->first;
        mag[cur] = std::hypot(cur->x, cur->y);
        std::cout << "The magnitude of (" << cur->x << ", " << cur->y << ") is ";
        std::cout << iter->second << '\n';
    }
 
    // 以基于范围的 for 循环重复上述内容。
    for (auto i : mag)
    {
        auto cur = i.first;
        cur->y = i.second;
        mag[cur] = std::hypot(cur->x, cur->y);
        std::cout << "The magnitude of (" << cur->x << ", " << cur->y << ") is ";
        std::cout << mag[cur] << '\n';
        // 注意与上述 std::cout << iter->second << '\n'; 相反，
        // std::cout << i.second << '\n'; 将不打印更新的长度。
        // 如果用的是 auto &i : mag，则它会打印更新的长度。
    }
}

输出：

The magnitude of (1, 1) is 1.41421
The magnitude of (2, 2) is 2.82843
The magnitude of (3, 3) is 4.24264
The magnitude of (1, 1.41421) is 1.73205
The magnitude of (2, 2.82843) is 3.4641
The magnitude of (3, 4.24264) is 5.19615

参阅

begincbegin (C++11)	返回指向起始的迭代器 (公开成员函数)
endcend (C++11)(C++14)	返回指向容器或数组结尾的迭代器 (函数模板)