Functie fprintf

De functie fprintf formatteert een string volgens het opgegeven patroon en schrijft het resultaat naar een bestandsstream. De eerste parameter accepteert een bestandshulpbron, de tweede een formatteerstring en de volgende parameters zijn waarden voor substitutie in het patroon. Als u null in plaats van een bestandshulpbron doorgeeft, retourneert de functie een string in plaats van naar een stream te schrijven.

In de formatteerstring worden speciale tekens (formatspecificaties) gebruikt, die beginnen met het teken % en de opmaak van de uitvoer beheren.

Syntaxis

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

Formatspecificaties

Specificatie	Beschrijving
`%s`	String
`%d`	Geheel getal met teken (decimaal)
`%u`	Geheel getal zonder teken (decimaal)
`%f`	Drijvende-kommagetal (locale-afhankelijk)
`%F`	Drijvende-kommagetal (niet locale-afhankelijk)
`%c`	Karakter volgens ASCII-code
`%x`	Geheel getal in hexadecimaal systeem (kleine letters)
`%X`	Geheel getal in hexadecimaal systeem (hoofdletters)
`%o`	Geheel getal in octaal systeem
`%b`	Geheel getal in binair systeem
`%e`	Wetenschappelijke notatie (kleine letters)
`%E`	Wetenschappelijke notatie (hoofdletters)
`%g`	Korte notatie van %e of %f
`%G`	Korte notatie van %E of %F
`%%`	Procentteken

Voorbeeld

Een geformatteerde string naar een bestand schrijven:

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

Inhoud van het bestand output.txt:

'Naam: John, Leeftijd: 25'

Voorbeeld

Gebruik van verschillende formatspecificaties:

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

Resultaat van de code-uitvoering:

'Float: 12.35, Hex: ff'

Voorbeeld

Retourneren van een string in plaats van naar een bestand te schrijven:

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

Resultaat van de code-uitvoering:

'Vandaag is het 2023-11-15'

Zie ook

de functie sprintf,
die een geformatteerde string retourneert
de functie vprintf,
die een geformatteerde string uitvoert
de functie file_put_contents,
die gegevens naar een bestand schrijft