Formated I/O

Formatted Input

The ObjexxFCL formatted input capability allows formatted reads to be performed using C++ streams, as in:

int i, j;
stream >> bite(3,i) >> skip(1) >> bite(2,j) >> skip;

A numeric first argument to bite is the number of characters to read the variable into. Variables of a known width, such as char or Fstring, can be read with a one-argument bite function, as in  bite(name). Character strings are read into the variables as is: no BLANK=ZERO or nP Fortran-like read capability is available at this time.

A numeric argument to skip is the number of characters to skip over. A trailing skip reads the rest of the line and the line terminator.

Formatted Output

The ObjexxFCL formatted output capability provides the core Fortran formatted write capability with C++ streams, as in:

int i, j;
double x, y;
Fstring name(20);
std::string address;
...
stream << I(3,i) << space(1) << I(2,j) << '\n';
stream << F(9,3,x) << G(15,6,y) << '\n';
stream << A(15,name) << '\n';
stream << A(30,address) << '\n';

The floating point output functions have the form F(w,d,v), E(w,d,v), and G(w,d,v) where w is the field width, d is the number of digits, and v stands for the variable.

Formatting similar to Fortran list-directed writes are provided by some additional functions. List-directed write formatting is not standardized so two classes of functions are provided. The SS functions provide single-space separated, minimal width output (akin to GCC g77 list-directed output) and the SW functions provide a standard-width format with each field's width and precision based on its data type.

Organization

The formatted i/o functions and classes are contained within a nested ObjexxFCL::fmt namespace to provide control over scoping and name conflicts.

Sources using formatted input must include the formatted.i.hh header file. Sources using formatted output must include the formatted.o.hh header file. For convenience, source files that use both formatted input and output can include the single formatted.io.hh header file.