NAME

dumptable - print the contents of a table from an associated table-handle variable to a terminal or a file

SYNOPSIS

table = dumptable(table_handle, [ "filename"])

DESCRIPTION

dumptable is a useful utility that will print the contents of a table associated with a particular table-handle to the screen, or to a text file if the optional filename is given.

ARGUMENTS

table_handle

The table-handle identifier for the table.

filename

This optional string argument refers to a file that will contain the printed output from the dumptable command. This text file can be identified using an absolute or a relative path -- i.e. if the filename is given with no pth information the file will be created in the directory where the scorefile is invoked.

RETURN VALUE

Returns 0.0 if the printing is successful, -1.0 if there was an error.

EXAMPLES

   table = maketable("wave", 10, 1)
   dumptable(table)

The above score will produce the following output to the screem:

   0 0.000000
   1 0.618034
   2 1.000000
   3 1.000000
   4 0.618034
   5 0.000000
   6 -0.618034
   7 -1.000000
   8 -1.000000
   9 -0.618034

SEE ALSO

maketable, tablelen, samptable, plottable

ADDITIONAL REFERENCE (older makegen functions)

fdump