Scroll to navigation

GOLF(2gg) Development GOLF(2gg)

NAME

get-app - (application-information)

PURPOSE

Obtain data that describes the application.

SYNTAX

get-app \


    name | directory | trace-directory | file-directory | root-directory \


        | db-vendor <database configuration> | upload-size \


        | path | is-service \


    to <variable>

DESCRIPTION

Application-related variables can be obtained with get-app statement. The following application variables can be obtained (they are all strings unless indicated otherwise):

• "name" returns the name of your application, as specified when created (see mgrg).

• "directory" is the directory where your application resides, i.e. the application home directory (see directories).

• "trace-directory" is the directory where your application trace files are written, if enabled (see directories).

• "root-directory" is the Golf's root directory (i.e. where Golf is installed, see directories).

• "is-service" is a boolean variable that is true if your code is running as a service, or false if it is running as a command-line program.

• "file-directory" is the directory where Golf file storage system is, i.e. file-storage.

• "db-vendor" is the database vendor name of database given by <database configuration> (as used for example in run-query). You can use it to create database specific conditions. The database vendor name can be compared against predefined string constants GG_MARIADB (for MariaDB database), GG_POSTGRES (for Postgres database) and GG_SQLITE (for SQLite database).

• "path" is the leading path of the URL request that can be used to build web forms and links leading back to your application. It returns the same value as used in print-path before <request path> is appended.

• "upload-size" is the maximum allowed size of an uploaded file - this is a number (see gg for setting this value).

EXAMPLES

Get the name of Golf application:

get-app name to appname

Get the vendor of database db:

get-app db-vendor db to dbv
if-true dbv equal GG_POSTGRES


    // do something Postgres specific
end-if

SEE ALSO


Application information

get-app See all documentation

$VERSION $DATE