配列テンプレートクラスの基本クラス [詳解]

詳解

template<class TYPE>
class FVCL::CFvMultiData< TYPE >

配列テンプレートクラスの基本クラス

テンプレート引数

TYPE 配列の要素の型

namespace FVCL

配列の動的な確保を行うクラスの基本クラスです。
このクラスは抽象クラスですので、インスタンスの生成を行うには継承する必要があります。

必要条件:: ヘッダー: FVCLbasic.h

参照: FVCL::CFvArray
FVCL::CFvList

FVCL::CFvMultiData< TYPE > の継承関係図

公開型
typedef TYPE *	pointer
	ポインタ型 [詳解]

typedef const TYPE *	const_pointer
	ポインタ型(const付き) [詳解]

typedef TYPE &	reference
	参照型 [詳解]

typedef const TYPE &	const_reference
	参照型(const付き) [詳解]

typedef UINT	size_type
	サイズ型 [詳解]

typedef CFvIterator< TYPE >	iterator
	イテレータ型 [詳解]

typedef const iterator	const_iterator
	イテレータ型(const付き) [詳解]

公開メンバ関数
	CFvMultiData ()
	コンストラクタ [詳解]

	CFvMultiData (const CFvMultiData< TYPE > &object)
	コピーコンストラクタ [詳解]

virtual	~CFvMultiData ()
	デストラクタ [詳解]

virtual INT	GetDataID () const =0
	データIDの取得 [詳解]

virtual bool	GetPointer (INT id, void **val) const =0
	インスタンスのthisポインタの取得 [詳解]

virtual reference	at (size_type _Pos)
	配列の任意の位置の要素取得 [詳解]

virtual const_reference	at (size_type _Pos) const
	配列の任意の位置の要素取得 [詳解]

virtual reference	front ()
	配列の先頭の要素取得 [詳解]

virtual const_reference	front () const
	配列の先頭の要素取得 [詳解]

virtual reference	back ()
	配列末尾の要素の取得 [詳解]

virtual const_reference	back () const
	配列末尾の要素の取得 [詳解]

virtual iterator	begin ()
	配列の先頭位置の取得 [詳解]

virtual const_iterator	begin () const
	配列の先頭位置の取得 [詳解]

virtual iterator	end ()
	配列末尾の次の位置の取得 [詳解]

virtual const_iterator	end () const
	配列末尾の次の位置の取得 [詳解]

virtual size_type	capacity () const
	配列の許容量の取得 [詳解]

virtual void	clear ()
	配列の開放 [詳解]

virtual bool	empty () const
	要素の存在の確認 [詳解]

virtual iterator	erase (iterator _First, iterator _Last)
	要素の削除 [詳解]

virtual iterator	erase (iterator _Where)
	要素の削除 [詳解]

virtual CFvAllocator< TYPE > &	get_allocator ()
	アロケータクラスの取得 [詳解]

virtual const CFvAllocator< TYPE > &	get_allocator () const
	アロケータクラスの取得 [詳解]

virtual void	insert (iterator _Where, size_type _Count, const_reference _Val)
	配列への要素の挿入 [詳解]

virtual iterator	insert (iterator _Where, const_reference _Val)
	配列への要素の挿入 [詳解]

virtual bool	push_back (const_reference _Val)
	配列への要素の追加 [詳解]

virtual bool	pop_back ()
	配列末尾の要素の削除 [詳解]

virtual bool	resize (size_type _Newsize, const_reference _Val)
	配列の再確保 [詳解]

virtual bool	resize (size_type _Newsize)
	配列の再確保 [詳解]

virtual void	reserve (size_type _Count)
	配列容量の追加 [詳解]

virtual size_type	size () const
	配列の要素数の取得 [詳解]

virtual bool	ChangeOrder (iterator _Where, INT _Order)
	配列要素の順序入れ替え [詳解]

virtual bool	SwapItem (iterator _Where1, iterator _Where2)
	配列要素の位置入れ替え [詳解]

virtual reference	operator[] (size_type uiIndex)
	添字オペレータ [詳解]

virtual const_reference	operator[] (size_type uiIndex) const
	添字オペレータ(const付き) [詳解]

virtual CFvMultiData< TYPE > &	operator= (const CFvMultiData< TYPE > &ope)
	代入オペレータ(=) [詳解]

基底クラス FVCL::CFvObject に属する継承公開メンバ関数
	CFvObject ()
	標準のコンストラクタ [詳解]

