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

#include <opencv2/core/utility.hpp>

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

公開型
typedef _Tp	value_type

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

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

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

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

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

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

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

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

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

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

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

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
   ...
}