covWrite Exports runtime information to files

## Syntax

              covWrite("html", dir)
              covWrite("binary", binaryFile)
              covWrite("html", binaryFile, dir)

## Arguments

"html"

  exports the coverage data as HTML files

"binary"

  store the coverage data as binary for later use

dir

  output directory as a string

binaryFile

  stored binary filename as a string

## Description

This command is used to export, store or "load and export" runtime instrumentation data to the file system. The major usage is to export the current runtime information to HTML files on a directory using `covWrite("html", "TMPDIR/coverage")`.

This command is used to export, store or "load and export" runtime instrumentation data to the file system.

## Basic example

    covStart(isempty)                      // instrument isempty by macro value
    for i=1:1e5; isempty(i); end           // run
    covWrite("html", "TMPDIR/coverage")    // write runtime information to a directory
    covStop();                             // remove any instrumentation

## Binary exemple

    covStart(isempty)
    for i=1:1e5; isempty(i); end
    covWrite("binary", "TMPDIR/isempty1")  // write runtime information
    covStop();                             // clear instrumentation

    covStart(isempty)
    for i=1:1e5; isempty(string(i)); end
    covWrite("binary", "TMPDIR/isempty2")  // write other runtime information
    covStop();

    covMerge(["TMPDIR/isempty1" "TMPDIR/isempty2"], "TMPDIR/isempty") // merge them
    covWrite("html", "TMPDIR/isempty", "TMPDIR/coverage") // render the information as HTML

## See also

- covStart
- covStop
- covMerge