This document is outdated, please follow this
link to get the up-to-date online help.
1.4.23 mfprintf: ----- converts, formats, and writes data to a file
mprintf - converts, formats, and writes data to the main scilab window
msprintf - converts, formats, and writes data in a string
CALLING SEQUENCE
mfprintf(fd,format,a1,...,an);
mprintf(format,a1,...,an);
str=msprintf(format,a1,...,an);
PARAMETERS
-
fd
: scalar, file descriptor given by mopen (it's a positive
integer). 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, string to be scanned.
- a1,...,an
: Specifies the data to be converted and printed according to the format
parameter.
DESCRIPTION
The mprintf, mfprintf, and msprintf functions are interface for C-coded version of printf, fprintf and
sprintf functions.
The mprintf function
writes formatted operands to the standard Scilab output
(i.e the Scilab window). The argument operands are formatted under control
of the format operand.
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.
The msprintf writes formatted operands in its returned value (a Scilab string).
The argument operands are formatted under control
of the format operand. Note that, in this case, the escape
sequences (", ,..") are treated as a normal sequence of
characters.
All these functions may be used to output column vectors of numbers
and string vectors without an explicit loop on the elements. In that
case these functions 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
EXAMPLE
mprintf('At iteration %i, Result is:\nalpha=%f',33,0.535)
msprintf('%5.3f %5.3f',123,0.732)
msprintf('%5.3f\\n%5.3f',123,0.732)
A=rand(5,2);
// vectorized forms: the format directive needs
// two operand, each column of A is used as an operand.
// and the mprintf function is applied on each row of A
mprintf('%5.3f\\t%5.3f\\n',A)
colors=['red';'green';'blue';'pink';'black'];
RGB=[1 0 0;0 1 0;0 0 1;1 0.75 0.75;0 0 0];
mprintf('%d\\t%s\\t%f\\t%f\\t%f\\n',(1:5)',colors,RGB)
SEE ALSO
mclose, meof, mfprintf, fprintfMat, mfscanf, fscanfMat, mget, mgetstr, mopen, mprintf, mput, mputstr, mscanf, mseek, mtell