new getc function in input

Author: dreamer-coding

code/logic/fossil/io/input.h

@@ -22,6 +22,14 @@
 extern "C" {
 #endif
 
+/**
+ * Reads a single character from the input stream.
+ * 
+ * @param input_stream  Pointer to the input stream to read from.
+ * @return              The character read as an unsigned char cast to an int, or EOF on end-of-file or error.
+ */
+int fossil_io_getc(FILE *input_stream);
+
 /**
  * Reads a line from the input stream and stores it into the buffer pointed to by 'buf'.
  * 
@@ -171,6 +179,16 @@ namespace fossil {
          */
         class Input {
         public:
+            /**
+             * Reads a single character from the input stream.
+             * 
+             * @param input_stream  Pointer to the input stream to read from.
+             * @return              The character read as an unsigned char cast to an int, or EOF on end-of-file or error.
+             */
+            static int getc(FILE *input_stream) {
+                return fossil_io_getc(input_stream);
+            }
+
             /**
              * Reads a line from the input stream and stores it into the buffer pointed to by 'buf'.
              *

code/logic/input.c

@@ -88,6 +88,20 @@ void fossil_io_show_progress(int progress) {
     fflush(stdout);
 }
 
+int fossil_io_getc(FILE *input_stream) {
+    if (input_stream == NULL) {
+        fprintf(stderr, "Error: Invalid input stream.\n");
+        return EOF;
+    }
+    
+    int c = fgetc(input_stream);
+    if (c == EOF && ferror(input_stream)) {
+        fprintf(stderr, "Error: Failed to read from input stream.\n");
+    }
+    
+    return c;
+}
+
 // Function to get a sanitized line of input from a provided stream (or stdin by default)
 char *fossil_io_gets_from_stream(char *buf, size_t size, FILE *input_stream) {
     if (buf == NULL || size == 0 || input_stream == NULL) {