perror、_wperror

更新 : 2007 年 11 月

エラー メッセージを出力します。

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

パラメータ

  • string
    出力するメッセージ文字列。

解説

perror 関数は、エラー メッセージを stderr に出力します。ワイド文字を扱う場合は、_perror ではなく _wperror を使用します。この場合、_wperror の string 引数はワイド文字列になります。それ以外の場合、_wperror_perror の動作は同じです。

汎用テキスト ルーチンのマップ

TCHAR.H のルーチン

_UNICODE および _MBCS が未定義の場合

_MBCS が定義されている場合

_UNICODE が定義されている場合

_tperror

perror

perror

_wperror

最初に string に指定されている文字列、続いてコロンが出力されます。次に、エラーの発生原因となったライブラリの呼び出しに関するシステム エラー メッセージ、最後に改行文字が出力されます。string が NULL ポインタまたは NULL 文字列へのポインタの場合、perror 関数はシステム エラー メッセージだけを出力します。

エラー番号は、ERRNO.H で定義されている変数 errno に格納されます。システム エラー メッセージは、変数 _sys_errlist から取り出されます。この変数は、エラー番号順に並べられたメッセージの配列です。perror は、_sys_errlistのインデックスとして errno の値を使用し、該当するエラー メッセージを出力します。変数 _sys_nerr の値は、_sys_errlist 配列の最大要素数として定義されます。

正確な結果を得るには、ライブラリ ルーチンがエラーを起こした直後に perror を呼び出します。直後に呼び出しておかないと、後続の呼び出しによって errno の値が上書きされることがあるためです。

Windows オペレーティング システムでは、ERRNO.H に記述されている一部の errno 値が未使用です。これらの値は、UNIX オペレーティング システム用に予約されています。Windows オペレーティング システムで使用される errno 値については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。errno 値がこれらのプラットフォームで使用されない値の場合、perror 関数は空の文字列を出力します。

必要条件

ルーチン

必須ヘッダー

perror

<stdio.h> または <stdlib.h>

_wperror

<stdio.h> または <wchar.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

ライブラリ

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 );
   }
}

出力

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

.NET Framework の相当するアイテム

適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

参照

プロセス制御と環境制御

clearerr

ferror

strerror、_strerror、_wcserror、__wcserror