# 标准库头文件 <array>

< cpp‎ | header

此头文件是容器库的一部分。

### 包含
<compare> (C++20) | 三路比较运算符支持
<initializer_list> (C++11) | std::initializer_list 类模板
### 类
array (C++11) | 静态的连续数组 (类模板)
tuple_size (C++11) | 获得元组式类型的元素数 (类模板)
tuple_element (C++11) | 获得元组式类型的元素类型 (类模板)
std::tuple_size<std::array> (C++11) | 获得 `array` 的大小 (类模板特化)
std::tuple_element<std::array> (C++11) | 获得 `array` 元素的类型 (类模板特化)
### 函数
operator==operator!=operator<operator<=operator>operator>=operator<=> (C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20) | 按照字典顺序比较 array 中的值 (函数模板)
std::swap(std::array) (C++11) | 特化 std::swap 算法 (函数模板)
to_array (C++20) | 从内建数组创建 `std::array` 对象 (函数模板)
std::get(std::array) | 访问 `array` 的一个元素 (函数模板)
##### 范围访问
begin cbegin (C++11)(C++14) | 返回指向容器或数组起始的迭代器 (函数模板)
end cend (C++11)(C++14) | 返回指向容器或数组结尾的迭代器 (函数模板)
rbegin crbegin (C++14) | 返回指向一个容器或数组的逆向迭代器 (函数模板)
rend crend (C++14) | 返回容器或数组的逆向尾迭代器 (函数模板)
size ssize (C++17)(C++20) | 返回容器或数组的大小 (函数模板)
empty (C++17) | 检查容器是否为空 (函数模板)
data (C++17) | 获得指向底层数组的指针 (函数模板)

### 概要

    #include <compare>
    #include <initializer_list>

    namespace std {
      // 类模板 array
      template<class T, size_t N> struct array;

      template<class T, size_t N>
        constexpr bool operator==(const array<T, N>& x, const array<T, N>& y);
      template<class T, size_t N>
        constexpr /*synth-three-way-result*/<T>
          operator<=>(const array<T, N>& x, const array<T, N>& y);

      // 特化的算法
      template<class T, size_t N>
        constexpr void swap(array<T, N>& x, array<T, N>& y) noexcept(noexcept(x.swap(y)));

      // array 创建函数
      template<class T, size_t N>
        constexpr array<remove_cv_t<T>, N> to_array(T (&a)[N]);
      template<class T, size_t N>
        constexpr array<remove_cv_t<T>, N> to_array(T (&&a)[N]);

      // tuple 接口
      template<class T> struct tuple_size;
      template<size_t I, class T> struct tuple_element;
      template<class T, size_t N>
        struct tuple_size<array<T, N>>;
      template<size_t I, class T, size_t N>
        struct tuple_element<I, array<T, N>>;
      template<size_t I, class T, size_t N>
        constexpr T& get(array<T, N>&) noexcept;
      template<size_t I, class T, size_t N>
        constexpr T&& get(array<T, N>&&) noexcept;
      template<size_t I, class T, size_t N>
        constexpr const T& get(const array<T, N>&) noexcept;
      template<size_t I, class T, size_t N>
        constexpr const T&& get(const array<T, N>&&) noexcept;
    }

#### 类模板 std::array

    namespace std {
      template<class T, size_t N>
      struct array {
        // 类型
        using value_type             = T;
        using pointer                = T*;
        using const_pointer          = const T*;
        using reference              = T&;
        using const_reference        = const T&;
        using size_type              = size_t;
        using difference_type        = ptrdiff_t;
        using iterator               = /* 由实现定义 */;
        using const_iterator         = /* 由实现定义 */;
        using reverse_iterator       = std::reverse_iterator<iterator>;
        using const_reverse_iterator = std::reverse_iterator<const_iterator>;

        // 聚合类型无显式的构造/复制/销毁

        constexpr void fill(const T& u);
        constexpr void swap(array&) noexcept(is_nothrow_swappable_v<T>);

        // 迭代器
        constexpr iterator               begin() noexcept;
        constexpr const_iterator         begin() const noexcept;
        constexpr iterator               end() noexcept;
        constexpr const_iterator         end() const noexcept;

        constexpr reverse_iterator       rbegin() noexcept;
        constexpr const_reverse_iterator rbegin() const noexcept;
        constexpr reverse_iterator       rend() noexcept;
        constexpr const_reverse_iterator rend() const noexcept;

        constexpr const_iterator         cbegin() const noexcept;
        constexpr const_iterator         cend() const noexcept;
        constexpr const_reverse_iterator crbegin() const noexcept;
        constexpr const_reverse_iterator crend() const noexcept;

        // 容量
        [[nodiscard]] constexpr bool empty() const noexcept;
        constexpr size_type size() const noexcept;
        constexpr size_type max_size() const noexcept;

        // 元素访问
        constexpr reference       operator[](size_type n);
        constexpr const_reference operator[](size_type n) const;
        constexpr reference       at(size_type n);
        constexpr const_reference at(size_type n) const;
        constexpr reference       front();
        constexpr const_reference front() const;
        constexpr reference       back();
        constexpr const_reference back() const;

        constexpr T *       data() noexcept;
        constexpr const T * data() const noexcept;
      };

      template<class T, class... U>
        array(T, U...) -> array<T, 1 + sizeof...(U)>;
    }