Win32 API介绍（COORD、GetStdHandle、GetConsoleCursorInfo 、SetConsoleCursorInfo）、＜locale.h＞本地化、类项

目录

Win32 API介绍​

控制台程序​

Windows的控制台：

用C语言的system函数使用控制台：

mode指令：

控制台屏幕上的坐标COORD

GetStdHandle​

函数使用：

GetConsoleCursorInfo

CONSOLE_CURSOR_INFO 

 SetConsoleCursorInfo

SetConsoleCursorPosition ​

GetAsyncKeyState​

本地化​

类项

setlocale函数

宽字符的打印​

---

Win32 API介绍​

Windows 这个多作业系统除了协调应用程序的执行、分配内存、管理资源之外， 它同时也是一个很大的服务中心。

调用这个服务中心的各种服务（每一种服务就是一个函数），可以帮应用程序达到开启视窗、描绘图形、使用周边设备等目的。

由于这些函数服务的对象是应用程序(Application)， 所以便称之为 Application Programming Interface，简称 API 函数。

WIN32 API也就是Microsoft Windows 32位平台的应用程序编程接口。​

简单的理解就是我们通过调用WIN32 API的各个函数，就能够将对应的程序在Windows32位平台下正常运行。

控制台程序​

平常我们运行起来的黑框程序其实就是控制台程序

Windows的控制台：

我们可以通过Win + R打开运行窗口，再输入cmd并点击确认打开控制台，如下所示：

在完成上述操作后，我们将会得到一个.exe窗口

用C语言的system函数使用控制台：

•  system函数是用来执行一个命令的
• 在使用system函数时需要包含头文件
• 当指令有效时，则正常执行，指令无效时，则无法执行

• 如果 command 是一个空指针（NULL），system 函数将只检查系统是否有命令处理器可用，而不会实际执行任何命令。在这种情况下，如果命令处理器可用，函数通常返回一个非零值；如果不可用，则返回零。

• 如果 command 不是空指针，system 函数将执行该命令，并返回命令的退出状态（exit status）。在 Unix-like 系统中，这通常是命令返回给父进程的状态码；在 Windows 系统中，这通常是命令处理器返回的值。需要注意的是，system 函数的返回值可能会受到系统和库实现的影响，因此具体的返回值可能会有所不同。

这些能在控制台窗口执行的命令，也可以调用C语言函数system来执行。例如：

#include
#include
int main()
{
    //设置控制台窗口的长宽：设置控制台窗口的大小，30行，100列​
    system("mode con cols=100 lines=30");
    //设置cmd窗口名称
    system("title 贪吃蛇");
    getchar();
    //system("pause");//pause 暂停
    return 0;
}

mode指令：

可以通过mode con cols=c lines=c来修改控制台的窗口大小，这里的C指的是一个整型，不能是浮点型和字符型，

我们可以使用cmd命令来设置控制台窗口的长宽：设置控制台窗口的大小，30行，100列

mode con cols=100 lines=30

也可以通过命令设置控制台窗口的名字：

title 贪吃蛇

控制台屏幕上的坐标COORD

控制台窗口的坐标如下所示，横向的是X轴，从左向右依次增长，纵向是Y轴，从上到下依次增长。​

COORD是Windows API中定义的一个结构体，表示一个字符在控制台屏幕缓冲区上的坐标，坐标（0，0）的原点位于缓冲区的顶部左侧单元格。

typedef struct _COORD {
 SHORT X;
 SHORT Y;
} COORD, *PCOORD;

给坐标赋值：

COORD pos = { 10, 15 };

GetStdHandle​

GetStdHandle是一个Windows API函数。它用于从一个特定的标准设备（标准输入、标准输出或标准错误）中取得一个句柄（用来标识不同设备的数值），使用这个句柄可以操作设备。

函数原型：

HANDLE WINAPI GetStdHandle(
  _In_ DWORD nStdHandle
);

函数的参数函数的参数是_In_DWORD类型的参数，这个参数类型是什么我们目前可以不需要深究，我们只需要知道这个函数的参数有三种：

从函数的原型中我们可以看到函数的返回类型是HANDLE类型：

HANDLE GetStdHandle(DWORD nStdHandle);

实例：

HANDLE hOutput = NULL;
//获取标准输出的句柄(用来标识不同设备的数值)​
hOutput = GetStdHandle(STD_OUTPUT_HANDLE);

