グルーピング計算関数のベースクラス [詳解]

#include <groupQuery.h>

groupFuncBase の継承関係図

公開メンバ関数
	groupFuncBase ()

	groupFuncBase (const groupFuncBase &v)

	groupFuncBase (const fieldNames &targetNames, const _TCHAR *resultName=NULL)

virtual	~groupFuncBase ()

virtual groupFuncBase *	clone ()=0

uchar_td	decimals () const

bool	isNull (int index) const

groupFuncBase &	operator= (const groupFuncBase &v)

groupFuncBase &	operator= (const recordsetQuery &v)

void	reset ()

int	resultKey () const

const _TCHAR *	resultName () const

void	setResultName (const _TCHAR *v)

fieldNames &	targetNames () const

基底クラス recordsetQuery に属する継承公開メンバ関数
	recordsetQuery ()

	recordsetQuery (const recordsetQuery &r)

	~recordsetQuery ()

template<class T >
recordsetQuery &	and_ (const _TCHAR name, const _TCHAR qlogic, T value)

recordsetQuery &	andIsNotNull (const _TCHAR *name)

recordsetQuery &	andIsNull (const _TCHAR *name)

query *	internalQuery ()

recordsetQuery &	operator= (const recordsetQuery &r)

template<class T >
recordsetQuery &	or_ (const _TCHAR name, const _TCHAR qlogic, T value)

recordsetQuery &	orIsNotNull (const _TCHAR *name)

recordsetQuery &	orIsNull (const _TCHAR *name)

void	release ()

recordsetQuery &	reset ()

const _TCHAR *	toString () const

template<class T >
recordsetQuery &	when (const _TCHAR name, const _TCHAR qlogic, T value)

recordsetQuery &	whenIsNotNull (const _TCHAR *name)

recordsetQuery &	whenIsNull (const _TCHAR *name)

限定公開型
typedef double	numeric_type

基底クラス queryBase に属する継承限定公開型
enum	eOptimize { none = 0, joinHasOneOrHasMany = 1, combineCondition = 2 }
	クエリーの実行時に行われる最適化条件をセットします。 [詳解]

限定公開メンバ関数
void	clearInsertFlag ()

virtual void	doCalc (const row_ptr &row, int index)

virtual void	doCalcEachkey (const field &fd, int index)

virtual void	doInit (const fielddefs *fdinfo)

virtual void	doReset ()

void	init (const fielddefs *fdinfo)

virtual void	initResultVariable (int index)

bool	insertFlag () const

virtual numeric_type	numericResult (int index) const

void	operator() (const row_ptr &row, int index, bool insert)

ushort_td	resultLen () const

uchar_td	resultType () const

unsigned char *	stringResult (int index) const

基底クラス query に属する継承限定公開メンバ関数
	query ()

	query (const query &r)

virtual	~query ()

template<class T >
query &	and_ (const _TCHAR name, const _TCHAR qlogic, T value)

query &	andIsNotNull (const _TCHAR *name)

query &	andIsNull (const _TCHAR *name)

template<class T0 , class T1 , class T2 , class T3 , class T4 , class T5 , class T6 , class T7 >
query &	in (const T0 kv0, const T1 kv1, const T2 kv2, const T3 kv3, const T4 kv4, const T5 kv5, const T6 kv6, const T7 kv7)

template<class T0 , class T1 , class T2 , class T3 , class T4 , class T5 , class T6 >
query &	in (const T0 kv0, const T1 kv1, const T2 kv2, const T3 kv3, const T4 kv4, const T5 kv5, const T6 kv6)

template<class T0 , class T1 , class T2 , class T3 , class T4 , class T5 >
query &	in (const T0 kv0, const T1 kv1, const T2 kv2, const T3 kv3, const T4 kv4, const T5 kv5)

template<class T0 , class T1 , class T2 , class T3 , class T4 >
query &	in (const T0 kv0, const T1 kv1, const T2 kv2, const T3 kv3, const T4 kv4)

template<class T0 , class T1 , class T2 , class T3 >
query &	in (const T0 kv0, const T1 kv1, const T2 kv2, const T3 kv3)

template<class T0 , class T1 , class T2 >
query &	in (const T0 kv0, const T1 kv1, const T2 kv2)

template<class T0 , class T1 >
query &	in (const T0 kv0, const T1 kv1)

template<class T0 >
query &	in (const T0 kv0)

