_isatty
Determina se um descritor de arquivo está associado a um dispositivo de caracteres.
Sintaxe
int _isatty( int fd );
Parâmetros
fd
Descritor de arquivo que se refere ao dispositivo a ser testado.
Valor retornado
_isatty
retornará um valor diferente de zero se o descritor estiver associado a um dispositivo de caracteres. Caso contrário, _isatty
retorna 0.
Comentários
A função _isatty
determina se fd
está associado a um dispositivo de caracteres (um terminal, console, impressora ou porta serial).
Essa função valida o parâmetro fd
. Se fd
for um ponteiro de arquivo inválido, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução puder continuar, a função retornará 0 e definirá errno
como EBADF
.
Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.
Requisitos
Rotina | Cabeçalho necessário |
---|---|
_isatty |
<io.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.
Bibliotecas
Todas as versões das bibliotecas em tempo de execução C.
Exemplo
// crt_isatty.c
/* This program checks to see whether
* stdout has been redirected to a file.
*/
#include <stdio.h>
#include <io.h>
int main( void )
{
if( _isatty( _fileno( stdout ) ) )
printf( "stdout has not been redirected to a file\n" );
else
printf( "stdout has been redirected to a file\n");
}
Saída de exemplo
stdout has not been redirected to a file