# fprintf

(PHP 5, PHP 7)

fprintf — 将格式化后的字符串写入到流

### 说明

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

写入一个根据 `format` 格式化后的字符串到 由 `handle` 句柄打开的流中。

### 参数

`handle`

  文件系统指针，是典型地由 fopen() 创建的 resource(资源)。

`format`

  参见 sprintf() 中对 `format` 的描述。

`args`

`...`

### 返回值

返回写入的字符串长度。

### 范例

Example #1 fprintf(): 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(): 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
    ?>

### 参见

- printf() - 输出格式化字符串
- sprintf() - Return a formatted string
- sscanf() - 根据指定格式解析输入的字符
- fscanf() - 从文件中格式化输入
- vsprintf() - 返回格式化字符串
- number_format() - 以千位分隔符方式格式化一个数字