Changeset 771 for soft/giet_vm/giet_libs/stdlib.h

Timestamp:

Feb 3, 2016, 9:57:40 AM (8 years ago)

Author:

alain

Message:

Introducing the generic xprintf() function, called by the various *printf() functions.

File:

• soft/giet_vm/giet_libs/stdlib.h (modified) (2 diffs)

soft/giet_vm/giet_libs/stdlib.h

@@ -5 +5 @@
 // Copyright (c) UPMC-LIP6
 ///////////////////////////////////////////////////////////////////////////////////
+
+#include <stdarg.h>
 
 #ifndef _STDLIB_H
@@ -60 +62 @@
               char* source );
 
+///////////////////////////////////////////////////////////////////////////////////////
+// This user function build a formated string.
+// It analyse the <format> argument and uses the other arguments to returns 
+// a formated string in the <string> buffer. 
+// The <length> define the destination buffer size (bytes).
+// It returns the number of written characters in case of success.
+// It returns 0xFFFFFFFF in case of error (illegal format, or buffer overflow).
+///////////////////////////////////////////////////////////////////////////////////////
+unsigned int snprintf( char*        string,
+                       unsigned int length,
+                       char*        format, ... );
+
+///////////////////////////////////////////////////////////////////////////////////////
+// This service function is called by:
+// - giet_fat_fprintf()
+// - giet_tty_printf()
+// - snprintf()
+///////////////////////////////////////////////////////////////////////////////////////
+unsigned int xprintf( char*        string,
+                      unsigned int length,
+                      char*        format,
+                      va_list*     args );
+                
+
+
 #endif
+
 
 // Local Variables: