MF_write MD_write ME_write
MCF_write MCD_write MCE_write
MI_writeMBI_writeMSI_writeMLI_writeMQI_write
MU_writeMUB_writeMUS_writeMUL_writeMUQ_write
Functionwrite a matrix in ASCII format into a stream
Syntax C/C++#include <MFstd.h>
void MF_write( FILE *stream, fMatrix X, ui ht, ui len );
C++ MatObj#include <OptiVec.h>
void matrix<T>::write( FILE *stream  );
Pascal/Delphiuses MFstd;
{Delphi version:}
  procedure MF_write( var Stream:TextFile; MA:fMatrix; ht, len:UIntSize );
{Turbo Pascal version:}
  procedure MF_write( var Stream:Text; MA:fMatrix; ht, len:UIntSize );
DescriptionThe matrix MA with len columns and ht rows is written to stream in ASCII format. stream must already be open for write operations in text format.

The number format and the separation between columns may be specified using MF_setWriteFormat (C/C++ only) and MF_setWriteSeparate, respectively. See these functions for details.

Storing data in ASCII format is useful if the data have to be readable by human eyes, or if they are to be exported into other programs which are not able to read machine-format numbers. If avoidable, these functions should not be used for the storage of intermediate results that later have again to be read in. Instead, the function pairs of the MF_store / MF_recall family are recommended for the following reasons: conversion into ASCII format is slow, may lead to round-off errors, and requires much more disk memory than storage in machine format.

Error handlingnone
See alsoMF_setWriteFormat,   MF_setWriteSeparate,   MF_read,   MF_store,   MF_print,   chapter 14

MatrixLib Table of Contents  OptiVec home