From ae64b68717c02b902721e861dbf51c5d32950193 Mon Sep 17 00:00:00 2001 From: Tim Schumacher Date: Fri, 20 Jan 2023 14:07:24 +0100 Subject: AK: Deprecate the old `AK::Stream` This also removes a few cases where the respective header wasn't actually required to be included. --- AK/Stream.h | 167 ------------------------------------------------------------ 1 file changed, 167 deletions(-) delete mode 100644 AK/Stream.h (limited to 'AK/Stream.h') diff --git a/AK/Stream.h b/AK/Stream.h deleted file mode 100644 index c4269da90e..0000000000 --- a/AK/Stream.h +++ /dev/null @@ -1,167 +0,0 @@ -/* - * Copyright (c) 2020, the SerenityOS developers. - * - * SPDX-License-Identifier: BSD-2-Clause - */ - -#pragma once - -#include -#include -#include -#include -#include -#include - -namespace AK::Detail { - -class Stream { -public: - virtual ~Stream() { VERIFY(!has_any_error()); } - - virtual bool has_recoverable_error() const { return m_recoverable_error; } - virtual bool has_fatal_error() const { return m_fatal_error; } - virtual bool has_any_error() const { return has_recoverable_error() || has_fatal_error(); } - - virtual bool handle_recoverable_error() - { - VERIFY(!has_fatal_error()); - return exchange(m_recoverable_error, false); - } - virtual bool handle_fatal_error() { return exchange(m_fatal_error, false); } - virtual bool handle_any_error() - { - if (has_any_error()) { - m_recoverable_error = false; - m_fatal_error = false; - - return true; - } - - return false; - } - - ErrorOr try_handle_any_error() - { - if (!handle_any_error()) - return {}; - return Error::from_string_literal("Stream error"); - } - - virtual void set_recoverable_error() const { m_recoverable_error = true; } - virtual void set_fatal_error() const { m_fatal_error = true; } - -private: - mutable bool m_recoverable_error { false }; - mutable bool m_fatal_error { false }; -}; - -} - -namespace AK { - -class InputStream : public virtual Detail::Stream { -public: - // Reads at least one byte unless none are requested or none are available. Does nothing - // and returns zero if there is already an error. - virtual size_t read(Bytes) = 0; - - // If this function returns true, then no more data can be read. If read(Bytes) previously - // returned zero even though bytes were requested, then the inverse is true as well. - virtual bool unreliable_eof() const = 0; - - // Some streams additionally define a method with the signature: - // - // bool eof() const; - // - // This method has the same semantics as unreliable_eof() but returns true if and only if no - // more data can be read. (A failed read is not necessary.) - - virtual bool read_or_error(Bytes) = 0; - virtual bool discard_or_error(size_t count) = 0; -}; - -class OutputStream : public virtual Detail::Stream { -public: - virtual size_t write(ReadonlyBytes) = 0; - virtual bool write_or_error(ReadonlyBytes) = 0; -}; - -class DuplexStream - : public InputStream - , public OutputStream { -}; - -inline InputStream& operator>>(InputStream& stream, Bytes bytes) -{ - stream.read_or_error(bytes); - return stream; -} -inline OutputStream& operator<<(OutputStream& stream, ReadonlyBytes bytes) -{ - stream.write_or_error(bytes); - return stream; -} - -template -InputStream& operator>>(InputStream& stream, LittleEndian& value) -{ - return stream >> Bytes { &value.m_value, sizeof(value.m_value) }; -} -template -OutputStream& operator<<(OutputStream& stream, LittleEndian value) -{ - return stream << ReadonlyBytes { &value.m_value, sizeof(value.m_value) }; -} - -template -InputStream& operator>>(InputStream& stream, BigEndian& value) -{ - return stream >> Bytes { &value.m_value, sizeof(value.m_value) }; -} -template -OutputStream& operator<<(OutputStream& stream, BigEndian value) -{ - return stream << ReadonlyBytes { &value.m_value, sizeof(value.m_value) }; -} - -template -InputStream& operator>>(InputStream& stream, Optional& value) -{ - T temporary; - stream >> temporary; - value = temporary; - return stream; -} - -template -InputStream& operator>>(InputStream& stream, I& value) -{ - stream.read_or_error({ &value, sizeof(value) }); - return stream; -} -template -OutputStream& operator<<(OutputStream& stream, I value) -{ - stream.write_or_error({ &value, sizeof(value) }); - return stream; -} - -#ifndef KERNEL - -template -InputStream& operator>>(InputStream& stream, F& value) -{ - stream.read_or_error({ &value, sizeof(value) }); - return stream; -} -template -OutputStream& operator<<(OutputStream& stream, F value) -{ - stream.write_or_error({ &value, sizeof(value) }); - return stream; -} - -#endif - -} -- cgit v1.2.3