_ungetc_nolock, _ungetwc_nolock
Envia um caractere de volta para o fluxo.
int _ungetc_nolock(
int c,
FILE *stream
);
wint_t _ungetwc_nolock(
wint_t c,
FILE *stream
);
Parâmetros
c
Caractere a ser armazenado.stream
Ponteiro a estrutura de FILE .
Valor de retorno
Se for bem-sucedido, cada uma dessas funções retornará o argumento de caractere c*.* Se c não puder ser empurrado novamente ou se nenhum caractere tiver sido lido, a alteração no fluxo de entrada é desfeita e EOF retorna _ungetc_nolock; retorna WEOF _ungetwc_nolock. Se stream é NULL, EOF ou WEOF será retornado e errno é definido como EINVAL.
Para obter informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.
Comentários
Essas funções são versões sem-bloqueio de ungetc e de ungetwc. As versões com o sufixo _nolock são idênticas, exceto pelo fato de que não são protegidas contra interferência de outros threads. Elas podem ser mais rápidas, uma vez que não incorrem na sobrecarga de bloquear outros threads. Use essas funções somente em contextos de thread-safe, como aplicativos single-threaded ou onde o escopo de chamada já manipula o isolamento do thread.
Mapeamentos da rotina de texto genérico
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_ungettc_nolock |
_ungetc_nolock |
_ungetc_nolock |
_ungetwc_nolock |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_ungetc_nolock |
<stdio.h> |
_ungetwc_nolock |
<stdio.h> ou <wchar.h> |
Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.
Equivalência do .NET Framework
Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.