/*############################################################################# * 文件名：file.h * 功能：  實現了指紋相關文件的操作 * modified by  PRTsinghua@hotmail.com#############################################################################*/#if !defined FVS__FILE_HEADER__INCLUDED__#define FVS__FILE_HEADER__INCLUDED__/* 基本類型的定義文件 */#include "fvstypes.h"/* 對象的這些接口實現是私有的，不必為用戶所知。使用這里提供的函數操作文件 */typedef FvsHandle_t FvsFile_t;/******************************************************************************  * 功能：創建一個新的文件對象，只有在創建之后，文件對象才能為其它函數所用。  * 參數：無  * 返回：若創建失敗，返回NULL；否則返回新的對象句柄。******************************************************************************/FvsFile_t FileCreate(void);/******************************************************************************  * 功能：破壞一個已經存在的文件對象，在毀壞之后，文件對象不能再為其它函數所用。  * 參數：file  即將刪除的文件對象指針  * 返回：無返回值******************************************************************************/void FileDestroy(FvsFile_t file);/* 文件打開函數所用的選項 */typedef enum FvsFileOptions_t{    /* 讀打開 */    FvsFileRead   = (1<<1),    /* 寫打開 */    FvsFileWrite  = (1<<2),    /* 創建打開 */    FvsFileCreate = (1<<3)} FvsFileOptions_t;/******************************************************************************  * 功能：打開一個新的文件。一個文件可以讀打開，寫打開，或者被創建。  * 參數：file    文件對象  *       name    待打開文件的名字  *       flags   打開標志  * 返回：錯誤編號******************************************************************************/FvsError_t FileOpen(FvsFile_t file, const FvsString_t name, 						const FvsFileOptions_t flags);/******************************************************************************  * 功能：關閉一個文件對象，文件關閉之后，文件不再可用。  * 參數：file    文件對象  * 返回：錯誤編號******************************************************************************/FvsError_t FileClose(FvsFile_t file);/******************************************************************************  * 功能：從文件中讀數據，所讀取的字節數由length決定。讀取的數據保存于指針data。  * 參數：file    文件對象  *       data    指向存儲數據的數組  *       length  要讀取的字節數  * 返回：實際讀取的字節數******************************************************************************/FvsUint_t FileRead(FvsFile_t file, FvsPointer_t data, 						const FvsUint_t length);/******************************************************************************  * 功能：往文件中寫數據，所寫的字節數由length決定。要寫入的數據保存于指針data。  * 參數：file    文件對象  *       data    指向存儲數據的數組  *       length  要寫入的字節數  * 返回：實際寫入的字節數******************************************************************************/FvsUint_t FileWrite(FvsFile_t file, const FvsPointer_t data, 						const FvsUint_t length);/******************************************************************************  * 功能：從文件中得到一個字節  * 參數：file    文件對象  * 返回：讀取的字節******************************************************************************/FvsByte_t FileGetByte(FvsFile_t file);/******************************************************************************  * 功能：從文件中讀取一個字  * 參數：file    文件對象  * 返回：讀取的字******************************************************************************/FvsWord_t FileGetWord(FvsFile_t file);/******************************************************************************  * 功能：測試一個文件是否打開  * 參數：file    文件對象  * 返回：文件打開，則返回true；否則返回false******************************************************************************/FvsBool_t FileIsOpen(const FvsFile_t file);/******************************************************************************  * 功能：測試是否到了文件結尾  * 參數：file    文件對象  * 返回：到了結尾，返回true；否則返回false******************************************************************************/FvsBool_t FileIsAtEOF(const FvsFile_t file);/******************************************************************************  * 功能：提交對文件所作的更改  * 參數：file    文件對象  * 返回：錯誤編號******************************************************************************/FvsError_t FileCommit(FvsFile_t file);/******************************************************************************  * 功能：跳到文件的開頭  * 參數：file    文件對象  * 返回：錯誤編號******************************************************************************/FvsError_t FileSeekToBegin(FvsFile_t file);/******************************************************************************  * 功能：跳到文件的結尾  * 參數：file    文件對象  * 返回：錯誤編號******************************************************************************/FvsError_t FileSeekToEnd(FvsFile_t file);/******************************************************************************  * 功能：跳到文件的指定位置  * 參數：file     文件對象  *       position 指定的文件位置  * 返回：錯誤編號******************************************************************************/FvsError_t FileSeek(FvsFile_t file, const FvsUint_t position);/******************************************************************************  * 功能：得到當前的文件指針位置  * 參數：file    文件對象  * 返回：當前的指針位置******************************************************************************/FvsUint_t FileGetPosition(FvsFile_t file);#endif /* FVS__FILE_HEADER__INCLUDED__ */