Função fgetc

A função fgetc lê e retorna um único caractere de um arquivo. Como parâmetro a função aceita um ponteiro para o arquivo, retorna uma string com um caractere ou false se o final do arquivo for atingido.

Sintaxe

phpfgetc(resource $handle): string|false

Exemplo

Vamos ler um arquivo caractere por caractere e exibir cada um:

php<?php
  $file = fopen('test.txt', 'r');
  
  if ($file) {
    while (($char = fgetc($file)) !== false) {
      echo $char;
    }
    fclose($file);
  }
?>

Exemplo

Vamos ler apenas o primeiro caractere do arquivo:

php<?php
  $file = fopen('test.txt', 'r');
  
  if ($file) {
    $char = fgetc($file);
    echo $char;
    fclose($file);
  }
?>

Exemplo

Tratamento do caso quando o final do arquivo é atingido:

php<?php
  $file = fopen('empty.txt', 'r');
  
  if ($file) {
    $res = fgetc($file);
    var_dump($res);
    fclose($file);
  }
?>

Veja também

  • a função fgets,
    que lê uma linha de um arquivo
  • a função fread,
    que lê de um arquivo
  • a função feof,
    que verifica o final do arquivo