]> pd.if.org Git - pdclib/blobdiff - draft.c
Checked the remaining 'TODO' comments.
[pdclib] / draft.c
diff --git a/draft.c b/draft.c
index f8ca51bac004829fb9644e40ab7837aaf3f46e19..36b0c7954e25d7597c1fa6e6209ddc440bf8873b 100644 (file)
--- a/draft.c
+++ b/draft.c
@@ -40,9 +40,10 @@ struct status_t
     size_t        width; /* width of current field                           */
     size_t        prec;  /* precision of current field                       */
     FILE *        stream;/* for to-stream output                             */
+    va_list       ap;    /* the argument stack passed to the printf function */
 };
 
-const char * parse_out( const char * spec, struct status_t * status, va_list ap );
+const char * parse_out( const char * spec, struct status_t * status );
 inline void test( size_t n, const char * expect, ... );
 int _PDCLIB_sprintf( char * buffer, size_t n, const char * format, va_list ap );
 
@@ -134,30 +135,97 @@ int main( void )
     test( SIZE_MAX, "%-011d", INT_MAX );
     test( SIZE_MAX, "%-012d", INT_MIN );
     test( SIZE_MAX, "%-012d", INT_MAX );
+    puts( "- Limited n -\n" );
+    test( 8, "%9d", INT_MAX );
+    test( 8, "%9d", INT_MIN );
+    test( 9, "%9d", INT_MAX );
+    test( 9, "%9d", INT_MIN );
+    test( 10, "%9d", INT_MAX );
+    test( 10, "%9d", INT_MIN );
+    test( 9, "%10d", INT_MAX );
+    test( 9, "%10d", INT_MIN );
+    test( 10, "%10d", INT_MAX );
+    test( 10, "%10d", INT_MIN );
+    test( 11, "%10d", INT_MAX );
+    test( 11, "%10d", INT_MIN );
+    test( 10, "%11d", INT_MAX );
+    test( 10, "%11d", INT_MIN );
+    test( 11, "%11d", INT_MAX );
+    test( 11, "%11d", INT_MIN );
+    test( 12, "%11d", INT_MAX );
+    test( 12, "%11d", INT_MIN );
+    test( 11, "%12d", INT_MAX );
+    test( 11, "%12d", INT_MIN );
+    test( 12, "%12d", INT_MAX );
+    test( 12, "%12d", INT_MIN );
+    test( 13, "%12d", INT_MAX );
+    test( 13, "%12d", INT_MIN );
+    puts( "- Precision -\n" );
+    test( SIZE_MAX, "%030.20d", INT_MAX );
+    test( SIZE_MAX, "%.6x", UINT_MAX );
+    test( SIZE_MAX, "%#6.3x", UINT_MAX );
+    test( SIZE_MAX, "%#3.6x", UINT_MAX );
+    test( SIZE_MAX, "%.6d", INT_MIN );
+    test( SIZE_MAX, "%6.3d", INT_MIN );
+    test( SIZE_MAX, "%3.6d", INT_MIN );
+    test( SIZE_MAX, "%#0.6x", UINT_MAX );
+    test( SIZE_MAX, "%#06.3x", UINT_MAX );
+    test( SIZE_MAX, "%#03.6x", UINT_MAX );
+    test( SIZE_MAX, "%#0.6d", INT_MAX );
+    test( SIZE_MAX, "%#06.3d", INT_MAX );
+    test( SIZE_MAX, "%#03.6d", INT_MAX );
+    test( SIZE_MAX, "%#+.6d", INT_MAX );
+    test( SIZE_MAX, "%#+6.3d", INT_MAX );
+    test( SIZE_MAX, "%#+3.6d", INT_MAX );
+    test( SIZE_MAX, "%+0.6d", INT_MAX );
+    test( SIZE_MAX, "%+06.3d", INT_MAX );
+    test( SIZE_MAX, "%+03.6d", INT_MAX );
+    puts( "- Multiple outputs -\n" );
+    test( SIZE_MAX, "- %d", INT_MAX );
+    test( SIZE_MAX, "- %d %% %d", INT_MAX, INT_MIN );
     return 0;
 }
 
