up | previous | next | Tom Wetmore | ttw@shore.net | LifeLines
Reports can be generated in two modes, line mode and page mode. When in line mode report output is written directly to the output file as the program runs, line by line. When in page mode output is buffered into pages which are written to the output file when pageout is called. Page mode is useful for generating charts (e.g., pedigree charts or box charts) where it is convenient to compute the two-dimensional location of output.
| Function | Description |
|---|---|
| void linemode() | Linemode selects line output mode, which is the default mode. |
| void pagemode(int, int) | Pagemode selects page mode; the first argument is the number of rows per page; the second is the number of columns per page. |
| void col(int) | Col positions output to the given column. If the current column is greater than the argument, col positions output to the given column on the next line. Col works in both modes. |
| void row(int) | Row positions output to the first character in the given row; row can only be used in page mode. |
| void pos(int, int) | Pos positions output to a specified row and column coordinate; the first argument specifies the row, and the second specifies the column. Pos can only be used in page mode. |
| void pageout() | Pageout outputs the current contents of the page buffer and then clears the contents of the page buffer; pageout can only be used in page mode. |
| string nl() | Nl writes a newline character to the output; note that \n can be used in a string to represent the newline character. |
| string sp() | Sp writes a space character to the output. |
| string qt() | Qt writes a quote character to the output; note that\" can be used in a string to represent the quote character. |
| void newfile(string, bool) | Newfile specifies the name of the report output file. Its first argument is the file's name; its second argument is an append flag; if the value of the flag is non-zero, the report appends to this file; if its value is zero the report overwrites the contents of the file. Newfile can be called many times; this allows a single report program to generate many report output files during a single execution. Programs are not required to use newfile; if it is not used then LifeLines automatically asks for the name of the report output file. |
| string outfile() | Outfile returns the name of the current report output file. |
| void copyfile(string) | Copyfile copies the contents of a file to the report output file; its argument is a string whose value is the name of a file; if the file name is not absolute nor relative, then the LLPROGRAMS environment variable, if set, will be used to search for the file; the file is opened and its contents copied to the report output file. |
| void print(string [,string]*) | Print prints its argument strings to the standard output window; print may have one to 32 arguments. |
up | previous | next | Tom Wetmore | ttw@shore.net | LifeLines
1/1/00