2014-02-10 02:10:30 +01:00
/*************************************************************************/
/* file_access.h */
/*************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
2017-08-27 14:16:55 +02:00
/* https://godotengine.org */
2014-02-10 02:10:30 +01:00
/*************************************************************************/
2017-01-01 22:01:57 +01:00
/* Copyright (c) 2007-2017 Juan Linietsky, Ariel Manzur. */
2017-04-08 00:11:42 +02:00
/* Copyright (c) 2014-2017 Godot Engine contributors (cf. AUTHORS.md) */
2014-02-10 02:10:30 +01:00
/* */
/* Permission is hereby granted, free of charge, to any person obtaining */
/* a copy of this software and associated documentation files (the */
/* "Software"), to deal in the Software without restriction, including */
/* without limitation the rights to use, copy, modify, merge, publish, */
/* distribute, sublicense, and/or sell copies of the Software, and to */
/* permit persons to whom the Software is furnished to do so, subject to */
/* the following conditions: */
/* */
/* The above copyright notice and this permission notice shall be */
/* included in all copies or substantial portions of the Software. */
/* */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
/*************************************************************************/
# ifndef FILE_ACCESS_H
# define FILE_ACCESS_H
2017-03-05 16:44:50 +01:00
# include "math_defs.h"
# include "os/memory.h"
2014-02-10 02:10:30 +01:00
# include "typedefs.h"
# include "ustring.h"
/**
* Multi - Platform abstraction for accessing to files .
*/
class FileAccess {
public :
enum AccessType {
ACCESS_RESOURCES ,
ACCESS_USERDATA ,
ACCESS_FILESYSTEM ,
ACCESS_MAX
} ;
2017-03-05 16:44:50 +01:00
typedef void ( * FileCloseFailNotify ) ( const String & ) ;
2016-06-13 15:10:50 +02:00
2017-03-05 16:44:50 +01:00
typedef FileAccess * ( * CreateFunc ) ( ) ;
2014-02-10 02:10:30 +01:00
bool endian_swap ;
bool real_is_double ;
2017-03-05 16:44:50 +01:00
protected :
String fix_path ( const String & p_path ) const ;
virtual Error _open ( const String & p_path , int p_mode_flags ) = 0 ; ///< open a file
virtual uint64_t _get_modified_time ( const String & p_file ) = 0 ;
2014-02-10 02:10:30 +01:00
2016-06-13 15:10:50 +02:00
static FileCloseFailNotify close_fail_notify ;
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
private :
2014-02-10 02:10:30 +01:00
static bool backup_save ;
AccessType _access_type ;
static CreateFunc create_func [ ACCESS_MAX ] ; /** default file access creation function for a platform */
2017-03-05 16:44:50 +01:00
template < class T >
static FileAccess * _create_builtin ( ) {
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
return memnew ( T ) ;
2014-02-10 02:10:30 +01:00
}
public :
2017-03-05 16:44:50 +01:00
static void set_file_close_fail_notify_callback ( FileCloseFailNotify p_cbk ) { close_fail_notify = p_cbk ; }
2016-06-13 15:10:50 +02:00
2014-02-10 02:10:30 +01:00
virtual void _set_access_type ( AccessType p_access ) ;
2017-03-05 16:44:50 +01:00
enum ModeFlags {
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
READ = 1 ,
WRITE = 2 ,
READ_WRITE = 3 ,
WRITE_READ = 7 ,
2014-02-10 02:10:30 +01:00
} ;
2017-03-05 16:44:50 +01:00
virtual void close ( ) = 0 ; ///< close a file
virtual bool is_open ( ) const = 0 ; ///< true when file is open
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
virtual void seek ( size_t p_position ) = 0 ; ///< seek to a given position
virtual void seek_end ( int64_t p_position = 0 ) = 0 ; ///< seek from the end of file
virtual size_t get_pos ( ) const = 0 ; ///< get position in the file
virtual size_t get_len ( ) const = 0 ; ///< get size of the file
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
virtual bool eof_reached ( ) const = 0 ; ///< reading passed EOF
2016-03-09 00:00:52 +01:00
2017-03-05 16:44:50 +01:00
virtual uint8_t get_8 ( ) const = 0 ; ///< get a byte
2016-03-09 00:00:52 +01:00
virtual uint16_t get_16 ( ) const ; ///< get 16 bits uint
virtual uint32_t get_32 ( ) const ; ///< get 32 bits uint
virtual uint64_t get_64 ( ) const ; ///< get 64 bits uint
2014-02-10 02:10:30 +01:00
virtual float get_float ( ) const ;
virtual double get_double ( ) const ;
virtual real_t get_real ( ) const ;
2017-03-05 16:44:50 +01:00
virtual int get_buffer ( uint8_t * p_dst , int p_length ) const ; ///< get an array of bytes
2014-02-10 02:10:30 +01:00
virtual String get_line ( ) const ;
2017-05-29 02:46:48 +02:00
virtual String get_token ( ) const ;
2017-03-05 16:44:50 +01:00
virtual Vector < String > get_csv_line ( String delim = " , " ) const ;
2016-03-09 00:00:52 +01:00
2014-02-10 02:10:30 +01:00
/**< use this for files WRITTEN in _big_ endian machines (ie, amiga/mac)
* It ' s not about the current CPU type but file formats .
* this flags get reset to false ( little endian ) on each open
*/
2016-03-09 00:00:52 +01:00
2017-03-05 16:44:50 +01:00
virtual void set_endian_swap ( bool p_swap ) { endian_swap = p_swap ; }
2014-02-10 02:10:30 +01:00
inline bool get_endian_swap ( ) const { return endian_swap ; }
2017-03-05 16:44:50 +01:00
virtual Error get_error ( ) const = 0 ; ///< get last error
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
virtual void store_8 ( uint8_t p_dest ) = 0 ; ///< store a byte
2016-03-09 00:00:52 +01:00
virtual void store_16 ( uint16_t p_dest ) ; ///< store 16 bits uint
virtual void store_32 ( uint32_t p_dest ) ; ///< store 32 bits uint
virtual void store_64 ( uint64_t p_dest ) ; ///< store 64 bits uint
2014-02-10 02:10:30 +01:00
virtual void store_float ( float p_dest ) ;
virtual void store_double ( double p_dest ) ;
virtual void store_real ( real_t p_real ) ;
2017-03-05 16:44:50 +01:00
virtual void store_string ( const String & p_string ) ;
2017-08-11 21:10:05 +02:00
virtual void store_line ( const String & p_line ) ;
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
virtual void store_pascal_string ( const String & p_string ) ;
2014-03-14 02:57:24 +01:00
virtual String get_pascal_string ( ) ;
2017-03-05 16:44:50 +01:00
virtual void store_buffer ( const uint8_t * p_src , int p_length ) ; ///< store an array of bytes
2016-03-09 00:00:52 +01:00
2017-03-05 16:44:50 +01:00
virtual bool file_exists ( const String & p_name ) = 0 ; ///< return true if a file exists
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
virtual Error reopen ( const String & p_path , int p_mode_flags ) ; ///< does not change the AccessType
2014-02-10 02:10:30 +01:00
2017-09-17 19:40:58 +02:00
virtual Error _chmod ( const String & p_path , int p_mod ) { }
2014-02-10 02:10:30 +01:00
static FileAccess * create ( AccessType p_access ) ; /// Create a file access (for the current platform) this is the only portable way of accessing files.
2017-03-05 16:44:50 +01:00
static FileAccess * create_for_path ( const String & p_path ) ;
static FileAccess * open ( const String & p_path , int p_mode_flags , Error * r_error = NULL ) ; /// Create a file access (for the current platform) this is the only portable way of accessing files.
2014-02-10 02:10:30 +01:00
static CreateFunc get_create_func ( AccessType p_access ) ;
2017-03-05 16:44:50 +01:00
static bool exists ( const String & p_name ) ; ///< return true if a file exists
static uint64_t get_modified_time ( const String & p_file ) ;
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
static void set_backup_save ( bool p_enable ) { backup_save = p_enable ; } ;
2014-02-10 02:10:30 +01:00
static bool is_backup_save_enabled ( ) { return backup_save ; } ;
2017-03-05 16:44:50 +01:00
static String get_md5 ( const String & p_file ) ;
static String get_sha256 ( const String & p_file ) ;
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
static Vector < uint8_t > get_file_as_array ( const String & p_path ) ;
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
template < class T >
2014-02-10 02:10:30 +01:00
static void make_default ( AccessType p_access ) {
2017-03-05 16:44:50 +01:00
create_func [ p_access ] = _create_builtin < T > ;
2014-02-10 02:10:30 +01:00
}
FileAccess ( ) ;
2017-03-05 16:44:50 +01:00
virtual ~ FileAccess ( ) { }
2014-02-10 02:10:30 +01:00
} ;
struct FileAccessRef {
2017-03-05 16:44:50 +01:00
_FORCE_INLINE_ FileAccess * operator - > ( ) {
2014-02-10 02:10:30 +01:00
return f ;
}
2017-03-05 16:44:50 +01:00
operator bool ( ) const { return f ! = NULL ; }
2014-02-10 02:10:30 +01:00
FileAccess * f ;
2017-09-13 09:13:23 +02:00
operator FileAccess * ( ) { return f ; }
2014-02-10 02:10:30 +01:00
FileAccessRef ( FileAccess * fa ) { f = fa ; }
2017-03-05 16:44:50 +01:00
~ FileAccessRef ( ) {
if ( f ) memdelete ( f ) ;
}
2014-02-10 02:10:30 +01:00
} ;
# endif