-/* x - the character to be delivered
+/* This macro delivers a given character to either a memory buffer or a stream,
+   depending on the contents of 'status' (struct status_t).
+   x - the character to be delivered
    i - pointer to number of characters already delivered in this call
    n - pointer to maximum number of characters to be delivered in this call
    s - the buffer into which the character shall be delivered
-   TODO: Overruns.
 */
 #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 )
 
+/* This function recursively converts a given integer value to a given base
+   into a character string. Persistent information - like the number of digits
+   parsed so far - is recorded in a struct status_t, which allows to avoid
+   overwriting snprintf() limits, and enables the function to do the necessary
+   padding / prefixing of the character string eventually printed.
+*/
 static void int2base( intmax_t value, struct status_t * status )
 {
+    /* Registering the character being printed at the end of the function here
+       already so it will be taken into account when the deepestmost recursion
+       does the prefix / padding stuff.
+    */
     ++(status->this);
     if ( ( value / status->base ) != 0 )
     {
+        /* More digits to be done - recurse deeper */
         int2base( value / status->base, status );
     }
     else
     {
-        char preface[3] = "\0\0";
+        /* We reached the last digit, the deepest point of our recursion, and
+           only now know how long the number to be printed actually is. Now we
+           have to do the sign, prefix, width, and precision padding stuff
+           before printing the numbers while we resurface from the recursion.
+        */
+        /* At worst, we need two prefix characters (hex prefix). */
+        char preface[3] = "\0";
         size_t preidx = 0;
         if ( ( status->flags & E_alt ) && ( status->base == 16 || status->base == 8 ) )
         {
+            /* Octal / hexadecimal prefix for "%#" conversions */
             preface[ preidx++ ] = '0';
             if ( status->base == 16 )
             {
@@ -166,10 +234,12 @@ static void int2base( intmax_t value, struct status_t * status )
         }
         if ( value < 0 )
         {
+            /* Negative sign for negative values - at all times. */
             preface[ preidx++ ] = '-';
         }
         else if ( ! ( status->flags & E_unsigned ) )
         {
+            /* plus sign / extra space are only for unsigned conversions */
             if ( status->flags & E_plus )
             {
                 preface[ preidx++ ] = '+';
@@ -179,14 +249,29 @@ static void int2base( intmax_t value, struct status_t * status )
                 preface[ preidx++ ] = ' ';
             }
         }
+        {
+        size_t prec_pads = ( status->prec > status->this ) ? ( status->prec - status->this ) : 0;
         if ( ! ( status->flags & ( E_minus | E_zero ) ) )
         {
-            while ( ( status->this + preidx ) < status->width )
+            /* Space padding is only done if no zero padding or left alignment
+               is requested. Leave space for any prefixes determined above.
+            */
+            /* The number of characters to be printed, plus prefixes if any. */
+            /* This line contained probably the most stupid, time-wasting bug
+               I've ever perpetrated. Greetings to Samface, DevL, and all
+               sceners at Breakpoint 2006.
+            */
+            size_t characters = preidx + ( ( status->this > status->prec ) ? status->this : status->prec );
+            if ( status->width > characters )
             {
-                DELIVER( ' ' );
-                ++(status->this);
+                for ( int i = 0; i < status->width - characters; ++i )
+                {
+                    DELIVER( ' ' );
+                    ++(status->this);
+                }
             }
         }
+        /* Now we did the padding, do the prefixes (if any). */
         preidx = 0;
         while ( preface[ preidx ] != '\0' )
         {
@@ -195,13 +280,23 @@ static void int2base( intmax_t value, struct status_t * status )
         }
         if ( ( ! ( status->flags & E_minus ) ) && ( status->flags & E_zero ) )
         {
+            /* If field is not left aligned, and zero padding is requested, do
+               so.
+            */
             while ( status->this < status->width )
             {
                 DELIVER( '0' );
                 ++(status->this);
             }
         }
+        /* Do the precision padding if necessary. */
+        for ( int i = 0; i < prec_pads; ++i )
+        {
+            DELIVER( '0' );
+        }
+        }
     }
+    /* Recursion tail - print the current digit. */
     {
     int digit = value % status->base;
     if ( digit < 0 )
@@ -210,29 +305,34 @@ static void int2base( intmax_t value, struct status_t * status )
     }
     if ( status->flags & E_lower )
     {
+        /* Lowercase letters. Same array used for strto...(). */
         DELIVER( _PDCLIB_digits[ digit ] );
     }
     else
     {
+        /* Uppercase letters. Array only used here, only 0-F. */
         DELIVER( _PDCLIB_Xdigits[ digit ] );
     }
     }
 }
 
