ポインタ配列管理テンプレート [詳解]

#include <TnbPointerVector.h>

CPointerVectorT< TYP > の継承関係図

公開メンバ関数
INDEX	Add (TYP *P)
	[追加] 要素一つ追加 [詳解]

virtual TYP *const &	At (INDEX index) const
	[取得] 要素の参照取得. [詳解]

const_iterator	begin (void) const
	[反復] 先頭const_iterator. [詳解]

virtual INT_PTR	Compare (const IConstCollectionT< TYP * > &c) const
	[確認] 比較. [詳解]

	CPointerVectorT (const CPointerVectorT< TYP > &v)
	コピーコンストラクタ [詳解]

	CPointerVectorT (size_t size=0)
	コンストラクタ [詳解]

virtual void	Deserialize (const IDeserializer &ds)
	[処理] デシリアライズ [詳解]

const_iterator	end (void) const
	[反復] 最後const_iterator. [詳解]

INDEX	Find (const IChecker &checker, INDEX startIndex=0, bool boIsReverse=false) const
	[検索] 条件一致要素の検索. [詳解]

INDEX	Find (const IConstCollectionT< TYP * > &t, const IComparatorT< TYP * > &comparator, INDEX startIndex=0) const
	[検索] 指定配列の検索. [詳解]

INDEX	Find (const IConstCollectionT< TYP * > &t, INDEX startIndex=0) const
	[検索] 指定配列の検索. [詳解]

INDEX	Find (const TYP * &t, const IComparatorT< TYP * > &comparator, INDEX startIndex=0) const
	[検索] 指定要素の検索. [詳解]

INDEX	Find (const TYP * &t, INDEX startIndex=0) const
	[検索] 指定要素の検索. [詳解]

INDEX	FindMax (const IComparatorT< TYP * > &comparator, const TYP * &def) const
	[検索] 要素の最大検索. [詳解]

INDEX	FindMax (const TYP * &def) const
	[検索] 要素の最大検索. [詳解]

INDEX	FindMin (const IComparatorT< TYP * > &comparator, const TYP * &def) const
	[検索] 要素の最小検索. [詳解]

INDEX	FindMin (const TYP * &def) const
	[検索] 要素の最小検索. [詳解]

virtual TYP *	Get (INDEX index) const
	[取得] 要素の取得. [詳解]

virtual size_t	GetElements (size_t size, TYP * *_P, INDEX offset=0) const
	[取得] 複数要素取り出し. [詳解]

TYP *	GetEx (INDEX index) const
	[取得] 要素の取得. [詳解]

virtual size_t	GetSize (void) const
	[取得] 要素数取得 [詳解]

bool	Insert (INDEX index, TYP *P)
	[挿入] 要素一つ挿入 [詳解]

bool	IsEmpty (void) const
	[確認] 要素の有無確認. [詳解]

virtual bool	IsEqual (const IConstCollectionT< TYP * > &c) const
	[確認] 比較. [詳解]

bool	IsInRange (INDEX index) const
	[確認] INDEXの有効確認. [詳解]

virtual bool	Lock (DWORD dwTime=INFINITE) const
	[排他] ロック [詳解]

	operator size_t (void) const
	[取得] 要素数取得. [詳解]

bool	operator!= (const TNB::IConstCollectionT< TYP * > &t) const
	[確認] 比較 [詳解]

INT_PTR	operator- (const TNB::IConstCollectionT< TYP * > &t) const
	[確認] 比較 [詳解]

bool	operator< (const TNB::IConstCollectionT< TYP * > &t) const
	[確認] 比較 [詳解]

bool	operator<= (const TNB::IConstCollectionT< TYP * > &t) const
	[確認] 比較 [詳解]

CPointerVectorT &	operator= (const CPointerVectorT< TYP > &other)
	[代入] コピーオペレータ [詳解]

bool	operator== (const TNB::IConstCollectionT< TYP * > &t) const
	[確認] 比較 [詳解]

bool	operator> (const TNB::IConstCollectionT< TYP * > &t) const
	[確認] 比較 [詳解]

bool	operator>= (const TNB::IConstCollectionT< TYP * > &t) const
	[確認] 比較 [詳解]

TYP *	operator[] (INDEX index) const
	[取得] 要素参照取得 [詳解]

bool	Remove (INDEX index)
	[削除] 要素削除 [詳解]

void	RemoveAll (void)
	[削除] 空化 [詳解]

size_t	RemoveElements (INDEX index, size_t size=0)
	[削除] 要素削除. [詳解]

virtual void	Serialize (ISerializer &_sr) const
	[処理] シリアライズ [詳解]

