strError, _strerror, _wcserror, __wcserror

Receber uma mensagem de erro do sistema (strerror, _wcserror) ou imprime um (mensagem de erro fornecida pelo usuário_strerror, __wcserror). Versões mais seguras dessas funções estão disponível; consulte strerror_s, _strerror_s, _wcserror_s, __wcserror_s.

char *strerror(
   int errnum 
);
char *_strerror(
   const char *strErrMsg 
);
wchar_t * _wcserror(
   int errnum 
);
wchar_t * __wcserror(
   const wchar_t *strErrMsg 
);

Parâmetros

  • errnum
    Número de Erro

  • strErrMsg
    Mensagem fornecida pelo usuário.

Valor de retorno

Todas essas funções retornam um ponteiro para a cadeia de caracteres da mensagem de erro.As chamadas subseqüentes podem substituir a seqüência de caracteres.

Comentários

The strerror mapas de função errnum como uma seqüência de caracteres de mensagem de erro, retornando um ponteiro para a seqüência de caracteres. Nenhuma das strerror nem _strerror Na verdade, imprime a mensagem: Para isso, você precisa chamar uma função de saída, sistema autônomo fprintf:

if (( _access( "datafile",2 )) == -1 )
   fprintf( stderr, _strerror(NULL) );

If strErrMsg é passado sistema autônomo NULL, _strerror Retorna um ponteiro para uma seqüência de caracteres que contém a mensagem de erro do sistema para a última telefonar da biblioteca que produziu um erro. A cadeia de caracteres da mensagem de erro é terminada por caractere de nova linha ('\n').If strErrMsg não é igual a NULL, em seguida, _strerror Retorna um ponteiro para uma seqüência de caracteres que contém (em ordem), sua mensagem de seqüência de caracteres, dois-pontos, um espaço, a mensagem de erro do sistema para a última telefonar biblioteca de produzir um erro e um caractere de nova linha. Sua mensagem de seqüência de caracteres pode ter, no máximo, 94 caracteres.

número do erro real de _strerror é armazenado na variável errno.As mensagens de erro do sistema são acessadas por meio da variável _sys_errlist, que é uma matriz de mensagens ordenadas por número do erro._strerror acessa a mensagem de erro apropriadas usando o errno valor sistema autônomo um índice para a variável _sys_errlist. O valor da variável _sys_nerr definido sistema autônomo o número máximo de elementos no _sys_errlist matriz. Para produzir resultados precisos, telefonar _strerror imediatamente após uma rotina de biblioteca retorna com um erro. Caso contrário, subseqüentes chamadas para strerror ou _strerror pode substituir o errno valor.

_wcserrorand __wcserrorare wide-character versions of strerrorand _strerror, respectively.

_strerror, _wcserror, and __wcserrorare not part of the ANSI definition but are instead Microsoft extensions to it.Não use-los onde portabilidade for desejada; compatibilidade ANSI, usar strerror em vez disso.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H

_UNICODE & _MBCS não definido

_MBCS definido

_UNICODE definido

_tcserror

strerror

strerror

_wcserror

Requisitos

Rotina

Cabeçalho necessário

strerror

<string.h>

_strerror

<string.h>

_wcserror, __wcserror

<string.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

Consulte o exemplo para perror.

Equivalente do NET Framework

sistema::exceção::mensagem

Consulte também

Referência

Manipulação de seqüência de caracteres (CRT)

clearerr

ferror

perror, _wperror