# mfprintf

converts, formats, and writes data to a file

## Calling Sequence

    mfprintf(fd, format, a1, ..., an);

## Arguments

fd

  a scalar, file descriptor given by `mopen` (it's a positive integer).

  If `fd` equals 0 redirection in stderr.

  If `fd` equals 6 redirection in stdout.

  OBSOLETE: The value `-1` refers to the default file (i.e the last opened file).

format

  a Scilab string describing the format to use to write the remaining operands. The `format` operand follows, as close as possible, the C `printf` format operand syntax.

str

  a character string: a string to be scanned.

a1, ..., an

  the data to be converted and printed according to the format parameter.

## Description

The `mfprintf` function is a interface for C-coded version of `fprintf` function.

The `mfprintf` function writes formatted operands to the file specified by the file desciptor `fd`. The argument operands are formatted under control of the `format` operand.

This function may be used to output column vectors of numbers and string vectors without an explicit loop on the elements. In that case this function iterates on the rows. The shortest vector gives the number of time the format has to be iterated.

An homogeneous sequence of identical type parameters can be replaced by a matrix.

## Examples

    fd = mopen(TMPDIR+'/text.txt','wt');
    mfprintf(fd,'hello %s %d.\n','world',1);
    mfprintf(fd,'hello %s %d.\n','scilab',2);
    mfprintf(fd,'This line is built with a column vector (26:28) %d.\n',[26:28].');
    mfprintf(fd,'This line is built with a row vector (26:28) %d.\n',[26:28]);
    A = rand(3,6);
    mfprintf(fd,'This line is built with a matrix %.3f.\n',A);
    mclose(fd);
    if (isdef('editor') | (funptr('editor')<>0)) then
      editor(TMPDIR+'/text.txt')
    end
    mfprintf(0,'stderr output.\n');
    mfprintf(6,'stdout output.\n');

## See Also

- mclose
- meof
- fprintfMat
- mfscanf
- fscanfMat
- mget
- mgetstr
- mopen
- mprintf
- mput
- mputstr
- mseek
- mtell
- mdelete
- printf_conversion