nearby: snapshot as of cl/296436629

Signed-off-by: Alexey Polyudov <apolyudov@google.com>
Change-Id: I2cf5bf225b76f4c1541954651f3a7544a14e0cec

cpp/platform/api/input_stream.h

@@ -0,0 +1,31 @@
+#ifndef PLATFORM_API_INPUT_STREAM_H_
+#define PLATFORM_API_INPUT_STREAM_H_
+
+#include <cstdint>
+
+#include "platform/byte_array.h"
+#include "platform/exception.h"
+#include "platform/ptr.h"
+
+namespace location {
+namespace nearby {
+
+// An InputStream represents an input stream of bytes.
+//
+// https://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html
+class InputStream {
+ public:
+  virtual ~InputStream() {}
+
+  // The returned ConstPtr will be owned (and destroyed) by the caller.
+  virtual ExceptionOr<ConstPtr<ByteArray> > read() = 0;  // throws Exception::IO
+  // The returned ConstPtr will be owned (and destroyed) by the caller.
+  virtual ExceptionOr<ConstPtr<ByteArray> > read(
+      std::int64_t size) = 0;            // throws Exception::IO
+  virtual Exception::Value close() = 0;  // throws Exception::IO
+};
+
+}  // namespace nearby
+}  // namespace location
+
+#endif  // PLATFORM_API_INPUT_STREAM_H_