Export (0) Print
Expand All
div
Expand Minimize
1 out of 1 rated this helpful - Rate this topic

_cprintf, _cwprintf

Formats and prints to the console.

int _cprintf( 
   const char * format [, 
   argument] ... 
);
int _cwprintf(
   const wchar * format [, 
   argument] ...
);

Parameters

format
Format-control string.
argument
Optional parameters.

Return Value

_cprintf and _cwprintf return the number of characters printed.

Remarks

The _cprintf and _cwprintf functions format and print a series of characters and values directly to the console, using the _putch and _putwch functions, respectively, to output characters. Each argument (if any) is converted and output according to the corresponding format specification in format. The format has the same form and function as the format parameter for the printf function. Unlike the fprintf, printf, and sprintf functions, neither _cprintf nor _cwprintf translates line feed characters into carriage return–line feed (CR-LF) combinations when output.

An important distinction is that _cwprintf displays Unicode characters when used in Windows NT. Unlike _cprintf, _cwprintf uses the current console locale settings.

Security Note   Ensure that format is not a user-defined string.

Generic-Text Routine Mappings

TCHAR.H routine _UNICODE & _MBCS not defined _MBCS defined _UNICODE defined
_tcprintf _cprintf _cprintf _cwprintf

Requirements

Routine Required header Compatibility
_cprintf <conio.h> Win 98, Win Me, Win NT, Win 2000, Win XP
_cwprintf <conio.h> Win 98, Win Me, Win NT, Win 2000, Win XP

For additional compatibility information, see Compatibility in the Introduction.

Libraries

All versions of the C run-time libraries.

Example

// crt_cprintf.c
// compile with: /c
/* This program displays some variables to the console.
 */

#include <conio.h>

int main( void )
{
   int      i = -16, h = 29;
   unsigned u = 62511;
   char     c = 'A';
   char     s[] = "Test";

   /* Note that console output does not translate \n as
    * standard output does. Use \r\n instead.
    */
   _cprintf( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}

Output

-16  001d  62511  A Test

See Also

Console and Port I/O Routines | _cscanf | fprintf | printf | sprintf | vfprintf | Run-Time Routines and .NET Framework Equivalents

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.