函数的返回值这个函数如果成功调用的话，它能够将指定的句柄返回，并且我们可以对这个句柄进行读和写的操作。
这个函数我们可以简单的理解为它是用来操作输入缓冲区和控制台屏幕缓冲区的，所谓的控制台屏幕缓冲区就是控制台中的黑色部分。

函数使用：

这个函数的使用就比较简单，我们只需要通过HANDLE创建一个变量，再通过这个变量来接收函数的参数即可，如下所示：

HANDLE handle = GetStdHandle(STD_OUTPUT_HANDLE);

现在我们对函数传入的参数为输出设备，这里我们可以认为就是屏幕缓冲区，接下来我们就可以通过handle来对屏幕缓冲区中的内容进行一系列的操作了。

GetConsoleCursorInfo

检索有关指定控制台屏幕缓冲区的光标⼤⼩和可⻅性的信息

函数原型

BOOL WINAPI GetConsoleCursorInfo(
  _In_  HANDLE               hConsoleOutput,
  _Out_ PCONSOLE_CURSOR_INFO lpConsoleCursorInfo
);

从函数的原型中我们可以看到这个函数的返回类型是布尔类型；

函数参数这个函数的参数有两个：

• _In_ HANDLE hConsoleOutput: 这是一个控制台屏幕缓冲区的句柄。通常，你可以通过调用 GetStdHandle 函数并传递 STD_OUTPUT_HANDLE 来获取这个句柄，它代表了当前进程的标准输出。
• _Out_ PCONSOLE_CURSOR_INFO lpConsoleCursorInfo: 这是一个指向 CONSOLE_CURSOR_INFO 结构的指针，该结构用于接收光标的信息。

返回值
如果函数成功，返回值为非零（TRUE）。如果函数失败，返回值为零（FALSE）。要获取更多的错误信息，可以调用 GetLastError 函数。

BOOL WINAPI GetConsoleCursorInfo(

HANDLE hConsoleOutput,
 PCONSOLE_CURSOR_INFO lpConsoleCursorInfo
);

PCONSOLE_CURSOR_IFNO        是指向 CONSOLE_CURSOR_IFNO 结构的指针,该结构接收有关主句游标（光标）的信息。

实例：

HANDLE hOutput = NULL;
//获取标准输出的句柄(用来标识不同设备的数值)​
hOutput = GetStdHandle(STD_OUTPUT_HANDLE);
CONSOLE_CURSOR_INFO CursorInfo;
GetConsoleCursorInfo(hOutput, &CursorInfo);//获取控制台光标信息​

CONSOLE_CURSOR_INFO 

这个结构体，包含有关控制台光标的信息

typedef struct _CONSOLE_CURSOR_INFO {
 DWORD dwSize;
 BOOL bVisible;
} CONSOLE_CURSOR_INFO, *PCONSOLE_CURSOR_INFO;

• dwSize，由光标填充的字符单元格的百分比。 此值介于1到100之间。 光标外观会变化，范围从完全填充单元格到单元底部的水平线条。

int main()
{
	//它会定义一个COORD结构的变量pos，表示控制台屏幕上的一个坐标（40列，10行）
	//COORD pos = { 40 , 10 };

	//定义一个CONSOLE_CURSOR_INFO结构的变量cursor_info，并将其所有成员初始化为0
	CONSOLE_CURSOR_INFO cursor_info = { 0 };

	// 调用GetStdHandle函数获取标准输出的句柄，通常是控制台窗口 
	HANDLE handle = GetStdHandle(STD_OUTPUT_HANDLE);

	// 调用GetConsoleCursorInfo函数获取当前控制台光标的信息，并将其存储在cursor_info变量中
	GetConsoleCursorInfo(handle, &cursor_info);

	//设置cursor_info结构中的dwSize成员为100，改变光标的大小
	cursor_info.dwSize = 100;

	// 调用SetConsoleCursorInfo函数，将修改后的光标信息应用到控制台窗口
	SetConsoleCursorInfo(handle, &cursor_info);

	return 0;
}

• bVisible，游标的可见性。 如果光标可见，则此成员为 TRUE。 ​

CursorInfo.bVisible = false; //隐藏控制台光标​

 SetConsoleCursorInfo

设置指定控制台屏幕缓冲区的光标的大小和可见性。

