Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Change language to: English - Português - 日本語

Please note that the recommended version of Scilab is 6.0.0. This page might be outdated.
See the recommended documentation of this function

Aide Scilab >> Entrées/Sorties [fichiers] > mput

mput

writes byte or word in a given binary format

Calling Sequence

mput(x [,type,fd])

Arguments

x

a vector of floating point or integer type numbers

fd

scalar. The fd parameter returned by the function. Default value is -1 which stands for the last (mopen) opened file.

type

a string. Give the binary format used to write all the entries of x.

Description

The mput function writes data to the output specified by the stream parameter fd. Data is written at the position at which the file pointer is currently pointing and advances the indicator appropriately.

The type parameter is a conversion specifier which may be set to any of the following flag characters (with default value "l"):

"l","i","s","ul","ui","us","d","f","c","uc"

for writing respectively a long, an int, a short, an unsigned long, an unsigned int, an unsigned short, a double, a float, a char and an unsigned char. The bytes which are wrote are automatically swapped if necessary (by checking little-endian status) in order to produce machine independent binary files ( in little-endian mode). This default swapping mode can be suppressed by adding a flag in the mopen function.

"..l" or "..b"

It is also possible to write in little-endian or big-endian mode by adding a 'l' or 'b' character at the end of a type specification. For example "db" will write a double in big-endian mode.

Examples

filen = 'test.bin';
mopen(filen,'wb');
mput(1996,'l');mput(1996,'i');mput(1996,'s');mput(98,'c');

// force little-endian 
mput(1996,'ll');mput(1996,'il');mput(1996,'sl');mput(98,'cl');

// force big-endian 
mput(1996,'lb');mput(1996,'ib');mput(1996,'sb');mput(98,'cb');

mclose();
mopen(filen,'rb');
if 1996<>mget(1,'l') then pause,end
if 1996<>mget(1,'i') then pause,end
if 1996<>mget(1,'s') then pause,end
if   98<>mget(1,'c') then pause,end

// force little-endian
if 1996<>mget(1,'ll') then pause,end
if 1996<>mget(1,'il') then pause,end
if 1996<>mget(1,'sl') then pause,end
if   98<>mget(1,'cl') then pause,end

// force big-endian 
if 1996<>mget(1,'lb') then pause,end
if 1996<>mget(1,'ib') then pause,end
if 1996<>mget(1,'sb') then pause,end
if   98<>mget(1,'cb') then pause,end

mclose();

See Also

  • mclose — close an opened file
  • meof — check if end of file has been reached
  • mfprintf — converts, formats, and writes data to a file
  • fprintfMat — Write a matrix in a file.
  • mfscanf — reads input from the standard input (interface to the C scanf function)
  • fscanfMat — Reads a Matrix from a text file.
  • mget — reads byte or word in a given binary format and convert to double
  • mgetl — read lines from an text file
  • mgetstr — read a character string from a file
  • mopen — open a file
  • mprintf — converts, formats, and writes data to the main scilab window
  • mputl — writes strings in an ascii file
  • mputstr — write a character string in a file
  • mscanf
  • mseek — set current position in binary file.
  • mtell — binary file management
  • mdelete — Delete file(s)
Scilab Enterprises
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Wed Oct 05 12:11:00 CEST 2011