OptiVec: VF

VF_cprint

VD_cprint

VE_cprint

VCF_cprint

VCD_cprint

VCE_cprint

VPF_cprint

VPD_cprint

VPE_cprint

VI_cprint

VBI_cprint

VSI_cprint

VLI_cprint

VQI_cprint

VU_cprint

VUB_cprint

VUS_cprint

VUL_cprint

VUI_cprint

Function

print a vector to the screen. Only DOS and Win32 console applications; not for Visual C++.

Syntax C/C++	#include <VFstd.h> void VF_cprint( fVector X, ui size, unsigned nperline );
C++ VecObj	#include <OptiVec.h> void vector<T>::cprint( unsigned nperline );
Pascal/Delphi	uses VFstd; procedure VF_cprint( X:fVector; size:UIntSize; nperline:UInt );

Description

size elements of X are printed to the screen (or "console"), into the actual text window, nperline elements in each line.

The display starts always with a new line. Please note that this may lead to an empty line at the beginning.
Each line begins with the index of the first element printed into that line. The index is followed by a colon and by the requested nperline elements.
Cartesian complex numbers are printed in braces, with the real and imaginary parts separated by a komma: {Re, Im}. Polar complex numbers are also written in braces, with the Mag and Arg parts separated by an at-sign: {Mag @ Arg}.

The display pauses every screenful. The user is prompted after each page to continue or to stop printing.
The number of digits per element is determined by the available space, which depends in turn on the line width and on the parameter nperline.

This family of functions is available only for DOS and Win32 console applications. It should not be used within TurboVision DOS programs.

Error handling

If nperline exceeds the maximum number of entries possible in the current text mode, an error message "Cannot use requested format (too many entries per line)!" is generated; in this case, the program chooses the maximum number nperline that is possible.

Return value

none