Changeset 677 for trunk/libs/mini-libc/stdio.h

Timestamp:

Nov 20, 2020, 12:18:00 AM (3 years ago)

Author:

alain

Message:

Introduce the fgetc() and fputc() functions.

File:

• trunk/libs/mini-libc/stdio.h (modified) (5 diffs)

trunk/libs/mini-libc/stdio.h

@@ -27 +27 @@
 /*********************************************************************************************
  * This file defines the user level, TXT related <stdio> library.
+ *
  * These functions call the read() and write() functions defined in the <unistd> library
  * to access the TXT terminal.
@@ -38 +39 @@
 /*********************************************************************************************
  * This defines the user level FILE structure.
+ * The open_file_array[] of files is a global variable allocated in the <stdio.c> file
  ********************************************************************************************/
 
@@ -64 +66 @@
 
 /*********************************************************************************************
- * This function writes one single character to the standard "stdout" stream.
+ * This function writes the <c> character to the standard "stdout" stream.
  *********************************************************************************************
  * @ returns written character code if success / returns 0 (EOF) if failure.
@@ -85 +87 @@
  * @ length    : max bumber of characters in target buffer.
  * @ format    : formated string.
- * @ returns number of characters written if success / returns -1 if failure.
+ * @ returns string length (not including NUL) if success / returns -1 if failure.
  ********************************************************************************************/
 int snprintf( char         * string,
               unsigned int   length,
               const char   * format, ... );
+
+
+
+
+
 
 /*********************************************************************************************
@@ -131 +138 @@
 
 /*********************************************************************************************
+ * This function returns one single character from the FILE identified by <stream>.
+ *********************************************************************************************
+ * @ returns read character code if success / returns 0 (EOF) if failure.
+ ********************************************************************************************/
+int fgetc( FILE * stream );
+
+/*********************************************************************************************
+ * This function writes the <c> character to the FILE identified by <stream>.
+ *********************************************************************************************
+ * @ returns written character code if success / returns 0 (EOF) if failure.
+ ********************************************************************************************/
+int fputc( int c, 
+           FILE * stream);
+
+/*********************************************************************************************
  * This function copies a formated string to an output stream identified by the <stream>
  * argument. It can be a  regular file or a character oriented output device.