added functions for reading stdin as complete string and added comments

Author: staxfur

cpp-terminal/input.cpp

@@ -2,6 +2,8 @@
 #include <cpp-terminal/input.hpp>
 #include <thread>
 #include "private/platform.hpp"
+#include <cpp-terminal/base.hpp>
+
 
 int Term::read_key() {
  int key{};
@@ -183,3 +185,22 @@ int Term::read_key0() {
  return c;
  }
 }
+
+// returns the whole input from STDIN as string
+std::string Term::read_stdin() {
+ std::string file;
+ char c;
+ while (true) {
+ c = Private::read_raw_stdin();
+ if (c == 0x04) { // check for end of transmission signal
+ return file;
+ } else {
+ file += c;
+ }
+ }
+}
+std::string Term::read_stdin_alone() {
+ // temporarily enable raw mode
+ Term::Terminal term(false, true, false, false);
+ return Term::read_stdin();
+}

cpp-terminal/input.hpp

@@ -1,4 +1,5 @@
 #pragma once
+#include <string>
 
 namespace Term {
 enum Key {
@@ -40,11 +41,24 @@ enum Key {
 };
 
 // Waits for a key press, translates escape codes
+// if Term:Terminal is not enabling the keyboard it'll loop for infinity
 int read_key();
 
 // If there was a key press, returns the translated key from escape codes,
-// otherwise returns 0. If the escape code is not supported, returns a
+// otherwise returns 0. If the escape code is not supported it returns a
 // negative number.
+// if Term::Terminal is not enabling the keyboard it'll always return 0
 int read_key0();
 
+// returns the stdin as a string
+// waits until the EOT signal is send
+// if Term::Terminal is not enabling the keyboard this function will wait until
+// the user presses CTRL+D (which sends the EOT signal)
+std::string read_stdin();
+
+// returns stdin as a string, Term::Terminal is used to enable input to make the
+// function non-blocking, use Term::read_stdin() when Term::Terminal is already
+// created
+std::string read_stdin_alone();
+
 } // namespace Term