perror、_wperror

發行項
06/09/2015

列印錯誤訊息。

void perror( 
   const char *string  
); 
void _wperror( 
   const wchar_t *string  
);

參數

string
欲列印的字串訊息。

備註

perror 函式會列印錯誤訊息至 stderr。 _wperror 是 _perror 的寬字元版本； _wperror 的 string 引數是寬字元字串。此外 _wperror 和 _perror 的行為相同。

一般文字常式對應

TCHAR.H 常式	_UNICODE & _MBCS 未定義	_MBCS 已定義	_UNICODE 已定義
_tperror	perror	perror	_wperror

string 會先列印，後面加上冒號，然後由造成錯誤的最後一個程式庫呼叫的系統錯誤訊息和最後的新行字元。如果 string 為 null 指標或指標為空字串， perror 只列印系統錯誤訊息。

錯誤代碼儲存在變數 errno 中 (定義在 ERRNO.H)。系統錯誤訊息透過變數 _sys_errlist 存取，此變數為依錯誤代碼排序的訊息陣列。 perror 列印適當的錯誤訊息會使用 errno 值做為對 _sys_errlist 的索引。 _sys_nerr 變數的值定義為項目 _sys_errlist 陣列中的最大數目。

若要產生正確的結果，請在程式庫常式傳回錯誤之後立刻呼叫 perror。否則，後續呼叫可以覆寫 errno 值。

在 Windows 作業系統，在 ERRNO.H 清單的 errno 值未使用。這些值是保留給 UNIX 作業系統使用的。如需提供 Windows 作業系統使用的 errno 值的清單，請參閱 _doserrno、errno、_sys_errlist 和 _sys_nerr 作業系統。 perror 列印這些平台未使用的所有 errno 值為空字串。

需求

常式	必要的標頭
perror	<stdio.h> or <stdlib.h>
_wperror	<stdio.h> 或 <wchar.h>

如需其他相容性資訊，請參閱＜簡介＞中的相容性。

程式庫

C 執行階段程式庫的所有版本。

範例

// crt_perror.c
// compile with: /W3
/* This program attempts to open a file named
 * NOSUCHF.ILE. Because this file probably doesn't exist,
 * an error message is displayed. The same message is
 * created using perror, strerror, and _strerror.
 */

#include <fcntl.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <io.h>
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <share.h>

int main( void )
{
   int  fh;

   if( _sopen_s( &fh, "NOSUCHF.ILE", _O_RDONLY, _SH_DENYNO, 0 ) != 0 )
   {
      /* Three ways to create error message: */
      perror( "perror says open failed" );
      printf( "strerror says open failed: %s\n",
         strerror( errno ) ); // C4996
      printf( _strerror( "_strerror says open failed" ) ); // C4996
      // Note: strerror and _strerror are deprecated; consider
      // using strerror_s and _strerror_s instead.
   }
   else
   {
      printf( "open succeeded on input file\n" );
      _close( fh );
   }
}

Output

perror says open failed: No such file or directory
strerror says open failed: No such file or directory
_strerror says open failed: No such file or directory