情報相互アクセスクラス [詳解]

#include <TnbMutualAccessor.h>

クラス
class	CSubSection
	情報相互アクセスサブセクションクラス [詳解]

struct	IWorker
	情報相互アクセスのワーカーインターフェース [詳解]

公開型
enum	EMode { QUERY , WRITE }
	モード [詳解]

公開メンバ関数
	CMutualAccessor (IAccessor *pAccessor, EMode mode=QUERY)
	コンストラクタ [詳解]

	CMutualAccessor (IAccessor::CSection &sec, EMode mode=QUERY)
	コンストラクタ [詳解]

bool	InSubSection (LPCTSTR lpszSection)
	[設定] 対象セクション変更. [詳解]

bool	IsQueryMode (void) const
	[確認] モード確認 [詳解]

bool	IsWriteMode (void) const
	[確認] モード確認 [詳解]

IAccessor::CSection *	operator-> (void)
	[参照] CSection 参照. [詳解]

void	PreviousSubSection (void)
	[設定] 対象セクション変更. [詳解]

bool	Works (LPCTSTR lpszKey, bool &_boValue, bool def=false)
	[処理] bool 情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, BYTE &_bValue, BYTE def=0)
	[処理] BYTE 情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, CButton &button, int def=BST_UNCHECKED)
	[処理] ボタン情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, CComboBox &comboBox, int def=0)
	[処理] コンボボックス情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, CStr &_strValue, LPCTSTR def=NULL)
	[処理] 文字列情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, CString &_strValue, LPCTSTR def=NULL)
	[処理] 文字列情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, double &_value, double def=0.0)
	[処理] LONGLONG 情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, DWORD &_dwValue, const CStrVector &vs, DWORD def=0)
	[処理] DWORD 情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, DWORD &_dwValue, DWORD def=0)
	[処理] DWORD 情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, HWND hWnd, LPCTSTR def=NULL)
	[処理] ウィンドウテキスト情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, ICollectionT< BYTE > &_c)
	[処理] コレクション情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, int &_iValue, int def=0)
	[処理] int 情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, ISerializable &_s)
	[処理] シリアライザブル情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, IWorker &_worker)
	[処理] ワーカー情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, long &_lValue, long def=0)
	[処理] long 情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, LONGLONG &_llValue, LONGLONG def=0)
	[処理] LONGLONG 情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, short &_value, short def=0)
	[処理] short 情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, size_t size, LPVOID P)
	[処理] レガシー構造体情報処理. [詳解]

bool	Works (LPCTSTR lpszKey, WORD &_wValue, WORD def=0)
	[処理] WORD 情報処理. [詳解]

限定公開メンバ関数
virtual void	OnFalse (void) const
	[通知] 各処理失敗通知. [詳解]

詳解

情報相互アクセスクラス

IAccessor を持つクラスのアクセス補助クラスです。

IAccessor へのアクセス（Query / Write）を行う変数と管理用のキーを
一元に管理することが出来るようになります。

使用例

    void CFoo::Init(void)
    {
        CInifileAccessor ini;
        CMutualAccessor a(&ini, CMutualAccessor::QUERY);
        BackupRestore(a);
    }

    void CFoo::Exit(void)
    {
        CInifileAccessor ini;
        CMutualAccessor a(&ini, CMutualAccessor::WRITE);
        BackupRestore(a);
    }

    bool CFoo::BuckupRestore(CMutualAccessor& _a)
    {
        CMutualAccessor::CSubSection sub(&_a, _T("Settings"));
        //
        bool r = _a.Works("DeviceNumber", m_wDeviceNumber, 1);
        r &= _a.Works("ModelNo", m_wModelNo, 3);
        r &= _a.Works("HardVersion", m_wHardVersion, 3);
        //
        CStrVector vs;
        vs.Add("NoConnect");
        vs.Add("Connect");
        r &= _a.Works("Mode", m_dwMode, vs, 0);
        return r;
    }

必要ファイル: TnbMutualAccessor.h

日付: 08/04/01 新規作成; 08/04/15 OnFalse() 追加。 CSubSectionクラス追加。; 10/01/15 構造更新。; 11/02/11 double にも対応。

TnbMutualAccessor.h の 71 行目に定義があります。

列挙型メンバ詳解

◆ EMode

enum EMode

モード

列挙値
QUERY	QUERYモード
WRITE	WRITEモード

TnbMutualAccessor.h の 152 行目に定義があります。

構築子と解体子

◆ CMutualAccessor() [1/2]

CMutualAccessor	(	IAccessor *	pAccessor,
		EMode	mode = `QUERY`
	)

コンストラクタ

引数

pAccessor	IAccessor のポインタ。 NULL は指定できません。
mode	本インスタンスのモード。省略か QUERY なら QUERYモード、 WRITE ならWRITEモードを指定。

TnbMutualAccessor.h の 163 行目に定義があります。

◆ CMutualAccessor() [2/2]