bool	Set (INDEX index, TYP *P)
	[設定] 要素の設定 [詳解]

void	SetSize (size_t size)
	[操作] サイズ指定 [詳解]

virtual void	Unlock (void) const
	[排他] アンロック [詳解]

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

詳解

template<typename TYP>
class TNB::CPointerVectorT< TYP >

ポインタ配列管理テンプレート

newで確保した一つ型のポインタ配列を管理します。

動的に配列を増やすことができます。
コピーや削除で不要になったポインタは自動的に delete します。
複製しても、ポインタ先の実体は複製しません。ですので、実体を操作すると、
コピー元にも影響が出ます。

注意: new[] で確保したポインタは管理できません。

引数

TYP	保持する型（コピーできなくてもよし）

参照: IConstCollectionT を実装しています。ポインタ保護のためICollectionT は実装していません。

覚え書き: IConstCollectionT の TYP は TYP* になります。

必要ファイル: TnbPointerVector.h

日付: 06/04/01 新規作成; 06/04/21 コンストラクト時に追加サイズ指定可能にした。; 06/04/22 ポインタ保護のため、継承から実装に切り替えた。; 06/05/17 CVectorTの仕様変更のため、本クラスも修正。; 06/05/19 「VectorのPH」から「PHのVector」に変更。; 06/08/01 GetConstPointer/GetPointerに依存しないつくりに変更。; 06/08/30 シリアライズはサポート出来ないようにした。; 07/03/15 index,size管理を unsignedに変更。; 09/02/12 Insert() 追加。; 11/03/02 RemoveElements() 追加。

TnbPointerVector.h の 60 行目に定義があります。

構築子と解体子

◆ CPointerVectorT() [1/2]

CPointerVectorT ( size_t size = 0 )

explicit

コンストラクタ

覚え書き: 指定のメモリ確保時の追加サイズを設定します。; データは保持しません

引数

size	メモリ確保時の追加サイズ

TnbPointerVector.h の 72 行目に定義があります。

◆ CPointerVectorT() [2/2]

CPointerVectorT ( const CPointerVectorT< TYP > & v )

コピーコンストラクタ

引数

v コピー元

TnbPointerVector.h の 81 行目に定義があります。

◆ ~CPointerVectorT()

virtual ~CPointerVectorT ( void )

virtual

デストラクタ

TnbPointerVector.h の 120 行目に定義があります。

関数詳解

◆ Add()

INDEX Add ( TYP * P )

[追加] 要素一つ追加

引数

P	データのポインタ。newで確保したものに限ります。

戻り値

INVALID_INDEX	失敗。
上記以外	追加したINDEX。

TnbPointerVector.h の 173 行目に定義があります。

◆ At()

virtual TYP *const & At ( INDEX index ) const

virtual

[取得] 要素の参照取得.

引数

index インデックス

戻り値: 参照

例外

CIndexOutOfBoundsException インデックスが範囲外であることを示すためにスローされます。

IConstCollectionT< TYP * >を実装しています。

TnbPointerVector.h の 112 行目に定義があります。

◆ begin()

const_iterator begin ( void ) const

inherited

[反復] 先頭const_iterator.

先頭要素を指す反復子を取得

戻り値: const_iterator

TnbCollection.h の 246 行目に定義があります。

◆ Compare()

virtual INT_PTR Compare ( const IConstCollectionT< TYP * > & c ) const

virtualinherited

[確認] 比較.

コンパレータ( IComparatorT のサブクラス)を使用して、全要素を比較します。

引数

c 比較対象

戻り値

０	自分は c と同じ
１以上	自分は c より大きい
０未満	自分は c より小さい

IComparableT< TNB::IConstCollectionT< TYP * > >を実装しています。

TnbCollection.h の 595 行目に定義があります。

◆ Deserialize()

virtual void Deserialize ( const IDeserializer & ds )

virtualinherited

[処理] デシリアライズ

引数

ds デシリアライザー。

例外

CNotSupportException サポートしていないことを示すためにスローされます。

ISerializableを実装しています。

ICollectionT< TYP * >で再実装されています。

TnbCollection.h の 384 行目に定義があります。

◆ end()

const_iterator end ( void ) const

inherited

[反復] 最後const_iterator.

最後要素の次を指す反復子を取得

戻り値: const_iterator

TnbCollection.h の 253 行目に定義があります。

◆ Find() [1/5]

INDEX Find	(	const IChecker &	checker,
		INDEX	startIndex = `0`,
		bool	boIsReverse = `false`
	)		const

inherited

[検索] 条件一致要素の検索.

