XBufferIO

Inherited from NULL

Inherited by NULL

Friend class NULL

Description

XBufferIO是为文件IO构建的工具类，它从内存中开辟一块内存专门用于缓冲写入文件或从文件中读取的内容，在缓冲区满的时候一次性写出或读入新的文件内容，以提高文件IO的速度，从而有效避免频繁的硬盘IO操作所导致的性能瓶颈。

Members

• Path m_strPath
• DBVersion m_Version
• void* m_pFp
• int64 m_liSize
• int m_iOpenMode
• char * m_pBuf
• int m_iTxtEncode
• int m_iBufSize
• int m_iBufMode
• char m_cKeyPrefix
• int m_iEncode
• char * g_curBufPos
• size_t g_iBufFreeSize
• int64 m_DoneSize

Public interface

• XBufferIO(XBufferIOType type,const char * path = 0,int buf_size = MEG)
• ~XBufferIO()
• void * getFileHandle()
• bool open(IOFlag f)
• bool isEnd()
• void close()
• TypeID getEncode()
• XBufferIOType type()
• int64 size()
• void setPath(const char * path)
• int64 getCurPos()
• void setTotalSize(int64 t_size)
• void setCurPos(int64 pos, bool bRead = false)
• void setKeywordPrefix(char c)
• bool pumpBuffer(bool bReverse = false)
• void jumpBufferEnd()
• bool backward(int size)
• bool forward(int size)
• void resetBuffer()
• void flushBuffer()
• void setBufferSize(int size)
• void showProgress()
• void writeChar(char c)
• char readChar()
• const DBVersion & getVersion()
• void setVersion(int major, int minor, int sub, int build)

---

Path m_strPath

被处理文件的路径

DBVersion m_Version

被处理文件的版本号

void* m_pFp

被处理文件的句柄

int64 m_liSize

读入文件的大小

int m_iOpenMode

文件打开的模式，分为二进制读取、二进制写出、文本读取、文本写出四种模式。

char * m_pBuf

内容缓冲区地址

int m_iBufSize

内容缓冲区大小

int m_iBufMode

缓冲区模式，二进制或者文本

char m_cKeyPrefix

文件模式下，关键字的前导字符

int m_iEncode

文本模式下的文本编码

char * g_curBufPos

在缓冲区中的文件内容的当前访问地址

size_t g_iBufFreeSize

缓冲区剩余空间大小

int64 m_DoneSize

已经处理完的文件内容总大小（不包含缓冲区中的内容）

---

XBufferIO(XBufferIOType type,const char * path = 0,int buf_size = MEG)

• function: 构造函数
• parameters:
  1. [i]XBufferIOType type: 缓冲区类型
  2. [i]const char * path = 0: 文件路径
  3. [i]int buf_size = MEG: 缓冲区大小
• return value: 无

~XBufferIO()

• function: 析构函数
• parameters: NULL
• return value: 无

void * getFileHandle()

• function: 获取文件句柄
• parameters: NULL
• return value: 文件句柄

bool open(IOFlag f)

• function: 打开文件
• parameters:
  1. [i]IOFlag f: 打开模式
• return value: 成功打开返回true，否则返回false

bool isEnd()

• function: 文件是否已经到达末尾
• parameters: NULL
• return value: 如果文件已经达到末尾返回true，否则返回false

void close()

• function: 关闭文件
• parameters: NULL
• return value: 无

TypeID getEncode()

• function: 获取文件的编码
• parameters: NULL
• return value: 编码ID

XBufferIOType type()

• function: 获取文件的缓冲类型
• parameters: NULL
• return value: 缓冲类型，二进制或文本

int64 size()

• function: 获取文件的大小
• parameters: NULL
• return value: 文件的大小

void setPath(const char * path)

• function: 设置文件路径
• parameters:
  1. [i]const char * path: 文件路径
• return value: 无

int64 getCurPos()

• function: 获取文件的当前访问位置（从文件起始开始计算）
• parameters: NULL
• return value: 文件的当前访问位置

void setTotalSize(int64 t_size)

• function: 设置文件的总大小
• parameters:
  1. [i]int64 t_size: 文件的总大小
• return value: 无

void setCurPos(int64 pos, bool bRead = false)

• function: 设置文件的当前访问位置，如果是读取模式，自动从当前位置读入后续内容到缓冲区中
• parameters:
  1. [i]int64 pos: 文件的当前访问位置
  2. [i] bool bRead = false: 是否读取模式
• return value: 无

void setKeywordPrefix(char c)

• function: 设置关键字的前导字符
• parameters:
  1. [i]char c: 关键字的前导字符
• return value: 无

bool pumpBuffer(bool bReverse = false)

• function: 读取文件内容到缓冲区中
• parameters:
  1. [i]bool bReverse = false: 是否逆向读取，默认顺序向前读取
• return value: 成功读取返回true，如已到文件末尾返回false

void jumpBufferEnd()

• function: 跳转到缓冲区末尾
• parameters: NULL
• return value: 无

bool backward(int size)

• function: 将当前访问位置向后（文件起始位置方向）移动size个字节
• parameters:
  1. [i]int size: 移动的字节数
• return value: 如已经到达文件起始位置返回false，否则返回true

bool forward(int size)

• function: 将当前访问位置向前（文件末尾方向）移动size个字节
• parameters:
  1. [i]int size: 移动的字节数
• return value: 如已经到达文件末尾返回false，否则返回true

void resetBuffer()

• function: 重置缓冲区
• parameters: NULL
• return value: 无

void flushBuffer()

• function: 将缓冲区所有内容写入到文件中并清空缓冲区
• parameters: NULL
• return value: 无

void setBufferSize(int size)

• function: 设置缓冲区大小
• parameters:
  1. [i]int size: 缓冲区大小
• return value: 无

void showProgress()

• function: 通过发送PUBLISH_PROGRESS事件显示文件处理进度
• parameters: NULL
• return value: 无

void writeChar(char c)

• function: 写出一个字符
• parameters:
  1. [i]char c: 字符
• return value: 无

char readChar()

• function: 读入一个字符
• parameters: NULL
• return value: 读入字符

const DBVersion & getVersion()

• function: 获取文件版本信息
• parameters: NULL
• return value: 文件版本信息

void setVersion(int major, int minor, int sub, int build)

• function: 设置文件版本信息
• parameters:
  1. [i]int major: 主版本号
  2. [i] int minor: 小版本号
  3. [i] int sub: 次版本号
  4. [i] int build: 构建序号
• return value: 无