# write

write in a formatted file

## Calling Sequence

    write(file-desc,a,[format])
                write(file-desc,a,k,format)

## Arguments

file-desc

  character string specifying the file name or integer value specifying logical unit (see file).

  This function can not open a UTF filename. In this case, please uses mopen.

a

  real matrix or column vector of character strings.

format

  character string, specifies a "Fortran" format. This character string must begin with a right parenthesis and end with a left parenthesis. Formats cannot mix floating point , integer or character edition modes

k

  integer vector

## Description

writes row-by-row a real matrix or a column vector of character strings in a formatted file. Each row of the `a` argument begin in a new line of `file-desc` file. Depending on `format` a given row of the `a` argument may be written in more than one line of `file-desc` file.

Format examples : `(1x,e10.3,5x,3(f3.0))` , `(10x,a20)` ;

See a Fortran book for more precision.

Direct access files : `x=write(file_desc,a,k,format)`. Here `k` is the vector of records (one record by row, i.e. `m=prod(size(k)`)

`write(%io(2),....)` writes on Scilab's window. Note that in this case `format` should produce one output line per matrix row. If this contraint is not verified unpredictable behavior could happen.

## Examples

    if getos() == 'Windows' then unix('del asave');
    else unix('rm -f asave'); end
    A=rand(5,3); write('asave',A); A=read('asave',5,3);
    write(%io(2),A,'('' | '',3(f10.3,'' | ''))')
    write(%io(2),string(1:10))
    write(%io(2),strcat(string(1:10),','))
    write(%io(2),1:10,'(10(i2,3x))')

    if getos() == 'Windows' then unix('del foo');
    else unix('rm -f foo'); end
    write('foo',A)

## See Also

- read
- save
- file
- fileinfo
- writb
- print
- string
- mfprintf
- mprintf
- msprintf
- fprintfMat