Share via


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

Retornar valor

_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 incorreto, o manipulador de parâmetros inválido será chamado, 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, consulte Estado global na 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

Confira também

Manipulação de arquivos