チェッカー( IChecker のサブクラス)を使用して、検索します。

覚え書き: 範囲を限定したい場合、 CConstOffsetAdapterT を使用します。

引数

checker	チェッカー
startIndex	検索開始インデックス。
boIsReverse	省略すると条件に一致を探します。 trueを指定すると条件不一致を探します。

戻り値

INVALID_INDEX	未発見
それ以外	発見したインデックス

TnbCollection.h の 400 行目に定義があります。

◆ Find() [2/5]

INDEX Find	(	const IConstCollectionT< TYP * > &	t,
		const IComparatorT< TYP * > &	comparator,
		INDEX	startIndex = `0`
	)		const

inherited

[検索] 指定配列の検索.

コンパレータ( IComparatorT のサブクラス)を使用して、検索します。

覚え書き: 範囲を限定したい場合、 CConstOffsetAdapterT を使用します。

引数

t	配列
comparator	コンパレーター
startIndex	検索開始インデックス。

戻り値

INVALID_INDEX	未発見
それ以外	発見したインデックス

TnbCollection.h の 427 行目に定義があります。

◆ Find() [3/5]

INDEX Find	(	const IConstCollectionT< TYP * > &	t,
		INDEX	startIndex = `0`
	)		const

inherited

[検索] 指定配列の検索.

IComparatorT::GetDefault() で得られるコンパレータを使用して検索します。

覚え書き: 範囲を限定したい場合、 CConstOffsetAdapterT を使用します。

引数

t	配列
startIndex	検索開始インデックス。

戻り値

INVALID_INDEX	未発見
それ以外	発見したインデックス

TnbCollection.h の 467 行目に定義があります。

◆ Find() [4/5]

INDEX Find	(	const TYP * &	t,
		const IComparatorT< TYP * > &	comparator,
		INDEX	startIndex = `0`
	)		const

inherited

[検索] 指定要素の検索.

コンパレータ( IComparatorT のサブクラス)を使用して、検索します。

覚え書き: 範囲を限定したい場合、 CConstOffsetAdapterT を使用します。

引数

t	要素
comparator	コンパレーター
startIndex	検索開始インデックス。

戻り値

INVALID_INDEX	未発見
それ以外	発見したインデックス

TnbCollection.h の 482 行目に定義があります。

◆ Find() [5/5]

INDEX Find	(	const TYP * &	t,
		INDEX	startIndex = `0`
	)		const

inherited

[検索] 指定要素の検索.

IComparatorT::GetDefault() で得られるコンパレータを使用して検索します。

覚え書き: 範囲を限定したい場合、 CConstOffsetAdapterT を使用します。

引数

t	要素
startIndex	検索開始インデックス。

戻り値

INVALID_INDEX	未発見
それ以外	発見したインデックス

TnbCollection.h の 508 行目に定義があります。

◆ FindMax() [1/2]

INDEX FindMax	(	const IComparatorT< TYP * > &	comparator,
		const TYP * &	def
	)		const

inherited

[検索] 要素の最大検索.

コンパレータ( IComparatorT のサブクラス)を使用して、比較検索します。

引数

comparator	コンパレーター
def	最小値(初期値)

戻り値

INVALID_INDEX	未発見
それ以外	最大を持つインデックス

TnbCollection.h の 521 行目に定義があります。

◆ FindMax() [2/2]

INDEX FindMax ( const TYP * & def ) const

inherited

[検索] 要素の最大検索.

IComparatorT::GetDefault() で得られるコンパレータを使用して比較検索します。

覚え書き: 範囲を限定したい場合、 CConstOffsetAdapterT を使用します。

引数

def 最小値(初期値)

戻り値

INVALID_INDEX	未発見
それ以外	最大を持つインデックス

TnbCollection.h の 545 行目に定義があります。

◆ FindMin() [1/2]

INDEX FindMin	(	const IComparatorT< TYP * > &	comparator,
		const TYP * &	def
	)		const

inherited

[検索] 要素の最小検索.

コンパレータ( IComparatorT のサブクラス)を使用して、比較検索します。

引数

comparator	コンパレーター
def	最大値(初期値)

戻り値

INVALID_INDEX	未発見
それ以外	最小を持つインデックス

TnbCollection.h の 558 行目に定義があります。

◆ FindMin() [2/2]

INDEX FindMin ( const TYP * & def ) const

inherited

[検索] 要素の最小検索.

IComparatorT::GetDefault() で得られるコンパレータを使用して比較検索します。

覚え書き: 範囲を限定したい場合、 CConstOffsetAdapterT を使用します。

引数

def 最大値(初期値)