virtual	~CFvObject ()
	デストラクタ [詳解]

INT	SetErrorCode (INT err)
	エラーコードの設定 [詳解]

INT	SetErrorCode (INT err) const
	エラーコードの設定 [詳解]

INT	GetErrorCode () const
	エラーコードの取得 [詳解]

bool	SetAllocateOption (INT value)
	画像領域確保時のオプションの設定 [詳解]

INT	GetAllocateOption () const
	画像領域確保時のオプションの取得 [詳解]

void *	operator new (size_t uiSize)
	new オペレータ [詳解]

void *	operator new[] (size_t uiSize)
	new[] オペレータ [詳解]

void	operator delete (void *pvObject)
	delete オペレータ [詳解]

void	operator delete[] (void *pvObject)
	delete[] オペレータ [詳解]

void *	operator new (size_t uiSize, LPCSTR szFileName, INT iLine)
	new オペレータ [詳解]

void *	operator new[] (size_t uiSize, LPCSTR szFileName, INT iLine)
	new[] オペレータ [詳解]

void	operator delete (void *pvObject, LPCSTR szFileName, INT iLine)
	delete オペレータ [詳解]

void	operator delete[] (void *pvObject, LPCSTR szFileName, INT iLine)
	delete[] オペレータ [詳解]

virtual CFvObject &	operator= (const CFvObject &src)
	代入オペレータ [詳解]

virtual bool	operator== (const CFvObject &src) const
	比較オペレータ (==) [詳解]

virtual bool	operator!= (const CFvObject &src) const
	比較オペレータ (!=) [詳解]

限定公開変数類
CFvAllocator< TYPE > *	m_alloc
	アロケータクラスのオブジェクトへのポインタ [詳解]

基底クラス FVCL::CFvObject に属する継承限定公開変数類
INT	m_ErrorCode
	エラーコード [詳解]

INT	m_AllocateOption
	画像領域確保時のオプション [詳解]

その他の継承メンバ
基底クラス FVCL::CFvObject に属する継承静的公開メンバ関数
static bool	SetDefaultAllocateOption (INT value)
	既定の画像領域確保時のオプションの設定 [詳解]

static INT	GetDefaultAllocateOption ()
	既定の画像領域確保時のオプションの取得 [詳解]

基底クラス FVCL::CFvObject に属する継承限定公開メンバ関数
INT	fnCPUCheck ()
	CPU情報の取得 [詳解]

型定義メンバ詳解

template<class TYPE>

typedef TYPE * FVCL::CFvMultiData< TYPE >::pointer

ポインタ型

template<class TYPE>

typedef const TYPE * FVCL::CFvMultiData< TYPE >::const_pointer

ポインタ型(const付き)

template<class TYPE>

typedef TYPE & FVCL::CFvMultiData< TYPE >::reference

参照型

template<class TYPE>

typedef const TYPE & FVCL::CFvMultiData< TYPE >::const_reference

参照型(const付き)

template<class TYPE>

typedef size_t FVCL::CFvMultiData< TYPE >::size_type

サイズ型

template<class TYPE>

typedef CFvIterator< TYPE > FVCL::CFvMultiData< TYPE >::iterator

イテレータ型

template<class TYPE>

typedef const iterator FVCL::CFvMultiData< TYPE >::const_iterator

イテレータ型(const付き)

構築子と解体子

template<class TYPE>

FVCL::CFvMultiData< TYPE >::CFvMultiData ( )

inline

コンストラクタ

オブジェクトを構築します。
コンストラクタが protected に指定されていますので、このクラスのオブジェクトを生成する事は出来ません。オブジェクトを生成するには、このクラスを継承する必要があります。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::CFvMultiData ( const CFvMultiData< TYPE > & object )

inline

コピーコンストラクタ

同一クラスのインスタンスの内容を複製してオブジェクトを構築します。

引数

[in] object 複製元

template<class TYPE>

FVCL::CFvMultiData< TYPE >::~CFvMultiData ( )

inlinevirtual

デストラクタ

関数詳解

template<class TYPE>

FVCL::CFvMultiData< TYPE >::GetDataID ( ) const

pure virtual

データIDの取得

データの型を特定する識別番号を取得します。

戻り値: データIDを返します。

解説:: この関数は純粋仮想関数ですので、実際の処理は継承したクラスで実装する必要があります。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::GetPointer	(	INT	iDataID,
		void **	pvThis
	)		const

pure virtual