-const char * parse_out( const char * spec, struct status_t * status, va_list ap )
+/* This function is to be called with spec pointing to the leading '%' of a
+   printf() conversion specifier, with ap being 
+*/
+const char * parse_out( const char * spec, struct status_t * status )
 {
     const char * orig_spec = spec;
     if ( *(++spec) == '%' )
     {
         DELIVER( *spec );
-        return spec;
+        return ++spec;
     }
     /* Initializing status structure */
     status->flags = 0;
-    status->base = 0;
-    status->this = 0;
+    status->base  = 0;
+    status->this  = 0;
     status->width = 0;
-    status->prec = 0;
+    status->prec  = 0;
 
     /* First come 0..n flags */
     do
@@ -269,7 +369,7 @@ const char * parse_out( const char * spec, struct status_t * status, va_list ap
     if ( *spec == '*' )
     {
         /* Retrieve width value from argument stack */
-        if ( ( status->width = va_arg( ap, int ) ) < 0 )
+        if ( ( status->width = va_arg( status->ap, int ) ) < 0 )
         {
             /* Negative value is '-' flag plus absolute value */
             status->flags |= E_minus;
@@ -296,7 +396,7 @@ const char * parse_out( const char * spec, struct status_t * status, va_list ap
                is as if no precision is given - as precision is initalized to
                EOF (negative), there is no need for testing for negative here.
             */
-            status->prec = va_arg( ap, int );
+            status->prec = va_arg( status->ap, int );
         }
         else
         {
@@ -307,7 +407,10 @@ const char * parse_out( const char * spec, struct status_t * status, va_list ap
                 /* Decimal point but no number - bad conversion specifier. */
                 return orig_spec;
             }
+            spec = endptr;
         }
+        /* Having a precision cancels out any zero flag. */
+        status->flags ^= E_zero;
     }
 
     /* Optional length modifier
@@ -413,22 +516,22 @@ const char * parse_out( const char * spec, struct status_t * status, va_list ap
             switch ( status->flags & ( E_char | E_short | E_long | E_llong | E_size ) )
             {
                 case E_char:
-                    value = (uintmax_t)(unsigned char)va_arg( ap, int );
+                    value = (uintmax_t)(unsigned char)va_arg( status->ap, int );
                     break;
                 case E_short:
-                    value = (uintmax_t)(unsigned short)va_arg( ap, int );
+                    value = (uintmax_t)(unsigned short)va_arg( status->ap, int );
                     break;
                 case 0:
-                    value = (uintmax_t)va_arg( ap, unsigned int );
+                    value = (uintmax_t)va_arg( status->ap, unsigned int );
                     break;
                 case E_long:
-                    value = (uintmax_t)va_arg( ap, unsigned long );
+                    value = (uintmax_t)va_arg( status->ap, unsigned long );
                     break;
                 case E_llong:
-                    value = (uintmax_t)va_arg( ap, unsigned long long );
+                    value = (uintmax_t)va_arg( status->ap, unsigned long long );
                     break;
                 case E_size:
-                    value = (uintmax_t)va_arg( ap, size_t );
+                    value = (uintmax_t)va_arg( status->ap, size_t );
                     break;
             }
             ++(status->this);
@@ -455,25 +558,25 @@ const char * parse_out( const char * spec, struct status_t * status, va_list ap
             switch ( status->flags & ( E_char | E_short | E_long | E_llong | E_intmax ) )
             {
                 case E_char:
-                    int2base( (intmax_t)(char)va_arg( ap, int ), status );
+                    int2base( (intmax_t)(char)va_arg( status->ap, int ), status );
                     break;
                 case E_short:
-                    int2base( (intmax_t)(short)va_arg( ap, int ), status );
+                    int2base( (intmax_t)(short)va_arg( status->ap, int ), status );
                     break;
                 case 0:
-                    int2base( (intmax_t)va_arg( ap, int ), status );
+                    int2base( (intmax_t)va_arg( status->ap, int ), status );
                     break;
                 case E_long:
-                    int2base( (intmax_t)va_arg( ap, long ), status );
+                    int2base( (intmax_t)va_arg( status->ap, long ), status );
                     break;
                 case E_llong:
-                    int2base( (intmax_t)va_arg( ap, long long ), status );
+                    int2base( (intmax_t)va_arg( status->ap, long long ), status );
                     break;
                 case E_ptrdiff:
-                    int2base( (intmax_t)va_arg( ap, ptrdiff_t ), status );
+                    int2base( (intmax_t)va_arg( status->ap, ptrdiff_t ), status );
                     break;
                 case E_intmax:
-                    int2base( va_arg( ap, intmax_t ), status );
+                    int2base( va_arg( status->ap, intmax_t ), status );
                     break;
             }
         }
@@ -502,7 +605,7 @@ inline void test( size_t n, const char * expect, ... )
     va_list ap;
     va_start( ap, expect );
     myrc = _PDCLIB_sprintf( buffer1, n, expect, ap );
-    rc = vsprintf( buffer2, expect, ap );
+    rc = vsnprintf( buffer2, n, expect, ap );
     if ( ( strcmp( buffer1, buffer2 ) != 0 ) || ( myrc != rc ) )
     {
         printf( "Output '%s', RC %d\nExpect '%s', RC %d\n\n", buffer1, myrc, buffer2, rc );
@@ -513,14 +616,14 @@ inline void test( size_t n, const char * expect, ... )
 
 int _PDCLIB_sprintf( char * buffer, size_t n, const char * format, va_list ap )
 {
-    struct status_t status = { 0, 0, n, 0, 0, buffer, 0, 0, NULL };
+    struct status_t status = { 0, 0, n, 0, 0, buffer, 0, 0, NULL, ap };
     while ( *format != '\0' )
     {
         const char * rc;
-        if ( ( *format != '%' ) || ( ( rc = parse_out( format, &status, ap ) ) == format ) )
+        if ( ( *format != '%' ) || ( ( rc = parse_out( format, &status ) ) == format ) )
         {
             /* No conversion specifier, print verbatim */
-            buffer[ status.i++ ] = *format;
+            buffer[ status.i++ ] = *(format++);
         }
         else
         {
@@ -535,8 +638,7 @@ int _PDCLIB_sprintf( char * buffer, size_t n, const char * format, va_list ap )
 #if 0
 int _PDCLIB_fprintf( FILE * stream, const char * format, va_list ap )
 {
-    char * buffer = malloc( 50 );
-    struct status_t status = { 0, 0, SIZE_MAX, 0, 0, /* stream->buffer */ buffer, 0, 0, stream };
+    struct status_t status = { 0, 0, SIZE_MAX, 0, 0, NULL, 0, 0, stream, ap };
     while ( *format != '\0' )
     {
         const char * rc;