Contents page

Rules for Tools/savesong()


savesong()
SYNOPSIS
     long savesong(long file, struct Environment *environment)

ARGUMENTS
    `long file'
          File pointer.

    `struct Environment  *environment'
          Environment to save.

DESCRIPTION
     Use `savesong()' to save an Environment to disk.  You must first
     open file using the fast file i/o routine `fastopen()'.  Then,
     pass the file pointer and environment to `savesong()'.  If you are
     saving the currently installed song, pass the functions pointer
     instead of an Environment pointer, to indicate the currently
     installed Environment is to be saved.

SEE
     See clearenvironment(), installenvironment(), loadsong().