Rover12421's Blog

The End.

API入门系列之四 -一个相当简单的SDK程序

首发

http://blog.csdn.net/beyondcode

http://www.cnblogs.com/beyond-code/

大家好,还是我beyondcode,再次见面,前面介绍的那么多'理论知识',你们都懂了吗? 就算还没有彻底领悟,但至少还是有那么一点意识了吧,知道有那么一回事了吧。这一篇我打算通过一个小小小例子,来回忆一下我们以前介绍的相关知识,如Windows的数据类型,特别是和字符和字符串操作相关的数据类型,还有就是Unicode和ASCII在API函数上的具体体现。

另外,SDK编程交流群已经建立,很多朋友踊跃参加,系列文章和群的发展离不开你们。群号:81543028。

Ok,我们正式开始,我打算从一个简单的SDK程序开始,别怕,就几行代码而已··

/* BY beyondcode */

include <windows.h>

int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd)

{

MessageBoxA( NULL, “Hello beyondcode”, “Title”, MB_OK );

return 0;

}

程序你已经看到了,这恐怕就是一个最简单的带窗口的SDK程序了吧,如果你能写出代码行数比这个还少,又带窗口显示字符串的SDK程序,欢迎交流,呵呵,开个玩笑。

程序倒是简单,可是我还是要问一问,这个程序,你通过观察我在字符串的处理,还是在API函数的调用,还是主函数的参数写法,你能看出什么问题呢?……………………………….对,就是我全部明确指出是单字节版本的,WinMain的第三个参数是LPSTR类型,调用的MessageBox是带A后缀的单字节版本,字符串常量"Hello beyondcode"和"Title"都没有使用L前缀。那么第二个问题来了, 如果我告诉你我现在的工程环境是 使用Unicode字符集 (工程使用的字符集可以在 【项目】->工程属性 弹出的属性页中的 【配置属性】中的【常规】左边的【字符集】中设置),那么我上面的程序能正常通过编译吗? 当然能,因为我已经试过了,不信你也可以试试,可是为什么呢? 这是因为我指定的参数和函数需要的参数都是单字节版本的,也就是说他们相互匹配。要是我这里将MessageBoxA改成MessageBoxW呢? 就会出错吧,因为MessageBoxW的第二个,和第三个参数是需要LPCWSTR,通过上一篇学习,我们知道也就是const wchar_t*, 而我给出的两个字符串常量却没有用L前缀.也就是说他们是单字节的,传给宽字节版本的MessageBoxW当然就类型不匹配了啊,所以就通不过编译了吧。

通过上面的学习,我再出一个问题,如果我此时的工程环境是使用Unicode字符集,而这里我不用MessageBoxA,也不用MessageBoxW,而是用MessageBox,其他的都不变,结果会怎么样呢?   不能理解的可以加群讨论哟~~~

好了,单字节版本的程序,我们已经看到了,我们再来看看我们怎么才能把它改成宽字节版本的呢?

其实需要改的地方不多,也就5处WinMain改成wWinMain, WinMain的第三个参数改成LPWSTR,MessageBoxA改成W,两个字符串常量加L就ok了。

/* BY beyondcode */

include <windows.h>

int WINAPI wWinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPWSTR lpCmdLine, int nShowCmd )

{

MessageBoxW( NULL, L"Hello Beyondcode", L"Title", MB_OK );

return 0;

}

如果我想写一个代码比较通用的版本,也就是可以不用改动代码,就能编译出Unicode和ASCII的两个版本的程序,我应该怎么写呢?  其实就是我上一篇重点讨论的,凡是涉及到字符串的都不明确指出是Unicode还是ASCII版本的,调用的API函数凡是涉及到字符串参数的都不明确指出调用是A后缀的还是W后缀的函数,而是调用没有后缀的函数,如上面的MessageBox,这样就能写出代码比较通用的程序了。那么我们现在来把我们上面的程序改一改,让它通用

/* BY beyondcode */

include <windows.h>

include <tchar.h>

int WINAPI _tWinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nShowCmd )

{

MessageBox( NULL, _T(“Hello Beyondcode”), _T(“Title”), MB_OK );

return 0;

}

WinMain被改成了_tWinMain ,_tWinMain也是一个宏,根据UNICODE这个宏被设置与否而被定义成WinMain或wWinMain,和LPTSTR是一样的,这里还需要注意的是要包含tchar.h这个头文件,因为_tWinMain和_T()这些宏是被定义在里面的。经过上面我们就写出了第一个SDK的可以编译出两个版本的比较通用的程序代码了。是不是有点成就感了呢。。