CMutualAccessor	(	IAccessor::CSection &	sec,
		EMode	mode = `QUERY`
	)

コンストラクタ

引数

sec	セクション。
mode	本インスタンスのモード。省略か QUERY なら QUERYモード、 WRITE ならWRITEモードを指定。

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

関数詳解

◆ InSubSection()

bool InSubSection ( LPCTSTR lpszSection )

[設定] 対象セクション変更.

指定のサブセクションを追加し、取得対象をそのセクション内にします。

引数

lpszSection セクション名

戻り値

true	成功
false	失敗

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

◆ IsQueryMode()

bool IsQueryMode ( void ) const

[確認] モード確認

戻り値

true	QUERYモード
false	WRITEモード

TnbMutualAccessor.h の 205 行目に定義があります。

◆ IsWriteMode()

bool IsWriteMode ( void ) const

[確認] モード確認

戻り値

false	QUERYモード
true	WRITEモード

TnbMutualAccessor.h の 215 行目に定義があります。

◆ OnFalse()

virtual void OnFalse ( void ) const

protectedvirtual

[通知] 各処理失敗通知.

覚え書き: 各処理が失敗した時に通知されます。このメソッドを継承して Throw するなど、処理を変更できます。; 本クラスでは、何もしません。

TnbMutualAccessor.h の 648 行目に定義があります。

◆ operator->()

IAccessor::CSection * operator-> ( void )

[参照] CSection 参照.

覚え書き: 本クラスが使用している CSection を参照します。 Works() メソッドだけでは処理できない場合、モードを確認して本メソッドを使って、処理が可能です。

戻り値: CSection 。

TnbMutualAccessor.h の 226 行目に定義があります。

◆ PreviousSubSection()

void PreviousSubSection ( void )

[設定] 対象セクション変更.

取得対象を一つ上のセクション内ににします。

覚え書き: IsSubSection() と対になるように使用します。

TnbMutualAccessor.h の 195 行目に定義があります。

◆ Works() [1/19]

bool Works	(	LPCTSTR	lpszKey,
		bool &	_boValue,
		bool	def = `false`
	)

[処理] bool 情報処理.

bool 情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_boValue	値。 QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 QUERYモードの時は、値が不明文字列の場合( _boValue は def が入ります)。 WRITEモードの場合は書込みに失敗した時。

TnbMutualAccessor.h の 241 行目に定義があります。

◆ Works() [2/19]

bool Works	(	LPCTSTR	lpszKey,
		BYTE &	_bValue,
		BYTE	def = `0`
	)

[処理] BYTE 情報処理.

BYTE 情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_bValue	値。 QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 261 行目に定義があります。

◆ Works() [3/19]

bool Works	(	LPCTSTR	lpszKey,
		CButton &	button,
		int	def = `BST_UNCHECKED`
	)

[処理] ボタン情報処理.

ボタン情報を Query / Write します。ボタンは通常「チェックボックス」のものを使います。

引数

[in]	lpszKey	キー。
[in,out]	button	ボタン。QUERYモードなら取得した値でボタン状態を設定。WRITEモードならボタン状態をインデックスを書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値をボタン状態とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 630 行目に定義があります。

◆ Works() [4/19]

bool Works	(	LPCTSTR	lpszKey,
		CComboBox &	comboBox,
		int	def = `0`
	)

[処理] コンボボックス情報処理.

コンボボックス情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	comboBox	コンボボックス。QUERYモードなら取得したインデックスでコンボボックスを選択。WRITEモードなら選択されているインデックスを書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値をインデックスとします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 611 行目に定義があります。

◆ Works() [5/19]

bool Works	(	LPCTSTR	lpszKey,
		CStr &	_strValue,
		LPCTSTR	def = `NULL`
	)

[処理] 文字列情報処理.

文字列情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_strValue	値。 QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 424 行目に定義があります。

◆ Works() [6/19]

bool Works	(	LPCTSTR	lpszKey,
		CString &	_strValue,
		LPCTSTR	def = `NULL`
	)

[処理] 文字列情報処理.

文字列情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_strValue	値。 QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 572 行目に定義があります。

◆ Works() [7/19]

bool Works	(	LPCTSTR	lpszKey,
		double &	_value,
		double	def = `0.0`
	)

[処理] LONGLONG 情報処理.

LONGLONG 情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_value	値。 QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 399 行目に定義があります。

◆ Works() [8/19]

bool Works	(	LPCTSTR	lpszKey,
		DWORD &	_dwValue,
		const CStrVector &	vs,
		DWORD	def = `0`
	)

[処理] DWORD 情報処理.

DWORD 情報をQuery / Write します。その際、値と対になる文字列配列を使って、情報を管理します。

引数

[in]	lpszKey	キー。
[in,out]	_dwValue	値。QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	vs	値を対になる文字列配列。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 QUERYモードの時は、値が不明文字列の場合( _dwValue は def が入ります)。 WRITEモードの場合は書込みに失敗した時。

