使用AllocConsole在Win32程序中调用控制台调试输出

Posted 2020-06-18

近期一个Win32窗口项目中，调试时经常需要输出调试信息以追踪数据流及程序运行状态。

起初我封装了一系列文件操作，实现了日志形式的调试信息输出，但在后期的使用过程中越发觉得颇不顺手。那么，如何方便地在Win32程序中使用控制台进行调试输出？答案如题：AllocConsole函数和C-Runtime的freopen函数。具体操作流程如下：

1. 打开控制台
2. 重定向输出流至控制台
3. 执行调试信息输出操作

 

完整代码如下：

SetConsoleTitle(_T("Debug Output"));
freopen("CONOUT$", "w", stdout);
std::cout << "This is a test info" << std::endl;

 

相关函数说明：

AllocConsole函数的功能是为当前的窗口程序申请一个Console窗口，其原型为

BOOL AllocConsole(void);

 

函数调用成功，返回非零值，调用不成功则返回0。

freopen函数用来替换一个流，或者说重新分配文件指针，以实现重定向。可重定向的流有：标准输入流、标准输出流或者标准错误流。其函数原型为

FILE *freopen(const char *path, const char *mode, FILE *stream);

其中"CONOUT$"是指代当前console的特殊字符串，"w"表明以written模式打开这个console，stdout指代标准输出流。

 

补充：

AllocConsole函数不能改变控制台窗口在屏幕上的位置、尺寸等属性。以下函数可以控制&获取控制台相关信息。

GetConsoleScreenBufferInfo 　　// 检索窗口大小，屏幕缓冲区大小及颜色属性
SetConsoleWindowInfo 　　　　　 // 改变控制台窗口大小
SetConsoleScreenBufferSize　　 // 改变控制台屏幕缓冲区大小
SetConsoleTextAttribute　　    // 设置颜色属性
SetConsoleTitle　　　　　　　　  // 设置控制台窗口标题
GetConsoleTitle　　　　　　　　  // 获取控制台窗口标题