recordset フィルタリングクエリー [詳解]

#include <groupQuery.h>

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)

静的公開メンバ関数
static recordsetQuery *	create ()

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

基底クラス 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

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

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

詳解

recordset フィルタリングクエリー

recordset のレコードをフィルタリングする際に使用するクエリを表現します。
このクラスは、 recordset::matchBy() と groupFuncBase の派生クラスのコンストラクタまたは groupFuncBase::setQuery() に渡して使用します。
それぞれの関数内でこのクラスに設定されたクエリーに従って、レコードをフィルタリングします。
内部でどのように式が評価されるかは query クラスの詳細を参照してください。

参照: recordset query

構築子と解体子

recordsetQuery ( )

コンストラクタ。

recordsetQuery ( const recordsetQuery & r )

コピーコンストラクタ。

~recordsetQuery ( )

デストラクタ。

関数詳解

recordsetQuery & and_	(	const _TCHAR *	name,
		const _TCHAR *	qlogic,
		T	value
	)

inline

when() か or_() に続くレコードマッチ条件を指定します。

引数

name	フィールド名を指定します。
qlogic	比較条件を指定します。次の文字列が使用できます。">" ">=" "<" "<=" "=" "<>"
value	比較する値を指定します。Tはテンプレート型で char short int __int64 float double const _TCHAR* 型が使用できます。

戻り値: メソッドチェーンのために *thisが返されます。

注釈: valueにNULLポインターを渡すことはできません。NULLポインターを渡すと例外がスローされます。

recordsetQuery & andIsNotNull ( const _TCHAR * name )

inline

直前の条件がレコードにマッチし、andで結合する非NULLのレコードマッチ条件を追加します

引数

name	フィールド名を指定します。

戻り値: メソッドチェーンのために *thisが返されます。

recordsetQuery & andIsNull ( const _TCHAR * name )

inline

直前の条件がレコードにマッチし、andで結合するNULLのレコードマッチ条件を追加します

引数

name	フィールド名を指定します。

戻り値: メソッドチェーンのために *thisが返されます。

static recordsetQuery * create ( )

static

recordsetQueryオブジェクトを生成し返します。new演算子の代わりにこの関数にて生成するようにしてください。DLL内で実装されたnew演算子が使用されるようになります。また破棄は delete の代わりに release() を呼び出してください。引数の詳細は対応するコンストラクタを参照してください。

query * internalQuery ( )

inline

継承元のqueryのポインターを返します。通常この関数は使用しないでください。

recordsetQuery & operator= ( const recordsetQuery & r )

代入演算子。

recordsetQuery & or_	(	const _TCHAR *	name,
		const _TCHAR *	qlogic,
		T	value
	)

inline

when() か and_() に続くレコードマッチ条件を指定します。

引数

name	フィールド名を指定します。
qlogic	比較条件を指定します。次の文字列が使用できます。">" ">=" "<" "<=" "=" "<>"
value	比較する値を指定します。Tはテンプレート型で char short int __int64 float double const _TCHAR* 型が使用できます。

戻り値: メソッドチェーンのために *thisが返されます。

注釈: valueにNULLポインターを渡すことはできません。NULLポインターを渡すと例外がスローされます。

recordsetQuery & orIsNotNull ( const _TCHAR * name )

inline

直前の条件にorで結合する非NULLのレコードマッチ条件を追加します

recordsetQuery & orIsNull ( const _TCHAR * name )

inline

直前の条件にorで結合するNULLのレコードマッチ条件を追加します

引数

name	フィールド名を指定します。

戻り値: メソッドチェーンのために *thisが返されます。

void release ( )

recordsetQueryオブジェクトを破棄します。 create() で生成したオブジェクトは必ずこの関数で破棄してください。

recordsetQuery & reset ( )

inline

既に指定されたマッチ条件をすべてクリアします。

戻り値: メソッドチェーンのために *thisが返されます。

const _TCHAR * toString ( ) const

inline

設定された条件クエリー(フィルター)を文字列で返します。

recordsetQuery & when	(	const _TCHAR *	name,
		const _TCHAR *	qlogic,
		T	value
	)

inline

最初のレコードマッチ条件を指定します。この関数を呼び出すと以前に指定されていたマッチ条件はクリアされます。

引数

name	フィールド名を指定します。
qlogic	比較条件を指定します。次の文字列が使用できます。">" ">=" "<" "<=" "=" "<>"
value	比較する値を指定します。Tはテンプレート型で char short int __int64 float double const _TCHAR* 型が使用できます。

戻り値: メソッドチェーンのために *thisが返されます。

注釈: valueにNULLポインターを渡すことはできません。NULLポインターを渡すと例外がスローされます。

recordsetQuery & whenIsNotNull ( const _TCHAR * name )

inline

最初のレコードマッチ条件が非NULLであると指定します
この関数を呼び出すと以前に指定されていたマッチ条件はクリアされます。

引数

name	フィールド名を指定します。

戻り値: メソッドチェーンのために *thisが返されます。

recordsetQuery & whenIsNull ( const _TCHAR * name )

inline

最初のレコードマッチ条件がNULLであると指定します
この関数を呼び出すと以前に指定されていたマッチ条件はクリアされます。

引数

name	フィールド名を指定します。

戻り値: メソッドチェーンのために *thisが返されます。

公開メンバ関数

静的公開メンバ関数

その他の継承メンバ

詳解

構築子と解体子

関数詳解