下面,我们继续在上面的程序中加一些功能,让它计算1到10的和,然后把结果显示给我们看,这个地方,很多SDK初学者就不知所措了,因为一个和是一个整数,怎么显示这个整数给我们呢,通过对话框? MessageBox,可是MessageBox显示的是字符串。而我们这里又不是控制台程序可以使用printf之类的格式化输出函数来输出数字,也不能使用cout之类的C++对象来输出,那我们怎么办呢? 通过对话框来显示结果是不错的选择,但是对话框需要的是字符串,那我们就把我们的结果格式化到一个字符串里面,然后传送给MessageBox让它显示出来。那么就需要用到格式化字符串函数,下面我们就介绍wsprintf这个函数

ifdef UNICODE

define wsprintf wsprintfW

else

define wsprintf  wsprintfA

endif // !UNICODE

说它是函数,是不确切的。因为它实际是一个宏,根据环境被定义成不同的函数名wsprintfW或者wsprintfA, 而我们为了程序的通用性,直接使用wsprintf,传递的参数凡是涉及到字符串常量的我们都是用_T()宏,字符串指针的我们都使用LPTSTR和LPCTSTR。

下面我就先贴出添加了功能的程序代码,然后在做分析,你可以先不看分析,自己看一看代码,不懂的猜一猜它的意思。

/* BY beyondcode */

include <windows.h>

include <tchar.h>

int WINAPI _tWinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nShowCmd )

{

int sum = 0;

for( int i = 1; i<=10; i++ )

sum += i;

TCHAR strSum[256] = { 0 };

wsprintf( strSum, _T(“%d”), sum );

MessageBox( NULL, strSum, _T(“Title”), MB_OK );

return 0;

}

怎么样,也还不算复杂吧,计算1到10的那部分不用我讲了吧,最后的结果存放在sum这个变量里,我们现在的目的就是要让它显示在MessageBox弹出的对话框上面。

首先我们定义一个字符数组,我使用的是通用类型TCHAR,然后把它全部初始化为0。接着调用格式化字符函数wsprintf,它的第一个参数是LPTSTR类型的,指定经过格式化的字符串存放的地方,第二个参数是指定以什么格式来格式化后面的数据,这里我们要格式化一个整数,所以指定%d,这个和printf这些函数是一样的, 后面的参数就是我们要格式化的数据了。

这里还有一点可能有些新手朋友们不太懂,那就是,wsprintf要求的第一个参数是LPTSTR,而我传递的是一个TCHAR的数组名,这里我就在啰嗦一次咯,我们假设我们的环境是UNICODE的,那么LPTSTR相当于什么类型呢? 上一篇就讲过的啊,就是wchar_t* 就是宽字符指针,而我们知道数组名就是代表这个数组元素类型的指针,那么这里TCHAR数组的元素类型就是TCHAR,在Unicode环境下,TCHAR就是wchar_t也就是说strSum代表的是wchar_t类型的指针,也就是wchar_t*,所以看到了吗,他们是一样的类型。

通过上面的wsprintf函数的调用strSum这个字符数组中就包含了计算结果的字符串表示,然后我们通过MessageBox讲这个字符数组中的内容显示出来。在这里MessageBox的第二个参数类型是LPCTSTR,也就是const wchar_t*, 而我们上面说过我们的strSum代表的是 wchar_t*,这里同样可以传递给它又是为什么呢?这是因为阿,这里strSum在传递给MessageBox的时候就隐式转换成了const wchar_t*了。

有关格式化字符串的函数还有如下,详细用法各位可以查看MSDN,和上面所介绍的都差不多

sprintf 单字节版本的C/C++库函数

swprintf 宽字节版本的C/C++库函数

而我们上面的wsprintf和上面两个函数看起来很相似,大家不要搞混淆了啊,wsprintf最前面的w不是代表Wide,宽字节的意思了,而是Windows的W,代表是windows的API函数了,其实它是一个宏这在上面已经说过了,真正的API函数其实是wsprintfA和wsprintfW这两个,在不严格的情况下通常我们也说wsprintf是函数,只要大家懂就行了~

OK, 这一篇文章就到这里了,源代码就这么点,我也不上传了,各位有兴趣自己敲一下。下一篇,我讲会就怎么自己创建窗口进行介绍,谢谢大家的支持。

请记住我 beyondcode 。 

Comments