7 /* These can be removed once integrated into PDCLIB make procedure */
9 #include </home/solar/src/pdclib/functions/_PDCLIB/digits.c>
10 #include </home/solar/src/pdclib/functions/_PDCLIB/Xdigits.c>
12 /* Using an integer's bits as flags for both the conversion flags and length
25 #define E_intmax 1<<10
27 #define E_ptrdiff 1<<12
28 #define E_double 1<<13
30 #define E_unsigned 1<<15
34 int base; /* base to which the value shall be converted */
35 int_fast32_t flags; /* flags and length modifiers */
36 size_t n; /* maximum number of characters to be written */
37 size_t i; /* number of characters already written */
38 size_t this; /* number of output chars in the current conversion */
39 char * s; /* target buffer */
40 size_t width; /* width of current field */
41 size_t prec; /* precision of current field */
42 FILE * stream;/* for to-stream output */
43 va_list ap; /* the argument stack passed to the printf function */
46 const char * parse_out( const char * spec, struct status_t * status );
47 inline void test( size_t n, const char * expect, ... );
48 int _PDCLIB_sprintf( char * buffer, size_t n, const char * format, va_list ap );
50 /* The following only for testing. */
56 puts( "- Signed min / max -\n" );
57 test( SIZE_MAX, "%hhd", CHAR_MIN );
58 test( SIZE_MAX, "%hhd", CHAR_MAX );
59 test( SIZE_MAX, "%hhd", 0 );
60 test( SIZE_MAX, "%hd", SHRT_MIN );
61 test( SIZE_MAX, "%hd", SHRT_MAX );
62 test( SIZE_MAX, "%hd", 0 );
63 test( SIZE_MAX, "%d", INT_MIN );
64 test( SIZE_MAX, "%d", INT_MAX );
65 test( SIZE_MAX, "%d", 0 );
66 test( SIZE_MAX, "%ld", LONG_MIN );
67 test( SIZE_MAX, "%ld", LONG_MAX );
68 test( SIZE_MAX, "%ld", 0l );
69 test( SIZE_MAX, "%lld", LLONG_MIN );
70 test( SIZE_MAX, "%lld", LLONG_MAX );
71 test( SIZE_MAX, "%lld", 0ll );
72 puts( "- Unsigned min / max -\n" );
73 test( SIZE_MAX, "%hhu", UCHAR_MAX );
74 test( SIZE_MAX, "%hhu", (unsigned char)-1 );
75 test( SIZE_MAX, "%hu", USHRT_MAX );
76 test( SIZE_MAX, "%hu", (unsigned short)-1 );
77 test( SIZE_MAX, "%u", UINT_MAX );
78 test( SIZE_MAX, "%u", -1u );
79 test( SIZE_MAX, "%lu", ULONG_MAX );
80 test( SIZE_MAX, "%lu", -1ul );
81 test( SIZE_MAX, "%llu", ULLONG_MAX );
82 test( SIZE_MAX, "%llu", -1ull );
83 puts( "- Hex and Octal, normal and alternative, upper and lowercase -\n" );
84 test( SIZE_MAX, "%X", UINT_MAX );
85 test( SIZE_MAX, "%#X", -1u );
86 test( SIZE_MAX, "%x", UINT_MAX );
87 test( SIZE_MAX, "%#x", -1u );
88 test( SIZE_MAX, "%o", UINT_MAX );
89 test( SIZE_MAX, "%#o", -1u );
90 puts( "- Plus flag -\n" );
91 test( SIZE_MAX, "%+d", INT_MIN );
92 test( SIZE_MAX, "%+d", INT_MAX );
93 test( SIZE_MAX, "%+d", 0 );
94 test( SIZE_MAX, "%+u", UINT_MAX );
95 test( SIZE_MAX, "%+u", -1u );
96 puts( "- Space flag -\n" );
97 test( SIZE_MAX, "% d", INT_MIN );
98 test( SIZE_MAX, "% d", INT_MAX );
99 test( SIZE_MAX, "% d", 0 );
100 test( SIZE_MAX, "% u", UINT_MAX );
101 test( SIZE_MAX, "% u", -1u );
102 puts( "- Field width -\n" );
103 test( SIZE_MAX, "%9d", INT_MIN );
104 test( SIZE_MAX, "%9d", INT_MAX );
105 test( SIZE_MAX, "%10d", INT_MIN );
106 test( SIZE_MAX, "%10d", INT_MAX );
107 test( SIZE_MAX, "%11d", INT_MIN );
108 test( SIZE_MAX, "%11d", INT_MAX );
109 test( SIZE_MAX, "%12d", INT_MIN );
110 test( SIZE_MAX, "%12d", INT_MAX );
111 puts( "- Field width (left bound) -\n" );
112 test( SIZE_MAX, "%-9d", INT_MIN );
113 test( SIZE_MAX, "%-9d", INT_MAX );
114 test( SIZE_MAX, "%-10d", INT_MIN );
115 test( SIZE_MAX, "%-10d", INT_MAX );
116 test( SIZE_MAX, "%-11d", INT_MIN );
117 test( SIZE_MAX, "%-11d", INT_MAX );
118 test( SIZE_MAX, "%-12d", INT_MIN );
119 test( SIZE_MAX, "%-12d", INT_MAX );
120 puts( "- Field width, zero padding -\n");
121 test( SIZE_MAX, "%09d", INT_MIN );
122 test( SIZE_MAX, "%09d", INT_MAX );
123 test( SIZE_MAX, "%010d", INT_MIN );
124 test( SIZE_MAX, "%010d", INT_MAX );
125 test( SIZE_MAX, "%011d", INT_MIN );
126 test( SIZE_MAX, "%011d", INT_MAX );
127 test( SIZE_MAX, "%012d", INT_MIN );
128 test( SIZE_MAX, "%012d", INT_MAX );
129 puts( "- Field width, zero padding (left bound) -\n" );
130 test( SIZE_MAX, "%-09d", INT_MIN );
131 test( SIZE_MAX, "%-09d", INT_MAX );
132 test( SIZE_MAX, "%-010d", INT_MIN );
133 test( SIZE_MAX, "%-010d", INT_MAX );
134 test( SIZE_MAX, "%-011d", INT_MIN );
135 test( SIZE_MAX, "%-011d", INT_MAX );
136 test( SIZE_MAX, "%-012d", INT_MIN );
137 test( SIZE_MAX, "%-012d", INT_MAX );
138 puts( "- Limited n -\n" );
139 test( 8, "%9d", INT_MAX );
140 test( 8, "%9d", INT_MIN );
141 test( 9, "%9d", INT_MAX );
142 test( 9, "%9d", INT_MIN );
143 test( 10, "%9d", INT_MAX );
144 test( 10, "%9d", INT_MIN );
145 test( 9, "%10d", INT_MAX );
146 test( 9, "%10d", INT_MIN );
147 test( 10, "%10d", INT_MAX );
148 test( 10, "%10d", INT_MIN );
149 test( 11, "%10d", INT_MAX );
150 test( 11, "%10d", INT_MIN );
151 test( 10, "%11d", INT_MAX );
152 test( 10, "%11d", INT_MIN );
153 test( 11, "%11d", INT_MAX );
154 test( 11, "%11d", INT_MIN );
155 test( 12, "%11d", INT_MAX );
156 test( 12, "%11d", INT_MIN );
157 test( 11, "%12d", INT_MAX );
158 test( 11, "%12d", INT_MIN );
159 test( 12, "%12d", INT_MAX );
160 test( 12, "%12d", INT_MIN );
161 test( 13, "%12d", INT_MAX );
162 test( 13, "%12d", INT_MIN );
163 puts( "- Precision -\n" );
164 test( SIZE_MAX, "%030.20d", INT_MAX );
165 test( SIZE_MAX, "%.6x", UINT_MAX );
166 test( SIZE_MAX, "%#6.3x", UINT_MAX );
167 test( SIZE_MAX, "%#3.6x", UINT_MAX );
168 test( SIZE_MAX, "%.6d", INT_MIN );
169 test( SIZE_MAX, "%6.3d", INT_MIN );
170 test( SIZE_MAX, "%3.6d", INT_MIN );
171 test( SIZE_MAX, "%#0.6x", UINT_MAX );
172 test( SIZE_MAX, "%#06.3x", UINT_MAX );
173 test( SIZE_MAX, "%#03.6x", UINT_MAX );
174 test( SIZE_MAX, "%#0.6d", INT_MAX );
175 test( SIZE_MAX, "%#06.3d", INT_MAX );
176 test( SIZE_MAX, "%#03.6d", INT_MAX );
177 test( SIZE_MAX, "%#+.6d", INT_MAX );
178 test( SIZE_MAX, "%#+6.3d", INT_MAX );
179 test( SIZE_MAX, "%#+3.6d", INT_MAX );
180 test( SIZE_MAX, "%+0.6d", INT_MAX );
181 test( SIZE_MAX, "%+06.3d", INT_MAX );
182 test( SIZE_MAX, "%+03.6d", INT_MAX );
183 puts( "- Multiple outputs -\n" );
184 test( SIZE_MAX, "- %d", INT_MAX );
185 test( SIZE_MAX, "- %d %% %d", INT_MAX, INT_MIN );
189 /* This macro delivers a given character to either a memory buffer or a stream,
190 depending on the contents of 'status' (struct status_t).
191 x - the character to be delivered
192 i - pointer to number of characters already delivered in this call
193 n - pointer to maximum number of characters to be delivered in this call
194 s - the buffer into which the character shall be delivered
196 #define DELIVER( x ) do { if ( status->i < status->n ) { if ( status->stream != NULL ) putc( x, status->stream ); else status->s[status->i] = x; } ++(status->i); } while ( 0 )
198 /* This function recursively converts a given integer value to a given base
199 into a character string. Persistent information - like the number of digits
200 parsed so far - is recorded in a struct status_t, which allows to avoid
201 overwriting snprintf() limits, and enables the function to do the necessary
202 padding / prefixing of the character string eventually printed.
204 static void int2base( intmax_t value, struct status_t * status )
206 /* Registering the character being printed at the end of the function here
207 already so it will be taken into account when the deepestmost recursion
208 does the prefix / padding stuff.
211 if ( ( value / status->base ) != 0 )
213 /* More digits to be done - recurse deeper */
214 int2base( value / status->base, status );
218 /* We reached the last digit, the deepest point of our recursion, and
219 only now know how long the number to be printed actually is. Now we
220 have to do the sign, prefix, width, and precision padding stuff
221 before printing the numbers while we resurface from the recursion.
223 /* At worst, we need two prefix characters (hex prefix). */
224 char preface[3] = "\0";
226 if ( ( status->flags & E_alt ) && ( status->base == 16 || status->base == 8 ) )
228 /* Octal / hexadecimal prefix for "%#" conversions */
229 preface[ preidx++ ] = '0';
230 if ( status->base == 16 )
232 preface[ preidx++ ] = ( status->flags & E_lower ) ? 'x' : 'X';
237 /* Negative sign for negative values - at all times. */
238 preface[ preidx++ ] = '-';
240 else if ( ! ( status->flags & E_unsigned ) )
242 /* plus sign / extra space are only for unsigned conversions */
243 if ( status->flags & E_plus )
245 preface[ preidx++ ] = '+';
247 else if ( status->flags & E_space )
249 preface[ preidx++ ] = ' ';
253 size_t prec_pads = ( status->prec > status->this ) ? ( status->prec - status->this ) : 0;
254 if ( ! ( status->flags & ( E_minus | E_zero ) ) )
256 /* Space padding is only done if no zero padding or left alignment
257 is requested. Leave space for any prefixes determined above.
259 /* The number of characters to be printed, plus prefixes if any. */
260 /* This line contained probably the most stupid, time-wasting bug
261 I've ever perpetrated. Greetings to Samface, DevL, and all
262 sceners at Breakpoint 2006.
264 size_t characters = preidx + ( ( status->this > status->prec ) ? status->this : status->prec );
265 if ( status->width > characters )
267 for ( int i = 0; i < status->width - characters; ++i )
274 /* Now we did the padding, do the prefixes (if any). */
276 while ( preface[ preidx ] != '\0' )
278 DELIVER( preface[ preidx++ ] );
281 if ( ( ! ( status->flags & E_minus ) ) && ( status->flags & E_zero ) )
283 /* If field is not left aligned, and zero padding is requested, do
286 while ( status->this < status->width )
292 /* Do the precision padding if necessary. */
293 for ( int i = 0; i < prec_pads; ++i )
299 /* Recursion tail - print the current digit. */
301 int digit = value % status->base;
306 if ( status->flags & E_lower )
308 /* Lowercase letters. Same array used for strto...(). */
309 DELIVER( _PDCLIB_digits[ digit ] );
313 /* Uppercase letters. Array only used here, only 0-F. */
314 DELIVER( _PDCLIB_Xdigits[ digit ] );
319 /* This function is to be called with spec pointing to the leading '%' of a
320 printf() conversion specifier, with ap being
322 const char * parse_out( const char * spec, struct status_t * status )
324 const char * orig_spec = spec;
325 if ( *(++spec) == '%' )
330 /* Initializing status structure */
337 /* First come 0..n flags */
343 status->flags |= E_minus;
347 status->flags |= E_plus;
351 status->flags |= E_alt;
355 status->flags |= E_space;
359 status->flags |= E_zero;
363 status->flags |= E_done;
366 } while ( ! ( status->flags & E_done ) );
368 /* Optional field width */
371 /* Retrieve width value from argument stack */
372 if ( ( status->width = va_arg( status->ap, int ) ) < 0 )
374 /* Negative value is '-' flag plus absolute value */
375 status->flags |= E_minus;
382 /* If a width is given, strtol() will return its value. If not given,
383 strtol() will return zero. In both cases, endptr will point to the
384 rest of the conversion specifier - just what we need.
386 status->width = (int)strtol( spec, (char**)&spec, 10 );
389 /* Optional precision */
395 /* Retrieve precision value from argument stack. A negative value
396 is as if no precision is given - as precision is initalized to
397 EOF (negative), there is no need for testing for negative here.
399 status->prec = va_arg( status->ap, int );
404 status->prec = (int)strtol( spec, &endptr, 10 );
405 if ( spec == endptr )
407 /* Decimal point but no number - bad conversion specifier. */
412 /* Having a precision cancels out any zero flag. */
413 status->flags ^= E_zero;
416 /* Optional length modifier
417 We step one character ahead in any case, and step back only if we find
418 there has been no length modifier (or step ahead another character if it
419 has been "hh" or "ll").
426 status->flags |= E_char;
431 status->flags |= E_short;
437 status->flags |= E_llong;
442 status->flags |= E_long;
446 status->flags |= E_intmax;
449 status->flags |= E_size;
452 status->flags |= E_ptrdiff;
455 status->flags |= E_double;
462 /* Conversion specifier */
471 status->flags |= E_unsigned;
475 status->flags |= E_unsigned;
479 status->flags |= ( E_lower | E_unsigned );
483 status->flags |= E_unsigned;
500 /* uint2base( 16, (intptr_t)value, true ) */
504 /* No conversion specifier. Bad conversion. */
508 /* Do the actual output based on our findings */
509 if ( status->base != 0 )
511 /* Integer conversions */
512 /* TODO: Check for invalid flag combinations. */
513 if ( status->flags & E_unsigned )
516 switch ( status->flags & ( E_char | E_short | E_long | E_llong | E_size ) )
519 value = (uintmax_t)(unsigned char)va_arg( status->ap, int );
522 value = (uintmax_t)(unsigned short)va_arg( status->ap, int );
525 value = (uintmax_t)va_arg( status->ap, unsigned int );
528 value = (uintmax_t)va_arg( status->ap, unsigned long );
531 value = (uintmax_t)va_arg( status->ap, unsigned long long );
534 value = (uintmax_t)va_arg( status->ap, size_t );
538 if ( ( value / status->base ) != 0 )
540 int2base( (intmax_t)(value / status->base), status );
542 int digit = value % status->base;
547 if ( status->flags & E_lower )
549 DELIVER( _PDCLIB_digits[ digit ] );
553 DELIVER( _PDCLIB_Xdigits[ digit ] );
558 switch ( status->flags & ( E_char | E_short | E_long | E_llong | E_intmax ) )
561 int2base( (intmax_t)(char)va_arg( status->ap, int ), status );
564 int2base( (intmax_t)(short)va_arg( status->ap, int ), status );
567 int2base( (intmax_t)va_arg( status->ap, int ), status );
570 int2base( (intmax_t)va_arg( status->ap, long ), status );
573 int2base( (intmax_t)va_arg( status->ap, long long ), status );
576 int2base( (intmax_t)va_arg( status->ap, ptrdiff_t ), status );
579 int2base( va_arg( status->ap, intmax_t ), status );
583 if ( status->flags & E_minus )
585 while ( status->this < status->width )
591 if ( status->i >= status->n )
593 status->s[status->n - 1] = '\0';
599 inline void test( size_t n, const char * expect, ... )
601 char * buffer1 = malloc( 50 );
602 char * buffer2 = malloc( 50 );
606 va_start( ap, expect );
607 myrc = _PDCLIB_sprintf( buffer1, n, expect, ap );
608 rc = vsnprintf( buffer2, n, expect, ap );
609 if ( ( strcmp( buffer1, buffer2 ) != 0 ) || ( myrc != rc ) )
611 printf( "Output '%s', RC %d\nExpect '%s', RC %d\n\n", buffer1, myrc, buffer2, rc );
617 int _PDCLIB_sprintf( char * buffer, size_t n, const char * format, va_list ap )
619 struct status_t status = { 0, 0, n, 0, 0, buffer, 0, 0, NULL, ap };
620 while ( *format != '\0' )
623 if ( ( *format != '%' ) || ( ( rc = parse_out( format, &status ) ) == format ) )
625 /* No conversion specifier, print verbatim */
626 buffer[ status.i++ ] = *(format++);
630 /* Continue parsing after conversion specifier */
634 buffer[ status.i ] = '\0';
639 int _PDCLIB_fprintf( FILE * stream, const char * format, va_list ap )
641 struct status_t status = { 0, 0, SIZE_MAX, 0, 0, NULL, 0, 0, stream, ap };
642 while ( *format != '\0' )
645 if ( ( *format != '%' ) || ( ( rc = parse_out( format, &status, ap ) ) == format ) )
647 /* No conversion specifier, print verbatim */
648 putc( *(format++), stream );
652 /* Continue parsing after conversion specifier */