自動的に確保されるバッファクラス。続きを見る...

#include <opencv2/core/utility.hpp>

Collaboration diagram for cv::AutoBuffer< _Tp, fixed_size >:

公開型
typedef const _Tp *	const_iterator

typedef const _Tp &	const_reference

typedef std::ptrdiff_t	difference_type

typedef _Tp *	iterator

typedef _Tp &	reference

typedef std::size_t	size_type

typedef _Tp	value_type

公開メンバ関数
	AutoBuffer ()
	デフォルトコンストラクタ

	AutoBuffer (const AutoBuffer< _Tp, fixed_size > &buf)
	コピーコンストラクタ

	AutoBuffer (size_t _size)
	実際のバッファサイズを受け取るコンストラクタ

	AutoBuffer (size_t _size, const _Tp &value)

	~AutoBuffer ()
	デストラクタ。 deallocate() を呼び出す

void	allocate (size_t _size)
	サイズ_sizeの新しいバッファを確保する。_sizeが十分に小さい場合は、スタック確保されたバッファを使用する

reference	back ()

const_reference	back () const

iterator	begin ()

const_iterator	begin () const

const_iterator	cbegin () const

const_iterator	cend () const

void	clear ()

_Tp *	data ()
	実際のバッファ (スタック確保またはヒープ確保) へのポインタを返す

const _Tp *	data () const
	実際のバッファ (スタック確保またはヒープ確保) への読み取り専用ポインタを返す

void	deallocate ()
	バッファが動的に確保されていた場合は解放する

void	emplace_back (_Tp &&value)

bool	empty () const

iterator	end ()

const_iterator	end () const

reference	front ()

const_reference	front () const

	operator _Tp * ()
	実際のバッファ (スタック確保またはヒープ確保) へのポインタを返す

	operator const _Tp * () const
	実際のバッファ (スタック確保またはヒープ確保) への読み取り専用ポインタを返す

AutoBuffer< _Tp, fixed_size > &	operator= (const AutoBuffer< _Tp, fixed_size > &buf)
	代入演算子

void	pop_back ()

void	push_back (_Tp &&value)

void	push_back (const _Tp &value)

void	resize (size_t _size)
	バッファをリサイズし、内容を保持する

size_t	size () const
	現在のバッファサイズを返す

限定公開変数類
_Tp	buf [(fixed_size > 0) ? fixed_size :1]
	事前に確保されたバッファ。C++標準の要件を満たすため少なくとも1要素を持つ

_Tp *	ptr
	実際のバッファへのポインタ。バッファが十分に小さい場合はbufを指すことがある

size_t	sz
	実際のバッファのサイズ

詳細説明

template<typename _Tp, size_t fixed_size = 1024/sizeof(_Tp)+8>
class cv::AutoBuffer< _Tp, fixed_size >

自動的に確保されるバッファクラス。

このクラスは関数やメソッド内の一時バッファに使用される。一時バッファは通常小さい (数Kバイト程度のメモリ) が、そのサイズが引数に依存する場合、スタック上に小さな固定サイズの配列を作成し、それが十分大きければそれを使用するのが理にかなっている。必要なバッファサイズが固定サイズより大きい場合は、十分なサイズの別バッファを動的に確保し、処理後に解放する。したがって、バッファサイズが小さい典型的なケースでは、malloc()/free() に伴うオーバーヘッドが発生しない。同時に、処理するデータのサイズに制限はない。

これが AutoBuffer の行うことである。テンプレートは2つのパラメータ、すなわちバッファ要素の型とスタック確保される要素数を受け取る。このクラスの使い方を以下に示す:

void my_func(const cv::Mat& m)
{
 cv::AutoBuffer<float> buf(1000); // create automatic buffer containing 1000 floats
 
 buf.allocate(m.rows); // if m.rows <= 1000, the pre-allocated buffer is used,
 // otherwise the buffer of "m.rows" floats will be allocated
 // dynamically and deallocated in cv::AutoBuffer destructor
   ...
}