LZファイル読み込みクラス [詳解]

#include <TnbLzFile.h>

CLzFileReader の継承関係図

公開型
enum	ESeekMode { TOP = FILE_BEGIN , CURRENT = FILE_CURRENT , END = FILE_END }
	シークのオフセット指定モード [詳解]

公開メンバ関数
virtual bool	CanRead (void) const
	[確認] 読み込み可能か [詳解]

virtual void	Close (void)
	[操作] クローズ [詳解]

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

bool	Copy (LPCTSTR lpszDstFile)
	[複製] コピー [詳解]

LONGLONG	GetLeftoverSize (void) const
	[取得] 残りサイズ取得. [詳解]

virtual LPCTSTR	GetOpenName (void) const
	[取得] オープン名取得 [詳解]

virtual void	GetRaw (size_t size, LPVOID _P) const
	[取得] 取得. [詳解]

virtual LONGLONG	GetSize (void) const
	[取得] サイズ取得 [詳解]

bool	Open (LPCTSTR lpszLzFile, bool boIsShare=true)
	[設定] オープン [詳解]

template<typename T >
const IDeserializer &	operator>> (T &_t) const
	[取得] 取得. [詳解]

virtual size_t	Read (size_t size, LPVOID _P) const
	[取得] 読み込み [詳解]

void	ReadExactly (size_t size, LPVOID _P) const
	[取得] 読み込み. [詳解]

CByteVector	ReadExactly (size_t size=0) const
	[取得] 読み込み [詳解]

size_t	ReadInto (ICollectionT< BYTE > &_out, size_t size=0, size_t oneBlockSize=4096) const
	[取得] 読み込み. [詳解]

CByteVector	ReadInto (size_t size=0) const
	[取得] 読み込み [詳解]

virtual LONGLONG	Seek (LONGLONG llOffset, ESeekMode eSeek=TOP) const
	[操作] シーク. [詳解]

virtual	~CLzFileReader (void)
	デストラクタ [詳解]

静的公開メンバ関数
static CStr	GetExpandedName (LPCTSTR lpszLzFile)
	[取得] 圧縮前名前取得 [詳解]

詳解

LZファイル読み込みクラス

ファイル一つの読み込みをサポートするクラスです。
Microsoft ファイル圧縮ユーティリティ（COMPRESS.EXE）で圧縮されたファイルも読み込めます。

todo:: 圧縮されたファイルの展開動作が未確認です。

必要ファイル: TnbLzFile.h

日付: 07/01/22 新規作成

TnbLzFile.h の 39 行目に定義があります。

列挙型メンバ詳解

◆ ESeekMode

enum ESeekMode

inherited

シークのオフセット指定モード

列挙値
TOP	頭からのオフセット指定
CURRENT	現在位置からのオフセット指定
END	末からのオフセット指定

TnbReader.h の 38 行目に定義があります。

構築子と解体子

◆ CLzFileReader()

CLzFileReader ( void )

コンストラクタ

TnbLzFile.h の 58 行目に定義があります。

◆ ~CLzFileReader()

virtual ~CLzFileReader ( void )

virtual

デストラクタ

TnbLzFile.h の 63 行目に定義があります。

関数詳解

◆ CanRead()

virtual bool CanRead ( void ) const

virtual

[確認] 読み込み可能か

戻り値

true	可能
false	不可能

IReaderを実装しています。

TnbLzFile.h の 136 行目に定義があります。

◆ Close()

virtual void Close ( void )

virtual

[操作] クローズ

覚え書き: 使用していたテンポラリファイルも削除。

IReaderを実装しています。

TnbLzFile.h の 126 行目に定義があります。

◆ Copy()

bool Copy ( LPCTSTR lpszDstFile )

[複製] コピー

覚え書き: コピー元は、 Open() で指定してください。

引数

lpszDstFile 複製先ファイル名。

戻り値

true	成功
false	失敗

TnbLzFile.h の 97 行目に定義があります。

◆ GetExpandedName()

static CStr GetExpandedName ( LPCTSTR lpszLzFile )

static

[取得] 圧縮前名前取得

引数

lpszLzFile Compress.exeで圧縮されたファイル名か、通常のファイル名。

戻り値

Empty文字列	エラー。
文字あり	ファイル名。

TnbLzFile.h の 190 行目に定義があります。

◆ GetLeftoverSize()

LONGLONG GetLeftoverSize ( void ) const

inherited

[取得] 残りサイズ取得.

現在の位置から最後までのサイズを返します。

戻り値

０以上	サイズ
マイナス	取得失敗

TnbReader.h の 95 行目に定義があります。

◆ GetOpenName()

virtual LPCTSTR GetOpenName ( void ) const

virtual

[取得] オープン名取得

戻り値: 名前

IReaderを実装しています。

TnbLzFile.h の 117 行目に定義があります。

◆ GetRaw()

virtual void GetRaw	(	size_t	size,
		LPVOID	_P
	)		const

virtualinherited

