您的位置：首页 > 其它

我谈windows函数的返回值规律

2013-08-22 13:49 176 查看

在windows的世界里面，很少有API没有返回值。但是到底返回什么代表成功，这个没有标准。我发现主要有三种模式

1 . 返回非0表示成功，返回0表示失败

大多数Win32 Platform API都是这样,比如

int result =MoveFileEx(szTempName,

                    "allcaps.txt",

                    MOVEFILE_REPLACE_EXISTING);

if(!result)

    {

        printf("Could not move file. error:%d",GetLastError());

        return 0;

    }

使用这种方法。你必须提供类似GetLastError的取错误的方法，而且你必须保证这个函数是thread-safe的，每个线程能维护自己的错误信息。

2. 返回大于等于0表示成功，返回-1表示失败

socket api大部分是这样设计的

while( bytesRecv != SOCKET_ERROR ) {

    bytesRecv = recv( ConnectSocket, recvbuf, 32, 0 );

    if ( bytesRecv == 0 || bytesRecv == WSAECONNRESET ) {

      printf( "Connection Closed.\n");

      break;

    }

    printf( "Bytes Recv: %ld\n", bytesRecv );

  }

这样的好处是返回值就可以用来表示成功和状态。比如这里的recv就可以返回收到的字节数。但是你还是要有一个查询错误的API,like WSAGetLastError().

3.返回0表示成功

COM的接口大部分是这样设计的

if( FAILED(lpdd->QueryInterface(IID_IDirectDraw7, (LPVOID *) &lpdd)))

    {

          //error handle and return

    }

其他的一些考虑

1.如何定义错误值？

简单的一点使用宏连续定义，like

#define E_NO_FILE 1

#define E_BAD_FILE 2
复杂的一点就像COM，严格的定义每一位的意义

这种情况下你可以提供一个宏来创建错误代码,like

#define MAKE_HRESULT(sev,fac,code)\

( (HRESULT) (((unsigned long)(sev)<<31) | ((unsigned long)(fac)<<16) \

| ((unsigned long)(code))) )

2.可以提供一个宏或者函数来帮助判断是否成功

比如COM提供了FAILED宏来帮助你判断COM的返回值

#define FAILED(Status)     ((HRESULT)(Status)<0)

3.如果只有错误和成功两个返回值,考虑使用bool来返回

这个适用于C++,优点是意义很清晰.返回 true就是成功,false就是失败.

4.要使用异常来表示错误的状态么?

使用异常的好处就是返回值被省出来了，可以不返回或者返回其他信息，还有益于定义错误类型和简化程序流程。缺点就是C++对异常支持还不够好,没有finally,每一家编译器支持也不一样,实现可能大不同.

内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理

标签：

相关文章推荐

新的分享

章节导航