2014-02-10 02:10:30 +01:00
/*************************************************************************/
/* stream_peer.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
/*************************************************************************/
2021-01-01 20:13:46 +01:00
/* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur. */
/* Copyright (c) 2014-2021 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. */
/*************************************************************************/
2018-01-05 00:50:27 +01:00
2014-02-10 02:10:30 +01:00
# ifndef STREAM_PEER_H
# define STREAM_PEER_H
2020-11-07 23:33:38 +01:00
# include "core/object/reference.h"
2014-02-10 02:10:30 +01:00
class StreamPeer : public Reference {
2017-03-05 16:44:50 +01:00
GDCLASS ( StreamPeer , Reference ) ;
2014-02-10 02:10:30 +01:00
OBJ_CATEGORY ( " Networking " ) ;
2017-03-05 16:44:50 +01:00
2014-02-10 02:10:30 +01:00
protected :
static void _bind_methods ( ) ;
//bind helpers
2020-02-17 22:06:54 +01:00
Error _put_data ( const Vector < uint8_t > & p_data ) ;
Array _put_partial_data ( const Vector < uint8_t > & p_data ) ;
2014-02-10 02:10:30 +01:00
Array _get_data ( int p_bytes ) ;
Array _get_partial_data ( int p_bytes ) ;
2020-05-12 17:01:17 +02:00
bool big_endian = false ;
2015-12-13 16:53:29 +01:00
2014-02-10 02:10:30 +01:00
public :
2017-03-05 16:44:50 +01:00
virtual Error put_data ( const uint8_t * p_data , int p_bytes ) = 0 ; ///< put a whole chunk of data, blocking until it sent
virtual Error put_partial_data ( const uint8_t * p_data , int p_bytes , int & r_sent ) = 0 ; ///< put as much data as possible, without blocking.
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
virtual Error get_data ( uint8_t * p_buffer , int p_bytes ) = 0 ; ///< read p_bytes of data, if p_bytes > available, it will block
virtual Error get_partial_data ( uint8_t * p_buffer , int p_bytes , int & r_received ) = 0 ; ///< read as much data as p_bytes into buffer, if less was read, return in r_received
2014-02-10 02:10:30 +01:00
2017-03-05 16:44:50 +01:00
virtual int get_available_bytes ( ) const = 0 ;
2015-12-13 16:53:29 +01:00
void set_big_endian ( bool p_enable ) ;
bool is_big_endian_enabled ( ) const ;
void put_8 ( int8_t p_val ) ;
void put_u8 ( uint8_t p_val ) ;
void put_16 ( int16_t p_val ) ;
void put_u16 ( uint16_t p_val ) ;
void put_32 ( int32_t p_val ) ;
void put_u32 ( uint32_t p_val ) ;
void put_64 ( int64_t p_val ) ;
void put_u64 ( uint64_t p_val ) ;
void put_float ( float p_val ) ;
void put_double ( double p_val ) ;
2018-09-22 05:08:07 +02:00
void put_string ( const String & p_string ) ;
2017-03-05 16:44:50 +01:00
void put_utf8_string ( const String & p_string ) ;
2019-03-26 16:52:42 +01:00
void put_var ( const Variant & p_variant , bool p_full_objects = false ) ;
2015-12-13 16:53:29 +01:00
uint8_t get_u8 ( ) ;
int8_t get_8 ( ) ;
uint16_t get_u16 ( ) ;
int16_t get_16 ( ) ;
uint32_t get_u32 ( ) ;
int32_t get_32 ( ) ;
uint64_t get_u64 ( ) ;
int64_t get_64 ( ) ;
float get_float ( ) ;
2018-01-30 00:45:46 +01:00
double get_double ( ) ;
2018-09-22 05:08:07 +02:00
String get_string ( int p_bytes = - 1 ) ;
String get_utf8_string ( int p_bytes = - 1 ) ;
2019-03-26 16:52:42 +01:00
Variant get_var ( bool p_allow_objects = false ) ;
2015-12-13 16:53:29 +01:00
2020-05-12 17:01:17 +02:00
StreamPeer ( ) { }
2014-02-10 02:10:30 +01:00
} ;
2016-08-22 06:14:08 +02:00
class StreamPeerBuffer : public StreamPeer {
2017-03-05 16:44:50 +01:00
GDCLASS ( StreamPeerBuffer , StreamPeer ) ;
2016-08-22 06:14:08 +02:00
2020-02-17 22:06:54 +01:00
Vector < uint8_t > data ;
2020-05-12 17:01:17 +02:00
int pointer = 0 ;
2016-08-22 06:14:08 +02:00
2017-03-05 16:44:50 +01:00
protected :
2016-08-22 06:14:08 +02:00
static void _bind_methods ( ) ;
2017-03-05 16:44:50 +01:00
2016-08-22 06:14:08 +02:00
public :
2020-07-10 12:34:39 +02:00
Error put_data ( const uint8_t * p_data , int p_bytes ) override ;
Error put_partial_data ( const uint8_t * p_data , int p_bytes , int & r_sent ) override ;
2016-08-22 06:14:08 +02:00
2020-07-10 12:34:39 +02:00
Error get_data ( uint8_t * p_buffer , int p_bytes ) override ;
Error get_partial_data ( uint8_t * p_buffer , int p_bytes , int & r_received ) override ;
2016-08-22 06:14:08 +02:00
2020-07-10 12:34:39 +02:00
virtual int get_available_bytes ( ) const override ;
2016-08-22 06:14:08 +02:00
void seek ( int p_pos ) ;
int get_size ( ) const ;
2017-09-10 15:37:49 +02:00
int get_position ( ) const ;
2016-08-22 06:14:08 +02:00
void resize ( int p_size ) ;
2020-02-17 22:06:54 +01:00
void set_data_array ( const Vector < uint8_t > & p_data ) ;
Vector < uint8_t > get_data_array ( ) const ;
2016-08-22 06:14:08 +02:00
void clear ( ) ;
Ref < StreamPeerBuffer > duplicate ( ) const ;
2020-05-12 17:01:17 +02:00
StreamPeerBuffer ( ) { }
2016-08-22 06:14:08 +02:00
} ;
2014-02-10 02:10:30 +01:00
# endif // STREAM_PEER_H