Boost C++ Libraries Home Libraries People FAQ More
PrevUpHomeNext

Class template array（類模板 array）

boost::array — 服從 STL 風格的針對常量大小數組的容器包裝

概要

template<typename T, std::size_t N> 
class array {
public:
  // types
  typedef T                                     value_type;            
  typedef T*                                    iterator;              
  typedef const T*                              const_iterator;        
  typedef std::reverse_iterator<iterator>       reverse_iterator;      
  typedef std::reverse_iterator<const_iterator> const_reverse_iterator;
  typedef T&                                    reference;             
  typedef const T&                              const_reference;       
  typedef std::size_t                           size_type;             
  typedef std::ptrdiff_t                        difference_type;       

  // static constants
  static const size_type static_size = N;

  // construct/copy/destruct
  template<typename U> array& operator=(const array<U, N>&);

  // iterator support
  iterator begin();
  const_iterator begin() const;
  iterator end();
  const_iterator end() const;

  // reverse iterator support
  reverse_iterator rbegin();
  const_reverse_iterator rbegin() const;
  reverse_iterator rend();
  const_reverse_iterator rend() const;

  // capacity
  size_type size();
  bool empty();
  size_type max_size();

  // element access
  reference operator[](size_type);
  const_reference operator[](size_type) const;
  reference at(size_type);
  const_reference at(size_type) const;
  reference front();
  const_reference front() const;
  reference back();
  const_reference back() const;
  const T* data() const;
  T* c_array();

  // modifiers
  void swap(array<T, N>&);
  void assign(const T&);
  T elems[N];
};

// specialized algorithms
template<typename T, std::size_t N> void swap(array<T, N>&, array<T, N>&);

// comparisons
template<typename T, std::size_t N> 
  bool operator==(const array<T, N>&, const array<T, N>&);
template<typename T, std::size_t N> 
  bool operator!=(const array<T, N>&, const array<T, N>&);
template<typename T, std::size_t N> 
  bool operator<(const array<T, N>&, const array<T, N>&);
template<typename T, std::size_t N> 
  bool operator>(const array<T, N>&, const array<T, N>&);
template<typename T, std::size_t N> 
  bool operator<=(const array<T, N>&, const array<T, N>&);
template<typename T, std::size_t N> 
  bool operator>=(const array<T, N>&, const array<T, N>&);

Description

array 公有的 構造/拷貝/析構

  1. template<typename U> array& operator=(const array<U, N>& other);

    效果：

    		 std::copy(rhs.begin(),rhs.end(), begin())

array 迭代器支持

  1. iterator begin();
const_iterator begin() const;

    返回：

    		 位於第一個元素的迭代器

    拋出：

    		 不拋出異常 
  2. iterator end();
const_iterator end() const;

    返回：

    		 位於最後一個元素之後位置的迭代器

    拋出：

    		 不拋出異常

array 反向迭代器支持

  1. reverse_iterator rbegin();
const_reverse_iterator rbegin() const;

    返回：

    		 位於反向迭代的第一個元素的反向迭代器 
  2. reverse_iterator rend();
const_reverse_iterator rend() const;

    返回：

    		 位於反向迭代的最後一個元素之後位置的反向迭代器

array 容量

  1. size_type size();

    返回：

    		 N 
  2. bool empty();

    返回：

    		 N==0

    拋出：

    		 不拋出異常 
  3. size_type max_size();

    返回：

    		 N

    拋出：

    		 不拋出異常

array 元素訪問

  1. reference operator[](size_type i);
const_reference operator[](size_type i) const;

    Requires:

    		 i < N

    返回：

    		 索引為 i 的元素

    拋出：

    		 不拋出異常。 
  2. reference at(size_type i);
const_reference at(size_type i) const;

    返回：

    		 索引為 i 的元素

    拋出：

    		 std::range_error if i >= N 
  3. reference front();
const_reference front() const;

    要求：

    		 N > 0

    返回：

    		 第一個元素

    拋出：

    		 不拋出異常 
  4. reference back();
const_reference back() const;

    要求：

    		 N > 0

    返回：

    		 最後一個元素

    拋出：

    		 不拋出異常 
  5. const T* data() const;

    返回：

    		 elems

    拋出：

    		 不拋出異常 
  6. T* c_array();

    返回：

    		 elems

    拋出：

    		 不拋出異常

array 修改器

  1. void swap(array<T, N>& other);

    效果：

    		 std::swap_ranges(begin(), end(), other.begin())

    複雜度：

    		 基於 N 的線性增長 
  2. void assign(const T& value);

    效果：

    		 std::fill_n(begin(), N, value)

array 特殊算法

  1. template<typename T, std::size_t N> void swap(array<T, N>& x, array<T, N>& y);

    效果：

    		 x.swap(y)

    拋出：

    		 不拋出異常。

array 比較

  1. template<typename T, std::size_t N> 
  bool operator==(const array<T, N>& x, const array<T, N>& y);

    返回：

    		 std::equal(x.begin(), x.end(), y.begin()) 
  2. template<typename T, std::size_t N> 
  bool operator!=(const array<T, N>& x, const array<T, N>& y);

    返回：

    		 !(x == y) 
  3. template<typename T, std::size_t N> 
  bool operator<(const array<T, N>& x, const array<T, N>& y);

    返回：

    		 std::lexicographical_compare(x.begin(), x.end(), y.begin(), y.end()) 
  4. template<typename T, std::size_t N> 
  bool operator>(const array<T, N>& x, const array<T, N>& y);

    返回：

    		 y < x 
  5. template<typename T, std::size_t N> 
  bool operator<=(const array<T, N>& x, const array<T, N>& y);

    返回：

    		 !(y < x) 
  6. template<typename T, std::size_t N> 
  bool operator>=(const array<T, N>& x, const array<T, N>& y);

    返回：

    		 !(x < y)
Copyright c 2001-2004 Nicolai M. Josuttis

Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

PrevUpHomeNext