System


System

System class is a class registered in every Gravity VM that offers some useful methods and properties.

Print methods

    func main() {
        // print to stdout and add a newline character
        System.print("Hello World");

        // print to stdout without any newline character appended
        System.put("Hello World");
    }

Garbage collector methods

Gravity automatically manages memory for you using a tri-colour marking garbage collector, using the System class the user has the ability to change some of its settings and even disable it when certain performance critical tasks need to be performed:

    func main() {
        // disable GC
        System.gcenabled = false;

        // ratio used during automatic recomputation of the new gcthreshold value
        var ratio = System.gcratio;

        // minimum GC threshold size
        var minthreshold = System.gcminthreshold;

        // memory required to trigger a GC
        var threshold = System.gcthreshold;

        // enable GC
        System.gcenabled = true;
    }

Time related methods

There are times where it could be really useful to easily measure how much time is spent in a given task:

    func main() {
        var t1 = System.nanotime();
        perform_my_task();
        var t2 = System.nanotime();

        // return elapsed time in ms
        return ((t2-t1) / 1000000.0);
    }

System Exit

There are times where it could be useful to have main() return an error code back to your shell:

    func main() {
        foo(); // Do something useful
        System.exit(5);
    }

In your terminal, you can now reference the return code:

    # Returns: 5
    $ echo $?