php man page for fprintf

FPRINTF(3)								 1								FPRINTF(3)

fprintf - Write a formatted string to a stream

SYNOPSIS
       int fprintf (resource  $handle, string  $format, [mixed	$args], [mixed	$...])

DESCRIPTION
	Write a string produced according to $format to the stream resource specified by $handle.

PARAMETERS
	      o $handle
		-A file system pointer resource that is typically created using fopen(3).

	      o $format
		- See sprintf(3) for a description of $format.

	      o $args
		-

	      o $...
		-

RETURN VALUES
	Returns the length of the string written.

EXAMPLES
       Example #1

	      fprintf(3): zero-padded integers

	      <?php
	      if (!($fp = fopen('date.txt', 'w'))) {
		  return;
	      }

	      fprintf($fp, "%04d-%02d-%02d", $year, $month, $day);
	      // will write the formatted ISO date to date.txt
	      ?>

       Example #2

	      fprintf(3): formatting currency

	      <?php
	      if (!($fp = fopen('currency.txt', 'w'))) {
		  return;
	      }

	      $money1 = 68.75;
	      $money2 = 54.35;
	      $money = $money1 + $money2;
	      // echo $money will output "123.1";
	      $len = fprintf($fp, '%01.2f', $money);
	      // will write "123.10" to currency.txt

	      echo "wrote $len bytes to currency.txt";
	      // use the return value of fprintf to determine how many bytes we wrote
	      ?>

SEE ALSO
       printf(3), sprintf(3), sscanf(3), fscanf(3), vsprintf(3), number_format(3).

PHP Documentation Group 														FPRINTF(3)