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 ErrostrErrMsg
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.