TnbMutualAccessor.h の 522 行目に定義があります。

◆ Works() [9/19]

bool Works	(	LPCTSTR	lpszKey,
		DWORD &	_dwValue,
		DWORD	def = `0`
	)

[処理] DWORD 情報処理.

DWORD 情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_dwValue	値。 QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 321 行目に定義があります。

◆ Works() [10/19]

bool Works	(	LPCTSTR	lpszKey,
		HWND	hWnd,
		LPCTSTR	def = `NULL`
	)

[処理] ウィンドウテキスト情報処理.

ウィンドウテキスト情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	hWnd	ウィンドウハンドル。QUERYモードなら取得したテキストをこのウィンドウに設定。WRITEモードならこのウィンドウのテキストを書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 592 行目に定義があります。

◆ Works() [11/19]

bool Works	(	LPCTSTR	lpszKey,
		ICollectionT< BYTE > &	_c
	)

[処理] コレクション情報処理.

コレクション情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_c	値。 QUERYモードなら取得した情報をこれに格納。WRITEモードならこの情報を書込み。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 466 行目に定義があります。

◆ Works() [12/19]

bool Works	(	LPCTSTR	lpszKey,
		int &	_iValue,
		int	def = `0`
	)

[処理] int 情報処理.

int 情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_iValue	値。 QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 340 行目に定義があります。

◆ Works() [13/19]

bool Works	(	LPCTSTR	lpszKey,
		ISerializable &	_s
	)

[処理] シリアライザブル情報処理.

シリアライザブル情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_s	値。 QUERYモードなら取得した情報をこれに格納。WRITEモードならこの情報を書込み。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 485 行目に定義があります。

◆ Works() [14/19]

bool Works	(	LPCTSTR	lpszKey,
		IWorker &	_worker
	)

[処理] ワーカー情報処理.

ワーカー情報をQuery / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_worker	ワーカー。

戻り値

true	成功。
false	失敗。WRITEモードの場合は書込みに失敗した時。

TnbMutualAccessor.h の 556 行目に定義があります。

◆ Works() [15/19]

bool Works	(	LPCTSTR	lpszKey,
		long &	_lValue,
		long	def = `0`
	)

[処理] long 情報処理.

long 情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_lValue	値。 QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 360 行目に定義があります。

◆ Works() [16/19]

bool Works	(	LPCTSTR	lpszKey,
		LONGLONG &	_llValue,
		LONGLONG	def = `0`
	)

[処理] LONGLONG 情報処理.

LONGLONG 情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_llValue	値。 QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 380 行目に定義があります。

◆ Works() [17/19]

bool Works	(	LPCTSTR	lpszKey,
		short &	_value,
		short	def = `0`
	)

[処理] short 情報処理.

short 情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_value	値。 QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 301 行目に定義があります。

◆ Works() [18/19]

bool Works	(	LPCTSTR	lpszKey,
		size_t	size,
		LPVOID	P
	)

[処理] レガシー構造体情報処理.

構造体を Query / Write します。

引数

[in]	lpszKey	キー。
[in]	size	P のバッファサイズ。
[in,out]	P	値。 QUERYモードなら取得した情報をこれに格納。WRITEモードならこの情報を書込み。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 443 行目に定義があります。

◆ Works() [19/19]

bool Works	(	LPCTSTR	lpszKey,
		WORD &	_wValue,
		WORD	def = `0`
	)

[処理] WORD 情報処理.

WORD 情報を Query / Write します。

引数

[in]	lpszKey	キー。
[in,out]	_wValue	値。 QUERYモードなら取得した値をこれに格納。WRITEモードならこの値を書込み。
[in]	def	QUERYモードのみ使用。指定のキーがない場合、この値が戻り値とします。

戻り値

true	成功。
false	失敗。 WRITEモードの場合は書込みに失敗した時（QUERYモードは失敗はありません）。

TnbMutualAccessor.h の 281 行目に定義があります。

クラス

公開型

公開メンバ関数

限定公開メンバ関数

詳解

列挙型メンバ詳解

◆ EMode

構築子と解体子

◆ CMutualAccessor() [1/2]

◆ CMutualAccessor() [2/2]

関数詳解

◆ InSubSection()

◆ IsQueryMode()

◆ IsWriteMode()

◆ OnFalse()

◆ operator->()

◆ PreviousSubSection()

◆ Works() [1/19]

◆ Works() [2/19]

◆ Works() [3/19]

◆ Works() [4/19]

◆ Works() [5/19]

◆ Works() [6/19]

◆ Works() [7/19]

◆ Works() [8/19]

◆ Works() [9/19]

◆ Works() [10/19]

◆ Works() [11/19]

◆ Works() [12/19]

◆ Works() [13/19]

◆ Works() [14/19]

◆ Works() [15/19]

◆ Works() [16/19]

◆ Works() [17/19]

◆ Works() [18/19]

◆ Works() [19/19]