インスタンスのthisポインタの取得

指定されたデータIDと自身のIDが一致する場合にthisポインタを返します。

引数

[in]	iDataID	データID
[out]	pvThis	thisポインタを格納する変数へのポインタ

戻り値

true	正常
false	異常

解説:: この関数は純粋仮想関数ですので、実際の処理は継承したクラスで実装する必要があります。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::at ( size_type _Pos )

inlinevirtual

配列の任意の位置の要素取得

配列指標が示す位置の要素への参照を取得します。

引数

[in] _Pos 配列指標

戻り値: 配列指標が示す位置の要素への参照を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::at ( size_type _Pos ) const

inlinevirtual

配列の任意の位置の要素取得

配列指標が示す位置の要素への参照を取得します。
このクラスのオブジェクトが const付きの場合は、このメソッドが呼び出されます。

引数

[in] _Pos 配列指標

戻り値: 配列指標が示す位置の要素への参照を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::front ( )

inlinevirtual

配列の先頭の要素取得

配列の先頭の要素への参照を取得します。

戻り値: 配列の先頭の要素への参照を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::front ( ) const

inlinevirtual

配列の先頭の要素取得

配列の先頭の要素への参照を取得します。
このクラスのオブジェクトが const付きの場合は、このメソッドが呼び出されます。

戻り値: 配列の先頭の要素への参照を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::back ( )

inlinevirtual

配列末尾の要素の取得

配列末尾の要素への参照を取得します。

戻り値: 配列末尾の要素への参照を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::back ( ) const

inlinevirtual

配列末尾の要素の取得

配列末尾の要素への参照を取得します。
このクラスのオブジェクトが const付きの場合は、このメソッドが呼び出されます。

戻り値: 配列末尾の要素への参照を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::begin ( )

inlinevirtual

配列の先頭位置の取得

配列の先頭位置を示すイテレータを取得します。

戻り値: 配列の先頭位置を示すイテレータを返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::begin ( ) const

inlinevirtual

配列の先頭位置の取得

配列の先頭位置を示すイテレータを取得します。
このクラスのオブジェクトが const付きの場合は、このメソッドが呼び出されます。

戻り値: 配列の先頭位置を示すイテレータを返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::end ( )

inlinevirtual

配列末尾の次の位置の取得

配列末尾の次の位置を示すイテレータを取得します。

戻り値: 配列末尾の次の位置を示すイテレータを返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::end ( ) const

inlinevirtual

配列末尾の次の位置の取得

配列末尾の次の位置を示すイテレータを取得します。
このクラスのオブジェクトが const付きの場合は、このメソッドが呼び出されます。

戻り値: 配列末尾の次の位置を示すイテレータを返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::capacity ( ) const

inlinevirtual

配列の許容量の取得

配列の許容量を取得します。

戻り値: 配列の許容量を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::clear ( )

inlinevirtual

配列の開放

配列の領域を開放します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::empty ( ) const

inlinevirtual

要素の存在の確認

配列に要素が存在するか否かを確認します。

戻り値

true	配列は空です。(要素が１つも在りません)
false	１つ以上の要素が存在します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::erase	(	iterator	_First,
		iterator	_Last
	)

inlinevirtual

要素の削除

配列の任意の位置の要素を削除します。

引数

[in]	_First	削除する開始位置を示すイテレータ
[in]	_Last	削除する終了位置を示すイテレータ

戻り値: 削除した開始位置を示すイテレータを返します。

解説:: 第１引数の _First が指し示す位置から第２引数 _Last が示す位置までの要素を削除します。
例えば、 _First が配列の２番目を示し、_Last が３番目を示す場合は、４番目以降の要素を２つづつ前方へずらします。

: _First = 2 (0起算)
_Last = 3 (0起算)
削除前の配列: [L][I](V)(V)[B][R][A][R][Y]
削除後の配列: [L][I][B][R][A][R][Y]

template<class TYPE>

FVCL::CFvMultiData< TYPE >::erase ( iterator _Where )

inlinevirtual

要素の削除

配列の任意の位置の要素を削除します。

引数

[in] _Where 削除する位置を示すイテレータ

戻り値: 削除した位置を示すイテレータを返します。

解説:: 第１引数の _Where が指し示す位置の要素を削除します。
例えば、 _Where が配列の２番目を示す場合、２番目の要素を１つ削除し、２番目以降を１つづづ前方へずらします。