戻り値

INVALID_INDEX	未発見
それ以外	最小を持つインデックス

TnbCollection.h の 582 行目に定義があります。

◆ Get()

virtual TYP * Get ( INDEX index ) const

virtualinherited

[取得] 要素の取得.

覚え書き: 非スレッドセーブメソッドです。複数のスレッドからアクセスがある場合、 GetEx() を使用してください。

引数

index インデックス

戻り値: 内容

例外

CIndexOutOfBoundsException インデックスが範囲外であることを示すためにスローされます。

CVectorT< TYP * >で再実装されています。

TnbCollection.h の 298 行目に定義があります。

◆ GetElements()

virtual size_t GetElements	(	size_t	size,
		TYP * *	_P,
		INDEX	offset = `0`
	)		const

virtualinherited

[取得] 複数要素取り出し.

引数

[in]	size	取り出すデータの数。
[out]	_P	コピーするポインタ。size 分の領域がある必要があります。
[in]	offset	取り出し開始のインデックス。省略すると０。

戻り値: コピーした数

TnbCollection.h の 322 行目に定義があります。

◆ GetEx()

TYP * GetEx ( INDEX index ) const

inherited

[取得] 要素の取得.

引数

index インデックス

戻り値: 内容

例外

CIndexOutOfBoundsException インデックスが範囲外であることを示すためにスローされます。

TnbCollection.h の 309 行目に定義があります。

◆ GetSize()

virtual size_t GetSize ( void ) const

virtual

[取得] 要素数取得

戻り値: 要素数

IConstCollectionT< TYP * >を実装しています。

TnbPointerVector.h の 217 行目に定義があります。

◆ Insert()

bool Insert	(	INDEX	index,
		TYP *	P
	)

[挿入] 要素一つ挿入

引数

index	追加するINDEX。
P	データのポインタ。newで確保したものに限ります。

戻り値

true	成功。
false	失敗。

TnbPointerVector.h の 185 行目に定義があります。

◆ IsEmpty()

bool IsEmpty ( void ) const

inherited

[確認] 要素の有無確認.

覚え書き: GetSize()の戻り値が０か否かでチェックしています。

戻り値

true	要素なし
false	要素有り

TnbCollection.h の 346 行目に定義があります。

◆ IsEqual()

virtual bool IsEqual ( const IConstCollectionT< TYP * > & c ) const

virtualinherited

[確認] 比較.

コンパレータ( IComparatorT のサブクラス)を使用して、全要素を比較します。

引数

c 比較対象

戻り値

true	自分は c と同じ
false	自分は c と異なる

IComparableT< TNB::IConstCollectionT< TYP * > >を再実装しています。

TnbCollection.h の 624 行目に定義があります。

◆ IsInRange()

bool IsInRange ( INDEX index ) const

inherited

[確認] INDEXの有効確認.

覚え書き: GetSize()の戻り値を使用してチェックしています。

引数

index インデックス

戻り値

true	指定Indexは有効。
false	指定Indexは無効(範囲外)。

TnbCollection.h の 358 行目に定義があります。

◆ Lock()

virtual bool Lock ( DWORD dwTime = INFINITE ) const

virtual

[排他] ロック

引数

dwTime ダミー。省略してください。

戻り値: 常にtrue。

ISynchronizedを実装しています。

TnbPointerVector.h の 101 行目に定義があります。

◆ operator size_t()

operator size_t ( void ) const

inherited

[取得] 要素数取得.

戻り値: 要素数

TnbCollection.h の 268 行目に定義があります。

◆ operator!=()

bool operator!= ( const TNB::IConstCollectionT< TYP * > & t ) const

inherited

[確認] 比較

引数

t 比較対象

戻り値

true	自分は t と異なる
false	自分は t と同じ

TnbComparable.h の 98 行目に定義があります。

◆ operator-()

INT_PTR operator- ( const TNB::IConstCollectionT< TYP * > & t ) const

inherited

[確認] 比較

引数

t 比較対象

戻り値

０	自分は t と同じ
１以上	自分は t より大きい
０未満	自分は t より小さい

TnbComparable.h の 82 行目に定義があります。

◆ operator<()

bool operator< ( const TNB::IConstCollectionT< TYP * > & t ) const

inherited

[確認] 比較

引数

t 比較対象

戻り値

true	自分は t より小さい
false	自分は t と同じか大きい

TnbComparable.h の 106 行目に定義があります。

◆ operator<=()

bool operator<= ( const TNB::IConstCollectionT< TYP * > & t ) const

inherited

[確認] 比較

引数

t 比較対象

戻り値