[取得] 取得.

指定データを取得します。

引数

[in]	size	取得するデータサイズ(単位BYTE)
[out]	_P	取得するデータ

例外

CTnbException 失敗時は、任意のスローの可能性があります。

IDeserializerを実装しています。

TnbReader.h の 211 行目に定義があります。

◆ GetSize()

virtual LONGLONG GetSize ( void ) const

virtual

[取得] サイズ取得

戻り値

０以上	サイズ
マイナス	取得失敗

IReaderを実装しています。

TnbLzFile.h の 146 行目に定義があります。

◆ Open()

bool Open	(	LPCTSTR	lpszLzFile,
		bool	boIsShare = `true`
	)

[設定] オープン

引数

lpszLzFile	Compress.exeで圧縮されたファイル名か、通常のファイル名。
boIsShare	省略かtrueなら、共有モードでオープンします。

戻り値

true	オープン成功
false	オープン失敗

TnbLzFile.h の 75 行目に定義があります。

◆ operator>>()

const IDeserializer & operator>> ( T & _t ) const

inherited

[取得] 取得.

指定データをデシリアライズして取得します。

引数

[out] _t データ

戻り値: 自分の参照

例外

CNotSupportException	デシリアライズをサポートしていない型が指定されると、スローされます。
CTnbException	失敗時は、任意のスローの可能性があります。

TnbSerializer.h の 277 行目に定義があります。

◆ Read()

virtual size_t Read	(	size_t	size,
		LPVOID	_P
	)		const

virtual

[取得] 読み込み

引数

[in]	size	読み込みサイズ。
[out]	_P	読み込みアドレス。 iSize 分書き込める領域である必要が有ります。

戻り値: 読み込めたサイズ。

例外

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

IReaderを実装しています。

TnbLzFile.h の 174 行目に定義があります。

◆ ReadExactly() [1/2]

void ReadExactly	(	size_t	size,
		LPVOID	_P
	)		const

inherited

[取得] 読み込み.

覚え書き: 指定サイズ読めないとエラーになります。

引数

[in]	size	読み込みサイズ。
[out]	_P	読み込みアドレス。 size 分書き込める領域である必要が有ります。

例外

CReadFailureException	読み込みに失敗すると、スローされます。
CShortOfDataException	指定サイズ読込めないと、スローされます。

TnbReader.h の 114 行目に定義があります。

◆ ReadExactly() [2/2]

CByteVector ReadExactly ( size_t size = 0 ) const

inherited

[取得] 読み込み

覚え書き: 指定サイズ読めないとエラーになります。

引数

size	読み込みサイズ。0ならファイル最後まで読み込む。

戻り値: ByteVector ファイル内容（サイズは読み込めたサイズ）。

例外

CReadFailureException	読み込みに失敗すると、スローされます。
CShortOfDataException	指定サイズ読込めないと、スローされます。

TnbReader.h の 134 行目に定義があります。

◆ ReadInto() [1/2]

size_t ReadInto	(	ICollectionT< BYTE > &	_out,
		size_t	size = `0`,
		size_t	oneBlockSize = `4096`
	)		const

inherited

[取得] 読み込み.

引数

[out]	_out	読込先。クリアせず、後ろに追加します。
	size	読み込みサイズ。省略か0ならファイル最後まで読み込む。
	oneBlockSize	一度に読み込むサイズ。省略なら４K。

戻り値: 読み込めたサイズ。

例外

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

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

◆ ReadInto() [2/2]

CByteVector ReadInto ( size_t size = 0 ) const

inherited

[取得] 読み込み

引数

size	読み込みサイズ。0ならファイル最後まで読み込む。

戻り値: ByteVector ファイル内容（サイズは読み込めたサイズ）。

例外

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

TnbReader.h の 150 行目に定義があります。

◆ Seek()

virtual LONGLONG Seek	(	LONGLONG	llOffset,
		ESeekMode	eSeek = `TOP`
	)		const

virtual

[操作] シーク.

アクセスポインタを移動します。

引数

llOffset	アクセスポインタの移動数。
eSeek	移動開始アクセスポインタ位置。省略すると TOP になります。

戻り値

０以上	シーク成功。数値は、現在のファイルポインタ
マイナス	シーク失敗

IReaderを実装しています。

TnbLzFile.h の 162 行目に定義があります。

公開型

公開メンバ関数

静的公開メンバ関数

詳解

列挙型メンバ詳解

◆ ESeekMode

構築子と解体子

◆ CLzFileReader()

◆ ~CLzFileReader()

関数詳解

◆ CanRead()

◆ Close()

◆ Copy()

◆ GetExpandedName()

◆ GetLeftoverSize()

◆ GetOpenName()

◆ GetRaw()

◆ GetSize()

◆ Open()

◆ operator>>()

◆ Read()

◆ ReadExactly() [1/2]

◆ ReadExactly() [2/2]

◆ ReadInto() [1/2]

◆ ReadInto() [2/2]

◆ Seek()