C++20 引入了 std::ssize 函数，这是一个非常实用的特性，它为处理容器和数组的大小提供了一种更安全、更灵活的方式。本文将详细介绍 std::ssize 的功能、使用场景以及它如何改进我们的代码。

一、std::ssize 的定义与功能

std::ssize 是一个模板函数，它返回给定容器或数组的大小，但与 std::size 不同的是，它返回的是一个有符号整数类型。具体来说，std::ssize 的返回类型是 std::common_type_t<std::ptrdiff_t, std::make_signed_t<decltype(c.size())>>，这意味着它会将容器的大小转换为一个有符号的整数类型。

函数签名

template<class C>
constexpr auto ssize(const C& c) -> std::common_type_t<std::ptrdiff_t, std::make_signed_t<decltype(c.size())>>;

参数

• c：一个拥有 size 方法的容器或数组。

返回值

• 容器或数组的大小，以有符号整数形式返回。

二、为什么需要 std::ssize

在 C++ 中，size() 方法通常返回一个无符号整数类型（如 std::size_t）。这在大多数情况下是合理的，但在某些场景下可能会导致问题。例如，当你需要对容器的大小进行减法操作时，无符号整数可能会导致意外的行为。

示例

for (auto i = container.size() - 1; i >= 0; --i) {
    
     /* do something... */ }

如果 container.size() 返回的是 std::size_t（无符号类型），那么 i 也会是无符号类型。当 container 为空时，i 会被初始化为 std::size_t 的最大值，这将导致一个无限循环。

而使用 std::ssize 可以避免这个问题：

for (auto i = std::ssize(container) - 1; i >= 0; --i) {
    
     /* do something... */ }

即使 container 为空，i 也会被初始化为 -1，从而避免了无限循环。

三、std::ssize 的使用场景

1. 容器

std::ssize 可以与各种标准库容器一起使用，例如 std::vector、std::list 等。

std::vector<int> v = {
    
    1, 2, 3};
auto size = std::ssize(v); // 返回 3

2. 数组

std::ssize 也可以用于内置数组。

int a[] = {
    
    1, 2, 3};
auto size = std::ssize(a); // 返回 3

3. 字符串

对于字符串，std::ssize 会返回字符串的长度，包括终止符。

const char str[] = "hello";
auto size = std::ssize(str); // 返回 6

四、std::ssize 的优势

1. 安全性

如前文所述，std::ssize 返回有符号整数，这使得在进行减法操作时更加安全，避免了无符号整数的溢出问题。

2. 一致性

std::ssize 提供了一种统一的方式来获取容器和数组的大小，无论它们的 size 方法返回什么类型。

3. 便捷性

std::ssize 的存在使得代码更加简洁，避免了手动进行类型转换。

五、可能的实现

以下是 std::ssize 的一个可能实现：

template<class C>
constexpr auto ssize(const C& c) -> std::common_type_t<std::ptrdiff_t, std::make_signed_t<decltype(c.size())>> {
    
    
    using R = std::common_type_t<std::ptrdiff_t, std::make_signed_t<decltype(c.size())>>;
    return static_cast<R>(c.size());
}

六、总结

std::ssize 是 C++20 中的一个非常有用的特性，它为处理容器和数组的大小提供了一种更安全、更灵活的方式。通过返回有符号整数，std::ssize 避免了无符号整数在减法操作中可能出现的问题。在编写涉及容器大小的代码时，强烈建议使用 std::ssize，以提高代码的安全性和可读性。