Gamedev Framework (gf)  0.17.0
A C++14 framework for 2D games
Stream.h
1 /*
2  * Gamedev Framework (gf)
3  * Copyright (C) 2016-2019 Julien Bernard
4  *
5  * This software is provided 'as-is', without any express or implied
6  * warranty. In no event will the authors be held liable for any damages
7  * arising from the use of this software.
8  *
9  * Permission is granted to anyone to use this software for any purpose,
10  * including commercial applications, and to alter it and redistribute it
11  * freely, subject to the following restrictions:
12  *
13  * 1. The origin of this software must not be misrepresented; you must not
14  * claim that you wrote the original software. If you use this software
15  * in a product, an acknowledgment in the product documentation would be
16  * appreciated but is not required.
17  * 2. Altered source versions must be plainly marked as such, and must not be
18  * misrepresented as being the original software.
19  * 3. This notice may not be removed or altered from any source distribution.
20  *
21  * Part of this file comes from SFML, with the same license:
22  * Copyright (C) 2007-2015 Laurent Gomila (laurent@sfml-dev.org)
23  */
24 #ifndef GF_STREAM_H
25 #define GF_STREAM_H
26 
27 #include <cstddef>
28 #include <cstdint>
29 
30 #include "ArrayRef.h"
31 #include "BufferRef.h"
32 #include "Portability.h"
33 
34 namespace gf {
35 #ifndef DOXYGEN_SHOULD_SKIP_THIS
36 inline namespace v1 {
37 #endif
38 
55  class GF_API InputStream {
56  public:
60  InputStream() = default;
61 
65  InputStream(const InputStream&) = delete;
66 
70  InputStream& operator=(const InputStream&) = delete;
71 
75  virtual ~InputStream();
76 
87  virtual std::size_t read(BufferRef<uint8_t> buffer) = 0;
88 
99  std::size_t read(uint8_t& byte) {
100  return read(BufferRef<uint8_t>(&byte, 1));
101  }
102 
108  virtual void seek(std::ptrdiff_t position) = 0;
109 
115  virtual void skip(std::ptrdiff_t position) = 0;
116 
122  virtual bool isFinished() = 0;
123 
124  };
125 
126 
136  class GF_API OutputStream {
137  public:
141  OutputStream() = default;
142 
146  OutputStream(const OutputStream&) = delete;
147 
151  OutputStream& operator=(const OutputStream&) = delete;
152 
156  virtual ~OutputStream();
157 
165  virtual std::size_t write(ArrayRef<uint8_t> buffer) = 0;
166 
174  std::size_t write(uint8_t byte) {
175  return write(ArrayRef<uint8_t>(&byte, 1));
176  }
177 
186  virtual std::size_t getWrittenBytesCount() const = 0;
187  };
188 
189 #ifndef DOXYGEN_SHOULD_SKIP_THIS
190 }
191 #endif
192 }
193 
194 #endif // GF_STREAM_H
constexpr BufferRef< T > buffer(T *data, std::size_t size)
Create a reference to a buffer.
Definition: BufferRef.h:211
Abstract class for custom file output streams.
Definition: Stream.h:136
std::size_t read(uint8_t &byte)
Read a single byte from the stream.
Definition: Stream.h:99
std::size_t write(uint8_t byte)
Write a single byte to the stream.
Definition: Stream.h:174
The namespace for gf classes.
Definition: Action.h:35
Abstract class for custom file input streams.
Definition: Stream.h:55