: _Where = 2 (0起算)
削除前の配列: [L][I](V)[B][R][A][R][Y]
削除後の配列: [L][I][B][R][A][R][Y]

template<class TYPE>

FVCL::CFvMultiData< TYPE >::get_allocator ( )

inlinevirtual

アロケータクラスの取得

アロケータクラスのオブジェクトへの参照を取得します。

戻り値: アロケータクラスのオブジェクトへの参照を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::get_allocator ( ) const

inlinevirtual

アロケータクラスの取得

アロケータクラスのオブジェクトへの参照を取得します。
このクラスのオブジェクトが const付きの場合は、このメソッドが呼び出されます。

戻り値: アロケータクラスのオブジェクトへの参照を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::insert	(	iterator	_Where,
		size_type	_Count,
		const_reference	_Val
	)

inlinevirtual

配列への要素の挿入

配列の任意の位置に要素を挿入します。

引数

[in]	_Where	挿入する位置を示すイテレータ
[in]	_Count	挿入する個数
[in]	_Val	挿入する要素

解説:: 第１引数の _Where が指し示す位置に、第２引数の _Count に示す個数分、_Val を挿入します。
例えば、 _Where が配列の２番目を示す場合、２番目以降を _Count に示す個数だけ後方へずらし、 _Val を２番目から挿入します。

: _Where = 2 (0起算)
_Count = 2
_Val = 'C'
挿入前の配列: [S][U][E][S][S]
挿入後の配列: [S][U](C)(C)[E][E][S]

template<class TYPE>

FVCL::CFvMultiData< TYPE >::insert	(	iterator	_Where,
		const_reference	_Val
	)

inlinevirtual

配列への要素の挿入

配列の任意の位置に要素を挿入します。

引数

[in]	_Where	挿入する位置を示すイテレータ
[in]	_Val	挿入する要素

戻り値: 挿入した位置を示すイテレータを返します。

解説:: 第１引数の _Where が指し示す位置に、第２引数 _Val を挿入します。
例えば、 _Where が配列の２番目を示す場合、２番目以降を１つづづ後方へずらし、 _Val を２番目に挿入します。

: _Where = 2 (0起算)
_Val = 'B'
挿入前の配列: [L][I][R][A][R][Y]
挿入後の配列: [L][I](B)[R][A][R][Y]

template<class TYPE>

FVCL::CFvMultiData< TYPE >::push_back ( const_reference _Val )

inlinevirtual

配列への要素の追加

配列の末尾に要素を追加します。

引数

[in] _Val 追加する要素

戻り値

true	正常
false	異常

解説:: 第１引数の _Val を配列の末尾に追加します。
_Val = 'Y'
追加前の配列: [L][I][B][R][A][R]
追加後の配列: [L][I][B][R][A][R](Y)

template<class TYPE>

FVCL::CFvMultiData< TYPE >::pop_back ( )

inlinevirtual

配列末尾の要素の削除

配列の末尾にある要素を１つ削除します。

戻り値

true	正常
false	異常

解説:: 配列の末尾にある要素を１つ削除します。
削除前の配列: [L][I][B][R][A][R](Y)
削除後の配列: [L][I][B][R][A][R]

template<class TYPE>

FVCL::CFvMultiData< TYPE >::resize	(	size_type	_Newsize,
		const_reference	_Val
	)

inlinevirtual

配列の再確保

配列の領域を確保します。

引数

[in]	_Newsize	確保する容量
[in]	_Val	確保後の配列要素の初期値

戻り値

true	正常
false	異常

解説:: 第１引数の _Newsize に示す容量を確保します。
_Newsize に示す容量が、再確保前の容量を超える場合は、差分の領域は第２引数の _Val で初期化されます。再確保前の配列に在った要素は保持されます。

_Newsize = 7
_Val = '-'
再確保前の配列: [L][I][B]
再確保後の配列: [L][I][B](-)(-)(-)(-)

: 逆に、_Newsize に示す容量が、再確保前の容量を下回る場合は、再確保前の配列に在った要素を失う事になります。
_Newsize = 3
_Val = '-'
再確保前の配列: [L][I][B](R)(A)(R)(Y)
再確保後の配列: [L][I][B]

template<class TYPE>

FVCL::CFvMultiData< TYPE >::resize ( size_type _Newsize )

inlinevirtual

配列の再確保

配列の領域を確保します。

引数

[in] _Newsize 確保する容量(byte)

戻り値

true	正常
false	異常

