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

fprintf(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
	$file = fopen('output.txt', 'w');
	fprintf($file, "Name: %s, Age: %d", "John", 25);
	fclose($file);
?>

Conteúdo do arquivo output.txt:

'Name: John, Age: 25'

Exemplo

Usando diferentes especificadores de formato:

<?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:

'Float: 12.35, Hex: ff'

Exemplo

Retornar uma string em vez de gravar em um arquivo:

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

Resultado da execução do código:

'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