template<class T >
query &	or_ (const _TCHAR name, const _TCHAR qlogic, T value)

query &	orIsNotNull (const _TCHAR *name)

query &	orIsNull (const _TCHAR *name)

query &	reset ()

query &	segmentsForInValue (int v)

query &	select (const _TCHAR name, const _TCHAR name1=NULL, const _TCHAR name2=NULL, const _TCHAR name3=NULL, const _TCHAR name4=NULL, const _TCHAR name5=NULL, const _TCHAR name6=NULL, const _TCHAR name7=NULL, const _TCHAR name8=NULL, const _TCHAR name9=NULL, const _TCHAR *name10=NULL)

template<class T >
query &	where (const _TCHAR name, const _TCHAR qlogic, T value)

query &	whereIsNotNull (const _TCHAR *name)

query &	whereIsNull (const _TCHAR *name)

基底クラス queryBase に属する継承限定公開メンバ関数
const std::vector < std::_tstring > &	getSeekKeyValues () const

const std::vector< keyValuePtr > &	getSeekValuesPtr () const

const std::vector < std::_tstring > &	getSelects () const

const std::vector < std::_tstring > &	getWheres () const

	queryBase ()

	queryBase (const queryBase &r)

virtual	~queryBase ()

void	addField (const _TCHAR *name)

void	addLogic (const _TCHAR name, const _TCHAR logic, const _TCHAR *value)

void	addLogic (const _TCHAR combine, const _TCHAR name, const _TCHAR logic, const _TCHAR value)

void	addSeekBookmark (bookmark_td &bm, ushort_td len, bool reset=false)

void	addSeekKeyValue (const _TCHAR *value, bool reset=false)

void	addSeekKeyValuePtr (const void *value, ushort_td len, short typeStr, bool reset=false)

queryBase &	all ()

queryBase &	bookmarkAlso (bool v)

void	clearSeekKeyValues ()

void	clearSelectFields ()

queryBase &	direction (table::eFindType v)

table::eFindType	getDirection () const

int	getJoinKeySize () const

int	getLimit () const

eOptimize	getOptimize () const

int	getReject () const

const _TCHAR *	getSelect (short index) const

const _TCHAR *	getWhereToken (short index) const

bool	isAll () const

bool	isBookmarkAlso () const

bool	isSeekByBookmarks () const

bool	isStopAtLimit () const

queryBase &	joinKeySize (int v)

queryBase &	limit (int v)

queryBase &	operator= (const queryBase &r)

queryBase &	optimize (eOptimize v)

queryBase &	queryString (const _TCHAR *str, bool autoEscape=false)

queryBase &	reject (int v)

void	release ()

void	reserveSeekKeyValuePtrSize (size_t v)

void	reserveSeekKeyValueSize (size_t v)

void	reset ()

void	reverseAliasName (const _TCHAR alias, const _TCHAR src)

short	selectCount () const

void	setWhereToken (short index, const _TCHAR *v)

queryBase &	stopAtLimit (bool v)

const _TCHAR *	toString () const

short	whereTokens () const

限定公開変数類
class groupFuncBaseImple *	m_imple

その他の継承メンバ
基底クラス recordsetQuery に属する継承静的公開メンバ関数
static recordsetQuery *	create ()

基底クラス query に属する継承静的限定公開メンバ関数
static query *	create ()

基底クラス queryBase に属する継承静的限定公開メンバ関数
static queryBase *	create ()

詳解

グルーピング計算関数のベースクラス

グルーピング時にグループごとに計算を行うクラスの基底クラス
計算に必要な基本的なフレームワークを提供します。
このクラスをオーバライドすると容易にさまざまな計算クラスを実装できます。
計算結果はデフォルトでdouble型のデータが返されます。

型定義メンバ詳解

numeric_type

protected

計算結果の型を定義しています。デフォルトはdouble型です。

構築子と解体子

groupFuncBase ( )

コンストラクタ

groupFuncBase ( const groupFuncBase & v )

コピーコンストラクタ

groupFuncBase	(	const fieldNames &	targetNames,
		const _TCHAR *	resultName = `NULL`
	)

引数

targetNames	計算の対象となる列名リストを指定します。
resultName	結果を保持する列名を指定します。NULLで且つ場合targetNamesで指定したフィールドが一つの場合その名前にします。

~groupFuncBase ( )

virtual

仮想デストラクタ

関数詳解

void clearInsertFlag ( )

