Função fprintf

A função fprintf formata uma string de acordo com o padrão especificado e grava o resultado em um fluxo de arquivo. O primeiro parâmetro aceita um recurso de arquivo, o segundo - uma string de formato, e os parâmetros subsequentes - valores para substituição no padrão. Se null for passado em vez do recurso de arquivo, a função retornará uma string em vez de gravar no fluxo.

Na string de formato, são usados caracteres especiais (especificadores de formato), que começam com o sinal % e controlam a formatação da saída.

Sintaxe

phpfprintf(resource $handle, string $format, mixed ...$values): int|false

Especificadores de formato

Especificador Descrição
%s String
%d Número inteiro com sinal (decimal)
%u Número inteiro sem sinal (decimal)
%f Número de ponto flutuante (dependente da localidade)
%F Número de ponto flutuante (não dependente da localidade)
%c Caractere por código ASCII
%x Número inteiro em sistema hexadecimal (minúsculas)
%X Número inteiro em sistema hexadecimal (maiúsculas)
%o Número inteiro em sistema octal
%b Número inteiro em sistema binário
%e Notação científica (minúsculas)
%E Notação científica (maiúsculas)
%g Formato curto %e ou %f
%G Formato curto %E ou %F
%% Sinal de porcentagem

Exemplo

Gravar uma string formatada em um arquivo:

php<?php
  $file = fopen('output.txt', 'w');
  fprintf($file, "Name: %s, Age: %d", "John", 25);
  fclose($file);
?>

Conteúdo do arquivo output.txt:

php'Name: John, Age: 25'

Exemplo

Usando diferentes especificadores de formato:

php<?php
  $res = fopen('php://temp', 'w');
  fprintf($res, "Float: %.2f, Hex: %x", 12.3456, 255);
  rewind($res);
  echo stream_get_contents($res);
  fclose($res);
?>

Resultado da execução do código:

php'Float: 12.35, Hex: ff'

Exemplo

Retornar uma string em vez de gravar em um arquivo:

php<?php
  $result = sprintf("Today is %s", date('Y-m-d'));
  echo $result;
?>

Resultado da execução do código:

php'Today is 2023-11-15'

Veja também

  • a função sprintf,
    que retorna uma string formatada
  • a função vprintf,
    que exibe uma string formatada
  • a função file_put_contents,
    que grava dados em um arquivo