BOOL WINAPI SetConsoleCursorInfo(
 HANDLE hConsoleOutput,
 const CONSOLE_CURSOR_INFO *lpConsoleCursorInfo
);

实例：

HANDLE hOutput = GetStdHandle(STD_OUTPUT_HANDLE);
//影藏光标操作​
CONSOLE_CURSOR_INFO CursorInfo;
GetConsoleCursorInfo(hOutput, &CursorInfo);//获取控制台光标信息​
CursorInfo.bVisible = false; //隐藏控制台光标​
SetConsoleCursorInfo(hOutput, &CursorInfo);//设置控制台光标状态​
 

SetConsoleCursorPosition ​

设置指定控制台屏幕缓冲区中的光标位置，我们将想要设置的坐标信息放在COORD类型的pos中，调用SetConsoleCursorPosition函数将光标位置设置到指定的位置。

BOOL WINAPI SetConsoleCursorPosition(
 HANDLE hConsoleOutput,
 COORD pos
);

实例：

 COORD pos = { 10, 5};
 HANDLE hOutput = NULL;
 //获取标准输出的句柄(用来标识不同设备的数值)​
 hOutput = GetStdHandle(STD_OUTPUT_HANDLE);
 //设置标准输出上光标的位置为pos​
 SetConsoleCursorPosition(hOutput, pos);

SetPos：封装一个设置光标位置的函数

//设置光标的坐标​
void SetPos(short x, short y)
{
 COORD pos = { x, y };
 HANDLE hOutput = NULL;
 //获取标准输出的句柄(用来标识不同设备的数值)​
 hOutput = GetStdHandle(STD_OUTPUT_HANDLE);
 //设置标准输出上光标的位置为pos​
 SetConsoleCursorPosition(hOutput, pos);
}

GetAsyncKeyState​

获取按键情况，GetAsyncKeyState的函数原型如下：

SHORT GetAsyncKeyState(
       int vKey
);

将键盘上每个键的虚拟键值传递给函数，函数通过返回值来分辨按键的状态。
GetAsyncKeyState 的返回值是short类型，在上一次调用 GetAsyncKeyState 函数后，如果
返回的16位的short数据中，最高位是1，说明按键的状态是按下，如果最高是0，说明按键的状态是抬起；如果最低位被置为1则说明，该按键被按过，否则为0。

如果我们要判断一个键是否被按过，可以检测GetAsyncKeyState返回值的最低值是否为1.

#define KEY_PRESS(VK) ( (GetAsyncKeyState(VK) & 0x1) ? 1 : 0 )

//检测数字键
#define KEY_PRESS(VK) ( (GetAsyncKeyState(VK) & 0x1) ? 1 : 0 )


int main()
{
	while (1)
	{
		if (KEY_PRESS(0x30))
			printf("0\n");
		else if (KEY_PRESS(0x31))
			printf("1\n");
		else if (KEY_PRESS(0x32))
			printf("2\n");
		else if (KEY_PRESS(0x33))
			printf("3\n");
		else if (KEY_PRESS(0x34))
			printf("4\n");
		else if (KEY_PRESS(0x35))
			printf("5\n");
		else if (KEY_PRESS(0x36))
			printf("6\n");
		else if (KEY_PRESS(0x37))
			printf("7\n");
		else if (KEY_PRESS(0x38))
			printf("8\n");
		else if (KEY_PRESS(0x39))
			printf("9\n");

	}
}

本地化​

提供的函数用于控制C标准库中对于不同的地区会产生不一样行为的部分。​
在标准可以中，依赖地区的部分有以下几项：

• 数字量的格式
• 货币量的格式
• 字符集
• 日期和时间的表示形式

普通的字符是占一个字节的，这类宽字符是占用2个字节。​
这里再简单的讲一下C语言的国际化特性相关的知识，过去C语言并不适合非英语国家（地区）使用。
C语言最初假定字符都是但自己的。但是这些假定并不是在世界的任何地方都适用。​

