Gridファイル管理クラス [詳解]

#include <TnbGridFile.h>

CGridFile の継承関係図

公開型
enum	EFieldKind { EK_String , EK_Integer , EK_Float , EK_Date , EK_Invalid }
	フィールド種類 [詳解]

enum	EFieldType { ET_Character = 'C' , ET_Date = 'D' , ET_Numeric = 'N' , ET_Floating = 'F' , ET_Logical = 'L' }
	フィールドタイプ [詳解]

公開メンバ関数
INDEX	AddCharacterField (LPCTSTR lpszFieldName, size_t width)
	[追加] 文字フィールド追加. [詳解]

INDEX	AddDateField (LPCTSTR lpszFieldName)
	[追加] 日付フィールド追加. [詳解]

INDEX	AddField (const TFieldInfo &fi)
	[追加] フィールド追加. [詳解]

INDEX	AddFloatingField (LPCTSTR lpszFieldName, size_t width, size_t dec=0)
	[追加] 数値フィールド追加. [詳解]

INDEX	AddNumericField (LPCTSTR lpszFieldName, size_t width, size_t dec=0)
	[追加] 数値フィールド追加. [詳解]

INDEX	AddRecord (void)
	[追加] レコード追加. [詳解]

void	AllDelete (void)
	[削除] 全削除. [詳解]

bool	AllDeleteRecord (void)
	[削除] レコード全削除. [詳解]

bool	DeleteField (INDEX field)
	[削除] フィールド削除. [詳解]

bool	DeleteRecord (INDEX record)
	[削除] レコード削除. [詳解]

INDEX	FindFieldName (LPCTSTR lpszFieldName) const
	[検索] フィールド名検索 [詳解]

TDate	GetDateRecord (INDEX record, INDEX field) const
	[取得] レコード日付取得. [詳解]

size_t	GetFieldCount (void) const
	[取得] フィールド数取得 [詳解]

EFieldKind	GetFieldInfo (TFieldInfo &_fi, INDEX field) const
	[取得] フィールド情報取得 [詳解]

double	GetFloatRecord (INDEX record, INDEX field) const
	[取得] レコード実数取得. [詳解]

int	GetIntegerRecord (INDEX record, INDEX field) const
	[取得] レコード数値取得. [詳解]

size_t	GetRecordCount (void) const
	[取得] レコード数取得 [詳解]

CStr	GetStringRecord (INDEX record, INDEX field, bool isAdjust=false) const
	[取得] レコード文字列取得. [詳解]

bool	InsertRecord (INDEX record)
	[挿入] レコード挿入. [詳解]

bool	IsNullRecord (INDEX record, INDEX field) const
	[確認] レコードNULL確認 [詳解]

bool	LoadCsvFile (LPCTSTR lpszFileName, bool hasHeadLine=true)
	[読込] CSVファイル読込み. [詳解]

bool	SaveCsvFile (LPCTSTR lpszFileName, bool hasHeadLine=true) const
	[書出] CSVファイル書き出し [詳解]

bool	SetDateRecord (INDEX record, INDEX field, const TDate &date)
	[設定] レコード日付設定. [詳解]

bool	SetFloatRecord (INDEX record, INDEX field, double value)
	[設定] レコード実数設定. [詳解]

bool	SetIntegerRecord (INDEX record, INDEX field, int value)
	[設定] レコード数値設定. [詳解]

bool	SetNullRecord (INDEX record, INDEX field)
	[設定] レコードNULL設定. [詳解]

bool	SetStringRecord (INDEX record, INDEX field, LPCTSTR lpszString)
	[設定] レコード文字列設定. [詳解]

限定公開メンバ関数
void	Dump (void)
	Traceダンプ [詳解]

詳解

Gridファイル管理クラス

1つ以上の任意の型のフィールドと、複数のレコードからなる情報を扱います。
また、 CSV形式のファイルの読み書きをサポートします。

必要ファイル: TnbGridFile.h

