Libraries.System.Properties

The properties class is designed to gather information about the system that the user is running. Currently, it supports a general property action, GetProperty, which can gather any known system property. It also currently contains helper methods for determining which operating system the user is on and for determining which web page was requested if this is a web project. System properties are equivalent to what are often termed "environment variables." The properties class does query the operating system for information, but does not contain any state itself.

Example Code

use Libraries.System.Properties

Properties properties
text address = properties:GetRequestedWebPage()
output address

This action compares two object hash codes and returns an integer. The result is larger if this hash code is larger than the object passed as a parameter, smaller, or equal. In this case, -1 means smaller, 0 means equal, and 1 means larger. This action was changed in Quorum 7 to return an integer, instead of a CompareResult object, because the previous implementation was causing efficiency issues.

Example Code

Object o
        Object t
        integer result = o:Compare(t) //1 (larger), 0 (equal), or -1 (smaller)

This action determines if two objects are equal based on their hash code values.

Example Code

use Libraries.Language.Object
        use Libraries.Language.Types.Text
        Object o
        Text t
        boolean result = o:Equals(t)

This action returns an environment variable from the system.

Example Code

use Libraries.System.Properties

        Properties properties
        text value = properties:GetEnvironmentVariable("quorum.url")
        output value

This action returns all environment variables on the system.

Example Code

use Libraries.System.Properties

        Properties properties
        HashTable<text, text> table = properties:GetEnvironmentVariables()

This action gets the hash code for an object.

Example Code

Object o
        integer hash = o:GetHashCode()

This property returns the name of the operating system currently running the program.

Example Code

use Libraries.System.Properties

    Properties properties
    text value = properties:GetOperatingSystemName()
    output value

This property returns the name of the operating system version currently running the program.

Example Code

use Libraries.System.Properties

    Properties properties
    text value = properties:GetOperatingSystemVersion()
    output value

This action returns all properties on the system.

Example Code

use Libraries.System.Properties

        Properties properties
        HashTable<text, text> table = properties:GetProperties()

This action returns a property from the system.

Example Code

use Libraries.System.Properties

        Properties properties
        text value = properties:GetProperty("os.name")
        output value

This helper method returns the requested web address if the project was a web project.

Example Code

use Libraries.System.Properties

    Properties properties
    text address = properties:GetRequestedWebPage()
    output address

This action returns a the location of the running executable on the system.

Example Code

use Libraries.System.Properties
        use Libraries.System.File

        Properties properties
        File file = properties:GetRunPath()
        output file:GetAbsolutePath()

This property returns whether or not the program is running on Android.

Example Code

use Libraries.System.Properties

    Properties properties
    boolean value = properties:IsAndroid()
    output value

This property returns whether or not the program is running on Apple's ios, either the simulator or the device.

Example Code

use Libraries.System.Properties

    Properties properties
    boolean value = properties:IsIos()
    output value

This property returns whether or not the program is running on Apple's ios simulator.

Example Code

use Libraries.System.Properties

    Properties properties
    boolean value = properties:IsIosSimulator()
    output value

This property returns whether or not the program is running on Mac.

Example Code

use Libraries.System.Properties

    Properties properties
    boolean value = properties:IsMac()
    output value

This property returns whether or not the program is running on a web browser.

Example Code

use Libraries.System.Properties

    Properties properties
    boolean value = properties:IsWebBrowser()
    output value

This property returns whether or not the program is running on Windows.

Example Code

use Libraries.System.Properties

    Properties properties
    boolean value = properties:IsWindows()
    output value

This action sets a property on the system.

Example Code

use Libraries.System.Properties

        Properties properties
        properties:SetProperty("my.custom.property", "value")