Create Compiled Database

DESCRIPTION:
Takes names of objects and puts them in a compiled database object.

USAGE:
cdump(what, name, file=paste(name, ".c", sep=""), optimize=T)

REQUIRED ARGUMENTS:
what:
character vector giving names of objects to be put into compiled database.
name:
name of the resulting compiled database object.

OPTIONAL ARGUMENTS:
file:
file name on which the C program will be stored.
optimize:
should the database be optimized so that common subexpressions occur only once.

VALUE:
output file name (file).

DETAILS:
The notion of a compiled database is that there is no run-time penalty for accessing the data there. The database is compiled and included within an executable version of S and all objects there are in memory and immediately available. A drawback is that the procedure is somewhat complex, you end up owning a special copy of S, and the work must be re-done if anything on the compiled database is to be updated.

EXAMPLES:
  cdump(objects(1),"foo")
  q()
$ S LOAD foo.c
$ S
  attach(foo)