解説:: 第１引数の _Newsize に示す容量を確保します。
_Newsize に示す容量が、再確保前の容量を超える場合は、差分の領域は不定値になります。再確保前の配列に在った要素は保持されます。

_Newsize = 7
再確保前の配列: [L][I][B]
再確保後の配列: [L][I][B](?)(?)(?)(?)

: 逆に、_Newsize に示す容量が、再確保前の容量を下回る場合は、再確保前の配列に在った要素を失う事になります。
_Newsize = 3
再確保前の配列: [L][I][B](R)(A)(R)(Y)
再確保後の配列: [L][I][B]

template<class TYPE>

FVCL::CFvMultiData< TYPE >::reserve ( size_type _Count )

inlinevirtual

配列容量の追加

引数

[in] _Count 追加容量(byte)

戻り値

true	正常
false	異常

template<class TYPE>

FVCL::CFvMultiData< TYPE >::size ( ) const

inlinevirtual

配列の要素数の取得

戻り値: 配列の要素数を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::ChangeOrder	(	iterator	_Where,
		INT	_Order
	)

inlinevirtual

配列要素の順序入れ替え

１つの要素の配列順序を入れ替えます。

引数

[in]	_Where	入れ替え対象の要素
[in]	_Order	移動量

戻り値

true	正常
false	異常

解説:: この関数は、当配列クラス内の要素順序を入れ替える為に使用します。引数に指定される要素(_Where)は、この配列クラスの要素でなければなりません。異なる配列クラスの要素が指定された場合は、戻り値に false を返します。

: 下記は CFvList を使用した例を示します。
CFvList<INT> list;
list.push_back( 1 ); // where
list.push_back( 2 );
list.push_back( 3 );
list.push_back( 4 ); // where + 3
CFvList<INT>::iterator where = list.begin();
list.ChangeOrder( where, 3 );
入れ替え前: (1)[2][3][4]
入れ替え後: [2][3][4](1)

template<class TYPE>

FVCL::CFvMultiData< TYPE >::SwapItem	(	iterator	_Where1,
		iterator	_Where2
	)

inlinevirtual

配列要素の位置入れ替え

２つの要素の配列位置を入れ替えます。

引数

[in]	_Where1	入れ替え対象の要素
[in]	_Where2	入れ替え対象の要素

戻り値

true	正常
false	異常

解説:: この関数は、当配列クラス内の要素位置を入れ替える為に使用します。引数に指定される要素(_Where1,_Where2)は、この配列クラスの要素でなければなりません。異なる配列クラスの要素が指定された場合は、戻り値に false を返します。

: 下記は CFvList を使用した例を示します。
CFvList<INT> list;
list.push_back( 1 ); // where1
list.push_back( 2 );
list.push_back( 3 );
list.push_back( 4 ); // where2
CFvList<INT>::iterator where1 = list.begin();
CFvList<INT>::iterator where2 = list.begin() + 3;
list.SwapItem( where1, where2 );
入れ替え前: (1)[2][3]{4}
入れ替え後: {4}[2][3](1)

template<class TYPE>

FVCL::CFvMultiData< TYPE >::operator[] ( size_type uiIndex )

inlinevirtual

添字オペレータ

配列の要素を取得します。

引数

[in] uiIndex 配列指標

戻り値: 配列の要素を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::operator[] ( size_type uiIndex ) const

inlinevirtual

添字オペレータ(const付き)

配列の要素を取得します。このオブジェクトが、const付きの場合はこのオペレータが呼び出されます。返される要素にもconstが付加されます。

引数

[in] uiIndex 配列指標

戻り値: 配列の要素を返します。

template<class TYPE>

FVCL::CFvMultiData< TYPE >::operator= ( const CFvMultiData< TYPE > & ope )

inlinevirtual

代入オペレータ(=)

他の配列の要素をこの配列へコピーします。

引数

[in] ope 代入するオブジェクト

戻り値: 代入後の自身のオブジェクトへの参照を返します。

メンバ詳解

template<class TYPE>

FVCL::CFvMultiData< TYPE >::m_alloc

protected

アロケータクラスのオブジェクトへのポインタ

詳解

template<class TYPE> class FVCL::CFvMultiData< TYPE >

公開型

公開メンバ関数

限定公開変数類

その他の継承メンバ

型定義メンバ詳解

構築子と解体子

関数詳解

メンバ詳解

template<class TYPE>
class FVCL::CFvMultiData< TYPE >