Lê um caractere do ponteiro de arquivo

# fgetc

(PHP 4, PHP 5, PHP 7, PHP 8)

fgetc — Lê um caractere do ponteiro de arquivo

### Descrição

function fgetc(resource `$stream`): string|false

Obtém um caractere de um dado ponteiro de arquivo.

### Parâmetros

`stream`
  O ponteiro de arquivo deve ser válido e deve apontar para um arquivo aberto com sucesso por fopen() ou fsockopen() (e ainda não fechado por fclose()).

### Valor Retornado

Retorna uma string contendo um único caractere lido do ponteiro do arquivo passado por `stream`. Retorna `false` em EOF.

Aviso

Esta função pode retornar o valor booleano `false`, mas também pode retornar um valor não booleano que pode ser avaliado como `false`. Leia a seção sobre Booleanos para mais informações. Use o operador === para testar o valor retornado por esta função.

### Exemplos

Exemplo #1 Um exemplo da fgetc()

    <?php
    $fp = fopen('algumarquivo.txt', 'r');
    if (!$fp) {
        echo 'Não é possivel abrir algumarquivo.txt';
    }
    while (false !== ($char = fgetc($fp))) {
        echo "$char\n";
    }
    ?>

### Notas

> Nota: Esta função é compatível com dados binários.

### Veja Também

- fread() - Leitura de arquivo segura para binário
- fopen() - Abre um arquivo ou URL
- popen() - Abre um processo como ponteiro de arquivo
- fsockopen() - Abre uma conexão socket de domínio Unix ou de Internet
- fgets() - Lê uma linha de um ponteiro de arquivo

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open