在windows的世界里面，很少有API沒有返回值。但是到底返回什么代表成功，這個(gè)沒有標(biāo)準(zhǔn)。我發(fā)現(xiàn)主要有三種模式
1 . 返回非0表示成功，返回0表示失敗大多數(shù)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的取錯(cuò)誤的方法，而且你必須保證這個(gè)函數(shù)是thread-safe的，每個(gè)線程能維護(hù)自己的錯(cuò)誤信息。
2. 返回大于等于0表示成功，返回-1表示失敗
socket api大部分是這樣設(shè)計(jì)的
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?);
??}
這樣的好處是返回值就可以用來表示成功和狀態(tài)。比如這里的recv就可以返回收到的字節(jié)數(shù)。但是你還是要有一個(gè)查詢錯(cuò)誤的API,like WSAGetLastError().
3.返回0表示成功
COM的接口大部分是這樣設(shè)計(jì)的
if(?FAILED(lpdd->QueryInterface(IID_IDirectDraw7,?(LPVOID?*)?&lpdd)))
????{
??????????//error?handle?and?return
????}
其他的一些考慮
1.如何定義錯(cuò)誤值？
簡單的一點(diǎn)使用宏連續(xù)定義，like
#define?E_NO_FILE?1
#define?E_BAD_FILE?2
復(fù)雜的一點(diǎn)就像COM，嚴(yán)格的定義每一位的意義
這種情況下你可以提供一個(gè)宏來創(chuàng)建錯(cuò)誤代碼,like
#define?MAKE_HRESULT(sev,fac,code)\
(?(HRESULT)?(((unsigned?long)(sev)<<31)?|?((unsigned?long)(fac)<<16)?\
|?((unsigned?long)(code)))?)
2.可以提供一個(gè)宏或者函數(shù)來幫助判斷是否成功
比如COM提供了FAILED宏來幫助你判斷COM的返回值
#define?FAILED(Status)?????((HRESULT)(Status)<0)
3.如果只有錯(cuò)誤和成功兩個(gè)返回值,考慮使用bool來返回
這個(gè)適用于C++,優(yōu)點(diǎn)是意義很清晰.返回 true就是成功,false就是失敗.
4.要使用異常來表示錯(cuò)誤的狀態(tài)么?使用異常的好處就是返回值被省出來了，可以不返回或者返回其他信息，還有益于定義錯(cuò)誤類型和簡化程序流程。缺點(diǎn)就是C++對(duì)異常支持還不夠好,沒有finally,每一家編譯器支持也不一樣,實(shí)現(xiàn)可能大不同.