C语言字符默认是采用ASCII编码的，ASCII字符集采用的是单字节编码，且只使用了单字节中的低7位，最高位是没有使用的，可表示为0xxxxxxx；可以看到，ASCII字符集共包含128个字符，在英语国家中，128个字符是基本够用的，但是，在其他国家语言中，比如，在法语中，字母上方有注音符号，它就无法用 ASCII 码表示。于是，一些欧洲国家就决定，利用字节中闲置的最高位编入新的符号。比如，法语中的é的编码为130（二进制10000010）。这样一来，这些欧洲国家使用的编码体系，可以表示最多256个符号。但是，这里又出现了新的问题。不同的国家有不同的字母，因此，哪怕它们都使用256个符号的编码方式，代表的字母却不一样。比如，130在法语编码中代表了é，在希伯来语编码中却代表了字母Gimel (ג,(在俄语编码中又会代表另一个符号。但是不管怎样，所有这些编码方式中，0--127表示的符号是一样的，不一样的只是128--255的这一段。
至于亚洲国家的文字，使用的符号就更多了，汉字就多达10万左右。一个字节只能表示256种符号，肯定是不够的，就必须使用多个字节表达一个符号。比如，简体中文常见的编码方式是 GB2312，使用两个字节表示一个汉字，所以理论上最多可以表示 256 x 256 = 65536 个符号。

后来为了使C语言适应国际化，C语言的标准中不断加入了国际化的支持。比如：加入和宽字符的类型wchar_t 和宽字符的输入和输出函数，加入和头文件，其中提供了允许程序员针对特定地区（通常是国家或者说某种特定语言的地理区域）调整程序行为的函数。

类项

​通过修改地区，程序可以改变它的行为来适应世界的不同区域。但地区的改变可能会影响库的许多部分，其中一部分可能是我们不希望修改的。所以C语言支持针对不同的类项进行修改，下面的一个宏，指定一个类项：

• LC_COLLATE​
• LC_CTYPE
• LC_MONETARY​
• LC_NUMERIC​
• LC_TIME​
• LC_ALL - 针对所有类项修改​

setlocale函数

char* setlocale (int category, const char* locale);

setlocale 函数用于修改当前地区，可以针对一个类项修改，也可以针对所有类项。​
setlocale 的第一个参数可以是前面说明的类项中的一个，那么每次只会影响一个类项，如果第一个参数是LC_ALL，就会影响所有的类项。​
C标准给第二个参数仅定义了2种可能取值："C"和" "。

在任意程序执行开始，都会隐藏式执行调用:​

setlocale(LC_ALL, "C");

当地区设置为"C"时，库函数按正常方式执行，小数点是一个点。​
当程序运行起来后想改变地区，就只能显示调用setlocale函数。用" "作为第2个参数，调用setlocale函数就可以切换到本地模式，这种模式下程序会适应本地环境。

比如：切换到我们的本地模式后就支持宽字符（汉字）的输出等。

setlocale(LC_ALL, " ");//切换到本地环境​

setlocale的返回孩子是一个字符串指针，表示已经设置好的格式。如果调试失败，则返回空指针NULL。

setlocale()可以用来查询当前地区，这时第二个参数设为NULL就可以了

#include
int main()
{
	char* loc;
	loc = setlocale(LC_ALL, NULL);
	printf("默认的本地信息:%s\n", loc);

	loc = setlocale(LC_ALL, "");
	printf("设置后的本地信息:%s\n", loc);

	return 0;
}

宽字符的打印​

那如果想在屏幕上打印宽字符，怎么打印呢？

宽字符的字面量必须加上前缀L，否则C语言会把字面量当做窄字符串类型来处理。前缀L在单引号前面，表示宽字符，宽字符的打印使用wprintf，对应wprintf()的占位符为%lc；在双引号前面，表示宽字符串，对应wprintf()的占位符为%ls。

#include 
#include

int main()
{
	setlocale(LC_ALL, "");//适配本地模式

	wchar_t ch1 = L'中';
	wchar_t ch2 = L'国';
	wchar_t ch3 = L'☆';
	wchar_t ch4 = L'●';

	wprintf(L"%lc\n", ch1);
	wprintf(L"%lc\n", ch2);
	wprintf(L"%lc\n", ch3);
	wprintf(L"%lc\n", ch4);
	printf("AB\n");

	return 0;
}

输出结果：

从输出的结果来看，我们发现一个普通字符占一个字符的位置​

普通字符和宽字符打印出宽度的展示如下：

今天就先到这了！！！

看到这里了还不给博主扣个：
⛳️ 点赞☀️收藏 ⭐️ 关注！

你们的点赞就是博主更新最大的动力！
有问题可以评论或者私信呢秒回哦。