日付: 09/04/16 新規作成

TnbGridFile.h の 33 行目に定義があります。

列挙型メンバ詳解

◆ EFieldKind

enum EFieldKind

inherited

フィールド種類

列挙値
EK_String	文字列
EK_Integer	数値
EK_Float	実数
EK_Date	日付
EK_Invalid	不正

TnbGrid.h の 37 行目に定義があります。

◆ EFieldType

enum EFieldType

inherited

フィールドタイプ

列挙値
ET_Character	文字列
ET_Date	年月日
ET_Numeric	数値
ET_Floating	浮動小数点数値
ET_Logical	論理(?,Y,N,T,F)

TnbGrid.h の 47 行目に定義があります。

関数詳解

◆ AddCharacterField()

INDEX AddCharacterField	(	LPCTSTR	lpszFieldName,
		size_t	width
	)

inherited

[追加] 文字フィールド追加.

覚え書き: フィールド名が既存の場合、失敗します。; レコードがある場合、失敗します。

引数

lpszFieldName	フィールド名
width	フィールド幅

戻り値

INVALID_INDEX以外	追加成功。値は追加したフィールドインデックス。
INVALID_INDEX	フィールド追加失敗

TnbGrid.h の 214 行目に定義があります。

◆ AddDateField()

INDEX AddDateField ( LPCTSTR lpszFieldName )

inherited

[追加] 日付フィールド追加.

覚え書き: フィールド名が既存の場合、失敗します。; レコードがある場合、失敗します。

引数

lpszFieldName フィールド名

戻り値

INVALID_INDEX以外	追加成功。値は追加したフィールドインデックス。
INVALID_INDEX	フィールド追加失敗

TnbGrid.h の 270 行目に定義があります。

◆ AddField()

INDEX AddField ( const TFieldInfo & fi )

inherited

[追加] フィールド追加.

覚え書き: フィールド名が既存の場合、失敗します。; レコードがある場合、失敗します。

引数

fi フィールド追加

戻り値

INVALID_INDEX以外	追加成功。値は追加したフィールドインデックス。
INVALID_INDEX	フィールド追加失敗

TnbGrid.h の 196 行目に定義があります。

◆ AddFloatingField()

INDEX AddFloatingField	(	LPCTSTR	lpszFieldName,
		size_t	width,
		size_t	dec = `0`
	)

inherited

[追加] 数値フィールド追加.

覚え書き: フィールド名が既存の場合、失敗します。; レコードがある場合、失敗します。　; 指数形式で管理します。

引数

lpszFieldName	フィールド名
width	フィールド幅
dec	小数点部幅。省略すると０になります。

戻り値

INVALID_INDEX以外	追加成功。値は追加したフィールドインデックス。
INVALID_INDEX	フィールド追加失敗

TnbGrid.h の 252 行目に定義があります。

◆ AddNumericField()

INDEX AddNumericField	(	LPCTSTR	lpszFieldName,
		size_t	width,
		size_t	dec = `0`
	)

inherited

[追加] 数値フィールド追加.

覚え書き: フィールド名が既存の場合、失敗します。; レコードがある場合、失敗します。　; 小数形式で管理します。そのため、数値の範囲によりフィールド幅、小数点部幅を考慮する必要があります。

引数

lpszFieldName	フィールド名
width	フィールド幅
dec	小数点部幅。省略すると０になります。

戻り値

INVALID_INDEX以外	追加成功。値は追加したフィールドインデックス。
INVALID_INDEX	フィールド追加失敗

TnbGrid.h の 231 行目に定義があります。

◆ AddRecord()

INDEX AddRecord ( void )

inherited

[追加] レコード追加.

覚え書き: 追加したレコードの全フィールドはNULLになっています。

戻り値

INVALID_INDEX以外	追加成功。値は追加したレコードインデックス。
INVALID_INDEX	レコード追加失敗

TnbGrid.h の 308 行目に定義があります。

◆ AllDelete()

void AllDelete ( void )