protected

内部に保持されたinsertFlagをクリアします。

virtual groupFuncBase* clone ( )

pure virtual

first, last, min, count, sumで実装されています。

uchar_td decimals ( ) const

結果がdouble型の場合で、文字列変換の際の小数点以下の桁数を返します。
小数点以下の桁数は、計算内容と対象の列の型によって決まります。

void doCalc	(	const row_ptr &	row,
		int	index
	)

protectedvirtual

この関数内で実際の計算を行います。単一の変数で結果を計算できる場合は m_values[index]に値を入れます。たとえば合計であれば m_values[index] += このレコードの値となります。
計算の内容ごとに異なった実装を行います。

引数

row	対象のレコードです。
index	グルーピングされたグループの番号を示します。通常、計算はグループごとに区別して行います。

first, last, countで再実装されています。

virtual void doCalcEachkey	(	const field &	fd,
		int	index
	)

protectedvirtual

min, count, sumで再実装されています。

virtual void doInit ( const fielddefs * fdinfo )

protectedvirtual

lastで再実装されています。

void doReset ( )

protectedvirtual

reset() を実装します。継承したクラスでこの関数をオーバーライドすることで、独自の変数を初期化することができます。

firstで再実装されています。

void init ( const fielddefs * fdinfo )

protected

フィールド定義を受け取って m_resultKey m_targetKey に名前から番号をセットします。
resultName() が既存ではない名前の場合は、m_resultKeyに現在あるフィールド数をセットします。 groupQuery クラスで新しい列が自動で追加されます。

引数

fdinfo フィールド定義

void initResultVariable ( int index )

protectedvirtual

新しいグループ番号が追加された際に、新しい値を保持する変数を確保します。
この関数は、必要なときに operator() から呼び出されます。

引数

index グループ番号

countで再実装されています。

bool insertFlag ( ) const

protected

内部に保持されたinsertFlagの値を返します。新しいグループが追加された際にtrueを返します。
clearInsertFlag() を呼び出すことで、falseに設定されます。

bool isNull ( int index ) const

indexで指定されたグループの値がNULLかどうかを返します。

numeric_type numericResult ( int index ) const

protectedvirtual

数値型の計算結果を返します。コンストラクに渡した、targetNamesの最初のフィールド型が数値型の場合にのみ有効です。

引数

index グループ番号

戻り値: indexで指定されたグループの計算結果を返します。

void operator()	(	const row_ptr &	row,
		int	index,
		bool	insert
	)

protected

一つの行について計算を実行します。この関数はグルーピング時にgroupQuery クラスから各行ごとに繰り返し呼び出されます。

引数

row	対象の行
index	グループ番号
insert	indexで示されたグループ番号が一連の呼び出しで始めて呼び出されたかどうかを示します。通常はじめての場合、結果データを保持する変数を確保します。

void groupFuncBase & operator= ( const groupFuncBase & v )

v指定されたgroupFuncBaseオブジェクトの内容をこのオブジェクトにコピーします。

void groupFuncBase & operator= ( const recordsetQuery & v )

v指定されたrecordsetQueryオブジェクトの内容をこのオブジェクトにコピーし参照を返します。

void reset ( )

計算結果をクリアします。

int resultKey ( ) const

戻り値: 結果がセットされる列番号を返します。

ushort_td resultLen ( ) const

protected

結果を返すフィールド定義のフィールド長を返します。

const _TCHAR * resultName ( ) const

戻り値: 結果がセットされる列名を返します。

uchar_td resultType ( ) const

protected

結果を返すフィールド定義のフィールドタイプを返します。

void setResultName ( const _TCHAR * v )

結果がセットされる列名を設定します。

v指定されたrecordsetQueryオブジェクトの内容をこのオブジェクトにコピーし参照を返します。

結果を保持する列名をセットします。

unsigned char * stringResult ( int index ) const

protected

文字列型の処理結果を返します。コンストラクに渡した、targetNamesの最初のフィールド型が文字列型の場合にのみ有効です。

fieldNames & targetNames ( ) const

戻り値: 計算対象の列名リストを返します。

メンバ詳解

class groupFuncBaseImple * m_imple

protected

このクラスの内部実装ポインタ

公開メンバ関数

限定公開型

限定公開メンバ関数

限定公開変数類

その他の継承メンバ

詳解

型定義メンバ詳解

構築子と解体子

関数詳解

メンバ詳解