newlib-cygwin/winsup/mingw/mingwex/stdio/vsprintf.c

67 lines
2.6 KiB
C
Raw Normal View History

/* vsprintf.c
*
* $Id$
*
* Provides an implementation of the "vsprintf" 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 "vsprintf" will normally be invoked by calling
* "__mingw_vsprintf()" in preference to a direct reference to "vsprintf()"
* itself; this leaves the MSVCRT implementation as the default, which
* will be deployed when user code invokes "vsprint()". Users who then
* wish to use this implementation may either call "__mingw_vsprintf()"
* directly, or may use conditional preprocessor defines, to redirect
* references to "vsprintf()" to "__mingw_vsprintf()".
*
* Compiling this module with "-D INSTALL_AS_DEFAULT" will change this
* recommended convention, such that references to "vsprintf()" in user
* code will ALWAYS be redirected to "__mingw_vsprintf()"; if this option
* is adopted, then users wishing to use the MSVCRT implementation of
* "vsprintf()" 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_vsprintf()"; 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 __vsprintf (char *, const char *, va_list) __MINGW_NOTHROW;
#ifdef INSTALL_AS_DEFAULT
/*
* This implementation is to become the default for calls to vsprintf();
* establish the alias to make this so, forcing users to use the back-door
* __msvcrt_vsprintf() reference, to access the original MSVCRT function.
*/
int __cdecl __mingw_alias(vsprintf) (char *, const char *, va_list) __MINGW_NOTHROW;
#endif
int __cdecl __vsprintf( char *buf, const char *fmt, va_list argv )
{
register int retval;
buf[retval = __pformat( PFORMAT_NOLIMIT, buf, 0, fmt, argv )] = '\0';
return retval;
}
/* $RCSfile$Revision$: end of file */