inherited

[削除] 全削除.

覚え書き: レコードも全削除します。

TnbGrid.h の 129 行目に定義があります。

◆ AllDeleteRecord()

bool AllDeleteRecord ( void )

inherited

[削除] レコード全削除.

戻り値

true	成功
false	失敗

TnbGrid.h の 297 行目に定義があります。

◆ DeleteField()

bool DeleteField ( INDEX field )

inherited

[削除] フィールド削除.

覚え書き: レコードがある場合、失敗します。

引数

field フィールドインデックス

戻り値

true	成功
false	失敗

TnbGrid.h の 283 行目に定義があります。

◆ DeleteRecord()

bool DeleteRecord ( INDEX record )

inherited

[削除] レコード削除.

引数

record レコードインデックス

戻り値

true	成功
false	失敗

TnbGrid.h の 345 行目に定義があります。

◆ Dump()

void Dump ( void )

protectedinherited

Traceダンプ

TnbGrid.h の 613 行目に定義があります。

◆ FindFieldName()

INDEX FindFieldName ( LPCTSTR lpszFieldName ) const

inherited

[検索] フィールド名検索

引数

lpszFieldName フィールド名

戻り値

INVALID_INDEX以外	発見。値はフィールドインデックス。
INVALID_INDEX	見つからない

TnbGrid.h の 159 行目に定義があります。

◆ GetDateRecord()

TDate GetDateRecord	(	INDEX	record,
		INDEX	field
	)		const

inherited

[取得] レコード日付取得.

引数

record	レコードインデックス
field	フィールドインデックス

戻り値: 日付

TnbGrid.h の 604 行目に定義があります。

◆ GetFieldCount()

size_t GetFieldCount ( void ) const

inherited

[取得] フィールド数取得

戻り値: フィールド数

TnbGrid.h の 139 行目に定義があります。

◆ GetFieldInfo()

EFieldKind GetFieldInfo	(	TFieldInfo &	_fi,
		INDEX	field
	)		const

inherited

[取得] フィールド情報取得

引数

[out]	_fi	フィールド情報
[in]	field	フィードインデックス

戻り値

EK_Invalid以外	取得成功。値は種類。
EK_Invalid	失敗（インデックスが範囲外）。

TnbGrid.h の 178 行目に定義があります。

◆ GetFloatRecord()

double GetFloatRecord	(	INDEX	record,
		INDEX	field
	)		const

inherited

[取得] レコード実数取得.

引数

record	レコードインデックス
field	フィールドインデックス

戻り値: 実数

TnbGrid.h の 580 行目に定義があります。

◆ GetIntegerRecord()

int GetIntegerRecord	(	INDEX	record,
		INDEX	field
	)		const

inherited

[取得] レコード数値取得.

引数

record	レコードインデックス
field	フィールドインデックス

戻り値: 数値

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

◆ GetRecordCount()

size_t GetRecordCount ( void ) const

inherited

[取得] レコード数取得

戻り値: レコード数

TnbGrid.h の 148 行目に定義があります。

◆ GetStringRecord()

CStr GetStringRecord	(	INDEX	record,
		INDEX	field,
		bool	isAdjust = `false`
	)		const

inherited

[取得] レコード文字列取得.

引数

record	レコードインデックス
field	フィールドインデックス
isAdjust	true ならフィールドの幅になるようにスペースでパディング、調整します。

戻り値: 文字列

TnbGrid.h の 481 行目に定義があります。

◆ InsertRecord()

bool InsertRecord ( INDEX record )

inherited

[挿入] レコード挿入.

覚え書き: 挿入追加したレコードの全フィールドはNULLになっています。

引数

record レコードインデックス。

戻り値

true	成功
false	失敗

TnbGrid.h の 327 行目に定義があります。

◆ IsNullRecord()

bool IsNullRecord	(	INDEX	record,
		INDEX	field
	)		const

inherited

[確認] レコードNULL確認

引数

record	レコードインデックス
field	フィールドインデックス

戻り値

true	NULL。フィールドインデックス、レコードインデックスが無効の場合も true が返ります。
false	失敗

TnbGrid.h の 464 行目に定義があります。

◆ LoadCsvFile()

bool LoadCsvFile	(	LPCTSTR	lpszFileName,
		bool	hasHeadLine = `true`
	)

[読込] CSVファイル読込み.

覚え書き: レコードは読み込みません。読み込む前に設定しておく必要があります。

引数

lpszFileName	ファイル名
hasHeadLine	true ならヘッダがあるとし、読み込み対象にしません。

戻り値

true	成功
false	失敗

TnbGridFile.h の 46 行目に定義があります。

◆ SaveCsvFile()

bool SaveCsvFile	(	LPCTSTR	lpszFileName,
		bool	hasHeadLine = `true`
	)		const

[書出] CSVファイル書き出し

引数

lpszFileName	ファイル名
hasHeadLine	true なら一行目にヘッダを書き出します。

戻り値

true	成功
false	失敗

TnbGridFile.h の 78 行目に定義があります。

◆ SetDateRecord()

bool SetDateRecord	(	INDEX	record,
		INDEX	field,
		const TDate &	date
	)

inherited

[設定] レコード日付設定.

覚え書き: 日付のフィールド以外には設定できません。

引数

record	レコードインデックス
field	フィールドインデックス
date	日付

戻り値

true	成功
false	失敗

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

◆ SetFloatRecord()

bool SetFloatRecord	(	INDEX	record,
		INDEX	field,
		double	value
	)

inherited

[設定] レコード実数設定.

覚え書き: 実数のフィールド以外には設定できません。

引数

record	レコードインデックス
field	フィールドインデックス
value	値

戻り値

true	成功
false	失敗

TnbGrid.h の 420 行目に定義があります。

◆ SetIntegerRecord()

bool SetIntegerRecord	(	INDEX	record,
		INDEX	field,
		int	value
	)

inherited

[設定] レコード数値設定.

覚え書き: 数値のフィールド以外には設定できません。

引数

record	レコードインデックス
field	フィールドインデックス
value	値

戻り値

true	成功
false	失敗

TnbGrid.h の 397 行目に定義があります。

◆ SetNullRecord()

bool SetNullRecord	(	INDEX	record,
		INDEX	field
	)

inherited

[設定] レコードNULL設定.

引数

record	レコードインデックス
field	フィールドインデックス

戻り値

true	成功
false	失敗

TnbGrid.h の 357 行目に定義があります。

◆ SetStringRecord()

bool SetStringRecord	(	INDEX	record,
		INDEX	field,
		LPCTSTR	lpszString
	)

inherited

[設定] レコード文字列設定.

覚え書き: 文字列のフィールド以外にも設定可能です。

引数

record	レコードインデックス
field	フィールドインデックス
lpszString	文字列

戻り値

true	成功
false	失敗

TnbGrid.h の 377 行目に定義があります。

公開型

公開メンバ関数

限定公開メンバ関数

詳解

列挙型メンバ詳解

◆ EFieldKind

◆ EFieldType

関数詳解

◆ AddCharacterField()

◆ AddDateField()

◆ AddField()

◆ AddFloatingField()

◆ AddNumericField()

◆ AddRecord()

◆ AllDelete()

◆ AllDeleteRecord()

◆ DeleteField()

◆ DeleteRecord()

◆ Dump()

◆ FindFieldName()

◆ GetDateRecord()

◆ GetFieldCount()

◆ GetFieldInfo()

◆ GetFloatRecord()

◆ GetIntegerRecord()

◆ GetRecordCount()

◆ GetStringRecord()

◆ InsertRecord()

◆ IsNullRecord()

◆ LoadCsvFile()

◆ SaveCsvFile()

◆ SetDateRecord()

◆ SetFloatRecord()

◆ SetIntegerRecord()

◆ SetNullRecord()

◆ SetStringRecord()