true	自分は t と同じか小さい
false	自分は t より大きい

TnbComparable.h の 114 行目に定義があります。

◆ operator=()

CPointerVectorT & operator= ( const CPointerVectorT< TYP > & other )

[代入] コピーオペレータ

引数

other コピー元

戻り値: 自分の参照

TnbPointerVector.h の 90 行目に定義があります。

◆ operator==()

bool operator== ( const TNB::IConstCollectionT< TYP * > & t ) const

inherited

[確認] 比較

引数

t 比較対象

戻り値

true	自分は t と同じ
false	自分は t と異なる

TnbComparable.h の 90 行目に定義があります。

◆ operator>()

bool operator> ( const TNB::IConstCollectionT< TYP * > & t ) const

inherited

[確認] 比較

引数

t 比較対象

戻り値

true	自分は t より大きい
false	自分は t と同じか小さい

TnbComparable.h の 122 行目に定義があります。

◆ operator>=()

bool operator>= ( const TNB::IConstCollectionT< TYP * > & t ) const

inherited

[確認] 比較

引数

t 比較対象

戻り値

true	自分は t と同じか大きい
false	自分は t より小さい

TnbComparable.h の 130 行目に定義があります。

◆ operator[]()

TYP * operator[] ( INDEX index ) const

[取得] 要素参照取得

引数

index インデックス

戻り値: 内容

例外

CIndexOutOfBoundsException インデックスが範囲外であることを示すためにスローされます。

TnbPointerVector.h の 208 行目に定義があります。

◆ Remove()

bool Remove ( INDEX index )

[削除] 要素削除

引数

index インデックス

戻り値

true	削除成功
false	失敗

TnbPointerVector.h の 130 行目に定義があります。

◆ RemoveAll()

void RemoveAll ( void )

[削除] 空化

TnbPointerVector.h の 138 行目に定義があります。

◆ RemoveElements()

size_t RemoveElements	(	INDEX	index,
		size_t	size = `0`
	)

[削除] 要素削除.

引数

index	インデックス
size	削除数。省略すると０。０を指定するとそれ以降全部削除します。

戻り値

INVALID_SIZE エラー。

戻り値: それ以外削除した数。

TnbPointerVector.h の 150 行目に定義があります。

◆ Serialize()

virtual void Serialize ( ISerializer & _sr ) const

virtual

[処理] シリアライズ

引数

[out] _sr シリアライザー。

例外

CNotSupportException サポートしていないことを示すためにスローされます。

IConstCollectionT< TYP * >を再実装しています。

TnbPointerVector.h の 227 行目に定義があります。

◆ Set()

bool Set	(	INDEX	index,
		TYP *	P
	)

[設定] 要素の設定

引数

index	インデックス
P	データのポインタ。newで確保したものに限ります。

戻り値

true	設定成功
false	失敗(インデックスが範囲外、など)

TnbPointerVector.h の 197 行目に定義があります。

◆ SetSize()

void SetSize ( size_t size )

[操作] サイズ指定

覚え書き: 大きくすることも小さくすることも出来ます。; 大きくした時、そのデータは NULL で埋められます。; 小さくした時、不必要にあったデータは delete されます。

引数

size サイズ

TnbPointerVector.h の 162 行目に定義があります。

◆ Unlock()

virtual void Unlock ( void ) const

virtual

[排他] アンロック

ISynchronizedを実装しています。

TnbPointerVector.h の 104 行目に定義があります。

公開メンバ関数

詳解

構築子と解体子

◆ CPointerVectorT() [1/2]

◆ CPointerVectorT() [2/2]

◆ ~CPointerVectorT()

関数詳解

◆ Add()

◆ At()

◆ begin()

◆ Compare()

◆ Deserialize()

◆ end()

◆ Find() [1/5]

◆ Find() [2/5]

◆ Find() [3/5]

◆ Find() [4/5]

◆ Find() [5/5]

◆ FindMax() [1/2]

◆ FindMax() [2/2]

◆ FindMin() [1/2]

◆ FindMin() [2/2]

◆ Get()

◆ GetElements()

◆ GetEx()

◆ GetSize()

◆ Insert()

◆ IsEmpty()

◆ IsEqual()

◆ IsInRange()

◆ Lock()

◆ operator size_t()

◆ operator!=()

◆ operator-()

◆ operator<()

◆ operator<=()

◆ operator=()

◆ operator==()

◆ operator>()

◆ operator>=()

◆ operator[]()

◆ Remove()

◆ RemoveAll()

◆ RemoveElements()

◆ Serialize()

◆ Set()

◆ SetSize()

◆ Unlock()