include/io/orxFile.h

Go to the documentation of this file.

/* Orx - Portable Game Engine
 *
 * Copyright (c) 2008-2011 Orx-Project
 *
 * This software is provided 'as-is', without any express or implied
 * warranty. In no event will the authors be held liable for any damages
 * arising from the use of this software.
 *
 * Permission is granted to anyone to use this software for any purpose,
 * including commercial applications, and to alter it and redistribute it
 * freely, subject to the following restrictions:
 *
 *    1. The origin of this software must not be misrepresented; you must not
 *    claim that you wrote the original software. If you use this software
 *    in a product, an acknowledgment in the product documentation would be
 *    appreciated but is not required.
 *
 *    2. Altered source versions must be plainly marked as such, and must not be
 *    misrepresented as being the original software.
 *
 *    3. This notice may not be removed or altered from any source
 *    distribution.
 */

#ifndef _orxFILE_H_
#define _orxFILE_H_
 
#include "orxInclude.h"


#define orxFILE_KU32_FLAG_INFO_NORMAL       0x00000001  
#define orxFILE_KU32_FLAG_INFO_RDONLY       0x00000002  
#define orxFILE_KU32_FLAG_INFO_HIDDEN       0x00000004  
#define orxFILE_KU32_FLAG_INFO_DIR          0x00000008  
#define orxFILE_KU32_FLAG_OPEN_READ         0x00000001  
#define orxFILE_KU32_FLAG_OPEN_WRITE        0x00000002  
#define orxFILE_KU32_FLAG_OPEN_APPEND       0x00000004  
#define orxFILE_KU32_FLAG_OPEN_BINARY       0x00000008  
typedef struct __orxFILE_INFO_t
{
  orxU32    u32Flags;                                   
  orxU32    u32TimeStamp;                               
  orxU32    u32Size;                                    
  orxHANDLE hInternal;                                  
  orxCHAR   zName[256];                                 
  orxCHAR   zPattern[256];                              
  orxCHAR   zPath[1024];                                
  orxCHAR   zFullName[1280];                            
} orxFILE_INFO;


typedef struct __orxFILE_t                  orxFILE;


extern orxDLLAPI void orxFASTCALL           orxFile_Setup();

extern orxDLLAPI orxSTATUS orxFASTCALL      orxFile_Init();

extern orxDLLAPI void orxFASTCALL           orxFile_Exit();

extern orxDLLAPI orxBOOL orxFASTCALL        orxFile_Exists(const orxSTRING _zFileName);

extern orxDLLAPI orxBOOL orxFASTCALL        orxFile_FindFirst(const orxSTRING _zSearchPattern, orxFILE_INFO *_pstFileInfo);

extern orxDLLAPI orxBOOL orxFASTCALL        orxFile_FindNext(orxFILE_INFO *_pstFileInfo);

extern orxDLLAPI void orxFASTCALL           orxFile_FindClose(orxFILE_INFO *_pstFileInfo);

extern orxDLLAPI orxSTATUS orxFASTCALL      orxFile_GetInfo(const orxSTRING _zFileName, orxFILE_INFO *_pstFileInfo);

extern orxDLLAPI orxFILE *orxFASTCALL       orxFile_Open(const orxSTRING _zFileName, orxU32 _u32OpenFlags);

extern orxDLLAPI orxU32 orxFASTCALL         orxFile_Read(void *_pReadData, orxU32 _u32ElemSize, orxU32 _u32NbElem, orxFILE *_pstFile);

extern orxDLLAPI orxU32 orxFASTCALL         orxFile_Write(void *_pDataToWrite, orxU32 _u32ElemSize, orxU32 _u32NbElem, orxFILE *_pstFile);

extern orxDLLAPI orxSTATUS orxFASTCALL      orxFile_Seek(orxFILE *_pstFile, orxS32 _s32Position);

extern orxDLLAPI orxS32 orxFASTCALL         orxFile_Tell(const orxFILE *_pstFile);

extern orxDLLAPI orxS32 orxFASTCALL         orxFile_GetSize(const orxFILE *_pstFile);

extern orxDLLAPI orxS32 orxCDECL            orxFile_Print(orxFILE *_pstFile, orxSTRING _zString, ...);

extern orxDLLAPI orxSTATUS orxFASTCALL      orxFile_Close(orxFILE *_pstFile);

#endif /* _orxFILE_H_ */