Handout

kernel/device/textstream.h

@@ -0,0 +1,45 @@
+/*! \file
+ *  \brief \ref TextStream outputs text onto the screen in \ref CGA
+ */
+
+/*! \defgroup io I/O subsystem
+ *  \brief The input/output subsystem
+ */
+
+#pragma once
+#include "../arch/textwindow.h"
+#include "../object/outputstream.h"
+#include "../types.h"
+
+/*! \brief  Output text (form different data type sources) on screen in text
+ * mode
+ *  \ingroup io
+ *
+ * Allows the output of different data types as strings on the \ref CGA
+ * screen of a PC.
+ * To achieve this, \ref TextStream is derived from both \ref OutputStream and
+ * \ref TextWindow and only implements the method \ref TextStream::flush().
+ * Further formatting or special effects are implemented in \ref TextWindow.
+ */
+class TextStream : public OutputStream, public TextWindow {
+	// Prevent copies and assignments
+	TextStream(const TextStream&) = delete;
+	TextStream& operator=(const TextStream&) = delete;
+
+   public:
+	/// \copydoc
+	/// TextWindow::TextWindow(unsigned,unsigned,unsigned,unsigned,bool)
+	TextStream(unsigned from_col, unsigned to_col, unsigned from_row,
+			   unsigned to_row, bool use_cursor = false);
+
+	/*! \brief Output the buffer contents of the base class \ref Stringbuffer
+	 *
+	 * The method is automatically called when the buffer is full,
+	 * but can also be called explicitly to force output of the current buffer.
+	 *
+	 *
+	 */
+	// NOTE: We can only add the `override` once we inherit from `TextWindow`
+	// which is part of the solution.
+	void flush() override;
+};