2 * Copyright ArcCore AB
\r
4 * A simple implementation of all formatted xxprintf functionallity.
\r
10 * What you normally would do is to print to a buffer of some kind and then
\r
11 * call write(). However little stack indicates that we can't place buffers
\r
12 * on the stack and reentrant tells us that we can't have a static buffer.
\r
13 * That leaves us with printing characters as it is ready. From a speed
\r
14 * point of view that is less than optimal, but that the way it's got to be.
\r
15 * (Could make a 16 long char buffer??)
\r
17 * This is just intended to be used as a replacement for newlibs implementation.
\r
18 * Newlib porting interface have the following API:
\r
19 * int write( int fd, char *buf, int nbytes)
\r
22 * Note that puts(), putc() are still the newlib variants....
\r
24 * printf() -> vfprintf(stdout,) -> vsnprintf(buf,)
\r
26 * vprintf() -> vfprintf(stdout,) -> vsnprintf(buf,)
\r
28 * sprintf(buf,) -> vsnprintf(buf,)
\r
29 * snprintf(buf,) -> vsnprintf(buf,)
\r
31 * IMPLEMENTATION NOTE:
\r
32 * - If printing more than the limit, e.g. using vsnprintf() then
\r
33 * the emit function will only stop printing, but not interrupted
\r
34 * (The code will get more complicated that way)
\r
35 * - ANSI-C and POSIX, streams and POSIX filenumbers.
\r
36 * POSIX file-numbers exist in unistd.h and are only to be used by the porting
\r
37 * newlib interface i.e. newlib_port.c.
\r
38 * The filenumber is actually just a cast of the steampointer and save in the member
\r
49 //#define HOST_TEST 1
\r
51 int arc_putchar(int fd, int c);
\r
52 int print(FILE *file, char **buffer, size_t n, const char *format, va_list ap);
\r
54 int printf(const char *format, ...) {
\r
58 va_start(ap, format);
\r
59 rv = vfprintf(stdout, format, ap);
\r
64 int fprintf(FILE *file, const char *format, ...) {
\r
68 va_start(ap, format);
\r
69 rv = vfprintf(file, format, ap);
\r
74 int sprintf(char *buffer, const char *format, ...) {
\r
78 va_start(ap, format);
\r
79 rv = vsnprintf(buffer, ~(size_t)0, format, ap);
\r
85 int snprintf(char *buffer, size_t n, const char *format, ...) {
\r
89 va_start(ap, format);
\r
90 rv = vsnprintf(buffer, n, format, ap);
\r
95 int vprintf(const char *format, va_list ap) {
\r
96 return vfprintf(stdout, format, ap);
\r
99 int vsprintf(char *buffer, const char *format, va_list ap) {
\r
100 return vsnprintf(buffer, ~(size_t)0, format, ap);
\r
103 int vfprintf(FILE *file, const char *format, va_list ap) {
\r
105 /* Just print to stdout */
\r
106 rv = print(file,NULL,~(size_t)0, format,ap);
\r
111 int vsnprintf(char *buffer, size_t n, const char *format, va_list ap) {
\r
114 rv = print(NULL, &buffer, n, format,ap);
\r
120 * The integer only counterpart
\r
122 int iprintf(const char *format, ...) __attribute__ ((alias("printf")));
\r
123 int fiprintf(FILE *file, const char *format, ...) __attribute__ ((alias("fprintf")));
\r
124 int siprintf(char *buffer, const char *format, ...) __attribute__ ((alias("sprintf")));
\r
125 int sniprintf(char *buffer, size_t n, const char *format, ...) __attribute__ ((alias("snprintf")));
\r
126 int viprintf(const char *format, va_list ap) __attribute__ ((alias("vprintf")));
\r
127 int vsiprintf(char *buffer, const char *format, va_list ap) __attribute__ ((alias("vsprintf")));
\r
128 int vfiprintf(FILE *file, const char *format, va_list ap) __attribute__ ((alias("vfprintf")));
\r
132 * @param file The file to print to
\r
133 * @param buf The buffer to print to
\r
134 * @param c The char to print
\r
137 static inline int emitChar( FILE *file, char **buf, char c, int *left ) {
\r
138 if( (*left) == 1 ) {
\r
142 if( buf == NULL ) {
\r
147 arc_putchar((int)file, c);
\r
157 #if defined(HOST_TEST)
\r
159 * Convert a number to a string
\r
161 * @param val The value to convert
\r
162 * @param str Pointer to a space where to put the string
\r
163 * @param base The base
\r
164 * @param negative If negative or not.
\r
166 void xtoa( unsigned long val, char* str, int base, int negative) {
\r
175 if( base < 10 && base > 16 ) {
\r
182 str[i++] = "0123456789abcdef"[ val % base ];
\r
183 } while ((val /= base) > 0);
\r
192 while(str > oStr) {
\r
199 extern void xtoa( unsigned long val, char* str, int base, int negative);
\r
203 #define FL_NONE (0<<0)
\r
204 #define FL_ZERO (1<<1)
\r
205 #define FL_HASH (1<<2)
\r
206 #define FL_SPACE (1<<3)
\r
207 #define FL_ALIGN_LEFT (1<<4)
\r
208 #define FL_TYPE_SIGNED_INT (1<<5)
\r
209 #define FL_TYPE_UNSIGNED_INT (1<<6)
\r
210 #define FL_TYPE_POINTER (1<<7)
\r
212 static void emitString( FILE *file, char **buffer, char *string, int width, int flags, int *left) {
\r
214 char *str = string;
\r
217 /* padding: FL_ZERO or normal ' '
\r
218 * align: FL_ALIGN_LEFT (left) or normal (right)
\r
220 pad = (flags & FL_ZERO) ? '0' : ' ';
\r
223 if( flags & FL_ALIGN_LEFT ) {
\r
224 for(i=0;str[i]; i++) {
\r
225 emitChar(file,buffer,str[i],left);
\r
229 for(;i<width;i++) {
\r
230 emitChar(file,buffer,pad,left);
\r
234 strLen = strlen(string);
\r
237 if( width > strLen ) {
\r
238 for(i=0;i<(width-strLen);i++) {
\r
239 emitChar(file,buffer,pad,left);
\r
243 for(i=0;i<strLen; i++) {
\r
244 emitChar(file,buffer,string[i],left);
\r
249 void emitInt( FILE *file, char **buffer, int val, int base, int width, int flags, int *left )
\r
251 char lBuf[12]; // longest is base 10, 2^32
\r
254 if( flags & FL_TYPE_SIGNED_INT ) {
\r
255 xtoa(val,str,base ,(val < 0));
\r
257 xtoa((unsigned)val,str,base ,0);
\r
260 emitString(file,buffer,str,width,flags,left);
\r
263 #define PRINT_CHAR(_c) *buffer++= (_c);
\r
267 * Write formatted output to an array with a maximum number of characters.
\r
269 * This is the mother of the formatted print family. The main goal here
\r
270 * is to be very small and memory efficient.
\r
274 * Flags : '-' and '0'
\r
275 * Width : Normal padding is supported, '*' is not.
\r
279 * Type : d,u,x,s,and c
\r
281 * @param file The file descriptor
\r
282 * @param buffer A pointer to the place to store the output
\r
283 * If NULL the output is instead
\r
284 * @param n The maximum number of characters to write
\r
285 * @param format The format string
\r
286 * @param ap The va list
\r
289 int print(FILE *file, char **buffer, size_t n, const char *format, va_list ap)
\r
297 while ( (ch = *format++) ) {
\r
303 emitChar(file,buffer,ch,&left);
\r
316 flags = FL_ALIGN_LEFT;
\r
319 /* Not supported or no flag */
\r
328 if( (ch >= '0') && (ch <= '9') ) {
\r
338 emitChar(file,buffer,(char )va_arg( ap, int ),&left);
\r
341 flags |= FL_TYPE_SIGNED_INT;
\r
342 emitInt(file,buffer,va_arg( ap, int ),10,width,flags,&left);
\r
345 flags |= FL_TYPE_UNSIGNED_INT;
\r
346 emitInt(file,buffer,va_arg( ap, int ),10,width,flags,&left);
\r
349 flags |= FL_TYPE_UNSIGNED_INT;
\r
350 emitInt(file,buffer,va_arg( ap, int ),16,width,flags,&left);
\r
353 flags |= FL_TYPE_POINTER;
\r
354 emitInt(file,buffer,va_arg( ap, int ),16,width,flags,&left);
\r
357 str = (char *)va_arg( ap, int );
\r
359 if( str == NULL ) {
\r
363 emitString(file,buffer,str,width,flags,&left);
\r
372 emitChar(file,buffer,ch,&left);
\r
375 // va_end(ap); // Removed, TODO: Check the va_start/va_end handling (used in calling functions also).
\r
378 emitChar(file,buffer,'\0',&left);
\r
380 return 0; // Wrong.. but for now.
\r
388 printf("char: %c %c = a B\n", 'a', 66);
\r
390 printf("string: %s = (null)\n", (char *)ptr);
\r
392 printf("string: %s = foobar \n", "foobar");
\r
394 printf("string: %2s = foobar \n", "foobar");
\r
395 printf("string: \"%8s\" = \" foobar\" \n", "foobar");
\r
397 printf("string: \"%-8s\" = \"foobar \" \n", "foobar");
\r
399 printf("decimal: 23 = %d \n", 23);
\r
400 printf("hex: c23 = %x \n", 0xc23);
\r
401 printf("hex: 0c23 = %04x \n", 0xc23);
\r
402 printf("decimal with blanks: 23 = %6d \n", 23);
\r
403 printf("decimal with zero: 000023 = %06d \n", 23);
\r
405 /* negative and large numbers */
\r
406 printf("decimal: -23 = %d \n", -23);
\r
407 printf("decimal: 4294967273 = %u \n", -23);
\r
408 printf("decimal: c0000000 = %x \n", 0xc0000000);
\r
410 printf("decimal: 00c000 = %06x \n", 0xc000);
\r
412 fprintf(stdout, "string: %s = foobar \n", "foobar");
\r
413 sprintf(buff, "string: %s = foobar \n", "foobar");
\r
416 snprintf(buff,10, "%s\n", "12345678901234567");
\r
417 printf("\"123456789\" = \"%s\"\n",buff);
\r
419 snprintf(buff,12, "%s\n", "abcdefghijklmn");
\r
420 printf("\"abcdefghijkl\" = \"%s\"\n",buff);
\r