テキストファイル書込みクラス [詳解]

#include <TnbTextFile.h>

CTextFileWriter の継承関係図

公開メンバ関数
bool	CanWrite (void) const
	[確認] 書込み可能？. [詳解]

void	Close (void)
	[処理] クローズ. [詳解]

	CTextFileWriter (void)
	コンストラクタ [詳解]

bool	New (LPCTSTR lpszName, bool isUnicode=false)
	[作成] 新規ファイル作成. [詳解]

bool	Open (IWriter *pWriter, bool isUnicode=false)
	[作成] 新規ファイル作成. [詳解]

void	Write (const CStrVector &vs)
	[書込] 書き込み. [詳解]

void	WriteFormat (LPCSTR lpszFormat,...)
	[書込] 書式書き込み. [詳解]

void	WriteFormat (LPCWSTR lpszFormat,...)
	[書込] 書式書き込み. [詳解]

void	WriteLine (LPCSTR lpszLine)
	[書込] 一行書き込み. [詳解]

void	WriteLine (LPCWSTR lpszLine)
	[書込] 一行書き込み. [詳解]

静的公開メンバ関数
static bool	NewFile (LPCTSTR lpszName, const CStrVector &vs, bool isUnicode=false)
	[作成] 新規ファイル作成. [詳解]

詳解

テキストファイル書込みクラス

文字列を指定してファイルに書き込むことができます。

覚え書き: UNICODE テキストファイルも作成できます。; 改行コードは￥r￥n になります。; 最後の行に改行コードは付きません。

必要ファイル: TnbTextFile.h

日付: 11/02/10 新規作成; 11/10/12 NewFile() 新規。

TnbTextFile.h の 41 行目に定義があります。

構築子と解体子

◆ CTextFileWriter()

CTextFileWriter ( void )

コンストラクタ

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

関数詳解

◆ CanWrite()

bool CanWrite ( void ) const

[確認] 書込み可能？.

Open しているか確認できます。

戻り値

true	オープン済み（書込み可能）
false	未オープン

TnbTextFile.h の 56 行目に定義があります。

◆ Close()

void Close ( void )

[処理] クローズ.

覚え書き: オープンしていなかったら何もしません。

TnbTextFile.h の 65 行目に定義があります。

◆ New()

bool New	(	LPCTSTR	lpszName,
		bool	isUnicode = `false`
	)

[作成] 新規ファイル作成.

引数

lpszName	ファイル名.
isUnicode	true なら UNICODE TEXT ファイルを作成します。省略か false なら S-JIS TEXT ファイルを作成します。

戻り値

true	成功.
false	失敗.

TnbTextFile.h の 79 行目に定義があります。

◆ NewFile()

static bool NewFile	(	LPCTSTR	lpszName,
		const CStrVector &	vs,
		bool	isUnicode = `false`
	)

static

[作成] 新規ファイル作成.

覚え書き: 失敗しても、throw しません。

引数

lpszName	ファイル名.
vs	文字列配列
isUnicode	true なら UNICODE TEXT ファイルを作成します。省略か false なら S-JIS TEXT ファイルを作成します。

戻り値

true	成功.
false	失敗.

TnbTextFile.h の 191 行目に定義があります。

◆ Open()

bool Open	(	IWriter *	pWriter,
		bool	isUnicode = `false`
	)

[作成] 新規ファイル作成.

引数

pWriter	ライター。書き込みオープン済み、サイズ0である必要があります。
isUnicode	true なら UNICODE TEXT ファイルを作成します。省略か false なら S-JIS TEXT ファイルを作成します。

戻り値

true	成功.
false	失敗.

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

◆ Write()

void Write ( const CStrVector & vs )

[書込] 書き込み.

覚え書き: 文字列配列要素ごとに、自動的に改行が挿入されます。

引数

vs 文字列配列

例外

CWriteFailureException 書込みに失敗すると、スローされます。

TnbTextFile.h の 170 行目に定義があります。

◆ WriteFormat() [1/2]

void WriteFormat	(	LPCSTR	lpszFormat,
			...
	)

[書込] 書式書き込み.

覚え書き: 必要に応じて改行コードはをつけてください。

引数

lpszFormat	書式
...	パラメータ

例外

CWriteFailureException 書込みに失敗すると、スローされます。

TnbTextFile.h の 137 行目に定義があります。

◆ WriteFormat() [2/2]

void WriteFormat	(	LPCWSTR	lpszFormat,
			...
	)

[書込] 書式書き込み.

覚え書き: 必要に応じて改行コードはをつけてください。

引数

lpszFormat	書式
...	パラメータ

例外

CWriteFailureException 書込みに失敗すると、スローされます。

TnbTextFile.h の 154 行目に定義があります。

◆ WriteLine() [1/2]

void WriteLine ( LPCSTR lpszLine )

[書込] 一行書き込み.

覚え書き: 改行コードはつけないでください

引数

lpszLine 文字列

例外

CWriteFailureException 書込みに失敗すると、スローされます。

TnbTextFile.h の 110 行目に定義があります。

◆ WriteLine() [2/2]

void WriteLine ( LPCWSTR lpszLine )

[書込] 一行書き込み.

覚え書き: 改行コードはつけないでください

引数

lpszLine 文字列

例外

CWriteFailureException 書込みに失敗すると、スローされます。

TnbTextFile.h の 123 行目に定義があります。

公開メンバ関数

静的公開メンバ関数

詳解

構築子と解体子

◆ CTextFileWriter()

関数詳解

◆ CanWrite()

◆ Close()

◆ New()

◆ NewFile()

◆ Open()

◆ Write()

◆ WriteFormat() [1/2]

◆ WriteFormat() [2/2]

◆ WriteLine() [1/2]

◆ WriteLine() [2/2]