Posted on 2006-04-25 16:55
小明 閱讀(2414)
評論(2) 編輯 收藏 引用 所屬分類:
C/C++
在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,每一家編譯器支持也不一樣,實現可能大不同.