1. Miscellaneous Utilities

1.1 Various File Interpreter Functions

1.1.1 pwdinfo { }

Prints the information about the current directory of the programme to the standard output and to the programme-s output file (the pre/defined file variable outfile).

This function currently works only on UNIX systems.

1.1.2 setoutputdigits { numdigits }

Sets the number of digits used for output of decimal numbers to numdigits. This number is used e.g. at output of numbers with the write, fwrite and dwrite functions, but also with functions for printing vectors, matrices and other variables, e.g. printvector or printvectorvar.

Interfacing functions like setparam are affected by another function, namely setintfcdigits.

1.1.3 setoutputcharacters { numcharacters }

Sets the minimal number of characters used for output of decimal numbers to numcharacters. This number is used e.g. at output of numbers with the write, fwrite and dwrite functions, but also with functions for printing vectors, matrices and other variables, e.g. printvector or printvectorvar. There is seldomly a need to use this function. One example is when we want to output numbers in a table format so that all numbers in a column occupy the same amount of space. In this case the number of characters for output must be set appropriately greater than the number of digits which are written, so that the width of output numbers does not exceed numcharacters and all number outputs take the same amount of space. By default the minimal number of characters is less than the number of digits, so that each number that is written takes just as much space as necessary.

1.1.4 setintfcdigits { numdigits }

Sets the number of digits used while writing parameter values to the direct analysis input file aninfile by the function setparam to numdigits.

1.1.5 setintfccharacters { numcharacters }

Sets the minimal length of output strings when writing parameter values to the direct analysis input file aninfile by the function setparam to numcharacters.

2. Controlling Time

2.1 File Interpreter Functions for Controlling Time

Manuals List

Manuals List & Contents

Table of Contents

2.1.1 fprinttime { }

Prints the current time of the day to programme output file.

2.1.2 printtime { }

Prints the current time of the day to programme standard output.

2.1.3 dprinttime { }

Prints the current time of the day to both programme output file and standard output.

2.1.4 fileprinttime { filespec }

Prints the current time of the day to the file specified by filespec.

2.1.5 fwritetime { }

Does the same as fprinttime, except that merely the time is printed without any acompanying comment, spaces or empty lines.

2.1.6 writetime { }

Does the same as printtime, except that merely the time is printed without any acompanying comment, spaces or empty lines.

2.1.7 dwritetime { }

Does the same as dprinttime, except that merely the time is printed without any acompanying comment, spaces or empty lines.

2.1.8 filewritetime { filespec }

Does the same as fileprinttime, except that merely the time is printed without any acompanying comment, spaces or empty lines.

2.1.9 fprintdate { }

Prints the current date to programme output file.

2.1.10 printdate { }

Prints the current date to programme standard output.

2.1.11 dprintdate { }

Prints the current date to both programme output file and standard output.

2.1.12 fileprintdate { filespec }

Prints the current date to the file specified by filespec.

2.1.13 fwritedate { }

Does the same as fprintdate, except that merely the date is printed without any acompanying comment, spaces or empty lines.

2.1.14 writedate { }

Does the same as printdate, except that merely the date is printed without any acompanying comment, spaces or empty lines.

2.1.15 dwritedate { }

Does the same as dprintdate, except that merely the date is printed without any acompanying comment, spaces or empty lines.

2.1.16 filewritedate { filespec }

Does the same as fileprintdate, except that merely the date is printed without any acompanying comment, spaces or empty lines.

2.1.17 fmarktime { <id> }

Marks the current time and prints information about this mark to programme output file. Some measure of the current time in seconds is printed, as well as the time elapsed from the last time mark (i.e. call to any of the functions fmarktime, marktime, or dmarktime).

Optional numerical argument id is the identification number (should be integer) of the cpu mark, which is printed together with other data if it is specified.

2.1.18 marktime { <id> }

Does the same as fmarktime, except that information is printed to programme standard output.

2.1.19 dmarktime { <id> }

Does the same as fmarktime, except that information is printed to both programme output file and standard output.

2.1.20 fmarkcputime { <id> }

Marks the CPU time spent by the programme and prints information about this mark to programme output file. The CPU time spent for the programme since the beginning of its execution is printed, as well as the CPU time spent since the last CPU time mark (i.e. call to any of the functions fmarkCPUtime, markCPUtime, or dmarkCPUtime).

Optional numerical argument id is the identification number (should be integer) of the cpu time mark, which is printed together with other data if it is specified.

2.1.21 markcputime { <id> }

Does the same as fmarkCPUtime, except that information is printed to programme standard output.

2.1.22 dmarkcputime { <id> }

Does the same as fmarkCPUtime, except that information is printed to both programme output file and standard output.

2.2 Expression Evaluator Functions for Controlling Time

Manuals List

Manuals List & Contents

Table of Contents

2.2.1 gettime [ ]

Returns the current absolute time in seconds.

2.2.2 getcputime [ ]

Returns the CPU time spent by the programme since the beginning of its execution, in seconds.

3. Printing Programme Information

3.1 File Interpreter Functions for Printing Programme Information

Manuals List

Manuals List & Contents

Table of Contents

3.1.1 about { }

Prints basic information about the programme (such as name, version, support address) to the standard output and the programme output file.

3.1.2 fprintabout { }

Prints basic information about the programme to the programme output file.

3.1.3 printabout { }

Prints basic information about the programme to the programme standard output.

3.1.4 dprintabout { }

Prints basic information about the programme to the programme output file and standard output.

3.1.5 fwriteabout { }

Prints basic information about the programme to the programme output file. No empty lines are printed before and after the data.

3.1.6 writeabout { }

Prints basic information about the programme to the programme standard output. No empty lines are printed before and after the data.

3.1.7 dwriteabout { }

Prints basic information about the programme to the programme output file and standard output. No empty lines are printed before and after the data.