/* printf.c
 *
 * $Id$
 *
 * Provides an implementation of the "printf" function, conforming
 * generally to C99 and SUSv3/POSIX specifications, with extensions
 * to support Microsoft's non-standard format specifications.  This
 * is included in libmingwex.a, whence it may replace the Microsoft
 * function of the same name.
 *
 * Written by Keith Marshall <keithmarshall@users.sourceforge.net>
 *
 * This implementation of "printf" will normally be invoked by calling
 * "__mingw_printf()" in preference to a direct reference to "printf()"
 * itself; this leaves the MSVCRT implementation as the default, which
 * will be deployed when user code invokes "print()".  Users who then
 * wish to use this implementation may either call "__mingw_printf()"
 * directly, or may use conditional preprocessor defines, to redirect
 * references to "printf()" to "__mingw_printf()".
 *
 * Compiling this module with "-D INSTALL_AS_DEFAULT" will change this
 * recommended convention, such that references to "printf()" in user
 * code will ALWAYS be redirected to "__mingw_printf()"; if this option
 * is adopted, then users wishing to use the MSVCRT implementation of
 * "printf()" will be forced to use a "back-door" mechanism to do so.
 * Such a "back-door" mechanism is provided with MinGW, allowing the
 * MSVCRT implementation to be called as "__msvcrt_printf()"; however,
 * since users may not expect this behaviour, a standard libmingwex.a
 * installation does not employ this option.
 *
 *
 * This is free software.  You may redistribute and/or modify it as you
 * see fit, without restriction of copyright.
 *
 * This software is provided "as is", in the hope that it may be useful,
 * but WITHOUT WARRANTY OF ANY KIND, not even any implied warranty of
 * MERCHANTABILITY, nor of FITNESS FOR ANY PARTICULAR PURPOSE.  At no
 * time will the author accept any form of liability for any damages,
 * however caused, resulting from the use of this software.
 *
 */
#include <stdio.h>
#include <stdarg.h>

#include "pformat.h"

int __cdecl __printf( const char *, ... ) __MINGW_NOTHROW;

#ifdef INSTALL_AS_DEFAULT
/*
 * This implementation is to become the default for calls to printf();
 * establish the alias to make this so, forcing users to use the back-door
 * __msvcrt_printf() reference, to access the original MSVCRT function.
 */
int __cdecl __mingw_alias(printf) (const char *, ...) __MINGW_NOTHROW;

#endif

int __cdecl __printf( const char *fmt, ... )
{
  register int retval;
  va_list argv; va_start( argv, fmt );
  retval = __pformat( PFORMAT_TO_FILE | PFORMAT_NOLIMIT, stdout, 0, fmt, argv );
  va_end( argv );
  return retval;
}

/* $RCSfile$$Revision$: end of file */
